/* ============================================================================
 * Docs Platform — shared shell for the library documentation family
 * driftwatch · evalkit · fastinfer · leakguard · ml-service-blueprint
 * model-foundry · quantkit · rankforge · tinytorch
 *
 * Structure, code blocks, sidebar, API tables, quickstart, motion and icons are
 * shared. Each library keeps its own accent hue and paper ramp from tokens.css,
 * so the sites read as siblings rather than clones.
 *
 * Every class is `dp-` prefixed and every colour resolves through a token with a
 * fallback, so this file can be dropped onto a site whose tokens are named
 * differently without exploding.
 * ========================================================================== */

:root {
  /* — platform surfaces, derived from each site's paper ramp ————————— */
  --dp-bg:        var(--color-paper,   #fbfaf8);
  --dp-bg-2:      var(--color-paper-2, #f2f0ec);
  --dp-bg-3:      var(--color-paper-3, #e8e5df);
  --dp-rule:      var(--color-rule,    #dcd8d1);
  --dp-rule-2:    var(--color-rule-2,  #b9b3a9);
  --dp-ink:       var(--color-ink,     #1c1a17);
  --dp-ink-2:     var(--color-ink-2,   #3a3630);
  --dp-muted:     var(--color-muted,   #55504a);
  --dp-neutral:   var(--color-neutral, #6c665e);
  --dp-accent:    var(--color-accent,  #a8461f);
  /* Secondary *text* is deliberately not --dp-neutral. Several sites in this
   * family set a neutral light enough that 11-13px text on it measured
   * 3.6-4.0:1 — under AA. Small copy uses the darker `muted` step; neutral is
   * kept for rules, gutters, list markers and low-emphasis icons. */
  --dp-secondary: var(--color-muted, var(--color-neutral, #55504a));
  --dp-accent-soft: var(--color-accent-soft, var(--color-accent-wash, #f6e5dc));
  --dp-focus:     var(--color-focus,   var(--color-accent, #a8461f));

  /* — code surface: a distinct material, not just another paper tint ——— */
  --dp-code-bg:      oklch(from var(--dp-bg) calc(l - 0.045) calc(c * 0.7) h);
  --dp-code-bar:     oklch(from var(--dp-bg) calc(l - 0.075) calc(c * 0.7) h);
  --dp-code-rule:    var(--dp-rule);
  --dp-code-ink:     var(--dp-ink);
  --dp-code-gutter:  var(--dp-neutral);

  /* syntax palette — hue-anchored to the site accent so it never clashes */
  --dp-syn-comment: oklch(from var(--dp-neutral) l calc(c * 0.8) h);
  --dp-syn-keyword: oklch(from var(--dp-accent) calc(l - 0.02) c h);
  --dp-syn-string:  oklch(48% 0.095 152);
  --dp-syn-number:  oklch(48% 0.110 265);
  --dp-syn-builtin: oklch(46% 0.085 300);
  --dp-syn-punct:   var(--dp-muted);

  /* — icon sizing scale ————————————————————————————————— */
  --dp-icon-sm: 0.875rem;   /* inline with small text / chips        */
  --dp-icon-md: 1rem;       /* default control and nav icon          */
  --dp-icon-lg: 1.25rem;    /* section markers, prominent affordance */
  --dp-icon-xl: 1.75rem;    /* empty / feature states                */
  --dp-icon-stroke: 1.75;

  /* — motion ————————————————————————————————————————— */
  --dp-ease:     var(--ease-out, cubic-bezier(0.16, 1, 0.3, 1));
  --dp-ease-in:  var(--ease-in,  cubic-bezier(0.7, 0, 0.84, 0));
  --dp-dur-1:    var(--dur-micro, 130ms);
  --dp-dur-2:    var(--dur-short, 220ms);
  --dp-dur-3:    var(--dur-long,  380ms);

  /* — geometry ——————————————————————————————————————— */
  --dp-radius:    var(--radius-md, 4px);
  --dp-radius-sm: var(--radius-sm, 2px);
  --dp-hair:      var(--rule-hair, 1px);
  --dp-side-w:    16.5rem;
  --dp-nav-h:     3.5rem;

  /* — elevation: hairline-first, shadow only where it earns its keep —— */
  --dp-shadow-1: 0 1px 2px -1px oklch(from var(--dp-ink) l c h / 0.10);
  --dp-shadow-2: 0 4px 14px -6px oklch(from var(--dp-ink) l c h / 0.18),
                 0 1px 2px -1px  oklch(from var(--dp-ink) l c h / 0.10);
}

/* Dark: the code surface goes *up* from the page, not down. */
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --dp-code-bg:   oklch(from var(--dp-bg) calc(l + 0.035) calc(c * 0.8) h);
    --dp-code-bar:  oklch(from var(--dp-bg) calc(l + 0.065) calc(c * 0.8) h);
    --dp-syn-string:  oklch(80% 0.115 152);
    --dp-syn-number:  oklch(80% 0.100 265);
    --dp-syn-builtin: oklch(80% 0.090 300);
    --dp-shadow-1: 0 1px 2px -1px oklch(0% 0 0 / 0.5);
    --dp-shadow-2: 0 4px 16px -6px oklch(0% 0 0 / 0.6), 0 1px 2px -1px oklch(0% 0 0 / 0.4);
  }
}
:root[data-theme="dark"] {
  --dp-code-bg:   oklch(from var(--dp-bg) calc(l + 0.035) calc(c * 0.8) h);
  --dp-code-bar:  oklch(from var(--dp-bg) calc(l + 0.065) calc(c * 0.8) h);
  --dp-syn-string:  oklch(80% 0.115 152);
  --dp-syn-number:  oklch(80% 0.100 265);
  --dp-syn-builtin: oklch(80% 0.090 300);
  --dp-shadow-1: 0 1px 2px -1px oklch(0% 0 0 / 0.5);
  --dp-shadow-2: 0 4px 16px -6px oklch(0% 0 0 / 0.6), 0 1px 2px -1px oklch(0% 0 0 / 0.4);
}

/* Browsers without relative-colour syntax get flat, still-correct fallbacks. */
@supports not (color: oklch(from #fff l c h)) {
  :root { --dp-code-bg: var(--dp-bg-2); --dp-code-bar: var(--dp-bg-3);
          --dp-syn-comment: var(--dp-neutral); --dp-syn-keyword: var(--dp-accent);
          --dp-shadow-1: 0 1px 2px -1px rgb(0 0 0 / 0.10);
          --dp-shadow-2: 0 4px 14px -6px rgb(0 0 0 / 0.18); }
}

/* ————————————————————————————————————————————————————————————
 * 1 · Icons
 * ———————————————————————————————————————————————————————————— */
.dp-i {
  width: var(--dp-icon-md); height: var(--dp-icon-md);
  flex: none; display: inline-block; vertical-align: -0.14em;
  stroke: currentColor; fill: none;
  stroke-width: var(--dp-icon-stroke);
  stroke-linecap: round; stroke-linejoin: round;
  overflow: visible;
}
.dp-i--sm { width: var(--dp-icon-sm); height: var(--dp-icon-sm); stroke-width: 2; }
.dp-i--lg { width: var(--dp-icon-lg); height: var(--dp-icon-lg); stroke-width: 1.6; }
.dp-i--xl { width: var(--dp-icon-xl); height: var(--dp-icon-xl); stroke-width: 1.4; }
.dp-sprite { position: absolute; width: 0; height: 0; overflow: hidden; }

/* ————————————————————————————————————————————————————————————
 * 2 · Skip link
 * ———————————————————————————————————————————————————————————— */
.dp-skip {
  position: fixed; top: 0.5rem; left: 0.5rem; z-index: 1000;
  padding: 0.6rem 0.95rem; border-radius: var(--dp-radius);
  background: var(--dp-accent); color: var(--dp-bg);
  font: 600 0.8125rem/1 var(--font-body, system-ui, sans-serif);
  text-decoration: none; box-shadow: var(--dp-shadow-2);
  transform: translateY(-160%); transition: transform var(--dp-dur-2) var(--dp-ease);
}
.dp-skip:focus-visible { transform: translateY(0); }

/* ————————————————————————————————————————————————————————————
 * 3 · Top bar — reading progress, brand, links, theme toggle
 * ———————————————————————————————————————————————————————————— */
.dp-bar {
  position: sticky; top: 0; z-index: 300;
  display: flex; align-items: center; gap: 1rem;
  min-height: var(--dp-nav-h);
  padding-inline: var(--page-gutter, clamp(1.15rem, 4vw, 2.5rem));
  background: color-mix(in oklch, var(--dp-bg) 86%, transparent);
  backdrop-filter: saturate(1.6) blur(10px);
  -webkit-backdrop-filter: saturate(1.6) blur(10px);
  border-bottom: var(--dp-hair) solid var(--dp-rule);
}
@supports not (backdrop-filter: blur(2px)) { .dp-bar { background: var(--dp-bg); } }

.dp-bar__progress {
  position: absolute; left: 0; bottom: -1px; height: 2px; width: 100%;
  transform: scaleX(var(--dp-progress, 0)); transform-origin: 0 50%;
  background: var(--dp-accent); will-change: transform;
}

.dp-brand {
  display: inline-flex; align-items: center; gap: 0.5rem;
  font-family: var(--font-display, var(--font-body, system-ui));
  font-size: 1.125rem; font-weight: 600; letter-spacing: -0.015em;
  line-height: 1; text-decoration: none; color: inherit;
  min-height: 44px; margin-right: auto; flex: 0 1 auto; min-width: 0;
}
.dp-brand em { font-style: normal; color: var(--dp-accent); }
.dp-brand .dp-i { color: var(--dp-accent); transition: transform var(--dp-dur-2) var(--dp-ease); }
.dp-brand:hover .dp-i { transform: rotate(-8deg) scale(1.06); }

.dp-bar__links { display: flex; align-items: center; gap: 0.25rem; }
.dp-bar__links a {
  position: relative; display: inline-flex; align-items: center; gap: 0.4rem;
  padding: 0.5rem 0.65rem; min-height: 44px; border-radius: var(--dp-radius);
  font-size: 0.8125rem; font-weight: 500; letter-spacing: 0.01em;
  color: var(--dp-secondary); text-decoration: none; white-space: nowrap;
  transition: color var(--dp-dur-1) var(--dp-ease), background-color var(--dp-dur-1) var(--dp-ease);
}
.dp-bar__links a:hover { color: var(--dp-ink); background: var(--dp-bg-2); }
.dp-bar__links a .dp-i { opacity: 0.7; transition: transform var(--dp-dur-2) var(--dp-ease), opacity var(--dp-dur-1) var(--dp-ease); }
.dp-bar__links a:hover .dp-i { opacity: 1; transform: translateX(1px) translateY(-1px); }

.dp-ver {
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; font-variant-numeric: tabular-nums;
  padding: 0.25rem 0.5rem; border-radius: 999px;
  border: var(--dp-hair) solid var(--dp-rule);
  background: var(--dp-bg-2); color: var(--dp-secondary);
  letter-spacing: 0.02em; white-space: nowrap; flex: none;
}

/* icon-only control — used by the theme toggle and the mobile contents button */
.dp-iconbtn {
  display: inline-flex; align-items: center; justify-content: center;
  /* flex: none — the bar is a flex row, and without this the button is the
   * first thing squeezed below its target size on narrow screens. */
  flex: none;
  width: 40px; height: 40px; padding: 0;
  border: var(--dp-hair) solid transparent; border-radius: var(--dp-radius);
  background: transparent; color: var(--dp-secondary); cursor: pointer;
  transition: color var(--dp-dur-1) var(--dp-ease), background-color var(--dp-dur-1) var(--dp-ease),
              border-color var(--dp-dur-1) var(--dp-ease), transform var(--dp-dur-1) var(--dp-ease);
}
.dp-iconbtn:hover { color: var(--dp-ink); background: var(--dp-bg-2); border-color: var(--dp-rule); }
.dp-iconbtn:active { transform: scale(0.93); }
.dp-iconbtn[aria-expanded="true"] { color: var(--dp-accent); background: var(--dp-accent-soft); border-color: var(--dp-rule); }

/* theme toggle cross-fades sun/moon in place rather than swapping glyphs */
.dp-theme { position: relative; }
.dp-theme .dp-i { position: absolute; transition: opacity var(--dp-dur-2) var(--dp-ease), transform var(--dp-dur-2) var(--dp-ease); }
.dp-theme .dp-i--moon { opacity: 0; transform: rotate(-70deg) scale(0.6); }
.dp-theme .dp-i--sun  { opacity: 1; transform: rotate(0) scale(1); }
:root[data-theme="dark"] .dp-theme .dp-i--moon,
.dp-theme[data-resolved="dark"] .dp-i--moon { opacity: 1; transform: rotate(0) scale(1); }
:root[data-theme="dark"] .dp-theme .dp-i--sun,
.dp-theme[data-resolved="dark"] .dp-i--sun  { opacity: 0; transform: rotate(70deg) scale(0.6); }

@media (max-width: 40rem) { .dp-bar__links .dp-bar__hide { display: none; } }

/* ————————————————————————————————————————————————————————————
 * 4 · Shell — sidebar + document
 * ———————————————————————————————————————————————————————————— */
.dp-shell {
  display: grid;
  grid-template-columns: var(--dp-side-w) minmax(0, 1fr);
  gap: clamp(2rem, 4vw, 4rem);
  max-width: 84rem; margin-inline: auto;
  padding-inline: var(--page-gutter, clamp(1.15rem, 4vw, 2.5rem));
  align-items: start;
}
.dp-main { min-width: 0; padding-block: clamp(2rem, 4vw, 3.5rem) 5rem; }

/* — sidebar ————————————————————————————————————————————— */
.dp-side {
  position: sticky; top: var(--dp-nav-h);
  max-height: calc(100dvh - var(--dp-nav-h));
  overflow-y: auto; overscroll-behavior: contain;
  padding-block: clamp(2rem, 4vw, 3.5rem) 3rem;
  scrollbar-width: thin; scrollbar-color: var(--dp-rule-2) transparent;
}
.dp-side::-webkit-scrollbar { width: 6px; }
.dp-side::-webkit-scrollbar-thumb { background: var(--dp-rule); border-radius: 3px; }
.dp-side:hover::-webkit-scrollbar-thumb { background: var(--dp-rule-2); }

.dp-side__label {
  display: flex; align-items: center; gap: 0.45rem;
  margin: 0 0 0.85rem; padding-inline-start: 0.7rem;
  font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.13em;
  text-transform: uppercase; color: var(--dp-secondary);
}
.dp-toc { list-style: none; margin: 0; padding: 0; counter-reset: dptoc; }
.dp-toc li { counter-increment: dptoc; }
.dp-toc a {
  position: relative; display: grid;
  grid-template-columns: 1.85rem minmax(0, 1fr); align-items: baseline;
  gap: 0.15rem; padding: 0.5rem 0.7rem; border-radius: var(--dp-radius);
  font-size: 0.8125rem; line-height: 1.45; text-decoration: none;
  color: var(--dp-muted);
  transition: color var(--dp-dur-1) var(--dp-ease), background-color var(--dp-dur-1) var(--dp-ease);
}
/* the active rail slides between items instead of blinking on and off */
.dp-toc a::before {
  content: ""; position: absolute; left: 0; top: 0.42rem; bottom: 0.42rem;
  width: 2px; border-radius: 1px; background: var(--dp-accent);
  transform: scaleY(0); transform-origin: 50% 50%; opacity: 0;
  transition: transform var(--dp-dur-2) var(--dp-ease), opacity var(--dp-dur-1) var(--dp-ease);
}
.dp-toc a::after {
  content: counter(dptoc, decimal-leading-zero);
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; font-variant-numeric: tabular-nums;
  color: var(--dp-secondary); grid-column: 1; grid-row: 1;
  transition: color var(--dp-dur-1) var(--dp-ease);
}
.dp-toc a b { grid-column: 2; grid-row: 1; font-weight: 500; }
.dp-toc a i { grid-column: 2; grid-row: 2; font-style: normal; font-size: 0.75rem; color: var(--dp-secondary); }
.dp-toc a:hover { color: var(--dp-ink); background: var(--dp-bg-2); }
.dp-toc a[aria-current="true"] { color: var(--dp-ink); font-weight: 500; background: var(--dp-accent-soft); }
.dp-toc a[aria-current="true"]::before { transform: scaleY(1); opacity: 1; }
.dp-toc a[aria-current="true"]::after { color: var(--dp-accent); }

/* A lead entry sits outside the numbered run — it shows 00 and does not
 * advance the counter, so the rail matches the section numbers exactly. */
.dp-toc li.is-lead { counter-increment: none; }
.dp-toc li.is-lead a::after { content: "00"; }

.dp-side__foot {
  margin-top: 1.5rem; padding: 0.9rem 0.7rem 0;
  border-top: var(--dp-hair) solid var(--dp-rule);
  display: grid; gap: 0.15rem;
}
.dp-side__foot a {
  display: inline-flex; align-items: center; gap: 0.5rem;
  padding: 0.45rem 0; min-height: 40px;
  font-size: 0.78125rem; color: var(--dp-secondary); text-decoration: none;
  transition: color var(--dp-dur-1) var(--dp-ease);
}
.dp-side__foot a:hover { color: var(--dp-accent); }
.dp-side__foot a .dp-i { transition: transform var(--dp-dur-2) var(--dp-ease); }
.dp-side__foot a:hover .dp-i { transform: translateX(2px); }

/* — mobile: the sidebar becomes a disclosure under the bar ————————— */
.dp-side__toggle { display: none; }
@media (max-width: 64rem) {
  .dp-shell { grid-template-columns: minmax(0, 1fr); gap: 0; }
  .dp-side {
    position: static; max-height: none; overflow: visible;
    padding-block: 0; margin-top: 1.5rem;
    border: var(--dp-hair) solid var(--dp-rule); border-radius: var(--dp-radius);
    background: var(--dp-bg-2);
  }
  .dp-side__label { display: none; }
  .dp-side__toggle {
    display: flex; align-items: center; gap: 0.55rem; width: 100%;
    padding: 0.85rem 1rem; min-height: 48px;
    background: none; border: 0; border-radius: var(--dp-radius);
    font: 600 0.8125rem/1 var(--font-body, system-ui, sans-serif);
    letter-spacing: 0.06em; text-transform: uppercase;
    color: var(--dp-ink); cursor: pointer; text-align: left;
  }
  .dp-side__toggle .dp-i--chev { margin-left: auto; transition: transform var(--dp-dur-2) var(--dp-ease); }
  .dp-side__toggle[aria-expanded="true"] .dp-i--chev { transform: rotate(90deg); }
  .dp-side__panel { padding: 0 0.5rem 0.6rem; }
  .dp-side__panel[hidden] { display: none; }
  .dp-toc a { grid-template-columns: 1.85rem minmax(0, 1fr); min-height: 44px; align-content: center; }
  .dp-main { padding-block: 2rem 4rem; }
}

/* ————————————————————————————————————————————————————————————
 * 5 · Document typography
 * ———————————————————————————————————————————————————————————— */
/* The measure is held by the prose elements themselves, not by their section,
 * so wide evidence — tables, transcripts, diagrams — can deliberately break the
 * column while the text it explains stays readable. */
.dp-main > * { max-width: var(--measure, 68ch); }
.dp-main > .dp-sec, .dp-main > .dp-hero, .dp-main > .dp-bleed { max-width: none; }
.dp-sec > p, .dp-sec > h3, .dp-sec > h4, .dp-sec > ul, .dp-sec > ol,
.dp-sec > .dp-h2, .dp-sec > .dp-kv, .dp-sec > .dp-note, .dp-sec > .dp-flow,
.dp-sec > .dp-quick, .dp-sec > .dp-code, .dp-sec > .dp-cmd, .dp-sec > .dp-tablewrap,
.dp-sec > blockquote, .dp-sec > figure {
  max-width: var(--measure, 68ch);
}
/* Deliberately not `.dp-sec > div`: a bare wrapper div is a layout container
 * on several of these sites, and clamping it to the prose measure collapses
 * whatever grid it holds. Sites opt their own prose wrappers in instead. */
.dp-sec > .dp-bleed { max-width: min(62rem, 100%); }

/* A full-bleed band escapes the document column entirely — for pages whose
 * macrostructure is banded rather than continuous prose. It escapes the main
 * column only, never the sidebar rail. */
.dp-fullbleed {
  max-width: none;
  margin-inline: calc(-1 * var(--page-gutter, 2rem));
  padding-inline: var(--page-gutter, 2rem);
}
@media (max-width: 64rem) {
  .dp-fullbleed { margin-inline: calc(-1 * var(--page-gutter, 1.25rem)); }
}

.dp-hero { padding-block: clamp(1rem, 3vw, 2.5rem) clamp(2rem, 4vw, 3rem); }
.dp-hero > p, .dp-hero > ul, .dp-hero > ol, .dp-hero > hr { max-width: var(--measure, 68ch); }
.dp-kicker {
  display: flex; align-items: center; gap: 0.55rem; flex-wrap: wrap;
  margin: 0 0 1.15rem;
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; font-weight: 500; letter-spacing: 0.12em;
  text-transform: uppercase; color: var(--dp-secondary);
}
.dp-kicker .dp-i { color: var(--dp-accent); }
.dp-kicker span + span::before {
  content: "·"; margin-inline: 0.5rem; color: var(--dp-rule-2);
}

.dp-h1 {
  font-family: var(--font-display, var(--font-body, system-ui));
  font-weight: 500; font-size: var(--text-display, clamp(2.35rem, 1.3rem + 4.2vw, 4.25rem));
  line-height: 1.03; letter-spacing: -0.023em; text-wrap: balance;
  margin: 0 0 1.15rem; max-width: 19ch; overflow-wrap: break-word;
}
.dp-lede {
  font-size: var(--text-lg, 1.1875rem); line-height: 1.6;
  color: var(--dp-ink-2); margin: 0 0 1rem; max-width: 58ch; text-wrap: pretty;
}

/* ————————————————————————————————————————————————————————————
 * 6 · Install / quickstart step flow
 * ———————————————————————————————————————————————————————————— */
.dp-quick {
  margin: 2rem 0 2.5rem; padding: 0; list-style: none;
  counter-reset: dpstep; position: relative;
}
.dp-quick > li {
  counter-increment: dpstep; position: relative;
  padding: 0 0 1.75rem 3rem;
}
/* continuous rail, drawn per-step so the last one stops at its own marker */
.dp-quick > li::before {
  content: ""; position: absolute; left: 0.9375rem; top: 1.9rem; bottom: 0;
  width: var(--dp-hair); background: var(--dp-rule);
}
.dp-quick > li:last-child { padding-bottom: 0; }
.dp-quick > li:last-child::before { display: none; }
.dp-quick > li::after {
  content: counter(dpstep);
  position: absolute; left: 0; top: 0.05rem;
  display: grid; place-items: center;
  width: 1.875rem; height: 1.875rem; border-radius: 50%;
  border: var(--dp-hair) solid var(--dp-rule-2);
  background: var(--dp-bg); color: var(--dp-accent);
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.75rem; font-weight: 500; font-variant-numeric: tabular-nums;
  transition: border-color var(--dp-dur-2) var(--dp-ease), background-color var(--dp-dur-2) var(--dp-ease);
}
.dp-quick > li:hover::after { border-color: var(--dp-accent); background: var(--dp-accent-soft); }
.dp-quick h3, .dp-quick .dp-quick__t {
  margin: 0 0 0.3rem; font-family: var(--font-body, system-ui);
  font-size: 1rem; font-weight: 600; line-height: 1.4; letter-spacing: 0;
}
.dp-quick p { margin: 0 0 0.75rem; color: var(--dp-ink-2); }
.dp-quick p:last-child, .dp-quick .dp-code:last-child { margin-bottom: 0; }

/* ————————————————————————————————————————————————————————————
 * 7 · Code blocks
 * ———————————————————————————————————————————————————————————— */
.dp-code {
  margin: 1.5rem 0; border: var(--dp-hair) solid var(--dp-code-rule);
  border-radius: var(--dp-radius); background: var(--dp-code-bg);
  overflow: hidden; box-shadow: var(--dp-shadow-1);
  transition: border-color var(--dp-dur-2) var(--dp-ease), box-shadow var(--dp-dur-2) var(--dp-ease);
}
.dp-code:hover { border-color: var(--dp-rule-2); box-shadow: var(--dp-shadow-2); }

.dp-code__bar {
  display: flex; align-items: center; gap: 0.6rem;
  padding: 0.4rem 0.45rem 0.4rem 0.85rem;
  min-height: 2.375rem;
  background: var(--dp-code-bar);
  border-bottom: var(--dp-hair) solid var(--dp-code-rule);
}
.dp-code__lang {
  display: inline-flex; align-items: center; gap: 0.4rem;
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; font-weight: 500; letter-spacing: 0.07em;
  text-transform: lowercase; color: var(--dp-secondary);
}
.dp-code__lang .dp-i { color: var(--dp-accent); opacity: 0.85; }
.dp-code__file {
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; color: var(--dp-muted); margin-left: auto;
  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
}
.dp-code__file + .dp-copy { margin-left: 0.5rem; }
.dp-code__lang + .dp-copy { margin-left: auto; }

.dp-code pre {
  margin: 0; padding: 0.95rem 1rem 1rem;
  overflow-x: auto; -webkit-overflow-scrolling: touch;
  scrollbar-width: thin; scrollbar-color: var(--dp-rule-2) transparent;
}
.dp-code pre::-webkit-scrollbar { height: 8px; }
.dp-code pre::-webkit-scrollbar-thumb { background: var(--dp-rule); border-radius: 4px; }
.dp-code pre:hover::-webkit-scrollbar-thumb { background: var(--dp-rule-2); }
.dp-code code {
  display: block; background: none; padding: 0; border-radius: 0;
  font-family: var(--font-mono, ui-monospace, SFMono-Regular, monospace);
  font-size: 0.8125rem; line-height: 1.62;
  color: var(--dp-code-ink); tab-size: 4;
  font-variant-ligatures: none;
}

/* line-level: numbering and highlight */
.dp-code--numbered code { counter-reset: dpln; }
/* Terminal transcripts and ASCII tables read better tight — the grid is the
 * information, and loose leading breaks the columns apart visually. */
.dp-code[data-lang="text"] code, .dp-code[data-lang="console"] code { line-height: 1.5; }
.dp-code[data-lang="text"] .dp-ln, .dp-code[data-lang="console"] .dp-ln { min-height: 1.5em; }
.dp-code--numbered .dp-ln::before {
  content: counter(dpln); counter-increment: dpln;
  display: inline-block; width: 2ch; margin-right: 1.25ch;
  text-align: right; color: var(--dp-code-gutter); opacity: 0.55;
  user-select: none; -webkit-user-select: none;
}
.dp-ln { display: block; padding-inline: 1rem; margin-inline: -1rem; min-height: 1.62em; }
.dp-ln--hl {
  background: color-mix(in oklch, var(--dp-accent) 11%, transparent);
  box-shadow: inset 2px 0 0 var(--dp-accent);
}
.dp-ln--add { background: color-mix(in oklch, var(--dp-syn-string) 13%, transparent); }
.dp-ln--del { background: color-mix(in oklch, var(--color-crit, #b3261e) 12%, transparent); opacity: 0.75; }

/* syntax tokens */
.dp-t-com { color: var(--dp-syn-comment); font-style: italic; }
.dp-t-key { color: var(--dp-syn-keyword); font-weight: 500; }
.dp-t-str { color: var(--dp-syn-string); }
.dp-t-num { color: var(--dp-syn-number); font-variant-numeric: tabular-nums; }
.dp-t-fun { color: var(--dp-syn-builtin); }
.dp-t-pun { color: var(--dp-syn-punct); }
.dp-t-pmt { color: var(--dp-accent); user-select: none; -webkit-user-select: none; }
/* Printed output below a data-src-until boundary: unhighlighted, and set back
 * a little so the source above it stays the figure's subject. */
.dp-ln--out { color: var(--dp-muted); }

/* copy button — icon swaps to a check, label announced politely */
.dp-copy {
  display: inline-flex; align-items: center; gap: 0.35rem;
  height: 30px; padding: 0 0.55rem;
  border: var(--dp-hair) solid transparent; border-radius: var(--dp-radius-sm);
  background: transparent; color: var(--dp-secondary); cursor: pointer;
  font: 500 0.6875rem/1 var(--font-body, system-ui, sans-serif);
  letter-spacing: 0.03em;
  transition: color var(--dp-dur-1) var(--dp-ease), background-color var(--dp-dur-1) var(--dp-ease),
              border-color var(--dp-dur-1) var(--dp-ease), transform var(--dp-dur-1) var(--dp-ease);
}
.dp-copy:hover { color: var(--dp-ink); background: var(--dp-bg); border-color: var(--dp-rule); }
.dp-copy:active { transform: scale(0.94); }
.dp-copy .dp-i { transition: transform var(--dp-dur-2) var(--dp-ease), opacity var(--dp-dur-1) var(--dp-ease); }
.dp-copy__done { display: none; }
.dp-copy[data-copied="true"] { color: var(--dp-syn-string); border-color: transparent; background: transparent; }
.dp-copy[data-copied="true"] .dp-copy__idle { display: none; }
.dp-copy[data-copied="true"] .dp-copy__done { display: inline-flex; align-items: center; gap: 0.35rem; }
.dp-copy[data-copied="true"] .dp-i { animation: dp-pop var(--dp-dur-3) var(--dp-ease); }
@keyframes dp-pop { 0% { transform: scale(0.4); opacity: 0; } 60% { transform: scale(1.15); } 100% { transform: scale(1); opacity: 1; } }
.dp-copy[data-copied="error"] { color: var(--color-crit, #b3261e); }

/* A copy control floated over someone else's <pre> — used where a markdown
 * renderer or highlight.js owns the block and should not be rewritten. */
.dp-prewrap { position: relative; }
.dp-prewrap > .dp-copy {
  position: absolute; top: 0.5rem; right: 0.5rem; z-index: 2;
  background: var(--dp-bg); border-color: var(--dp-rule);
  opacity: 0; transition: opacity var(--dp-dur-2) var(--dp-ease),
                          color var(--dp-dur-1) var(--dp-ease);
}
.dp-prewrap:hover > .dp-copy,
.dp-prewrap > .dp-copy:focus-visible,
.dp-prewrap > .dp-copy[data-copied] { opacity: 1; }
@media (hover: none) { .dp-prewrap > .dp-copy { opacity: 1; } }

/* single-line command, presented as a terminal line rather than a block */
.dp-cmd {
  display: flex; align-items: center; gap: 0.7rem;
  margin: 1.25rem 0; padding: 0.15rem 0.35rem 0.15rem 0.9rem;
  border: var(--dp-hair) solid var(--dp-code-rule); border-radius: var(--dp-radius);
  background: var(--dp-code-bg); box-shadow: var(--dp-shadow-1);
  transition: border-color var(--dp-dur-2) var(--dp-ease), box-shadow var(--dp-dur-2) var(--dp-ease);
}
.dp-cmd:hover { border-color: var(--dp-rule-2); box-shadow: var(--dp-shadow-2); }
.dp-cmd code {
  flex: 1 1 auto; min-width: 0; background: none; padding: 0.55rem 0;
  font-family: var(--font-mono, ui-monospace, monospace); font-size: 0.8125rem;
  line-height: 1.6; overflow-x: auto; white-space: pre; color: var(--dp-code-ink);
  scrollbar-width: none;
}
.dp-cmd code::-webkit-scrollbar { display: none; }
.dp-cmd .dp-i--prompt { color: var(--dp-accent); opacity: 0.8; }

/* inline code inside prose */
.dp-main :not(pre):not(.dp-cmd) > code, .dp-prose :not(pre):not(.dp-cmd) > code {
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.86em; padding: 0.12em 0.38em; border-radius: var(--dp-radius-sm);
  background: var(--dp-bg-2); border: var(--dp-hair) solid var(--dp-rule);
  color: var(--dp-ink-2); overflow-wrap: anywhere;
}

/* ————————————————————————————————————————————————————————————
 * 8 · Tables — general and API reference
 * ———————————————————————————————————————————————————————————— */
.dp-tablewrap {
  position: relative; margin: 1.75rem 0;
  border: var(--dp-hair) solid var(--dp-rule); border-radius: var(--dp-radius);
  background: var(--dp-bg);
  overflow: hidden;
}
.dp-tablewrap__scroll {
  overflow-x: auto; -webkit-overflow-scrolling: touch;
  scrollbar-width: thin; scrollbar-color: var(--dp-rule-2) transparent;
}
.dp-tablewrap__scroll::-webkit-scrollbar { height: 8px; }
.dp-tablewrap__scroll::-webkit-scrollbar-thumb { background: var(--dp-rule); border-radius: 4px; }
/* edge fades tell you there is more table off-screen */
.dp-tablewrap::before, .dp-tablewrap::after {
  content: ""; position: absolute; top: 0; bottom: 0; width: 2rem;
  pointer-events: none; opacity: 0; z-index: 2;
  transition: opacity var(--dp-dur-2) var(--dp-ease);
}
.dp-tablewrap::before { left: 0;  background: linear-gradient(90deg, var(--dp-bg), transparent); }
.dp-tablewrap::after  { right: 0; background: linear-gradient(270deg, var(--dp-bg), transparent); }
.dp-tablewrap[data-scroll~="start"]::before { opacity: 1; }
.dp-tablewrap[data-scroll~="end"]::after { opacity: 1; }

.dp-table { border-collapse: collapse; width: 100%; font-size: 0.875rem; }
.dp-table caption {
  text-align: left; padding: 0.85rem 1rem; color: var(--dp-secondary);
  font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.11em; text-transform: uppercase;
  border-bottom: var(--dp-hair) solid var(--dp-rule);
  background: var(--dp-bg-2);
}
.dp-table th, .dp-table td { text-align: left; padding: 0.7rem 1rem; vertical-align: top; }
.dp-table thead th {
  position: sticky; top: 0; z-index: 1;
  background: var(--dp-bg-2); color: var(--dp-muted);
  font-size: 0.75rem; font-weight: 600; letter-spacing: 0.03em; white-space: nowrap;
  border-bottom: var(--dp-hair) solid var(--dp-rule-2);
}
.dp-table tbody tr { border-top: var(--dp-hair) solid var(--dp-rule); }
.dp-table tbody tr:first-child { border-top: 0; }
.dp-table tbody tr { transition: background-color var(--dp-dur-1) var(--dp-ease); }
.dp-table tbody tr:hover { background: var(--dp-bg-2); }
.dp-table .n { text-align: right; font-family: var(--font-mono, ui-monospace, monospace); font-variant-numeric: tabular-nums; white-space: nowrap; }
.dp-table .k { font-family: var(--font-mono, ui-monospace, monospace); font-size: 0.9em; }

/* API reference: signature column carries the weight */
.dp-table--api td:first-child, .dp-table--api th:first-child { width: 1%; white-space: nowrap; }
.dp-table--api .dp-sig {
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.8125rem; font-weight: 500; color: var(--dp-ink);
  display: block;
}
.dp-table--api .dp-sig em { font-style: normal; color: var(--dp-accent); }
.dp-table--api .dp-argmeta {
  display: flex; flex-wrap: wrap; gap: 0.3rem 0.45rem; margin-top: 0.3rem;
}
.dp-type {
  display: inline-flex; align-items: center;
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; line-height: 1.5;
  padding: 0.05rem 0.4rem; border-radius: var(--dp-radius-sm);
  background: var(--dp-bg-2); border: var(--dp-hair) solid var(--dp-rule);
  color: var(--dp-muted); white-space: nowrap;
}
.dp-type--req { color: var(--dp-accent); border-color: color-mix(in oklch, var(--dp-accent) 35%, var(--dp-rule)); background: var(--dp-accent-soft); }
.dp-type--def { color: var(--dp-secondary); }

/* stacked cards below the point where an API table stops being readable */
@media (max-width: 46rem) {
  .dp-table--stack, .dp-table--stack thead, .dp-table--stack tbody,
  .dp-table--stack tr, .dp-table--stack th, .dp-table--stack td { display: block; }
  .dp-table--stack thead { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
  .dp-table--stack tbody tr { padding: 0.9rem 1rem; border-top: var(--dp-hair) solid var(--dp-rule); }
  .dp-table--stack td { padding: 0.2rem 0; }
  .dp-table--stack td[data-label]::before {
    content: attr(data-label); display: block;
    font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.08em;
    text-transform: uppercase; color: var(--dp-secondary); margin-bottom: 0.15rem;
  }
  .dp-table--stack .n { text-align: left; }
}

/* ————————————————————————————————————————————————————————————
 * 9 · Callouts, chips, key-value evidence
 * ———————————————————————————————————————————————————————————— */
.dp-note {
  display: grid; grid-template-columns: auto minmax(0, 1fr); gap: 0.75rem;
  margin: 1.6rem 0; padding: 0.9rem 1rem;
  border: var(--dp-hair) solid var(--dp-rule); border-left: 2px solid var(--dp-accent);
  border-radius: var(--dp-radius); background: var(--dp-bg-2); color: var(--dp-ink-2);
}
.dp-note > .dp-i { color: var(--dp-accent); margin-top: 0.22em; }
.dp-note__b > :first-child { margin-top: 0; }
.dp-note__b > :last-child { margin-bottom: 0; }
.dp-note--warn { border-left-color: var(--color-warn, #a06600); }
.dp-note--warn > .dp-i { color: var(--color-warn, #a06600); }

.dp-chip {
  display: inline-flex; align-items: center; gap: 0.4ch;
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; letter-spacing: 0.06em; text-transform: uppercase; white-space: nowrap;
}
.dp-chip .dp-i { width: 0.85em; height: 0.85em; stroke-width: 2.4; }

/* ————————————————————————————————————————————————————————————
 * 10 · Section headings with anchor affordance
 * ———————————————————————————————————————————————————————————— */
.dp-sec { margin: 0 0 clamp(3rem, 6vw, 4.5rem); scroll-margin-top: calc(var(--dp-nav-h) + 1.5rem); }
.dp-h2 {
  position: relative;
  font-family: var(--font-display, var(--font-body, system-ui));
  font-weight: 600; font-size: var(--text-2xl, 1.8rem); line-height: 1.15;
  letter-spacing: -0.014em; margin: 0 0 0.9rem; text-wrap: balance;
}
.dp-h2 .dp-num {
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.8125rem; font-weight: 400; color: var(--dp-accent);
  letter-spacing: 0; margin-right: 0.65ch; vertical-align: 0.18em;
}
.dp-anchor {
  display: inline-flex; align-items: center; justify-content: center;
  width: 1.6rem; height: 1.6rem; margin-left: 0.35rem; vertical-align: 0.05em;
  color: var(--dp-secondary); text-decoration: none; border-radius: var(--dp-radius-sm);
  opacity: 0; transform: translateX(-3px);
  transition: opacity var(--dp-dur-2) var(--dp-ease), transform var(--dp-dur-2) var(--dp-ease), color var(--dp-dur-1) var(--dp-ease);
}
.dp-h2:hover .dp-anchor, .dp-anchor:focus-visible { opacity: 1; transform: translateX(0); }
.dp-anchor:hover { color: var(--dp-accent); }
@media (hover: none) { .dp-anchor { display: none; } }

/* ————————————————————————————————————————————————————————————
 * 11 · Back to top
 * ———————————————————————————————————————————————————————————— */
.dp-top {
  position: fixed; right: clamp(1rem, 3vw, 2rem); bottom: clamp(1rem, 3vw, 2rem);
  z-index: 250; display: inline-flex; align-items: center; justify-content: center;
  width: 44px; height: 44px; border-radius: 50%;
  border: var(--dp-hair) solid var(--dp-rule);
  background: color-mix(in oklch, var(--dp-bg) 92%, transparent);
  backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
  color: var(--dp-muted); cursor: pointer; box-shadow: var(--dp-shadow-2);
  opacity: 0; visibility: hidden; transform: translateY(10px) scale(0.9);
  transition: opacity var(--dp-dur-2) var(--dp-ease), transform var(--dp-dur-2) var(--dp-ease),
              visibility var(--dp-dur-2), color var(--dp-dur-1) var(--dp-ease), border-color var(--dp-dur-1) var(--dp-ease);
}
.dp-top[data-show="true"] { opacity: 1; visibility: visible; transform: translateY(0) scale(1); }
.dp-top:hover { color: var(--dp-accent); border-color: var(--dp-rule-2); }
.dp-top:hover .dp-i { transform: translateY(-2px); }
.dp-top:active { transform: scale(0.92); }
.dp-top .dp-i { transition: transform var(--dp-dur-2) var(--dp-ease); }

/* ————————————————————————————————————————————————————————————
 * 12 · Colophon
 * ———————————————————————————————————————————————————————————— */
.dp-colophon {
  border-top: var(--dp-hair) solid var(--dp-rule-2);
  margin-top: 2rem;
  padding: clamp(2rem, 4vw, 3rem) var(--page-gutter, clamp(1.15rem, 4vw, 2.5rem)) 4rem;
  background: var(--dp-bg-2);
}
.dp-colophon__in {
  max-width: 84rem; margin-inline: auto;
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; line-height: 1.85; letter-spacing: 0.01em;
  color: var(--dp-secondary);
}
.dp-colophon__in p { max-width: 82ch; margin: 0 0 0.75rem; }
.dp-colophon__in a { color: var(--dp-muted); }
.dp-colophon__in a:hover { color: var(--dp-accent); }

/* ————————————————————————————————————————————————————————————
 * 13 · Motion — entrance reveals, opt-in and reduced-motion safe
 * ———————————————————————————————————————————————————————————— */
[data-dp-motion="on"] .dp-reveal {
  opacity: 0; transform: translateY(10px);
  transition: opacity var(--dp-dur-3) var(--dp-ease), transform var(--dp-dur-3) var(--dp-ease);
  transition-delay: var(--dp-delay, 0ms);
}
[data-dp-motion="on"] .dp-reveal[data-shown="true"] { opacity: 1; transform: none; }

/* The single hard guarantee: no motion when the user asked for none. */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto !important; }
  *, *::before, *::after {
    animation-duration: 0.001ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.001ms !important;
    scroll-behavior: auto !important;
  }
  .dp-reveal { opacity: 1 !important; transform: none !important; }
  .dp-bar__progress { transition: none !important; }
}

/* ————————————————————————————————————————————————————————————
 * 14 · Focus, selection, print
 * ———————————————————————————————————————————————————————————— */
.dp-shell :focus-visible, .dp-bar :focus-visible, .dp-colophon :focus-visible, .dp-top:focus-visible {
  outline: 2px solid var(--dp-focus); outline-offset: 3px; border-radius: var(--dp-radius-sm);
}
.dp-sr {
  position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px;
  overflow: hidden; clip-path: inset(50%); white-space: nowrap; border: 0;
}

@media print {
  .dp-bar, .dp-side, .dp-top, .dp-copy, .dp-skip { display: none !important; }
  .dp-shell { display: block; max-width: none; padding: 0; }
  .dp-code, .dp-tablewrap { break-inside: avoid; box-shadow: none; }
  .dp-reveal { opacity: 1 !important; transform: none !important; }
}

/* ============================================================================
 * 15 · Base + prose
 * Kept in the shared layer on purpose: reading rhythm is the thing that most
 * makes these sites feel like one platform rather than nine one-offs.
 * ========================================================================== */
*, *::before, *::after { box-sizing: border-box; }
html {
  overflow-x: clip; -webkit-text-size-adjust: 100%;
  scroll-behavior: smooth; color-scheme: light dark;
}
body {
  margin: 0; overflow-x: clip;
  background: var(--dp-bg); color: var(--dp-ink);
  font-family: var(--font-body, ui-sans-serif, system-ui, sans-serif);
  font-size: var(--text-base, 1.0625rem);
  line-height: 1.66; font-weight: 400;
  -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale;
  text-rendering: optimizeLegibility;
}
:root[data-theme="dark"] body { font-weight: 350; }
@media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) body { font-weight: 350; } }

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

.dp-main a:not(.dp-anchor):not(.dp-btn),
.dp-colophon a {
  color: inherit;
  text-decoration-color: var(--dp-rule-2);
  text-underline-offset: 0.22em; text-decoration-thickness: 1px;
  transition: text-decoration-color var(--dp-dur-1) var(--dp-ease), color var(--dp-dur-1) var(--dp-ease);
}
.dp-main a:not(.dp-anchor):not(.dp-btn):hover { color: var(--dp-accent); text-decoration-color: var(--dp-accent); }

.dp-main p { margin: 0 0 1rem; text-wrap: pretty; }
.dp-main h3 {
  font-family: var(--font-body, ui-sans-serif, system-ui, sans-serif);
  font-size: 1.0625rem; font-weight: 600; line-height: 1.4;
  letter-spacing: 0.002em; margin: 2.25rem 0 0.5rem; text-wrap: balance;
}
.dp-main h4 {
  font-size: 0.9375rem; font-weight: 600; margin: 1.75rem 0 0.4rem;
  color: var(--dp-ink-2);
}
.dp-main strong { font-weight: 600; color: var(--dp-ink); }
.dp-main ul, .dp-main ol { margin: 0 0 1rem; padding-left: 1.35rem; }
.dp-main li { margin-bottom: 0.35rem; }
.dp-main li::marker { color: var(--dp-neutral); }
.dp-main hr {
  border: 0; border-top: var(--dp-hair) solid var(--dp-rule-2);
  margin: 2.5rem 0 0;
}
.dp-main figure { margin: 0; }
img, svg:not(.dp-i):not(.dp-sprite) { max-width: 100%; height: auto; }

/* Key-value evidence list — the family's shared "what was measured" pattern. */
.dp-kv { display: grid; gap: 0; margin: 1.6rem 0; }
.dp-kv > div {
  display: grid; grid-template-columns: minmax(0, 12rem) minmax(0, 1fr);
  gap: 1rem; padding: 0.7rem 0;
  border-top: var(--dp-hair) solid var(--dp-rule);
}
.dp-kv > div:last-child { border-bottom: var(--dp-hair) solid var(--dp-rule); }
.dp-kv dt { font-size: 0.8125rem; font-weight: 600; color: var(--dp-secondary); letter-spacing: 0.02em; }
.dp-kv dd { margin: 0; }
.dp-kv dd > :last-child { margin-bottom: 0; }
@media (max-width: 34rem) {
  .dp-kv > div { grid-template-columns: minmax(0, 1fr); gap: 0.15rem; }
}

/* Numbered pipeline / stage list — shared across the libraries that have one. */
.dp-flow { display: grid; gap: 0; margin: 1.75rem 0; }
.dp-flow__step {
  display: grid; grid-template-columns: 1.9rem minmax(0, 1fr); gap: 1rem;
  align-items: start; padding: 0.95rem 0;
  border-top: var(--dp-hair) solid var(--dp-rule);
  transition: background-color var(--dp-dur-1) var(--dp-ease);
}
.dp-flow__step:last-child { border-bottom: var(--dp-hair) solid var(--dp-rule); }
.dp-flow__n {
  font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.6875rem; font-variant-numeric: tabular-nums;
  color: var(--dp-secondary); padding-top: 0.42em;
}
.dp-flow__b b { display: block; font-weight: 600; margin-bottom: 0.15rem; }
.dp-flow__b span { color: var(--dp-muted); font-size: 0.9375rem; }
.dp-flow__gate {
  color: var(--dp-accent); font-family: var(--font-mono, ui-monospace, monospace);
  font-size: 0.8125rem;
}