/* runtime-narrative docs — design system
   Theme: light/dark via [data-theme] on <html>, falls back to prefers-color-scheme. */

:root {
  --bg: #f5f4f1;
  --bg-soft: #ece9e4;
  --bg-elevated: #fbfaf8;
  --border: #ddd9d1;
  --border-soft: #e6e3dc;
  --text: #26262a;
  --text-soft: #5c5e63;
  --text-faint: #8a8b8f;
  --accent: #6528c0;
  --accent-2: #c2680a;
  --accent-soft: #ece5f9;
  --accent-contrast: #ffffff;
  --code-bg: #0d1117;
  --code-text: #e6edf3;
  --code-border: #21262d;
  --success: #15803d;
  --success-soft: #e7f3ea;
  --danger: #b91c1c;
  --danger-soft: #f8ecec;
  --warning: #9a5b0a;
  --warning-soft: #f6efe2;
  --info: #1d4ed8;
  --info-soft: #e8edfa;
  --shadow: 0 1px 2px rgba(20, 20, 30, 0.04), 0 8px 24px rgba(20, 20, 30, 0.06);
  --radius: 10px;
  --header-h: 60px;
  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Inter", Roboto, Helvetica, Arial, sans-serif;
  --font-mono: "JetBrains Mono", "Fira Code", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

:root[data-theme="dark"] {
  --bg: #0b0d12;
  --bg-soft: #12151c;
  --bg-elevated: #161a23;
  --border: #242933;
  --border-soft: #1c202a;
  --text: #e7e9ee;
  --text-soft: #a2acb9;
  --text-faint: #6b7480;
  --accent: #b19af6;
  --accent-2: #f0ad4e;
  --accent-soft: rgba(177, 154, 246, 0.12);
  --accent-contrast: #0b0d12;
  --code-bg: #0a0d13;
  --code-text: #e6edf3;
  --code-border: #262c38;
  --success: #34d399;
  --success-soft: rgba(52, 211, 153, 0.1);
  --danger: #f87171;
  --danger-soft: rgba(248, 113, 113, 0.1);
  --warning: #fbbf24;
  --warning-soft: rgba(251, 191, 36, 0.1);
  --info: #60a5fa;
  --info-soft: rgba(96, 165, 250, 0.1);
  --shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 24px rgba(0, 0, 0, 0.35);
}

@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --bg: #0b0d12;
    --bg-soft: #12151c;
    --bg-elevated: #161a23;
    --border: #242933;
    --border-soft: #1c202a;
    --text: #e7e9ee;
    --text-soft: #a2acb9;
    --text-faint: #6b7480;
    --accent: #b19af6;
    --accent-2: #f0ad4e;
    --accent-soft: rgba(177, 154, 246, 0.12);
    --accent-contrast: #0b0d12;
    --code-bg: #0a0d13;
    --code-text: #e6edf3;
    --code-border: #262c38;
    --success: #34d399;
    --success-soft: rgba(52, 211, 153, 0.1);
    --danger: #f87171;
    --danger-soft: rgba(248, 113, 113, 0.1);
    --warning: #fbbf24;
    --warning-soft: rgba(251, 191, 36, 0.1);
    --info: #60a5fa;
    --info-soft: rgba(96, 165, 250, 0.1);
    --shadow: 0 1px 2px rgba(0, 0, 0, 0.3), 0 8px 24px rgba(0, 0, 0, 0.35);
  }
}

* { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; scroll-behavior: smooth; }
html, body { height: auto; }
body {
  margin: 0;
  background: var(--bg);
  color: var(--text);
  font-family: var(--font-sans);
  font-size: 16px;
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
  transition: background-color 0.15s ease, color 0.15s ease;
  overflow-x: hidden;
}
img, svg { max-width: 100%; display: block; }
a { color: inherit; text-decoration: none; }
::selection { background: var(--accent-soft); color: var(--accent); }

.visually-hidden {
  position: absolute; width: 1px; height: 1px; overflow: hidden;
  clip: rect(0 0 0 0); white-space: nowrap;
}

/* ---------- Header ---------- */
.topbar {
  position: sticky; top: 0; z-index: 40;
  height: var(--header-h);
  display: flex; align-items: center; gap: 16px;
  padding: 0 20px;
  background: color-mix(in srgb, var(--bg) 88%, transparent);
  backdrop-filter: blur(10px);
  border-bottom: 1px solid var(--border-soft);
}
.topbar-inner {
  width: 100%; max-width: 1440px; margin: 0 auto;
  display: flex; align-items: center; gap: 16px;
}
.brand {
  display: flex; align-items: center; gap: 10px;
  font-weight: 700; font-size: 15.5px; letter-spacing: -0.01em;
  white-space: nowrap;
}
.brand-mark {
  width: 26px; height: 26px; border-radius: 7px;
  background: linear-gradient(155deg, var(--accent), var(--accent-2));
  display: flex; align-items: center; justify-content: center;
  color: #fff; font-size: 13px; flex-shrink: 0;
  box-shadow: 0 2px 8px rgba(109, 40, 217, 0.35);
}
.topbar-nav {
  display: flex; align-items: center; gap: 4px; margin-left: 8px;
}
.topbar-nav a {
  padding: 7px 12px; border-radius: 7px; font-size: 14px;
  color: var(--text-soft); font-weight: 500;
}
.topbar-nav a:hover, .topbar-nav a.active { color: var(--text); background: var(--bg-soft); }
.topbar-spacer { flex: 1; }
.topbar-actions { display: flex; align-items: center; gap: 8px; }
.icon-btn {
  width: 34px; height: 34px; border-radius: 8px;
  display: flex; align-items: center; justify-content: center;
  color: var(--text-soft); background: transparent; border: 1px solid transparent;
  cursor: pointer;
}
.icon-btn:hover { background: var(--bg-soft); color: var(--text); border-color: var(--border-soft); }
.icon-btn svg { width: 17px; height: 17px; }
.menu-btn { display: none; }
.icon-moon { display: block; }
.icon-sun { display: none; }
:root[data-theme="dark"] .icon-moon { display: none; }
:root[data-theme="dark"] .icon-sun { display: block; }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .icon-moon { display: none; }
  :root:not([data-theme="light"]) .icon-sun { display: block; }
}

/* ---------- Layout ---------- */
.layout {
  max-width: 1440px; margin: 0 auto;
  display: grid;
  grid-template-columns: 258px minmax(0, 1fr) 232px;
  align-items: start;
}
.layout.no-toc { grid-template-columns: 258px minmax(0, 1fr); }
.layout.landing { grid-template-columns: minmax(0, 1fr); }

/* ---------- Sidebar ---------- */
.sidebar {
  position: sticky; top: var(--header-h);
  height: calc(100vh - var(--header-h));
  overflow-y: auto;
  padding: 22px 14px 40px;
  border-right: 1px solid var(--border-soft);
  scrollbar-width: thin;
}
.sidebar-search {
  position: relative; margin: 0 6px 18px;
}
.sidebar-search input {
  width: 100%; padding: 8px 12px 8px 30px; border-radius: 8px;
  border: 1px solid var(--border); background: var(--bg-soft); color: var(--text);
  font-size: 13.5px; font-family: var(--font-sans);
}
.sidebar-search input:focus { outline: 2px solid var(--accent-soft); border-color: var(--accent); }
.sidebar-search svg {
  position: absolute; left: 10px; top: 50%; transform: translateY(-50%);
  width: 14px; height: 14px; color: var(--text-faint); pointer-events: none;
}
.nav-group { margin-bottom: 6px; }
.nav-group-title {
  font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.06em;
  color: var(--text-faint); padding: 14px 10px 6px;
}
.nav-link {
  display: block; padding: 7px 10px; margin: 1px 0; border-radius: 7px;
  font-size: 14px; color: var(--text-soft); border-left: 2px solid transparent;
  line-height: 1.35;
}
.nav-link:hover { color: var(--text); background: var(--bg-soft); }
.nav-link.active {
  color: var(--accent); background: var(--accent-soft); font-weight: 600;
  border-left-color: var(--accent);
}
.nav-empty { padding: 10px; font-size: 13px; color: var(--text-faint); }

/* ---------- Content ---------- */
.content { min-width: 0; padding: 0 40px; }
.prose { max-width: 720px; margin: 0 auto; padding: 44px 0 80px; }
.prose.prose-wide { max-width: 880px; }
.landing .content { padding: 0; }

.prose h1 {
  font-size: 2.35rem; line-height: 1.15; letter-spacing: -0.02em;
  margin: 0 0 10px; font-weight: 800;
}
.prose .lede {
  font-size: 1.15rem; color: var(--text-soft); margin: 0 0 34px; line-height: 1.55;
}
.prose h2 {
  font-size: 1.5rem; font-weight: 700; letter-spacing: -0.01em;
  margin: 48px 0 16px; padding-top: 6px; scroll-margin-top: 78px;
  border-top: 1px solid var(--border-soft); padding-top: 22px;
}
.prose h2:first-of-type { border-top: none; padding-top: 0; margin-top: 30px; }
.prose h3 {
  font-size: 1.17rem; font-weight: 700; margin: 30px 0 12px; scroll-margin-top: 78px;
}
.prose h4 {
  font-size: 1rem; font-weight: 700; margin: 22px 0 8px; scroll-margin-top: 78px;
  color: var(--text-soft); text-transform: uppercase; letter-spacing: 0.03em; font-size: 0.8rem;
}
.prose h2 .anchor, .prose h3 .anchor, .prose h4 .anchor {
  opacity: 0; margin-left: 8px; color: var(--text-faint); font-weight: 400;
  font-size: 0.85em; transition: opacity 0.1s;
}
.prose h2:hover .anchor, .prose h3:hover .anchor, .prose h4:hover .anchor { opacity: 1; }
.prose p { margin: 14px 0; color: var(--text); }
.prose p, .prose li { color: var(--text); }
.prose strong { font-weight: 650; }
.prose ul, .prose ol { margin: 14px 0; padding-left: 1.3em; }
.prose li { margin: 6px 0; line-height: 1.65; }
.prose li > ul, .prose li > ol { margin: 6px 0; }
.prose a:not(.nav-link):not(.btn) {
  color: var(--accent); text-underline-offset: 3px; text-decoration: underline;
  text-decoration-color: color-mix(in srgb, var(--accent) 35%, transparent);
}
.prose a:not(.nav-link):not(.btn):hover { text-decoration-color: var(--accent); }
.prose hr { border: none; border-top: 1px solid var(--border-soft); margin: 40px 0; }
.prose blockquote {
  margin: 18px 0; padding: 2px 18px; border-left: 3px solid var(--border);
  color: var(--text-soft);
}

/* inline code */
.prose :not(pre) > code, .prose td code, .prose li code {
  font-family: var(--font-mono); font-size: 0.86em;
  background: var(--bg-soft); border: 1px solid var(--border-soft);
  padding: 0.12em 0.42em; border-radius: 5px; color: var(--text);
}

/* tables */
.table-wrap { overflow-x: auto; margin: 20px 0; border: 1px solid var(--border-soft); border-radius: 10px; }
.prose table { width: 100%; border-collapse: collapse; font-size: 14.5px; min-width: 480px; }
.prose th {
  text-align: left; font-weight: 650; padding: 10px 14px; background: var(--bg-soft);
  border-bottom: 1px solid var(--border); white-space: nowrap; font-size: 13px;
  color: var(--text-soft); text-transform: uppercase; letter-spacing: 0.02em;
}
.prose td {
  padding: 10px 14px; border-bottom: 1px solid var(--border-soft); vertical-align: top;
}
.prose tr:last-child td { border-bottom: none; }

/* code blocks */
.code-block {
  position: relative; margin: 18px 0; border-radius: var(--radius);
  background: var(--code-bg); border: 1px solid var(--code-border);
  overflow: hidden;
}
.code-block-head {
  display: flex; align-items: center; justify-content: space-between;
  padding: 8px 10px 8px 14px; border-bottom: 1px solid var(--code-border);
  font-family: var(--font-mono); font-size: 11.5px; color: #8b95a1;
  text-transform: uppercase; letter-spacing: 0.05em;
}
.code-block pre {
  margin: 0; padding: 16px 18px; overflow-x: auto;
  font-family: var(--font-mono); font-size: 13.4px; line-height: 1.65;
  color: var(--code-text); background: transparent;
}
.code-block:not(.has-head) pre { padding-top: 16px; }
.copy-btn {
  border: 1px solid var(--code-border); background: rgba(255,255,255,0.04);
  color: #9aa4b2; border-radius: 6px; padding: 4px 9px; font-size: 11.5px;
  font-family: var(--font-sans); cursor: pointer; display: flex; align-items: center; gap: 5px;
}
.copy-btn:hover { color: #e6edf3; border-color: #3a4150; }
.copy-btn svg { width: 12px; height: 12px; }
.copy-btn.copied { color: var(--success); border-color: var(--success); }

/* syntax tokens (mini highlighter) */
.tok-kw { color: #ff7b72; }
.tok-str { color: #a5d6ff; }
.tok-com { color: #6b7480; font-style: italic; }
.tok-num { color: #79c0ff; }
.tok-fn { color: #d2a8ff; }
.tok-cls { color: #ffa657; }
.tok-op { color: #ff7b72; }
.tok-deco { color: #f0ad4e; }
.tok-const { color: #79c0ff; }

/* callouts */
.callout {
  display: flex; gap: 12px; margin: 20px 0; padding: 14px 16px;
  border-radius: 10px; border: 1px solid var(--border-soft); font-size: 14.5px;
}
.callout p { margin: 4px 0; }
.callout p:first-child { margin-top: 0; }
.callout p:last-child { margin-bottom: 0; }
.callout-icon { flex-shrink: 0; width: 19px; height: 19px; margin-top: 1px; }
.callout-title { font-weight: 700; margin-bottom: 2px !important; }
.callout-note { background: var(--info-soft); border-color: color-mix(in srgb, var(--info) 25%, var(--border-soft)); }
.callout-note .callout-icon, .callout-note .callout-title { color: var(--info); }
.callout-tip { background: var(--success-soft); border-color: color-mix(in srgb, var(--success) 25%, var(--border-soft)); }
.callout-tip .callout-icon, .callout-tip .callout-title { color: var(--success); }
.callout-warning { background: var(--warning-soft); border-color: color-mix(in srgb, var(--warning) 25%, var(--border-soft)); }
.callout-warning .callout-icon, .callout-warning .callout-title { color: var(--warning); }
.callout-danger { background: var(--danger-soft); border-color: color-mix(in srgb, var(--danger) 25%, var(--border-soft)); }
.callout-danger .callout-icon, .callout-danger .callout-title { color: var(--danger); }

/* badges */
.badge {
  display: inline-flex; align-items: center; gap: 4px;
  font-size: 11.5px; font-weight: 650; padding: 2px 8px; border-radius: 999px;
  background: var(--accent-soft); color: var(--accent); font-family: var(--font-mono);
  vertical-align: middle;
}
.badge-outline { background: transparent; border: 1px solid var(--border); color: var(--text-soft); }

/* cards / grids */
.grid-cards { display: grid; gap: 16px; margin: 22px 0; }
.grid-cards.cols-2 { grid-template-columns: repeat(2, 1fr); }
.grid-cards.cols-3 { grid-template-columns: repeat(3, 1fr); }
.grid-cards.cols-4 { grid-template-columns: repeat(4, 1fr); }
.card {
  padding: 18px 20px; border: 1px solid var(--border-soft); border-radius: 12px;
  background: var(--bg-elevated); transition: border-color 0.15s, transform 0.15s;
}
a.card:hover { border-color: var(--accent); transform: translateY(-1px); }
.card-icon {
  width: 34px; height: 34px; border-radius: 9px; background: var(--accent-soft);
  color: var(--accent); display: flex; align-items: center; justify-content: center;
  margin-bottom: 12px; font-size: 16px;
}
.card h3, .card .card-title { font-size: 15px; margin: 0 0 6px; font-weight: 700; }
.card p { font-size: 13.6px; color: var(--text-soft); margin: 0; line-height: 1.55; }
.card .card-ref { margin-top: 10px; font-size: 12.5px; color: var(--accent); font-weight: 600; }

/* buttons */
.btn {
  display: inline-flex; align-items: center; gap: 8px; font-weight: 650; font-size: 14.5px;
  padding: 10px 18px; border-radius: 9px; border: 1px solid transparent; cursor: pointer;
}
.btn-primary { background: var(--accent); color: #fff; box-shadow: 0 4px 14px rgba(109, 40, 217, 0.3); }
.btn-primary:hover { filter: brightness(1.07); }
.btn-ghost { background: var(--bg-elevated); color: var(--text); border-color: var(--border); }
.btn-ghost:hover { border-color: var(--text-faint); }

/* page prev/next nav */
.page-nav {
  display: grid; grid-template-columns: 1fr 1fr; gap: 14px; margin-top: 56px;
  padding-top: 26px; border-top: 1px solid var(--border-soft);
}
.page-nav-link {
  display: block; padding: 14px 16px; border: 1px solid var(--border-soft); border-radius: 10px;
}
.page-nav-link:hover { border-color: var(--accent); }
.page-nav-link.next { text-align: right; }
.page-nav-dir { font-size: 11.5px; color: var(--text-faint); text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 3px; }
.page-nav-title { font-size: 14.5px; font-weight: 650; color: var(--accent); }

/* on-this-page TOC */
.toc {
  position: sticky; top: var(--header-h); height: calc(100vh - var(--header-h));
  overflow-y: auto; padding: 44px 20px 40px 0; font-size: 13px;
}
.toc-title { font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.06em; color: var(--text-faint); margin-bottom: 10px; }
.toc a {
  display: block; padding: 5px 0 5px 12px; color: var(--text-soft);
  border-left: 2px solid var(--border-soft); line-height: 1.4;
}
.toc a.level-3 { padding-left: 22px; font-size: 12.4px; }
.toc a:hover { color: var(--text); }
.toc a.active { color: var(--accent); border-left-color: var(--accent); font-weight: 600; }

/* mobile nav overlay */
.sidebar-overlay { display: none; }

/* footer */
.site-footer {
  border-top: 1px solid var(--border-soft); padding: 40px 20px 50px; margin-top: 20px;
}
.site-footer-inner {
  max-width: 1100px; margin: 0 auto; display: flex; justify-content: space-between;
  flex-wrap: wrap; gap: 30px;
}
.footer-col h4 { font-size: 12px; text-transform: uppercase; letter-spacing: 0.05em; color: var(--text-faint); margin: 0 0 12px; }
.footer-col a { display: block; font-size: 13.8px; color: var(--text-soft); padding: 4px 0; }
.footer-col a:hover { color: var(--accent); }
.footer-bottom {
  max-width: 1100px; margin: 30px auto 0; padding-top: 20px; border-top: 1px solid var(--border-soft);
  font-size: 13px; color: var(--text-faint); display: flex; justify-content: space-between; flex-wrap: wrap; gap: 10px;
}

/* ---------- Terminal replay component ---------- */
.terminal {
  border-radius: 14px; overflow: hidden; background: var(--code-bg);
  border: 1px solid var(--code-border); box-shadow: var(--shadow); margin: 22px 0;
}
.terminal-head {
  display: flex; align-items: center; gap: 10px; padding: 11px 16px;
  border-bottom: 1px solid var(--code-border);
}
.terminal-head .dots { display: flex; gap: 7px; }
.terminal-head .dots span { width: 11px; height: 11px; border-radius: 50%; background: #3a4150; }
.terminal-label {
  font-family: var(--font-mono); font-size: 12px; color: #8b95a1; flex: 1;
  white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
}
.terminal-replay-btn {
  border: 1px solid var(--code-border); background: rgba(255,255,255,0.04);
  color: #9aa4b2; border-radius: 6px; padding: 4px 10px; font-size: 11.5px;
  font-family: var(--font-sans); cursor: pointer; display: flex; align-items: center; gap: 5px;
  flex-shrink: 0;
}
.terminal-replay-btn:hover { color: #e6edf3; border-color: #3a4150; }
.terminal-replay-btn svg { width: 12px; height: 12px; }
.terminal-body {
  margin: 0; padding: 18px 20px 22px; overflow-x: auto;
  font-family: var(--font-mono); font-size: 13px; line-height: 1.7; color: var(--code-text);
  max-height: 480px; overflow-y: auto;
}
.terminal-body.compact { font-size: 12.4px; line-height: 1.6; }
.term-line {
  white-space: pre; opacity: 0; transform: translateY(3px);
  animation: term-in 0.32s ease forwards;
  animation-play-state: paused;
}
.terminal.play .term-line { animation-play-state: running; }
@keyframes term-in { to { opacity: 1; transform: none; } }
.term-line.gap-before { margin-top: 10px; }
.t-ok { color: #34d399; } .t-fail { color: #f87171; } .t-warn { color: #f0ad4e; }
.t-dim { color: #6b7480; } .t-hd { color: #f0ad4e; font-weight: 600; } .t-id { color: #7dd3fc; }
.t-info { color: #60a5fa; }
.terminal-caption {
  font-size: 12.5px; color: var(--text-faint); margin: 10px 2px 0; font-family: var(--font-mono);
}

/* side-by-side before/after */
.compare-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 18px; margin: 22px 0; align-items: start; }
.compare-grid .terminal { margin: 0; }
.compare-label {
  font-size: 12px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.05em;
  margin-bottom: 8px; display: flex; align-items: center; gap: 7px;
}
.compare-label.bad { color: var(--danger); }
.compare-label.good { color: var(--success); }
.compare-label .dot { width: 7px; height: 7px; border-radius: 50%; background: currentColor; }
@media (max-width: 900px) {
  .compare-grid { grid-template-columns: 1fr; }
}

/* responsive */
@media (max-width: 1180px) {
  .layout { grid-template-columns: 240px minmax(0, 1fr); }
  .toc { display: none; }
}
@media (max-width: 800px) {
  .menu-btn { display: flex; }
  .layout { grid-template-columns: 1fr; }
  .content { padding: 0 20px; }
  .sidebar {
    position: fixed; top: var(--header-h); left: 0; bottom: 0; width: 84vw; max-width: 320px;
    background: var(--bg); z-index: 50; transform: translateX(-100%);
    transition: transform 0.2s ease; box-shadow: var(--shadow);
    border-right: 1px solid var(--border);
  }
  body.nav-open .sidebar { transform: translateX(0); }
  body.nav-open .sidebar-overlay {
    display: block; position: fixed; inset: var(--header-h) 0 0 0; z-index: 45;
    background: rgba(0,0,0,0.35);
  }
  .topbar-nav { display: none; }
  .prose h1 { font-size: 1.85rem; }
  .grid-cards.cols-2, .grid-cards.cols-3, .grid-cards.cols-4 { grid-template-columns: 1fr; }
  .page-nav { grid-template-columns: 1fr; }
}