/* Docs · extends styles.css with the same tokens: a contents rail beside one long, readable column. */

.docs { padding: 112px 0 var(--space-3xl); }
.docs__layout { display: grid; grid-template-columns: minmax(0, 1fr); gap: var(--space-xl); }
@media (min-width: 62rem) {
  .docs { padding-top: 140px; }
  .docs__layout { grid-template-columns: 15rem minmax(0, 1fr); gap: var(--space-3xl); }
}

/* contents · a collapsible block on phones, a sticky rail on desktop */
.toc { font-size: var(--text-sm); }
.toc summary { cursor: pointer; font-weight: 600; padding: var(--space-xs) 0; list-style: none; }
.toc summary::-webkit-details-marker { display: none; }
.toc summary::after { content: " +"; color: var(--color-ink-2); }
.toc[open] summary::after { content: " −"; }
.toc ol { list-style: none; margin: var(--space-xs) 0 0; padding: 0; display: grid; gap: 1px; }
.toc a {
  display: block; padding: 5px 10px; border-radius: var(--radius-sm);
  color: var(--color-ink-1); text-decoration: none;
  transition: background-color var(--dur-fast) var(--ease-out), color var(--dur-fast) var(--ease-out);
}
.toc a:hover { background: var(--color-paper-2); color: var(--color-ink-0); }
.toc a[aria-current="true"] { background: var(--color-accent-tint); color: var(--color-ink-0); font-weight: 500; }
.toc__group { font-family: var(--font-mono); font-size: var(--text-2xs); text-transform: uppercase; letter-spacing: 0.08em;
  color: var(--color-ink-2); padding: var(--space-sm) 10px 2px; }
@media (min-width: 62rem) {
  .toc { position: sticky; top: 104px; align-self: start; max-height: calc(100vh - 128px); overflow-y: auto; }
  .toc summary { pointer-events: none; }
  .toc summary::after, .toc[open] summary::after { content: none; }
}

/* reading column */
.doc { max-width: 46rem; min-width: 0; }
.doc__eyebrow { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-accent); letter-spacing: 0.04em; }
.doc h1 { font-size: var(--text-3xl); font-weight: 600; letter-spacing: -0.04em; line-height: 1.02; margin-top: var(--space-xs); max-width: 16ch; }
.doc__lede { margin-top: var(--space-md); font-size: var(--text-md); color: var(--color-ink-1); line-height: 1.55; }
.doc section { padding-top: var(--space-2xl); margin-top: var(--space-2xl); border-top: var(--rule-hair); }
.doc h2 { font-size: var(--text-2xl); font-weight: 600; letter-spacing: -0.03em; line-height: 1.1; }
.doc h3 { font-size: var(--text-lg); font-weight: 600; letter-spacing: -0.015em; margin-top: var(--space-xl); }
.doc h2 + p, .doc h3 + p { margin-top: var(--space-sm); }
.doc p, .doc li { color: var(--color-ink-1); }
.doc p + p, .doc p + ul, .doc p + ol, .doc ul + p, .doc ol + p, .doc table + p, .doc .callout + p, .doc p + table { margin-top: var(--space-sm); }
.doc ul, .doc ol { margin: var(--space-sm) 0 0; padding-left: 1.25rem; display: grid; gap: var(--space-2xs); }
.doc li::marker { color: var(--color-ink-2); }
.doc strong, .doc b { color: var(--color-ink-0); font-weight: 600; }
.doc a { color: var(--color-ink-0); text-decoration-color: color-mix(in oklch, var(--color-accent) 55%, transparent); text-underline-offset: 3px; }
.doc a:hover { text-decoration-color: var(--color-accent); }
.doc h2 a.anchor, .doc h3 a.anchor { text-decoration: none; color: var(--color-ink-3); margin-left: 0.3em; opacity: 0;
  transition: opacity var(--dur-fast) var(--ease-out); }
.doc h2:hover a.anchor, .doc h3:hover a.anchor, .doc a.anchor:focus-visible { opacity: 1; }

/* the app's own words, so a reader can find the button */
.ui { font-weight: 600; color: var(--color-ink-0); white-space: nowrap; }

/* numbered walk-throughs */
.doc ol.walk { counter-reset: walk; list-style: none; padding: 0; gap: var(--space-sm); }
.doc ol.walk > li { counter-increment: walk; position: relative; padding-left: 2.25rem; }
.doc ol.walk > li::before {
  content: counter(walk); position: absolute; left: 0; top: 0.1em;
  width: 1.5rem; height: 1.5rem; border-radius: 50%; display: grid; place-items: center;
  font-family: var(--font-mono); font-size: var(--text-2xs); font-weight: 500;
  background: var(--color-paper-2); color: var(--color-ink-0);
}

.callout {
  margin-top: var(--space-md); padding: var(--space-sm) var(--space-md);
  border-radius: var(--radius-md); border: var(--rule-soft); background: var(--color-surface);
  font-size: var(--text-sm);
}
.callout p { color: var(--color-ink-1); }
.callout b:first-child { color: var(--color-ink-0); }
.callout--warn { background: var(--color-warning-tint); border-color: color-mix(in oklch, var(--color-warning) 35%, transparent); }
.callout--ok { background: var(--color-success-tint); border-color: color-mix(in oklch, var(--color-success) 30%, transparent); }

/* tables scroll inside themselves, never the page */
.table-wrap { margin-top: var(--space-md); overflow-x: auto; border: var(--rule-soft); border-radius: var(--radius-md); background: var(--color-surface); }
.doc table { border-collapse: collapse; width: 100%; font-size: var(--text-sm); }
.doc th, .doc td { text-align: left; vertical-align: top; padding: 9px 12px; border-bottom: var(--rule-hair); }
.doc tr:last-child td { border-bottom: 0; }
.doc th { font-weight: 600; color: var(--color-ink-0); background: var(--color-paper-1); white-space: nowrap; }
.doc td:first-child { color: var(--color-ink-0); }
.doc td code, .doc th code { white-space: nowrap; }

/* the pipeline at the top */
.doc ol.flow { list-style: none; padding: 0; margin: var(--space-xl) 0 0; display: grid; gap: var(--space-xs);
  grid-template-columns: repeat(auto-fit, minmax(9.5rem, 1fr)); }
.flow li { padding: var(--space-sm) var(--space-md); border: var(--rule-soft); border-radius: var(--radius-md); background: var(--color-surface); }
.flow b { display: block; font-size: var(--text-sm); }
.flow span { display: block; margin-top: 2px; font-size: var(--text-xs); color: var(--color-ink-2); line-height: 1.4; }
.flow a { text-decoration: none; }
.flow a:hover b { color: var(--color-accent); }

pre.code {
  margin-top: var(--space-sm); padding: var(--space-sm) var(--space-md); overflow-x: auto;
  background: var(--color-paper-2); border-radius: var(--radius-md);
  font-family: var(--font-mono); font-size: var(--text-xs); line-height: 1.6; white-space: pre;
}

.doc__foot { margin-top: var(--space-3xl); padding-top: var(--space-md); border-top: var(--rule-hair); font-size: var(--text-sm); color: var(--color-ink-2); }
.nav__link[aria-current="page"] { background: var(--color-paper-2); color: var(--color-ink-0); }