/* Project docs. One stylesheet for every page in docs/.
   Layout: a sticky page list on the left, one reading column on the right, wide tables scroll inside their own box.
   Palette: cool paper and ink with one teal accent; status colours (ok, warn, bad) are separate from the accent. */

:root {
  --bg: #f5f7f8;
  --surface: #ffffff;
  --surface-2: #eef2f3;
  --fg: #172125;
  --muted: #54656c;
  --line: #d9e1e4;
  --accent: #0a6b6b;
  --accent-ink: #ffffff;
  --accent-soft: #dff0ef;
  --ok: #1d6a39;
  --ok-soft: #e0f1e6;
  --warn: #8a5300;
  --warn-soft: #fbefd6;
  --bad: #a0302f;
  --bad-soft: #f8e3e2;
  --code-bg: #eaeff1;
  --font-body: "Segoe UI", system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif;
  --font-mono: ui-monospace, "Cascadia Code", Consolas, "SFMono-Regular", Menlo, monospace;
}
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --bg: #0e1417;
    --surface: #151d21;
    --surface-2: #1b252a;
    --fg: #e3eaec;
    --muted: #93a4ab;
    --line: #26343a;
    --accent: #5cc6c1;
    --accent-ink: #062322;
    --accent-soft: #12302f;
    --ok: #74c992;
    --ok-soft: #14301f;
    --warn: #e5b765;
    --warn-soft: #2f2610;
    --bad: #f09a98;
    --bad-soft: #391a19;
    --code-bg: #1d282d;
    color-scheme: dark;
  }
}
:root[data-theme="dark"] {
  --bg: #0e1417;
  --surface: #151d21;
  --surface-2: #1b252a;
  --fg: #e3eaec;
  --muted: #93a4ab;
  --line: #26343a;
  --accent: #5cc6c1;
  --accent-ink: #062322;
  --accent-soft: #12302f;
  --ok: #74c992;
  --ok-soft: #14301f;
  --warn: #e5b765;
  --warn-soft: #2f2610;
  --bad: #f09a98;
  --bad-soft: #391a19;
  --code-bg: #1d282d;
  color-scheme: dark;
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }

body {
  margin: 0;
  background: var(--bg);
  color: var(--fg);
  font-family: var(--font-body);
  font-size: 16px;
  line-height: 1.62;
  padding-inline: max(16px, env(safe-area-inset-left, 0px)) max(16px, env(safe-area-inset-right, 0px));
  padding-block: 0 48px;
}

a { color: var(--accent); text-underline-offset: 2px; }
a:hover { text-decoration-thickness: 2px; }
:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 3px; }

.shell {
  max-width: 1180px;
  margin: 0 auto;
  display: grid;
  grid-template-columns: 232px minmax(0, 1fr);
  gap: 40px;
  align-items: start;
}

/* ---- page list ---- */
.side {
  position: sticky;
  top: 0;
  max-height: 100vh;
  overflow-y: auto;
  padding: 24px 0;
  font-size: 14px;
}
.side .brand { font-weight: 700; font-size: 15px; letter-spacing: 0.01em; margin: 0 0 4px; }
.side .brand a { color: var(--fg); text-decoration: none; }
.side .sub { color: var(--muted); font-size: 12.5px; margin: 0 0 14px; }
.side summary { cursor: pointer; font-weight: 600; padding: 4px 0; color: var(--muted); }
.side .grp { margin: 14px 0 4px; font-size: 11.5px; text-transform: uppercase; letter-spacing: 0.09em; color: var(--muted); font-weight: 700; }
.side ul { list-style: none; margin: 0; padding: 0; }
.side li a {
  display: block;
  padding: 5px 10px;
  margin-left: -10px;
  border-radius: 6px;
  color: var(--fg);
  text-decoration: none;
  line-height: 1.35;
}
.side li a:hover { background: var(--surface-2); }
.side li a[aria-current="page"] { background: var(--accent-soft); color: var(--accent); font-weight: 650; }
.side li a .tag { font-size: 10.5px; font-weight: 700; letter-spacing: 0.05em; color: var(--accent); margin-left: 6px; text-transform: uppercase; }

/* ---- reading column ---- */
main { min-width: 0; padding: 32px 0 24px; max-width: 78ch; }
main > * + * { margin-top: 1rem; }
h1 { font-size: clamp(1.7rem, 3.4vw, 2.3rem); line-height: 1.15; margin: 0 0 6px; text-wrap: balance; letter-spacing: -0.01em; }
h2 { font-size: 1.4rem; line-height: 1.25; margin: 2.4rem 0 0.4rem; text-wrap: balance; padding-top: 0.4rem; border-top: 1px solid var(--line); }
h3 { font-size: 1.1rem; line-height: 1.3; margin: 1.7rem 0 0.2rem; text-wrap: balance; }
h4 { font-size: 0.95rem; margin: 1.2rem 0 0; text-transform: uppercase; letter-spacing: 0.06em; color: var(--muted); }
p { margin: 0.7rem 0 0; }
ul, ol { margin: 0.6rem 0 0; padding-left: 1.3rem; }
li + li { margin-top: 0.3rem; }
.lede { color: var(--muted); font-size: 1.05rem; margin-top: 0; }
.meta { color: var(--muted); font-size: 13px; margin: 4px 0 0; }
strong { font-weight: 650; }

code, kbd {
  font-family: var(--font-mono);
  font-size: 0.87em;
  background: var(--code-bg);
  padding: 0.1em 0.35em;
  border-radius: 4px;
  overflow-wrap: anywhere;
}
pre {
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.5;
  background: var(--code-bg);
  border: 1px solid var(--line);
  border-radius: 8px;
  padding: 12px 14px;
  overflow-x: auto;
  margin: 0.9rem 0 0;
  white-space: pre;
}
pre code { background: none; padding: 0; font-size: inherit; overflow-wrap: normal; }

/* ---- TL;DR ---- */
.tldr {
  background: var(--accent-soft);
  border: 1px solid color-mix(in srgb, var(--accent) 35%, var(--line));
  border-radius: 10px;
  padding: 14px 18px 16px;
  margin-top: 18px;
}
.tldr .label {
  display: block;
  font-size: 11.5px;
  font-weight: 800;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--accent);
  margin-bottom: 6px;
}
.tldr p:first-of-type { margin-top: 0; }
.tldr ul { margin-top: 0.4rem; }

/* ---- callouts ---- */
.callout {
  border-left: 4px solid var(--accent);
  background: var(--surface);
  border-radius: 0 8px 8px 0;
  padding: 10px 16px 12px;
  border-top: 1px solid var(--line);
  border-right: 1px solid var(--line);
  border-bottom: 1px solid var(--line);
}
.callout > :first-child { margin-top: 0; }
.callout .t { font-weight: 700; display: block; margin-bottom: 2px; }
.callout.warn { border-left-color: var(--warn); background: var(--warn-soft); }
.callout.warn .t { color: var(--warn); }
.callout.bad { border-left-color: var(--bad); background: var(--bad-soft); }
.callout.bad .t { color: var(--bad); }
.callout.ok { border-left-color: var(--ok); background: var(--ok-soft); }
.callout.ok .t { color: var(--ok); }

/* ---- status pills ---- */
.pill {
  display: inline-block;
  font-size: 11.5px;
  font-weight: 700;
  letter-spacing: 0.03em;
  padding: 1px 8px;
  border-radius: 999px;
  vertical-align: 1px;
  white-space: nowrap;
  background: var(--surface-2);
  color: var(--muted);
  border: 1px solid var(--line);
}
.pill.ok { background: var(--ok-soft); color: var(--ok); border-color: transparent; }
.pill.warn { background: var(--warn-soft); color: var(--warn); border-color: transparent; }
.pill.bad { background: var(--bad-soft); color: var(--bad); border-color: transparent; }
.pill.acc { background: var(--accent-soft); color: var(--accent); border-color: transparent; }

/* ---- tables ---- */
.tw { overflow-x: auto; margin-top: 0.9rem; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); }
table { border-collapse: collapse; width: 100%; font-size: 14px; line-height: 1.45; }
.tw table { margin: 0; }
th, td { text-align: left; padding: 8px 12px; vertical-align: top; border-bottom: 1px solid var(--line); }
th { background: var(--surface-2); font-weight: 650; font-size: 12.5px; text-transform: uppercase; letter-spacing: 0.05em; color: var(--muted); white-space: nowrap; }
tr:last-child td { border-bottom: 0; }
td.num, th.num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
td:first-child { min-width: 6rem; }
.tw table.compact td, .tw table.compact th { padding: 6px 10px; }

/* ---- step flow ---- */
.flow { display: grid; gap: 10px; margin-top: 1rem; counter-reset: none; }
.step {
  display: grid;
  grid-template-columns: 56px minmax(0, 1fr);
  gap: 14px;
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: 10px;
  padding: 12px 16px;
}
.step .id {
  font-family: var(--font-mono);
  font-weight: 700;
  font-size: 15px;
  color: var(--accent);
  padding-top: 1px;
}
.step h3, .step h4 { margin: 0; font-size: 1rem; text-transform: none; letter-spacing: 0; color: var(--fg); }
.step p { margin-top: 0.25rem; font-size: 14.5px; }
.step .io { font-size: 13px; color: var(--muted); margin-top: 0.35rem; }
.step .io b { color: var(--fg); font-weight: 650; }
.step.phase-a .id { color: #0a6b6b; }

/* ---- small grids ---- */
.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(230px, 1fr)); gap: 10px; margin-top: 1rem; }
.card { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; padding: 12px 16px 14px; min-width: 0; }
.card h3 { margin: 0 0 4px; font-size: 1rem; }
.card h3 a { text-decoration: none; }
.card p { font-size: 14px; margin-top: 0.25rem; color: var(--muted); }
.card p.when { color: var(--fg); }

/* ---- footer nav ---- */
.pager { display: flex; gap: 12px; justify-content: space-between; flex-wrap: wrap; margin-top: 3rem; padding-top: 1rem; border-top: 1px solid var(--line); font-size: 14px; }
.pager a { display: block; padding: 10px 14px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); text-decoration: none; min-width: 0; }
.pager a:hover { border-color: var(--accent); }
.pager small { display: block; color: var(--muted); font-size: 12px; }
.foot { color: var(--muted); font-size: 12.5px; margin-top: 1.4rem; }

dl.defs { margin: 0.8rem 0 0; display: grid; grid-template-columns: minmax(8rem, 12rem) minmax(0, 1fr); gap: 6px 16px; font-size: 14.5px; }
dl.defs dt { font-weight: 650; }
dl.defs dd { margin: 0; color: var(--muted); }
dl.defs dd b { color: var(--fg); font-weight: 600; }

/* ---- narrow ---- */
@media (max-width: 900px) {
  .shell { grid-template-columns: minmax(0, 1fr); gap: 0; }
  .side { position: static; max-height: none; padding: 14px 0 0; }
  .side details { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; padding: 6px 14px 10px; }
  main { padding-top: 12px; }
  dl.defs { grid-template-columns: minmax(0, 1fr); }
  dl.defs dd { margin-bottom: 6px; }
  .step { grid-template-columns: minmax(0, 1fr); gap: 2px; }
}
@media (min-width: 901px) {
  .side summary { display: none; }
}