/* ============================================================
   HushSpec - style.css
   Obsidian dark theme. Clean, precise, product-grade.
   One file. No frameworks. No build step.
   ============================================================ */

/* --- Fonts -------------------------------------------------- */
@import url('https://fonts.googleapis.com/css2?family=Cinzel:wght@400;500;600;700&family=Source+Sans+3:wght@300;400;600&family=JetBrains+Mono:wght@400;500&display=swap');

/* --- Custom properties -------------------------------------- */
:root {
  /* Obsidian dark backgrounds */
  --bg-primary:    oklch(8% 0.005 250);
  --bg-secondary:  oklch(12% 0.008 250);
  --bg-elevated:   oklch(15% 0.01 250);
  --bg-code:       oklch(10% 0.008 250);

  /* Bone-white / pale silver text */
  --text-primary:   oklch(88% 0.01 60);
  --text-secondary: oklch(65% 0.01 60);
  --text-tertiary:  oklch(45% 0.01 250);

  /* Antique gold accents */
  --accent-gold:      oklch(72% 0.12 75);
  --accent-gold-dim:  oklch(55% 0.08 75);
  --accent-gold-glow: oklch(80% 0.15 75);

  /* Faint ice-blue spectral accent - VERY sparse */
  --accent-ice: oklch(75% 0.06 230);

  /* Borders */
  --border:       oklch(20% 0.01 250);
  --border-gold:  oklch(40% 0.06 75);
  --border-code:  oklch(22% 0.02 75);

  /* Semantic aliases */
  --surface-page:    var(--bg-primary);
  --surface-raised:  var(--bg-secondary);
  --surface-code:    var(--bg-code);
  --surface-nav:     var(--bg-primary);

  --accent:       var(--accent-gold);
  --accent-hover: var(--accent-gold-glow);

  /* Type scale - fluid */
  --text-xs:   clamp(0.7rem, 0.65rem + 0.25vw, 0.75rem);
  --text-sm:   clamp(0.8rem, 0.75rem + 0.25vw, 0.875rem);
  --text-base: clamp(0.95rem, 0.9rem + 0.25vw, 1.05rem);
  --text-lg:   clamp(1.1rem, 1rem + 0.5vw, 1.25rem);
  --text-xl:   clamp(1.3rem, 1.1rem + 1vw, 1.6rem);
  --text-2xl:  clamp(1.6rem, 1.3rem + 1.5vw, 2.2rem);
  --text-3xl:  clamp(2rem, 1.5rem + 2.5vw, 3rem);
  --text-4xl:  clamp(2.4rem, 1.8rem + 3vw, 3.8rem);
  --text-hero: clamp(3rem, 2rem + 5vw, 5.5rem);

  /* Spacing */
  --space-xs:  clamp(0.25rem, 0.2rem + 0.25vw, 0.5rem);
  --space-sm:  clamp(0.5rem, 0.4rem + 0.5vw, 0.75rem);
  --space-md:  clamp(1rem, 0.8rem + 1vw, 1.5rem);
  --space-lg:  clamp(1.5rem, 1.2rem + 1.5vw, 2.5rem);
  --space-xl:  clamp(2rem, 1.5rem + 2.5vw, 4rem);
  --space-2xl: clamp(3rem, 2rem + 5vw, 6rem);
  --space-3xl: clamp(5rem, 3.5rem + 7vw, 10rem);
  --space-section: clamp(4rem, 3rem + 5vw, 7rem);

  /* Layout */
  --content-width: 72rem;
  --prose-width: 65ch;
  --sidebar-width: 16rem;

  /* Docs surfaces */
  --docs-shell:        oklch(9.5% 0.008 252);
  --docs-panel:        oklch(11.8% 0.01 252 / 0.96);
  --docs-panel-soft:   oklch(13.5% 0.012 252 / 0.84);
  --docs-panel-strong: oklch(15% 0.015 252 / 0.98);
  --docs-border:       oklch(24% 0.018 252 / 0.88);
  --docs-shadow:       0 24px 72px oklch(3% 0.01 250 / 0.42);

  /* Motion */
  --ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1);
  --ease-out-expo:  cubic-bezier(0.16, 1, 0.3, 1);
  --duration-fast:  150ms;
  --duration-base:  300ms;
  --duration-slow:  500ms;
}

/* --- Reset -------------------------------------------------- */
*,
*::before,
*::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  scroll-behavior: smooth;
  -webkit-text-size-adjust: 100%;
  text-size-adjust: 100%;
  overflow-x: hidden;
}

body {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-base);
  font-weight: 400;
  line-height: 1.7;
  color: var(--text-primary);
  background: var(--surface-page);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  font-kerning: normal;
  overflow-x: hidden;
}

img, picture, video, canvas, svg {
  display: block;
  max-width: 100%;
}

a {
  color: var(--accent-gold);
  text-decoration: none;
  transition: color var(--duration-fast) var(--ease-out-quart);
}

a:hover {
  color: var(--accent-gold-glow);
}

a:focus-visible {
  outline: 2px solid var(--accent-gold);
  outline-offset: 2px;
}

h1, h2, h3, h4, h5, h6 {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-weight: 600;
  line-height: 1.2;
  color: var(--text-primary);
  letter-spacing: 0.01em;
}

h1 { font-size: var(--text-4xl); font-weight: 700; }
h2 { font-size: var(--text-2xl); }
h3 { font-size: var(--text-xl); }
h4 { font-size: var(--text-lg); }

ul, ol { padding-left: 1.25em; }

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

/* --- Utility ------------------------------------------------ */
.sr-only {
  position: absolute;
  width: 1px; height: 1px;
  padding: 0; margin: -1px;
  overflow: hidden;
  clip: rect(0,0,0,0);
  white-space: nowrap;
  border: 0;
}

/* --- Page-load reveal animation ----------------------------- */
@keyframes reveal-up {
  from {
    opacity: 0;
    transform: translateY(1.5rem);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes reveal-fade {
  from { opacity: 0; }
  to   { opacity: 1; }
}

.reveal {
  opacity: 0;
  animation: reveal-up var(--duration-slow) var(--ease-out-expo) forwards;
}

.reveal-d1 { animation-delay: 0.12s; }
.reveal-d2 { animation-delay: 0.24s; }
.reveal-d3 { animation-delay: 0.36s; }
.reveal-d4 { animation-delay: 0.48s; }
.reveal-d5 { animation-delay: 0.60s; }
.reveal-d6 { animation-delay: 0.72s; }
.reveal-d7 { animation-delay: 0.84s; }
.reveal-d8 { animation-delay: 0.96s; }

@media (prefers-reduced-motion: reduce) {
  .reveal {
    animation: none;
    opacity: 1;
  }
}

/* ============================================================
   SITE HEADER / NAV
   ============================================================ */
.site-header {
  position: sticky;
  top: 0;
  z-index: 100;
  background: color-mix(in oklch, var(--bg-primary) 92%, transparent);
  backdrop-filter: blur(20px) saturate(1.2);
  -webkit-backdrop-filter: blur(20px) saturate(1.2);
  border-bottom: 1px solid oklch(25% 0.03 75 / 0.4);
}

.site-header__inner {
  max-width: var(--content-width);
  margin: 0 auto;
  padding: var(--space-sm) var(--space-md);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-md);
}

.site-header__logo {
  font-family: 'Cinzel', 'Garamond', 'Georgia', serif;
  font-size: clamp(1.1rem, 1rem + 0.5vw, 1.35rem);
  font-weight: 600;
  color: var(--text-primary);
  text-decoration: none;
  letter-spacing: 0.12em;
  text-transform: uppercase;
}

.site-header__logo-accent {
  color: var(--accent-gold);
}

.site-header__logo:hover {
  color: var(--accent-gold-glow);
}

.site-header__logo:hover .site-header__logo-accent {
  color: var(--accent-gold-glow);
}

.site-nav {
  display: flex;
  align-items: center;
  gap: var(--space-md);
}

.site-nav a {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-sm);
  color: var(--text-tertiary);
  font-weight: 400;
  color: var(--text-secondary);
  text-decoration: none;
  letter-spacing: 0.03em;
  transition: color var(--duration-fast) var(--ease-out-quart);
}

.site-nav a:hover {
  color: var(--accent-gold);
}

.site-nav a.active {
  color: var(--accent-gold);
}

/* Mobile nav toggle */
.nav-toggle {
  display: none;
  background: none;
  border: none;
  cursor: pointer;
  padding: 0.5rem;
  color: var(--text-primary);
}

.nav-toggle svg {
  width: 1.25rem;
  height: 1.25rem;
  stroke: currentColor;
  stroke-width: 2;
  fill: none;
}

@media (max-width: 48rem) {
  .nav-toggle {
    display: block;
  }

  .site-nav {
    position: fixed;
    top: 0;
    right: 0;
    bottom: 0;
    width: min(20rem, 80vw);
    flex-direction: column;
    align-items: flex-start;
    padding: 4rem var(--space-lg) var(--space-lg);
    background: var(--bg-secondary);
    border-left: 1px solid var(--border-gold);
    transform: translateX(100%);
    visibility: hidden;
    transition: transform var(--duration-base) var(--ease-out-expo),
                visibility 0s var(--duration-base);
    z-index: 200;
    gap: var(--space-sm);
  }

  .site-nav.open {
    transform: translateX(0);
    visibility: visible;
    transition: transform var(--duration-base) var(--ease-out-expo),
                visibility 0s 0s;
  }

  .site-nav a {
    font-size: var(--text-base);
    padding: var(--space-xs) 0;
  }

  .nav-overlay {
    display: none;
    position: fixed;
    inset: 0;
    background: oklch(0 0 0 / 0.6);
    z-index: 150;
  }

  .nav-overlay.open {
    display: block;
  }
}

/* ============================================================
   HOMEPAGE
   ============================================================ */

/* --- Hero --------------------------------------------------- */
.hero {
  min-height: max(70vh, 28rem);
  display: flex;
  align-items: center;
  padding: clamp(6rem, 8vw, 10rem) var(--space-md) clamp(4rem, 6vw, 6rem);
  background: oklch(4% 0.002 250);
  position: relative;
  overflow: hidden;
}

.hero__bg {
  position: absolute;
  inset: 0;
  background:
    url('../static/hero.png') 42% 80% / 110% auto no-repeat;
  opacity: 0.15;
  mask-image: radial-gradient(
    ellipse 80% 70% at 50% 75%,
    black 0%,
    black 30%,
    transparent 70%
  );
  -webkit-mask-image: radial-gradient(
    ellipse 80% 70% at 50% 75%,
    black 0%,
    black 30%,
    transparent 70%
  );
  pointer-events: none;
}

/* Subtle grain texture via CSS */
.hero::after {
  content: '';
  position: absolute;
  inset: 0;
  opacity: 0.03;
  background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 256 256' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23noise)'/%3E%3C/svg%3E");
  background-size: 256px 256px;
  pointer-events: none;
}

.hero__layout {
  max-width: var(--content-width);
  width: 100%;
  margin: 0 auto;
  padding: 0 var(--space-md);
  position: relative;
  z-index: 1;
}

.hero__content {
  max-width: 40rem;
  width: 100%;
  display: flex;
  flex-direction: column;
  align-items: flex-start;
  text-align: left;
}

.hero__label {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.2em;
  color: var(--accent-gold-dim);
  margin-bottom: var(--space-md);
}

.hero__version {
  display: inline-block;
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-xs);
  font-weight: 400;
  letter-spacing: 0.1em;
  color: var(--text-tertiary);
  margin-bottom: var(--space-lg);
}

.hero__title {
  font-family: 'Cinzel', 'Garamond', 'Georgia', serif;
  font-size: var(--text-hero);
  font-weight: 400;
  color: var(--text-primary);
  letter-spacing: 0.04em;
  margin-bottom: var(--space-sm);
  line-height: 1;
}

/* Gold divider line - hidden in redesign */
.hero__divider {
  display: none;
}

.hero__tagline {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-lg);
  font-weight: 400;
  font-style: normal;
  letter-spacing: 0.04em;
  color: var(--text-secondary);
  margin-bottom: var(--space-lg);
  max-width: min(36rem, 100%);
  line-height: 1.55;
}

.hero__desc {
  font-size: var(--text-base);
  color: var(--text-secondary);
  max-width: min(var(--prose-width), 100%);
  margin-bottom: var(--space-lg);
  line-height: 1.7;
}

.hero__actions {
  display: flex;
  gap: var(--space-sm);
  flex-wrap: wrap;
  margin-bottom: var(--space-md);
}

/* GitHub text link below CTAs */
.hero__gh-link {
  font-size: var(--text-sm);
  color: var(--text-tertiary);
  letter-spacing: 0.02em;
  transition: color var(--duration-fast) var(--ease-out-quart);
}

.hero__gh-link:hover {
  color: var(--accent-gold);
}

/* Buttons */
.btn {
  display: inline-flex;
  align-items: center;
  gap: 0.4em;
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-sm);
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  padding: 0.75em 1.75em;
  border: 1px solid transparent;
  cursor: pointer;
  text-decoration: none;
  transition: all var(--duration-fast) var(--ease-out-quart);
}

.btn:focus-visible {
  outline: 2px solid var(--accent-gold);
  outline-offset: 2px;
}

.btn--primary {
  background: var(--accent-gold);
  color: oklch(10% 0.01 250);
  border-color: var(--accent-gold);
}

.btn--primary:hover {
  background: var(--accent-gold-glow);
  border-color: var(--accent-gold-glow);
  color: oklch(8% 0.01 250);
  transform: translateY(-1px);
}

.btn--primary:active {
  transform: translateY(0);
}

.btn--secondary {
  background: transparent;
  color: var(--text-secondary);
  border-color: var(--border-gold);
}

.btn--secondary:hover {
  background: oklch(15% 0.01 250);
  border-color: var(--accent-gold-dim);
  color: var(--accent-gold);
  transform: translateY(-1px);
}

.btn--secondary:active {
  transform: translateY(0);
}

/* Hero code example */
.hero__code {
  background: var(--bg-code);
  border: 1px solid var(--border);
  border-left: 2px solid var(--accent-gold-dim);
  padding: var(--space-md);
  overflow-x: auto;
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  line-height: 1.6;
  color: var(--text-primary);
  text-align: left;
  width: 100%;
  max-width: min(36rem, 100%);
}

.hero__code-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: var(--space-sm);
  padding-bottom: var(--space-xs);
  border-bottom: 1px solid var(--border);
}

.hero__code-filename {
  font-size: var(--text-xs);
  font-weight: 500;
  color: var(--accent-gold-dim);
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  text-transform: uppercase;
  letter-spacing: 0.08em;
}

/* Syntax highlighting - gold-accented */
.kw { color: var(--accent-gold); font-weight: 500; }
.str { color: oklch(70% 0.06 145); }
.cmt { color: var(--text-tertiary); font-style: italic; }
.num { color: var(--accent-ice); }

/* --- Section layout ----------------------------------------- */
.section {
  padding: var(--space-section) var(--space-md);
  max-width: var(--content-width);
  margin: 0 auto;
}

.section--alt {
  background: var(--bg-secondary);
  max-width: none;
}

.section--alt > .section__inner {
  max-width: var(--content-width);
  margin: 0 auto;
  padding: 0 var(--space-md);
  min-width: 0;
  overflow: hidden;
}

.section__label {
  display: block;
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.15em;
  color: var(--accent-gold-dim);
  margin-bottom: var(--space-sm);
}

.section__title {
  font-size: var(--text-2xl);
  color: var(--text-primary);
  margin-bottom: var(--space-sm);
  letter-spacing: 0.01em;
}

.section__title code,
.section__desc code {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.85em;
  background: var(--bg-code);
  padding: 0.1em 0.35em;
  color: var(--accent-gold);
  font-weight: 400;
}

.section__desc {
  color: var(--text-secondary);
  max-width: var(--prose-width);
  margin-bottom: var(--space-md);
  line-height: 1.7;
}

/* Section dividers - hidden, whitespace does the work now */
.section-divider {
  display: none;
}

/* --- "What is" section -------------------------------------- */
.what-is__subtitle {
  font-size: var(--text-lg);
  margin-bottom: var(--space-sm);
  color: var(--text-secondary);
  letter-spacing: 0.01em;
}

.what-is__desc {
  font-size: var(--text-sm);
  color: var(--text-secondary);
  margin-bottom: var(--space-md);
  line-height: 1.7;
}

.what-is {
  display: grid;
  grid-template-columns: 1fr 1.2fr;
  gap: var(--space-xl);
  align-items: start;
}

.what-is > * {
  min-width: 0;
}

@media (max-width: 60rem) {
  .what-is {
    grid-template-columns: 1fr;
  }
}

/* --- Principles badges -------------------------------------- */
.principles {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-sm);
  margin-top: var(--space-sm);
}

.principle-badge {
  font-size: var(--text-sm);
  font-weight: 400;
  padding: 0.4em 0.9em;
  color: var(--text-secondary);
  background: var(--bg-elevated);
}

.principle-badge strong {
  color: var(--accent-gold);
  font-weight: 600;
}

/* --- Rules section - numbered list, not grid --------------- */
.rules-grid {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-xs);
}

@media (max-width: 50rem) {
  .rules-grid {
    grid-template-columns: 1fr;
  }
}

.rule-cell {
  display: grid;
  grid-template-columns: 3rem 1fr;
  gap: var(--space-sm);
  padding: var(--space-md);
  align-items: baseline;
  background: var(--bg-secondary);
  transition: background var(--duration-fast) var(--ease-out-quart);
}

.rule-cell:hover {
  background: var(--bg-elevated);
}

.rule-cell__number {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-lg);
  font-weight: 600;
  color: var(--accent-gold-dim);
  line-height: 1;
  text-align: right;
}

.rule-cell__name {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--accent-gold);
  margin-bottom: 0.15rem;
}

.rule-cell__desc {
  font-size: var(--text-sm);
  color: var(--text-secondary);
  line-height: 1.5;
}

.rule-cell:hover .rule-cell__number {
  color: var(--accent-gold);
  transition: color var(--duration-fast) var(--ease-out-quart);
}

/* --- SDK section -------------------------------------------- */
.sdk-table-wrap {
  overflow-x: auto;
}

.sdk-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-sm);
  font-variant-numeric: tabular-nums;
}

.sdk-table th {
  text-align: left;
  padding: var(--space-sm) var(--space-md);
  background: var(--bg-elevated);
  font-weight: 600;
  color: var(--accent-gold-dim);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  border-bottom: 1px solid var(--border-gold);
}

.sdk-table td {
  padding: var(--space-sm) var(--space-md);
  border-bottom: 1px solid var(--border);
  vertical-align: top;
  color: var(--text-secondary);
}

.sdk-table tr:last-child td {
  border-bottom: none;
}

.sdk-table tbody tr:hover {
  background: oklch(10% 0.005 250);
}

.sdk-table__lang {
  font-weight: 600;
  color: var(--text-primary);
}

.sdk-table__level {
  display: inline-block;
  font-size: var(--text-xs);
  font-weight: 600;
  padding: 0.15em 0.5em;
}

.sdk-table__level--3 {
  background: oklch(15% 0.02 75);
  color: var(--accent-gold);
  border: 1px solid var(--border-gold);
}

.sdk-table__level--2 {
  background: oklch(12% 0.01 250);
  color: var(--text-secondary);
  border: 1px solid var(--border);
}

.sdk-check {
  color: var(--accent-gold-dim);
  font-weight: 500;
}

/* --- CLI section -------------------------------------------- */
.cli-commands {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-sm);
}

@media (max-width: 50rem) {
  .cli-commands {
    grid-template-columns: 1fr;
  }
}

.cli-cmd {
  background: var(--bg-code);
  border-left: 2px solid var(--accent-gold-dim);
  padding: var(--space-sm) var(--space-md);
  display: flex;
  align-items: start;
  gap: var(--space-sm);
  transition: border-color var(--duration-fast) var(--ease-out-quart),
              background var(--duration-fast) var(--ease-out-quart);
}

.cli-cmd:hover {
  border-left-color: var(--accent-gold);
  background: oklch(11% 0.008 250);
}

.cli-cmd__code {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  color: var(--text-primary);
  white-space: nowrap;
}

.cli-cmd__desc {
  font-size: var(--text-xs);
  color: var(--text-tertiary);
  margin-top: 0.15rem;
}

/* --- Rulesets section --------------------------------------- */
.rulesets-list {
  list-style: none;
  padding: 0;
  columns: 2;
  column-gap: var(--space-lg);
}

@media (max-width: 40rem) {
  .rulesets-list {
    columns: 1;
  }
}

.rulesets-list li {
  break-inside: avoid;
  padding: var(--space-xs) 0;
  display: flex;
  align-items: baseline;
  gap: var(--space-sm);
}

.rulesets-list__name {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--accent-gold);
  flex-shrink: 0;
}

.rulesets-list__desc {
  font-size: var(--text-sm);
  color: var(--text-secondary);
}

/* --- Open source / license --------------------------------- */
.oss-block {
  display: flex;
  align-items: center;
  gap: var(--space-lg);
  flex-wrap: wrap;
}

.oss-block__text {
  max-width: 36rem;
}

.oss-block__license {
  font-size: var(--text-2xl);
  font-weight: 700;
  color: var(--accent-gold);
  letter-spacing: 0.01em;
}

.oss-block__desc {
  color: var(--text-secondary);
  margin-top: var(--space-sm);
  line-height: 1.7;
}

.oss-block__action {
  margin-top: var(--space-md);
}

/* --- Site footer -------------------------------------------- */
.site-footer {
  border-top: 1px solid var(--border-gold);
  padding: var(--space-xl) var(--space-md);
  background: var(--bg-primary);
}

.site-footer__inner {
  max-width: var(--content-width);
  margin: 0 auto;
  display: flex;
  justify-content: space-between;
  align-items: start;
  flex-wrap: wrap;
  gap: var(--space-lg);
}

.site-footer__brand {
  font-weight: 700;
  font-size: var(--text-lg);
  color: var(--text-primary);
  margin-bottom: var(--space-xs);
  letter-spacing: 0.02em;
}

.site-footer__copy {
  font-size: var(--text-sm);
  color: var(--text-tertiary);
}

.site-footer__links {
  display: flex;
  gap: var(--space-lg);
}

.site-footer__col h4 {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--text-tertiary);
  margin-bottom: var(--space-xs);
}

.site-footer__col ul {
  list-style: none;
  padding: 0;
}

.site-footer__col li {
  margin-bottom: 0.25rem;
}

.site-footer__col a {
  font-size: var(--text-sm);
  color: var(--text-secondary);
}

.site-footer__col a:hover {
  color: var(--accent-gold);
}

/* ============================================================
   DOCS LAYOUT
   ============================================================ */
.docs-layout {
  position: relative;
  max-width: min(92rem, calc(100vw - clamp(1.5rem, 5vw, 5rem)));
  margin: 0 auto;
  padding: clamp(1rem, 2vw, 2rem);
  display: grid;
  grid-template-columns: minmax(15rem, 18rem) minmax(0, 1fr);
  gap: clamp(1rem, 2vw, 2rem);
  min-height: calc(100vh - 4rem - clamp(1rem, 2vw, 2rem));
}

.docs-layout::before {
  content: '';
  position: absolute;
  inset: 0;
  border: 1px solid color-mix(in oklch, var(--docs-border) 80%, transparent);
  border-radius: clamp(1.25rem, 1rem + 1vw, 2rem);
  background:
    radial-gradient(circle at top right, oklch(18% 0.04 78 / 0.15), transparent 34%),
    radial-gradient(circle at left 20%, oklch(16% 0.025 240 / 0.18), transparent 28%),
    linear-gradient(180deg, color-mix(in oklch, var(--docs-shell) 92%, transparent), color-mix(in oklch, var(--bg-primary) 90%, transparent));
  box-shadow: inset 0 1px 0 oklch(100% 0 0 / 0.03);
  pointer-events: none;
  z-index: -1;
}

@media (max-width: 68rem) {
  .docs-layout {
    grid-template-columns: 1fr;
    max-width: min(100vw, calc(100vw - 1rem));
    padding: 0.75rem;
  }
}

/* --- Sidebar ------------------------------------------------ */
.docs-sidebar {
  position: sticky;
  top: calc(3.5rem + clamp(0.75rem, 1.2vw, 1.25rem));
  align-self: start;
  max-height: calc(100vh - 3.5rem - clamp(1.5rem, 2vw, 2rem));
  overflow-y: auto;
  padding: clamp(1rem, 1.2rem + 0.2vw, 1.4rem);
  border: 1px solid color-mix(in oklch, var(--docs-border) 85%, transparent);
  border-radius: 1.4rem;
  font-size: var(--text-sm);
  background:
    linear-gradient(180deg, color-mix(in oklch, var(--docs-panel-strong) 82%, transparent), color-mix(in oklch, var(--docs-panel) 90%, transparent));
  box-shadow: var(--docs-shadow);
  backdrop-filter: blur(14px) saturate(1.05);
  -webkit-backdrop-filter: blur(14px) saturate(1.05);
}

@media (max-width: 68rem) {
  .docs-sidebar {
    position: fixed;
    top: 3.5rem;
    left: 0;
    bottom: 0;
    width: min(20rem, calc(100vw - 2rem));
    max-height: none;
    margin: 0.75rem;
    transform: translateX(calc(-100% - 1rem));
    opacity: 0;
    visibility: hidden;
    transition:
      transform var(--duration-base) var(--ease-out-expo),
      opacity var(--duration-fast) var(--ease-out-quart),
      visibility 0s var(--duration-base);
    z-index: 110;
  }

  .docs-sidebar.open {
    transform: translateX(0);
    opacity: 1;
    visibility: visible;
    transition:
      transform var(--duration-base) var(--ease-out-expo),
      opacity var(--duration-fast) var(--ease-out-quart),
      visibility 0s 0s;
  }
}

.docs-sidebar__section {
  margin-bottom: 1.1rem;
}

.docs-sidebar__section + .docs-sidebar__section {
  padding-top: 1rem;
  border-top: 1px solid color-mix(in oklch, var(--docs-border) 70%, transparent);
}

.docs-sidebar__heading {
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.14em;
  color: var(--text-tertiary);
  margin-bottom: 0.55rem;
}

.docs-sidebar ul {
  list-style: none;
  padding: 0;
  display: grid;
  gap: 0.2rem;
}

.docs-sidebar a {
  display: block;
  padding: 0.55rem 0.7rem;
  color: var(--text-secondary);
  font-weight: 400;
  border: 1px solid transparent;
  border-radius: 0.9rem;
  transition:
    color var(--duration-fast) var(--ease-out-quart),
    background var(--duration-fast) var(--ease-out-quart),
    border-color var(--duration-fast) var(--ease-out-quart),
    transform var(--duration-fast) var(--ease-out-quart);
  text-decoration: none;
}

.docs-sidebar a:hover {
  color: var(--accent-gold);
  background: color-mix(in oklch, var(--docs-panel-soft) 72%, transparent);
  border-color: color-mix(in oklch, var(--border-gold) 55%, transparent);
  transform: translateX(2px);
}

.docs-sidebar a.active {
  color: var(--accent-gold);
  background: color-mix(in oklch, var(--accent-gold) 10%, var(--docs-panel-soft));
  border-color: color-mix(in oklch, var(--border-gold) 70%, transparent);
  font-weight: 500;
  box-shadow: inset 0 1px 0 oklch(100% 0 0 / 0.03);
}

/* --- Doc content -------------------------------------------- */
.docs-content {
  padding: clamp(1.1rem, 2vw, 2rem) clamp(0.8rem, 1.8vw, 1.4rem) clamp(3rem, 5vw, 5rem);
  min-width: 0;
  background: transparent;
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: 1rem clamp(1.4rem, 2vw, 2.4rem);
  align-content: start;
}

@media (min-width: 86rem) {
  .docs-content {
    grid-template-columns: minmax(0, 72ch) minmax(14rem, 18rem);
    justify-content: start;
  }

  .docs-content > .breadcrumb {
    grid-column: 1 / -1;
    grid-row: 1;
  }

  .docs-content > .prose,
  .docs-content > .docs-pager {
    grid-column: 1;
  }

  .docs-content > .prose {
    grid-row: 2;
  }

  .docs-content > .docs-pager {
    grid-row: 3;
  }
}

@media (max-width: 68rem) {
  .docs-content {
    padding: 0.75rem 0.3rem 3rem;
  }
}

/* Breadcrumb */
.breadcrumb {
  width: fit-content;
  max-width: 100%;
  padding: 0.45rem 0.75rem;
  border: 1px solid color-mix(in oklch, var(--docs-border) 70%, transparent);
  border-radius: 999px;
  background: color-mix(in oklch, var(--docs-panel-soft) 82%, transparent);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  font-size: var(--text-xs);
  color: var(--text-tertiary);
  display: flex;
  align-items: center;
  gap: 0.4em;
  flex-wrap: wrap;
}

.breadcrumb a {
  color: var(--text-tertiary);
}

.breadcrumb a:hover {
  color: var(--accent-gold);
}

.breadcrumb__sep {
  color: var(--text-tertiary);
  opacity: 0.5;
}

/* Docs mobile toggle */
.docs-sidebar-toggle {
  display: none;
  width: fit-content;
  min-height: 2.75rem;
  background: color-mix(in oklch, var(--docs-panel-soft) 85%, transparent);
  border: 1px solid color-mix(in oklch, var(--docs-border) 70%, transparent);
  border-radius: 999px;
  padding: 0.55rem 0.95rem;
  font-size: var(--text-sm);
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-weight: 500;
  color: var(--text-secondary);
  cursor: pointer;
  transition:
    color var(--duration-fast) var(--ease-out-quart),
    border-color var(--duration-fast) var(--ease-out-quart),
    background var(--duration-fast) var(--ease-out-quart);
}

.docs-sidebar-toggle:hover {
  border-color: var(--accent-gold-dim);
  color: var(--accent-gold);
  background: color-mix(in oklch, var(--docs-panel-strong) 90%, transparent);
}

@media (max-width: 68rem) {
  .docs-sidebar-toggle {
    display: inline-flex;
    align-items: center;
    gap: 0.4em;
  }
}

/* --- Prose -------------------------------------------------- */
.prose {
  position: relative;
  max-width: none;
  padding: clamp(1.4rem, 3vw, 3rem);
  border: 1px solid color-mix(in oklch, var(--docs-border) 75%, transparent);
  border-radius: clamp(1.2rem, 1rem + 1vw, 1.8rem);
  background:
    radial-gradient(circle at top right, oklch(19% 0.04 76 / 0.12), transparent 30%),
    linear-gradient(180deg, color-mix(in oklch, var(--docs-panel-strong) 84%, transparent), color-mix(in oklch, var(--docs-panel) 94%, transparent));
  box-shadow: var(--docs-shadow);
  overflow: hidden;
}

.prose::before {
  content: '';
  position: absolute;
  inset: 0;
  background: linear-gradient(180deg, oklch(100% 0 0 / 0.035), transparent 18%);
  pointer-events: none;
}

.prose > * {
  position: relative;
}

.prose h1 {
  max-width: 12ch;
  margin-bottom: 1rem;
  font-size: clamp(2.75rem, 2.2rem + 2vw, 4.5rem);
  line-height: 0.98;
  letter-spacing: -0.035em;
  color: var(--text-primary);
  text-wrap: balance;
}

.prose h2 {
  margin-top: clamp(2.75rem, 4vw, 3.75rem);
  margin-bottom: 0.8rem;
  padding-top: 1.25rem;
  border-top: 1px solid color-mix(in oklch, var(--docs-border) 65%, transparent);
  font-size: clamp(1.7rem, 1.4rem + 1vw, 2.25rem);
  letter-spacing: -0.025em;
  color: var(--text-primary);
  text-wrap: balance;
}

.prose h3 {
  margin-top: 1.9rem;
  margin-bottom: 0.7rem;
  font-size: clamp(1.15rem, 1rem + 0.7vw, 1.55rem);
  letter-spacing: -0.015em;
  text-wrap: balance;
}

.prose h4 {
  margin-top: 1.4rem;
  margin-bottom: 0.45rem;
}

.prose p {
  max-width: 68ch;
  margin-bottom: 0.95rem;
  line-height: 1.82;
  color: color-mix(in oklch, var(--text-primary) 90%, var(--accent-gold) 10%);
}

.prose > p:first-of-type {
  max-width: 58ch;
  margin-bottom: 1.75rem;
  font-size: clamp(1.05rem, 0.98rem + 0.25vw, 1.22rem);
  line-height: 1.86;
  color: color-mix(in oklch, var(--text-primary) 82%, var(--accent-gold) 18%);
}

.prose ul,
.prose ol {
  max-width: 66ch;
  margin-bottom: 1rem;
}

.prose li {
  margin-bottom: 0.45rem;
  line-height: 1.7;
  color: color-mix(in oklch, var(--text-primary) 90%, var(--accent-gold) 10%);
}

.prose li::marker {
  color: color-mix(in oklch, var(--accent-gold-dim) 70%, var(--text-secondary));
}

.prose strong {
  font-weight: 600;
  color: var(--text-primary);
}

.prose em {
  font-style: italic;
}

.prose hr {
  border: none;
  border-top: 1px solid color-mix(in oklch, var(--docs-border) 65%, transparent);
  margin: 1.8rem 0;
}

/* Inline code */
.prose code {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.88em;
  background: color-mix(in oklch, var(--bg-code) 88%, var(--docs-panel-soft));
  border: 1px solid color-mix(in oklch, var(--docs-border) 60%, transparent);
  border-radius: 0.45rem;
  padding: 0.12em 0.42em;
  color: var(--accent-gold);
}

/* Code blocks */
.prose pre {
  margin-bottom: 1.2rem;
  background:
    linear-gradient(180deg, color-mix(in oklch, var(--bg-code) 92%, transparent), color-mix(in oklch, var(--bg-primary) 94%, transparent));
  border: 1px solid color-mix(in oklch, var(--docs-border) 75%, transparent);
  border-radius: 1rem;
  padding: 1.1rem 1.15rem;
  overflow-x: auto;
  line-height: 1.65;
  box-shadow: inset 0 1px 0 oklch(100% 0 0 / 0.03);
}

.prose pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: var(--text-sm);
  color: var(--text-primary);
}

/* Code block language label */
.prose .code-block {
  position: relative;
  margin: 1.3rem 0;
}

.prose .code-block__lang {
  position: absolute;
  top: 0.75rem;
  right: 0.85rem;
  font-size: var(--text-xs);
  font-family: 'Source Sans 3', 'Source Sans Pro', system-ui, sans-serif;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--accent-gold-dim);
  padding: 0.25em 0.6em;
  border: 1px solid color-mix(in oklch, var(--docs-border) 55%, transparent);
  border-radius: 999px;
  background: color-mix(in oklch, var(--bg-code) 82%, transparent);
}

/* Syntax highlighting in prose */
.prose pre .kw { color: var(--accent-gold); font-weight: 500; }
.prose pre .str { color: oklch(70% 0.06 145); }
.prose pre .cmt { color: var(--text-tertiary); font-style: italic; }
.prose pre .num { color: var(--accent-ice); }

/* Tables */
.prose table {
  width: 100%;
  border-collapse: separate;
  border-spacing: 0;
  margin: 1.2rem 0;
  font-size: var(--text-sm);
  border: 1px solid color-mix(in oklch, var(--docs-border) 72%, transparent);
  border-radius: 1rem;
  overflow: hidden;
  background: color-mix(in oklch, var(--docs-panel-soft) 82%, transparent);
}

.prose th {
  text-align: left;
  padding: 0.8rem 0.95rem;
  background: color-mix(in oklch, var(--docs-panel-strong) 88%, transparent);
  font-weight: 600;
  color: var(--accent-gold-dim);
  border-bottom: 1px solid color-mix(in oklch, var(--border-gold) 75%, transparent);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.08em;
}

.prose td {
  padding: 0.85rem 0.95rem;
  border-bottom: 1px solid color-mix(in oklch, var(--docs-border) 55%, transparent);
  vertical-align: top;
  color: color-mix(in oklch, var(--text-primary) 88%, var(--accent-gold) 12%);
}

.prose th:first-child,
.prose td:first-child {
  font-weight: 500;
}

.prose tbody tr:nth-child(odd) {
  background: oklch(12% 0.008 250 / 0.3);
}

.prose tbody tr:hover {
  background: color-mix(in oklch, var(--docs-panel-strong) 76%, transparent);
}

.prose tr:last-child td {
  border-bottom: none;
}

/* Blockquotes */
.prose blockquote {
  border-left: 3px solid var(--accent-gold-dim);
  border-radius: 0 1rem 1rem 0;
  padding: 1rem 1.2rem;
  margin: 1.2rem 0;
  background: color-mix(in oklch, var(--docs-panel-soft) 90%, transparent);
  color: var(--text-secondary);
}

.prose blockquote p {
  margin-bottom: 0;
  color: var(--text-secondary);
}

/* Links in prose */
.prose a {
  color: var(--accent-gold);
  text-decoration: underline;
  text-decoration-color: color-mix(in oklch, var(--accent-gold) 35%, transparent);
  text-underline-offset: 0.15em;
}

.prose a:hover {
  text-decoration-color: var(--accent-gold);
  color: var(--accent-gold-glow);
}

/* --- Prev/Next nav ------------------------------------------ */
.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: var(--space-md);
  margin-top: 1.2rem;
  padding-top: 1rem;
  border-top: 1px solid color-mix(in oklch, var(--docs-border) 60%, transparent);
}

.docs-pager a {
  display: block;
  text-decoration: none;
  padding: 1rem 1.1rem;
  border: 1px solid color-mix(in oklch, var(--docs-border) 72%, transparent);
  border-radius: 1rem;
  background: color-mix(in oklch, var(--docs-panel-soft) 82%, transparent);
  max-width: 50%;
  transition:
    border-color var(--duration-fast) var(--ease-out-quart),
    background var(--duration-fast) var(--ease-out-quart),
    transform var(--duration-fast) var(--ease-out-quart);
}

.docs-pager a:hover {
  border-color: var(--accent-gold-dim);
  background: color-mix(in oklch, var(--docs-panel-strong) 76%, transparent);
  transform: translateY(-1px);
}

.docs-pager__dir {
  font-size: var(--text-xs);
  color: var(--text-tertiary);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  font-weight: 600;
  margin-bottom: 0.15rem;
}

.docs-pager__title {
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--text-primary);
}

.docs-pager a.docs-pager--next {
  margin-left: auto;
  text-align: right;
}

@media (max-width: 40rem) {
  .docs-pager {
    flex-direction: column;
  }

  .docs-pager a {
    max-width: none;
  }

  .docs-pager a.docs-pager--next {
    text-align: left;
  }
}

/* --- Generated page outline --------------------------------- */
.docs-outline {
  display: none;
}

@media (min-width: 86rem) {
  .docs-outline {
    display: block;
    grid-column: 2;
    grid-row: 2;
    position: sticky;
    top: calc(3.5rem + 1.25rem);
    align-self: start;
    padding: 1rem;
    border: 1px solid color-mix(in oklch, var(--docs-border) 72%, transparent);
    border-radius: 1.1rem;
    background: color-mix(in oklch, var(--docs-panel-soft) 88%, transparent);
    box-shadow: 0 18px 48px oklch(3% 0.01 250 / 0.28);
    backdrop-filter: blur(12px);
    -webkit-backdrop-filter: blur(12px);
  }

  .docs-outline__title {
    margin-bottom: 0.7rem;
    font-size: var(--text-xs);
    font-weight: 600;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--text-tertiary);
  }

  .docs-outline nav {
    display: grid;
    gap: 0.25rem;
  }

  .docs-outline a {
    display: block;
    padding: 0.45rem 0.6rem;
    border-radius: 0.8rem;
    color: var(--text-secondary);
    font-size: 0.92rem;
    line-height: 1.45;
    text-decoration: none;
    transition:
      color var(--duration-fast) var(--ease-out-quart),
      background var(--duration-fast) var(--ease-out-quart);
  }

  .docs-outline a:hover,
  .docs-outline a.active {
    color: var(--accent-gold);
    background: color-mix(in oklch, var(--accent-gold) 10%, transparent);
  }
}

/* ============================================================
   DOCS LANDING
   ============================================================ */
.docs-content .docs-landing-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(min(100%, 16rem), 1fr));
  gap: 1rem;
  margin-top: 1.25rem;
}

.docs-content .docs-landing-card {
  border: 1px solid var(--border);
  border-color: color-mix(in oklch, var(--docs-border) 70%, transparent);
  border-radius: 1.1rem;
  padding: 1.2rem 1.15rem;
  background:
    linear-gradient(180deg, color-mix(in oklch, var(--docs-panel-soft) 88%, transparent), color-mix(in oklch, var(--docs-panel) 92%, transparent));
  box-shadow: 0 18px 48px oklch(3% 0.01 250 / 0.22);
  text-decoration: none;
  transition:
    transform var(--duration-fast) var(--ease-out-quart),
    border-color var(--duration-fast) var(--ease-out-quart),
    background var(--duration-fast) var(--ease-out-quart);
}

.docs-content .docs-landing-card:hover {
  border-color: var(--accent-gold-dim);
  background:
    linear-gradient(180deg, color-mix(in oklch, var(--docs-panel-strong) 86%, transparent), color-mix(in oklch, var(--docs-panel-soft) 92%, transparent));
  transform: translateY(-2px);
}

.docs-content .docs-landing-card__title {
  font-size: var(--text-xl);
  font-weight: 600;
  color: var(--text-primary);
  margin-bottom: 0.4rem;
  letter-spacing: -0.01em;
}

.docs-content .docs-landing-card__desc {
  font-size: 0.96rem;
  color: var(--text-secondary);
  line-height: 1.65;
}

@media (min-width: 70rem) {
  .docs-content .docs-landing-card:first-child {
    grid-column: span 2;
  }
}

/* --- Docs-specific mobile overlay --------------------------- */
.docs-sidebar-backdrop {
  display: none;
}

@media (max-width: 68rem) {
  .docs-sidebar-backdrop {
    position: fixed;
    inset: 0;
    background: oklch(0 0 0 / 0.62);
    opacity: 0;
    visibility: hidden;
    transition:
      opacity var(--duration-fast) var(--ease-out-quart),
      visibility 0s var(--duration-fast);
    z-index: 100;
  }

  .docs-sidebar-backdrop.open {
    display: block;
    opacity: 1;
    visibility: visible;
    transition:
      opacity var(--duration-fast) var(--ease-out-quart),
      visibility 0s 0s;
  }
}

/* --- Anchor offsets ----------------------------------------- */
.prose h2,
.prose h3,
.prose h4 {
  scroll-margin-top: 5.75rem;
}

@media (max-width: 48rem) {
  .prose {
    padding: 1.2rem 1rem 1.35rem;
    border-radius: 1.1rem;
  }

  .prose h1 {
    max-width: 100%;
  }

  .prose p,
  .prose ul,
  .prose ol {
    max-width: none;
  }

  .prose table {
    display: block;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }
}

/* --- Scrollbar styling -------------------------------------- */
.hero__code pre,
.prose pre {
  -webkit-overflow-scrolling: touch;
  scrollbar-width: thin;
  scrollbar-color: oklch(25% 0.01 250) transparent;
}

.hero__code pre::-webkit-scrollbar,
.prose pre::-webkit-scrollbar {
  height: 6px;
}

.hero__code pre::-webkit-scrollbar-thumb,
.prose pre::-webkit-scrollbar-thumb {
  background: oklch(25% 0.01 250);
  border-radius: 3px;
}

/* --- Selection color ---------------------------------------- */
::selection {
  background: color-mix(in oklch, var(--accent-gold) 25%, transparent);
  color: var(--text-primary);
}

/* --- Sidebar scrollbar -------------------------------------- */
.docs-sidebar {
  scrollbar-width: thin;
  scrollbar-color: oklch(20% 0.01 250) transparent;
}

.docs-sidebar::-webkit-scrollbar {
  width: 4px;
}

.docs-sidebar::-webkit-scrollbar-thumb {
  background: oklch(20% 0.01 250);
  border-radius: 2px;
}

/* --- Extensions grid --------------------------------------- */
.extensions-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(18rem, 1fr));
  gap: var(--space-md);
}

/* --- Mobile hero overrides --------------------------------- */
@media (max-width: 48rem) {
  .hero {
    min-height: auto;
    padding: clamp(5rem, 6vw, 7rem) var(--space-md) clamp(3rem, 4vw, 5rem);
  }

  .hero__title {
    font-size: var(--text-4xl);
  }

  .hero__actions {
    flex-direction: column;
    width: 100%;
  }

  .hero__actions .btn {
    width: 100%;
    justify-content: center;
    text-align: center;
  }
}