/* Docs at /docs (built by tools/docs/build.py). Uses the tokens in site.css; only the docs layout lives here. */

.docs-layout{display:grid;grid-template-columns:minmax(0,1fr);gap:16px;padding-block:24px 0;align-items:start}
.docs-main{min-width:0;display:flex;flex-direction:column;gap:32px}

/* sidebar: a list on wide screens, behind "Docs menu" on phones (assets/docs.js; without scripts it stays open) */
.docs-menu{justify-self:start}
.docs-nav{font-size:15px;display:flex;flex-direction:column;gap:4px}
.js .docs-nav.closed{display:none}
.docs-group{font-family:var(--sans);font-size:12px;font-weight:800;letter-spacing:.08em;text-transform:uppercase;color:var(--muted);margin:16px 0 4px}
.docs-nav ul{list-style:none;margin:0;padding:0;display:flex;flex-direction:column}
.docs-nav li a{display:flex;align-items:center;min-height:36px;padding:4px 10px;border-radius:var(--r-control);color:var(--fg);text-decoration:none;border-left:2px solid transparent}
.docs-nav li a:hover{background:var(--surface-2)}
.docs-nav li a[aria-current="page"]{background:var(--brand-soft);color:var(--accent);font-weight:700;border-left-color:var(--brand)}

/* search */
.docs-search{position:relative}
.docs-search input{width:100%;border:1px solid var(--muted);border-radius:var(--r-control);padding:9px 12px;background:var(--surface);font-size:16px}
.docs-results{margin-top:8px;background:var(--surface);border:1px solid var(--line);border-radius:var(--r-card);box-shadow:var(--card-shadow);max-height:60vh;overflow:auto}
.docs-results ol{list-style:none;margin:0;padding:4px}
.docs-results a{display:block;padding:8px 10px;border-radius:var(--r-control);color:var(--fg);text-decoration:none}
.docs-results a:hover,.docs-results a:focus-visible{background:var(--surface-2)}
.docs-results b{display:block;font-size:15px}
.docs-results span{display:block;font-size:13px;color:var(--muted);line-height:1.45}
.docs-results mark{background:var(--brand-soft);color:inherit;border-radius:2px}
.docs-results p{padding:10px 12px;margin:0;color:var(--muted);font-size:14px}

/* article */
.docs-prose{max-width:46em}
.docs-prose h1{font-size:36px}
.docs-prose .lead{font-size:19px;color:var(--muted)}
.docs-crumb{font-size:13px;font-weight:800;letter-spacing:.08em;text-transform:uppercase;color:var(--accent)}
.docs-prose h2{font-size:24px;margin-top:24px;scroll-margin-top:80px}
.docs-prose h3{font-size:19px;margin-top:12px;scroll-margin-top:80px}
.anchor{font-family:var(--sans);font-weight:400;color:var(--muted);text-decoration:none;opacity:0;margin-left:4px}
h2:hover .anchor,h3:hover .anchor,.anchor:focus-visible{opacity:1}
.docs-prose code{font-family:var(--mono);font-size:.86em;background:var(--surface-2);border:1px solid var(--line);border-radius:4px;padding:1px 5px;overflow-wrap:anywhere}
.docs-prose pre{position:relative;margin:0;background:var(--chrome-2);color:var(--chrome-fg);border:1px solid var(--chrome-line);border-radius:var(--r-card);padding:14px 16px;overflow-x:auto;font:14px/1.55 var(--mono)}
.docs-prose pre code{background:none;border:0;padding:0;font-size:inherit;color:inherit;overflow-wrap:normal}
.copy{position:absolute;top:8px;right:8px;border:1px solid rgba(245,238,232,.25);background:var(--chrome);color:var(--chrome-fg);border-radius:6px;padding:3px 10px;font-size:13px;font-weight:600;cursor:pointer}
.copy:hover{border-color:var(--flare)}
.docs-prose kbd{font-family:var(--mono);font-size:.85em;border:1px solid var(--line);border-bottom-width:2px;border-radius:4px;padding:0 5px;background:var(--surface)}
.docs-prose .ui{font-weight:700}
.docs-prose table code{white-space:nowrap}
.docs-prose li > ul,.docs-prose li > ol{margin-top:6px}
.docs-prose dl{margin:0;display:grid;gap:4px 16px}
.docs-prose dt{font-weight:700}
.docs-prose dd{margin:0 0 8px;color:var(--fg)}
.note,.warn,.tip{border:1px solid var(--line);border-left:4px solid var(--brand);background:var(--surface);border-radius:var(--r-control);padding:12px 16px;display:flex;flex-direction:column;gap:8px}
.warn{border-left-color:var(--bad);background:var(--bad-bg)}
.tip{border-left-color:var(--ok);background:var(--ok-bg)}
.note > b:first-child,.warn > b:first-child,.tip > b:first-child{font-family:var(--head);letter-spacing:.02em}
.docs-updated{margin-top:24px;padding-top:16px;border-top:1px solid var(--line);font-size:14px;color:var(--muted)}

/* step list with numbers in circles */
ol.howto{list-style:none;padding:0;counter-reset:howto;gap:14px}
ol.howto > li{counter-increment:howto;display:grid;grid-template-columns:32px minmax(0,1fr);gap:12px;align-items:start}
ol.howto > li::before{content:counter(howto);font-family:var(--head);font-weight:700;width:30px;height:30px;border-radius:50%;display:grid;place-items:center;background:var(--grad);color:#1C130D;font-size:15px}
ol.howto > li > *{grid-column:2}
ol.howto > li > :first-child{grid-column:2;grid-row:1}

/* cards on the docs home */
.doc-cards{display:grid;gap:12px;grid-template-columns:minmax(0,1fr)}
.doc-cards a{display:flex;flex-direction:column;gap:4px;background:var(--surface);border:1px solid var(--line);border-radius:var(--r-card);padding:16px 18px;box-shadow:var(--card-shadow);color:var(--fg);text-decoration:none;transition:border-color var(--fast)}
.doc-cards a:hover{border-color:var(--brand)}
.doc-cards b{font-family:var(--head);font-size:18px}
.doc-cards span{color:var(--muted);font-size:15px;line-height:1.5}

/* contents of this page */
.toc{border:1px solid var(--line);border-radius:var(--r-card);padding:12px 16px;background:var(--surface)}
.toc-head{font-size:13px;font-weight:800;letter-spacing:.08em;text-transform:uppercase;color:var(--muted);margin-bottom:6px}
.toc ul{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:2px;font-size:15px}

/* API reference */
.op{border:1px solid var(--line);border-radius:var(--r-card);background:var(--surface);padding:14px 16px;display:flex;flex-direction:column;gap:10px}
.op h3{margin:0;font-size:16px;font-family:var(--mono);display:flex;flex-wrap:wrap;align-items:center;gap:8px}
.op h3 code{background:none;border:0;padding:0;font-size:15px}
.verb{font-family:var(--mono);font-size:12px;font-weight:800;border-radius:4px;padding:2px 7px;letter-spacing:.04em}
.verb-get{color:var(--ok);background:var(--ok-bg)}
.verb-post{color:var(--run);background:var(--run-bg)}
.verb-put,.verb-patch{color:var(--wait-ink);background:var(--wait-bg)}
.verb-delete{color:var(--bad);background:var(--bad-bg)}
.scopes{font-size:14px;color:var(--muted)}
.req{font-size:11px;font-weight:800;text-transform:uppercase;letter-spacing:.06em;color:var(--bad);margin-left:4px}
.op table,.docs-prose .tablewrap table{font-size:14px}

/* previous / next */
.pager{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:12px;max-width:46em}
.pn{display:flex;flex-direction:column;gap:2px;border:1px solid var(--line);border-radius:var(--r-card);padding:12px 16px;background:var(--surface);color:var(--fg);text-decoration:none;font-weight:700}
.pn small{color:var(--muted);font-weight:600;font-size:13px}
.pn:hover{border-color:var(--brand)}
.pn.next{text-align:right}

body.docs .foot{margin-top:48px}

@media (min-width:640px){
  .doc-cards{grid-template-columns:repeat(2,minmax(0,1fr))}
  .docs-prose dl{grid-template-columns:max-content minmax(0,1fr)}
  .docs-prose dd{margin:0}
}
@media (min-width:960px){
  .docs-layout{grid-template-columns:240px minmax(0,1fr);gap:48px;padding-block:32px 0}
  .docs-menu{display:none}
  .js .docs-nav.closed{display:flex}
  .docs-nav{position:sticky;top:76px;max-height:calc(100vh - 92px);overflow-y:auto;padding-right:4px;padding-bottom:24px}
  .docs-prose h1{font-size:44px}
}
@media print{.docs-nav,.docs-menu,.pager,.copy,.anchor{display:none}}
/* search results sit inside the sidebar nav: undo its link layout */
.docs-nav .docs-results li a{display:block;min-height:0;border-left:0;padding:8px 10px}
