/* ---------------------------------------------------------------------
   Zero to Hero: shared stylesheet
   Plain CSS, no build step. Custom properties drive light/dark theming.
   --------------------------------------------------------------------- */

:root {
  --bg-base: #faf7f2;
  --bg-sunken: #f1ece3;
  --surface-1: #ffffff;
  --surface-2: #f5f0e8;
  --surface-inset: #ece5d8;
  --fg-1: #241f1a;
  --fg-2: #55493e;
  --fg-3: #8a7c6c;
  --border-subtle: #e4dccc;
  --border-default: #d6cab3;
  --border-strong: #b7a789;
  --accent: #c1502e;
  --accent-hover: #a3401f;
  --accent-soft: #f3ddd0;
  --ok: #2f7a4f;
  --ok-soft: #dff0e4;
  --warn: #a3781f;
  --warn-soft: #f6ecd2;
  --danger: #b3352c;
  --danger-soft: #f7ded9;
  --info: #2d5f8a;
  --info-soft: #dde9f3;
  --code-bg: #241f1a;
  --code-fg: #f1ece0;
  --code-accent: #e8a06a;
  --code-string: #b6cf8e;
  --code-comment: #8a7c6c;
  --font-display: "Georgia", "Iowan Old Style", serif;
  --font-body: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
  --font-mono: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
  --radius-sm: 6px;
  --radius-md: 10px;
  --radius-lg: 16px;
  --space-1: 4px;
  --space-2: 8px;
  --space-3: 12px;
  --space-4: 16px;
  --space-6: 24px;
  --space-8: 32px;
  --space-12: 48px;
  --shadow-sm: 0 1px 2px rgba(36, 31, 26, 0.08);
  --shadow-md: 0 6px 20px rgba(36, 31, 26, 0.12);
  --max-w: 860px;
  color-scheme: light;
}

[data-theme="dark"] {
  --bg-base: #16130f;
  --bg-sunken: #100e0b;
  --surface-1: #1f1a14;
  --surface-2: #241f18;
  --surface-inset: #2b241b;
  --fg-1: #f4ede1;
  --fg-2: #cbbda6;
  --fg-3: #93856f;
  --border-subtle: #322a1f;
  --border-default: #3d3325;
  --border-strong: #55462f;
  --accent: #e8865b;
  --accent-hover: #f29c76;
  --accent-soft: #3a2418;
  --ok: #79c896;
  --ok-soft: #1c3226;
  --warn: #dcb45f;
  --warn-soft: #362c15;
  --danger: #e58b81;
  --danger-soft: #3a201c;
  --info: #86b6dc;
  --info-soft: #1c2c3a;
  --code-bg: #0f0d0a;
  --code-fg: #f1ece0;
  color-scheme: dark;
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; scroll-padding-top: 84px; }

body {
  margin: 0;
  background: var(--bg-base);
  color: var(--fg-1);
  font-family: var(--font-body);
  font-size: 17px;
  line-height: 1.65;
  transition: background 0.2s ease, color 0.2s ease;
}

/* ---------- Top bar ---------- */
.topbar {
  position: sticky;
  top: 0;
  z-index: 100;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  padding: var(--space-3) var(--space-6);
  background: color-mix(in srgb, var(--bg-base) 88%, transparent);
  backdrop-filter: blur(8px);
  border-bottom: 1px solid var(--border-subtle);
}

.topbar__brand {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 1.05rem;
  color: var(--fg-1);
  text-decoration: none;
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.topbar__nav {
  display: flex;
  gap: var(--space-4);
  font-size: 0.92rem;
}

.topbar__nav a {
  color: var(--fg-2);
  text-decoration: none;
}
.topbar__nav a:hover { color: var(--accent); }

.theme-toggle {
  border: 1px solid var(--border-default);
  background: var(--surface-1);
  color: var(--fg-1);
  border-radius: var(--radius-md);
  padding: 6px 10px;
  font-size: 0.85rem;
  cursor: pointer;
}
.theme-toggle:hover { border-color: var(--accent); }

/* ---------- Layout ---------- */
.page {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr);
  gap: var(--space-8);
  max-width: 1180px;
  margin: 0 auto;
  padding: var(--space-6);
}

.page--narrow { grid-template-columns: 1fr; max-width: var(--max-w); }

.sidenav {
  position: sticky;
  top: 84px;
  align-self: start;
  max-height: calc(100vh - 100px);
  overflow-y: auto;
  font-size: 0.88rem;
  padding-right: var(--space-2);
}

.sidenav h3 {
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--fg-3);
  margin: var(--space-4) 0 var(--space-2);
}
.sidenav h3:first-child { margin-top: 0; }

.sidenav ol, .sidenav ul { list-style: none; margin: 0 0 var(--space-2); padding: 0; }
.sidenav li { margin: 2px 0; }
.sidenav a {
  display: block;
  padding: 5px 8px;
  border-radius: var(--radius-sm);
  color: var(--fg-2);
  text-decoration: none;
  line-height: 1.35;
}
.sidenav a:hover { background: var(--surface-2); color: var(--fg-1); }
.sidenav a.current { background: var(--accent-soft); color: var(--accent-hover); font-weight: 600; }
.sidenav .chnum { display: inline-block; width: 1.6em; color: var(--fg-3); }

main { min-width: 0; }

/* ---------- Typography ---------- */
h1, h2, h3, h4 { font-family: var(--font-display); color: var(--fg-1); line-height: 1.25; }
h1 { font-size: 2.1rem; margin: 0 0 var(--space-2); }
h2 { font-size: 1.5rem; margin: var(--space-12) 0 var(--space-3); padding-top: var(--space-4); border-top: 1px solid var(--border-subtle); }
section:first-of-type h2:first-child, .no-rule { border-top: none; padding-top: 0; }
h3 { font-size: 1.15rem; margin: var(--space-8) 0 var(--space-2); }
h4 { font-size: 1rem; margin: var(--space-4) 0 var(--space-1); }

p { margin: 0 0 var(--space-4); color: var(--fg-2); }
strong { color: var(--fg-1); }
a { color: var(--accent); }
a:hover { color: var(--accent-hover); }

.kicker {
  display: inline-block;
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--fg-3);
  margin-bottom: var(--space-2);
}

.lede { font-size: 1.15rem; color: var(--fg-2); margin-bottom: var(--space-6); }

.anchor-link {
  opacity: 0;
  margin-left: var(--space-2);
  font-size: 0.8em;
  text-decoration: none;
  color: var(--fg-3);
}
h2:hover .anchor-link, h3:hover .anchor-link { opacity: 1; }

ul, ol { color: var(--fg-2); padding-left: 1.3em; }
li { margin-bottom: var(--space-1); }
li > p { margin-bottom: var(--space-2); }

hr { border: none; border-top: 1px solid var(--border-subtle); margin: var(--space-8) 0; }

/* ---------- Code ---------- */
code {
  font-family: var(--font-mono);
  font-size: 0.86em;
  background: var(--surface-2);
  color: var(--accent-hover);
  padding: 0.1em 0.4em;
  border-radius: 4px;
}

pre {
  background: var(--code-bg);
  color: var(--code-fg);
  border-radius: var(--radius-md);
  padding: var(--space-4);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.86rem;
  line-height: 1.6;
  margin: 0 0 var(--space-4);
  box-shadow: var(--shadow-sm);
}
pre code { background: none; color: inherit; padding: 0; border-radius: 0; }

.code-caption {
  display: block;
  font-size: 0.78rem;
  color: var(--fg-3);
  margin: -12px 0 var(--space-2);
  font-family: var(--font-mono);
}

/* ---------- Callouts ---------- */
.callout {
  border: 1px solid var(--border-subtle);
  border-left: 4px solid var(--fg-3);
  background: var(--surface-1);
  border-radius: var(--radius-md);
  padding: var(--space-3) var(--space-4);
  margin: 0 0 var(--space-4);
}
.callout p:last-child { margin-bottom: 0; }
.callout__label {
  display: flex;
  align-items: center;
  gap: 6px;
  font-weight: 700;
  font-size: 0.82rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  margin-bottom: 4px;
}
.callout--tip { border-left-color: var(--ok); background: var(--ok-soft); }
.callout--tip .callout__label { color: var(--ok); }
.callout--warn { border-left-color: var(--warn); background: var(--warn-soft); }
.callout--warn .callout__label { color: var(--warn); }
.callout--danger { border-left-color: var(--danger); background: var(--danger-soft); }
.callout--danger .callout__label { color: var(--danger); }
.callout--info { border-left-color: var(--info); background: var(--info-soft); }
.callout--info .callout__label { color: var(--info); }
.callout--try { border-left-color: var(--accent); background: var(--accent-soft); }
.callout--try .callout__label { color: var(--accent-hover); }

/* ---------- Term / glossary ---------- */
.term {
  border-bottom: 1px dotted var(--fg-3);
  text-decoration: none;
  color: inherit;
  cursor: help;
}
.term:hover { color: var(--accent); border-bottom-color: var(--accent); }

/* ---------- Cards / grids ---------- */
.grid {
  display: grid;
  gap: var(--space-4);
  margin: var(--space-4) 0 var(--space-6);
}
.grid--2 { grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); }
.grid--3 { grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); }

.card {
  background: var(--surface-1);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  padding: var(--space-4);
  box-shadow: var(--shadow-sm);
}
.card h3, .card h4 { margin-top: 0; }
.card--link { text-decoration: none; display: block; color: inherit; transition: transform 0.15s ease, box-shadow 0.15s ease; }
.card--link:hover { transform: translateY(-2px); box-shadow: var(--shadow-md); border-color: var(--accent); }
.card__num { font-family: var(--font-mono); color: var(--accent); font-size: 0.8rem; }

.badge {
  display: inline-block;
  font-size: 0.72rem;
  font-weight: 600;
  padding: 2px 8px;
  border-radius: 999px;
  background: var(--surface-2);
  color: var(--fg-2);
  border: 1px solid var(--border-default);
}

/* ---------- Prev/next ---------- */
.chapter-nav {
  display: flex;
  justify-content: space-between;
  gap: var(--space-4);
  margin-top: var(--space-12);
  padding-top: var(--space-6);
  border-top: 1px solid var(--border-subtle);
}
.chapter-nav a {
  flex: 1;
  text-decoration: none;
  color: var(--fg-1);
  background: var(--surface-1);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  padding: var(--space-3) var(--space-4);
}
.chapter-nav a:hover { border-color: var(--accent); }
.chapter-nav .dir { display: block; font-size: 0.72rem; color: var(--fg-3); text-transform: uppercase; letter-spacing: 0.06em; }
.chapter-nav .next { text-align: right; }

/* ---------- Table ---------- */
table { width: 100%; border-collapse: collapse; margin: 0 0 var(--space-4); font-size: 0.92rem; }
th, td { text-align: left; padding: 8px 10px; border-bottom: 1px solid var(--border-subtle); color: var(--fg-2); }
th { color: var(--fg-1); font-family: var(--font-display); }

/* ---------- Progress checklist ---------- */
.checklist { list-style: none; padding-left: 0; }
.checklist li { padding-left: 1.6em; position: relative; }
.checklist li::before {
  content: "";
  position: absolute;
  left: 0; top: 4px;
  width: 16px; height: 16px;
  border-radius: 4px;
  border: 2px solid var(--border-strong);
}

/* ---------- Diagram wrapper ---------- */
.diagram {
  background: var(--surface-1);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  padding: var(--space-4);
  margin: 0 0 var(--space-6);
  overflow-x: auto;
}
.diagram svg { max-width: 100%; height: auto; display: block; margin: 0 auto; }
.diagram figcaption { text-align: center; font-size: 0.82rem; color: var(--fg-3); margin-top: var(--space-2); }
svg text { font-family: var(--font-body); }
.svg-mono { font-family: var(--font-mono); }

/* ---------- Footer ---------- */
footer.page-footer {
  max-width: 1180px;
  margin: 0 auto;
  padding: var(--space-8) var(--space-6) var(--space-12);
  color: var(--fg-3);
  font-size: 0.85rem;
}

/* ---------- Glossary index ---------- */
.glossary-jump {
  display: flex;
  flex-wrap: wrap;
  gap: 6px;
  margin: 0 0 var(--space-6);
}
.glossary-jump a {
  text-decoration: none;
  color: var(--fg-2);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-sm);
  padding: 3px 9px;
  font-family: var(--font-mono);
  font-size: 0.82rem;
}
.glossary-jump a:hover { border-color: var(--accent); color: var(--accent); }

dl.glossary dt {
  font-family: var(--font-mono);
  font-weight: 700;
  color: var(--fg-1);
  font-size: 1.02rem;
  margin-top: var(--space-6);
  scroll-margin-top: 90px;
}
dl.glossary dd { margin: var(--space-1) 0 0; color: var(--fg-2); }
dl.glossary dd .see-also { display: block; margin-top: 4px; font-size: 0.85rem; }

/* ---------- Search box (progressive enhancement) ---------- */
.filter-box {
  width: 100%;
  padding: 10px 14px;
  border-radius: var(--radius-md);
  border: 1px solid var(--border-default);
  background: var(--surface-1);
  color: var(--fg-1);
  font-size: 0.95rem;
  margin-bottom: var(--space-4);
}

/* ---------- Responsive ---------- */
@media (max-width: 860px) {
  .page { grid-template-columns: 1fr; }
  .sidenav { position: static; max-height: none; }
  body { font-size: 16px; }
}