/* Docs: a manual on aged paper, lying in the lamp-lit cabinet. The hub is a
   drawer of labelled cards. Raw .md files stay published for agents. */
.doc-room main { padding-top: calc(var(--stage-top) - 60px); }
.doc-layout { display: grid; grid-template-columns: 220px minmax(0, 1fr); gap: var(--space-page); align-items: start; padding-block: var(--space-page) var(--space-page-lg); }
.doc-side { position: sticky; top: 170px; display: grid; gap: var(--space-2xl); font-size: 14px; }
.doc-back, .doc-raw { display: inline-flex; align-items: center; gap: var(--space-md); min-height: var(--space-touch-target); color: var(--set-brass-light); font: 500 14px/1.2 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }
.doc-back:hover, .doc-raw:hover { color: var(--set-ivory); }
.doc-raw { color: var(--marketing-muted); letter-spacing: .12em; font-size: 13px; }
.doc-toc p { margin-bottom: var(--space-lg); color: var(--marketing-muted); font: 500 13px/1 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }
.doc-toc ol { display: grid; gap: var(--space-sm); margin: 0; padding: 0 0 0 var(--space-xl); border-left: 1px solid color-mix(in srgb, var(--set-brass) 35%, transparent); list-style: none; }
.doc-toc a { display: block; padding: var(--space-sm) 0; color: var(--marketing-muted); line-height: 1.35; }
.doc-toc a:hover { color: var(--set-ivory); }

.doc-sheet { position: relative; min-width: 0; max-width: 860px; padding: clamp(24px, 4vw, 56px); border-radius: var(--rounded-xs); color: var(--set-ink); background: linear-gradient(180deg, var(--set-ivory), color-mix(in srgb, var(--set-ivory) 86%, var(--set-ivory-shade))); box-shadow: 0 30px 60px var(--marketing-room), 0 0 0 1px color-mix(in srgb, var(--set-ivory-shade) 80%, transparent), inset 0 6px 0 var(--marketing-accent), inset 0 8px 0 var(--set-brass); }
.doc-sheet::after { content: ''; position: absolute; inset: 0; border-radius: inherit; background: var(--set-noise); opacity: .1; mix-blend-mode: multiply; pointer-events: none; }
.doc-kicker { color: var(--tertiary); font: 500 13px/1 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }
.doc-sheet h1 { margin-top: var(--space-xl); color: var(--set-ink); font-size: clamp(32px, 4vw, 48px); line-height: 1.05; letter-spacing: -.03em; }
.doc-summary { margin-top: var(--space-xl); padding-bottom: var(--space-3xl); border-bottom: 1px solid color-mix(in srgb, var(--set-ink) 18%, transparent); color: color-mix(in srgb, var(--set-ink) 75%, transparent); font-size: 18px; }
.doc-sheet h2 { margin-top: var(--space-page); color: var(--set-ink); font-size: 24px; line-height: 1.2; letter-spacing: -.02em; scroll-margin-top: 170px; }
.doc-sheet h3 { margin-top: var(--space-3xl); color: var(--set-ink); font-size: 18px; scroll-margin-top: 170px; }
.doc-sheet h4 { margin-top: var(--space-2xl); color: var(--set-ink); font-size: 16px; }
.doc-sheet p, .doc-sheet li { color: color-mix(in srgb, var(--set-ink) 88%, transparent); font-size: 16px; line-height: 1.7; }
.doc-sheet p { margin-top: var(--space-xl); }
.doc-sheet ul, .doc-sheet ol { margin: var(--space-xl) 0 0; padding-left: var(--space-3xl); }
.doc-sheet li + li { margin-top: var(--space-sm); }
.doc-sheet a { color: var(--tertiary); text-decoration: underline; text-underline-offset: 3px; }
.doc-sheet :not(pre) > code { padding: 1px 5px; border-radius: var(--rounded-xs); background: color-mix(in srgb, var(--set-ivory-shade) 45%, transparent); color: var(--set-ink); font-size: .88em; overflow-wrap: anywhere; }
.doc-code { position: relative; margin: var(--space-2xl) 0 0; padding: var(--space-3xl); overflow-x: auto; border-radius: var(--rounded-xs); background: var(--marketing-room); color: var(--set-ivory); box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--set-brass) 35%, transparent); font-size: 13px; line-height: 1.6; }
.doc-code[data-lang]::before { content: attr(data-lang); position: absolute; top: var(--space-md); right: var(--space-xl); color: var(--set-brass-light); font: 500 11px/1 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }
.doc-table { margin-top: var(--space-2xl); overflow-x: auto; }
.doc-table table { width: 100%; border-collapse: collapse; font-size: 14px; }
.doc-table th, .doc-table td { padding: var(--space-lg) var(--space-xl); border-bottom: 1px solid color-mix(in srgb, var(--set-ink) 14%, transparent); text-align: left; vertical-align: top; color: color-mix(in srgb, var(--set-ink) 88%, transparent); }
.doc-table th { color: var(--set-ink); font: 500 13px/1.3 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }
.doc-sheet blockquote { margin: var(--space-2xl) 0 0; padding: var(--space-lg) var(--space-2xl); border-left: 4px solid var(--marketing-accent); background: color-mix(in srgb, var(--set-ivory-shade) 25%, transparent); }
.doc-sheet blockquote p:first-child { margin-top: 0; }
.doc-sheet hr { margin: var(--space-page) 0; border: 0; border-top: 1px solid color-mix(in srgb, var(--set-ink) 18%, transparent); }

/* Hub: a drawer of index cards. */
.doc-drawer { display: grid; gap: var(--space-page); padding-block: var(--space-page) var(--space-page-lg); }
.doc-group h2 { margin-bottom: var(--space-2xl); color: var(--set-brass-light); font: 500 16px/1 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }
.doc-cards { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: var(--space-2xl); margin: 0; padding: 0; list-style: none; }
.doc-card { position: relative; display: grid; gap: var(--space-md); align-content: start; min-height: 132px; padding: var(--space-3xl) var(--space-3xl) var(--space-2xl); border-radius: var(--rounded-xs); color: var(--set-ink); background: linear-gradient(180deg, var(--set-ivory), color-mix(in srgb, var(--set-ivory) 84%, var(--set-ivory-shade))); box-shadow: 0 12px 26px color-mix(in srgb, var(--marketing-room) 70%, transparent), inset 0 5px 0 var(--marketing-accent), inset 0 7px 0 var(--set-brass); transition: transform var(--motion-fast) var(--ease-standard), box-shadow var(--motion-fast) var(--ease-standard); }
.doc-card:hover, .doc-card:focus-within { transform: translateY(-3px); box-shadow: 0 18px 32px var(--marketing-room), inset 0 5px 0 var(--marketing-accent), inset 0 7px 0 var(--set-brass); }
.doc-card a.doc-card-title { color: var(--set-ink); font: 600 20px/1.2 var(--font-marketing); letter-spacing: -.01em; }
.doc-card a.doc-card-title::after { content: ''; position: absolute; inset: 0; }
.doc-card p { color: color-mix(in srgb, var(--set-ink) 75%, transparent); font-size: 14px; line-height: 1.5; }
.doc-card .doc-card-raw { position: relative; z-index: 1; justify-self: start; min-height: 28px; display: inline-flex; align-items: center; color: var(--tertiary); font: 500 12px/1 var(--font-engrave); letter-spacing: .14em; text-transform: uppercase; }

@media (max-width: 900px) {
  .doc-layout { grid-template-columns: minmax(0, 1fr); gap: var(--space-2xl); }
  .doc-side { position: static; }
  .doc-toc { display: none; }
  .doc-cards { grid-template-columns: minmax(0, 1fr); }
}

/* How-to guide: the chapter list on /guide/ and previous/next at the end of a chapter. Ink on the paper sheet. */
.doc-sheet .guide-list { display: grid; gap: var(--space-md); margin: var(--space-3xl) 0; padding: 0; list-style: none; }
.doc-sheet .guide-list li { margin: 0; padding: 0; }
.doc-sheet .guide-list li::marker { content: none; }
.doc-sheet .guide-list a, .doc-sheet .guide-steps a { color: var(--set-ink); text-decoration: none; }
.guide-list a { display: grid; grid-template-columns: var(--space-page) minmax(0, 1fr); gap: var(--space-xs) var(--space-xl); align-items: baseline; padding: var(--space-2xl); border: 1px solid color-mix(in srgb, var(--set-ink) 18%, transparent); border-radius: var(--rounded-md); background: color-mix(in srgb, var(--set-ivory) 70%, transparent); }
.guide-list a:hover, .guide-steps a:hover { border-color: var(--tertiary); }
.guide-n { grid-row: span 2; color: var(--tertiary); font: 600 13px/1.6 var(--font-mono); }
.guide-list strong { font-size: 18px; }
.guide-sum { color: color-mix(in srgb, var(--set-ink) 72%, transparent); font-size: 14px; }
.guide-steps { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--space-xl); margin-top: var(--space-page); padding-top: var(--space-3xl); border-top: 1px solid color-mix(in srgb, var(--set-ink) 18%, transparent); }
.guide-steps a { display: grid; gap: var(--space-xs); min-height: var(--space-touch-target); padding: var(--space-2xl); border: 1px solid color-mix(in srgb, var(--set-ink) 18%, transparent); border-radius: var(--rounded-md); font-weight: 600; }
.guide-steps a span { color: color-mix(in srgb, var(--set-ink) 65%, transparent); font: 500 12px/1.4 var(--font-mono); text-transform: uppercase; letter-spacing: .08em; }
.guide-next { text-align: right; }
@media (max-width: 640px) { .guide-steps { grid-template-columns: 1fr; } .guide-next { text-align: left; } }

/* Copy stays fixed while long examples scroll. Uses the live command pattern. */
.doc-snippet { position: relative; margin-block: var(--space-2xl); }
.doc-snippet .doc-code { margin: 0; padding-top: calc(var(--space-touch-target) + var(--space-2xl)); }
.doc-snippet .doc-code[data-lang]::before { left: var(--space-3xl); right: auto; top: var(--space-xl); }
.doc-copy { position: absolute; top: var(--space-md); right: var(--space-xl); min-height: var(--space-touch-target); min-width: var(--space-touch-target); padding-inline: var(--space-2xl); border: 1px solid var(--on-surface-muted); border-radius: var(--rounded-md); background: var(--surface-2); color: var(--on-surface); font: inherit; cursor: pointer; }
.doc-copy:hover { background: var(--surface-3); border-color: var(--accent); }
.doc-copy:focus-visible { outline: 2px solid var(--accent); outline-offset: var(--space-xs); }
html:not(.docs-copy-ready) .doc-copy { display: none; }
.doc-snippet > [role="status"] { color: var(--on-surface); }
@media print { .doc-copy { display: none; } }

/* Facts-table headers retain the page typography and expose keyboard sorting. */
.doc-sort { display: inline-flex; align-items: center; gap: var(--space-sm); min-height: var(--space-touch-target); padding: 0; border: 0; background: transparent; color: inherit; font: inherit; letter-spacing: inherit; text-transform: inherit; text-align: left; cursor: pointer; }
.doc-sort::after { content: "↕"; }
[aria-sort="ascending"] > .doc-sort::after { content: "↑"; }
[aria-sort="descending"] > .doc-sort::after { content: "↓"; }