/* ============================================================================
   Design tokens — Nix.js Kit Docs
   Dark-first with a refined light theme. Inspired by Astro Starlight,
   Vite docs, and Linear's design language.
   ============================================================================ */

:root {
  /* ── Brand (Nix.js official colors) ── */
  --brand: #3432c8;
  --brand-2: #256fe1;
  --brand-3: #2bc7f0;
  --brand-glow: rgba(52, 50, 200, 0.3);

  /* ── Semantic (dark theme default) ── */
  --bg: #0a0a12;
  --bg-2: #0f0f1a;
  --bg-3: #15152400;
  --bg-card: #12121e;
  --bg-code: #0d0d16;
  --bg-hover: #1a1a2e;

  --border: rgba(43, 199, 240, 0.12);
  --border-2: rgba(43, 199, 240, 0.22);
  --border-strong: rgba(255, 255, 255, 0.08);

  --text: #e4e4f0;
  --text-2: #9999b8;
  --text-3: #5a5a7a;
  --text-inverse: #0a0a12;

  --accent: var(--brand);
  --accent-text: #2bc7f0;
  --link: var(--brand-2);
  --link-hover: #2bc7f0;

  --green: #34d399;
  --gold: #fbbf24;
  --red: #f87171;
  --blue: #38bdf8;

  /* ── Callout colors ── */
  --callout-note-bg: rgba(56, 189, 248, 0.08);
  --callout-note-border: rgba(56, 189, 248, 0.3);
  --callout-tip-bg: rgba(52, 211, 153, 0.08);
  --callout-tip-border: rgba(52, 211, 153, 0.3);
  --callout-warn-bg: rgba(251, 191, 36, 0.08);
  --callout-warn-border: rgba(251, 191, 36, 0.3);
  --callout-danger-bg: rgba(248, 113, 113, 0.08);
  --callout-danger-border: rgba(248, 113, 113, 0.3);

  /* ── Typography ── */
  --font-sans: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
  --font-mono: "JetBrains Mono", "Fira Code", "SF Mono", monospace;

  --fs-xs: 0.75rem;
  /* 12px */
  --fs-sm: 0.875rem;
  /* 14px */
  --fs-base: 1rem;
  /* 16px */
  --fs-lg: 1.125rem;
  /* 18px */
  --fs-xl: 1.25rem;
  /* 20px */
  --fs-2xl: 1.5rem;
  /* 24px */
  --fs-3xl: 2rem;
  /* 32px */
  --fs-4xl: 2.5rem;
  /* 40px */
  --fs-5xl: 3.5rem;
  /* 56px */

  --lh-tight: 1.25;
  --lh-normal: 1.6;
  --lh-relaxed: 1.75;

  --fw-normal: 400;
  --fw-medium: 500;
  --fw-semibold: 600;
  --fw-bold: 700;

  /* ── Spacing scale (4px base) ── */
  --sp-1: 4px;
  --sp-2: 8px;
  --sp-3: 12px;
  --sp-4: 16px;
  --sp-5: 20px;
  --sp-6: 24px;
  --sp-8: 32px;
  --sp-10: 40px;
  --sp-12: 48px;
  --sp-16: 64px;
  --sp-20: 80px;
  --sp-24: 96px;

  /* ── Layout ── */
  --sidebar-w: 280px;
  --toc-w: 240px;
  --content-max: 780px;
  --topbar-h: 56px;

  /* ── Radii ── */
  --r-sm: 6px;
  --r-md: 10px;
  --r-lg: 14px;
  --r-xl: 20px;
  --r-full: 9999px;

  /* ── Shadows ── */
  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.3);
  --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.35);
  --shadow-lg: 0 12px 32px rgba(0, 0, 0, 0.4);
  --shadow-glow: 0 0 24px var(--brand-glow);

  /* ── Transitions ── */
  --t-fast: 120ms ease;
  --t-normal: 200ms ease;
  --t-slow: 350ms cubic-bezier(0.4, 0, 0.2, 1);

  /* ── Z-index ── */
  --z-sidebar: 100;
  --z-topbar: 200;
  --z-drawer: 300;
  --z-modal: 400;
  --z-overlay: 350;
}

/* ── Light theme ── */
:root[data-theme="light"] {
  --bg: #ffffff;
  --bg-2: #f8f8fc;
  --bg-3: #f0f0f8;
  --bg-card: #ffffff;
  --bg-code: #f6f6fa;
  --bg-hover: #f0f0f8;

  --border: rgba(52, 50, 200, 0.15);
  --border-2: rgba(52, 50, 200, 0.28);
  --border-strong: rgba(0, 0, 0, 0.08);

  --text: #1a1a2e;
  --text-2: #555570;
  --text-3: #9999b0;
  --text-inverse: #ffffff;

  --accent-text: #3432c8;
  --link: #3432c8;
  --link-hover: #256fe1;

  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.06);
  --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.08);
  --shadow-lg: 0 12px 32px rgba(0, 0, 0, 0.12);
  --shadow-glow: 0 0 24px rgba(52, 50, 200, 0.15);

  --callout-note-bg: rgba(43, 199, 240, 0.06);
  --callout-tip-bg: rgba(52, 211, 153, 0.06);
  --callout-warn-bg: rgba(251, 191, 36, 0.06);
  --callout-danger-bg: rgba(248, 113, 113, 0.06);
}

/* Respect system preference if no explicit theme set */
@media (prefers-color-scheme: light) {
  :root:not([data-theme]) {
    --bg: #ffffff;
    --bg-2: #f8f8fc;
    --bg-3: #f0f0f8;
    --bg-card: #ffffff;
    --bg-code: #f6f6fa;
    --bg-hover: #f0f0f8;
    --border: rgba(52, 50, 200, 0.15);
    --border-2: rgba(52, 50, 200, 0.28);
    --border-strong: rgba(0, 0, 0, 0.08);
    --text: #1a1a2e;
    --text-2: #555570;
    --text-3: #9999b0;
    --text-inverse: #ffffff;
    --accent-text: #3432c8;
    --link: #3432c8;
    --link-hover: #256fe1;
    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.06);
    --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.08);
    --shadow-lg: 0 12px 32px rgba(0, 0, 0, 0.12);
    --shadow-glow: 0 0 24px rgba(52, 50, 200, 0.15);
  }
}

/* ============================================================================
   Base — reset, typography defaults, focus, accessibility
   ============================================================================ */

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

html {
  scroll-behavior: smooth;
  scroll-padding-top: calc(var(--topbar-h) + var(--sp-6));
  -webkit-text-size-adjust: 100%;
  text-rendering: optimizeLegibility;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

body {
  background: var(--bg);
  color: var(--text);
  font-family: var(--font-sans);
  font-size: var(--fs-base);
  line-height: var(--lh-normal);
  min-height: 100vh;
}

h1, h2, h3, h4, h5, h6 {
  font-weight: var(--fw-semibold);
  line-height: var(--lh-tight);
  color: var(--text);
  letter-spacing: -0.02em;
}

h1 { font-size: var(--fs-3xl); }
h2 { font-size: var(--fs-2xl); margin-top: var(--sp-12); }
h3 { font-size: var(--fs-xl); margin-top: var(--sp-8); }
h4 { font-size: var(--fs-lg); margin-top: var(--sp-6); }

p { margin: var(--sp-4) 0; }

a {
  color: var(--link);
  text-decoration: none;
  transition: color var(--t-fast);
}
a:hover { color: var(--link-hover); }

code, pre, kbd, samp {
  font-family: var(--font-mono);
  font-size: 0.9em;
}

strong { font-weight: var(--fw-semibold); }

ul, ol { margin: var(--sp-4) 0; padding-left: var(--sp-6); }
li { margin: var(--sp-2) 0; }

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

input, button, textarea, select {
  font: inherit;
  color: inherit;
}

button { cursor: pointer; background: none; border: none; }

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

blockquote {
  border-left: 3px solid var(--brand);
  padding: var(--sp-2) var(--sp-5);
  margin: var(--sp-6) 0;
  color: var(--text-2);
  background: var(--bg-2);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
}

/* ── Focus ── */
:focus-visible {
  outline: 2px solid var(--brand);
  outline-offset: 2px;
  border-radius: var(--r-sm);
}

/* ── Skip link ── */
.skip-link {
  position: absolute;
  top: -100px;
  left: var(--sp-4);
  z-index: var(--z-modal);
  background: var(--brand);
  color: white;
  padding: var(--sp-2) var(--sp-4);
  border-radius: var(--r-sm);
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
}
.skip-link:focus {
  top: var(--sp-4);
}

/* ── Scrollbar ── */
::-webkit-scrollbar { width: 8px; height: 8px; }
::-webkit-scrollbar-track { background: transparent; }
::-webkit-scrollbar-thumb {
  background: var(--border-2);
  border-radius: var(--r-full);
}
::-webkit-scrollbar-thumb:hover { background: var(--brand); }

/* ── Selection ── */
::selection {
  background: var(--brand-glow);
  color: var(--text);
}

/* ── Reduced motion ── */
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}


/* ============================================================================
   Layout — 3-column docs shell (sidebar / content / TOC)
   Responsive: TOC hides < 1280px, sidebar becomes drawer < 1024px
   ============================================================================ */

.docs-layout {
  display: grid;
  grid-template-columns: var(--sidebar-w) 1fr;
  grid-template-rows: var(--topbar-h) 1fr;
  grid-template-areas:
    "topbar topbar"
    "sidebar main";
  height: 100vh;
  overflow: hidden;
}

@media (min-width: 1280px) {
  .docs-layout {
    grid-template-columns: var(--sidebar-w) 1fr var(--toc-w);
    grid-template-areas:
      "topbar topbar topbar"
      "sidebar main toc";
  }
}

@media (max-width: 1023px) {
  .docs-layout {
    grid-template-columns: 1fr;
    grid-template-areas:
      "topbar"
      "main";
  }
}

/* ── Topbar ── */
.topbar {
  grid-area: topbar;
  display: flex;
  align-items: center;
  gap: var(--sp-4);
  padding: 0 var(--sp-5);
  background: var(--bg-2);
  border-bottom: 1px solid var(--border);
  z-index: var(--z-topbar);
  height: var(--topbar-h);
}

.topbar-left {
  display: flex;
  align-items: center;
  gap: var(--sp-3);
  flex-shrink: 0;
}

.topbar-brand {
  display: flex;
  align-items: center;
  gap: var(--sp-2);
  font-weight: var(--fw-bold);
  font-size: var(--fs-lg);
  color: var(--text);
  text-decoration: none;
}

.topbar-brand img {
  width: 28px;
  height: 28px;
  object-fit: contain;
}

.topbar-brand em {
  color: var(--brand);
  font-style: normal;
}

.topbar-version {
  font-size: var(--fs-xs);
  color: var(--text-3);
  padding: 2px var(--sp-2);
  border: 1px solid var(--border);
  border-radius: var(--r-full);
  font-family: var(--font-mono);
}

.topbar-breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--sp-2);
  font-size: var(--fs-sm);
  color: var(--text-2);
  margin-left: var(--sp-4);
}

.topbar-breadcrumb .sep {
  color: var(--text-3);
}

.topbar-breadcrumb .current {
  color: var(--text);
  font-weight: var(--fw-medium);
}

.topbar-right {
  margin-left: auto;
  display: flex;
  align-items: center;
  gap: var(--sp-3);
}

.topbar-link {
  display: flex;
  align-items: center;
  gap: var(--sp-2);
  font-size: var(--fs-sm);
  color: var(--text-2);
  padding: var(--sp-2) var(--sp-3);
  border-radius: var(--r-sm);
  transition: all var(--t-fast);
}

.topbar-link:hover {
  color: var(--text);
  background: var(--bg-hover);
}

.topbar-icon-btn {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 36px;
  height: 36px;
  border-radius: var(--r-sm);
  color: var(--text-2);
  transition: all var(--t-fast);
}

.topbar-icon-btn:hover {
  color: var(--text);
  background: var(--bg-hover);
}

/* Mobile menu button */
.menu-btn {
  display: none;
}

@media (max-width: 1023px) {
  .menu-btn {
    display: flex;
  }
}

/* ── Responsive topbar ── */
@media (max-width: 1023px) {
  .topbar-breadcrumb {
    display: none;
  }
}

@media (max-width: 640px) {
  .topbar {
    padding: 0 var(--sp-3);
    gap: var(--sp-2);
  }

  .topbar-version {
    display: none;
  }

  .topbar-brand {
    font-size: var(--fs-base);
  }

  .topbar-brand img {
    width: 24px;
    height: 24px;
  }

  .topbar-link {
    font-size: 0;
    gap: 0;
    padding: var(--sp-2);
  }
}

/* ── Sidebar ── */
.sidebar {
  grid-area: sidebar;
  background: var(--bg-2);
  border-right: 1px solid var(--border);
  overflow-y: auto;
  padding: var(--sp-5) var(--sp-3);
  display: flex;
  flex-direction: column;
  gap: var(--sp-1);
}

@media (max-width: 1023px) {
  .sidebar {
    position: fixed;
    top: var(--topbar-h);
    left: 0;
    bottom: 0;
    width: min(var(--sidebar-w), 85vw);
    z-index: var(--z-modal);
    transform: translateX(-100%);
    transition: transform var(--t-normal);
    box-shadow: var(--shadow-lg);
  }

  .sidebar.open {
    transform: translateX(0);
  }
}

.sidebar-search {
  position: relative;
  margin-bottom: var(--sp-4);
}

.sidebar-search input {
  width: 100%;
  padding: var(--sp-2) var(--sp-3) var(--sp-2) var(--sp-8);
  background: var(--bg-3);
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  color: var(--text);
  font-size: var(--fs-sm);
  outline: none;
  transition: border-color var(--t-fast);
}

.sidebar-search input:focus {
  border-color: var(--brand);
}

.sidebar-search input::placeholder {
  color: var(--text-3);
}

.sidebar-search-icon {
  position: absolute;
  left: var(--sp-3);
  top: 50%;
  transform: translateY(-50%);
  color: var(--text-3);
  font-size: var(--fs-sm);
  pointer-events: none;
}

.sidebar-search-kbd {
  position: absolute;
  right: var(--sp-2);
  top: 50%;
  transform: translateY(-50%);
  font-size: 10px;
  font-family: var(--font-mono);
  color: var(--text-3);
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  padding: 1px 5px;
  pointer-events: none;
}

.sidebar-group {
  margin-top: var(--sp-5);
}

.sidebar-group-title {
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--text-3);
  padding: var(--sp-2) var(--sp-3);
  margin-bottom: var(--sp-1);
}

.sidebar-link {
  display: flex;
  align-items: center;
  gap: var(--sp-2);
  padding: var(--sp-2) var(--sp-3);
  font-size: var(--fs-sm);
  color: var(--text-2);
  border-radius: var(--r-sm);
  transition: all var(--t-fast);
  text-decoration: none;
  line-height: 1.4;
}

.sidebar-link:hover {
  color: var(--text);
  background: var(--bg-hover);
}

.sidebar-link.active {
  color: var(--accent-text);
  background: var(--brand-glow);
  font-weight: var(--fw-medium);
}

.sidebar-link.active::before {
  content: "";
  position: absolute;
  left: 0;
  width: 3px;
  height: 20px;
  background: var(--brand);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
}

/* ── Main content ── */
.main {
  grid-area: main;
  min-width: 0;
  overflow-y: auto;
  display: flex;
  flex-direction: column;
}

/* Lock page scrolling while the mobile drawer is open */
body.drawer-open .main {
  overflow: hidden;
}

.content-wrapper {
  max-width: var(--content-max);
  margin: 0 auto;
  padding: var(--sp-8) var(--sp-6) var(--sp-16);
  flex: 1;
  width: 100%;
}

@media (max-width: 768px) {
  .content-wrapper {
    padding: var(--sp-6) var(--sp-4) var(--sp-12);
  }
}

/* ── TOC (right sidebar) ── */
.toc {
  grid-area: toc;
  min-width: 0;
  overflow-y: auto;
  padding: var(--sp-8) var(--sp-5);
  border-left: 1px solid var(--border);
}

/* TOC is a 3rd grid column only on wide screens; hide it otherwise so it
   doesn't leak into the implicit grid and squeeze the content column. */
@media (max-width: 1279px) {
  .toc {
    display: none;
  }
}

.toc-title {
  font-size: var(--fs-xs);
  font-weight: var(--fw-semibold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--text-3);
  margin-bottom: var(--sp-3);
}

.toc-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.toc-link {
  display: block;
  padding: var(--sp-1) 0 var(--sp-1) var(--sp-3);
  font-size: var(--fs-sm);
  color: var(--text-2);
  border-left: 2px solid transparent;
  transition: all var(--t-fast);
  line-height: 1.4;
}

.toc-link:hover {
  color: var(--text);
}

.toc-link.active {
  color: var(--accent-text);
  border-left-color: var(--brand);
}

.toc-link.level-3 {
  padding-left: var(--sp-6);
  font-size: var(--fs-xs);
}

/* ── Prev/Next footer ── */
.page-footer {
  display: flex;
  justify-content: space-between;
  gap: var(--sp-4);
  margin-top: var(--sp-12);
  padding-top: var(--sp-6);
  border-top: 1px solid var(--border);
}

.page-nav-link {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: var(--sp-3) var(--sp-4);
  border: 1px solid var(--border);
  border-radius: var(--r-md);
  transition: all var(--t-fast);
  max-width: 48%;
}

.page-nav-link:hover {
  border-color: var(--brand);
  background: var(--bg-2);
}

.page-nav-link.next {
  margin-left: auto;
  text-align: right;
}

.page-nav-label {
  font-size: var(--fs-xs);
  color: var(--text-3);
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.page-nav-title {
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
  color: var(--text);
}

/* ── Edit on GitHub ── */
.edit-link {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-2);
  font-size: var(--fs-sm);
  color: var(--text-3);
  margin-top: var(--sp-8);
  transition: color var(--t-fast);
}

.edit-link:hover {
  color: var(--link);
}

/* ── Mobile drawer backdrop ── */
.drawer-backdrop {
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.5);
  z-index: var(--z-overlay);
  opacity: 0;
  transition: opacity var(--t-normal);
  pointer-events: none;
}

.drawer-backdrop.open {
  opacity: 1;
  pointer-events: auto;
}

@media (min-width: 1024px) {
  .drawer-backdrop {
    display: none;
  }
}

/* ============================================================================
   Components — code blocks, callouts, cards, badges, buttons, tables, hero
   ============================================================================ */

/* ── Hero (landing) ── */
.hero {
  text-align: center;
  padding: var(--sp-16) 0 var(--sp-12);
  position: relative;
}

.hero::before {
  content: "";
  position: absolute;
  top: -40px;
  left: 50%;
  transform: translateX(-50%);
  width: 600px;
  height: 400px;
  background: radial-gradient(ellipse at center, var(--brand-glow), transparent 70%);
  pointer-events: none;
  z-index: -1;
}

.hero-eyebrow {
  font-size: var(--fs-sm);
  color: var(--accent-text);
  font-weight: var(--fw-medium);
  margin-bottom: var(--sp-3);
  letter-spacing: 0.04em;
}

.hero h1 {
  font-size: var(--fs-5xl);
  font-weight: var(--fw-bold);
  letter-spacing: -0.04em;
  margin-bottom: var(--sp-5);
  background: linear-gradient(135deg, var(--text), var(--brand-2));
  -webkit-background-clip: text;
  background-clip: text;
  -webkit-text-fill-color: transparent;
}

.hero h1 em {
  font-style: normal;
  color: var(--brand);
  -webkit-text-fill-color: var(--brand);
}

.hero-desc {
  font-size: var(--fs-lg);
  color: var(--text-2);
  max-width: 640px;
  margin: 0 auto var(--sp-8);
  line-height: var(--lh-relaxed);
}

.hero-badges {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  gap: var(--sp-3);
  margin-bottom: var(--sp-8);
}

.hero-actions {
  display: flex;
  gap: var(--sp-3);
  justify-content: center;
  flex-wrap: wrap;
}

/* ── Badges ── */
.badge {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-2);
  padding: var(--sp-1) var(--sp-3);
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
  border-radius: var(--r-full);
  background: var(--bg-card);
  border: 1px solid var(--border);
  color: var(--text-2);
}

.badge-dot {
  width: 8px;
  height: 8px;
  border-radius: 50%;
  flex-shrink: 0;
}

/* ── Buttons ── */
.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-2);
  padding: var(--sp-3) var(--sp-5);
  font-size: var(--fs-base);
  font-weight: var(--fw-semibold);
  border-radius: var(--r-md);
  transition: background var(--t-fast), border-color var(--t-fast), transform var(--t-fast), box-shadow var(--t-fast);
  text-decoration: none;
  border: 1px solid transparent;
  cursor: pointer;
}

.btn-primary {
  background: var(--brand);
  color: #ffffff !important;
  font-weight: 700;
  text-shadow: 0 1px 2px rgba(0, 0, 0, 0.3);
}

.btn-primary:hover {
  background: var(--brand-2);
  color: #ffffff !important;
  transform: translateY(-1px);
  box-shadow: var(--shadow-glow);
}

.btn-outline {
  background: var(--bg-card);
  color: var(--text);
  border-color: var(--border-2);
}

.btn-outline:hover {
  border-color: var(--brand);
  color: var(--text);
  background: var(--bg-hover);
}

.btn-sm {
  padding: var(--sp-2) var(--sp-3);
  font-size: var(--fs-sm);
}

/* ── Cards grid ── */
.cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: var(--sp-4);
  margin: var(--sp-8) 0;
}

.card {
  padding: var(--sp-5);
  background: var(--bg-card);
  border: 1px solid var(--border);
  border-radius: var(--r-lg);
  transition: all var(--t-normal);
}

.card:hover {
  border-color: var(--border-2);
  transform: translateY(-2px);
  box-shadow: var(--shadow-md);
}

.card-icon {
  font-size: var(--fs-2xl);
  margin-bottom: var(--sp-3);
  display: block;
}

.card-title {
  font-size: var(--fs-lg);
  font-weight: var(--fw-semibold);
  margin-bottom: var(--sp-2);
}

.card-desc {
  font-size: var(--fs-sm);
  color: var(--text-2);
  line-height: var(--lh-normal);
}

/* ── Code blocks ── */
.code-block {
  margin: var(--sp-5) 0;
  border-radius: var(--r-md);
  overflow: hidden;
  border: 1px solid var(--border);
  background: var(--bg-code);
}

.code-block-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--sp-2) var(--sp-4);
  background: var(--bg-2);
  border-bottom: 1px solid var(--border);
  font-size: var(--fs-xs);
}

.code-block-lang {
  color: var(--text-3);
  font-family: var(--font-mono);
  font-weight: var(--fw-medium);
}

.code-block-filename {
  color: var(--text-2);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
}

.code-block-copy {
  display: flex;
  align-items: center;
  gap: var(--sp-1);
  padding: var(--sp-1) var(--sp-2);
  font-size: var(--fs-xs);
  color: var(--text-3);
  border-radius: var(--r-sm);
  transition: all var(--t-fast);
}

.code-block-copy:hover {
  color: var(--text);
  background: var(--bg-hover);
}

.code-block-copy.copied {
  color: var(--green);
}

.code-block pre {
  margin: 0;
  padding: var(--sp-4) var(--sp-5);
  overflow-x: auto;
  font-size: var(--fs-sm);
  line-height: var(--lh-normal);
}

.code-block code {
  font-family: var(--font-mono);
  background: none;
  padding: 0;
}

/* Inline code */
.prose code:not(pre code) {
  background: var(--bg-code);
  border: 1px solid var(--border);
  padding: 2px 6px;
  border-radius: var(--r-sm);
  font-size: 0.85em;
  color: var(--accent-text);
}

/* ── Callouts ── */
.callout {
  margin: var(--sp-5) 0;
  padding: var(--sp-4) var(--sp-5);
  border-radius: var(--r-md);
  border-left: 4px solid;
  font-size: var(--fs-sm);
  line-height: var(--lh-relaxed);
}

.callout-title {
  font-weight: var(--fw-semibold);
  margin-bottom: var(--sp-2);
  display: flex;
  align-items: center;
  gap: var(--sp-2);
}

.callout-note {
  background: var(--callout-note-bg);
  border-color: var(--callout-note-border);
}

.callout-note .callout-title {
  color: var(--blue);
}

.callout-tip {
  background: var(--callout-tip-bg);
  border-color: var(--callout-tip-border);
}

.callout-tip .callout-title {
  color: var(--green);
}

.callout-warning {
  background: var(--callout-warn-bg);
  border-color: var(--callout-warn-border);
}

.callout-warning .callout-title {
  color: var(--gold);
}

.callout-danger {
  background: var(--callout-danger-bg);
  border-color: var(--callout-danger-border);
}

.callout-danger .callout-title {
  color: var(--red);
}

.callout p:last-child {
  margin-bottom: 0;
}

/* ── Tables ── */
.table-wrap {
  overflow-x: auto;
  margin: var(--sp-5) 0;
  border: 1px solid var(--border);
  border-radius: var(--r-md);
}

table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--fs-sm);
}

th,
td {
  padding: var(--sp-3) var(--sp-4);
  text-align: left;
  border-bottom: 1px solid var(--border);
}

th {
  background: var(--bg-2);
  font-weight: var(--fw-semibold);
  color: var(--text);
  white-space: nowrap;
}

td {
  color: var(--text-2);
}

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

tr:hover td {
  background: var(--bg-hover);
}

/* ── Tabs ── */
.tabs {
  margin: var(--sp-5) 0;
  border: 1px solid var(--border);
  border-radius: var(--r-md);
  overflow: hidden;
}

.tabs-head {
  display: flex;
  border-bottom: 1px solid var(--border);
  background: var(--bg-2);
}

.tab-btn {
  padding: var(--sp-2) var(--sp-4);
  font-size: var(--fs-sm);
  color: var(--text-2);
  border-bottom: 2px solid transparent;
  transition: all var(--t-fast);
}

.tab-btn:hover {
  color: var(--text);
}

.tab-btn.active {
  color: var(--accent-text);
  border-bottom-color: var(--brand);
}

.tabs-body {
  padding: var(--sp-4) var(--sp-5);
}

/* ── Search modal ── */
.search-modal {
  position: fixed;
  inset: 0;
  z-index: var(--z-modal);
  display: flex;
  align-items: flex-start;
  justify-content: center;
  padding-top: 15vh;
  background: rgba(0, 0, 0, 0.6);
  backdrop-filter: blur(4px);
}

.search-panel {
  width: 90%;
  max-width: 560px;
  background: var(--bg-2);
  border: 1px solid var(--border-2);
  border-radius: var(--r-lg);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
}

.search-input-wrap {
  display: flex;
  align-items: center;
  gap: var(--sp-3);
  padding: var(--sp-4) var(--sp-5);
  border-bottom: 1px solid var(--border);
}

.search-input {
  flex: 1;
  background: none;
  border: none;
  outline: none;
  font-size: var(--fs-lg);
  color: var(--text);
}

.search-input::placeholder {
  color: var(--text-3);
}

.search-results {
  max-height: 400px;
  overflow-y: auto;
  padding: var(--sp-2);
}

.search-result {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: var(--sp-3) var(--sp-4);
  border-radius: var(--r-sm);
  cursor: pointer;
  transition: background var(--t-fast);
}

.search-result:hover,
.search-result.selected {
  background: var(--bg-hover);
}

.search-result-title {
  font-size: var(--fs-sm);
  font-weight: var(--fw-medium);
  color: var(--text);
}

.search-result-section {
  font-size: var(--fs-xs);
  color: var(--text-3);
}

.search-result-excerpt {
  font-size: var(--fs-xs);
  color: var(--text-2);
  margin-top: 2px;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

.search-empty {
  padding: var(--sp-8);
  text-align: center;
  color: var(--text-3);
  font-size: var(--fs-sm);
}

/* ── Theme toggle ── */
.theme-toggle {
  position: relative;
  width: 36px;
  height: 36px;
  border-radius: var(--r-sm);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--text-2);
  transition: all var(--t-fast);
}

.theme-toggle:hover {
  color: var(--text);
  background: var(--bg-hover);
}

.theme-toggle .sun {
  display: none;
}

.theme-toggle .moon {
  display: block;
}

:root[data-theme="light"] .theme-toggle .sun {
  display: block;
}

:root[data-theme="light"] .theme-toggle .moon {
  display: none;
}

/* ── Lead paragraph ── */
.lead {
  font-size: var(--fs-lg);
  color: var(--text-2);
  line-height: var(--lh-relaxed);
  margin-bottom: var(--sp-8);
}

/* ── Anchor link (heading hover) ── */
.anchor-link {
  opacity: 0;
  margin-left: var(--sp-2);
  color: var(--text-3);
  font-size: 0.8em;
  transition: opacity var(--t-fast);
}

h2:hover .anchor-link,
h3:hover .anchor-link {
  opacity: 1;
}

/* ============================================================================
   Prose — styles for rendered Markdown content
   ============================================================================ */

.prose {
  font-size: var(--fs-base);
  line-height: var(--lh-relaxed);
  color: var(--text);
}

.prose h1 {
  font-size: var(--fs-3xl);
  font-weight: var(--fw-bold);
  margin-bottom: var(--sp-3);
  letter-spacing: -0.03em;
}

.prose h2 {
  font-size: var(--fs-2xl);
  font-weight: var(--fw-semibold);
  margin-top: var(--sp-12);
  margin-bottom: var(--sp-4);
  padding-bottom: var(--sp-2);
  border-bottom: 1px solid var(--border);
}

.prose h3 {
  font-size: var(--fs-xl);
  font-weight: var(--fw-semibold);
  margin-top: var(--sp-8);
  margin-bottom: var(--sp-3);
}

.prose h4 {
  font-size: var(--fs-lg);
  font-weight: var(--fw-semibold);
  margin-top: var(--sp-6);
  margin-bottom: var(--sp-2);
}

.prose p {
  margin: var(--sp-4) 0;
  color: var(--text);
}

.prose a {
  color: var(--link);
  text-decoration: underline;
  text-decoration-color: var(--border-2);
  text-underline-offset: 2px;
  transition: text-decoration-color var(--t-fast);
}

.prose a:hover {
  text-decoration-color: var(--link);
}

.prose ul,
.prose ol {
  margin: var(--sp-4) 0;
  padding-left: var(--sp-6);
}

.prose li {
  margin: var(--sp-2) 0;
}

.prose ul li::marker {
  color: var(--brand);
}

.prose ol li::marker {
  color: var(--brand);
  font-weight: var(--fw-medium);
}

.prose code:not(pre code) {
  background: var(--bg-code);
  border: 1px solid var(--border);
  padding: 2px 6px;
  border-radius: var(--r-sm);
  font-size: 0.85em;
  color: var(--accent-text);
  font-family: var(--font-mono);
}

.prose pre {
  margin: var(--sp-5) 0;
  padding: 0;
  background: transparent;
  border: none;
  border-radius: 0;
  overflow-x: auto;
  font-size: var(--fs-sm);
  line-height: var(--lh-normal);
}

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

.prose blockquote {
  border-left: 3px solid var(--brand);
  padding: var(--sp-2) var(--sp-5);
  margin: var(--sp-6) 0;
  color: var(--text-2);
  background: var(--bg-2);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
}

.prose blockquote p {
  margin: var(--sp-2) 0;
}

.prose hr {
  border: none;
  border-top: 1px solid var(--border);
  margin: var(--sp-8) 0;
}

.prose img {
  border-radius: var(--r-md);
  margin: var(--sp-6) auto;
  border: 1px solid var(--border);
}

.prose table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--sp-5) 0;
  font-size: var(--fs-sm);
  border: 1px solid var(--border);
  border-radius: var(--r-md);
  overflow: hidden;
}

.prose th,
.prose td {
  padding: var(--sp-3) var(--sp-4);
  text-align: left;
  border-bottom: 1px solid var(--border);
}

.prose th {
  background: var(--bg-2);
  font-weight: var(--fw-semibold);
}

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

/* ── Shiki syntax highlighting (dual theme via CSS variables) ── */
/* Shiki outputs inline `color:` (dark) and `--shiki-light` (light) on each
   span. In light mode we override `color` with the `--shiki-light` value. */
.shiki {
  background-color: #24292e !important;
  color: #e1e4e8 !important;
  padding: var(--sp-4) var(--sp-5) !important;
  border-radius: var(--r-md) !important;
  overflow-x: auto;
  font-size: 0.875rem;
  line-height: 1.6;
  border: 1px solid var(--border);
  margin: var(--sp-5) 0;
}

.shiki code {
  display: block;
  font-family: var(--font-mono);
  background: none !important;
  padding: 0 !important;
  border: none !important;
}

/* Light theme: use the --shiki-light variable instead of the inline color */
:root[data-theme="light"] .shiki {
  background-color: #f6f8fa !important;
  color: #24292e !important;
  border-color: #d0d7de;
}

:root[data-theme="light"] .shiki span {
  color: var(--shiki-light, inherit) !important;
}

/* ── Responsive tables: scroll horizontally instead of blowing up the layout ── */
@media (max-width: 1023px) {
  .prose table {
    display: block;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }
}