/* DarkStage Manual — one stylesheet for every page.
   Colours mirror the app's handoff palette (Sources/DSColors.swift). */

:root {
  --bg:        #0B0B0B;
  --panel:     #141414;
  --line:      #232323;
  --text:      #E8E8E8;
  --text-2:    #CFCFCF;
  --text-3:    #8D8D8D;
  --muted:     #656565;
  --accent:    #FF8A1F;
  --header:    #FF5C2B;
  --red:       #FF3B21;
  --tip:       #FFD600;
  --mono: ui-monospace, "SF Mono", Menlo, monospace;
  --sans: -apple-system, BlinkMacSystemFont, "SF Pro Text", "Helvetica Neue", sans-serif;
  --side: 250px;
}

:root[data-theme="light"] {
  --bg: #FFFFFF; --panel: #F4F4F4; --line: #E2E2E2;
  --text: #111; --text-2: #2A2A2A; --text-3: #555; --muted: #777;
  --accent: #D96A00; --header: #D9461A; --tip: #8A6D00;
}
@media (prefers-color-scheme: light) {
  :root:not([data-theme="dark"]) {
    --bg: #FFFFFF; --panel: #F4F4F4; --line: #E2E2E2;
    --text: #111; --text-2: #2A2A2A; --text-3: #555; --muted: #777;
    --accent: #D96A00; --header: #D9461A; --tip: #8A6D00;
  }
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; scroll-padding-top: 24px; }
body {
  margin: 0; background: var(--bg); color: var(--text-2);
  font: 16px/1.6 var(--sans); -webkit-font-smoothing: antialiased;
}
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }

/* ── Layout ─────────────────────────────────────────── */
.site { display: grid; grid-template-columns: var(--side) minmax(0, 1fr); min-height: 100vh; }
nav.side {
  position: sticky; top: 0; height: 100vh; overflow-y: auto;
  border-right: 1px solid var(--line); padding: 28px 20px 40px; background: var(--bg);
}
nav.side .brand {
  display: flex; align-items: center; gap: 10px; margin-bottom: 28px;
  font: 500 13px var(--mono); letter-spacing: .18em; color: var(--text);
}
nav.side .brand i {
  width: 18px; height: 14px; border: 2px solid var(--red); border-radius: 2px; display: inline-block;
}
nav.side h4 {
  font: 500 11px var(--mono); letter-spacing: .14em; text-transform: uppercase;
  color: var(--muted); margin: 22px 0 6px;
}
nav.side a {
  display: block; padding: 4px 10px; margin-left: -10px; border-left: 2px solid transparent;
  color: var(--text-3); font-size: 14.5px;
}
nav.side a:hover { color: var(--text); text-decoration: none; }
nav.side a.on { color: var(--text); border-left-color: var(--accent); }
nav.side a.sub { padding-left: 22px; font-size: 13.5px; }

main { max-width: 860px; padding: 48px 56px 120px; }

/* ── Type ───────────────────────────────────────────── */
.eyebrow {
  font: 500 11px var(--mono); letter-spacing: .16em; text-transform: uppercase; color: var(--header);
}
h1 { font-size: 34px; line-height: 1.2; color: var(--text); margin: 6px 0 12px; font-weight: 650; }
.lede { font-size: 18px; color: var(--text-3); margin: 0 0 32px; }
h2 {
  font-size: 22px; color: var(--text); margin: 56px 0 10px; padding-top: 24px;
  border-top: 1px solid var(--line); font-weight: 620;
}
h3 { font-size: 17px; color: var(--text); margin: 28px 0 6px; font-weight: 600; }
p, ul, ol { margin: 0 0 14px; }
li { margin: 3px 0; }
strong { color: var(--text); font-weight: 600; }
kbd, .ui {
  font: 500 12.5px var(--mono); letter-spacing: .04em; color: var(--text);
  background: var(--panel); border: 1px solid var(--line); border-radius: 4px; padding: 1px 6px;
  white-space: nowrap;
}
code { font: 13.5px var(--mono); color: var(--text); }

/* ── Blocks ─────────────────────────────────────────── */
figure { margin: 22px 0 26px; }
figure img {
  display: block; width: 100%; height: auto; border-radius: 8px; border: 1px solid var(--line);
}
figcaption { font-size: 13px; color: var(--muted); margin-top: 8px; }

.tip, .note, .warn {
  border-left: 3px solid var(--tip); background: var(--panel);
  padding: 12px 16px; border-radius: 0 6px 6px 0; margin: 18px 0;
}
.tip::before, .note::before, .warn::before {
  display: block; font: 500 10.5px var(--mono); letter-spacing: .16em; margin-bottom: 4px;
}
.tip::before  { content: "TIP"; color: var(--tip); }
.note { border-left-color: var(--text-3); }
.note::before { content: "NOTE"; color: var(--text-3); }
.warn { border-left-color: var(--red); }
.warn::before { content: "IMPORTANT"; color: var(--red); }
.tip p:last-child, .note p:last-child, .warn p:last-child { margin: 0; }

.usecase { margin: 18px 0; padding: 14px 16px; border: 1px solid var(--line); border-radius: 8px; }
.usecase h4 {
  margin: 0 0 6px; font: 500 11px var(--mono); letter-spacing: .14em; text-transform: uppercase; color: var(--accent);
}
.usecase ul { margin: 0; padding-left: 18px; }

ol.steps { counter-reset: s; list-style: none; padding: 0; }
ol.steps > li { counter-increment: s; position: relative; padding-left: 40px; margin: 12px 0; }
ol.steps > li::before {
  content: counter(s); position: absolute; left: 0; top: 1px; width: 26px; height: 26px;
  border: 1px solid var(--accent); color: var(--accent); border-radius: 50%;
  font: 500 12px/24px var(--mono); text-align: center;
}

table { width: 100%; border-collapse: collapse; margin: 14px 0 22px; font-size: 15px; }
th {
  text-align: left; font: 500 11px var(--mono); letter-spacing: .12em; text-transform: uppercase;
  color: var(--muted); border-bottom: 1px solid var(--line); padding: 8px 10px 8px 0;
}
td { border-bottom: 1px solid var(--line); padding: 9px 10px 9px 0; vertical-align: top; }

.cards { display: grid; grid-template-columns: repeat(auto-fill, minmax(230px, 1fr)); gap: 14px; margin: 20px 0; }
.card {
  display: block; padding: 16px; border: 1px solid var(--line); border-radius: 8px; color: var(--text-2);
}
.card:hover { border-color: var(--accent); text-decoration: none; }
.card b { display: block; color: var(--text); margin-bottom: 4px; }
.card span { font-size: 14px; color: var(--text-3); }

.widgets { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: 18px; margin: 20px 0; }
.widgets figure { margin: 0; }
.widgets figcaption { color: var(--text); font-size: 14px; }
.widgets figcaption span { display: block; color: var(--muted); font-size: 13px; }

.pager { display: flex; justify-content: space-between; margin-top: 64px; padding-top: 20px; border-top: 1px solid var(--line); }
.pager a { font: 500 12px var(--mono); letter-spacing: .1em; text-transform: uppercase; }

/* ── Phone ──────────────────────────────────────────── */
@media (max-width: 820px) {
  .site { display: block; }
  nav.side { position: static; height: auto; border-right: 0; border-bottom: 1px solid var(--line); padding: 16px; }
  nav.side .subs { display: none; }
  main { padding: 28px 16px 80px; }
  h1 { font-size: 28px; }
}

details { border: 1px solid var(--line); border-radius: 8px; padding: 10px 16px; margin: 10px 0; }
details[open] { padding-bottom: 14px; }
summary { cursor: pointer; color: var(--text); font-weight: 600; }
details ol { margin-top: 10px; }

pre.flow {
  font: 12.5px/1.5 var(--mono); color: var(--text-2); background: var(--panel);
  border: 1px solid var(--line); border-radius: 8px; padding: 14px 16px; overflow-x: auto; margin: 16px 0;
}
h4.eyebrow { margin: 22px 0 6px; }