/* Zoroval documentation, Ledger design system.
   Same tokens as index.html and the product UI: one cobalt accent, semantic
   colour reserved for state, IBM Plex for text and machine facts, flat
   surfaces, two radii. Self-hosted fonts, zero external requests. */

@font-face{font-family:'IBM Plex Sans';font-style:normal;font-weight:400;font-display:swap;src:url(/fonts/plex-sans-400.woff2) format('woff2');}
@font-face{font-family:'IBM Plex Sans';font-style:normal;font-weight:500;font-display:swap;src:url(/fonts/plex-sans-500.woff2) format('woff2');}
@font-face{font-family:'IBM Plex Sans';font-style:normal;font-weight:600;font-display:swap;src:url(/fonts/plex-sans-600.woff2) format('woff2');}
@font-face{font-family:'IBM Plex Mono';font-style:normal;font-weight:400;font-display:swap;src:url(/fonts/plex-mono-400.woff2) format('woff2');}
@font-face{font-family:'IBM Plex Mono';font-style:normal;font-weight:500;font-display:swap;src:url(/fonts/plex-mono-500.woff2) format('woff2');}

:root {
  --bg: #f4f5f7;
  --surface: #ffffff;
  --surface-2: #f0f2f4;
  --line: #e3e6ea;
  --line-strong: #ccd2da;
  --ink: #1c2128;
  --ink-2: #4d5763;
  --muted: #8a93a0;
  --accent: #29579e;
  --accent-tint: #eaf0f8;
  --accent-line: #b9cbe4;
  --good: #196b3e;
  --good-tint: #e4f1e9;
  --good-line: #bcd8c7;
  --bad: #b42318;
  --bad-tint: #f9e9e7;
  --bad-line: #e6c4c0;
  --warn: #8a5a00;
  --warn-tint: #fbf1de;
  --warn-line: #e8d6ac;
  --radius: 8px;
  --radius-s: 5px;
  --sans: "IBM Plex Sans", -apple-system, "Segoe UI", sans-serif;
  --mono: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
  --header-h: 60px;
}

* { box-sizing: border-box; margin: 0; padding: 0; }
html { -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }
body {
  font-family: var(--sans);
  background: var(--bg);
  color: var(--ink);
  line-height: 1.65;
  font-size: 16px;
  -webkit-font-smoothing: antialiased;
}
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } * { transition: none !important; } }

a { color: var(--accent); }
:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 2px; }
.eyebrow { font: 500 11px/1.4 var(--mono); letter-spacing: .1em; text-transform: uppercase; color: var(--muted); }
.skip {
  position: absolute; left: -9999px; top: 0; z-index: 60;
  background: var(--surface); border: 1px solid var(--accent-line);
  padding: 10px 16px; border-radius: var(--radius-s); font-size: 14px;
}
.skip:focus { left: 12px; top: 12px; }

/* ── top bar, identical geometry to the landing page ── */
header.site {
  background: var(--surface); border-bottom: 1px solid var(--line);
  position: sticky; top: 0; z-index: 30;
}
header.site .bar {
  max-width: 1440px; margin: 0 auto; padding: 0 28px;
  display: flex; align-items: center; justify-content: space-between; height: var(--header-h); gap: 20px;
}
.brand { display: flex; align-items: center; gap: 10px; color: var(--ink); text-decoration: none; font-weight: 600; font-size: 16px; flex: none; }
.brand svg { display: block; border-radius: 7px; }
.brand .tag {
  font: 500 11px var(--mono); letter-spacing: .1em; text-transform: uppercase;
  color: var(--accent); border-left: 1px solid var(--line-strong); padding-left: 10px; margin-left: 2px;
}
.nav-links { display: flex; align-items: center; gap: 24px; flex: none; }
.nav-links a { color: var(--ink-2); text-decoration: none; font-size: 14px; }
.nav-links a:hover { color: var(--ink); }
.nav-cta { background: var(--accent); color: #fff !important; padding: 8px 15px; border-radius: var(--radius-s); font-weight: 500; white-space: nowrap; }
.nav-cta:hover { background: #1f477f; }

.menu-btn {
  display: none; align-items: center; gap: 8px; font: 500 13px var(--sans);
  background: var(--surface); color: var(--ink-2);
  border: 1px solid var(--line-strong); border-radius: var(--radius-s);
  padding: 7px 12px; cursor: pointer; white-space: nowrap; flex: none;
}
.menu-btn:hover { color: var(--ink); border-color: var(--muted); }

/* ── three column shell ── */
.shell {
  max-width: 1440px; margin: 0 auto; padding: 0 28px;
  display: grid; grid-template-columns: 236px minmax(0, 1fr) 210px; gap: 44px;
  align-items: start;
}

/* ── left rail ── */
.rail {
  position: sticky; top: var(--header-h);
  max-height: calc(100vh - var(--header-h)); overflow-y: auto;
  padding: 30px 0 60px; font-size: 14px;
}
.rail-group + .rail-group { margin-top: 24px; }
.rail-group > p {
  font: 500 11px/1.4 var(--mono); letter-spacing: .1em; text-transform: uppercase;
  color: var(--muted); padding: 0 10px 8px;
}
.rail a {
  display: block; padding: 6px 10px; border-radius: var(--radius-s);
  color: var(--ink-2); text-decoration: none; line-height: 1.4;
}
.rail a:hover { background: var(--surface-2); color: var(--ink); }
.rail a[aria-current="page"] { background: var(--accent-tint); color: var(--accent); font-weight: 500; }

/* ── article ── */
main.doc { padding: 34px 0 72px; min-width: 0; }
.crumb { font: 400 12px var(--mono); color: var(--muted); margin-bottom: 12px; }
.doc h1 {
  font-size: clamp(28px, 3.4vw, 36px); font-weight: 600; line-height: 1.16;
  letter-spacing: -.02em; text-wrap: balance;
}
.doc .lead { margin-top: 14px; font-size: 18px; color: var(--ink-2); max-width: 68ch; }
.doc h2 {
  margin: 46px 0 16px; padding-top: 26px; border-top: 1px solid var(--line);
  font-size: 22px; font-weight: 600; letter-spacing: -.015em; scroll-margin-top: calc(var(--header-h) + 16px);
}
.doc h3 {
  margin: 30px 0 10px; font-size: 16.5px; font-weight: 600;
  scroll-margin-top: calc(var(--header-h) + 16px);
}
.doc p, .doc ul, .doc ol { max-width: 74ch; }
.doc p { margin-top: 14px; color: var(--ink-2); }
.doc p strong, .doc li strong,
.doc p b, .doc li b, .doc dd b { color: var(--ink); font-weight: 600; }
.doc ul, .doc ol { margin-top: 14px; padding-left: 22px; color: var(--ink-2); }
.doc li { margin-top: 7px; }
.doc li::marker { color: var(--muted); }
.doc a { text-decoration-thickness: 1px; text-underline-offset: 3px; }

code {
  font: 400 13.5px var(--mono); background: var(--surface-2);
  border: 1px solid var(--line); border-radius: 4px; padding: 1px 5px; color: var(--ink);
}
pre {
  margin-top: 16px; max-width: 74ch; overflow-x: auto;
  background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius);
  padding: 14px 16px;
}
pre code { background: none; border: 0; padding: 0; font-size: 13px; line-height: 1.7; color: var(--ink-2); }

/* callouts */
.note, .warn, .tip {
  margin-top: 20px; max-width: 74ch; padding: 13px 16px;
  border: 1px solid var(--accent-line); border-left-width: 3px;
  border-radius: var(--radius-s); background: var(--accent-tint); font-size: 14.5px; color: var(--ink-2);
}
.warn { border-color: var(--bad-line); background: var(--bad-tint); }
.tip { border-color: var(--good-line); background: var(--good-tint); }
.note > b, .warn > b, .tip > b {
  display: block; font: 500 11px/1.4 var(--mono); letter-spacing: .1em;
  text-transform: uppercase; margin-bottom: 5px; color: var(--accent);
}
.warn > b { color: var(--bad); }
.tip > b { color: var(--good); }
.note p, .warn p, .tip p { color: inherit; margin-top: 8px; }
.note :first-child, .warn :first-child, .tip :first-child { margin-top: 0; }

/* tables */
.table-scroll { margin-top: 18px; overflow-x: auto; max-width: 100%; }
table { width: 100%; border-collapse: collapse; font-size: 14px; min-width: 460px; }
th {
  text-align: left; padding: 8px 12px; border-bottom: 1px solid var(--line-strong);
  font: 500 11px var(--mono); letter-spacing: .06em; text-transform: uppercase; color: var(--muted); white-space: nowrap;
}
td { padding: 10px 12px; border-bottom: 1px solid var(--line); color: var(--ink-2); vertical-align: top; }
td:first-child { color: var(--ink); font-weight: 500; }
tbody tr:last-child td { border-bottom: 0; }

/* panel, used for diagrams and worked examples */
.panel {
  margin-top: 20px; background: var(--surface); border: 1px solid var(--line);
  border-radius: var(--radius); padding: 18px 20px; max-width: 74ch;
}
.panel > .cap { font: 400 12px var(--mono); color: var(--muted); margin-top: 12px; }
.panel svg { display: block; width: 100%; height: auto; }
.panel.wide { max-width: none; }

/* evidence sample, mirrors the product's anchored highlight */
.evidence {
  margin-top: 18px; max-width: 74ch; border: 1px solid var(--line); border-radius: var(--radius);
  background: var(--surface); overflow: hidden;
}
.evidence header {
  display: flex; align-items: center; gap: 10px; flex-wrap: wrap;
  padding: 9px 14px; border-bottom: 1px solid var(--line); background: var(--surface-2);
  font: 400 11.5px var(--mono); color: var(--muted);
}
/* Marks a worked example as invented, so no reader mistakes it for real data. */
.evidence header .ex, .sample-tag {
  font: 500 10.5px var(--mono); letter-spacing: .08em; text-transform: uppercase;
  color: var(--accent); background: var(--accent-tint); border: 1px solid var(--accent-line);
  border-radius: 4px; padding: 1px 7px;
}
.evidence .body { padding: 13px 15px; font-size: 14px; color: var(--ink-2); }
.evidence mark { background: #fdf0c9; border-bottom: 2px solid #e3b93c; color: var(--ink); padding: 1px 0; }
.evidence footer {
  padding: 10px 15px; border-top: 1px solid var(--line);
  font-size: 13.5px; color: var(--ink-2); background: var(--surface);
}
.evidence footer b { font-weight: 600; color: var(--ink); }

/* numbered sequence */
.flow { list-style: none; margin-top: 20px; padding: 0; counter-reset: flow; max-width: 74ch; }
.flow li {
  counter-increment: flow; position: relative; padding-left: 42px; margin-top: 18px;
}
.flow li::before {
  content: counter(flow, decimal-leading-zero);
  position: absolute; left: 0; top: 2px;
  font: 500 11px var(--mono); letter-spacing: .06em; color: var(--accent);
  border: 1px solid var(--accent-line); background: var(--accent-tint);
  border-radius: var(--radius-s); padding: 2px 6px;
}
.flow li b { display: block; color: var(--ink); font-weight: 600; font-size: 15.5px; }
.flow li span { display: block; margin-top: 3px; }

/* key/value reference list, used by the glossary */
.kv { margin-top: 22px; max-width: 74ch; }
.kv > div { padding: 14px 0; border-top: 1px solid var(--line); }
.kv > div:first-child { border-top: 0; padding-top: 4px; }
.kv dt { font-size: 15px; font-weight: 600; color: var(--ink); }
.kv dt span {
  display: inline-block; margin-left: 10px; vertical-align: 2px;
  padding: 1px 7px; border: 1px solid var(--line); background: var(--surface-2);
  border-radius: 4px; font: 400 11px var(--mono); color: var(--muted); font-weight: 400;
}
.kv dd { margin-top: 5px; color: var(--ink-2); font-size: 15px; }

/* card grid, used on the docs home */
.cards { display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 14px; margin-top: 22px; }
.cards a {
  display: block; text-decoration: none; background: var(--surface);
  border: 1px solid var(--line); border-radius: var(--radius); padding: 16px 18px;
}
.cards a:hover { border-color: var(--accent-line); background: var(--accent-tint); }
.cards b { display: block; color: var(--ink); font-size: 15.5px; font-weight: 600; }
.cards span { display: block; margin-top: 5px; color: var(--ink-2); font-size: 14px; line-height: 1.55; }

/* pager */
.pager { display: grid; grid-template-columns: repeat(2, minmax(0,1fr)); gap: 14px; margin-top: 56px; padding-top: 26px; border-top: 1px solid var(--line); }
.pager a {
  display: block; text-decoration: none; background: var(--surface);
  border: 1px solid var(--line); border-radius: var(--radius); padding: 13px 16px;
}
.pager a:hover { border-color: var(--accent-line); }
.pager span { display: block; font: 500 11px var(--mono); letter-spacing: .1em; text-transform: uppercase; color: var(--muted); }
.pager b { display: block; margin-top: 4px; color: var(--ink); font-size: 15px; font-weight: 600; }
.pager .next { text-align: right; grid-column: 2; }

/* ── right rail, on this page ── */
.toc { position: sticky; top: var(--header-h); padding: 40px 0 60px; font-size: 13.5px; }
.toc > p { font: 500 11px/1.4 var(--mono); letter-spacing: .1em; text-transform: uppercase; color: var(--muted); padding-bottom: 10px; }
.toc a {
  display: block; padding: 5px 0 5px 12px; border-left: 2px solid var(--line);
  color: var(--muted); text-decoration: none; line-height: 1.45;
}
.toc a:hover { color: var(--ink-2); }
.toc a.on { border-left-color: var(--accent); color: var(--accent); }
.toc a.sub { padding-left: 24px; font-size: 13px; }

footer.site { border-top: 1px solid var(--line); background: var(--surface); padding: 24px 0 32px; }
footer.site .foot {
  max-width: 1440px; margin: 0 auto; padding: 0 28px;
  display: flex; align-items: center; justify-content: space-between;
  flex-wrap: wrap; gap: 12px; color: var(--muted); font-size: 13.5px;
}
.foot-links { display: flex; gap: 20px; flex-wrap: wrap; }
.foot-links a { font-family: var(--mono); font-size: 13px; text-decoration: none; }
.foot-links a:hover { text-decoration: underline; }

/* ── responsive ── */
@media (max-width: 1180px) {
  .shell { grid-template-columns: 220px minmax(0, 1fr); gap: 36px; }
  .toc { display: none; }
}
@media (max-width: 860px) {
  .shell { grid-template-columns: minmax(0, 1fr); gap: 0; padding: 0 22px; }
  header.site .bar { padding: 0 22px; gap: 12px; }
  .menu-btn { display: inline-flex; }
  .nav-links a:not(.nav-cta) { display: none; }
  .rail {
    position: static; max-height: none; overflow: visible;
    padding: 18px 0; border-bottom: 1px solid var(--line);
  }
  .rail[hidden] { display: none; }
  main.doc { padding-top: 26px; }
  .cards, .pager { grid-template-columns: minmax(0,1fr); }
  .pager .next { text-align: left; grid-column: 1; }
}

/* ── stage rail, the end to end loop on the overview page ── */
.stages { position: relative; margin-top: 24px; max-width: 74ch; }
.stages::before { content: ""; position: absolute; left: 15px; top: 12px; bottom: 16px; width: 1px; background: var(--line-strong); }
.stage { position: relative; padding: 0 0 22px 46px; }
.stage:last-child { padding-bottom: 0; }
.stage .dot {
  position: absolute; left: 8px; top: 4px; width: 16px; height: 16px; border-radius: 50%;
  background: var(--surface); border: 2px solid var(--accent-line);
}
.stage .dot.auto { border-color: var(--good-line); }
.stage h4 { font-size: 15.5px; font-weight: 600; display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap; }
.stage .by {
  font: 500 10.5px var(--mono); letter-spacing: .08em; text-transform: uppercase;
  border: 1px solid var(--line); background: var(--surface-2); color: var(--muted);
  padding: 1px 6px; border-radius: 4px; white-space: nowrap;
}
.stage p { margin-top: 4px; font-size: 14.5px; max-width: 66ch; }

@media (max-width: 540px) {
  header.site .bar { padding: 0 16px; gap: 8px; }
  .brand { font-size: 15px; gap: 8px; }
  .brand .tag { display: none; }
  .brand svg { width: 24px; height: 24px; }
  .menu-btn { padding: 6px 10px; font-size: 12.5px; }
  .nav-cta { padding: 7px 12px; font-size: 14px; }
  .shell { padding: 0 16px; }
  footer.site .foot { padding: 0 16px; }
}