/* =============================================================================
   SYNTECNIA DOCUMENTATION — style.css
   "The language built for AI agents"
   Dark theme · Electric blue #3b82f6 · Violet #8b5cf6
   ============================================================================= */

/* -----------------------------------------------------------------------------
   1. CSS CUSTOM PROPERTIES (DESIGN TOKENS)
   ----------------------------------------------------------------------------- */

:root {
  /* Background layers */
  --bg-base:        #0a0e1a;
  --bg-surface:     #0f1425;
  --bg-elevated:    #151b2e;
  --bg-overlay:     #1a2038;
  --bg-code:        #1a1f35;
  --bg-code-header: #131829;
  --bg-modal:       rgba(10, 14, 26, 0.92);

  /* Accent palette */
  --blue:           #3b82f6;
  --blue-light:     #60a5fa;
  --blue-dark:      #2563eb;
  --violet:         #8b5cf6;
  --violet-light:   #a78bfa;
  --violet-dark:    #7c3aed;
  --cyan:           #06b6d4;
  --green:          #22c55e;
  --amber:          #f59e0b;
  --red:            #ef4444;
  --pink:           #ec4899;
  --orange:         #f59e0b;

  /* Text */
  --text-primary:   #e2e8f0;
  --text-secondary: #94a3b8;
  --text-muted:     #64748b;
  --text-inverse:   #0a0e1a;

  /* Borders */
  --border-subtle:  rgba(255, 255, 255, 0.06);
  --border-default: rgba(255, 255, 255, 0.10);
  --border-strong:  rgba(255, 255, 255, 0.18);
  --border-accent:  rgba(59, 130, 246, 0.40);

  /* Gradients */
  --gradient-hero:   linear-gradient(135deg, #0a0e1a 0%, #0d1530 40%, #110a2e 100%);
  --gradient-accent: linear-gradient(135deg, var(--blue) 0%, var(--violet) 100%);
  --gradient-glow:   radial-gradient(ellipse 80% 60% at 50% -10%, rgba(59,130,246,0.18) 0%, transparent 70%);
  --gradient-card:   linear-gradient(145deg, #151b2e 0%, #111628 100%);

  /* Sidebar */
  --sidebar-width:     280px;
  --sidebar-bg:        #0c1020;
  --sidebar-border:    rgba(255, 255, 255, 0.07);

  /* Spacing */
  --content-max:       900px;
  --spacing-xs:        0.25rem;
  --spacing-sm:        0.5rem;
  --spacing-md:        1rem;
  --spacing-lg:        1.5rem;
  --spacing-xl:        2rem;
  --spacing-2xl:       3rem;
  --spacing-3xl:       4rem;

  /* Typography */
  --font-sans:  'Inter', 'Segoe UI', system-ui, -apple-system, sans-serif;
  --font-mono:  'JetBrains Mono', 'Fira Code', 'Cascadia Code', 'Consolas', monospace;
  --font-size-xs:   0.75rem;
  --font-size-sm:   0.875rem;
  --font-size-base: 1rem;
  --font-size-lg:   1.125rem;
  --font-size-xl:   1.25rem;
  --font-size-2xl:  1.5rem;
  --font-size-3xl:  2rem;
  --font-size-4xl:  2.5rem;
  --font-size-5xl:  3.5rem;
  --line-height:    1.75;

  /* Radius */
  --radius-sm:  4px;
  --radius-md:  8px;
  --radius-lg:  12px;
  --radius-xl:  16px;
  --radius-2xl: 24px;
  --radius-full: 9999px;

  /* Shadows */
  --shadow-sm:   0 1px 3px rgba(0,0,0,0.4);
  --shadow-md:   0 4px 16px rgba(0,0,0,0.5);
  --shadow-lg:   0 8px 32px rgba(0,0,0,0.6);
  --shadow-glow: 0 0 40px rgba(59,130,246,0.12);
  --shadow-card: 0 4px 24px rgba(0,0,0,0.45), inset 0 1px 0 rgba(255,255,255,0.04);

  /* Transitions */
  --transition-fast:   150ms ease;
  --transition-base:   250ms ease;
  --transition-slow:   400ms ease;

  /* Z-index scale */
  --z-sidebar:  100;
  --z-topbar:   110;
  --z-modal:    200;
  --z-toast:    300;
  --z-fab:      150;
}

/* -----------------------------------------------------------------------------
   2. RESET & BASE
   ----------------------------------------------------------------------------- */

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

html {
  scroll-behavior: smooth;
  font-size: 16px;
  -webkit-text-size-adjust: 100%;
}

body {
  font-family: var(--font-sans);
  font-size: var(--font-size-base);
  line-height: var(--line-height);
  color: var(--text-primary);
  background-color: var(--bg-base);
  min-height: 100vh;
  overflow-x: hidden;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

/* Page-load fade-in */
body {
  animation: pageFadeIn 0.5s ease both;
}

@keyframes pageFadeIn {
  from { opacity: 0; transform: translateY(6px); }
  to   { opacity: 1; transform: translateY(0); }
}

/* Scrollbar */
::-webkit-scrollbar              { width: 6px; height: 6px; }
::-webkit-scrollbar-track        { background: var(--bg-base); }
::-webkit-scrollbar-thumb        { background: var(--bg-overlay); border-radius: var(--radius-full); }
::-webkit-scrollbar-thumb:hover  { background: var(--text-muted); }

/* Focus ring */
:focus-visible {
  outline: 2px solid var(--blue);
  outline-offset: 3px;
  border-radius: var(--radius-sm);
}

a {
  color: var(--blue-light);
  text-decoration: none;
  transition: color var(--transition-fast);
}

a:hover { color: #fff; }

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

ul, ol { padding-left: var(--spacing-lg); }

hr {
  border: none;
  border-top: 1px solid var(--border-subtle);
  margin: var(--spacing-2xl) 0;
}

/* -----------------------------------------------------------------------------
   3. TYPOGRAPHY
   ----------------------------------------------------------------------------- */

h1, h2, h3, h4, h5, h6 {
  font-family: var(--font-sans);
  font-weight: 700;
  line-height: 1.25;
  color: var(--text-primary);
  letter-spacing: -0.02em;
}

h1 { font-size: clamp(var(--font-size-3xl), 5vw, var(--font-size-5xl)); }
h2 { font-size: clamp(var(--font-size-2xl), 3vw, var(--font-size-4xl)); margin-top: var(--spacing-3xl); margin-bottom: var(--spacing-lg); }
h3 { font-size: var(--font-size-2xl); margin-top: var(--spacing-2xl); margin-bottom: var(--spacing-md); }
h4 { font-size: var(--font-size-xl); margin-top: var(--spacing-xl); margin-bottom: var(--spacing-sm); }
h5 { font-size: var(--font-size-lg); margin-top: var(--spacing-lg); margin-bottom: var(--spacing-sm); }
h6 { font-size: var(--font-size-base); margin-top: var(--spacing-lg); margin-bottom: var(--spacing-sm); color: var(--text-secondary); }

/* Anchor headings — subtle # on hover */
.content-area h2[id],
.content-area h3[id],
.content-area h4[id] {
  scroll-margin-top: 80px;
  position: relative;
}

.content-area h2[id]::before,
.content-area h3[id]::before,
.content-area h4[id]::before {
  content: '#';
  position: absolute;
  left: -1.4em;
  color: var(--text-muted);
  opacity: 0;
  font-weight: 400;
  transition: opacity var(--transition-fast);
  font-size: 0.85em;
}

.content-area h2[id]:hover::before,
.content-area h3[id]:hover::before,
.content-area h4[id]:hover::before { opacity: 1; }

p { margin-bottom: var(--spacing-md); }

strong { color: #fff; font-weight: 600; }
em     { font-style: italic; }

/* Inline code */
:not(pre) > code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--bg-code);
  color: var(--violet-light);
  padding: 0.15em 0.45em;
  border-radius: var(--radius-sm);
  border: 1px solid var(--border-subtle);
  white-space: nowrap;
}

blockquote {
  border-left: 3px solid var(--blue);
  background: var(--bg-elevated);
  padding: var(--spacing-md) var(--spacing-lg);
  margin: var(--spacing-lg) 0;
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  color: var(--text-secondary);
  font-style: italic;
}

/* Lead paragraph */
.lead {
  font-size: var(--font-size-lg);
  color: var(--text-secondary);
  line-height: 1.8;
  margin-bottom: var(--spacing-xl);
}

/* Gradient text utility */
.gradient-text {
  background: var(--gradient-accent);
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

/* -----------------------------------------------------------------------------
   4. LAYOUT — SHELL (Sidebar + Content)
   ----------------------------------------------------------------------------- */

.doc-shell {
  display: flex;
  min-height: 100vh;
}

/* ---- Sidebar ---- */
.sidebar {
  position: fixed;
  top: 0;
  left: 0;
  bottom: 0;
  width: var(--sidebar-width);
  background: var(--sidebar-bg);
  border-right: 1px solid var(--sidebar-border);
  overflow-y: auto;
  overflow-x: hidden;
  z-index: var(--z-sidebar);
  display: flex;
  flex-direction: column;
  transition: transform var(--transition-base), box-shadow var(--transition-base);
}

.sidebar::-webkit-scrollbar { width: 3px; }

.sidebar-header {
  padding: var(--spacing-lg) var(--spacing-lg) var(--spacing-md);
  border-bottom: 1px solid var(--sidebar-border);
  flex-shrink: 0;
}

.sidebar-logo {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  text-decoration: none;
  margin-bottom: var(--spacing-sm);
}

.sidebar-logo-icon {
  width: 32px;
  height: 32px;
  border-radius: var(--radius-md);
  background: var(--gradient-accent);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 16px;
  color: #fff;
  font-weight: 800;
  flex-shrink: 0;
  box-shadow: 0 0 16px rgba(139, 92, 246, 0.4);
}

.sidebar-logo-name {
  font-size: var(--font-size-lg);
  font-weight: 800;
  color: #fff;
  letter-spacing: -0.03em;
}

.sidebar-version {
  font-size: var(--font-size-xs);
  color: var(--text-muted);
  font-family: var(--font-mono);
  background: var(--bg-elevated);
  padding: 0.2em 0.5em;
  border-radius: var(--radius-sm);
  border: 1px solid var(--border-subtle);
  display: inline-block;
}

/* Sidebar search trigger */
.sidebar-search-btn {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  width: 100%;
  margin-top: var(--spacing-md);
  padding: var(--spacing-sm) var(--spacing-md);
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  color: var(--text-muted);
  font-size: var(--font-size-sm);
  font-family: var(--font-sans);
  cursor: pointer;
  transition: border-color var(--transition-fast), background var(--transition-fast);
  text-align: left;
}

.sidebar-search-btn:hover {
  border-color: var(--border-accent);
  background: var(--bg-overlay);
  color: var(--text-secondary);
}

.sidebar-search-btn .search-icon { flex-shrink: 0; }

.sidebar-search-shortcut {
  margin-left: auto;
  font-size: var(--font-size-xs);
  background: var(--bg-base);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.4em;
  font-family: var(--font-mono);
}

/* Sidebar navigation */
.sidebar-nav { flex: 1; padding: var(--spacing-md) 0 var(--spacing-xl); }

.nav-group { margin-bottom: var(--spacing-sm); }

.nav-group-label {
  padding: var(--spacing-sm) var(--spacing-lg);
  font-size: var(--font-size-xs);
  font-weight: 600;
  letter-spacing: 0.10em;
  text-transform: uppercase;
  color: var(--text-muted);
}

.nav-item {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  padding: 0.45rem var(--spacing-lg);
  font-size: var(--font-size-sm);
  color: var(--text-secondary);
  text-decoration: none;
  border-left: 2px solid transparent;
  transition: color var(--transition-fast), background var(--transition-fast), border-color var(--transition-fast);
  position: relative;
  line-height: 1.4;
}

.nav-item:hover {
  color: var(--text-primary);
  background: rgba(59, 130, 246, 0.06);
  border-left-color: var(--border-default);
}

/* Active nav state — blue left border indicator */
.nav-item.active {
  color: var(--blue-light);
  background: rgba(59, 130, 246, 0.10);
  border-left-color: var(--blue);
  font-weight: 500;
}

.nav-item.active::after {
  content: '';
  position: absolute;
  right: var(--spacing-md);
  width: 5px;
  height: 5px;
  border-radius: 50%;
  background: var(--blue);
  opacity: 0.7;
}

/* Sub-items (nested) */
.nav-sub {
  padding-left: var(--spacing-lg);
  list-style: none;
}

.nav-sub .nav-item {
  font-size: var(--font-size-xs);
  padding-top: 0.35rem;
  padding-bottom: 0.35rem;
  color: var(--text-muted);
}

.nav-sub .nav-item:hover { color: var(--text-primary); }
.nav-sub .nav-item.active { color: var(--blue-light); }

/* Sidebar footer */
.sidebar-footer {
  padding: var(--spacing-md) var(--spacing-lg);
  border-top: 1px solid var(--sidebar-border);
  font-size: var(--font-size-xs);
  color: var(--text-muted);
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  flex-shrink: 0;
}

/* ---- Main content area ---- */
.main-content {
  margin-left: var(--sidebar-width);
  flex: 1;
  min-width: 0;
  display: flex;
  flex-direction: column;
}

/* ---- Top bar ---- */
.topbar {
  position: sticky;
  top: 0;
  z-index: var(--z-topbar);
  background: rgba(10, 14, 26, 0.85);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  border-bottom: 1px solid var(--border-subtle);
  padding: 0 var(--spacing-xl);
  height: 56px;
  display: flex;
  align-items: center;
  gap: var(--spacing-md);
}

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

/* Hamburger (mobile only) */
.hamburger {
  display: none;
  flex-direction: column;
  gap: 4px;
  background: none;
  border: none;
  cursor: pointer;
  padding: var(--spacing-sm);
  border-radius: var(--radius-sm);
  transition: background var(--transition-fast);
}

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

.hamburger-line {
  display: block;
  width: 20px;
  height: 2px;
  background: var(--text-secondary);
  border-radius: var(--radius-full);
  transition: transform var(--transition-base), opacity var(--transition-base);
}

/* Hamburger open state */
.hamburger.open .hamburger-line:nth-child(1) { transform: translateY(6px) rotate(45deg); }
.hamburger.open .hamburger-line:nth-child(2) { opacity: 0; }
.hamburger.open .hamburger-line:nth-child(3) { transform: translateY(-6px) rotate(-45deg); }

/* ---- Breadcrumb ---- */
.breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--spacing-xs);
  font-size: var(--font-size-sm);
  color: var(--text-muted);
  flex-wrap: wrap;
}

.breadcrumb-item { color: var(--text-muted); }
.breadcrumb-item a { color: var(--text-muted); }
.breadcrumb-item a:hover { color: var(--text-secondary); }
.breadcrumb-sep { color: var(--border-strong); font-size: 0.7em; }
.breadcrumb-item:last-child { color: var(--text-secondary); }

/* ---- Content ---- */
.content-area {
  flex: 1;
  max-width: var(--content-max);
  width: 100%;
  margin: 0 auto;
  padding: var(--spacing-2xl) var(--spacing-xl) var(--spacing-3xl);
}

/* Content sections — subtle fade-in on scroll (JS adds .visible) */
.section {
  opacity: 0;
  transform: translateY(12px);
  transition: opacity 0.5s ease, transform 0.5s ease;
}

.section.visible {
  opacity: 1;
  transform: translateY(0);
}

/* -----------------------------------------------------------------------------
   5. HERO SECTION
   ----------------------------------------------------------------------------- */

.hero {
  background: var(--gradient-hero);
  padding: var(--spacing-3xl) var(--spacing-xl) calc(var(--spacing-3xl) + 2rem);
  text-align: center;
  position: relative;
  overflow: hidden;
  border-bottom: 1px solid var(--border-subtle);
}

/* Ambient glow layer */
.hero::before {
  content: '';
  position: absolute;
  inset: 0;
  background: var(--gradient-glow);
  pointer-events: none;
}

/* Animated grid background */
.hero::after {
  content: '';
  position: absolute;
  inset: 0;
  background-image:
    linear-gradient(rgba(59,130,246,0.04) 1px, transparent 1px),
    linear-gradient(90deg, rgba(59,130,246,0.04) 1px, transparent 1px);
  background-size: 40px 40px;
  pointer-events: none;
  mask-image: radial-gradient(ellipse 80% 60% at 50% 0%, black 30%, transparent 80%);
  -webkit-mask-image: radial-gradient(ellipse 80% 60% at 50% 0%, black 30%, transparent 80%);
}

.hero-inner {
  position: relative;
  z-index: 1;
  max-width: 780px;
  margin: 0 auto;
}

.hero-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-xs);
  background: rgba(139, 92, 246, 0.12);
  border: 1px solid rgba(139, 92, 246, 0.30);
  color: var(--violet-light);
  font-size: var(--font-size-xs);
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  padding: 0.35em 0.85em;
  border-radius: var(--radius-full);
  margin-bottom: var(--spacing-lg);
  animation: badgePulse 3s ease-in-out infinite;
}

@keyframes badgePulse {
  0%, 100% { box-shadow: 0 0 0 0 rgba(139,92,246,0); }
  50%       { box-shadow: 0 0 0 6px rgba(139,92,246,0.08); }
}

.hero-badge-dot {
  width: 6px;
  height: 6px;
  border-radius: 50%;
  background: var(--violet);
  animation: dotBlink 2s ease-in-out infinite;
}

@keyframes dotBlink {
  0%, 100% { opacity: 1; }
  50%       { opacity: 0.3; }
}

.hero-title {
  font-size: clamp(2.5rem, 7vw, 4.5rem);
  font-weight: 900;
  letter-spacing: -0.04em;
  line-height: 1.05;
  margin-bottom: var(--spacing-lg);
  color: #fff;
}

.hero-tagline {
  font-size: clamp(var(--font-size-base), 2vw, var(--font-size-xl));
  color: var(--text-secondary);
  max-width: 520px;
  margin: 0 auto var(--spacing-2xl);
  line-height: 1.7;
}

.hero-tagline strong { color: var(--blue-light); font-weight: 500; }

.hero-actions {
  display: flex;
  align-items: center;
  justify-content: center;
  gap: var(--spacing-md);
  flex-wrap: wrap;
}

/* -----------------------------------------------------------------------------
   6. BUTTONS
   ----------------------------------------------------------------------------- */

.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-sm);
  padding: 0.65em 1.4em;
  font-size: var(--font-size-sm);
  font-weight: 600;
  font-family: var(--font-sans);
  border-radius: var(--radius-md);
  border: 1px solid transparent;
  cursor: pointer;
  transition: background var(--transition-fast), box-shadow var(--transition-fast),
              transform var(--transition-fast), border-color var(--transition-fast);
  text-decoration: none;
  line-height: 1.5;
  white-space: nowrap;
}

.btn:active { transform: translateY(1px); }

.btn-primary {
  background: var(--blue);
  color: #fff;
  border-color: var(--blue);
  box-shadow: 0 0 24px rgba(59,130,246,0.30);
}

.btn-primary:hover {
  background: var(--blue-dark);
  color: #fff;
  box-shadow: 0 0 32px rgba(59,130,246,0.50);
}

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

.btn-secondary:hover {
  background: var(--bg-elevated);
  color: #fff;
  border-color: var(--blue);
}

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

.btn-ghost:hover {
  background: var(--bg-elevated);
  color: var(--text-primary);
}

.btn-sm { padding: 0.45em 0.9em; font-size: var(--font-size-xs); }
.btn-lg { padding: 0.8em 1.8em; font-size: var(--font-size-base); }

.btn-icon {
  width: 36px;
  height: 36px;
  padding: 0;
  justify-content: center;
  border-radius: var(--radius-md);
}

/* -----------------------------------------------------------------------------
   7. CODE BLOCKS
   ----------------------------------------------------------------------------- */

.code-block {
  background: var(--bg-code);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  overflow: hidden;
  margin: var(--spacing-lg) 0;
  box-shadow: var(--shadow-md);
}

.code-block-header {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  padding: var(--spacing-sm) var(--spacing-md);
  background: var(--bg-code-header);
  border-bottom: 1px solid var(--border-subtle);
  min-height: 40px;
}

/* Traffic-light dots */
.code-block-dots {
  display: flex;
  gap: 6px;
  flex-shrink: 0;
}

.code-block-dot {
  width: 12px;
  height: 12px;
  border-radius: 50%;
}

.code-block-dot:nth-child(1) { background: #ff5f57; }
.code-block-dot:nth-child(2) { background: #febc2e; }
.code-block-dot:nth-child(3) { background: #28c840; }

.code-block-lang {
  font-size: var(--font-size-xs);
  font-family: var(--font-mono);
  color: var(--text-muted);
  font-weight: 500;
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

.code-block-title {
  font-size: var(--font-size-xs);
  color: var(--text-secondary);
  font-family: var(--font-mono);
  margin-left: var(--spacing-xs);
}

.code-block-actions {
  margin-left: auto;
  display: flex;
  gap: var(--spacing-xs);
}

.code-copy-btn {
  display: flex;
  align-items: center;
  gap: 4px;
  background: none;
  border: 1px solid var(--border-default);
  border-radius: var(--radius-sm);
  color: var(--text-muted);
  font-size: var(--font-size-xs);
  font-family: var(--font-sans);
  padding: 0.25em 0.6em;
  cursor: pointer;
  transition: color var(--transition-fast), border-color var(--transition-fast),
              background var(--transition-fast);
}

.code-copy-btn:hover {
  color: var(--text-primary);
  border-color: var(--border-strong);
  background: var(--bg-overlay);
}

.code-copy-btn.copied {
  color: var(--green);
  border-color: rgba(34, 197, 94, 0.4);
}

pre {
  margin: 0;
  overflow-x: auto;
  padding: var(--spacing-lg);
  font-family: var(--font-mono);
  font-size: var(--font-size-sm);
  line-height: 1.7;
  color: #c9d1d9;
}

pre code {
  background: none !important;
  border: none !important;
  padding: 0 !important;
  color: inherit;
  font-size: inherit;
  white-space: pre;
  border-radius: 0;
}

/* Line numbers */
.code-block.line-numbers pre { padding-left: 0; }

.code-block.line-numbers code {
  display: grid;
  counter-reset: line;
}

.code-block.line-numbers code > span {
  display: flex;
  counter-increment: line;
}

.code-block.line-numbers code > span::before {
  content: counter(line);
  display: inline-block;
  min-width: 2.5em;
  padding-right: 1em;
  text-align: right;
  color: var(--text-muted);
  border-right: 1px solid var(--border-subtle);
  margin-right: 1em;
  user-select: none;
  flex-shrink: 0;
}

/* Highlighted lines */
.code-line-highlight {
  background: rgba(59, 130, 246, 0.08);
  border-left: 2px solid var(--blue);
  display: block;
}

/* -----------------------------------------------------------------------------
   8. SYNTAX HIGHLIGHTING
   ----------------------------------------------------------------------------- */

.kw  { color: var(--violet-light); font-weight: 600; }  /* keyword */
.str { color: var(--green); }                            /* string */
.num { color: var(--orange); }                           /* number */
.cmt { color: #6b7280; font-style: italic; }            /* comment */
.fn  { color: var(--blue-light); }                      /* function */
.op  { color: var(--cyan); }                             /* operator */
.type{ color: var(--pink); }                             /* type */

/* Additional common tokens */
.tok-const   { color: var(--violet-light); font-weight: 600; }
.tok-var     { color: #e2e8f0; }
.tok-attr    { color: var(--blue-light); }
.tok-value   { color: var(--green); }
.tok-tag     { color: var(--red); }
.tok-regex   { color: var(--amber); }
.tok-escape  { color: var(--cyan); }

/* -----------------------------------------------------------------------------
   9. SIDE-BY-SIDE CODE COMPARISON
   ----------------------------------------------------------------------------- */

.code-compare {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--spacing-md);
  margin: var(--spacing-lg) 0;
}

.code-compare .code-block { margin: 0; }

.code-compare-label {
  font-size: var(--font-size-xs);
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  padding: 0.3em 0.6em;
  border-radius: var(--radius-sm);
  margin-left: auto;
  flex-shrink: 0;
}

.code-compare-label.before {
  background: rgba(239, 68, 68, 0.15);
  color: #f87171;
  border: 1px solid rgba(239, 68, 68, 0.25);
}

.code-compare-label.after {
  background: rgba(34, 197, 94, 0.12);
  color: var(--green);
  border: 1px solid rgba(34, 197, 94, 0.25);
}

/* -----------------------------------------------------------------------------
   10. TABS
   ----------------------------------------------------------------------------- */

.tabs {
  margin: var(--spacing-lg) 0;
}

.tab-list {
  display: flex;
  gap: 0;
  border-bottom: 1px solid var(--border-default);
  overflow-x: auto;
  scrollbar-width: none;
}

.tab-list::-webkit-scrollbar { display: none; }

.tab-btn {
  display: flex;
  align-items: center;
  gap: var(--spacing-xs);
  padding: 0.65em 1.2em;
  font-size: var(--font-size-sm);
  font-weight: 500;
  font-family: var(--font-sans);
  color: var(--text-muted);
  background: none;
  border: none;
  border-bottom: 2px solid transparent;
  margin-bottom: -1px;
  cursor: pointer;
  transition: color var(--transition-fast), border-color var(--transition-fast);
  white-space: nowrap;
  flex-shrink: 0;
}

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

.tab-btn.active {
  color: var(--blue-light);
  border-bottom-color: var(--blue);
}

.tab-panel {
  display: none;
  animation: tabFadeIn 0.2s ease;
}

.tab-panel.active { display: block; }

@keyframes tabFadeIn {
  from { opacity: 0; transform: translateY(4px); }
  to   { opacity: 1; transform: translateY(0); }
}

/* Tabs with icon badges */
.tab-badge {
  font-size: var(--font-size-xs);
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-full);
  padding: 0.1em 0.5em;
  color: var(--text-muted);
  line-height: 1.4;
}

.tab-btn.active .tab-badge {
  background: rgba(59,130,246,0.15);
  border-color: rgba(59,130,246,0.3);
  color: var(--blue-light);
}

/* -----------------------------------------------------------------------------
   11. CALLOUT / ADMONITION BOXES
   ----------------------------------------------------------------------------- */

.callout {
  display: flex;
  gap: var(--spacing-md);
  padding: var(--spacing-md) var(--spacing-lg);
  border-radius: var(--radius-lg);
  border: 1px solid;
  margin: var(--spacing-lg) 0;
  line-height: 1.65;
}

.callout-icon {
  font-size: 1.2em;
  flex-shrink: 0;
  margin-top: 0.05em;
}

.callout-body { flex: 1; min-width: 0; }

.callout-title {
  font-weight: 700;
  font-size: var(--font-size-sm);
  letter-spacing: 0.02em;
  margin-bottom: 0.25em;
  text-transform: uppercase;
}

.callout-content { font-size: var(--font-size-sm); }
.callout-content p:last-child { margin-bottom: 0; }

/* Info — blue */
.callout-info {
  background: rgba(59, 130, 246, 0.08);
  border-color: rgba(59, 130, 246, 0.25);
}
.callout-info .callout-title { color: var(--blue-light); }
.callout-info .callout-content { color: #93c5fd; }

/* Warning — amber */
.callout-warning {
  background: rgba(245, 158, 11, 0.08);
  border-color: rgba(245, 158, 11, 0.28);
}
.callout-warning .callout-title { color: #fbbf24; }
.callout-warning .callout-content { color: #fcd34d; }

/* Danger — red */
.callout-danger {
  background: rgba(239, 68, 68, 0.08);
  border-color: rgba(239, 68, 68, 0.28);
}
.callout-danger .callout-title { color: #f87171; }
.callout-danger .callout-content { color: #fca5a5; }

/* Tip — green */
.callout-tip {
  background: rgba(34, 197, 94, 0.07);
  border-color: rgba(34, 197, 94, 0.25);
}
.callout-tip .callout-title { color: #4ade80; }
.callout-tip .callout-content { color: #86efac; }

/* -----------------------------------------------------------------------------
   12. TABLES
   ----------------------------------------------------------------------------- */

.table-wrapper {
  overflow-x: auto;
  margin: var(--spacing-lg) 0;
  border-radius: var(--radius-lg);
  border: 1px solid var(--border-default);
  -webkit-overflow-scrolling: touch;
}

@media (max-width: 640px) {
  .table-wrapper::before {
    content: 'Scroll to see more';
    display: block;
    font-size: var(--font-size-xs);
    color: var(--text-muted);
    text-align: right;
    padding: var(--spacing-xs) var(--spacing-md);
    border-bottom: 1px solid var(--border-subtle);
    background: var(--bg-code-header);
  }
}

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

thead {
  background: var(--bg-code-header);
  position: sticky;
  top: 0;
}

th {
  padding: 0.75rem 1rem;
  text-align: left;
  font-size: var(--font-size-xs);
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--text-muted);
  border-bottom: 1px solid var(--border-default);
  white-space: nowrap;
}

td {
  padding: 0.75rem 1rem;
  color: var(--text-secondary);
  border-bottom: 1px solid var(--border-subtle);
  vertical-align: top;
  line-height: 1.55;
}

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

tbody tr { transition: background var(--transition-fast); }
tbody tr:hover { background: rgba(59, 130, 246, 0.04); }

/* Table cell modifiers */
td code { white-space: nowrap; }

.table-cell-center { text-align: center; }
.table-cell-right  { text-align: right; }
.table-cell-mono   { font-family: var(--font-mono); font-size: 0.8em; }

/* -----------------------------------------------------------------------------
   13. FEATURE CARDS
   ----------------------------------------------------------------------------- */

.cards-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: var(--spacing-lg);
  margin: var(--spacing-xl) 0;
}

.card {
  background: var(--gradient-card);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-xl);
  padding: var(--spacing-xl);
  box-shadow: var(--shadow-card);
  transition: transform var(--transition-base), box-shadow var(--transition-base),
              border-color var(--transition-base);
  position: relative;
  overflow: hidden;
}

.card::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  height: 1px;
  background: linear-gradient(90deg, transparent, rgba(255,255,255,0.08), transparent);
}

.card:hover {
  transform: translateY(-3px);
  box-shadow: 0 12px 40px rgba(0,0,0,0.6), var(--shadow-glow);
  border-color: var(--border-accent);
}

.card-icon {
  width: 44px;
  height: 44px;
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 1.4rem;
  margin-bottom: var(--spacing-md);
  flex-shrink: 0;
}

.card-icon-blue   { background: rgba(59,130,246,0.15);  border: 1px solid rgba(59,130,246,0.25);  }
.card-icon-violet { background: rgba(139,92,246,0.15); border: 1px solid rgba(139,92,246,0.25); }
.card-icon-cyan   { background: rgba(6,182,212,0.12);   border: 1px solid rgba(6,182,212,0.25);   }
.card-icon-green  { background: rgba(34,197,94,0.10);   border: 1px solid rgba(34,197,94,0.22);   }
.card-icon-pink   { background: rgba(236,72,153,0.12);  border: 1px solid rgba(236,72,153,0.25);  }

.card-title {
  font-size: var(--font-size-base);
  font-weight: 700;
  color: #fff;
  margin-bottom: var(--spacing-sm);
}

.card-desc {
  font-size: var(--font-size-sm);
  color: var(--text-muted);
  line-height: 1.65;
  margin: 0;
}

.card-link {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  margin-top: var(--spacing-md);
  font-size: var(--font-size-sm);
  color: var(--blue-light);
  text-decoration: none;
  font-weight: 500;
  transition: gap var(--transition-fast);
}

.card-link:hover { color: #fff; gap: 8px; }

/* Large feature card */
.card-featured {
  grid-column: 1 / -1;
  display: flex;
  gap: var(--spacing-xl);
  align-items: flex-start;
}

@media (max-width: 640px) {
  .card-featured { flex-direction: column; }
}

/* -----------------------------------------------------------------------------
   14. BADGES & TAGS
   ----------------------------------------------------------------------------- */

.badge {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  font-size: var(--font-size-xs);
  font-weight: 600;
  padding: 0.2em 0.6em;
  border-radius: var(--radius-full);
  border: 1px solid;
  line-height: 1.4;
  white-space: nowrap;
  font-family: var(--font-sans);
}

.badge-blue    { background: rgba(59,130,246,0.12); border-color: rgba(59,130,246,0.30); color: var(--blue-light); }
.badge-violet  { background: rgba(139,92,246,0.12); border-color: rgba(139,92,246,0.30); color: var(--violet-light); }
.badge-green   { background: rgba(34,197,94,0.10);  border-color: rgba(34,197,94,0.28);  color: #4ade80; }
.badge-amber   { background: rgba(245,158,11,0.10); border-color: rgba(245,158,11,0.28); color: #fbbf24; }
.badge-red     { background: rgba(239,68,68,0.10);  border-color: rgba(239,68,68,0.28);  color: #f87171; }
.badge-cyan    { background: rgba(6,182,212,0.10);  border-color: rgba(6,182,212,0.28);  color: #22d3ee; }
.badge-pink    { background: rgba(236,72,153,0.10); border-color: rgba(236,72,153,0.28); color: #f472b6; }
.badge-gray    { background: rgba(107,114,128,0.14);border-color: rgba(107,114,128,0.28);color: #9ca3af; }

/* Tag cloud */
.tag-list {
  display: flex;
  flex-wrap: wrap;
  gap: var(--spacing-sm);
  margin: var(--spacing-md) 0;
}

/* Capability type badges — larger */
.capability-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-sm);
  padding: 0.4em 0.9em;
  border-radius: var(--radius-md);
  font-size: var(--font-size-sm);
  font-weight: 600;
  border: 1px solid;
}

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

/* -----------------------------------------------------------------------------
   15. SEARCH MODAL
   ----------------------------------------------------------------------------- */

.search-overlay {
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.7);
  backdrop-filter: blur(4px);
  -webkit-backdrop-filter: blur(4px);
  z-index: var(--z-modal);
  display: flex;
  align-items: flex-start;
  justify-content: center;
  padding-top: clamp(60px, 12vh, 120px);
  padding-left: var(--spacing-md);
  padding-right: var(--spacing-md);
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--transition-base);
}

.search-overlay.open {
  opacity: 1;
  pointer-events: auto;
}

.search-modal {
  width: 100%;
  max-width: 620px;
  background: var(--bg-elevated);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-xl);
  box-shadow: var(--shadow-lg), 0 0 80px rgba(59,130,246,0.12);
  overflow: hidden;
  transform: translateY(-10px) scale(0.98);
  transition: transform var(--transition-base);
}

.search-overlay.open .search-modal {
  transform: translateY(0) scale(1);
}

.search-input-wrap {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  padding: var(--spacing-md) var(--spacing-lg);
  border-bottom: 1px solid var(--border-default);
}

.search-icon-wrap {
  color: var(--text-muted);
  flex-shrink: 0;
}

.search-input {
  flex: 1;
  background: none;
  border: none;
  font-family: var(--font-sans);
  font-size: var(--font-size-base);
  color: var(--text-primary);
  outline: none;
}

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

.search-clear {
  background: none;
  border: none;
  color: var(--text-muted);
  cursor: pointer;
  padding: var(--spacing-xs);
  border-radius: var(--radius-sm);
  transition: color var(--transition-fast), background var(--transition-fast);
}

.search-clear:hover { color: var(--text-primary); background: var(--bg-overlay); }

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

.search-result-group { margin-bottom: var(--spacing-sm); }

.search-result-group-label {
  font-size: var(--font-size-xs);
  font-weight: 600;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  color: var(--text-muted);
  padding: var(--spacing-xs) var(--spacing-sm);
}

.search-result-item {
  display: flex;
  align-items: flex-start;
  gap: var(--spacing-md);
  padding: var(--spacing-sm) var(--spacing-md);
  border-radius: var(--radius-md);
  cursor: pointer;
  text-decoration: none;
  transition: background var(--transition-fast);
}

.search-result-item:hover,
.search-result-item.focused {
  background: rgba(59, 130, 246, 0.10);
}

.search-result-icon {
  width: 32px;
  height: 32px;
  border-radius: var(--radius-sm);
  background: var(--bg-overlay);
  border: 1px solid var(--border-subtle);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--text-muted);
  flex-shrink: 0;
  font-size: 0.9rem;
}

.search-result-title {
  font-size: var(--font-size-sm);
  font-weight: 500;
  color: var(--text-primary);
  margin-bottom: 2px;
}

.search-result-excerpt {
  font-size: var(--font-size-xs);
  color: var(--text-muted);
  line-height: 1.5;
}

.search-result-excerpt mark {
  background: rgba(59, 130, 246, 0.25);
  color: var(--blue-light);
  border-radius: 2px;
  padding: 0 2px;
}

.search-result-path {
  margin-left: auto;
  font-size: var(--font-size-xs);
  font-family: var(--font-mono);
  color: var(--text-muted);
  white-space: nowrap;
  flex-shrink: 0;
}

.search-footer {
  display: flex;
  align-items: center;
  gap: var(--spacing-md);
  padding: var(--spacing-sm) var(--spacing-lg);
  border-top: 1px solid var(--border-subtle);
  font-size: var(--font-size-xs);
  color: var(--text-muted);
}

.search-footer kbd {
  font-family: var(--font-mono);
  background: var(--bg-overlay);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.4em;
  font-size: 0.85em;
}

.search-no-results {
  padding: var(--spacing-2xl);
  text-align: center;
  color: var(--text-muted);
  font-size: var(--font-size-sm);
}

/* -----------------------------------------------------------------------------
   16. BACK TO TOP BUTTON (FAB)
   ----------------------------------------------------------------------------- */

.back-to-top {
  position: fixed;
  bottom: var(--spacing-xl);
  right: var(--spacing-xl);
  z-index: var(--z-fab);
  width: 44px;
  height: 44px;
  border-radius: var(--radius-full);
  background: var(--bg-elevated);
  border: 1px solid var(--border-strong);
  color: var(--text-secondary);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: var(--shadow-md);
  opacity: 0;
  transform: translateY(12px);
  pointer-events: none;
  transition: opacity var(--transition-base), transform var(--transition-base),
              background var(--transition-fast), border-color var(--transition-fast),
              color var(--transition-fast), box-shadow var(--transition-fast);
}

.back-to-top.visible {
  opacity: 1;
  transform: translateY(0);
  pointer-events: auto;
}

.back-to-top:hover {
  background: var(--blue);
  border-color: var(--blue);
  color: #fff;
  box-shadow: 0 0 20px rgba(59,130,246,0.40);
}

/* -----------------------------------------------------------------------------
   17. FOOTER
   ----------------------------------------------------------------------------- */

.site-footer {
  background: var(--sidebar-bg);
  border-top: 1px solid var(--border-subtle);
  padding: var(--spacing-2xl) var(--spacing-xl);
  margin-top: auto;
}

.footer-inner {
  max-width: 1100px;
  margin: 0 auto;
  display: grid;
  grid-template-columns: 1.5fr repeat(3, 1fr);
  gap: var(--spacing-2xl);
}

.footer-brand .sidebar-logo { margin-bottom: var(--spacing-md); }

.footer-tagline {
  font-size: var(--font-size-sm);
  color: var(--text-muted);
  line-height: 1.65;
  margin-bottom: var(--spacing-md);
}

.footer-social {
  display: flex;
  gap: var(--spacing-sm);
}

.footer-social-link {
  width: 34px;
  height: 34px;
  border-radius: var(--radius-md);
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--text-muted);
  transition: background var(--transition-fast), color var(--transition-fast),
              border-color var(--transition-fast);
}

.footer-social-link:hover {
  background: var(--bg-overlay);
  color: var(--text-primary);
  border-color: var(--border-strong);
}

.footer-col-title {
  font-size: var(--font-size-xs);
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-secondary);
  margin-bottom: var(--spacing-md);
}

.footer-links { list-style: none; padding: 0; }

.footer-links li { margin-bottom: var(--spacing-sm); }

.footer-links a {
  font-size: var(--font-size-sm);
  color: var(--text-muted);
  transition: color var(--transition-fast);
}

.footer-links a:hover { color: var(--text-primary); }

.footer-bottom {
  max-width: 1100px;
  margin: var(--spacing-xl) auto 0;
  padding-top: var(--spacing-lg);
  border-top: 1px solid var(--border-subtle);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--spacing-md);
  flex-wrap: wrap;
}

.footer-copy {
  font-size: var(--font-size-xs);
  color: var(--text-muted);
}

.footer-bottom-links {
  display: flex;
  gap: var(--spacing-lg);
}

.footer-bottom-links a {
  font-size: var(--font-size-xs);
  color: var(--text-muted);
}

.footer-bottom-links a:hover { color: var(--text-secondary); }

/* -----------------------------------------------------------------------------
   18. PREV / NEXT PAGE NAVIGATION
   ----------------------------------------------------------------------------- */

.doc-nav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--spacing-md);
  margin-top: var(--spacing-3xl);
  padding-top: var(--spacing-xl);
  border-top: 1px solid var(--border-subtle);
}

.doc-nav-link {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: var(--spacing-lg);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-lg);
  text-decoration: none;
  transition: border-color var(--transition-fast), background var(--transition-fast);
  background: var(--bg-surface);
}

.doc-nav-link:hover {
  border-color: var(--border-accent);
  background: var(--bg-elevated);
}

.doc-nav-link.next { text-align: right; }

.doc-nav-label {
  font-size: var(--font-size-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--text-muted);
}

.doc-nav-title {
  font-size: var(--font-size-sm);
  font-weight: 600;
  color: var(--text-primary);
}

/* -----------------------------------------------------------------------------
   19. TABLE OF CONTENTS (in-page, right side)
   ----------------------------------------------------------------------------- */

.toc-aside {
  position: sticky;
  top: 80px;
  width: 200px;
  flex-shrink: 0;
  align-self: flex-start;
  font-size: var(--font-size-xs);
  display: none;
}

@media (min-width: 1280px) {
  .toc-aside { display: block; }

  .doc-layout {
    display: flex;
    gap: var(--spacing-2xl);
    align-items: flex-start;
  }

  .doc-layout .content-area { flex: 1; }
}

.toc-title {
  font-size: var(--font-size-xs);
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-muted);
  margin-bottom: var(--spacing-md);
}

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

.toc-item { padding: 0.25em 0; }

.toc-link {
  color: var(--text-muted);
  font-size: var(--font-size-xs);
  line-height: 1.5;
  display: block;
  border-left: 2px solid transparent;
  padding-left: var(--spacing-sm);
  transition: color var(--transition-fast), border-color var(--transition-fast);
}

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

.toc-link.active {
  color: var(--blue-light);
  border-left-color: var(--blue);
}

.toc-link.depth-3 { padding-left: calc(var(--spacing-sm) + 0.75rem); font-size: 0.7rem; }

/* -----------------------------------------------------------------------------
   20. UTILITY CLASSES
   ----------------------------------------------------------------------------- */

/* Spacing */
.mt-0  { margin-top: 0 !important; }
.mt-sm { margin-top: var(--spacing-sm); }
.mt-md { margin-top: var(--spacing-md); }
.mt-lg { margin-top: var(--spacing-lg); }
.mt-xl { margin-top: var(--spacing-xl); }
.mb-0  { margin-bottom: 0 !important; }
.mb-sm { margin-bottom: var(--spacing-sm); }
.mb-md { margin-bottom: var(--spacing-md); }
.mb-lg { margin-bottom: var(--spacing-lg); }
.mb-xl { margin-bottom: var(--spacing-xl); }

/* Text alignment */
.text-left   { text-align: left; }
.text-center { text-align: center; }
.text-right  { text-align: right; }

/* Text colors */
.text-primary   { color: var(--text-primary) !important; }
.text-secondary { color: var(--text-secondary) !important; }
.text-muted     { color: var(--text-muted) !important; }
.text-blue      { color: var(--blue-light) !important; }
.text-violet    { color: var(--violet-light) !important; }
.text-green     { color: var(--green) !important; }
.text-amber     { color: var(--amber) !important; }
.text-red       { color: var(--red) !important; }

/* Display */
.flex        { display: flex; }
.inline-flex { display: inline-flex; }
.grid        { display: grid; }
.hidden      { display: none; }

/* Flex utilities */
.items-center   { align-items: center; }
.items-start    { align-items: flex-start; }
.justify-center { justify-content: center; }
.gap-sm         { gap: var(--spacing-sm); }
.gap-md         { gap: var(--spacing-md); }
.gap-lg         { gap: var(--spacing-lg); }
.flex-wrap      { flex-wrap: wrap; }

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

/* Divider with label */
.divider {
  display: flex;
  align-items: center;
  gap: var(--spacing-md);
  margin: var(--spacing-xl) 0;
  color: var(--text-muted);
  font-size: var(--font-size-xs);
}

.divider::before,
.divider::after {
  content: '';
  flex: 1;
  border-top: 1px solid var(--border-subtle);
}

/* Keyboard shortcut */
kbd {
  font-family: var(--font-mono);
  font-size: 0.8em;
  background: var(--bg-elevated);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-sm);
  padding: 0.15em 0.5em;
  color: var(--text-secondary);
  box-shadow: 0 1px 0 var(--border-strong);
}

/* Step list */
.steps {
  list-style: none;
  padding: 0;
  margin: var(--spacing-lg) 0;
  counter-reset: step;
}

.steps > li {
  display: flex;
  gap: var(--spacing-md);
  padding-bottom: var(--spacing-lg);
  position: relative;
  counter-increment: step;
}

.steps > li::before {
  content: counter(step);
  width: 28px;
  height: 28px;
  border-radius: 50%;
  background: var(--gradient-accent);
  color: #fff;
  font-size: var(--font-size-xs);
  font-weight: 800;
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
  margin-top: 0.1em;
}

.steps > li:not(:last-child)::after {
  content: '';
  position: absolute;
  left: 13px;
  top: 30px;
  bottom: 0;
  width: 1px;
  background: var(--border-default);
}

.steps > li > div { flex: 1; }

/* -----------------------------------------------------------------------------
   21. MOBILE SIDEBAR OVERLAY
   ----------------------------------------------------------------------------- */

.sidebar-backdrop {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0,0,0,0.6);
  backdrop-filter: blur(2px);
  z-index: calc(var(--z-sidebar) - 1);
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--transition-base);
}

/* -----------------------------------------------------------------------------
   22. RESPONSIVE — MOBILE FIRST
   ----------------------------------------------------------------------------- */

@media (max-width: 1023px) {
  /* Sidebar becomes off-canvas drawer */
  .sidebar {
    transform: translateX(-100%);
    box-shadow: none;
    width: min(var(--sidebar-width), 85vw);
  }

  .sidebar.open {
    transform: translateX(0);
    box-shadow: 24px 0 80px rgba(0,0,0,0.7);
  }

  .sidebar-backdrop { display: block; }
  .sidebar-backdrop.open { opacity: 1; pointer-events: auto; }

  /* Main content takes full width */
  .main-content { margin-left: 0; }

  /* Show hamburger */
  .hamburger { display: flex; }

  .content-area {
    padding: var(--spacing-lg) var(--spacing-md) var(--spacing-2xl);
  }

  .footer-inner {
    grid-template-columns: 1fr 1fr;
    gap: var(--spacing-xl);
  }

  .footer-brand {
    grid-column: 1 / -1;
  }

  .back-to-top {
    bottom: var(--spacing-md);
    right: var(--spacing-md);
  }

  .code-compare {
    grid-template-columns: 1fr;
  }
}

@media (max-width: 640px) {
  .hero {
    padding: var(--spacing-2xl) var(--spacing-md) var(--spacing-2xl);
  }

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

  .hero-actions .btn { width: 100%; justify-content: center; }

  .cards-grid {
    grid-template-columns: 1fr;
  }

  .doc-nav {
    grid-template-columns: 1fr;
  }

  .footer-inner {
    grid-template-columns: 1fr;
  }

  table { font-size: var(--font-size-xs); }

  h2 { font-size: var(--font-size-2xl); }
  h3 { font-size: var(--font-size-xl); }
}

@media (min-width: 1024px) {
  .topbar { padding-left: var(--spacing-2xl); padding-right: var(--spacing-2xl); }

  .content-area {
    padding: var(--spacing-2xl) var(--spacing-2xl) var(--spacing-3xl);
  }
}

/* -----------------------------------------------------------------------------
   23. PRINT STYLES
   ----------------------------------------------------------------------------- */

@media print {
  * {
    color: #000 !important;
    background: #fff !important;
    box-shadow: none !important;
    text-shadow: none !important;
  }

  body {
    font-family: Georgia, serif;
    font-size: 11pt;
    line-height: 1.5;
  }

  .sidebar,
  .topbar,
  .back-to-top,
  .search-overlay,
  .sidebar-backdrop,
  .hamburger,
  .doc-nav,
  .site-footer,
  .tab-list,
  .code-block-actions { display: none !important; }

  .main-content { margin-left: 0 !important; }

  .content-area {
    max-width: 100% !important;
    padding: 0 !important;
  }

  h1, h2, h3, h4 { page-break-after: avoid; }
  pre, .code-block { page-break-inside: avoid; }

  a[href]::after {
    content: ' (' attr(href) ')';
    font-size: 0.85em;
    color: #555 !important;
  }

  a[href^="#"]::after { content: ''; }

  .callout {
    border: 1pt solid #aaa !important;
    background: #f9f9f9 !important;
  }

  .callout-title,
  .callout-content { color: #000 !important; }

  pre {
    border: 1pt solid #ccc !important;
    font-size: 9pt;
    overflow: visible;
    white-space: pre-wrap;
    word-break: break-all;
  }

  table { border-collapse: collapse; }
  th, td { border: 1pt solid #ccc !important; }

  .badge { border: 1pt solid #999 !important; }

  @page {
    margin: 2cm;
  }
}

/* -----------------------------------------------------------------------------
   24. REDUCED MOTION
   ----------------------------------------------------------------------------- */

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

  html { scroll-behavior: auto; }
}

/* -----------------------------------------------------------------------------
   25. MISCELLANEOUS COMPONENTS
   ----------------------------------------------------------------------------- */

/* Inline definition */
.definition {
  border-bottom: 1px dashed var(--text-muted);
  cursor: help;
}

/* Version selector */
.version-select {
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  color: var(--text-secondary);
  font-size: var(--font-size-sm);
  font-family: var(--font-sans);
  padding: 0.4em 0.7em;
  cursor: pointer;
  transition: border-color var(--transition-fast);
  outline: none;
}

.version-select:hover,
.version-select:focus { border-color: var(--border-accent); }

/* On-this-page select (mobile) */
.page-toc-select {
  display: none;
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-md);
  color: var(--text-secondary);
  font-size: var(--font-size-sm);
  font-family: var(--font-sans);
  padding: 0.4em 0.7em;
  max-width: 200px;
  outline: none;
  cursor: pointer;
}

@media (max-width: 1023px) {
  .page-toc-select { display: block; }
}

/* Chip list */
.chip-list {
  display: flex;
  flex-wrap: wrap;
  gap: 6px;
  margin: var(--spacing-sm) 0;
}

.chip {
  display: inline-flex;
  align-items: center;
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-full);
  padding: 0.2em 0.75em;
  font-size: var(--font-size-xs);
  color: var(--text-secondary);
  font-family: var(--font-mono);
  gap: 4px;
}

/* Property/parameter documentation row */
.param-row {
  display: grid;
  grid-template-columns: 1fr 3fr;
  gap: var(--spacing-md);
  padding: var(--spacing-md) 0;
  border-bottom: 1px solid var(--border-subtle);
  align-items: baseline;
}

.param-row:last-child { border-bottom: none; }

.param-name {
  font-family: var(--font-mono);
  font-size: var(--font-size-sm);
  color: var(--blue-light);
  font-weight: 600;
}

.param-required {
  font-size: var(--font-size-xs);
  color: var(--red);
  margin-left: var(--spacing-xs);
}

.param-optional {
  font-size: var(--font-size-xs);
  color: var(--text-muted);
  margin-left: var(--spacing-xs);
}

.param-type {
  display: inline-block;
  margin-bottom: var(--spacing-xs);
}

.param-desc {
  font-size: var(--font-size-sm);
  color: var(--text-secondary);
  line-height: 1.6;
}

/* Stat / metric display */
.stat-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
  gap: var(--spacing-md);
  margin: var(--spacing-xl) 0;
}

.stat-box {
  background: var(--bg-elevated);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-lg);
  padding: var(--spacing-lg);
  text-align: center;
}

.stat-value {
  font-size: var(--font-size-3xl);
  font-weight: 900;
  letter-spacing: -0.03em;
  line-height: 1;
  margin-bottom: var(--spacing-xs);
}

.stat-label {
  font-size: var(--font-size-xs);
  color: var(--text-muted);
  text-transform: uppercase;
  letter-spacing: 0.07em;
  font-weight: 600;
}

/* Typing cursor */
.typing-cursor {
  display: inline-block;
  width: 2px;
  height: 1em;
  background: var(--blue);
  vertical-align: text-bottom;
  margin-left: 2px;
  animation: blink 1s step-end infinite;
}

@keyframes blink {
  0%, 100% { opacity: 1; }
  50%       { opacity: 0; }
}

/* AI agent pulse ring */
.agent-pulse {
  position: relative;
  display: inline-flex;
  align-items: center;
  justify-content: center;
}

.agent-pulse::before {
  content: '';
  position: absolute;
  inset: -4px;
  border-radius: 50%;
  border: 1px solid rgba(59, 130, 246, 0.4);
  animation: agentRing 2.5s ease-out infinite;
}

.agent-pulse::after {
  content: '';
  position: absolute;
  inset: -8px;
  border-radius: 50%;
  border: 1px solid rgba(139, 92, 246, 0.2);
  animation: agentRing 2.5s ease-out infinite 0.5s;
}

@keyframes agentRing {
  0%   { transform: scale(0.8); opacity: 0.8; }
  100% { transform: scale(1.5); opacity: 0; }
}

/* Glow border utilities */
.glow-blue   { box-shadow: 0 0 20px rgba(59,130,246,0.3), 0 0 40px rgba(59,130,246,0.1); }
.glow-violet { box-shadow: 0 0 20px rgba(139,92,246,0.3), 0 0 40px rgba(139,92,246,0.1); }

/* Announcement banner */
.announcement-bar {
  background: linear-gradient(90deg, rgba(59,130,246,0.15), rgba(139,92,246,0.15));
  border-bottom: 1px solid rgba(139,92,246,0.20);
  padding: 0.6em var(--spacing-xl);
  text-align: center;
  font-size: var(--font-size-sm);
  color: var(--text-secondary);
  position: relative;
}

.announcement-bar a {
  color: var(--blue-light);
  font-weight: 600;
}

.announcement-bar a:hover { color: #fff; }

.announcement-dismiss {
  position: absolute;
  right: var(--spacing-md);
  top: 50%;
  transform: translateY(-50%);
  background: none;
  border: none;
  color: var(--text-muted);
  cursor: pointer;
  font-size: 1.2em;
  line-height: 1;
  padding: 0.2em;
}

/* =============================================================================
   END OF SYNTECNIA DOCUMENTATION CSS
   ============================================================================= */