/* ===== CSS Variables ===== */
:root {
  /* Colors - Light Mode */
  --color-primary: #6366f1;
  --color-primary-dark: #4f46e5;
  --color-secondary: #8b5cf6;
  --color-accent: #06b6d4;
  --color-success: #10b981;
  --color-warning: #f59e0b;
  --color-error: #ef4444;

  --color-bg: #ffffff;
  --color-bg-secondary: #f8fafc;
  --color-bg-tertiary: #f1f5f9;
  --color-surface: #ffffff;
  --color-surface-hover: #f8fafc;

  --color-text: #1e293b;
  --color-text-secondary: #64748b;
  --color-text-tertiary: #94a3b8;
  --color-border: #e2e8f0;
  --color-border-light: #f1f5f9;

  /* Typography */
  --font-family-base: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
  --font-family-mono: 'SF Mono', 'Monaco', 'Inconsolata', 'Roboto Mono', 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: 1.875rem;
  --font-size-4xl: 2.25rem;
  --font-size-5xl: 3rem;

  --font-weight-normal: 400;
  --font-weight-medium: 500;
  --font-weight-semibold: 600;
  --font-weight-bold: 700;

  --line-height-tight: 1.25;
  --line-height-normal: 1.5;
  --line-height-relaxed: 1.75;

  /* Spacing */
  --spacing-1: 0.25rem;
  --spacing-2: 0.5rem;
  --spacing-3: 0.75rem;
  --spacing-4: 1rem;
  --spacing-5: 1.25rem;
  --spacing-6: 1.5rem;
  --spacing-8: 2rem;
  --spacing-10: 2.5rem;
  --spacing-12: 3rem;
  --spacing-16: 4rem;
  --spacing-20: 5rem;

  /* Shadows */
  --shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);
  --shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
  --shadow-xl: 0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1);

  /* Border Radius */
  --radius-sm: 0.25rem;
  --radius-md: 0.375rem;
  --radius-lg: 0.5rem;
  --radius-xl: 0.75rem;
  --radius-2xl: 1rem;

  /* Transitions */
  --transition-fast: 150ms ease;
  --transition-normal: 250ms ease;
  --transition-slow: 350ms ease;
}

/* Dark Mode */
[data-theme="dark"] {
  --color-bg: #0f172a;
  --color-bg-secondary: #1e293b;
  --color-bg-tertiary: #334155;
  --color-surface: #1e293b;
  --color-surface-hover: #334155;

  --color-text: #f1f5f9;
  --color-text-secondary: #cbd5e1;
  --color-text-tertiary: #94a3b8;
  --color-border: #334155;
  --color-border-light: #1e293b;
}

/* ===== Base Styles ===== */
* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

html {
  font-size: 16px;
  scroll-behavior: smooth;
}

body {
  font-family: var(--font-family-base);
  font-size: var(--font-size-base);
  line-height: var(--line-height-normal);
  color: var(--color-text);
  background-color: var(--color-bg);
  transition: background-color var(--transition-normal), color var(--transition-normal);
}

img {
  max-width: 100%;
  height: auto;
}

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

a:hover {
  color: var(--color-primary-dark);
}

/* ===== Layout ===== */
.container {
  max-width: 1280px;
  margin: 0 auto;
  padding: 0 var(--spacing-4);
}

header {
  background-color: var(--color-surface);
  border-bottom: 1px solid var(--color-border);
  padding: var(--spacing-4) 0;
  position: sticky;
  top: 0;
  z-index: 100;
  backdrop-filter: blur(8px);
}

header .container {
  display: flex;
  justify-content: space-between;
  align-items: center;
}

main {
  min-height: calc(100vh - 200px);
  padding: var(--spacing-12) 0;
}

/* ===== Typography ===== */
h1, h2, h3, h4, h5, h6 {
  font-weight: var(--font-weight-bold);
  line-height: var(--line-height-tight);
  margin-bottom: var(--spacing-4);
  color: var(--color-text);
}

h1 { font-size: var(--font-size-5xl); }
h2 { font-size: var(--font-size-4xl); }
h3 { font-size: var(--font-size-3xl); }
h4 { font-size: var(--font-size-2xl); }
h5 { font-size: var(--font-size-xl); }
h6 { font-size: var(--font-size-lg); }

p {
  margin-bottom: var(--spacing-4);
  color: var(--color-text-secondary);
}

/* ===== Cards ===== */
.card {
  background-color: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-xl);
  padding: var(--spacing-6);
  transition: all var(--transition-normal);
}

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

/* ===== Buttons ===== */
.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: var(--spacing-3) var(--spacing-6);
  font-size: var(--font-size-base);
  font-weight: var(--font-weight-medium);
  border-radius: var(--radius-lg);
  border: none;
  cursor: pointer;
  transition: all var(--transition-fast);
  text-decoration: none;
}

.btn-primary {
  background-color: var(--color-primary);
  color: white;
}

.btn-primary:hover {
  background-color: var(--color-primary-dark);
  color: white;
  transform: translateY(-1px);
  box-shadow: var(--shadow-md);
}

.btn-secondary {
  background-color: var(--color-surface);
  color: var(--color-text);
  border: 1px solid var(--color-border);
}

.btn-secondary:hover {
  background-color: var(--color-bg-secondary);
  border-color: var(--color-primary);
}

/* ===== Hero Section ===== */
.hero {
  text-align: center;
  padding: var(--spacing-20) 0;
}

.hero h1 {
  font-size: var(--font-size-5xl);
  margin-bottom: var(--spacing-6);
  background: linear-gradient(135deg, var(--color-primary), var(--color-secondary));
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

.hero p {
  font-size: var(--font-size-xl);
  color: var(--color-text-secondary);
  max-width: 600px;
  margin: 0 auto var(--spacing-8);
}

/* ===== Grid Layout ===== */
.grid {
  display: grid;
  gap: var(--spacing-6);
}

.grid-2 { grid-template-columns: repeat(2, 1fr); }
.grid-3 { grid-template-columns: repeat(3, 1fr); }

/* ===== Utilities ===== */
.text-center { text-align: center; }
.text-left { text-align: left; }
.text-right { text-align: right; }

.mb-0 { margin-bottom: 0; }
.mb-4 { margin-bottom: var(--spacing-4); }
.mb-6 { margin-bottom: var(--spacing-6); }
.mb-8 { margin-bottom: var(--spacing-8); }

.mt-4 { margin-top: var(--spacing-4); }
.mt-8 { margin-top: var(--spacing-8); }

/* ===== Theme Toggle ===== */
.theme-toggle {
  background: none;
  border: none;
  cursor: pointer;
  padding: var(--spacing-2);
  border-radius: var(--radius-md);
  color: var(--color-text);
  transition: background-color var(--transition-fast);
}

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

/* ===== Responsive ===== */
@media (max-width: 768px) {
  .hero h1 { font-size: var(--font-size-4xl); }
  .grid-2, .grid-3 { grid-template-columns: 1fr; }
  .container { padding: 0 var(--spacing-3); }
}

/* ===== Logo and Footer Styles ===== */
.logo-text {
  font-size: var(--font-size-xl);
  font-weight: var(--font-weight-bold);
  color: var(--color-primary);
  text-decoration: none;
}

.footer-link {
  color: var(--color-text);
  text-decoration: none;
}

.footer-link:hover {
  text-decoration: underline;
}

/* ===== Docs Three-Column Layout ===== */
.docs-layout {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr) 220px;
  gap: var(--spacing-8);
  max-width: 1400px;
  margin: 0 auto;
  align-items: start;
}

.docs-sidebar-left,
.docs-sidebar-right {
  position: sticky;
  top: calc(60px + var(--spacing-4));
  max-height: calc(100vh - 100px);
  overflow-y: auto;
  padding: var(--spacing-4);
  background-color: var(--color-surface);
  border-radius: var(--radius-lg);
  border: 1px solid var(--color-border);
}

/* Left sidebar nav styles */
.docs-nav-header {
  margin-bottom: var(--spacing-6);
  padding-bottom: var(--spacing-4);
  border-bottom: 1px solid var(--color-border);
}
.docs-nav-back {
  font-size: var(--font-size-sm);
  color: var(--color-text-secondary);
  text-decoration: none;
  display: inline-flex;
  align-items: center;
  gap: var(--spacing-2);
  transition: color var(--transition-fast);
}
.docs-nav-back:hover { color: var(--color-primary); }

.docs-nav-section { margin-bottom: var(--spacing-6); }
.docs-nav-section-title {
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-tertiary);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  margin-bottom: var(--spacing-3);
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: var(--spacing-2);
}
.docs-nav-section-title:hover { color: var(--color-primary); }
.docs-nav-chevron {
  transition: transform var(--transition-fast);
  opacity: 0.5;
}
.docs-nav-section.collapsed .docs-nav-chevron { transform: rotate(-90deg); }
.docs-nav-section.collapsed .docs-nav-list { display: none; }
.docs-nav-list { list-style: none; }
.docs-nav-link {
  display: block;
  padding: var(--spacing-2) var(--spacing-3);
  color: var(--color-text-secondary);
  font-size: var(--font-size-sm);
  border-radius: var(--radius-md);
  transition: all var(--transition-fast);
}
.docs-nav-link:hover { background-color: var(--color-bg-secondary); color: var(--color-primary); }
.docs-nav-link[aria-current="page"] { background-color: var(--color-primary); color: white; }

/* TOC styles */
.docs-toc-title {
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-semibold);
  color: var(--color-text-tertiary);
  margin-bottom: var(--spacing-3);
}
.docs-toc-list { list-style: none; border-left: 2px solid var(--color-border); }
.docs-toc-item { margin-bottom: var(--spacing-1); }
.docs-toc-link {
  display: block;
  padding: var(--spacing-1) var(--spacing-3);
  color: var(--color-text-secondary);
  font-size: var(--font-size-sm);
  border-left: 2px solid transparent;
  margin-left: -2px;
  transition: all var(--transition-fast);
}
.docs-toc-link:hover { color: var(--color-primary); }
.docs-toc-link.active { border-left-color: var(--color-primary); color: var(--color-primary); font-weight: var(--font-weight-medium); }
.docs-toc-h3 { padding-left: var(--spacing-6); }

/* Main content */
.docs-content {
  background-color: var(--color-surface);
  border-radius: var(--radius-lg);
  padding: var(--spacing-12);
  border: 1px solid var(--color-border);
  min-height: 600px;
}
.docs-content h1 { margin-top: 0; font-size: var(--font-size-4xl); margin-bottom: var(--spacing-6); }

/* Prev/Next Navigation */
.docs-nav-pagination {
  margin-top: var(--spacing-16);
  padding-top: var(--spacing-8);
  border-top: 1px solid var(--color-border);
  display: flex;
  justify-content: space-between;
  gap: var(--spacing-4);
}
.docs-nav-pagination a {
  display: flex;
  flex-direction: column;
  gap: var(--spacing-1);
  padding: var(--spacing-4);
  background-color: var(--color-bg-secondary);
  border-radius: var(--radius-lg);
  text-decoration: none;
  color: var(--color-text);
  transition: all var(--transition-fast);
  flex: 1;
}
.docs-nav-pagination a:hover { background-color: var(--color-primary); color: white; transform: translateY(-2px); }
.docs-nav-pagination .nav-direction {
  font-size: var(--font-size-xs);
  color: var(--color-text-tertiary);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}
.docs-nav-pagination a:hover .nav-direction { color: rgba(255,255,255,0.8); }
.docs-nav-pagination .nav-title {
  font-size: var(--font-size-sm);
  font-weight: var(--font-weight-medium);
}

/* Mobile menu & TOC buttons */
.docs-menu-toggle,
.docs-toc-toggle {
  display: none;
  background: none;
  border: 1px solid var(--color-border);
  padding: var(--spacing-2);
  border-radius: var(--radius-md);
  cursor: pointer;
  color: var(--color-text);
  align-items: center;
  gap: var(--spacing-2);
}

/* Mobile TOC Modal */
.docs-toc-modal {
  display: none;
  position: fixed;
  inset: 0;
  z-index: 300;
  background: rgba(0,0,0,0.5);
}
.docs-toc-modal.open { display: flex; align-items: center; justify-content: center; }
.docs-toc-modal-content {
  background-color: var(--color-surface);
  border-radius: var(--radius-lg);
  padding: var(--spacing-6);
  max-width: 600px;
  width: 90%;
  max-height: 80vh;
  overflow-y: auto;
  position: relative;
}
.docs-toc-modal-close {
  position: absolute;
  top: var(--spacing-4);
  right: var(--spacing-4);
  background: none;
  border: none;
  cursor: pointer;
  padding: var(--spacing-2);
  color: var(--color-text);
}

/* Tablet: hide TOC */
@media (max-width: 1024px) {
  .docs-layout { grid-template-columns: 260px 1fr; }
  .docs-sidebar-right { display: none; }
}

/* Mobile: hamburger drawer */
@media (max-width: 768px) {
  .docs-menu-toggle,
  .docs-toc-toggle { display: flex; }
  .docs-layout { grid-template-columns: 1fr; }
  .docs-sidebar-left {
    position: fixed;
    top: 0;
    left: 0;
    width: 280px;
    height: 100vh;
    max-height: 100vh;
    z-index: 200;
    transform: translateX(-100%);
    transition: transform var(--transition-normal);
    border-radius: 0;
  }
  .docs-sidebar-left.open { transform: translateX(0); }
  .docs-overlay {
    position: fixed;
    inset: 0;
    background: rgba(0,0,0,0.5);
    z-index: 199;
    display: none;
  }
  .docs-overlay.open { display: block; }
}

/* ===== Article Content Typography ===== */
.docs-content {
  /* Typography Scale */
  font-size: var(--font-size-base);
  line-height: 1.6;
}

.docs-content h1 {
  font-size: 2rem;
  line-height: 1.4;
  margin-top: 0;
  margin-bottom: 0.6em;
}

.docs-content h2 {
  font-size: 1.5rem;
  line-height: 1.4;
  margin-top: 1.6em;
  margin-bottom: 0.6em;
}

.docs-content h3 {
  font-size: 1.25rem;
  line-height: 1.4;
  margin-top: 1.6em;
  margin-bottom: 0.6em;
}

.docs-content h4 {
  font-size: 1.1rem;
  line-height: 1.4;
  margin-top: 1.6em;
  margin-bottom: 0.6em;
}

.docs-content p {
  margin-bottom: 1em;
}

.docs-content ul,
.docs-content ol {
  margin-left: 2rem;
  margin-bottom: 1em;
  padding-left: 0;
}

.docs-content li {
  margin-bottom: 0.5em;
}

.docs-content ul ul,
.docs-content ol ol,
.docs-content ul ol,
.docs-content ol ul {
  margin-left: 1.5rem;
  margin-top: 0.5em;
}

.docs-content code {
  background-color: var(--color-bg-secondary);
  padding: 0.2em 0.4em;
  border-radius: 4px;
  font-family: var(--font-family-mono);
  font-size: 0.9em;
}

.docs-content pre {
  background-color: var(--color-bg-secondary);
  padding: 1em;
  border-radius: 4px;
  overflow-x: auto;
  margin: 1em 0;
}

.docs-content pre code {
  background: none;
  padding: 0;
  border-radius: 0;
}

/* Dark mode list symbols */
[data-theme="dark"] .docs-content ul {
  color: var(--color-text-primary);
}

/* Mobile typography scaling */
@media (max-width: 768px) {
  .docs-content {
    font-size: calc(var(--font-size-base) * 0.875);
  }
}