/* =========================================================================
   Studio Documentation
   -------------------------------------------------------------------------
   Dark-first, built on the Studio design tokens: near-black ground, signal
   yellow accent, warm grey type. Typography is the product's own: Open Runde
   for everything you read, Departure Mono for everything you measure.
   ========================================================================= */

/* --- Fonts -------------------------------------------------------------- */

@font-face {
  font-family: "Open Runde";
  src: url("/docs/fonts/OpenRunde-Medium.woff2") format("woff2");
  font-weight: 400 500;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: "Open Runde";
  src: url("/docs/fonts/OpenRunde-Semibold.woff2") format("woff2");
  font-weight: 600 700;
  font-style: normal;
  font-display: swap;
}

@font-face {
  font-family: "Departure Mono";
  src: url("/docs/fonts/DepartureMono-Regular.woff2") format("woff2");
  font-weight: 400;
  font-style: normal;
  font-display: swap;
}

/* --- Tokens ------------------------------------------------------------- */

:root {
  /* Studio palette, lifted from frontend/src/app/globals.css */
  --ht-black: #222222;
  --ht-grey-light: #e9e9e9;
  --ht-grey-mid: #cacaca;
  --ht-grey-dark: #7e7e7e;
  --ht-yellow: #ffcb00;
  --ht-yellow-hover: #ffe173;
  --ht-green: #3bcc5a;
  --ht-blue: #0099ff;
  --ht-orange: #ffa05f;
  --ht-red: #ff5f56;
  --ht-purple: #b799fb;

  /* Dark theme surfaces */
  --ground: #1b1b1b;
  --surface: #222222;
  --surface-2: #262626;
  --surface-3: #2e2e2e;
  --recess: #171717;

  --text: #e9e9e9;
  --text-2: rgba(233, 233, 233, 0.66);
  --text-3: rgba(233, 233, 233, 0.58);

  --line: rgba(233, 233, 233, 0.1);
  --line-strong: rgba(233, 233, 233, 0.18);

  --accent: var(--ht-yellow);
  /* --accent paints surfaces and marks; --accent-text is for accent-coloured
     TEXT, which has to clear 4.5:1. On dark they are the same yellow; on light
     the surface yellow is far too bright to read, so they diverge. */
  --accent-text: var(--ht-yellow);
  --accent-soft: rgba(255, 203, 0, 0.14);
  --accent-line: rgba(255, 203, 0, 0.34);
  --on-accent: #1b1b1b;

  --grid: rgba(233, 233, 233, 0.028);
  --glow: rgba(255, 203, 0, 0.055);

  /* Syntax */
  --t-cm: rgba(233, 233, 233, 0.34);
  --t-st: #b6e7a8;
  --t-nu: #ffb86b;
  --t-kw: #ffcb00;
  --t-ty: #8fd2ff;
  --t-fn: #ffe173;
  --t-va: #d9b2ff;
  --t-at: #7fe0c8;
  --t-pu: rgba(233, 233, 233, 0.5);

  /* Metrics */
  --sidebar-w: 17rem;
  --toc-w: 14.5rem;
  --measure: 45.5rem;
  --topbar-h: 3.75rem;
  --gutter: clamp(1.15rem, 3.2vw, 2.75rem);
  --radius: 10px;
  --radius-lg: 14px;

  --sans: "Open Runde", ui-rounded, "Segoe UI", system-ui, sans-serif;
  --pixel: "Departure Mono", ui-monospace, monospace;
  --mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, monospace;

  --ease: cubic-bezier(0.22, 0.68, 0.3, 1);
  color-scheme: dark;
}

/* Every light override in this file is written once, against this selector.
   build.ts re-emits those same rules inside a prefers-color-scheme query
   scoped to :root:not([data-theme="dark"]), so a reader whose system asks for
   light gets it, an explicit choice always wins, and the palette exists once. */
:root[data-theme="light"] {
  --ground: #efece4;
  --surface: #f6f4ee;
  --surface-2: #eceadf;
  --surface-3: #e2dfd2;
  --recess: #26241f;

  --text: #22211e;
  --text-2: rgba(34, 33, 30, 0.7);
  --text-3: rgba(34, 33, 30, 0.68);

  --line: rgba(34, 33, 30, 0.12);
  --line-strong: rgba(34, 33, 30, 0.22);

  --accent: #b78400;
  --accent-text: #7a5400;
  --accent-soft: rgba(255, 203, 0, 0.2);
  --accent-line: rgba(183, 132, 0, 0.4);
  --on-accent: #22211e;

  --grid: rgba(34, 33, 30, 0.035);
  --glow: rgba(255, 203, 0, 0.12);

  /* Callout labels are text, so the signal colours darken for paper. */
  --ht-green: #1a6b2e;
  --ht-orange: #9a5210;
  --ht-blue: #0b5fa5;

  --t-cm: rgba(34, 33, 30, 0.42);
  --t-st: #3f7d2f;
  --t-nu: #a4562a;
  --t-kw: #8a6200;
  --t-ty: #1f6591;
  --t-fn: #7a5a00;
  --t-va: #6b3fa8;
  --t-at: #1f7565;
  --t-pu: rgba(34, 33, 30, 0.55);

  color-scheme: light;
}


/* --- Reset -------------------------------------------------------------- */

*,
*::before,
*::after {
  box-sizing: border-box;
}

html {
  scroll-behavior: smooth;
  scroll-padding-top: calc(var(--topbar-h) + 1.5rem);
  -webkit-text-size-adjust: 100%;
}

body {
  margin: 0;
  background: var(--ground);
  color: var(--text);
  font-family: var(--sans);
  font-size: 1.0125rem;
  line-height: 1.68;
  letter-spacing: -0.006em;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
  overflow-x: hidden;
}

/* Blueprint grid plus a single warm light source in the upper left. */
body::before {
  content: "";
  position: fixed;
  inset: 0;
  z-index: -2;
  pointer-events: none;
  background:
    radial-gradient(60rem 34rem at 12% -6%, var(--glow), transparent 68%),
    linear-gradient(var(--grid) 1px, transparent 1px) 0 0 / 100% 3.5rem,
    linear-gradient(90deg, var(--grid) 1px, transparent 1px) 0 0 / 3.5rem 100%;
}

.grain {
  position: fixed;
  inset: -50%;
  z-index: -1;
  pointer-events: none;
  opacity: 0.22;
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='160' height='160'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='3' stitchTiles='stitch'/%3E%3CfeColorMatrix type='saturate' values='0'/%3E%3C/filter%3E%3Crect width='160' height='160' filter='url(%23n)' opacity='0.5'/%3E%3C/svg%3E");
  mix-blend-mode: overlay;
}

:root[data-theme="light"] .grain {
  opacity: 0.4;
  mix-blend-mode: multiply;
}

::selection {
  background: var(--accent);
  color: var(--on-accent);
}

.skip {
  position: absolute;
  left: -9999px;
  top: 0;
  z-index: 100;
  padding: 0.7rem 1.1rem;
  background: var(--accent);
  color: var(--on-accent);
  font-weight: 600;
  border-radius: 0 0 var(--radius) 0;
}

.skip:focus {
  left: 0;
}

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

/* --- Top bar ------------------------------------------------------------ */

.topbar {
  position: sticky;
  top: 0;
  z-index: 40;
  height: var(--topbar-h);
  background: color-mix(in srgb, var(--ground) 82%, transparent);
  backdrop-filter: saturate(150%) blur(14px);
  -webkit-backdrop-filter: saturate(150%) blur(14px);
  border-bottom: 1px solid var(--line);
}

.topbar__inner {
  height: 100%;
  padding-inline: var(--gutter);
  display: flex;
  align-items: center;
  gap: 1rem;
}

.brand {
  display: inline-flex;
  align-items: center;
  gap: 0.55rem;
  color: var(--text);
  text-decoration: none;
  font-weight: 600;
  letter-spacing: -0.02em;
  flex: none;
}

.brand__glyph {
  display: grid;
  place-items: center;
  width: 1.85rem;
  height: 1.85rem;
  border-radius: 7px;
  background: var(--accent);
  color: var(--on-accent);
}

.brand__word {
  font-size: 1.06rem;
}

.brand__tag {
  font-family: var(--pixel);
  font-size: 0.68rem;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--text-3);
  border: 1px solid var(--line);
  border-radius: 4px;
  padding: 0.1rem 0.34rem 0.02rem;
  margin-left: 0.1rem;
}

.search {
  margin-left: auto;
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  min-width: 13rem;
  padding: 0.42rem 0.55rem 0.42rem 0.7rem;
  background: var(--surface-2);
  border: 1px solid var(--line);
  border-radius: 8px;
  color: var(--text-3);
  font: inherit;
  font-size: 0.9rem;
  cursor: pointer;
  transition: border-color 0.16s var(--ease), color 0.16s var(--ease);
}

.search:hover {
  border-color: var(--line-strong);
  color: var(--text-2);
}

.search__label {
  flex: 1;
  text-align: left;
}

.search__kbd,
kbd {
  font-family: var(--pixel);
  font-size: 0.7rem;
  line-height: 1;
  padding: 0.26rem 0.34rem 0.16rem;
  border: 1px solid var(--line);
  border-radius: 4px;
  background: var(--surface);
  color: var(--text-3);
}

.topbar__actions {
  display: flex;
  align-items: center;
  gap: 0.4rem;
  flex: none;
}

/* Back to the product: the docs are one section of app.hypertool.app, and this is its way home. */
.topbar__home {
  display: inline-flex;
  align-items: center;
  height: 2.1rem;
  padding: 0 0.8rem;
  border: 1px solid var(--line);
  border-radius: 8px;
  background: var(--surface-2);
  color: var(--text-2);
  font-size: 0.85rem;
  text-decoration: none;
  white-space: nowrap;
  transition: color 0.16s var(--ease), border-color 0.16s var(--ease);
}

.topbar__home:hover {
  color: var(--accent-text);
  border-color: var(--accent-line);
}

@media (max-width: 560px) {
  .topbar__home { display: none; }
}

.iconbtn {
  display: grid;
  place-items: center;
  width: 2.1rem;
  height: 2.1rem;
  border: 1px solid var(--line);
  border-radius: 8px;
  background: var(--surface-2);
  color: var(--text-2);
  cursor: pointer;
  transition: color 0.16s var(--ease), border-color 0.16s var(--ease);
}

.iconbtn:hover {
  color: var(--accent-text);
  border-color: var(--accent-line);
}

.iconbtn__moon {
  display: none;
}

:root[data-theme="light"] .iconbtn__sun {
  display: none;
}

:root[data-theme="light"] .iconbtn__moon {
  display: block;
}

.iconbtn--menu {
  display: none;
}

/* --- Shell -------------------------------------------------------------- */

.shell {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  gap: 0;
  max-width: 96rem;
  margin: 0 auto;
  padding-inline: var(--gutter);
  align-items: start;
}

/* --- Sidebar ------------------------------------------------------------ */

.sidebar {
  position: sticky;
  top: var(--topbar-h);
  height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  padding: 2.25rem 1.5rem 4rem 0;
  border-right: 1px solid var(--line);
  scrollbar-width: thin;
}

.navgroup + .navgroup {
  margin-top: 1.85rem;
}

.navgroup__title {
  display: flex;
  align-items: baseline;
  gap: 0.55rem;
  margin: 0 0 0.6rem;
  font-family: var(--pixel);
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.13em;
  color: var(--text-3);
}

.navgroup__num {
  color: var(--accent-text);
  opacity: 0.72;
}

.navgroup__list {
  list-style: none;
  margin: 0;
  padding: 0;
}

.navlink {
  position: relative;
  display: flex;
  align-items: center;
  gap: 0.75rem;
  padding: 0.34rem 0.6rem 0.34rem 0;
  color: var(--text-2);
  text-decoration: none;
  font-size: 0.945rem;
  border-radius: 0 6px 6px 0;
  transition: color 0.15s var(--ease);
}

.navlink__rail {
  width: 2px;
  height: 1.05rem;
  border-radius: 2px;
  background: var(--line-strong);
  flex: none;
  transition: background 0.18s var(--ease), height 0.18s var(--ease);
}

.navlink:hover {
  color: var(--text);
}

.navlink:hover .navlink__rail {
  background: var(--text-3);
}

.navlink--active {
  color: var(--accent-text);
  font-weight: 600;
}

.navlink--active .navlink__rail {
  background: var(--accent);
  height: 1.5rem;
  box-shadow: 0 0 12px rgba(255, 203, 0, 0.55);
}

/* --- Main --------------------------------------------------------------- */

.main {
  min-width: 0;
  padding: 3.25rem clamp(1rem, 4vw, 3.5rem) 5rem;
}

.doc {
  max-width: var(--measure);
}

.doc__head {
  margin-bottom: 2.5rem;
}

.doc__eyebrow {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  margin: 0 0 0.85rem;
  font-family: var(--pixel);
  font-size: 0.74rem;
  text-transform: uppercase;
  letter-spacing: 0.15em;
  color: var(--text-3);
}

.doc__eyebrow-dot {
  width: 5px;
  height: 5px;
  border-radius: 50%;
  background: var(--accent);
  box-shadow: 0 0 9px rgba(255, 203, 0, 0.8);
}

.doc__title {
  margin: 0;
  font-size: clamp(2.15rem, 4.6vw, 3.1rem);
  line-height: 1.04;
  letter-spacing: -0.038em;
  font-weight: 600;
  text-wrap: balance;
}

.doc__lede {
  margin: 1.05rem 0 0;
  font-size: 1.175rem;
  line-height: 1.56;
  color: var(--text-2);
  max-width: 38rem;
  text-wrap: pretty;
}

/* --- Prose -------------------------------------------------------------- */

.prose-p {
  margin: 0;
  color: var(--text-2);
  text-wrap: pretty;
}

/* Declared after .prose-p on purpose: both selectors weigh the same, so the
   later one has to be the flow spacing or every paragraph collapses. */
.prose > * + * {
  margin-top: 1.2rem;
}

.prose strong {
  color: var(--text);
  font-weight: 600;
}

.heading {
  margin: 0;
  scroll-margin-top: calc(var(--topbar-h) + 1.5rem);
  color: var(--text);
  font-weight: 600;
  letter-spacing: -0.024em;
  position: relative;
}

.prose > .heading--2 {
  margin-top: 3.25rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--line);
  font-size: 1.55rem;
  line-height: 1.24;
}

.prose > .heading--3 {
  margin-top: 2.35rem;
  font-size: 1.16rem;
  line-height: 1.35;
}

.prose > .heading--4 {
  margin-top: 1.85rem;
  font-size: 1rem;
  color: var(--text);
}

.heading__anchor {
  position: absolute;
  left: -1.25rem;
  top: 50%;
  transform: translateY(-50%);
  color: var(--accent-text);
  text-decoration: none;
  opacity: 0;
  font-weight: 400;
  transition: opacity 0.15s var(--ease);
}

.prose > .heading--2 .heading__anchor {
  top: auto;
  bottom: 0.1rem;
  transform: none;
}

.heading:hover .heading__anchor,
.heading__anchor:focus-visible {
  opacity: 1;
}

.link {
  color: var(--text);
  text-decoration: none;
  background-image: linear-gradient(var(--accent-line), var(--accent-line));
  background-size: 100% 1px;
  background-repeat: no-repeat;
  background-position: 0 100%;
  padding-bottom: 1px;
  transition: color 0.15s var(--ease), background-size 0.18s var(--ease);
}

.link:hover {
  color: var(--accent-text);
  background-image: linear-gradient(var(--accent), var(--accent));
}

.link--external::after {
  content: "↗";
  display: inline-block;
  margin-left: 0.18em;
  font-size: 0.82em;
  color: var(--text-3);
}

.inline-code {
  font-family: var(--mono);
  font-size: 0.855em;
  padding: 0.14em 0.38em;
  border-radius: 5px;
  background: var(--surface-3);
  border: 1px solid var(--line);
  color: var(--text);
  white-space: nowrap;
}

.rule {
  height: 1px;
  border: 0;
  margin: 2.75rem 0;
  background: linear-gradient(90deg, var(--line-strong), transparent);
}

/* --- Lists -------------------------------------------------------------- */

.list {
  margin: 0;
  padding-left: 1.3rem;
  color: var(--text-2);
}

.list__item {
  margin: 0;
  padding-left: 0.3rem;
}

.list__item + .list__item {
  margin-top: 0.5rem;
}

.list__item::marker {
  color: var(--accent-text);
}

.list--ordered > .list__item::marker {
  font-family: var(--pixel);
  font-size: 0.9em;
}

.list .list {
  margin-top: 0.5rem;
}

.list__item > .prose-p + .prose-p,
.list__item > .prose-p + .code {
  margin-top: 0.7rem;
}

/* --- Code --------------------------------------------------------------- */

.code {
  margin: 1.6rem 0;
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: var(--recess);
  overflow: hidden;
  box-shadow: 0 18px 34px -28px rgba(0, 0, 0, 0.9);
}

:root[data-theme="light"] .code {
  background: #211f1b;
  border-color: rgba(34, 33, 30, 0.18);
}

.code__bar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  padding: 0.45rem 0.7rem 0.35rem 0.95rem;
  border-bottom: 1px solid rgba(233, 233, 233, 0.08);
  background: rgba(233, 233, 233, 0.028);
}

.code__lang {
  font-family: var(--pixel);
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.11em;
  color: rgba(233, 233, 233, 0.62);
}

.code__copy {
  font-family: var(--pixel);
  font-size: 0.7rem;
  text-transform: uppercase;
  letter-spacing: 0.09em;
  padding: 0.26rem 0.5rem 0.16rem;
  border: 1px solid rgba(233, 233, 233, 0.14);
  border-radius: 5px;
  background: transparent;
  color: rgba(233, 233, 233, 0.62);
  cursor: pointer;
  transition: color 0.15s var(--ease), border-color 0.15s var(--ease);
}

.code__copy:hover {
  color: var(--ht-yellow);
  border-color: rgba(255, 203, 0, 0.45);
}

.code__copy[data-copied] {
  color: var(--ht-green);
  border-color: rgba(59, 204, 90, 0.45);
}

.code__pre {
  margin: 0;
  padding: 1.05rem 1.15rem 1.15rem;
  overflow-x: auto;
  font-family: var(--mono);
  font-size: 0.855rem;
  line-height: 1.68;
  color: #e9e9e9;
  tab-size: 2;
}

.code__code {
  font: inherit;
}

.t-cm { color: var(--t-cm); font-style: italic; }
.t-st { color: var(--t-st); }
.t-nu { color: var(--t-nu); }
.t-kw { color: var(--t-kw); }
.t-ty { color: var(--t-ty); }
.t-fn { color: var(--t-fn); }
.t-va { color: var(--t-va); }
.t-at { color: var(--t-at); }
.t-pu { color: var(--t-pu); }

:root[data-theme="light"] .code__pre {
  color: #e4e1d8;
}

:root[data-theme="light"] .code .t-cm { color: rgba(228, 225, 216, 0.4); }
:root[data-theme="light"] .code .t-pu { color: rgba(228, 225, 216, 0.5); }
:root[data-theme="light"] .code .t-st { color: #b6e7a8; }
:root[data-theme="light"] .code .t-nu { color: #ffb86b; }
:root[data-theme="light"] .code .t-kw { color: #ffcb00; }
:root[data-theme="light"] .code .t-ty { color: #8fd2ff; }
:root[data-theme="light"] .code .t-fn { color: #ffe173; }
:root[data-theme="light"] .code .t-va { color: #d9b2ff; }
:root[data-theme="light"] .code .t-at { color: #7fe0c8; }

/* --- Callouts ----------------------------------------------------------- */

.callout {
  margin: 1.7rem 0;
  padding: 1rem 1.2rem 1.05rem;
  border: 1px solid var(--line);
  border-left: 2px solid var(--accent);
  border-radius: 0 var(--radius) var(--radius) 0;
  background: var(--surface-2);
}

.callout__label {
  margin: 0 0 0.4rem;
  font-family: var(--pixel);
  font-size: 0.73rem;
  text-transform: uppercase;
  letter-spacing: 0.13em;
  color: var(--accent-text);
}

.callout__body > *:first-child {
  margin-top: 0;
}

.callout__body .prose-p {
  color: var(--text-2);
}

.callout--warning,
.callout--caution {
  border-left-color: var(--ht-orange);
}

.callout--warning .callout__label,
.callout--caution .callout__label {
  color: var(--ht-orange);
}

.callout--tip {
  border-left-color: var(--ht-green);
}

.callout--tip .callout__label {
  color: var(--ht-green);
}

.callout--important {
  border-left-color: var(--ht-blue);
}

.callout--important .callout__label {
  color: var(--ht-blue);
}

.quote {
  margin: 1.7rem 0;
  padding-left: 1.2rem;
  border-left: 2px solid var(--line-strong);
  color: var(--text-2);
  font-style: italic;
}

/* --- Tables ------------------------------------------------------------- */

.table-scroll {
  margin: 1.7rem 0;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: var(--radius);
}

.table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.925rem;
}

.table th {
  padding: 0.7rem 0.95rem 0.6rem;
  background: var(--surface-2);
  border-bottom: 1px solid var(--line);
  font-family: var(--pixel);
  font-size: 0.73rem;
  font-weight: 400;
  text-transform: uppercase;
  letter-spacing: 0.11em;
  color: var(--text-3);
  white-space: nowrap;
}

.table td {
  padding: 0.72rem 0.95rem;
  border-bottom: 1px solid var(--line);
  color: var(--text-2);
  vertical-align: top;
}

.table tbody tr:last-child td {
  border-bottom: 0;
}

.table tbody tr:hover td {
  background: var(--accent-soft);
  color: var(--text);
}

.table td .inline-code {
  white-space: nowrap;
}

/* --- Home page components ----------------------------------------------- */

.hero {
  margin: 0 0 1rem;
}

.hero__kicker {
  font-family: var(--pixel);
  font-size: 0.76rem;
  text-transform: uppercase;
  letter-spacing: 0.16em;
  color: var(--accent-text);
  margin: 0 0 1rem;
}

.cardgrid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
  gap: 0.85rem;
  margin: 1.9rem 0;
}

.card {
  display: block;
  padding: 1.15rem 1.2rem 1.25rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: var(--surface-2);
  text-decoration: none;
  color: inherit;
  position: relative;
  overflow: hidden;
  transition: border-color 0.18s var(--ease), transform 0.18s var(--ease);
}

.card::after {
  content: "";
  position: absolute;
  inset: 0 auto 0 0;
  width: 2px;
  background: var(--accent);
  transform: scaleY(0);
  transform-origin: top;
  transition: transform 0.22s var(--ease);
}

.card:hover {
  border-color: var(--line-strong);
  transform: translateY(-2px);
}

.card:hover::after {
  transform: scaleY(1);
}

.card__num {
  display: block;
  font-family: var(--pixel);
  font-size: 0.72rem;
  letter-spacing: 0.12em;
  color: var(--accent-text);
  margin-bottom: 0.6rem;
}

.card__title {
  display: block;
  font-weight: 600;
  font-size: 1.03rem;
  letter-spacing: -0.018em;
  margin-bottom: 0.3rem;
}

.card__text {
  display: block;
  font-size: 0.92rem;
  line-height: 1.55;
  color: var(--text-2);
}

.statgrid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(11rem, 1fr));
  gap: 1px;
  margin: 2rem 0;
  background: var(--line);
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.stat {
  padding: 1.15rem 1.2rem;
  background: var(--surface-2);
}

.stat__value {
  display: block;
  font-size: 1.5rem;
  font-weight: 600;
  letter-spacing: -0.03em;
  color: var(--accent-text);
  line-height: 1.2;
}

.stat__label {
  display: block;
  margin-top: 0.25rem;
  font-family: var(--pixel);
  font-size: 0.71rem;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--text-3);
}

/* A labelled schematic drawn in plain boxes. */
/* Product screenshots: `<figure class="shot">` in content. Studio's UI is dark, so the frame stays dark in both
   themes; the caption follows the page. */
.shot {
  margin: 1.9rem 0;
}

.shot__frame {
  display: block;
  overflow: hidden;
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background: #222222;
  box-shadow: 0 18px 40px -24px rgba(0, 0, 0, 0.55);
}

.shot__frame img {
  display: block;
  width: 100%;
  height: auto;
}

.shot figcaption {
  margin-top: 0.7rem;
  color: var(--text-3);
  font-size: 0.86rem;
  line-height: 1.5;
}

.schematic {
  margin: 1.9rem 0;
  padding: 1.35rem 1.3rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-lg);
  background:
    linear-gradient(var(--grid) 1px, transparent 1px) 0 0 / 100% 1.5rem,
    linear-gradient(90deg, var(--grid) 1px, transparent 1px) 0 0 / 1.5rem 100%,
    var(--surface-2);
}

.schematic__title {
  margin: 0 0 1rem;
  font-family: var(--pixel);
  font-size: 0.73rem;
  text-transform: uppercase;
  letter-spacing: 0.13em;
  color: var(--text-3);
}

.layer {
  display: flex;
  align-items: center;
  gap: 0.8rem;
  padding: 0.62rem 0.85rem;
  border: 1px solid var(--line);
  border-radius: 8px;
  background: var(--surface);
  font-size: 0.9rem;
}

.layer + .layer {
  margin-top: 0.45rem;
}

.layer--accent {
  border-color: var(--accent-line);
  background: var(--accent-soft);
}

.layer__tag {
  font-family: var(--pixel);
  font-size: 0.69rem;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--accent-text);
  flex: none;
  width: 5.5rem;
}

.layer__body {
  color: var(--text-2);
}

.layer__body strong {
  color: var(--text);
  font-weight: 600;
}

.nest {
  margin-left: 1.5rem;
  padding-left: 1rem;
  border-left: 1px dashed var(--line-strong);
}

/* --- Pager -------------------------------------------------------------- */

.pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 0.85rem;
  max-width: var(--measure);
  margin-top: 4rem;
}

.pager__card {
  display: flex;
  flex-direction: column;
  gap: 0.28rem;
  padding: 0.95rem 1.1rem 1.05rem;
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--surface-2);
  text-decoration: none;
  color: inherit;
  transition: border-color 0.18s var(--ease);
}

.pager__card:hover {
  border-color: var(--accent-line);
}

.pager__card--next {
  text-align: right;
}

.pager__dir {
  font-family: var(--pixel);
  font-size: 0.7rem;
  text-transform: uppercase;
  letter-spacing: 0.13em;
  color: var(--text-3);
}

.pager__title {
  font-weight: 600;
  letter-spacing: -0.018em;
}

.pager__card:hover .pager__title {
  color: var(--accent-text);
}

.docfoot {
  max-width: var(--measure);
  margin-top: 2.5rem;
  padding-top: 1.4rem;
  border-top: 1px solid var(--line);
}

.docfoot__line {
  margin: 0;
  font-family: var(--pixel);
  font-size: 0.74rem;
  letter-spacing: 0.05em;
  color: var(--text-3);
}

/* --- Table of contents -------------------------------------------------- */

.toc {
  position: sticky;
  top: var(--topbar-h);
  max-height: calc(100vh - var(--topbar-h));
  overflow-y: auto;
  padding: 3.6rem 0 3rem 1.5rem;
  border-left: 1px solid var(--line);
}

.toc__title {
  margin: 0 0 0.75rem;
  font-family: var(--pixel);
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.13em;
  color: var(--text-3);
}

.toc__list {
  list-style: none;
  margin: 0;
  padding: 0;
  border-left: 1px solid var(--line);
}

.toc__item--l3 .toc__link {
  padding-left: 1.55rem;
  font-size: 0.85rem;
}

.toc__link {
  display: block;
  padding: 0.28rem 0 0.28rem 0.85rem;
  margin-left: -1px;
  border-left: 1px solid transparent;
  color: var(--text-3);
  text-decoration: none;
  font-size: 0.89rem;
  line-height: 1.45;
  transition: color 0.15s var(--ease), border-color 0.15s var(--ease);
}

.toc__link:hover {
  color: var(--text);
}

.toc__link[data-active] {
  color: var(--accent-text);
  border-left-color: var(--accent);
}

/* --- Search palette ----------------------------------------------------- */

.palette[hidden] {
  display: none;
}

.palette {
  position: fixed;
  inset: 0;
  z-index: 80;
  display: grid;
  place-items: start center;
  padding: min(12vh, 7rem) 1rem 1rem;
}

.palette__scrim {
  position: absolute;
  inset: 0;
  background: rgba(10, 10, 10, 0.64);
  backdrop-filter: blur(3px);
  animation: fade 0.16s var(--ease);
}

.palette__panel {
  position: relative;
  width: min(38rem, 100%);
  background: var(--surface);
  border: 1px solid var(--line-strong);
  border-radius: var(--radius-lg);
  box-shadow: 0 40px 80px -30px rgba(0, 0, 0, 0.85);
  overflow: hidden;
  animation: rise 0.2s var(--ease);
}

.palette__field {
  display: flex;
  align-items: center;
  gap: 0.7rem;
  padding: 0.9rem 1rem;
  border-bottom: 1px solid var(--line);
  color: var(--text-3);
}

.palette__input {
  flex: 1;
  min-width: 0;
  background: transparent;
  border: 0;
  outline: none;
  color: var(--text);
  font: inherit;
  font-size: 1rem;
}

.palette__input::placeholder {
  color: var(--text-3);
}

.palette__results {
  max-height: min(52vh, 26rem);
  overflow-y: auto;
  padding: 0.45rem;
}

.result {
  display: block;
  padding: 0.6rem 0.75rem;
  border-radius: 8px;
  text-decoration: none;
  color: inherit;
  border: 1px solid transparent;
}

.result[data-active] {
  background: var(--accent-soft);
  border-color: var(--accent-line);
}

.result__crumb {
  font-family: var(--pixel);
  font-size: 0.69rem;
  text-transform: uppercase;
  letter-spacing: 0.11em;
  color: var(--text-3);
}

.result__title {
  display: block;
  font-weight: 600;
  letter-spacing: -0.016em;
  margin-top: 0.1rem;
}

.result__snippet {
  display: block;
  margin-top: 0.15rem;
  font-size: 0.87rem;
  color: var(--text-2);
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.result mark {
  background: transparent;
  color: var(--accent-text);
  font-weight: 600;
}

.palette__empty {
  padding: 2rem 1rem;
  text-align: center;
  color: var(--text-3);
  font-size: 0.92rem;
}

.palette__foot {
  display: flex;
  gap: 1.1rem;
  padding: 0.6rem 1rem;
  border-top: 1px solid var(--line);
  font-size: 0.78rem;
  color: var(--text-3);
  background: var(--surface-2);
}

.palette__foot span {
  display: inline-flex;
  align-items: center;
  gap: 0.35rem;
}

.palette__esc {
  flex: none;
}

@keyframes fade {
  from { opacity: 0; }
}

@keyframes rise {
  from { opacity: 0; transform: translateY(-8px); }
}

/* --- Entrance ----------------------------------------------------------- */

@media (prefers-reduced-motion: no-preference) {
  .doc__head,
  .prose > *,
  .pager,
  .docfoot {
    animation: enter 0.5s var(--ease) both;
  }

  .doc__head { animation-delay: 0.02s; }
  .prose > *:nth-child(1) { animation-delay: 0.07s; }
  .prose > *:nth-child(2) { animation-delay: 0.1s; }
  .prose > *:nth-child(3) { animation-delay: 0.13s; }
  .prose > *:nth-child(4) { animation-delay: 0.16s; }
  .prose > *:nth-child(n + 5) { animation-delay: 0.19s; }
  .pager, .docfoot { animation-delay: 0.22s; }
}

@keyframes enter {
  from { opacity: 0; transform: translateY(10px); }
}

/* --- Scrollbars --------------------------------------------------------- */

* {
  scrollbar-color: var(--line-strong) transparent;
}

::-webkit-scrollbar {
  width: 9px;
  height: 9px;
}

::-webkit-scrollbar-thumb {
  background: var(--line-strong);
  border-radius: 9px;
}

::-webkit-scrollbar-thumb:hover {
  background: var(--text-3);
}

::-webkit-scrollbar-track {
  background: transparent;
}

/* --- Responsive --------------------------------------------------------- */

@media (max-width: 1180px) {
  .shell {
    grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  }

  .toc {
    display: none;
  }
}

@media (max-width: 880px) {
  :root {
    --topbar-h: 3.5rem;
  }

  .shell {
    grid-template-columns: minmax(0, 1fr);
  }

  .iconbtn--menu {
    display: grid;
  }

  .search {
    min-width: 0;
    margin-left: auto;
  }

  .search__label {
    display: none;
  }

  .sidebar {
    position: fixed;
    top: var(--topbar-h);
    left: 0;
    width: min(20rem, 84vw);
    height: calc(100dvh - var(--topbar-h));
    padding: 1.75rem 1.5rem 3rem;
    background: var(--surface);
    border-right: 1px solid var(--line-strong);
    box-shadow: 0 24px 60px -20px rgba(0, 0, 0, 0.7);
    transform: translateX(-102%);
    transition: transform 0.24s var(--ease);
    z-index: 35;
  }

  .sidebar[data-open] {
    transform: translateX(0);
  }

  .main {
    padding: 2.25rem 0 4rem;
  }

  .doc__title {
    font-size: clamp(1.95rem, 8vw, 2.5rem);
  }

  .pager {
    grid-template-columns: 1fr;
  }

  .brand__tag {
    display: none;
  }
}

/* Generated by build.ts — system preference mirror of the light palette. */
@media (prefers-color-scheme: light) {
  /* Every light override in this file is written once, against this selector.
     build.ts re-emits those same rules inside a prefers-color-scheme query
     scoped to :root:not([data-theme="dark"]), so a reader whose system asks for
     light gets it, an explicit choice always wins, and the palette exists once. */
  :root:not([data-theme="dark"]) {
    --ground: #efece4;
    --surface: #f6f4ee;
    --surface-2: #eceadf;
    --surface-3: #e2dfd2;
    --recess: #26241f;
  
    --text: #22211e;
    --text-2: rgba(34, 33, 30, 0.7);
    --text-3: rgba(34, 33, 30, 0.68);
  
    --line: rgba(34, 33, 30, 0.12);
    --line-strong: rgba(34, 33, 30, 0.22);
  
    --accent: #b78400;
    --accent-text: #7a5400;
    --accent-soft: rgba(255, 203, 0, 0.2);
    --accent-line: rgba(183, 132, 0, 0.4);
    --on-accent: #22211e;
  
    --grid: rgba(34, 33, 30, 0.035);
    --glow: rgba(255, 203, 0, 0.12);
  
    /* Callout labels are text, so the signal colours darken for paper. */
    --ht-green: #1a6b2e;
    --ht-orange: #9a5210;
    --ht-blue: #0b5fa5;
  
    --t-cm: rgba(34, 33, 30, 0.42);
    --t-st: #3f7d2f;
    --t-nu: #a4562a;
    --t-kw: #8a6200;
    --t-ty: #1f6591;
    --t-fn: #7a5a00;
    --t-va: #6b3fa8;
    --t-at: #1f7565;
    --t-pu: rgba(34, 33, 30, 0.55);
  
    color-scheme: light;
  }

  :root:not([data-theme="dark"]) .grain {
    opacity: 0.4;
    mix-blend-mode: multiply;
  }

  :root:not([data-theme="dark"]) .iconbtn__sun {
    display: none;
  }

  :root:not([data-theme="dark"]) .iconbtn__moon {
    display: block;
  }

  :root:not([data-theme="dark"]) .code {
    background: #211f1b;
    border-color: rgba(34, 33, 30, 0.18);
  }

  :root:not([data-theme="dark"]) .code__pre {
    color: #e4e1d8;
  }

  :root:not([data-theme="dark"]) .code .t-cm { color: rgba(228, 225, 216, 0.4); }

  :root:not([data-theme="dark"]) .code .t-pu { color: rgba(228, 225, 216, 0.5); }

  :root:not([data-theme="dark"]) .code .t-st { color: #b6e7a8; }

  :root:not([data-theme="dark"]) .code .t-nu { color: #ffb86b; }

  :root:not([data-theme="dark"]) .code .t-kw { color: #ffcb00; }

  :root:not([data-theme="dark"]) .code .t-ty { color: #8fd2ff; }

  :root:not([data-theme="dark"]) .code .t-fn { color: #ffe173; }

  :root:not([data-theme="dark"]) .code .t-va { color: #d9b2ff; }

  :root:not([data-theme="dark"]) .code .t-at { color: #7fe0c8; }
}
