/* agent-ready — technical docs design system. Dual-theme, architect-grade. */
:root {
  --bg:      #0d1117;
  --panel:   #131922;
  --panel-2: #0f141b;
  --text:    #c9d1d9;
  --strong:  #f0f3f6;
  --dim:     #8b949e;
  --faint:   #5b636d;
  --line:    #222b36;
  --line-2:  #2d3743;
  --accent:  #6cb6ff;
  --accent-2:#56d4c0;
  --warn:    #e3b341;
  --bad:     #f0776a;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
  --mono: ui-monospace, "SF Mono", "JetBrains Mono", Menlo, Consolas, monospace;
  --measure: 46rem;
}
@media (prefers-color-scheme: light) {
  :root {
    --bg:#f6f8fa; --panel:#ffffff; --panel-2:#f2f4f7;
    --text:#1f2328; --strong:#0b0d10; --dim:#57606a; --faint:#8a929c;
    --line:#d8dee4; --line-2:#c4ccd4; --accent:#0969da; --accent-2:#0a7d6f;
    --warn:#9a6700; --bad:#cf222e;
  }
}
:root[data-theme="dark"]{--bg:#0d1117;--panel:#131922;--panel-2:#0f141b;--text:#c9d1d9;--strong:#f0f3f6;--dim:#8b949e;--faint:#5b636d;--line:#222b36;--line-2:#2d3743;--accent:#6cb6ff;--accent-2:#56d4c0;--warn:#e3b341;--bad:#f0776a;}
:root[data-theme="light"]{--bg:#f6f8fa;--panel:#fff;--panel-2:#f2f4f7;--text:#1f2328;--strong:#0b0d10;--dim:#57606a;--faint:#8a929c;--line:#d8dee4;--line-2:#c4ccd4;--accent:#0969da;--accent-2:#0a7d6f;--warn:#9a6700;--bad:#cf222e;}

* { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }
body {
  margin: 0; background: var(--bg); color: var(--text);
  font-family: var(--sans); font-size: 16px; line-height: 1.65;
  -webkit-font-smoothing: antialiased;
}
.wrap { max-width: 68rem; margin-inline: auto; padding: 0 clamp(1.1rem, 4vw, 3rem); }

/* top bar */
.bar { border-bottom: 1px solid var(--line); background: color-mix(in oklab, var(--bg) 88%, transparent); position: sticky; top: 0; z-index: 10; backdrop-filter: blur(8px); }
.bar .wrap { display: flex; align-items: center; gap: 1.2rem; height: 52px; }
.bar a { color: var(--dim); text-decoration: none; font: 500 .82rem/1 var(--mono); letter-spacing: .02em; }
.bar a:hover { color: var(--text); }
.bar .brand { color: var(--strong); font-weight: 700; }
.bar .brand b { color: var(--accent); }
.bar .spring { flex: 1; }
.theme-btn { cursor: pointer; background: transparent; border: 1px solid var(--line-2); color: var(--dim); border-radius: 6px; padding: .3rem .55rem; font: 500 .7rem/1 var(--mono); }
.theme-btn:hover { color: var(--text); border-color: var(--accent); }

/* hero */
header.doc { padding: clamp(3rem, 8vw, 5.5rem) 0 clamp(1.6rem,4vw,2.6rem); border-bottom: 1px solid var(--line); }
.eyebrow { font: 600 .72rem/1 var(--mono); letter-spacing: .22em; text-transform: uppercase; color: var(--accent); }
h1 { font-size: clamp(2.1rem, 4.5vw, 3.2rem); line-height: 1.05; letter-spacing: -.02em; margin: 1rem 0 0; color: var(--strong); font-weight: 800; }
.standfirst { max-width: var(--measure); margin: 1.1rem 0 0; font-size: clamp(1.05rem,.6vw+.95rem,1.25rem); color: var(--dim); }
.meta { margin-top: 1.4rem; font: 500 .74rem/1.6 var(--mono); color: var(--faint); letter-spacing: .02em; }

main { padding: clamp(1.5rem,4vw,2.5rem) 0 4rem; }
section { padding: clamp(1.4rem,3vw,2.2rem) 0; border-top: 1px solid var(--line); }
section:first-of-type { border-top: none; }
.snum { font: 600 .74rem/1 var(--mono); color: var(--accent); letter-spacing: .1em; }
h2 { font-size: clamp(1.4rem,2.4vw,1.85rem); line-height: 1.15; letter-spacing: -.01em; margin: .5rem 0 .9rem; color: var(--strong); font-weight: 700; }
h3 { font-size: 1.1rem; margin: 1.6rem 0 .5rem; color: var(--strong); font-weight: 600; }
p, li { max-width: var(--measure); }
p { margin: 0 0 1rem; }
a { color: var(--accent); text-underline-offset: 2px; }
strong, b { color: var(--strong); }
code { font-family: var(--mono); font-size: .88em; background: var(--panel-2); border: 1px solid var(--line); border-radius: 4px; padding: .08em .35em; color: var(--text); }
.term { color: var(--accent-2); font-family: var(--mono); font-size: .9em; }

ul.tight { padding-left: 1.1rem; margin: 0 0 1rem; }
ul.tight li { margin: .35rem 0; }
ul.tight li::marker { color: var(--accent); }

/* principle callout */
.law { border-left: 3px solid var(--accent); background: var(--panel-2); border-radius: 0 6px 6px 0; padding: .9rem 1.1rem; margin: 1.2rem 0; }
.law .k { font: 600 .68rem/1 var(--mono); letter-spacing: .16em; text-transform: uppercase; color: var(--accent); }
.law p { margin: .4rem 0 0; color: var(--text); }
.law.warn { border-left-color: var(--warn); } .law.warn .k { color: var(--warn); }

/* figure */
figure { margin: 1.6rem 0; border: 1px solid var(--line); border-radius: 8px; background: var(--panel); overflow: hidden; }
figure svg { display: block; width: 100%; height: auto; background: var(--panel-2); }
figcaption { font: 500 .78rem/1.5 var(--mono); color: var(--dim); padding: .7rem 1rem; border-top: 1px solid var(--line); }
figcaption b { color: var(--text); }
.svg-fg { fill: var(--text); } .svg-dim { fill: var(--dim); } .svg-acc { fill: var(--accent); stroke: var(--accent); }
.svg-lbl { font: 500 12px var(--mono); fill: var(--dim); } .svg-lbl.on { fill: var(--strong); }
.svg-node { fill: var(--panel); stroke: var(--line-2); }
.svg-edge { stroke: var(--line-2); fill: none; } .svg-edge.acc { stroke: var(--accent); } .svg-edge.bad { stroke: var(--bad); }

/* comparison table */
.tbl { width: 100%; border-collapse: collapse; margin: 1.2rem 0; font-size: .93rem; overflow-x: auto; display: block; }
.tbl thead th { text-align: left; font: 600 .68rem/1 var(--mono); letter-spacing: .1em; text-transform: uppercase; color: var(--dim); padding: .5rem .8rem; border-bottom: 1px solid var(--line-2); }
.tbl td { padding: .6rem .8rem; border-bottom: 1px solid var(--line); vertical-align: top; }
.tbl td:first-child { color: var(--strong); font-weight: 600; white-space: nowrap; }

/* footer */
footer { border-top: 1px solid var(--line); padding: 2rem 0 3rem; font: 500 .78rem/1.7 var(--mono); color: var(--faint); }
footer a { color: var(--dim); }

@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }