:root {
  --bg: #0f1115;
  --bg-elev: #161922;
  --bg-code: #1a1e2a;
  --border: #262b38;
  --text: #e6e8ee;
  --text-dim: #9aa0ad;
  --text-faint: #6b7280;
  --accent: #ff6b5e;
  --accent-dim: #ff8a7e;
  --link: #7cb7ff;
  --code-pink: #ff79c6;
  --code-green: #50fa7b;
  --code-blue: #8be9fd;
  --code-orange: #ffb86c;
  --code-purple: #bd93f9;
  --code-yellow: #f1fa8c;
  --code-comment: #6272a4;
  --sidebar-w: 280px;
  --content-max: 880px;
}

@media (prefers-color-scheme: light) {
  :root {
    --bg: #fafbfc;
    --bg-elev: #ffffff;
    --bg-code: #f4f6fa;
    --border: #e4e7ec;
    --text: #1a1d23;
    --text-dim: #56606c;
    --text-faint: #8a93a0;
    --accent: #d94535;
    --accent-dim: #e86655;
    --link: #2563eb;
    --code-pink: #d6336c;
    --code-green: #2f9e44;
    --code-blue: #1971c2;
    --code-orange: #e8590c;
    --code-purple: #7048e8;
    --code-yellow: #b58900;
    --code-comment: #8a93a0;
  }
}

* { box-sizing: border-box; }

html, body {
  margin: 0;
  padding: 0;
  background: var(--bg);
  color: var(--text);
  font: 15px/1.65 -apple-system, "SF Pro Text", "Helvetica Neue", Helvetica, Arial, sans-serif;
  -webkit-font-smoothing: antialiased;
  scroll-behavior: smooth;
}

body {
  display: grid;
  grid-template-columns: var(--sidebar-w) 1fr;
  min-height: 100vh;
}

/* Sidebar */
aside {
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
  background: var(--bg-elev);
  border-right: 1px solid var(--border);
  padding: 24px 0;
}

aside .brand {
  padding: 0 24px 20px;
  border-bottom: 1px solid var(--border);
  margin-bottom: 16px;
}
aside .brand h1 {
  font-size: 17px;
  margin: 0 0 4px;
  color: var(--text);
}
aside .brand .tag {
  font-size: 12px;
  color: var(--text-faint);
}

aside nav {
  padding: 0 12px;
}

aside nav .group {
  margin-bottom: 18px;
}

aside nav .group-title {
  font-size: 11px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--text-faint);
  padding: 6px 12px;
  margin-bottom: 4px;
}

aside nav a {
  display: block;
  padding: 6px 12px;
  font-size: 13px;
  color: var(--text-dim);
  text-decoration: none;
  border-radius: 6px;
  border-left: 2px solid transparent;
  transition: color .12s, background .12s;
}
aside nav a:hover {
  color: var(--text);
  background: rgba(255, 107, 94, 0.06);
}
aside nav a.active {
  color: var(--accent);
  border-left-color: var(--accent);
  background: rgba(255, 107, 94, 0.08);
  font-weight: 500;
}

/* Main content */
main {
  padding: 48px 64px 120px;
  max-width: calc(var(--content-max) + 128px);
}

main > section {
  scroll-margin-top: 24px;
}

main h2 {
  font-size: 28px;
  margin: 56px 0 8px;
  padding-top: 24px;
  color: var(--text);
  letter-spacing: -0.01em;
}
main > section:first-child h2 {
  margin-top: 0;
  padding-top: 0;
}
main h2 .anchor {
  color: var(--text-faint);
  font-weight: 400;
  margin-right: 10px;
  font-size: 18px;
}

main h3 {
  font-size: 18px;
  margin: 36px 0 10px;
  color: var(--text);
}
main h4 {
  font-size: 14px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-dim);
  margin: 24px 0 8px;
}

main p { color: var(--text); margin: 0 0 14px; }
main p.lede {
  font-size: 17px;
  color: var(--text-dim);
  margin-bottom: 24px;
  border-left: 3px solid var(--accent);
  padding-left: 16px;
}

main a { color: var(--link); text-decoration: none; border-bottom: 1px solid transparent; }
main a:hover { border-bottom-color: var(--link); }

main ul, main ol { padding-left: 24px; }
main li { margin: 4px 0; }

code {
  font: 13px/1.5 "SF Mono", "JetBrains Mono", "Fira Code", Menlo, Consolas, monospace;
  background: var(--bg-code);
  border: 1px solid var(--border);
  padding: 1px 6px;
  border-radius: 4px;
  font-size: 12.5px;
  color: var(--code-pink);
}

pre {
  background: var(--bg-code);
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 14px 16px;
  overflow-x: auto;
  margin: 14px 0;
}
pre code {
  background: transparent;
  border: 0;
  padding: 0;
  font-size: 13px;
  color: var(--text);
}

/* Inline-token coloring (manual, since we don't pull in a highlighter) */
.tok-key { color: var(--code-purple); }
.tok-str { color: var(--code-green); }
.tok-num { color: var(--code-orange); }
.tok-cls { color: var(--code-yellow); }
.tok-fn  { color: var(--code-blue); }
.tok-com { color: var(--code-comment); font-style: italic; }
.tok-acc { color: var(--accent); }

table {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0;
  font-size: 13.5px;
}
th, td {
  text-align: left;
  padding: 9px 12px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}
th {
  background: var(--bg-elev);
  font-weight: 600;
  color: var(--text-dim);
  font-size: 12px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}
td code { font-size: 12px; }

.callout {
  border-left: 3px solid var(--accent);
  background: rgba(255, 107, 94, 0.06);
  border-radius: 0 6px 6px 0;
  padding: 12px 16px;
  margin: 18px 0;
  font-size: 14px;
}
.callout.warn { border-left-color: #ffb86c; background: rgba(255, 184, 108, 0.08); }
.callout.info { border-left-color: var(--link); background: rgba(124, 183, 255, 0.06); }
.callout strong { display: block; margin-bottom: 4px; font-size: 12px; text-transform: uppercase; letter-spacing: 0.04em; color: var(--text-dim); }

.pill {
  display: inline-block;
  padding: 2px 8px;
  border-radius: 10px;
  background: var(--bg-code);
  border: 1px solid var(--border);
  font-size: 11px;
  color: var(--text-dim);
  margin-right: 4px;
}

hr {
  border: 0;
  border-top: 1px solid var(--border);
  margin: 48px 0;
}

.grid-2 {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
}

/* Diagrams */
.diagram {
  margin: 20px 0 28px;
  padding: 20px;
  background: var(--bg-elev);
  border: 1px solid var(--border);
  border-radius: 10px;
  overflow-x: auto;
}
.diagram .mermaid {
  display: flex;
  justify-content: center;
  min-height: 60px;
}
.diagram .mermaid svg {
  max-width: 100%;
  height: auto;
}
.diagram-caption {
  font-size: 12px;
  color: var(--text-faint);
  text-align: center;
  margin-top: 12px;
  padding-top: 12px;
  border-top: 1px dashed var(--border);
  font-style: italic;
}

footer {
  margin-top: 80px;
  padding-top: 24px;
  border-top: 1px solid var(--border);
  font-size: 12px;
  color: var(--text-faint);
}

/* Responsive */
@media (max-width: 900px) {
  body { grid-template-columns: 1fr; }
  aside { position: static; height: auto; border-right: 0; border-bottom: 1px solid var(--border); }
  aside { max-height: 200px; }
  main { padding: 32px 20px 80px; }
  .grid-2 { grid-template-columns: 1fr; }
}