/* Hallmark · docs — the library manuals, printed on the same set.
 * Same DNA as the portfolio television: dark near-mono paper, Bricolage display,
 * Fraunces numerals, JetBrains Mono machine text, red/cyan anaglyph register.
 * These pages scroll — a manual is read, not zapped.
 */
@import url("../tokens.css");

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

html { scroll-behavior: smooth; }

body {
  margin: 0;
  background: var(--color-paper);
  color: var(--color-ink);
  font-family: var(--font-body);
  font-size: var(--text-base);
  line-height: 1.65;
}

h1, h2, h3, h4 {
  font-family: var(--font-display);
  font-weight: 700;
  line-height: 1.08;
  letter-spacing: -0.015em;
  margin: 0;
  overflow-wrap: anywhere;
  min-width: 0;
}

p { margin: 0; }

a {
  color: var(--color-ink);
  text-decoration-color: var(--color-rule);
  text-decoration-thickness: 1px;
  text-underline-offset: 3px;
  transition: color var(--dur-micro) var(--ease-out),
              text-decoration-color var(--dur-micro) var(--ease-out);
}
a:hover { color: var(--color-accent); text-decoration-color: var(--color-accent); }
a:active { color: var(--color-neutral); }

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

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

/* ————— the static — same snow, quieter: this is the reading channel ————— */
.static {
  position: fixed;
  inset: 0;
  z-index: var(--z-toast);
  width: 100%;
  height: 100%;
  pointer-events: none;
  opacity: 0.018;
  mix-blend-mode: screen;
  image-rendering: pixelated;
}

/* ————— on-screen display ————— */
.osd {
  position: fixed;
  top: var(--space-md);
  right: var(--space-lg);
  z-index: var(--z-sticky);
  font-family: var(--font-outlier);
  font-size: var(--text-sm);
  font-weight: 700;
  letter-spacing: 0.1em;
  color: var(--color-ink);
  pointer-events: none;
}

/* ————— fixed film rails — the page is a strip being pulled through the gate ————— */
:root { --film-rail: 3rem; }
body::before, body::after {
  content: "";
  position: fixed;
  inset-block: 0;
  width: var(--film-rail);
  z-index: var(--z-base);
  opacity: 0.5;
  background-color: var(--color-paper-2);
  background-image: radial-gradient(
    ellipse 34% 22% at 50% 50%,
    var(--color-paper) 96%,
    transparent 100%
  );
  background-size: 100% 42px;
  background-repeat: repeat-y;
  border-inline: var(--rule-hair) solid var(--color-rule);
  pointer-events: none;
}
body::before { left: 0; }
body::after  { right: 0; }

/* ————— page column ————— */
.doc, .doc-mast__inner, .doc-foot__inner {
  max-width: 52rem;
  margin-inline: auto;
  padding-inline: calc(var(--film-rail) + var(--space-xl));
}

/* ————— masthead ————— */
.doc-mast {
  padding-block: var(--space-3xl) var(--space-2xl);
  border-bottom: var(--rule-hair) solid var(--color-rule);
}
.doc-back {
  display: inline-block;
  font-family: var(--font-outlier);
  font-size: var(--text-xs);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-neutral);
  text-decoration: none;
  margin-bottom: var(--space-2xl);
}
.doc-back:hover { color: var(--color-accent); }
.doc-mast .plate-num {
  font-family: var(--font-numeral);
  font-weight: 600;
  font-size: var(--text-lg);
  line-height: 1;
  color: var(--color-accent);
  font-variant-numeric: tabular-nums;
}
.doc-title {
  margin-top: var(--space-sm);
  font-size: var(--text-3xl);
}
.doc-sub {
  margin-top: var(--space-sm);
  font-family: var(--font-outlier);
  font-size: var(--text-xs);
  color: var(--color-neutral);
  font-variant-numeric: tabular-nums;
}
.doc-lede {
  margin-top: var(--space-lg);
  color: var(--color-neutral);
  font-size: var(--text-md);
  max-width: 58ch;
}
.doc-actions { display: flex; flex-wrap: wrap; gap: var(--space-lg); margin-top: var(--space-lg); }
.doc-actions a { font-size: var(--text-sm); white-space: nowrap; }

/* table of contents — channel chips */
.doc-toc {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-xs);
  margin-top: var(--space-xl);
}
.doc-toc a {
  font-family: var(--font-outlier);
  font-size: var(--text-sm);
  color: var(--color-neutral);
  text-decoration: none;
  border: var(--rule-hair) solid var(--color-rule);
  border-radius: 999px;
  padding: var(--space-2xs) var(--space-md);
  min-height: 2.25rem;
  display: inline-flex;
  align-items: center;
  white-space: nowrap;
  transition: border-color var(--dur-micro) var(--ease-out), color var(--dur-micro) var(--ease-out),
              box-shadow var(--dur-short) var(--ease-out);
}
.doc-toc a:hover {
  border-color: var(--color-accent);
  color: var(--color-ink);
  box-shadow: 2px 0 0 0 var(--ghost-red), -2px 0 0 0 var(--ghost-cyan);
}

/* ————— sections ————— */
.doc { padding-block: var(--space-2xl) var(--space-3xl); }
.doc-sec { padding-block: var(--space-xl); }
.doc-sec + .doc-sec { border-top: var(--rule-hair) solid var(--color-rule); }

.doc-sec h2 {
  font-size: var(--text-xl);
  scroll-margin-top: var(--space-2xl);
}
.doc-sec h2 .sec-num {
  font-family: var(--font-numeral);
  font-weight: 600;
  font-size: var(--text-md);
  color: var(--color-accent);
  font-variant-numeric: tabular-nums;
  margin-inline-end: var(--space-md);
  vertical-align: 0.1em;
}
.doc-sec h3 {
  font-size: var(--text-md);
  margin-top: var(--space-xl);
  scroll-margin-top: var(--space-2xl);
}
.doc-sec h4 {
  font-size: var(--text-base);
  margin-top: var(--space-lg);
  color: var(--color-muted);
}

.doc-sec p { color: var(--color-neutral); margin-top: var(--space-md); max-width: 62ch; }
.doc-sec ul, .doc-sec ol { color: var(--color-neutral); margin: var(--space-md) 0 0; padding-inline-start: 1.4em; max-width: 62ch; }
.doc-sec li { margin-top: var(--space-xs); }
.doc-sec li::marker { color: var(--color-accent); }
.doc-sec strong { color: var(--color-muted); }

/* ————— code — machine text on darker paper ————— */
code {
  font-family: var(--font-outlier);
  font-size: 0.86em;
  color: var(--color-muted);
  background: var(--color-paper-2);
  border: var(--rule-hair) solid var(--color-rule);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.35em;
}
pre {
  margin: var(--space-md) 0 0;
  padding: var(--space-lg);
  background: var(--color-paper-2);
  border: var(--rule-hair) solid var(--color-rule);
  border-radius: var(--radius-md);
  overflow-x: auto;
  transition: box-shadow var(--dur-short) var(--ease-out);
}
pre:hover { box-shadow: 4px 0 0 -1px var(--ghost-red), -4px 0 0 -1px var(--ghost-cyan); }
pre code {
  display: block;
  background: none;
  border: none;
  padding: 0;
  font-size: var(--text-sm);
  line-height: 1.7;
  color: var(--color-muted);
}
/* a mono label above a code block: the file / context it belongs to */
.code-tag {
  display: block;
  margin-top: var(--space-lg);
  font-family: var(--font-outlier);
  font-size: var(--text-xs);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-neutral);
}
.code-tag + pre { margin-top: var(--space-xs); }

/* ————— tables — API references, benchmark grids ————— */
.doc-table-wrap { overflow-x: auto; margin-top: var(--space-md); }
table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-sm);
}
th {
  font-family: var(--font-outlier);
  font-size: var(--text-xs);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  font-weight: 400;
  color: var(--color-neutral);
  text-align: left;
  padding: var(--space-sm) var(--space-md) var(--space-sm) 0;
  border-bottom: var(--rule-bold) solid var(--color-rule);
  white-space: nowrap;
}
td {
  color: var(--color-neutral);
  padding: var(--space-sm) var(--space-md) var(--space-sm) 0;
  border-bottom: var(--rule-hair) solid var(--color-rule);
  vertical-align: top;
}
td:first-child { color: var(--color-muted); }
td code { white-space: nowrap; }
tr:hover td { color: var(--color-muted); }

/* ————— stat tiles — the numbers, printed twice ————— */
.doc-stats {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(10rem, 100%), 1fr));
  gap: var(--space-md);
  margin-top: var(--space-lg);
}
.stat {
  padding: var(--space-lg);
  background: var(--color-paper-2);
  border: var(--rule-hair) solid var(--color-rule);
  border-radius: var(--radius-md);
  transition: border-color var(--dur-short) var(--ease-out), box-shadow var(--dur-short) var(--ease-out);
}
.stat:hover {
  border-color: var(--color-accent);
  box-shadow: 4px 0 0 -1px var(--ghost-red), -4px 0 0 -1px var(--ghost-cyan);
}
.stat__num {
  font-family: var(--font-numeral);
  font-weight: 600;
  font-size: var(--text-xl);
  line-height: 1.1;
  color: var(--color-ink);
  font-variant-numeric: tabular-nums;
}
.stat__label {
  margin-top: var(--space-xs);
  font-family: var(--font-outlier);
  font-size: var(--text-xs);
  color: var(--color-neutral);
}

/* ————— feature / concept cards ————— */
.doc-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(15rem, 100%), 1fr));
  gap: var(--space-md);
  margin-top: var(--space-lg);
}
.doc-card {
  padding: var(--space-lg);
  background: var(--color-paper-2);
  border: var(--rule-hair) solid var(--color-rule);
  border-radius: var(--radius-md);
  transition: border-color var(--dur-short) var(--ease-out), box-shadow var(--dur-short) var(--ease-out);
}
.doc-card:hover {
  border-color: var(--color-accent);
  box-shadow: 4px 0 0 -1px var(--ghost-red), -4px 0 0 -1px var(--ghost-cyan);
}
.doc-card__name { font-family: var(--font-display); font-weight: 700; font-size: var(--text-base); color: var(--color-ink); }
.doc-card__desc { color: var(--color-neutral); font-size: var(--text-sm); margin-top: var(--space-xs); }

/* ————— callout — a note pinned to the strip ————— */
.callout {
  margin-top: var(--space-lg);
  padding: var(--space-md) var(--space-lg);
  border: var(--rule-hair) dashed var(--color-rule);
  border-radius: var(--radius-md);
  font-size: var(--text-sm);
  color: var(--color-neutral);
  max-width: 62ch;
}
.callout__tag {
  display: block;
  font-family: var(--font-outlier);
  font-size: var(--text-xs);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-accent);
  margin-bottom: var(--space-2xs);
}

/* ————— API reference entries ————— */
.api { margin-top: var(--space-lg); }
.api-item { padding-block: var(--space-lg); border-top: var(--rule-hair) solid var(--color-rule); }
.api-item:last-child { border-bottom: var(--rule-hair) solid var(--color-rule); }
.api-item__sig {
  font-family: var(--font-outlier);
  font-size: var(--text-sm);
  color: var(--color-ink);
  overflow-wrap: anywhere;
}
.api-item__sig .fn { color: var(--color-accent); font-weight: 700; }
.api-item__desc { color: var(--color-neutral); font-size: var(--text-sm); margin-top: var(--space-xs); max-width: 62ch; }

/* ————— footer ————— */
.doc-foot {
  border-top: var(--rule-hair) solid var(--color-rule);
  padding-block: var(--space-xl) var(--space-3xl);
}
.doc-foot__inner {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-lg);
  align-items: baseline;
  font-size: var(--text-sm);
  color: var(--color-neutral);
}
.doc-foot a { white-space: nowrap; }

/* ————— ambient misbehaviour (docs.js taps these) ————— */
.tic-split { animation: head-split 300ms steps(3); }
@keyframes head-split {
  0%   { text-shadow: 10px 0 0 var(--ghost-red), -10px 0 0 var(--ghost-cyan); }
  50%  { text-shadow: -7px 0 0 var(--ghost-red), 7px 0 0 var(--ghost-cyan); }
  100% { text-shadow: 0 0 0 var(--ghost-red), 0 0 0 var(--ghost-cyan); }
}

/* ————— responsive ————— */
@media (max-width: 40rem) {
  :root { --film-rail: 1.4rem; }
  .doc, .doc-mast__inner, .doc-foot__inner { padding-inline: calc(var(--film-rail) + var(--space-lg)); }
  .doc-mast { padding-block-start: var(--space-2xl); }
  .doc-title { font-size: var(--text-2xl); }
  .osd { font-size: var(--text-xs); }
}
@media (pointer: coarse) {
  .doc-actions a, .doc-foot a { min-height: 44px; display: inline-flex; align-items: center; }
}

/* ————— reduced motion ————— */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after {
    animation-duration: 150ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 150ms !important;
  }
  .static { display: none; }
}