/* ClawMetry documentation — layout, theme, and content styles.
 *
 * Dark is the default because the rest of the site is dark; light is a
 * real second theme rather than an inverted afterthought, because docs
 * get read for an hour at a time in daylight. Both are defined as token
 * sets on :root so a single [data-theme] attribute swaps everything.
 */

:root {
  --void:#08080B; --panel:#0E0E13; --raise:#14141B; --sunk:#0B0B10;
  --ink:#FFFFFF; --ink-2:#CDCFDB; --ink-3:#A4A8B9; --ink-4:#787D92;
  --line:rgba(255,255,255,0.12); --line-2:rgba(255,255,255,0.24);
  --red:#E5443A; --red-hi:#FF6257; --red-soft:rgba(229,68,58,0.10);
  --ok:#3FBF87; --ok-soft:rgba(63,191,135,0.10);
  --warn:#E0A93B; --warn-soft:rgba(224,169,59,0.10);
  --info:#5AA9F5; --info-soft:rgba(90,169,245,0.10);
  --disp:'Archivo','Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;
  --body:'IBM Plex Sans','Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;
  --mono:'JetBrains Mono',ui-monospace,SFMono-Regular,Menlo,monospace;
  --side-w:288px; --toc-w:216px; --top-h:56px;
  --radius:10px;
}

[data-theme="light"] {
  --void:#FFFFFF; --panel:#F7F7F9; --raise:#FFFFFF; --sunk:#F2F2F5;
  --ink:#101014; --ink-2:#33353F; --ink-3:#5C6070; --ink-4:#83879A;
  --line:rgba(16,16,20,0.12); --line-2:rgba(16,16,20,0.22);
  --red:#C8362D; --red-hi:#E5443A; --red-soft:rgba(200,54,45,0.07);
  --ok:#1F8A5C; --ok-soft:rgba(31,138,92,0.08);
  --warn:#9A6B10; --warn-soft:rgba(154,107,16,0.09);
  --info:#1E6FBF; --info-soft:rgba(30,111,191,0.08);
}

* { box-sizing:border-box; }
html { scroll-behavior:smooth; scroll-padding-top:calc(var(--top-h) + 16px); }
body {
  margin:0; background:var(--void); color:var(--ink-2);
  font-family:var(--body); font-size:15.5px; line-height:1.72;
  -webkit-font-smoothing:antialiased;
}
a { color:var(--red-hi); text-decoration:none; }
[data-theme="light"] a { color:var(--red); }
a:hover { text-decoration:underline; }

/* ── top bar ─────────────────────────────────────────────────────────── */
.docs-top {
  position:fixed; inset:0 0 auto 0; height:var(--top-h); z-index:60;
  display:flex; align-items:center; gap:16px; padding:0 20px;
  background:color-mix(in srgb, var(--void) 88%, transparent);
  backdrop-filter:saturate(140%) blur(12px);
  border-bottom:1px solid var(--line);
}
.docs-brand { display:flex; align-items:center; gap:9px; font-family:var(--disp);
  font-weight:700; font-size:15px; color:var(--ink); letter-spacing:-.01em; }
.docs-brand:hover { text-decoration:none; }
.docs-brand .mark { width:20px; height:20px; border-radius:5px; background:var(--red);
  display:grid; place-items:center; color:#fff; font-size:12px; font-weight:800; }
.docs-brand .tag { color:var(--ink-4); font-weight:600; font-family:var(--body);
  font-size:12.5px; padding-left:9px; margin-left:2px; border-left:1px solid var(--line); }
.docs-top .spacer { flex:1; }
.docs-top nav { display:flex; gap:18px; align-items:center; }
.docs-top nav a { color:var(--ink-3); font-size:13.5px; font-weight:500; }
.docs-top nav a:hover { color:var(--ink); text-decoration:none; }
.top-cta { background:var(--red); color:#fff !important; padding:6px 13px;
  border-radius:7px; font-weight:600; font-size:13px; }
.top-cta:hover { background:var(--red-hi); }
.icon-btn { background:transparent; border:1px solid var(--line); color:var(--ink-3);
  width:32px; height:32px; border-radius:8px; cursor:pointer; display:grid;
  place-items:center; font-size:14px; font-family:inherit; }
.icon-btn:hover { color:var(--ink); border-color:var(--line-2); }
#nav-toggle { display:none; }

.search-open {
  display:flex; align-items:center; gap:8px; min-width:230px;
  background:var(--sunk); border:1px solid var(--line); color:var(--ink-4);
  border-radius:8px; padding:6px 10px; font-size:13.5px; cursor:pointer;
  font-family:inherit; text-align:left;
}
.search-open:hover { border-color:var(--line-2); color:var(--ink-3); }
.search-open kbd {
  margin-left:auto; font-family:var(--mono); font-size:10.5px; color:var(--ink-4);
  border:1px solid var(--line); border-radius:5px; padding:1px 5px; background:var(--panel);
}

/* ── shell ───────────────────────────────────────────────────────────── */
.docs-shell { display:flex; padding-top:var(--top-h); max-width:1600px; margin:0 auto; }

.docs-side {
  position:sticky; top:var(--top-h); align-self:flex-start; flex:0 0 var(--side-w);
  width:var(--side-w); height:calc(100vh - var(--top-h)); overflow-y:auto;
  padding:24px 12px 64px 20px; border-right:1px solid var(--line);
}
.docs-side::-webkit-scrollbar { width:9px; }
.docs-side::-webkit-scrollbar-thumb { background:var(--line); border-radius:9px;
  border:3px solid transparent; background-clip:content-box; }
.side-group { margin-bottom:6px; }
.side-title {
  display:flex; align-items:center; gap:6px; width:100%;
  font-family:var(--disp); font-size:11.5px; font-weight:700; letter-spacing:.09em;
  text-transform:uppercase; color:var(--ink-4); background:none; border:0;
  padding:9px 10px 6px; cursor:pointer; font-family:var(--disp);
}
.side-title:hover { color:var(--ink-2); }
.side-title .chev { margin-left:auto; transition:transform .15s ease; font-size:9px; }
.side-group[data-collapsed="1"] .chev { transform:rotate(-90deg); }
.side-group[data-collapsed="1"] .side-links { display:none; }
.side-links { display:flex; flex-direction:column; gap:1px; margin-bottom:12px; }
.side-links a {
  color:var(--ink-3); font-size:13.9px; padding:5.5px 10px; border-radius:7px;
  line-height:1.45; border-left:2px solid transparent;
}
.side-links a:hover { color:var(--ink); background:var(--panel); text-decoration:none; }
.side-links a.active {
  color:var(--ink); background:var(--red-soft); border-left-color:var(--red);
  font-weight:600;
}

/* ── main ────────────────────────────────────────────────────────────── */
.docs-main { flex:1 1 auto; min-width:0; padding:40px 44px 96px; }
.docs-body { max-width:812px; }

.crumbs { font-size:12.5px; color:var(--ink-4); margin-bottom:14px; display:flex;
  flex-wrap:wrap; gap:7px; align-items:center; }
.crumbs a { color:var(--ink-4); }
.crumbs a:hover { color:var(--ink-2); }
.crumbs .sep { opacity:.5; }

.page-eyebrow { font-family:var(--disp); font-size:11.5px; font-weight:700;
  letter-spacing:.1em; text-transform:uppercase; color:var(--red-hi); margin:0 0 8px; }
[data-theme="light"] .page-eyebrow { color:var(--red); }
.page-lede { font-size:17.5px; line-height:1.62; color:var(--ink-3); margin:0 0 30px;
  padding-bottom:26px; border-bottom:1px solid var(--line); }

.docs-body h1 { font-family:var(--disp); font-size:37px; line-height:1.14; font-weight:800;
  letter-spacing:-.022em; color:var(--ink); margin:0 0 14px; }
.docs-body h2 { font-family:var(--disp); font-size:24px; line-height:1.26; font-weight:700;
  letter-spacing:-.014em; color:var(--ink); margin:52px 0 14px; padding-top:6px; }
.docs-body h3 { font-family:var(--disp); font-size:17.5px; font-weight:700; color:var(--ink);
  margin:34px 0 10px; letter-spacing:-.008em; }
.docs-body h4 { font-size:15.5px; font-weight:700; color:var(--ink); margin:26px 0 8px; }
.docs-body p { margin:0 0 16px; }
.docs-body ul, .docs-body ol { margin:0 0 16px; padding-left:22px; }
.docs-body li { margin:5px 0; }
.docs-body li > ul, .docs-body li > ol { margin:6px 0 2px; }
.docs-body strong { color:var(--ink); font-weight:650; }
.docs-body hr { border:0; border-top:1px solid var(--line); margin:40px 0; }
.docs-body img { max-width:100%; border-radius:var(--radius); border:1px solid var(--line); }

.anchor { opacity:0; margin-left:9px; color:var(--ink-4); font-weight:400;
  text-decoration:none; font-size:.8em; transition:opacity .12s; }
h2:hover .anchor, h3:hover .anchor, h4:hover .anchor { opacity:1; }

code { font-family:var(--mono); font-size:.865em; background:var(--sunk);
  border:1px solid var(--line); border-radius:5px; padding:.1em .38em; color:var(--ink); }
[data-theme="light"] code { color:#9A2B22; }

.code-block { margin:0 0 20px; border:1px solid var(--line); border-radius:var(--radius);
  background:var(--sunk); overflow:hidden; }
.code-head { display:flex; align-items:center; gap:10px; padding:7px 12px;
  border-bottom:1px solid var(--line); background:var(--panel); }
.code-label { font-family:var(--mono); font-size:11px; color:var(--ink-4);
  letter-spacing:.03em; }
.code-copy { margin-left:auto; background:transparent; border:1px solid var(--line);
  color:var(--ink-4); border-radius:6px; padding:2px 9px; font-size:11px;
  cursor:pointer; font-family:inherit; }
.code-copy:hover { color:var(--ink); border-color:var(--line-2); }
.code-copy.done { color:var(--ok); border-color:var(--ok); }
.code-block pre { margin:0; padding:14px 16px; overflow-x:auto; }
.code-block code { background:none; border:0; padding:0; font-size:13px; line-height:1.68;
  color:var(--ink-2); }
[data-theme="light"] .code-block code { color:#26282F; }

.table-wrap { overflow-x:auto; margin:0 0 22px; border:1px solid var(--line);
  border-radius:var(--radius); }
.docs-body table { width:100%; border-collapse:collapse; font-size:14px; }
.docs-body th { font-family:var(--disp); font-size:11.5px; font-weight:700;
  letter-spacing:.06em; text-transform:uppercase; color:var(--ink-4);
  background:var(--panel); padding:10px 14px; border-bottom:1px solid var(--line);
  white-space:nowrap; }
.docs-body td { padding:10px 14px; border-bottom:1px solid var(--line);
  vertical-align:top; }
.docs-body tbody tr:last-child td { border-bottom:0; }
.docs-body td code { white-space:nowrap; }

.callout { border:1px solid var(--line); border-left:3px solid var(--ink-4);
  border-radius:var(--radius); padding:14px 18px; margin:0 0 22px; background:var(--panel); }
.callout p:last-child { margin-bottom:0; }
.callout-title { font-family:var(--disp); font-size:11.5px; font-weight:700;
  letter-spacing:.09em; text-transform:uppercase; margin:0 0 6px; color:var(--ink-3); }
.callout-note, .callout-info { border-left-color:var(--info); background:var(--info-soft); }
.callout-note .callout-title, .callout-info .callout-title { color:var(--info); }
.callout-tip { border-left-color:var(--ok); background:var(--ok-soft); }
.callout-tip .callout-title { color:var(--ok); }
.callout-warning { border-left-color:var(--warn); background:var(--warn-soft); }
.callout-warning .callout-title { color:var(--warn); }
.callout-danger { border-left-color:var(--red); background:var(--red-soft); }
.callout-danger .callout-title { color:var(--red-hi); }
[data-theme="light"] .callout-danger .callout-title { color:var(--red); }

blockquote { margin:0 0 20px; padding:2px 0 2px 18px; border-left:3px solid var(--line-2);
  color:var(--ink-3); }
blockquote p:last-child { margin-bottom:0; }

/* card grids used on index pages */
.card-grid { display:grid; gap:12px; margin:0 0 26px;
  grid-template-columns:repeat(auto-fill,minmax(238px,1fr)); }
.card { display:block; border:1px solid var(--line); border-radius:var(--radius);
  background:var(--panel); padding:15px 17px; color:var(--ink-2); }
.card:hover { border-color:var(--red); text-decoration:none; transform:translateY(-1px);
  transition:.13s; }
/* Card titles are link labels, not document structure. Using a heading here
   put an h4 into the page outline directly under an h2, which reads as a
   skipped level to an accessibility tree and to an SEO crawler alike. */
.card-title { display:block; font-family:var(--disp); font-size:14.5px; font-weight:700;
  color:var(--ink); margin:0 0 5px; }
.card p { margin:0; font-size:13.2px; color:var(--ink-4); line-height:1.55; }
.pill { display:inline-block; font-family:var(--mono); font-size:10.5px; letter-spacing:.04em;
  text-transform:uppercase; padding:2px 7px; border-radius:20px; border:1px solid var(--line);
  color:var(--ink-4); }
.pill-free { color:var(--ok); border-color:color-mix(in srgb,var(--ok) 45%,transparent);
  background:var(--ok-soft); }
.pill-paid { color:var(--warn); border-color:color-mix(in srgb,var(--warn) 45%,transparent);
  background:var(--warn-soft); }

/* ── page footer nav ─────────────────────────────────────────────────── */
.page-nav { display:flex; gap:12px; margin-top:56px; padding-top:26px;
  border-top:1px solid var(--line); }
.page-nav a { flex:1; border:1px solid var(--line); border-radius:var(--radius);
  padding:12px 16px; color:var(--ink-2); }
.page-nav a:hover { border-color:var(--red); text-decoration:none; }
.page-nav .dir { display:block; font-size:11.5px; color:var(--ink-4); margin-bottom:3px; }
.page-nav .ttl { font-family:var(--disp); font-weight:650; color:var(--ink); font-size:14.5px; }
.page-nav .next { text-align:right; }
.page-foot { margin-top:26px; font-size:12.5px; color:var(--ink-4);
  display:flex; gap:14px; flex-wrap:wrap; }

/* ── on this page ────────────────────────────────────────────────────── */
.docs-toc { position:sticky; top:var(--top-h); align-self:flex-start;
  flex:0 0 var(--toc-w); width:var(--toc-w); height:calc(100vh - var(--top-h));
  overflow-y:auto; padding:40px 20px 64px 4px; }
.toc-title { font-family:var(--disp); font-size:11.5px; font-weight:700;
  letter-spacing:.09em; text-transform:uppercase; color:var(--ink-4); margin:0 0 10px; }
.docs-toc a { display:block; color:var(--ink-4); font-size:13px; line-height:1.42;
  padding:4.5px 0 4.5px 11px; border-left:2px solid var(--line); }
.docs-toc a:hover { color:var(--ink-2); text-decoration:none; }
.docs-toc a.active { color:var(--ink); border-left-color:var(--red); }
.docs-toc a.lvl-3 { padding-left:22px; font-size:12.5px; }

/* ── search modal ────────────────────────────────────────────────────── */
.search-modal { position:fixed; inset:0; z-index:90; display:none;
  background:rgba(0,0,0,.62); padding:12vh 16px 16px; }
.search-modal[open], .search-modal.on { display:block; }
.search-panel { max-width:640px; margin:0 auto; background:var(--panel);
  border:1px solid var(--line-2); border-radius:14px; overflow:hidden;
  box-shadow:0 24px 70px rgba(0,0,0,.5); }
.search-panel input { width:100%; border:0; border-bottom:1px solid var(--line);
  background:transparent; color:var(--ink); font-size:16px; padding:16px 18px;
  font-family:inherit; outline:none; }
.search-results { max-height:56vh; overflow-y:auto; padding:6px; }
.search-results a { display:block; padding:10px 13px; border-radius:8px; color:var(--ink-2); }
.search-results a:hover, .search-results a.sel { background:var(--raise); text-decoration:none; }
.sr-sec { font-size:11px; color:var(--ink-4); text-transform:uppercase;
  letter-spacing:.07em; font-family:var(--disp); font-weight:700; }
.sr-title { font-weight:600; color:var(--ink); font-size:14.5px; }
.sr-desc { font-size:12.8px; color:var(--ink-4); line-height:1.5;
  overflow:hidden; display:-webkit-box; -webkit-line-clamp:2; -webkit-box-orient:vertical; }
.search-empty { padding:26px 18px; color:var(--ink-4); font-size:14px; text-align:center; }
.search-foot { border-top:1px solid var(--line); padding:8px 14px; font-size:11.5px;
  color:var(--ink-4); display:flex; gap:14px; }

/* ── responsive ──────────────────────────────────────────────────────── */
@media (max-width:1240px) {
  .docs-toc { display:none; }
  .docs-main { padding:36px 32px 88px; }
}
@media (max-width:920px) {
  #nav-toggle { display:grid; }
  .docs-top nav .hide-sm { display:none; }
  .search-open { min-width:0; }
  .search-open span { display:none; }
  .docs-side {
    position:fixed; left:0; top:var(--top-h); z-index:70; width:min(84vw,320px);
    background:var(--void); transform:translateX(-102%); transition:transform .2s ease;
    border-right:1px solid var(--line-2);
  }
  .docs-side.on { transform:none; }
  .docs-main { padding:28px 20px 80px; }
  .docs-body h1 { font-size:29px; }
  .docs-body h2 { font-size:21px; margin-top:40px; }
  .page-nav { flex-direction:column; }
}