/* ── SWARMHAUL DESIGN SYSTEM ─────────────────────────────────────────────── */

@import url('https://fonts.googleapis.com/css2?family=Chakra+Petch:wght@300;400;500;600;700&family=Crimson+Pro:ital,wght@0,300;0,400;0,600;1,300;1,400&family=JetBrains+Mono:wght@300;400;500&display=swap');

/* ── TOKENS ─────────────────────────────────────────────────────────────── */
:root {
  --bg:        #040708;
  --bg2:       #080d0e;
  --accent:    #00e5b0;
  --accent2:   #00aaff;
  --amber:     #f0a040;
  --text:      #d0e0dc;
  --dim:       #5a8080;
  --faint:     #162023;
  --line:      #1e2d30;
  --card-hover:#0a1214;
  --nav-glass: rgba(4,7,8,0.92);
  --grain-op:  0.6;
  --prose:     #b8ceca;
  --prose-dim: #8aada8;
  --mono:      'JetBrains Mono', monospace;
  --head:      'Chakra Petch', sans-serif;
  --serif:     'Crimson Pro', Georgia, serif;
}

[data-theme="light"] {
  --bg:        #f5f1ea;
  --bg2:       #ede9e1;
  --accent:    #007a60;
  --accent2:   #0066aa;
  --amber:     #b86a10;
  --text:      #0e1a1c;
  --dim:       #527070;
  --faint:     #e4e0d8;
  --line:      #ccc8be;
  --card-hover:#eae6de;
  --nav-glass: rgba(245,241,234,0.94);
  --grain-op:  0.18;
  --prose:     #263232;
  --prose-dim: #456060;
}

/* ── RESET ───────────────────────────────────────────────────────────────── */
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; cursor: none !important; }
@media (hover: none) and (pointer: coarse) {
  *, *::before, *::after { cursor: auto !important; }
  #cur-dot, #cur-ring { display: none !important; }
}
html { scroll-behavior: smooth; }
body {
  background: var(--bg);
  color: var(--text);
  font-family: var(--serif);
  overflow-x: hidden;
  transition: background 0.35s ease, color 0.35s ease;
}

/* ── CANVAS / GRAIN ──────────────────────────────────────────────────────── */
#canvas {
  position: fixed; top: 0; left: 0;
  width: 100%; height: 100%;
  z-index: 0; pointer-events: none;
}
.grain {
  position: fixed; inset: 0; z-index: 1; pointer-events: none;
  background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 200 200' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='4'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.035'/%3E%3C/svg%3E");
  opacity: var(--grain-op);
  transition: opacity 0.35s ease;
}

/* ── CURSOR ──────────────────────────────────────────────────────────────── */
#cur-dot {
  position: fixed; width: 6px; height: 6px; border-radius: 50%;
  background: var(--accent); pointer-events: none; z-index: 9999;
  transform: translate(-50%,-50%);
  transition: width 0.18s, height 0.18s, opacity 0.2s;
  box-shadow: 0 0 10px var(--accent);
}
#cur-ring {
  position: fixed; width: 28px; height: 28px; border-radius: 50%;
  border: 1px solid var(--accent); opacity: 0.35;
  pointer-events: none; z-index: 9998;
  transform: translate(-50%,-50%);
  transition: width 0.22s ease-out, height 0.22s ease-out, opacity 0.2s, border-color 0.2s;
}
body.cur-hover #cur-dot { width: 10px; height: 10px; opacity: 0.9; }
body.cur-hover #cur-ring { width: 42px; height: 42px; opacity: 0.6; }

/* ── SCROLL PROGRESS ─────────────────────────────────────────────────────── */
#scroll-progress {
  position: fixed; top: 0; left: 0; right: 0; height: 1px;
  background: var(--accent); transform-origin: left; transform: scaleX(0);
  z-index: 200; box-shadow: 0 0 6px var(--accent);
  transition: transform 0.05s linear;
}

/* ── NAV ─────────────────────────────────────────────────────────────────── */
nav {
  position: fixed; top: 0; left: 0; right: 0;
  z-index: 100; height: 56px;
  display: flex; align-items: center;
  padding: 0 32px;
  background: transparent;
  transition: background 0.4s, border-bottom 0.4s;
}
nav.scrolled {
  background: var(--nav-glass);
  backdrop-filter: blur(20px) saturate(1.4);
  -webkit-backdrop-filter: blur(20px) saturate(1.4);
  border-bottom: 1px solid var(--line);
}
.nav-inner { display: flex; align-items: center; width: 100%; }
.nav-logo { display: flex; align-items: center; gap: 10px; text-decoration: none; }
.nav-logo svg { width: 22px; height: 22px; }
.nav-wordmark {
  font-family: var(--head); font-size: 11px; font-weight: 700;
  letter-spacing: 0.22em; color: var(--text);
}
.nav-links { display: flex; gap: 2px; margin-left: 32px; }
.nav-links a {
  font-family: var(--head); font-size: 9px; font-weight: 500;
  letter-spacing: 0.16em; color: var(--dim);
  text-decoration: none; padding: 6px 10px;
  position: relative; transition: color 0.15s;
}
.nav-links a::after {
  content: ''; position: absolute; bottom: 2px; left: 10px; right: 10px;
  height: 1px; background: var(--accent);
  transform: scaleX(0); transform-origin: left;
  transition: transform 0.2s ease;
}
.nav-links a:hover { color: var(--text); }
.nav-links a:hover::after { transform: scaleX(1); }
.nav-links a.active { color: var(--accent); }
.nav-links a.active::after { transform: scaleX(1); }
.nav-right { margin-left: auto; display: flex; align-items: center; gap: 14px; }
.status-pill {
  display: flex; align-items: center; gap: 6px;
  font-family: var(--mono); font-size: 9px; letter-spacing: 0.1em; color: var(--dim);
  border: 1px solid var(--line); padding: 4px 10px; border-radius: 100px;
}
.pulse-dot {
  width: 5px; height: 5px; border-radius: 50%;
  background: var(--accent); box-shadow: 0 0 8px var(--accent);
  animation: throb 2s ease-in-out infinite;
}
@keyframes throb {
  0%,100% { opacity:1; box-shadow:0 0 8px var(--accent); }
  50%      { opacity:0.4; box-shadow:0 0 2px var(--accent); }
}
#theme-toggle {
  background: transparent; border: 1px solid var(--line); color: var(--dim);
  width: 30px; height: 30px; border-radius: 50%;
  display: flex; align-items: center; justify-content: center;
  flex-shrink: 0;
  transition: border-color 0.2s, color 0.2s, box-shadow 0.2s;
}
#theme-toggle:hover { border-color: var(--accent); color: var(--accent); box-shadow: 0 0 12px rgba(0,229,176,0.2); }
.cta-btn {
  font-family: var(--head); font-size: 9px; font-weight: 700;
  letter-spacing: 0.16em; color: var(--bg);
  background: var(--accent); padding: 7px 14px;
  text-decoration: none; border-radius: 2px;
  transition: opacity 0.15s, box-shadow 0.15s;
}
.cta-btn:hover { opacity: 0.9; box-shadow: 0 0 24px rgba(0,229,176,0.35); }

/* ── FOOTER ──────────────────────────────────────────────────────────────── */
footer {
  position: relative; z-index: 2;
  border-top: 1px solid var(--line);
  padding: 32px 40px;
  display: flex; align-items: center; justify-content: space-between;
  flex-wrap: wrap; gap: 12px;
}
.footer-wordmark {
  font-family: var(--head); font-size: 10px; font-weight: 700;
  letter-spacing: 0.22em; color: var(--dim);
}
.footer-inner {
  display: contents;
}
.footer-copy {
  font-family: var(--mono); font-size: 9px; letter-spacing: 0.08em; color: var(--dim);
}
.footer-links {
  font-family: var(--mono); font-size: 9px; letter-spacing: 0.1em; color: var(--dim);
  display: flex; align-items: center; gap: 16px;
}
.footer-links a { color: var(--dim); text-decoration: none; transition: color 0.15s; }
.footer-links a:hover { color: var(--text); }

/* ── DIVIDERS ────────────────────────────────────────────────────────────── */
.fw-divider {
  position: relative; z-index: 2; height: 1px;
  background: linear-gradient(to right, transparent, var(--line) 20%, var(--line) 80%, transparent);
}

/* ── SCROLL REVEAL ───────────────────────────────────────────────────────── */
.reveal {
  opacity: 0; transform: translateY(24px);
  transition: opacity 0.65s ease, transform 0.65s ease;
}
.reveal.visible { opacity: 1; transform: translateY(0); }

/* ── ANIMATIONS ──────────────────────────────────────────────────────────── */
@keyframes fadeUp {
  from { opacity: 0; transform: translateY(20px); }
  to   { opacity: 1; transform: translateY(0); }
}
@keyframes blink { 0%,100%{opacity:1} 50%{opacity:0} }
.tw-cursor {
  display: inline-block; width: 7px; height: 13px;
  background: var(--accent); vertical-align: middle; margin-left: 1px;
  animation: blink 0.9s step-start infinite; opacity: 0.85;
}

/* ── TERMINAL ────────────────────────────────────────────────────────────── */
.terminal {
  background: #020506; border: 1px solid var(--line);
  border-radius: 6px; overflow: hidden; margin: 24px 0; position: relative;
  box-shadow: 0 0 40px rgba(0,0,0,0.6), 0 0 80px rgba(0,229,176,0.03);
  transition: border-color 0.2s, box-shadow 0.2s;
}
.terminal:hover { border-color: rgba(0,229,176,0.2); }
.terminal::after {
  content: ''; position: absolute; inset: 0;
  background: repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(0,0,0,0.04) 2px, rgba(0,0,0,0.04) 4px);
  pointer-events: none; border-radius: 6px;
}
.terminal-bar {
  background: #0a1012; border-bottom: 1px solid var(--line);
  padding: 9px 16px; display: flex; align-items: center; gap: 12px;
}
.term-dots, .mac-dots { display: flex; gap: 6px; padding: 9px 14px; background: #0a1012; border-bottom: 1px solid var(--line); }
.term-dots span, .mac-dots span { width: 10px; height: 10px; border-radius: 50%; opacity: 0.7; transition: opacity 0.15s; flex-shrink: 0; }
.term-dots span:nth-child(1), .mac-dots span:nth-child(1) { background: #ff5f56; }
.term-dots span:nth-child(2), .mac-dots span:nth-child(2) { background: #ffbd2e; }
.term-dots span:nth-child(3), .mac-dots span:nth-child(3) { background: #27c93f; }
.terminal:hover .term-dots span, .terminal:hover .mac-dots span { opacity: 1; }
.term-title { font-family: var(--mono); font-size: 10px; letter-spacing: 0.08em; color: var(--dim); }
.term-lang { margin-left: auto; font-family: var(--head); font-size: 8px; letter-spacing: 0.18em; color: #263a3e; }
.terminal pre {
  padding: 18px 20px; font-family: var(--mono); font-size: 13px;
  line-height: 1.75; color: var(--prose); overflow-x: auto;
}
.terminal pre .c  { color: #517a80; }
.terminal pre .k  { color: var(--accent); }
.terminal pre .s  { color: #7ed4b6; }
.terminal pre .p  { color: #4a6e74; }
.terminal pre .hl { color: var(--text); }

/* ── COPY BUTTON ─────────────────────────────────────────────────────────── */
.copy-btn {
  position: absolute; top: 8px; right: 8px; z-index: 10;
  display: flex; align-items: center; justify-content: center;
  width: 28px; height: 28px; border-radius: 4px;
  background: transparent; border: 1px solid transparent;
  color: var(--dim); opacity: 0; cursor: pointer !important;
  transition: opacity 0.15s, color 0.15s, border-color 0.15s, background 0.15s;
}
.terminal:hover .copy-btn,
.prose pre:hover .copy-btn { opacity: 1; }
@media (hover: none) and (pointer: coarse) { .copy-btn { opacity: 1; } }
.copy-btn:hover {
  color: var(--accent); border-color: var(--line);
  background: rgba(0,229,176,0.06);
}
.copy-btn svg { width: 13px; height: 13px; stroke: currentColor; fill: none; stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; flex-shrink: 0; }
.copy-btn .icon-check { display: none; }
.copy-btn.copied { color: var(--accent); opacity: 1; border-color: transparent; }
.copy-btn.copied .icon-clip  { display: none; }
.copy-btn.copied .icon-check { display: block; }

/* ── CALLOUT ─────────────────────────────────────────────────────────────── */
.callout {
  border: 1px solid rgba(0,229,176,0.2);
  background: rgba(0,229,176,0.04);
  padding: 16px 20px; border-radius: 4px; margin: 20px 0;
  position: relative; overflow: hidden;
}
.callout::before {
  content: ''; position: absolute; top: 0; left: 0;
  width: 2px; height: 100%; background: var(--accent);
}
.callout-amber { border-color: rgba(240,160,64,0.25); background: rgba(240,160,64,0.05); }
.callout-amber::before { background: var(--amber); }
.callout strong { font-family: var(--head); font-size: 9px; letter-spacing: 0.2em; color: var(--accent); display: block; margin-bottom: 6px; }
.callout-amber strong { color: var(--amber); }
.callout p { font-size: 14px; color: #7a9e9a; margin: 0; }

/* ═════════════════════════════════════════════════════════════════════════ */
/*  DOC PAGE LAYOUT                                                          */
/* ═════════════════════════════════════════════════════════════════════════ */

.doc-layout {
  position: relative; z-index: 2;
  display: grid;
  grid-template-columns: 260px 1fr;
  min-height: 100vh;
  padding-top: 56px;
}

/* ── SIDEBAR ─────────────────────────────────────────────────────────────── */
.doc-sidebar {
  position: sticky; top: 56px;
  height: calc(100vh - 56px);
  overflow-y: auto;
  border-right: 1px solid var(--line);
  padding: 32px 0;
  background: rgba(4,7,8,0.5);
  backdrop-filter: blur(8px);
  -webkit-backdrop-filter: blur(8px);
  transition: background 0.35s ease;
  scrollbar-width: thin;
  scrollbar-color: var(--line) transparent;
}
[data-theme="light"] .doc-sidebar { background: rgba(245,241,234,0.6); }
.doc-sidebar::-webkit-scrollbar { width: 4px; }
.doc-sidebar::-webkit-scrollbar-thumb { background: var(--line); border-radius: 2px; }

.sidebar-section {
  font-family: var(--mono); font-size: 9px; font-weight: 500;
  letter-spacing: 0.24em; color: var(--accent); opacity: 0.7;
  padding: 20px 24px 8px; display: block;
}
.sidebar-section-label {
  font-family: var(--mono); font-size: 8px; letter-spacing: 0.28em;
  color: var(--accent); opacity: 0.7; display: block; margin-bottom: 10px;
  padding-bottom: 8px; border-bottom: 1px solid var(--faint);
}
.sidebar-links { display: flex; flex-direction: column; gap: 2px; }
.sidebar-links a {
  font-family: var(--head); font-size: 11px; font-weight: 500;
  letter-spacing: 0.08em; color: var(--prose-dim); text-decoration: none;
  padding: 9px 10px; border-radius: 3px;
  transition: color 0.15s, background 0.15s;
  position: relative; line-height: 1.4;
}
.sidebar-links a:hover { color: var(--text); background: var(--faint); }
.sidebar-links a.active {
  color: var(--accent);
  background: rgba(0,229,176,0.06);
}
.sidebar-links a.active::before {
  content: ''; position: absolute; left: 0; top: 20%; bottom: 20%;
  width: 2px; background: var(--accent); border-radius: 0 1px 1px 0;
}
.sidebar-links a.amber { color: var(--amber); }
.sidebar-links a.amber:hover { color: var(--amber); background: rgba(240,160,64,0.06); }
.sidebar-links a.amber.active { color: var(--amber); background: rgba(240,160,64,0.06); }
.sidebar-links a.amber.active::before { background: var(--amber); }

/* ── CONTENT AREA ─────────────────────────────────────────────────────────── */
.doc-content {
  padding: 52px 60px 80px;
  max-width: 860px;
  min-width: 0;
  overflow-x: clip; /* clip inline overflow without creating a scroll container */
}

/* breadcrumb */
.doc-breadcrumb {
  font-family: var(--mono); font-size: 9px; letter-spacing: 0.18em;
  color: var(--dim); margin-bottom: 32px;
  display: flex; align-items: center; gap: 8px;
}
.doc-breadcrumb a { color: var(--dim); text-decoration: none; transition: color 0.15s; }
.doc-breadcrumb a:hover { color: var(--text); }
.doc-breadcrumb span { opacity: 0.4; }

/* page title */
.doc-title {
  font-family: var(--head); font-size: clamp(28px, 3.5vw, 44px);
  font-weight: 700; letter-spacing: 0.06em; color: var(--text);
  line-height: 1.1; margin-bottom: 12px;
}
.doc-tagline {
  font-family: var(--serif); font-style: italic; font-size: 18px;
  color: var(--dim); line-height: 1.5; margin-bottom: 40px;
  font-weight: 300;
}
.doc-lead {
  font-family: var(--serif); font-size: 18px; font-style: italic;
  color: var(--prose-dim); line-height: 1.7; margin-bottom: 40px;
  font-weight: 300; max-width: 640px;
}

/* prose */
.prose h2 {
  font-family: var(--head); font-size: clamp(15px, 2vw, 20px);
  font-weight: 600; letter-spacing: 0.07em; color: var(--text);
  margin: 52px 0 16px; padding-top: 8px;
  border-top: 1px solid var(--line); overflow-wrap: anywhere;
}
.prose h3 {
  font-family: var(--head); font-size: clamp(13px, 1.5vw, 15px); font-weight: 600;
  letter-spacing: 0.1em; color: var(--text); margin: 32px 0 12px; overflow-wrap: anywhere;
}
.prose h4 {
  font-family: var(--mono); font-size: 11px; letter-spacing: 0.18em;
  color: var(--accent); margin: 24px 0 10px; opacity: 0.85; overflow-wrap: anywhere;
}
.prose p {
  font-size: 16px; line-height: 1.9; color: var(--prose); margin-bottom: 18px;
  overflow-wrap: anywhere; /* allow breaking long inline code tokens mid-token */
}
.prose strong { color: var(--text); font-weight: 600; }
.prose em { color: var(--prose); font-style: italic; }
.prose a {
  color: var(--accent); text-decoration: none;
  border-bottom: 1px solid rgba(0,229,176,0.35);
  transition: border-color 0.15s, color 0.15s;
}
.prose a:hover { border-color: var(--accent); }
.prose ul, .prose ol { margin: 14px 0 20px 0; padding-left: 0; list-style: none; }
.prose ul li, .prose ol li {
  font-size: 16px; line-height: 1.8; color: var(--prose);
  padding: 4px 0 4px 26px; position: relative;
  overflow-wrap: anywhere;
}
.prose ul li::before {
  content: '→'; position: absolute; left: 0;
  color: var(--accent); opacity: 0.7; font-family: var(--mono); font-size: 11px;
  top: 6px;
}
.prose ol { counter-reset: ol-counter; }
.prose ol li { counter-increment: ol-counter; }
.prose ol li::before {
  content: counter(ol-counter) '.'; position: absolute; left: 0;
  color: var(--accent); font-family: var(--mono); font-size: 12px;
  top: 5px;
}
.prose code {
  font-family: var(--mono); font-size: 12px;
  background: rgba(0,229,176,0.08); color: var(--accent);
  padding: 2px 7px; border-radius: 3px;
  border: 1px solid rgba(0,229,176,0.18);
  overflow-wrap: anywhere;
  -webkit-box-decoration-break: clone;
  box-decoration-break: clone;
}
.prose hr { border: none; border-top: 1px solid var(--line); margin: 44px 0; }
.prose blockquote {
  border-left: 2px solid var(--accent); padding: 6px 0 6px 20px;
  margin: 24px 0; opacity: 0.9;
}
.prose blockquote p { font-style: italic; color: var(--prose-dim); }

/* tables */
.prose .table-wrap { overflow-x: auto; -webkit-overflow-scrolling: touch; margin: 24px 0; }
.prose table {
  width: 100%; border-collapse: collapse; font-size: 14px;
  min-width: 480px;
}
.prose .table-wrap + p, .prose table + p { margin-top: 4px; }
.prose thead { border-bottom: 1px solid var(--accent); }
.prose th {
  font-family: var(--mono); font-size: 10px; letter-spacing: 0.14em;
  color: var(--accent); padding: 10px 14px; text-align: left;
  font-weight: 400; white-space: nowrap;
}
.prose td {
  padding: 11px 14px; color: var(--prose); border-bottom: 1px solid var(--line);
  vertical-align: top; line-height: 1.6; overflow-wrap: anywhere;
}
.prose td code { font-size: 12px; }
.prose tr:last-child td { border-bottom: none; }
.prose tr:hover td { background: var(--faint); color: var(--text); }

/* code blocks (pre) inside prose */
.prose pre {
  background: #020506; border: 1px solid var(--line); border-radius: 6px;
  padding: 18px 20px 18px 20px; margin: 20px 0; overflow-x: auto;
  font-family: var(--mono); font-size: 13px; line-height: 1.75;
  color: var(--prose); position: relative;
  -webkit-overflow-scrolling: touch;
}
.prose pre code {
  background: none; color: inherit; padding: 0; border: none;
  font-size: inherit; word-break: normal;
}

/* status badge */
.status-badge {
  display: inline-flex; align-items: center; gap: 6px;
  font-family: var(--mono); font-size: 9px; letter-spacing: 0.12em;
  padding: 4px 10px; border-radius: 100px; margin-bottom: 24px;
}
.status-badge.spec { border: 1px solid rgba(240,160,64,0.35); color: var(--amber); background: rgba(240,160,64,0.06); }
.status-badge.live { border: 1px solid rgba(0,229,176,0.3); color: var(--accent); background: rgba(0,229,176,0.06); }

/* prev/next nav */
.doc-nav-footer {
  display: flex; justify-content: space-between; align-items: center;
  margin-top: 64px; padding-top: 32px; border-top: 1px solid var(--line);
  gap: 16px; flex-wrap: wrap;
}
.doc-nav-link,
.doc-nav-prev,
.doc-nav-next {
  font-family: var(--head); font-size: 10px; letter-spacing: 0.14em;
  color: var(--prose-dim); text-decoration: none;
  display: inline-flex; align-items: center; gap: 8px;
  padding: 11px 18px; border: 1px solid var(--line); border-radius: 3px;
  transition: color 0.15s, border-color 0.15s, background 0.15s;
  min-height: 44px;
}
.doc-nav-link:hover,
.doc-nav-prev:hover,
.doc-nav-next:hover { color: var(--accent); border-color: rgba(0,229,176,0.4); background: rgba(0,229,176,0.04); }
.doc-nav-link .dir { color: var(--dim); opacity: 0.5; }
.doc-nav-link .label { color: var(--text); }
.doc-nav-link.next { flex-direction: row-reverse; }

/* ── LANDING-SPECIFIC ─────────────────────────────────────────────────────── */
.wide { max-width: 1100px; margin: 0 auto; padding: 0 40px; }

/* hero */
#hero {
  position: relative; z-index: 2; height: 100vh;
  display: flex; flex-direction: column; align-items: center;
  justify-content: center; text-align: center; padding: 0 40px;
}
.hero-eyebrow {
  font-family: var(--mono); font-size: 10px; letter-spacing: 0.3em; color: var(--accent);
  margin-bottom: 28px; opacity: 0; animation: fadeUp 0.6s 0.2s ease both;
}
.hero-title {
  font-family: var(--head); font-size: clamp(52px,10vw,110px); font-weight: 700;
  letter-spacing: 0.06em; line-height: 0.92; color: var(--text);
  opacity: 0; animation: fadeUp 0.7s 0.35s ease both;
  will-change: transform;
}
.hero-title span {
  display: block;
  background: linear-gradient(110deg, #00e5b0 0%, #00c4e0 55%, #00aaff 100%);
  -webkit-background-clip: text; -webkit-text-fill-color: transparent; background-clip: text;
}
.hero-sub {
  font-family: var(--serif); font-size: clamp(16px,2vw,20px); font-weight: 300;
  font-style: italic; color: var(--dim); margin-top: 24px; max-width: 520px;
  line-height: 1.5; opacity: 0; animation: fadeUp 0.7s 0.5s ease both;
  will-change: transform;
}
.hero-actions {
  display: flex; gap: 12px; margin-top: 44px;
  opacity: 0; animation: fadeUp 0.7s 0.65s ease both;
}
.btn-primary {
  font-family: var(--head); font-size: 10px; font-weight: 700; letter-spacing: 0.2em;
  color: var(--bg); background: var(--accent); padding: 13px 28px;
  text-decoration: none; border-radius: 2px;
  transition: box-shadow 0.2s, opacity 0.15s;
}
.btn-primary:hover { box-shadow: 0 0 32px rgba(0,229,176,0.4), 0 0 64px rgba(0,229,176,0.15); }
.btn-ghost {
  font-family: var(--head); font-size: 10px; font-weight: 500; letter-spacing: 0.2em;
  color: var(--dim); background: transparent; border: 1px solid var(--line);
  padding: 13px 28px; text-decoration: none; border-radius: 2px;
  transition: color 0.15s, border-color 0.15s;
}
.btn-ghost:hover { color: var(--text); border-color: var(--dim); }
.hero-stats {
  display: flex; gap: 48px; margin-top: 72px;
  opacity: 0; animation: fadeUp 0.7s 0.8s ease both;
}
.hero-stat { text-align: center; }
.hero-stat-val { font-family: var(--head); font-size: 26px; font-weight: 700; letter-spacing: 0.04em; color: var(--accent); display: block; }
.hero-stat-label { font-family: var(--mono); font-size: 8.5px; letter-spacing: 0.18em; color: var(--dim); margin-top: 4px; display: block; }
.hero-scroll {
  position: absolute; bottom: 36px; left: 50%; transform: translateX(-50%);
  font-family: var(--mono); font-size: 8.5px; letter-spacing: 0.2em; color: var(--dim);
  display: flex; flex-direction: column; align-items: center; gap: 10px;
  opacity: 0; animation: fadeUp 0.6s 1.1s ease both;
}
.scroll-line {
  width: 1px; height: 40px;
  background: linear-gradient(to bottom, var(--dim), transparent);
  animation: scrollLine 1.8s ease-in-out infinite;
}
@keyframes scrollLine {
  0%   { transform: scaleY(0); transform-origin: top; opacity: 1; }
  50%  { transform: scaleY(1); transform-origin: top; opacity: 1; }
  51%  { transform: scaleY(1); transform-origin: bottom; opacity: 1; }
  100% { transform: scaleY(0); transform-origin: bottom; opacity: 0; }
}

/* chapter dividers */
.chapter { position: relative; z-index: 2; padding: 120px 0 40px; text-align: center; }
.chapter-num { font-family: var(--mono); font-size: 9px; letter-spacing: 0.3em; color: var(--accent); opacity: 0.6; display: block; margin-bottom: 12px; }
.chapter-title { font-family: var(--head); font-size: clamp(36px,6vw,72px); font-weight: 700; letter-spacing: 0.08em; color: var(--text); line-height: 1; }
.chapter-sub { font-family: var(--serif); font-style: italic; font-size: 18px; color: var(--dim); margin-top: 16px; font-weight: 300; }

/* doc cards (landing) */
.doc-grid {
  position: relative; z-index: 2;
  display: grid; grid-template-columns: repeat(auto-fill, minmax(280px,1fr));
  gap: 1px; background: var(--line); border: 1px solid var(--line);
  margin: 60px 0; overflow: hidden;
}
.doc-card {
  background: var(--bg); padding: 32px 28px;
  text-decoration: none; position: relative; overflow: hidden;
  transition: background 0.2s, transform 0.2s; opacity: 0;
}
.doc-card::before {
  content: ''; position: absolute; inset: 0;
  background: radial-gradient(circle at 0% 0%, rgba(0,229,176,0.06) 0%, transparent 60%);
  opacity: 0; transition: opacity 0.3s;
}
.doc-card::after {
  content: ''; position: absolute; top: 0; left: 0; right: 0; height: 1px;
  background: linear-gradient(to right, transparent, var(--accent), transparent);
  opacity: 0; transition: opacity 0.3s;
}
.doc-card:hover::before, .doc-card:hover::after { opacity: 0.5; }
.doc-card:hover { background: var(--card-hover); transform: translateY(-1px); }
.doc-card-num { font-family: var(--mono); font-size: 9px; letter-spacing: 0.2em; color: var(--accent); opacity: 0.5; margin-bottom: 14px; display: block; }
.doc-card-title { font-family: var(--head); font-size: 14px; font-weight: 600; letter-spacing: 0.1em; color: var(--text); margin-bottom: 10px; }
.doc-card-desc { font-size: 13.5px; font-style: italic; color: var(--dim); line-height: 1.5; font-weight: 300; }
.doc-card-arrow { position: absolute; bottom: 20px; right: 20px; font-family: var(--mono); font-size: 11px; color: var(--accent); opacity: 0; transform: translateX(-6px); transition: opacity 0.2s, transform 0.2s; }
.doc-card:hover .doc-card-arrow { opacity: 1; transform: translateX(0); }
.doc-card-hackathon { border-top: 2px solid var(--amber); }
.doc-card-hackathon .doc-card-num { color: var(--amber); }
.doc-card-hackathon .doc-card-arrow { color: var(--amber); }
.doc-card-hackathon::after { background: linear-gradient(to right, transparent, var(--amber), transparent); }

/* staggered card reveal */
.doc-grid.visible .doc-card:nth-child(1) { animation: cardIn 0.5s 0.00s ease both; }
.doc-grid.visible .doc-card:nth-child(2) { animation: cardIn 0.5s 0.06s ease both; }
.doc-grid.visible .doc-card:nth-child(3) { animation: cardIn 0.5s 0.12s ease both; }
.doc-grid.visible .doc-card:nth-child(4) { animation: cardIn 0.5s 0.18s ease both; }
.doc-grid.visible .doc-card:nth-child(5) { animation: cardIn 0.5s 0.24s ease both; }
.doc-grid.visible .doc-card:nth-child(6) { animation: cardIn 0.5s 0.30s ease both; }
.doc-grid.visible .doc-card:nth-child(7) { animation: cardIn 0.5s 0.36s ease both; }
.doc-grid.visible .doc-card:nth-child(8) { animation: cardIn 0.5s 0.42s ease both; }
.doc-grid.visible .doc-card:nth-child(9) { animation: cardIn 0.5s 0.48s ease both; }
@keyframes cardIn { from { opacity:0; transform:translateY(16px); } to { opacity:1; transform:translateY(0); } }

/* sections */
.section {
  position: relative; z-index: 2; max-width: 820px; margin: 0 auto; padding: 80px 40px;
  opacity: 0; transform: translateY(30px);
  transition: opacity 0.6s ease, transform 0.6s ease;
}
.section.visible { opacity: 1; transform: translateY(0); }
.section-tag {
  font-family: var(--mono); font-size: 9px; letter-spacing: 0.28em; color: var(--accent);
  display: inline-flex; align-items: center; gap: 8px; margin-bottom: 20px;
}
.section-tag::before { content: ''; display: block; width: 20px; height: 1px; background: var(--accent); }
.section h2 { font-family: var(--head); font-size: clamp(26px,4vw,44px); font-weight: 700; letter-spacing: 0.06em; color: var(--text); line-height: 1.1; margin-bottom: 20px; }
.section p { font-size: 17px; line-height: 1.85; color: var(--prose); margin-bottom: 20px; }
.section a { color: var(--accent); text-decoration: none; border-bottom: 1px solid rgba(0,229,176,0.3); }
.section a:hover { border-color: var(--accent); }
.section code { font-family: var(--mono); font-size: 12px; background: rgba(0,229,176,0.07); color: var(--accent); padding: 2px 7px; border-radius: 3px; border: 1px solid rgba(0,229,176,0.15); }

/* flow diagram */
.protocol-visual { position: relative; z-index: 2; padding: 40px; margin: 0 auto; max-width: 900px; }
.flow-row { display: flex; align-items: center; justify-content: center; gap: 0; flex-wrap: wrap; margin: 48px 0; }
.flow-node { background: var(--bg2); border: 1px solid var(--line); border-radius: 6px; padding: 16px 22px; text-align: center; min-width: 120px; position: relative; transition: border-color 0.3s, box-shadow 0.3s; }
.flow-node:hover { border-color: var(--accent); box-shadow: 0 0 24px rgba(0,229,176,0.12); }
.flow-node-icon { margin-bottom: 6px; }
.flow-node-label { font-family: var(--head); font-size: 9px; font-weight: 600; letter-spacing: 0.16em; color: var(--text); }
.flow-node-sub { font-family: var(--mono); font-size: 8.5px; color: var(--dim); margin-top: 3px; }
.flow-arrow { display: flex; flex-direction: column; align-items: center; gap: 4px; padding: 0 8px; color: var(--accent); }
.flow-arrow-label { font-family: var(--mono); font-size: 7.5px; letter-spacing: 0.1em; color: var(--dim); white-space: nowrap; }
.flow-arrow svg { overflow: visible; }
.flow-pulse { animation: flowPulse 2.2s ease-in-out infinite; opacity: 0.8; }
@keyframes flowPulse { 0% { transform: translateX(0); opacity:0; } 10% { opacity:0.8; } 90% { opacity:0.8; } 100% { transform: translateX(56px); opacity:0; } }

/* reward section */
.reward-hero { position: relative; z-index: 2; margin: 0; padding: 100px 40px; text-align: center; overflow: hidden; }
.reward-hero::before { content: ''; position: absolute; top: 50%; left: 50%; transform: translate(-50%,-50%); width: 600px; height: 600px; border-radius: 50%; background: radial-gradient(circle, rgba(240,160,64,0.08) 0%, transparent 65%); pointer-events: none; }
.reward-tag { font-family: var(--head); font-size: 9px; letter-spacing: 0.28em; color: var(--amber); border: 1px solid rgba(240,160,64,0.3); display: inline-flex; align-items: center; gap: 8px; padding: 6px 14px; border-radius: 100px; margin-bottom: 28px; }
.reward-title { font-family: var(--head); font-size: clamp(32px,5vw,60px); font-weight: 700; letter-spacing: 0.06em; color: var(--amber); line-height: 1.1; margin-bottom: 16px; }
.reward-sub { font-family: var(--serif); font-style: italic; font-size: 18px; color: var(--dim); max-width: 480px; margin: 0 auto 36px; line-height: 1.6; }
.reward-window { display: inline-flex; align-items: center; gap: 12px; font-family: var(--mono); font-size: 11px; letter-spacing: 0.12em; color: var(--amber); border: 1px solid rgba(240,160,64,0.3); background: rgba(240,160,64,0.06); padding: 12px 24px; border-radius: 4px; }

/* steps */
.steps { display: flex; flex-direction: column; gap: 0; margin: 40px 0; }
.step { display: grid; grid-template-columns: 1fr; gap: 0; border-left: 1px solid var(--line); padding: 0 0 36px 28px; position: relative; }
.step:last-child { border-left: 1px solid transparent; }
.step::before { content: attr(data-n); position: absolute; left: -20px; top: 0; width: 40px; height: 40px; border-radius: 50%; background: var(--bg); border: 1px solid var(--line); display: flex; align-items: center; justify-content: center; font-family: var(--mono); font-size: 10px; color: var(--dim); transition: border-color 0.2s, color 0.2s, box-shadow 0.2s; }
.step:hover::before { border-color: var(--accent); color: var(--accent); box-shadow: 0 0 16px rgba(0,229,176,0.25); }
.step-content { padding-top: 8px; grid-column: 1 / -1; }
.step-title { font-family: var(--head); font-size: 12px; font-weight: 600; letter-spacing: 0.14em; color: var(--text); margin-bottom: 10px; }
.step-body { font-size: 16px; line-height: 1.8; color: var(--prose); }

/* MCP section */
#mcp .section { max-width: 820px; }

/* ═════════════════════════════════════════════════════════════════════════ */
/*  MOBILE NAV ELEMENTS (injected by JS)                                     */
/* ═════════════════════════════════════════════════════════════════════════ */

#nav-menu {
  display: none;
  background: transparent; border: 1px solid var(--line); color: var(--dim);
  width: 36px; height: 36px; border-radius: 4px; flex-shrink: 0;
  align-items: center; justify-content: center;
  transition: border-color 0.2s, color 0.2s;
}
#nav-menu:hover { border-color: var(--accent); color: var(--accent); }

#sidebar-overlay {
  display: none; position: fixed; inset: 0;
  background: rgba(0,0,0,0.65); z-index: 140;
  backdrop-filter: blur(2px); -webkit-backdrop-filter: blur(2px);
}
#sidebar-overlay.open { display: block; }

#sidebar-close {
  display: none; position: absolute; top: 12px; right: 12px;
  background: transparent; border: 1px solid var(--line); color: var(--dim);
  width: 32px; height: 32px; border-radius: 4px;
  align-items: center; justify-content: center; font-size: 14px;
  transition: border-color 0.2s, color 0.2s; z-index: 1;
}
#sidebar-close:hover { border-color: var(--accent); color: var(--accent); }

/* ═════════════════════════════════════════════════════════════════════════ */
/*  RESPONSIVE BREAKPOINTS                                                   */
/* ═════════════════════════════════════════════════════════════════════════ */

/* ── Tablet (≤ 1024px) ────────────────────────────────────────────────── */
@media (max-width: 1024px) {
  .doc-layout {
    grid-template-columns: 220px 1fr;
  }
  .doc-content {
    padding: 44px 40px 72px;
  }
  .wide { padding: 0 28px; }
  .hero-stats { gap: 32px; }
}

/* ── Mobile (≤ 768px) ─────────────────────────────────────────────────── */
@media (max-width: 768px) {
  /* Nav */
  nav { padding: 0 16px; height: 52px; }
  .nav-links { display: none; }
  .status-pill { display: none; }
  .nav-wordmark { font-size: 10px; }
  #nav-menu { display: flex; }
  nav.scrolled { background: var(--nav-glass); }

  /* Sidebar becomes full-height overlay drawer */
  .doc-layout {
    grid-template-columns: 1fr;
    padding-top: 52px;
  }
  .doc-sidebar {
    position: fixed;
    left: 0; top: 0; bottom: 0;
    width: min(280px, 85vw);
    height: 100dvh;
    z-index: 150;
    transform: translateX(-100%);
    transition: transform 0.28s cubic-bezier(0.4,0,0.2,1);
    padding-top: 52px;
  }
  .doc-sidebar.open { transform: translateX(0); }
  #sidebar-close { display: flex; }

  /* Content */
  .doc-content {
    padding: 28px 20px 56px;
    max-width: 100%;
  }
  .doc-title { font-size: clamp(22px, 7vw, 32px); }
  .doc-lead { font-size: 16px; }
  .doc-breadcrumb { font-size: 8px; gap: 6px; }

  /* Prose adjustments */
  .prose h2 { font-size: 17px; margin-top: 40px; }
  .prose h3 { font-size: 14px; }
  .prose p, .prose ul li, .prose ol li { font-size: 15px; }
  .prose code { font-size: 11.5px; }

  /* Terminal */
  .terminal pre { font-size: 12px; padding: 14px 14px; }
  .mac-dots { padding: 8px 12px; }

  /* Tables — horizontal scroll */
  .prose table { min-width: 0; }
  .prose th, .prose td { padding: 9px 10px; font-size: 13px; }

  /* Prev/next */
  .doc-nav-footer { flex-direction: column; align-items: stretch; gap: 10px; }
  .doc-nav-prev, .doc-nav-next { text-align: center; padding: 12px 16px; }

  /* Landing hero */
  #hero { padding: 0 20px; }
  .hero-title { font-size: clamp(42px, 14vw, 72px); }
  .hero-actions { flex-direction: column; width: 100%; max-width: 280px; }
  .btn-primary, .btn-ghost { text-align: center; }
  .hero-stats { flex-wrap: wrap; justify-content: center; gap: 24px 40px; }

  /* Landing sections */
  .chapter { padding: 80px 20px 28px; }
  .section { padding: 60px 20px; }
  .wide { padding: 0 16px; }
  .reward-hero { padding: 72px 20px; }
  .doc-grid { margin: 40px 0; }
  .doc-card { padding: 24px 20px; }

  /* Footer */
  footer { padding: 24px 20px; flex-direction: column; align-items: flex-start; gap: 16px; }
}

/* ── Small phones (≤ 480px) ──────────────────────────────────────────── */
@media (max-width: 480px) {
  .doc-content { padding: 24px 16px 48px; }
  .prose h2 { font-size: 16px; }
  .terminal pre { font-size: 11.5px; }
  .hero-title { font-size: clamp(36px, 12vw, 60px); }
}