/* ============================================================
   Front-End Engineering — shared design system
   Linked from every HTML page. Uses OKLCH color (modern CSS).
   ============================================================ */

:root {
  /* Palette — OKLCH for perceptual uniformity */
  --bg:            oklch(15% 0.01 260);
  --surface:       oklch(20% 0.012 260);
  --surface-2:     oklch(24% 0.015 260);
  --border:        oklch(30% 0.015 260);
  --border-bright: oklch(40% 0.02 260);
  --text:          oklch(96% 0.005 260);
  --text-muted:    oklch(70% 0.015 260);
  --text-dim:      oklch(55% 0.02 260);
  --accent:        oklch(78% 0.17 165);          /* teal-green */
  --accent-2:      oklch(75% 0.17 50);           /* warm orange */
  --accent-3:      oklch(72% 0.17 280);          /* violet */
  --danger:        oklch(70% 0.18 25);
  --success:       oklch(75% 0.16 150);

  /* Type */
  --font-body: "Inter", system-ui, -apple-system, "Segoe UI", sans-serif;
  --font-mono: "JetBrains Mono", ui-monospace, "SF Mono", Menlo, monospace;

  --fs-1: 0.75rem;
  --fs-2: 0.875rem;
  --fs-3: 1rem;
  --fs-4: 1.125rem;
  --fs-5: 1.375rem;
  --fs-6: 1.75rem;
  --fs-7: 2.25rem;
  --fs-8: 3rem;

  /* Spacing scale — 4px base */
  --sp-1: 0.25rem;
  --sp-2: 0.5rem;
  --sp-3: 0.75rem;
  --sp-4: 1rem;
  --sp-5: 1.5rem;
  --sp-6: 2rem;
  --sp-7: 3rem;
  --sp-8: 4rem;
  --sp-9: 6rem;

  --radius-sm: 6px;
  --radius: 10px;
  --radius-lg: 16px;

  --shadow-sm: 0 1px 2px rgba(0,0,0,0.3);
  --shadow: 0 4px 12px rgba(0,0,0,0.4);
  --shadow-lg: 0 16px 40px rgba(0,0,0,0.5);
}

*, *::before, *::after { box-sizing: border-box; }

html {
  scroll-behavior: smooth;
  color-scheme: dark;
}

body {
  margin: 0;
  font-family: var(--font-body);
  background: var(--bg);
  color: var(--text);
  font-size: var(--fs-3);
  line-height: 1.6;
  min-height: 100vh;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}

/* Navigation */
.site-nav {
  position: sticky;
  top: 0;
  z-index: 10;
  display: flex;
  align-items: center;
  gap: var(--sp-2);
  padding: var(--sp-3) var(--sp-5);
  background: color-mix(in oklab, var(--bg) 80%, transparent);
  backdrop-filter: blur(12px);
  border-bottom: 1px solid var(--border);
  font-size: var(--fs-2);
}
.site-nav a {
  color: var(--text-muted);
  text-decoration: none;
  padding: var(--sp-1) var(--sp-2);
  border-radius: var(--radius-sm);
  transition: all 120ms ease;
}
.site-nav a:hover { color: var(--text); background: var(--surface); }
.site-nav .nav-current { color: var(--text); font-weight: 500; }
.site-nav .nav-sep { color: var(--text-dim); }
.site-nav .nav-spacer { flex: 1; }
.site-nav .nav-meta {
  color: var(--text-dim);
  font-family: var(--font-mono);
  font-size: var(--fs-1);
}

/* Content wrapper */
.page {
  max-width: 820px;
  margin: 0 auto;
  padding: var(--sp-7) var(--sp-5) var(--sp-8);
}
.page-wide {
  max-width: 1200px;
  margin: 0 auto;
  padding: var(--sp-7) var(--sp-5) var(--sp-8);
}

/* Headings */
h1, h2, h3, h4 {
  font-weight: 600;
  line-height: 1.2;
  letter-spacing: -0.015em;
  margin: var(--sp-7) 0 var(--sp-4);
}
h1 { font-size: var(--fs-7); margin-top: 0; letter-spacing: -0.02em; }
h2 { font-size: var(--fs-6); }
h3 { font-size: var(--fs-5); color: var(--text); }
h4 { font-size: var(--fs-4); color: var(--text-muted); }

.lesson-eyebrow {
  display: inline-block;
  color: var(--accent);
  font-family: var(--font-mono);
  font-size: var(--fs-1);
  text-transform: uppercase;
  letter-spacing: 0.1em;
  margin-bottom: var(--sp-2);
}

.lesson-meta {
  display: flex;
  gap: var(--sp-4);
  color: var(--text-dim);
  font-size: var(--fs-2);
  margin-bottom: var(--sp-6);
  padding-bottom: var(--sp-5);
  border-bottom: 1px solid var(--border);
}

/* Prose */
p { margin: var(--sp-4) 0; color: var(--text); }
p.lead { font-size: var(--fs-4); color: var(--text-muted); margin: var(--sp-5) 0; }

a { color: var(--accent); text-decoration: none; border-bottom: 1px solid transparent; transition: border-color 120ms; }
a:hover { border-bottom-color: var(--accent); }

ul, ol { padding-left: var(--sp-5); }
li { margin: var(--sp-2) 0; }
li::marker { color: var(--text-dim); }

strong { color: var(--text); font-weight: 600; }
em { color: var(--text-muted); }

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

/* Code */
code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--surface-2);
  padding: 0.15em 0.4em;
  border-radius: 4px;
  color: var(--accent);
  border: 1px solid var(--border);
}
pre {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: var(--sp-4) var(--sp-5);
  overflow-x: auto;
  margin: var(--sp-5) 0;
  font-size: var(--fs-2);
  line-height: 1.6;
}
pre code {
  background: none;
  border: 0;
  padding: 0;
  color: var(--text);
  font-size: inherit;
}

/* Callouts */
.callout {
  border-left: 3px solid var(--accent);
  background: color-mix(in oklab, var(--accent) 10%, var(--surface));
  padding: var(--sp-4) var(--sp-5);
  border-radius: 0 var(--radius) var(--radius) 0;
  margin: var(--sp-5) 0;
}
.callout h4 {
  margin: 0 0 var(--sp-2) 0;
  color: var(--accent);
  font-size: var(--fs-2);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}
.callout p:first-of-type { margin-top: 0; }
.callout p:last-of-type { margin-bottom: 0; }
.callout.warn { border-color: var(--accent-2); background: color-mix(in oklab, var(--accent-2) 10%, var(--surface)); }
.callout.warn h4 { color: var(--accent-2); }
.callout.danger { border-color: var(--danger); background: color-mix(in oklab, var(--danger) 10%, var(--surface)); }
.callout.danger h4 { color: var(--danger); }

/* Cards & surfaces */
.card {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  padding: var(--sp-5);
  transition: border-color 200ms ease;
}
.card:hover { border-color: var(--border-bright); }

/* Buttons */
.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-2);
  padding: var(--sp-2) var(--sp-4);
  border: 1px solid var(--border-bright);
  background: var(--surface-2);
  color: var(--text);
  font: 500 var(--fs-2) var(--font-body);
  border-radius: var(--radius);
  cursor: pointer;
  transition: all 120ms ease;
  text-decoration: none;
}
.btn:hover {
  background: var(--surface);
  border-color: var(--accent);
  color: var(--text);
}
.btn.primary {
  background: var(--accent);
  color: var(--bg);
  border-color: var(--accent);
  font-weight: 600;
}
.btn.primary:hover {
  background: color-mix(in oklab, var(--accent) 90%, white);
  color: var(--bg);
  border-color: transparent;
}

/* Prev / next navigation */
.prev-next {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--sp-4);
  margin-top: var(--sp-8);
  padding-top: var(--sp-6);
  border-top: 1px solid var(--border);
}
.prev-next a {
  padding: var(--sp-4);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  color: var(--text);
  text-decoration: none;
  display: flex;
  flex-direction: column;
  gap: var(--sp-1);
  transition: all 150ms;
}
.prev-next a:hover { border-color: var(--accent); background: var(--surface); }
.prev-next .nav-next { text-align: right; }
.prev-next .nav-label {
  color: var(--text-dim);
  font-size: var(--fs-1);
  font-family: var(--font-mono);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}
.prev-next .nav-title { font-weight: 500; }

/* Tables */
table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--sp-5) 0;
  font-size: var(--fs-2);
}
th, td {
  text-align: left;
  padding: var(--sp-3);
  border-bottom: 1px solid var(--border);
}
th {
  color: var(--text-muted);
  font-weight: 500;
  font-size: var(--fs-1);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

/* Utility */
.grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: var(--sp-5); }
.grid-3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--sp-5); }
@media (max-width: 720px) {
  .grid-2, .grid-3 { grid-template-columns: 1fr; }
}

.kbd {
  display: inline-block;
  padding: 2px 6px;
  font-family: var(--font-mono);
  font-size: 0.85em;
  background: var(--surface-2);
  border: 1px solid var(--border-bright);
  border-bottom-width: 2px;
  border-radius: 4px;
  color: var(--text);
}

/* Focus states — accessible */
:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
  border-radius: 2px;
}

/* Sandbox / playground shared styles */
.sandbox {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--sp-4);
  margin: var(--sp-5) 0;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  overflow: hidden;
}
.sandbox-pane { background: var(--surface); padding: var(--sp-4); min-height: 200px; }
.sandbox-pane.preview { background: var(--surface-2); display: flex; align-items: center; justify-content: center; }
.sandbox-label {
  font-family: var(--font-mono);
  font-size: var(--fs-1);
  color: var(--text-dim);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  margin-bottom: var(--sp-2);
}
.sandbox textarea {
  width: 100%;
  min-height: 180px;
  background: var(--bg);
  color: var(--text);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  padding: var(--sp-3);
  font: 400 var(--fs-2) var(--font-mono);
  resize: vertical;
  line-height: 1.5;
}
@media (max-width: 720px) {
  .sandbox { grid-template-columns: 1fr; }
}