/* Reach docs. Loads after ../tokens.css and takes its spacing, radii and Inter from there.
   The docs follow the app's light look (DESIGN.md, "Docs"): a pale grey canvas, white panels, black text at
   four strengths, and blue only for links and the one main button. Values the landing tokens don't have are
   named here, once. */

:root {
  --docs-canvas: #f6f7f9;
  --docs-panel: #ffffff;
  --docs-raised: #f3f4f6;
  --docs-ink-strong: #0a0a0a;
  --docs-ink: #14181f;
  --docs-ink-2: rgb(0 0 0 / 0.64);
  --docs-ink-3: rgb(0 0 0 / 0.55);
  --docs-line: rgb(0 0 0 / 0.08);
  --docs-line-lift: rgb(0 0 0 / 0.16);
  --docs-link: #1d4ed8;
  --docs-primary: #0d6dfc;
  --docs-primary-hover: #0b62e6;
  --docs-active: rgb(13 109 252 / 0.1);
  --docs-shadow: 0 4px 16px -8px rgb(0 0 0 / 0.06);
  --docs-shadow-float: 0 24px 48px -16px rgb(0 0 0 / 0.18), 0 0 0 1px rgb(0 0 0 / 0.06);
  --docs-scrim: rgb(10 10 10 / 0.4);
  --docs-bar: 64px;
  --docs-side: 232px;
  --docs-rail: 208px;
  --docs-read: 720px;
  color-scheme: light;
}

*, *::before, *::after { box-sizing: border-box; }
html { scroll-padding-top: calc(var(--docs-bar) + var(--space-6)); -webkit-text-size-adjust: 100%; }
@media (prefers-reduced-motion: no-preference) { html { scroll-behavior: smooth; } }
body {
  margin: 0;
  background: var(--docs-canvas);
  color: var(--docs-ink);
  font: 400 16px / 1.5 var(--font-body);
  letter-spacing: -0.01em;
  -webkit-font-smoothing: antialiased;
}
a { color: var(--docs-link); text-decoration: none; }
a:hover { text-decoration: underline; text-underline-offset: 3px; }
:focus-visible { outline: 2px solid var(--docs-primary); outline-offset: 2px; border-radius: var(--radius-sm); }
img { max-width: 100%; height: auto; display: block; }
.skip { position: absolute; left: var(--space-4); top: -100px; z-index: 50; background: var(--docs-panel); padding: var(--space-2) var(--space-4); border-radius: var(--radius-pill); }
.skip:focus { top: var(--space-3); }

/* ---------- Top bar ---------- */
.bar { position: sticky; top: 0; z-index: 30; height: var(--docs-bar); background: var(--docs-panel); border-bottom: 1px solid var(--docs-line); }
.bar-in { height: 100%; max-width: 1440px; margin: 0 auto; padding: 0 var(--space-6); display: flex; align-items: center; gap: var(--space-4); }
.brand { display: flex; align-items: center; gap: var(--space-2); color: var(--docs-ink-strong); font-weight: 600; font-size: 15px; }
.brand:hover { text-decoration: none; }
.brand img { width: 28px; height: 28px; border-radius: var(--radius-sm); }
.brand-sep { color: var(--docs-ink-3); font-weight: 400; }
.brand-docs { color: var(--docs-ink-2); font-weight: 500; }
kbd {
  display: inline-block; min-width: 22px; text-align: center;
  font: 500 12px / 20px var(--font-body); color: var(--docs-ink-2);
  padding: 0 var(--space-2); border: 1px solid var(--docs-line); border-bottom-width: 2px;
  border-radius: 6px; background: var(--docs-panel); vertical-align: 1px;
}
.bar-end { margin-left: auto; display: flex; align-items: center; gap: var(--space-2); }
.bar-link { color: var(--docs-ink-2); font-size: 14px; font-weight: 500; padding: var(--space-2) var(--space-3); border-radius: var(--radius-pill); }
.bar-link:hover { color: var(--docs-ink-strong); background: var(--docs-raised); text-decoration: none; }
.btn {
  display: inline-flex; align-items: center; justify-content: center; gap: var(--space-2);
  height: 36px; padding: 0 var(--space-5); border-radius: var(--radius-pill); border: 1px solid transparent;
  font: 600 14px / 20px var(--font-body); white-space: nowrap; cursor: pointer;
}
.btn:hover { text-decoration: none; }
.btn-primary { background: var(--docs-primary); color: var(--on-accent); }
.btn-primary:hover { background: var(--docs-primary-hover); }
.icon-btn {
  display: none; width: 36px; height: 36px; flex: none; align-items: center; justify-content: center;
  border: 0; background: transparent; color: var(--docs-ink); border-radius: var(--radius-pill); cursor: pointer;
}
.icon-btn:hover { background: var(--docs-raised); }
.icon-btn svg { width: 20px; height: 20px; }

/* ---------- Three columns ---------- */
.shell {
  max-width: 1440px; margin: 0 auto;
  display: grid; grid-template-columns: var(--docs-side) minmax(0, 1fr) var(--docs-rail);
  gap: var(--space-9); padding: 0 var(--space-6);
}

/* Sidebar: one short list of pages, then Developers and the way out, each after a hairline */
.side {
  position: sticky; top: var(--docs-bar); height: calc(100dvh - var(--docs-bar));
  overflow-y: auto; overscroll-behavior: contain; padding: var(--space-8) 0; scrollbar-width: thin;
}
.side ul { list-style: none; margin: 0; padding: 0; display: grid; gap: 2px; }
.side .side-apart { margin-top: var(--space-4); padding-top: var(--space-4); border-top: 1px solid var(--docs-line); }
.side a {
  display: flex; align-items: center; gap: var(--space-2);
  padding: 7px var(--space-3); border-radius: var(--radius-pill);
  color: var(--docs-ink-2); font: 500 14px / 20px var(--font-body);
}
.side a:hover { color: var(--docs-ink-strong); background: var(--docs-raised); text-decoration: none; }
.side a[aria-current="page"] { color: var(--docs-link); background: var(--docs-active); }
.side .side-out a { color: var(--docs-ink-3); font-weight: 400; font-size: 13px; }
.out { width: 12px; height: 12px; }
.side-close { display: none; }

/* Article */
.main { min-width: 0; padding: var(--space-9) 0 var(--space-10); }
.article { max-width: var(--docs-read); }
.article h1 { margin: 0; color: var(--docs-ink-strong); font: 600 40px / 48px var(--font-body); letter-spacing: -0.025em; text-wrap: balance; }
.lead { margin: var(--space-4) 0 0; font: 400 18px / 28px var(--font-body); color: var(--docs-ink-2); max-width: 62ch; }
.article h2 { margin: var(--space-9) 0 0; color: var(--docs-ink-strong); font: 600 24px / 32px var(--font-body); letter-spacing: -0.02em; text-wrap: balance; }
.article h3 { margin: var(--space-7) 0 0; color: var(--docs-ink-strong); font: 600 18px / 28px var(--font-body); letter-spacing: -0.015em; }
.article p, .article li { color: var(--docs-ink); max-width: 66ch; }
.article p { margin: var(--space-3) 0 0; }
.article ul, .article ol { margin: var(--space-3) 0 0; padding-left: var(--space-6); }
.article li + li { margin-top: var(--space-2); }
.article li::marker { color: var(--docs-ink-3); }
.article strong { font-weight: 600; color: var(--docs-ink-strong); }
.ui { font-weight: 600; color: var(--docs-ink-strong); }
.article code {
  font: 500 13px / 1 var(--font-mono); letter-spacing: 0;
  padding: 3px 6px; border-radius: 6px; background: var(--docs-raised); color: var(--docs-ink-strong);
}
.anchor { color: inherit; }
.anchor:hover { text-decoration: none; }
.article h2 .anchor::after, .article h3 .anchor::after { content: "#"; margin-left: var(--space-2); color: var(--docs-ink-3); opacity: 0; }
.article h2:hover .anchor::after, .article h3:hover .anchor::after { opacity: 1; }

/* The five steps at the top of Get started: a real sequence, so numbers are allowed */
.article .summary {
  list-style: none; counter-reset: step; margin: var(--space-7) 0 0; padding: var(--space-2);
  background: var(--docs-panel); border: 1px solid var(--docs-line); border-radius: var(--radius-md); box-shadow: var(--docs-shadow);
}
.article .summary li { counter-increment: step; margin: 0; max-width: none; }
.summary a {
  position: relative; display: block;
  padding: var(--space-2) var(--space-3) var(--space-2) 44px; border-radius: var(--radius-sm); color: var(--docs-ink-2);
}
.summary a::before {
  content: counter(step); position: absolute; left: var(--space-4); top: var(--space-2);
  font: 600 14px / 24px var(--font-body); color: var(--docs-ink-3); font-variant-numeric: tabular-nums;
}
.summary a:hover { background: var(--docs-raised); text-decoration: none; }
.summary b { font-weight: 600; color: var(--docs-ink-strong); }

/* Shots: the real app, whole window, framed like a window */
.shot { margin: var(--space-5) 0 0; }
/* Every shot is a whole 1440 x 900 window, so the frame holds that shape before the lazy image arrives and
   nothing below it moves. Until then it's a quiet grey box. */
.shot-frame { aspect-ratio: 1440 / 900; border-radius: var(--radius-md); overflow: hidden; background: var(--docs-raised); border: 1px solid var(--docs-line); box-shadow: var(--docs-shadow); }
.shot-frame img { width: 100%; height: 100%; object-fit: cover; }
.shot figcaption { margin-top: var(--space-2); font: 400 13px / 20px var(--font-body); color: var(--docs-ink-3); }

/* Code blocks: long lines scroll inside the block, never cut off. Copy sits in the corner. */
.code { position: relative; margin: var(--space-4) 0 0; }
/* Code shows exactly what to type: no ligatures, so // and the like stay two plain characters. */
.article code, .code pre { font-variant-ligatures: none; font-feature-settings: "liga" 0, "calt" 0; }
.code pre {
  margin: 0; padding: var(--space-4) var(--space-5); padding-right: 84px;
  background: var(--docs-panel); border: 1px solid var(--docs-line); border-radius: var(--radius-md);
  font: 500 13px / 22px var(--font-mono); letter-spacing: 0; color: var(--docs-ink-strong);
  white-space: pre; overflow-x: auto; scrollbar-width: thin;
}
.copy {
  position: absolute; top: var(--space-3); right: var(--space-3); height: 28px; padding: 0 var(--space-3);
  border: 1px solid var(--docs-line); border-radius: var(--radius-pill); background: var(--docs-panel);
  font: 500 12px / 1 var(--font-body); color: var(--docs-ink-2); cursor: pointer;
}
.copy:hover { border-color: var(--docs-line-lift); color: var(--docs-ink-strong); }
/* A reply sits right under its request, on the grey of the page's fills, so the two read as a pair */
.code.reply { margin-top: var(--space-2); }
.code.reply pre { padding-right: var(--space-5); background: var(--docs-raised); border-color: transparent; color: var(--docs-ink); }
.article .code-note { margin-top: var(--space-2); font: 400 13px / 20px var(--font-body); color: var(--docs-ink-3); }

/* What's new: the date, then one line. Newest first. */
.article .changes { list-style: none; margin: var(--space-7) 0 0; padding: 0; border-top: 1px solid var(--docs-line); }
.article .changes li { display: grid; grid-template-columns: 120px minmax(0, 1fr); gap: var(--space-5); margin: 0; padding: var(--space-4) 0; border-bottom: 1px solid var(--docs-line); max-width: none; }
.changes time { font: 500 14px / 24px var(--font-body); color: var(--docs-ink-3); font-variant-numeric: tabular-nums; white-space: nowrap; }
.article .changes p { margin: 0; }

/* Previous and next */
.pager { margin: var(--space-10) 0 0; padding-top: var(--space-6); border-top: 1px solid var(--docs-line); display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-3); }
.pager a { display: block; padding: var(--space-4) var(--space-5); border: 1px solid var(--docs-line); border-radius: var(--radius-md); background: var(--docs-panel); }
.pager a:hover { border-color: var(--docs-line-lift); text-decoration: none; }
.pager small { display: block; font: 400 13px / 20px var(--font-body); color: var(--docs-ink-3); }
.pager b { display: block; margin-top: 2px; font: 600 15px / 22px var(--font-body); color: var(--docs-ink-strong); }
.pager .next { grid-column: 2; text-align: right; }
.page-foot { margin-top: var(--space-6); font: 400 13px / 20px var(--font-body); color: var(--docs-ink-3); }

/* On this page */
.rail { position: sticky; top: var(--docs-bar); align-self: start; padding: var(--space-9) 0 var(--space-8); max-height: calc(100dvh - var(--docs-bar)); overflow-y: auto; }
.rail-head { margin: 0 0 var(--space-3); font: 600 13px / 20px var(--font-body); color: var(--docs-ink-strong); }
.rail ol { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--docs-line); }
.rail a { display: block; margin-left: -1px; padding: 4px 0 4px var(--space-4); border-left: 1px solid transparent; font: 400 13px / 20px var(--font-body); color: var(--docs-ink-2); }
.rail a:hover { color: var(--docs-ink-strong); text-decoration: none; }
.rail a.is-here { color: var(--docs-link); border-left-color: var(--docs-link); }
.rail .sub a { padding-left: var(--space-7); }

/* Below 1180px, "On this page" folds into one row under the lead */
.toc-mobile { display: none; margin: var(--space-6) 0 0; border: 1px solid var(--docs-line); border-radius: var(--radius-md); background: var(--docs-panel); }
.toc-mobile summary { list-style: none; cursor: pointer; padding: var(--space-3) var(--space-4); font: 500 14px / 20px var(--font-body); display: flex; justify-content: space-between; align-items: center; }
.toc-mobile summary::-webkit-details-marker { display: none; }
.toc-mobile summary svg { width: 16px; height: 16px; color: var(--docs-ink-3); transition: transform 0.2s; }
.toc-mobile[open] summary svg { transform: rotate(180deg); }
.article .toc-mobile ol { list-style: none; margin: 0; padding: 0 var(--space-4) var(--space-3); }
.article .toc-mobile li { margin: 0; }
.toc-mobile a { display: block; padding: 6px 0; color: var(--docs-ink-2); font-size: 14px; }

/* ---------- Narrower screens ---------- */
.scrim { position: fixed; inset: 0; z-index: 40; background: var(--docs-scrim); opacity: 0; pointer-events: none; transition: opacity 0.2s; }

@media (max-width: 1180px) {
  .shell { grid-template-columns: var(--docs-side) minmax(0, 1fr); gap: var(--space-8); }
  .rail { display: none; }
  .toc-mobile { display: block; }
}

@media (max-width: 860px) {
  .bar-in { padding: 0 var(--space-4); gap: var(--space-1); }
  .icon-btn { display: inline-flex; }
  .bar-link { display: none; }
  .brand { margin-right: auto; margin-left: var(--space-1); }
  .bar-end { gap: var(--space-1); }
  .shell { grid-template-columns: minmax(0, 1fr); padding: 0 var(--space-4); gap: 0; }
  .side {
    position: fixed; z-index: 45; top: 0; left: 0; bottom: 0; width: min(300px, 86vw); height: 100dvh;
    background: var(--docs-panel); padding: var(--space-4) var(--space-3) var(--space-8);
    transform: translateX(-100%); visibility: hidden;
    transition: transform 0.24s cubic-bezier(0.4, 0, 0.2, 1), visibility 0s 0.24s;
  }
  .side-close { display: flex; justify-content: space-between; align-items: center; margin: 0 0 var(--space-4) var(--space-3); }
  .side-title { font: 600 15px / 20px var(--font-body); color: var(--docs-ink-strong); }
  body.menu-open .side { transform: none; visibility: visible; transition: transform 0.24s cubic-bezier(0.4, 0, 0.2, 1); }
  body.menu-open .scrim { opacity: 1; pointer-events: auto; }
  body.menu-open { overflow: hidden; }
  .main { padding: var(--space-7) 0 var(--space-9); }
  .article h1 { font-size: 32px; line-height: 40px; }
  .lead { font-size: 17px; line-height: 26px; }
  .article h2 { margin-top: var(--space-8); font-size: 22px; line-height: 30px; }
  .article ul, .article ol { padding-left: var(--space-5); }
  .code pre { padding: 44px var(--space-4) var(--space-4); }
  .copy { top: var(--space-2); right: var(--space-2); }
  .article .changes li { grid-template-columns: 1fr; gap: var(--space-1); }
  .code.reply pre { padding-top: var(--space-4); }
  .pager { grid-template-columns: 1fr; }
  .pager .next { grid-column: 1; }
}

@media (prefers-reduced-motion: reduce) {
  .side, .scrim, .toc-mobile summary svg { transition: none !important; }
}
