/* Anvil docs — Vercel/Supabase-adjacent: near-monochrome, tight, human. Blue is reserved for links,
   active nav marker, and the CTA. Everything else lives on a neutral grey scale. */

:root {
  /* Anvil blue — used sparingly */
  --anvil:         #4c8bff;
  --anvil-strong:  #2a6bf0;
  --anvil-soft:    rgba(76, 139, 255, 0.08);

  /* Neutral scale (light) */
  --bg:            #ffffff;
  --bg-elev:       #ffffff;
  --surface:       #f7f8fa;
  --surface-2:     #eff1f4;

  --text:          #101114;
  --text-dim:      #2a2d34;
  --text-faint:    #5b6270;
  --text-mute:     #8a8f9b;

  --border:        #ececef;
  --border-strong: #dcdee3;
  --border-soft:   #f2f3f5;

  --link:          var(--anvil-strong);
  --link-hover:    #1b56dd;

  /* Callout accents (left stripe only, no icon) */
  --note-stripe:   #d5dfef;
  --warn-stripe:   #eab948;
  --danger-stripe: #d95541;

  --note-tint:     #f7f9fc;
  --warn-tint:     #fdf8ec;
  --danger-tint:   #fcf3f1;

  --code-bg:       #f7f8fa;
  --code-border:   #ececef;
  --code-fg:       #101114;
  --code-inline-bg: #eef1f6;
  --code-inline-fg: #2a2d34;

  --success:       #16794f;
  --success-tint:  #ebf6f0;

  /* Type */
  --font-sans: 'Inter', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
  --font-mono: ui-monospace, 'SF Mono', 'JetBrains Mono', Menlo, Consolas, monospace;

  /* Sizes */
  --topbar-h: 56px;
  --sidebar-w: 252px;
  --toc-w: 236px;
  --content-max: 740px;

  /* Motion — minimal, quick */
  --ease: cubic-bezier(0.4, 0, 0.2, 1);
  --dur: 120ms;

  --radius: 6px;
  --radius-lg: 8px;

  color-scheme: light;
}

/* Dark surface — closer to Vercel's #0a0a0a base than a saturated navy */
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --bg:            #0a0a0b;
    --bg-elev:       #0f0f11;
    --surface:       #131316;
    --surface-2:     #1a1a1e;

    --text:          #ededef;
    --text-dim:      #cfd0d4;
    --text-faint:    #8f9199;
    --text-mute:     #6a6c74;

    --border:        #22232a;
    --border-strong: #2d2f38;
    --border-soft:   #1a1b21;

    --link:          #7ea6ff;
    --link-hover:    #a2beff;

    --note-stripe:   #3a4a70;
    --warn-stripe:   #b58a35;
    --danger-stripe: #a4453a;

    --note-tint:     rgba(76, 139, 255, 0.05);
    --warn-tint:     rgba(181, 138, 53, 0.08);
    --danger-tint:   rgba(164, 69, 58, 0.08);

    --code-bg:       #0f0f11;
    --code-border:   #22232a;
    --code-fg:       #d9dae0;
    --code-inline-bg: #1a1a1e;
    --code-inline-fg: #c4c6cd;

    --success:       #4bb385;
    --success-tint:  rgba(75, 179, 133, 0.10);

    color-scheme: dark;
  }
}

:root[data-theme="dark"] {
  --bg:            #0a0a0b;
  --bg-elev:       #0f0f11;
  --surface:       #131316;
  --surface-2:     #1a1a1e;

  --text:          #ededef;
  --text-dim:      #cfd0d4;
  --text-faint:    #8f9199;
  --text-mute:     #6a6c74;

  --border:        #22232a;
  --border-strong: #2d2f38;
  --border-soft:   #1a1b21;

  --link:          #7ea6ff;
  --link-hover:    #a2beff;

  --note-stripe:   #3a4a70;
  --warn-stripe:   #b58a35;
  --danger-stripe: #a4453a;

  --note-tint:     rgba(76, 139, 255, 0.05);
  --warn-tint:     rgba(181, 138, 53, 0.08);
  --danger-tint:   rgba(164, 69, 58, 0.08);

  --code-bg:       #0f0f11;
  --code-border:   #22232a;
  --code-fg:       #d9dae0;
  --code-inline-bg: #1a1a1e;
  --code-inline-fg: #c4c6cd;

  --success:       #4bb385;
  --success-tint:  rgba(75, 179, 133, 0.10);

  color-scheme: dark;
}

/* -------- premium theme-swap transition --------
   Applied only during a theme toggle (added by app.js for ~420ms). The
   long ease covers the visible surfaces — background, text color, border,
   fill, box-shadow — so the whole page cross-fades between light and dark
   instead of snap-swapping. `will-change` is not set because this only
   runs on user action, not continuously. */
html.theme-transitioning,
html.theme-transitioning body,
html.theme-transitioning * {
  transition:
    background-color 420ms cubic-bezier(0.22, 1, 0.36, 1),
    color 420ms cubic-bezier(0.22, 1, 0.36, 1),
    border-color 420ms cubic-bezier(0.22, 1, 0.36, 1),
    fill 420ms cubic-bezier(0.22, 1, 0.36, 1),
    stroke 420ms cubic-bezier(0.22, 1, 0.36, 1),
    box-shadow 420ms cubic-bezier(0.22, 1, 0.36, 1) !important;
}
/* Don't animate anything that carries a transform (icons, chevrons) —
   the color fade is enough, and animating transform here can pop. */
html.theme-transitioning *::before,
html.theme-transitioning *::after {
  transition:
    background-color 420ms cubic-bezier(0.22, 1, 0.36, 1),
    color 420ms cubic-bezier(0.22, 1, 0.36, 1),
    border-color 420ms cubic-bezier(0.22, 1, 0.36, 1),
    fill 420ms cubic-bezier(0.22, 1, 0.36, 1) !important;
}
@media (prefers-reduced-motion: reduce) {
  html.theme-transitioning,
  html.theme-transitioning body,
  html.theme-transitioning *,
  html.theme-transitioning *::before,
  html.theme-transitioning *::after {
    transition: none !important;
  }
}

/* -------- base -------- */
* { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; scroll-padding-top: calc(var(--topbar-h) + 12px); }
body {
  margin: 0;
  font-family: var(--font-sans);
  font-size: 14.5px;
  line-height: 1.65;
  color: var(--text-dim);
  background: var(--bg);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  font-feature-settings: 'ss01', 'cv02', 'cv11';
  letter-spacing: -0.005em;
}
a { color: var(--link); text-decoration: none; transition: color var(--dur) var(--ease); }
a:hover { color: var(--link-hover); }

:focus-visible {
  outline: 2px solid var(--anvil);
  outline-offset: 2px;
  border-radius: 3px;
}

.skip-link {
  position: fixed; top: 8px; left: 8px;
  background: var(--text); color: var(--bg);
  padding: 6px 10px; border-radius: 4px;
  transform: translateY(-200%);
  z-index: 100; font-size: 13px;
}
.skip-link:focus-visible { transform: translateY(0); color: var(--bg); }

/* -------- topbar -------- */
.topbar {
  position: sticky; top: 0; z-index: 30;
  height: var(--topbar-h);
  background: var(--bg);
  border-bottom: 1px solid var(--border);
}
.topbar-inner {
  height: 100%;
  max-width: 1440px;
  margin: 0 auto;
  padding: 0 40px;
  display: grid;
  grid-template-columns: auto minmax(0, 1fr) auto;
  align-items: center;
  column-gap: 36px;
}

/* The brand slot is a group of TWO links: the mark+wordmark goes back
   to the marketing homepage (anvilcontrol.ai); the "Docs" subtitle goes
   to the docs landing. Visually they read as one unit separated by a
   subtle divider. */
.brand-group {
  display: inline-flex; align-items: center; gap: 8px;
  min-width: 220px;
}
.brand {
  display: inline-flex; align-items: center; gap: 9px;
  color: var(--text); font-weight: 600; letter-spacing: -0.02em;
  text-decoration: none;
  font-size: 14.5px;
  transition: opacity var(--dur) var(--ease);
}
.brand:hover { color: var(--text); opacity: 0.72; }
.brand:focus-visible { outline: 2px solid var(--anvil); outline-offset: 4px; border-radius: 2px; }
.brand-sub-link {
  color: var(--text-faint);
  font-weight: 400;
  font-size: 13.5px;
  letter-spacing: -0.005em;
  text-decoration: none;
  transition: color var(--dur) var(--ease);
}
.brand-sub-link:hover { color: var(--text); }
.brand-sub-link:focus-visible { outline: 2px solid var(--anvil); outline-offset: 3px; border-radius: 2px; }
.brand-mark {
  color: var(--text);
  display: inline-flex; align-items: center;
  justify-content: center;
  flex: 0 0 auto;
}
.brand-mark img {
  display: block;
  width: 30px; height: 16px;
  /* Halftone PNG is white-on-transparent — invert in light mode so it reads dark. */
  filter: invert(1);
}
:root[data-theme="dark"] .brand-mark img { filter: none; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .brand-mark img { filter: none; }
}
.brand-wordmark { color: var(--text); }
.brand-dot { color: var(--text); }
.brand-divider {
  width: 1px; height: 16px;
  background: var(--border-strong);
  margin: 0 3px;
}
.brand-sub {
  color: var(--text-faint);
  font-weight: 400;
  font-size: 13.5px;
  letter-spacing: -0.005em;
}

/* search launcher — takes most of the top row */
.search-open {
  justify-self: stretch;
  width: 100%;
  max-width: 640px;
  height: 36px;
  display: inline-flex; align-items: center; gap: 10px;
  padding: 0 12px;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 8px;
  color: var(--text-mute);
  font: inherit; font-size: 13px;
  cursor: pointer;
  transition: border-color var(--dur) var(--ease), background var(--dur) var(--ease);
  margin: 0 auto;
}
.search-open:hover { border-color: var(--border-strong); background: var(--bg-elev); }
.search-open-label { flex: 1; text-align: left; }
.kbd {
  display: inline-flex; align-items: center;
  padding: 1px 5px;
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: 3px;
  font: 500 10.5px var(--font-mono);
  color: var(--text-faint);
  letter-spacing: 0.02em;
}

.topbar-right { display: inline-flex; align-items: center; gap: 8px; min-width: 220px; justify-content: flex-end; }

.status-badge {
  display: inline-flex; align-items: center; gap: 6px;
  height: 28px; padding: 0 10px;
  border-radius: 4px;
  border: 1px solid var(--border);
  background: var(--bg);
  font-size: 12.5px;
  color: var(--text-faint);
  font-weight: 500;
}
.status-dot {
  width: 6px; height: 6px; border-radius: 50%;
  background: var(--success);
}
.status-badge:hover { color: var(--text); border-color: var(--border-strong); }

.theme-toggle {
  width: 28px; height: 28px;
  border: 1px solid var(--border);
  background: var(--bg);
  border-radius: 4px; cursor: pointer;
  display: inline-flex; align-items: center; justify-content: center;
  color: var(--text-faint);
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.theme-toggle:hover { color: var(--text); border-color: var(--border-strong); }
.theme-toggle .ico-moon { display: none; }
:root[data-theme="dark"] .theme-toggle .ico-sun { display: none; }
:root[data-theme="dark"] .theme-toggle .ico-moon { display: inline; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .theme-toggle .ico-sun { display: none; }
  :root:not([data-theme="light"]) .theme-toggle .ico-moon { display: inline; }
}

.cta {
  display: inline-flex; align-items: center;
  height: 28px; padding: 0 12px;
  background: var(--anvil-strong); color: #fff;
  border-radius: 4px;
  font-weight: 500; font-size: 12.5px;
  letter-spacing: -0.005em;
  text-decoration: none;
  transition: background var(--dur) var(--ease);
}
.cta:hover { background: var(--anvil); color: #fff; }
:root[data-theme="dark"] .cta { background: #fff; color: #0a0a0b; }
:root[data-theme="dark"] .cta:hover { background: #e4e4e6; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .cta { background: #fff; color: #0a0a0b; }
  :root:not([data-theme="light"]) .cta:hover { background: #e4e4e6; }
}

.menu-toggle {
  display: none;
  width: 30px; height: 30px;
  background: transparent; border: 1px solid var(--border);
  border-radius: 4px; cursor: pointer;
  padding: 0;
  flex-direction: column; justify-content: center; align-items: center; gap: 3px;
}
.menu-toggle span { display: block; width: 14px; height: 1.5px; background: var(--text); border-radius: 1px; }

/* -------- shell -------- */
.shell {
  max-width: 1440px;
  margin: 0 auto;
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  gap: 0;
  padding: 0 40px;
}

/* sidebar — flex column, foot pinned to bottom */
.sidebar {
  padding: 24px 12px 20px 0;
  position: sticky; top: var(--topbar-h);
  height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  display: flex; flex-direction: column;
}
.sidebar-inner { padding-right: 8px; flex: 1 1 auto; }

.side-home {
  display: block;
  padding: 4px 10px;
  margin-bottom: 20px;
  border-radius: 4px;
  color: var(--text-faint);
  font-size: 13px;
  font-weight: 500;
  border-left: 2px solid transparent;
  margin-left: -2px;
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease);
}
.side-home:hover { color: var(--text); background: var(--surface); }
.side-home.is-active {
  color: var(--text);
  background: var(--surface);
  border-left-color: var(--text);
}

.nav-group + .nav-group { margin-top: 22px; }
.nav-group-title {
  padding: 4px 10px 6px;
  font-size: 11px;
  letter-spacing: 0.02em;
  color: var(--text-mute);
  font-weight: 600;
}
.nav-list { list-style: none; margin: 0; padding: 0; }
.nav-list li { margin: 0; }
.nav-link {
  display: block;
  padding: 4px 10px;
  border-radius: 4px;
  color: var(--text-faint);
  font-size: 13px;
  line-height: 1.55;
  border-left: 2px solid transparent;
  margin-left: -2px;
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.nav-link:hover { color: var(--text); background: var(--surface); }
.nav-link.is-active {
  color: var(--text);
  background: var(--surface);
  border-left-color: var(--text);
  font-weight: 500;
}

.sidebar-foot {
  flex: 0 0 auto;
  padding: 12px 10px 4px;
  border-top: 1px solid var(--border-soft);
}
.foot-stamp {
  font-size: 11px;
  color: var(--text-mute);
  letter-spacing: 0.03em;
  font-weight: 500;
}

/* main */
.main {
  padding: 44px 56px 96px;
  min-width: 0;
}
.main:focus { outline: none; }

.crumbs {
  display: flex; align-items: center; gap: 6px;
  font-size: 12.5px; color: var(--text-mute);
  margin-bottom: 28px;
  letter-spacing: -0.005em;
}
.crumbs a { color: var(--text-faint); }
.crumbs a:hover { color: var(--text); }
.crumbs-current { color: var(--text-dim); }

.content { max-width: var(--content-max); }

/* headings */
.content h1 {
  font-size: 30px;
  line-height: 1.2;
  letter-spacing: -0.028em;
  margin: 0;
  font-weight: 600;
  color: var(--text);
  text-wrap: balance;
  flex: 1 1 auto;
  min-width: 0;
}
/* H1 row — H1 + star button, aligned on baseline row */
.h1-row {
  display: flex;
  align-items: center;
  gap: 12px;
  margin: 0 0 14px;
}
/* Page-level star button — sits to the right of the H1 */
.page-star {
  flex: 0 0 auto;
  display: inline-flex; align-items: center; justify-content: center;
  width: 32px; height: 32px;
  border: 1px solid var(--border);
  background: var(--bg);
  border-radius: 6px;
  color: var(--text-mute);
  cursor: pointer;
  padding: 0;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease), background var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.page-star:hover {
  color: var(--text);
  border-color: var(--border-strong);
  background: var(--surface);
}
.page-star:focus-visible {
  outline: 2px solid var(--anvil);
  outline-offset: 2px;
}
.page-star.is-on {
  color: #eab24a;
  border-color: color-mix(in oklab, #eab24a 40%, var(--border));
  background: color-mix(in oklab, #eab24a 8%, transparent);
}
:root[data-theme="dark"] .page-star.is-on {
  color: #f4c256;
  background: color-mix(in oklab, #f4c256 10%, transparent);
}
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .page-star.is-on {
    color: #f4c256;
    background: color-mix(in oklab, #f4c256 10%, transparent);
  }
}
.page-star.is-flash { animation: star-flash 320ms var(--ease); }
@keyframes star-flash {
  0%   { transform: scale(1); }
  40%  { transform: scale(1.18); }
  100% { transform: scale(1); }
}
@media (prefers-reduced-motion: reduce) {
  .page-star.is-flash { animation: none; }
}
.content h2 {
  font-size: 20px;
  line-height: 1.35;
  letter-spacing: -0.02em;
  margin: 56px 0 12px;
  font-weight: 600;
  color: var(--text);
  padding-top: 4px;
  position: relative;
  text-wrap: balance;
}
.content p { text-wrap: pretty; }
.content h3 {
  font-size: 15.5px;
  line-height: 1.4;
  letter-spacing: -0.012em;
  margin: 32px 0 8px;
  font-weight: 600;
  color: var(--text);
}
.content h4 { font-size: 14px; margin: 20px 0 6px; font-weight: 600; color: var(--text); }

.anchor {
  position: absolute; margin-left: -18px;
  color: var(--text-mute); opacity: 0;
  text-decoration: none; font-weight: 400;
  transition: opacity var(--dur) var(--ease);
}
.content h2:hover .anchor, .content h3:hover .anchor { opacity: 1; }
.anchor:hover { color: var(--text); }

/* text */
.content p {
  margin: 0 0 16px;
  color: var(--text-dim);
}
.content strong { color: var(--text); font-weight: 600; }
.content em { color: var(--text-dim); font-style: italic; }
.content del { color: var(--text-mute); }

/* content links — subtle underline, blue on hover only */
.content a {
  color: var(--link);
  border-bottom: 1px solid color-mix(in oklab, var(--link) 30%, transparent);
  transition: border-color var(--dur) var(--ease), color var(--dur) var(--ease);
}
.content a:hover {
  border-bottom-color: var(--link);
  color: var(--link-hover);
}

/* lists */
.content ul, .content ol {
  margin: 0 0 16px;
  padding-left: 22px;
  color: var(--text-dim);
}
.content ul li, .content ol li { margin: 4px 0; }
.content li.task { list-style: none; margin-left: -22px; }
.content li.task input { margin-right: 8px; }

/* blockquote — plain */
.content blockquote {
  margin: 16px 0;
  padding: 8px 14px;
  border-left: 2px solid var(--border-strong);
  color: var(--text-faint);
  font-style: normal;
}
.content blockquote p:last-child { margin-bottom: 0; }

/* callouts — no side stripe; small uppercase colored label at the top */
.callout {
  display: block;
  padding: 12px 16px 14px;
  margin: 22px 0;
  border-radius: 7px;
  border: 1px solid var(--border);
  background: var(--note-tint);
  color: var(--text-dim);
  font-size: 14px;
}
.callout p:last-child { margin-bottom: 0; }
.callout-icon { display: none; }
.callout-body { min-width: 0; text-wrap: pretty; }
.callout-label {
  display: inline-block;
  font-size: 10.5px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--anvil-strong);
  margin-bottom: 6px;
}
:root[data-theme="dark"] .callout-label { color: var(--anvil); }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .callout-label { color: var(--anvil); }
}
.callout-warning { background: var(--warn-tint); }
/* Light-mode label darkened from #b0801f: at 10.5px/600 uppercase this is
   normal-size text for WCAG, and #b0801f on --warn-tint measured 3.33:1 —
   under the 4.5:1 floor. #8a6310 is the same gold, 5.12:1. Same hue family,
   so the amber read is unchanged. (Dark mode already measured 10.07:1.) */
.callout-warning .callout-label { color: #8a6310; }
:root[data-theme="dark"] .callout-warning .callout-label { color: #eab948; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .callout-warning .callout-label { color: #eab948; }
}
.callout-danger  { background: var(--danger-tint); }
.callout-danger .callout-label { color: #b53a2b; }
:root[data-theme="dark"] .callout-danger .callout-label { color: #e88072; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .callout-danger .callout-label { color: #e88072; }
}

/* hr */
.content hr {
  border: 0; height: 1px;
  background: var(--border);
  margin: 48px 0;
}

/* code — inline */
.content code {
  font-family: var(--font-mono);
  font-size: 0.87em;
  background: var(--code-inline-bg);
  color: var(--code-inline-fg);
  padding: 1.5px 5px;
  border-radius: 3px;
  font-weight: 500;
  letter-spacing: 0;
}
.content h1 code, .content h2 code, .content h3 code {
  background: transparent; color: inherit; padding: 0;
  font-size: 0.92em;
}
.content a code { color: inherit; }

/* code blocks — no header bar; copy button on hover only */
.code-block {
  position: relative;
  margin: 18px 0;
  border-radius: 6px;
  border: 1px solid var(--code-border);
  background: var(--code-bg);
  overflow: hidden;
}
.code-head {
  position: absolute; top: 0; right: 0;
  display: flex; align-items: center; gap: 6px;
  padding: 8px 10px;
  z-index: 1;
  opacity: 0;
  transition: opacity var(--dur) var(--ease);
}
.code-block:hover .code-head { opacity: 1; }
.code-block:focus-within .code-head { opacity: 1; }
.code-lang {
  font: 500 10.5px var(--font-mono);
  color: var(--text-mute);
  letter-spacing: 0.04em;
  text-transform: uppercase;
  padding: 2px 6px;
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: 3px;
}
.code-copy {
  background: var(--bg);
  border: 1px solid var(--border);
  color: var(--text-faint);
  border-radius: 3px;
  padding: 3px 8px;
  font: 500 11px var(--font-sans);
  cursor: pointer;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.code-copy:hover { color: var(--text); border-color: var(--border-strong); }
.code-copy.is-copied { color: var(--success); border-color: var(--success); }
.code-block pre {
  margin: 0;
  padding: 14px 16px;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 12.5px;
  line-height: 1.65;
  color: var(--code-fg);
}
.code-block pre code {
  background: transparent; color: inherit; padding: 0; font-weight: 400;
  font-size: inherit;
  letter-spacing: 0;
}

/* tables */
.table-wrap {
  margin: 20px 0;
  overflow-x: auto;
  border: 1px solid var(--border);
  border-radius: 6px;
}
.content table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13.5px;
}
.content thead { background: var(--surface); }
.content th, .content td {
  padding: 9px 14px;
  text-align: left;
  border-bottom: 1px solid var(--border-soft);
  color: var(--text-dim);
  vertical-align: top;
}
.content th {
  font-weight: 600;
  color: var(--text);
  font-size: 12.5px;
  letter-spacing: 0.005em;
}
.content tbody tr:last-child td { border-bottom: 0; }

/* screenshot placeholders — clean bordered frame, no stripes */
/* Real figures. The screenshots are dark product UI, so the frame is a hairline
   rather than a card — a filled surface behind a dark image reads as a double border. */
.doc-figure { margin: 24px 0; }
.doc-figure img {
  display: block;
  width: 100%;
  height: auto;
  border: 1px solid var(--border);
  border-radius: 6px;
}
/* Video sits in the same frame as a screenshot — same border, same radius, same rhythm —
   so a page that mixes the two reads as one column rather than two treatments. The black
   background covers the letterbox on a clip whose aspect does not match the column. */
.doc-figure-video video {
  display: block;
  width: 100%;
  height: auto;
  aspect-ratio: 16 / 9;
  background: #000;
  border: 1px solid var(--border);
  border-radius: 6px;
}
.doc-figure figcaption {
  margin-top: 10px;
  font-size: 12.5px;
  line-height: 1.55;
  color: var(--text-faint);
}

.placeholder-figure { margin: 24px 0; }
.placeholder-box {
  min-height: 200px;
  border: 1px solid var(--border);
  border-radius: 6px;
  background: var(--surface);
  display: flex; flex-direction: column; justify-content: center; align-items: center;
  gap: 8px;
  padding: 24px;
  text-align: center;
  color: var(--text-mute);
  transition: border-color var(--dur) var(--ease);
}
.placeholder-tag {
  font-size: 10.5px;
  letter-spacing: 0.04em;
  padding: 2px 7px;
  border-radius: 3px;
  background: var(--bg);
  border: 1px solid var(--border);
  color: var(--text-faint);
  font-weight: 500;
}
.placeholder-caption {
  font-size: 12.5px;
  max-width: 460px;
  color: var(--text-faint);
  line-height: 1.5;
}

/* TOC (right rail) — flush, roomier type, subtle left indicator on active */
.tocpane {
  padding: 40px 8px 32px 32px;
  position: sticky; top: var(--topbar-h);
  height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
}
.toc-title {
  font-size: 11.5px;
  color: var(--text-mute);
  font-weight: 600;
  margin-bottom: 12px;
  letter-spacing: 0.02em;
  padding-left: 12px;
}
.toc ul { list-style: none; margin: 0; padding: 0; }
.toc li a {
  display: block;
  padding: 4px 12px;
  border-left: 1px solid var(--border-soft);
  font-size: 13px;
  color: var(--text-faint);
  line-height: 1.55;
  text-wrap: pretty;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.toc li a:hover { color: var(--text); border-left-color: var(--border-strong); }
.toc li a.is-active {
  color: var(--text);
  font-weight: 500;
  border-left-color: var(--text);
}
.toc .toc-h3 a { padding-left: 24px; font-size: 12.5px; color: var(--text-mute); }
.toc .toc-h3 a.is-active { color: var(--text); }

/* page footer — small outlined tiles like Vercel */
.page-foot {
  max-width: var(--content-max);
  margin-top: 64px;
  padding-top: 24px;
  border-top: 1px solid var(--border);
}
.prev-next {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  margin-bottom: 24px;
}
.pn-tile {
  display: flex;
  align-items: center;
  gap: 14px;
  padding: 14px 18px;
  min-height: 66px;
  border: 1px solid var(--border);
  border-radius: 8px;
  color: var(--text-dim);
  background: var(--bg);
  transition: border-color var(--dur) var(--ease), color var(--dur) var(--ease), background var(--dur) var(--ease);
  text-decoration: none;
}
.pn-tile:hover { border-color: var(--border-strong); color: var(--text); background: var(--surface); }
.pn-text {
  display: flex; flex-direction: column; gap: 2px;
  min-width: 0;
  flex: 1;
}
.pn-label {
  font-size: 11.5px;
  color: var(--text-mute);
  font-weight: 500;
  letter-spacing: 0.005em;
}
.pn-title {
  font-size: 14.5px;
  font-weight: 600;
  letter-spacing: -0.015em;
  color: var(--text);
  text-wrap: pretty;
  line-height: 1.35;
}
.pn-arrow {
  color: var(--text-mute);
  font-size: 16px;
  line-height: 1;
  flex: 0 0 auto;
  transition: color var(--dur) var(--ease), transform var(--dur) var(--ease);
}
.pn-tile:hover .pn-arrow { color: var(--text); }
.pn-next { text-align: right; }
.pn-next .pn-text { align-items: flex-end; }

.related {
  padding: 16px 0;
  border-top: 1px solid var(--border-soft);
  margin-bottom: 18px;
}
.related-title {
  font-size: 11px;
  color: var(--text-mute);
  font-weight: 600;
  margin-bottom: 8px;
  letter-spacing: 0.02em;
}
.related ul {
  list-style: none;
  margin: 0; padding: 0;
  display: flex; flex-wrap: wrap; gap: 4px 16px;
}
.related a {
  font-size: 13.5px;
  color: var(--text-faint);
}
.related a:hover { color: var(--text); }

.page-meta {
  display: flex; align-items: center; gap: 14px; flex-wrap: wrap;
  font-size: 12px; color: var(--text-mute);
  padding-top: 4px;
}
.page-meta .dot { color: var(--text-mute); }
.edit-link { color: var(--text-faint); }
.edit-link:hover { color: var(--text); }
.feedback { display: inline-flex; align-items: center; gap: 4px; }
.fb {
  background: transparent;
  border: 1px solid var(--border);
  border-radius: 3px;
  padding: 1px 6px;
  color: var(--text-faint);
  cursor: pointer;
  font: inherit; font-size: 12px;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.fb:hover { color: var(--text); border-color: var(--border-strong); }
.fb.is-selected { color: var(--text); border-color: var(--border-strong); }

/* -------- search dialog -------- */
dialog.search {
  border: 1px solid var(--border);
  border-radius: 10px;
  background: var(--bg);
  color: var(--text);
  padding: 0;
  width: min(600px, 92vw);
  max-height: 68vh;
  margin: 12vh auto auto;
  box-shadow: 0 24px 48px rgba(15, 20, 30, 0.16), 0 8px 16px rgba(15, 20, 30, 0.08);
  overflow: hidden;
}
:root[data-theme="dark"] dialog.search { box-shadow: 0 24px 60px rgba(0, 0, 0, 0.55); }
dialog.search::backdrop {
  background: rgba(15, 20, 30, 0.30);
}
dialog.search[open] {
  display: flex; flex-direction: column;
}

.search-form {
  display: flex; align-items: center; gap: 10px;
  padding: 14px 16px;
  border-bottom: 1px solid var(--border);
}
.search-ico { color: var(--text-mute); flex: 0 0 16px; }
.search-input {
  flex: 1;
  border: 0; outline: 0; background: transparent;
  font: inherit; font-size: 14px;
  color: var(--text);
}
.search-input::placeholder { color: var(--text-mute); }
.search-esc { flex: 0 0 auto; }

.search-results {
  flex: 1; overflow-y: auto;
  padding: 6px 8px;
}
.sr-empty, .sr-hint-empty {
  padding: 32px 20px;
  color: var(--text-mute);
  font-size: 13px; text-align: center;
}
.sr-group {
  padding: 12px 10px 6px;
  font-size: 10.5px;
  letter-spacing: 0.06em;
  color: var(--text-mute);
  font-weight: 600;
  text-transform: uppercase;
  display: inline-flex; align-items: center; gap: 8px;
  width: 100%;
}
.sr-group-ico {
  display: inline-flex; align-items: center; justify-content: center;
  width: 14px; height: 14px;
  font-size: 11px;
  color: var(--text-faint);
  text-transform: none;
  letter-spacing: 0;
}
.sr-group-starred .sr-group-ico { color: #eab24a; }
.sr-group-count {
  margin-left: 6px;
  font-size: 9.5px;
  color: var(--text-mute);
  font-weight: 500;
  letter-spacing: 0.02em;
}
.sr-hint {
  padding: 14px 12px;
  margin: 4px 0;
  border: 1px dashed var(--border);
  border-radius: 6px;
  color: var(--text-faint);
  font-size: 12.5px;
  text-align: center;
  background: var(--surface);
}
.sr-hint-star { color: #eab24a; font-size: 12.5px; padding: 0 1px; }

/* Search result row — container with a link body and a star button sibling. */
.sr-item {
  display: flex;
  align-items: stretch;
  gap: 4px;
  border-radius: 5px;
  color: var(--text-dim);
  border: 1px solid transparent;
  transition: background var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.sr-item:hover, .sr-item.is-active {
  background: var(--surface);
  color: var(--text);
  border-color: var(--border);
}
.sr-item-body {
  display: block;
  flex: 1 1 auto;
  min-width: 0;
  padding: 9px 4px 9px 10px;
  color: inherit;
  text-decoration: none;
  border-radius: 5px;
}
.sr-item-body:hover { color: inherit; }
.sr-item-title { font-weight: 500; font-size: 13.5px; color: var(--text); letter-spacing: -0.005em; }
.sr-item-section { font-size: 11.5px; color: var(--text-mute); margin-top: 2px; }
.sr-item-snippet { font-size: 12px; color: var(--text-faint); margin-top: 4px; line-height: 1.55; }
.sr-hl { background: transparent; color: var(--link); font-weight: 500; }

/* Star button inside a search-result row. */
.sr-star {
  flex: 0 0 auto;
  align-self: center;
  display: inline-flex; align-items: center; justify-content: center;
  width: 26px; height: 26px;
  margin-right: 6px;
  background: transparent;
  border: 1px solid transparent;
  border-radius: 4px;
  color: var(--text-mute);
  cursor: pointer;
  padding: 0;
  opacity: 0.55;
  transition: color var(--dur) var(--ease), background var(--dur) var(--ease), opacity var(--dur) var(--ease), border-color var(--dur) var(--ease);
}
.sr-item:hover .sr-star,
.sr-item.is-active .sr-star,
.sr-star:focus-visible { opacity: 1; }
.sr-star:hover {
  color: var(--text);
  background: var(--bg);
  border-color: var(--border);
}
.sr-star.is-on {
  opacity: 1;
  color: #eab24a;
}
:root[data-theme="dark"] .sr-star.is-on { color: #f4c256; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .sr-star.is-on { color: #f4c256; }
}
.sr-star:focus-visible {
  outline: 2px solid var(--anvil);
  outline-offset: 2px;
}

.search-hint {
  border-top: 1px solid var(--border);
  padding: 8px 16px;
  font-size: 10.5px;
  color: var(--text-mute);
  display: flex; gap: 12px; align-items: center;
}

/* Ask-a-Question footer — surfaces when a query hits no useful match.
   Calm, dashed top border, no colored callout. Sits inside the dialog
   between .search-results and .search-hint so it survives result re-renders. */
.sr-ask {
  border-top: 1px dashed var(--border-strong);
  padding: 12px 16px 12px;
  display: flex; align-items: center; gap: 14px;
  background: var(--bg);
}
.sr-ask-hint {
  flex: 1 1 auto;
  min-width: 0;
  font-size: 12.5px;
  color: var(--text-faint);
  line-height: 1.5;
}
.sr-ask-btn {
  flex: 0 0 auto;
  display: inline-flex; align-items: center; gap: 6px;
  padding: 6px 10px;
  background: transparent;
  border: 1px solid var(--border);
  border-radius: 5px;
  font: inherit;
  font-size: 12.5px;
  font-weight: 500;
  color: var(--text);
  cursor: pointer;
  transition: color var(--dur) var(--ease), border-color var(--dur) var(--ease), background var(--dur) var(--ease);
}
.sr-ask-btn:hover { border-color: var(--border-strong); background: var(--surface); }
.sr-ask-btn:focus-visible {
  outline: 2px solid var(--anvil);
  outline-offset: 2px;
}
.sr-ask-btn.is-sent {
  color: var(--success);
  border-color: color-mix(in oklab, var(--success) 45%, var(--border));
}
.sr-ask-btn-arrow {
  color: var(--text-mute);
  font-size: 13px;
  line-height: 1;
  transition: transform var(--dur) var(--ease);
}
.sr-ask-btn:hover .sr-ask-btn-arrow { transform: translateX(2px); color: var(--text); }
@media (prefers-reduced-motion: reduce) {
  .sr-ask-btn:hover .sr-ask-btn-arrow { transform: none; }
}
@media (max-width: 780px) {
  .sr-ask { flex-direction: column; align-items: stretch; gap: 8px; }
  .sr-ask-btn { align-self: flex-end; }
}

/* -------- toast -------- */
.anvil-toast {
  position: fixed;
  bottom: 24px;
  left: 50%;
  transform: translate(-50%, 12px);
  z-index: 40;
  padding: 9px 14px;
  border-radius: 6px;
  background: var(--text);
  color: var(--bg);
  font-size: 12.5px;
  font-weight: 500;
  letter-spacing: -0.005em;
  box-shadow: 0 8px 24px rgba(15, 20, 30, 0.18), 0 2px 6px rgba(15, 20, 30, 0.10);
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--dur) var(--ease), transform var(--dur) var(--ease);
  max-width: min(90vw, 420px);
  text-align: center;
}
.anvil-toast.is-visible {
  opacity: 1;
  transform: translate(-50%, 0);
}
:root[data-theme="dark"] .anvil-toast {
  background: #f5f5f7;
  color: #0a0a0b;
  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.50);
}
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .anvil-toast {
    background: #f5f5f7;
    color: #0a0a0b;
    box-shadow: 0 8px 24px rgba(0, 0, 0, 0.50);
  }
}
@media (prefers-reduced-motion: reduce) {
  .anvil-toast { transition: opacity var(--dur) var(--ease); transform: translate(-50%, 0); }
}

/* -------- mobile -------- */
.mobile-overlay {
  position: fixed; inset: 0;
  background: rgba(15, 20, 30, 0.35);
  z-index: 25;
  opacity: 0; transition: opacity var(--dur) var(--ease);
}
.mobile-overlay.is-open { opacity: 1; }

@media (max-width: 1100px) {
  .shell { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); }
  .tocpane { display: none; }
  .main { padding: 40px 32px 96px; }
}

@media (max-width: 780px) {
  :root { --topbar-h: 48px; }

  .shell { grid-template-columns: 1fr; padding: 0 16px; }
  .main { padding: 28px 4px 60px; }

  .sidebar {
    position: fixed; top: var(--topbar-h); left: 0;
    width: 272px; max-width: 86vw;
    height: calc(100vh - var(--topbar-h));
    background: var(--bg);
    border-right: 1px solid var(--border);
    padding: 20px 12px;
    transform: translateX(-102%);
    transition: transform var(--dur) var(--ease);
    z-index: 26;
  }
  .sidebar.is-open { transform: translateX(0); }
  .sidebar-inner { padding-right: 0; }

  .topbar-inner { grid-template-columns: auto 1fr auto; gap: 12px; padding: 0 16px; }
  .search-open { min-width: 0; padding: 0 8px; max-width: 100%; }
  .search-open-label { display: none; }
  .search-open .kbd { display: none; }

  .status-badge, .cta { display: none; }
  .menu-toggle { display: inline-flex; }
  /* On mobile the "Docs" subtitle + its divider collapse; the mark alone
     stands in for identity and the marketing home is still one back-tap. */
  .brand-sub-link, .brand-divider { display: none; }
  .brand-group { min-width: 0; }

  .prev-next { grid-template-columns: 1fr; }
  .pn-next { text-align: left; }

  dialog.search { width: 96vw; max-height: 82vh; margin: 8vh auto auto; }
}

/* print */
@media print {
  .topbar, .sidebar, .tocpane, .page-foot .related, .page-foot .page-meta, dialog.search, .mobile-overlay { display: none; }
  .shell { grid-template-columns: 1fr; padding: 0; }
  .main { padding: 0; }
  body { color: #000; background: #fff; }
  .code-block { border: 1px solid #999; }
  a { color: #000; text-decoration: underline; }
}