/* ============================================================
   AgentEX1 Docs — Design Tokens & Styles
   ============================================================ */

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

/* --- Design Tokens --- */
:root {
  /* Typography */
  --font-display: 'Geist', 'Inter', system-ui, sans-serif;
  --font-body: 'Inter', system-ui, sans-serif;
  --font-mono: 'JetBrains Mono', 'Fira Code', monospace;

  /* Type Scale (fluid) */
  --text-xs: clamp(0.75rem, 0.7rem + 0.25vw, 0.8125rem);
  --text-sm: clamp(0.8125rem, 0.78rem + 0.15vw, 0.875rem);
  --text-base: clamp(0.875rem, 0.85rem + 0.15vw, 0.9375rem);
  --text-lg: clamp(1.125rem, 0.95rem + 0.85vw, 1.375rem);
  --text-xl: clamp(1.375rem, 1rem + 1.2vw, 1.75rem);
  --text-2xl: clamp(1.75rem, 1.2rem + 1.8vw, 2.5rem);

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

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

  /* Transition */
  --ease-out: cubic-bezier(0.16, 1, 0.3, 1);
  --transition-fast: 180ms var(--ease-out);

  /* Layout */
  --sidebar-width: 260px;
  --toc-width: 220px;
  --content-max: 75ch;
  --header-height: 56px;
}

/* --- Dark Theme (default) --- */
[data-theme="dark"] {
  --color-bg: #0a0a0a;
  --color-surface: #111111;
  --color-surface-2: #161616;
  --color-surface-offset: #1a1a1a;
  --color-border: #282828;
  --color-border-subtle: rgba(255,255,255,0.06);
  --color-text: #ededed;
  --color-text-muted: #888888;
  --color-text-faint: #555555;
  --color-primary: #00d4aa;
  --color-primary-hover: #00bfa0;
  --color-primary-dim: rgba(0,212,170,0.12);
  --color-primary-border: rgba(0,212,170,0.18);
  --color-success: #4ade80;
  --color-error: #f87171;
  --color-warning: #fbbf24;
  --color-code-bg: #0d0d0d;
  --color-code-border: #1e1e1e;
  --color-inline-code-bg: rgba(255,255,255,0.06);
  --color-table-header-bg: rgba(255,255,255,0.03);
  --color-table-row-hover: rgba(255,255,255,0.02);
  --shadow-sm: 0 1px 2px rgba(0,0,0,0.4);
  --shadow-md: 0 4px 12px rgba(0,0,0,0.5);
}

/* --- Light Theme --- */
[data-theme="light"] {
  --color-bg: #f8f9fa;
  --color-surface: #ffffff;
  --color-surface-2: #f3f4f6;
  --color-surface-offset: #eef0f2;
  --color-border: #e0e2e6;
  --color-border-subtle: rgba(0,0,0,0.06);
  --color-text: #0d0d0d;
  --color-text-muted: #6b7280;
  --color-text-faint: #9ca3af;
  --color-primary: #00a887;
  --color-primary-hover: #009578;
  --color-primary-dim: rgba(0,168,135,0.08);
  --color-primary-border: rgba(0,168,135,0.15);
  --color-success: #22c55e;
  --color-error: #ef4444;
  --color-warning: #f59e0b;
  --color-code-bg: #0d0d0d;
  --color-code-border: #1e1e1e;
  --color-inline-code-bg: rgba(0,0,0,0.05);
  --color-table-header-bg: rgba(0,0,0,0.02);
  --color-table-row-hover: rgba(0,0,0,0.02);
  --shadow-sm: 0 1px 2px rgba(0,0,0,0.05);
  --shadow-md: 0 4px 12px rgba(0,0,0,0.08);
}

/* ============================================================
   Layout Shell
   ============================================================ */

body {
  display: flex;
  flex-direction: column;
  overflow: hidden;
  height: 100dvh;
}

/* --- Header --- */
.docs-header {
  height: var(--header-height);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 var(--space-5);
  border-bottom: 1px solid var(--color-border);
  background: var(--color-bg);
  flex-shrink: 0;
  z-index: 50;
  gap: var(--space-4);
}

.header-left {
  display: flex;
  align-items: center;
  gap: var(--space-3);
}

.header-logo {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  text-decoration: none;
  color: var(--color-text);
  font-family: var(--font-display);
  font-weight: 600;
  font-size: var(--text-sm);
  letter-spacing: -0.01em;
  white-space: nowrap;
}

.header-logo svg {
  flex-shrink: 0;
}

.header-logo .logo-divider {
  width: 1px;
  height: 18px;
  background: var(--color-border);
  margin: 0 var(--space-1);
}

.header-logo .logo-docs {
  color: var(--color-text-muted);
  font-weight: 400;
}

.header-right {
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.header-search {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-1) var(--space-3);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  color: var(--color-text-faint);
  font-size: var(--text-xs);
  cursor: pointer;
  transition: border-color var(--transition-fast);
  min-width: 200px;
}

.header-search:hover {
  border-color: var(--color-text-faint);
}

.header-search kbd {
  font-family: var(--font-body);
  font-size: 10px;
  padding: 1px 5px;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  background: var(--color-surface-2);
  color: var(--color-text-faint);
  margin-left: auto;
}

/* Theme Toggle */
.theme-toggle {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  border-radius: var(--radius-md);
  color: var(--color-text-muted);
  transition: background var(--transition-fast), color var(--transition-fast);
}
.theme-toggle:hover {
  background: var(--color-surface-2);
  color: var(--color-text);
}

/* Mobile menu button */
.mobile-menu-btn {
  display: none;
  align-items: center;
  justify-content: center;
  width: 36px;
  height: 36px;
  border-radius: var(--radius-md);
  color: var(--color-text-muted);
}
.mobile-menu-btn:hover {
  background: var(--color-surface-2);
  color: var(--color-text);
}

/* --- Main Layout --- */
.docs-layout {
  display: flex;
  flex: 1;
  overflow: hidden;
}

/* --- Left Sidebar --- */
.docs-sidebar {
  width: var(--sidebar-width);
  flex-shrink: 0;
  overflow-y: auto;
  overscroll-behavior: contain;
  border-right: 1px solid var(--color-border);
  background: var(--color-bg);
  padding: var(--space-4) 0;
}

.sidebar-section {
  padding: 0 var(--space-4);
  margin-bottom: var(--space-4);
}

.sidebar-section-title {
  font-family: var(--font-body);
  font-size: var(--text-xs);
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-text-faint);
  padding: 0 var(--space-2);
  margin-bottom: var(--space-2);
}

.sidebar-link {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-1) var(--space-2);
  border-radius: var(--radius-md);
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  text-decoration: none;
  transition: background var(--transition-fast), color var(--transition-fast);
  line-height: 1.5;
}

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

.sidebar-link.active {
  background: var(--color-primary-dim);
  color: var(--color-primary);
  font-weight: 500;
}

.sidebar-link .method-badge {
  font-size: 9px;
  font-weight: 600;
  font-family: var(--font-mono);
  padding: 1px 4px;
  border-radius: var(--radius-sm);
  letter-spacing: 0.02em;
  text-transform: uppercase;
  line-height: 1.4;
  flex-shrink: 0;
}

/* --- Content Area --- */
.docs-content-wrapper {
  flex: 1;
  overflow-y: auto;
  overscroll-behavior: contain;
  display: flex;
  flex-direction: column;
  align-items: center;
}

.docs-content {
  width: 100%;
  max-width: calc(var(--content-max) + var(--toc-width) + var(--space-16));
  display: flex;
  gap: var(--space-8);
  padding: var(--space-8) var(--space-8);
  flex: 1;
}

.docs-main {
  flex: 1;
  min-width: 0;
  max-width: var(--content-max);
}

/* --- Right TOC --- */
.docs-toc {
  width: var(--toc-width);
  flex-shrink: 0;
  position: sticky;
  top: 0;
  align-self: flex-start;
  max-height: calc(100dvh - var(--header-height) - var(--space-16));
  overflow-y: auto;
  overscroll-behavior: contain;
  padding-top: var(--space-1);
}

.toc-title {
  font-family: var(--font-body);
  font-size: var(--text-xs);
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-text-faint);
  margin-bottom: var(--space-3);
}

.toc-list {
  list-style: none;
  border-left: 1px solid var(--color-border);
}

.toc-link {
  display: block;
  padding: var(--space-1) var(--space-3);
  font-size: var(--text-xs);
  color: var(--color-text-faint);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -1px;
  transition: color var(--transition-fast), border-color var(--transition-fast);
  line-height: 1.5;
}

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

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

.toc-link[data-level="3"] {
  padding-left: var(--space-6);
}

/* ============================================================
   Content Styles
   ============================================================ */

.docs-main h1 {
  font-family: var(--font-display);
  font-size: var(--text-xl);
  font-weight: 700;
  letter-spacing: -0.02em;
  margin-bottom: var(--space-2);
  color: var(--color-text);
}

.docs-main .page-description {
  font-size: var(--text-base);
  color: var(--color-text-muted);
  margin-bottom: var(--space-8);
  line-height: 1.6;
}

.docs-main h2 {
  font-family: var(--font-display);
  font-size: var(--text-lg);
  font-weight: 600;
  letter-spacing: -0.015em;
  margin-top: var(--space-10);
  margin-bottom: var(--space-4);
  padding-bottom: var(--space-2);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-text);
}

.docs-main h3 {
  font-family: var(--font-display);
  font-size: var(--text-base);
  font-weight: 600;
  margin-top: var(--space-6);
  margin-bottom: var(--space-3);
  color: var(--color-text);
}

.docs-main h4 {
  font-family: var(--font-display);
  font-size: var(--text-sm);
  font-weight: 600;
  margin-top: var(--space-5);
  margin-bottom: var(--space-2);
  color: var(--color-text);
}

.docs-main p {
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  margin-bottom: var(--space-4);
  line-height: 1.7;
}

.docs-main ul, .docs-main ol {
  padding-left: var(--space-5);
  margin-bottom: var(--space-4);
}

.docs-main li {
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  margin-bottom: var(--space-1);
  line-height: 1.6;
}

.docs-main li::marker {
  color: var(--color-text-faint);
}

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

.docs-main a:hover {
  color: var(--color-primary-hover);
  text-decoration: underline;
}

.docs-main strong {
  font-weight: 600;
  color: var(--color-text);
}

.docs-main hr {
  border: none;
  border-top: 1px solid var(--color-border);
  margin: var(--space-8) 0;
}

/* Inline code */
.docs-main code:not(pre code) {
  font-family: var(--font-mono);
  font-size: 0.85em;
  padding: 2px 6px;
  background: var(--color-inline-code-bg);
  border-radius: var(--radius-sm);
  color: var(--color-text);
  font-weight: 400;
}

/* ============================================================
   Code Blocks
   ============================================================ */

.code-block-wrapper {
  margin-bottom: var(--space-5);
  border-radius: var(--radius-lg);
  border: 1px solid var(--color-code-border);
  overflow: hidden;
  background: var(--color-code-bg);
}

.code-block-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-1) var(--space-3);
  background: rgba(255,255,255,0.03);
  border-bottom: 1px solid var(--color-code-border);
}

.code-tabs {
  display: flex;
  gap: 0;
}

.code-tab {
  font-family: var(--font-mono);
  font-size: 11px;
  padding: var(--space-1) var(--space-3);
  color: #666;
  border-radius: var(--radius-sm);
  transition: color var(--transition-fast), background var(--transition-fast);
  font-weight: 500;
}

.code-tab:hover {
  color: #999;
}

.code-tab.active {
  color: #ededed;
  background: rgba(255,255,255,0.08);
}

.copy-btn {
  display: flex;
  align-items: center;
  gap: var(--space-1);
  font-size: 11px;
  font-family: var(--font-mono);
  color: #666;
  padding: 3px 8px;
  border-radius: var(--radius-sm);
  transition: color var(--transition-fast), background var(--transition-fast);
}

.copy-btn:hover {
  color: #ededed;
  background: rgba(255,255,255,0.08);
}

.copy-btn.copied {
  color: var(--color-success);
}

.code-block-content {
  overflow-x: auto;
}

.code-block-content pre {
  padding: var(--space-4);
  margin: 0;
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.6;
  color: #e0e0e0;
  tab-size: 2;
}

.code-block-content code {
  font-family: inherit;
}

.code-panel {
  display: none;
}
.code-panel.active {
  display: block;
}

/* Syntax highlighting tokens */
.tok-keyword { color: #c792ea; }
.tok-string { color: #c3e88d; }
.tok-number { color: #f78c6c; }
.tok-comment { color: #546e7a; font-style: italic; }
.tok-function { color: #82aaff; }
.tok-operator { color: #89ddff; }
.tok-property { color: #f07178; }
.tok-type { color: #ffcb6b; }
.tok-punctuation { color: #89ddff; }
.tok-variable { color: #e0e0e0; }
.tok-param { color: #e0e0e0; }

/* ============================================================
   Method Badges
   ============================================================ */

.method-badge {
  display: inline-flex;
  align-items: center;
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 600;
  padding: 2px 6px;
  border-radius: var(--radius-sm);
  letter-spacing: 0.02em;
  text-transform: uppercase;
  line-height: 1.4;
  flex-shrink: 0;
}

.method-get {
  color: #4ade80;
  background: rgba(74,222,128,0.1);
}

.method-post {
  color: #00d4aa;
  background: rgba(0,212,170,0.1);
}

.method-put {
  color: #fbbf24;
  background: rgba(251,191,36,0.1);
}

.method-delete {
  color: #f87171;
  background: rgba(248,113,113,0.1);
}

/* ============================================================
   Endpoint Block
   ============================================================ */

.endpoint-block {
  margin-bottom: var(--space-8);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.endpoint-header {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: var(--space-3) var(--space-4);
  background: var(--color-surface);
  border-bottom: 1px solid var(--color-border);
}

.endpoint-path {
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  color: var(--color-text);
  font-weight: 500;
}

.endpoint-description {
  padding: var(--space-4);
  font-size: var(--text-sm);
  color: var(--color-text-muted);
}

/* ============================================================
   Tables
   ============================================================ */

.docs-main table {
  width: 100%;
  margin-bottom: var(--space-5);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  overflow: hidden;
  font-size: var(--text-sm);
}

.docs-main thead {
  background: var(--color-table-header-bg);
}

.docs-main th {
  text-align: left;
  padding: var(--space-2) var(--space-3);
  font-weight: 600;
  font-size: var(--text-xs);
  color: var(--color-text-muted);
  text-transform: uppercase;
  letter-spacing: 0.04em;
  border-bottom: 1px solid var(--color-border);
}

.docs-main td {
  padding: var(--space-2) var(--space-3);
  border-bottom: 1px solid var(--color-border-subtle);
  color: var(--color-text-muted);
  vertical-align: top;
  line-height: 1.5;
}

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

.docs-main tr:hover td {
  background: var(--color-table-row-hover);
}

.docs-main td code {
  font-size: 12px;
}

/* ============================================================
   Callouts
   ============================================================ */

.callout {
  display: flex;
  gap: var(--space-3);
  padding: var(--space-3) var(--space-4);
  border-radius: var(--radius-lg);
  margin-bottom: var(--space-5);
  font-size: var(--text-sm);
  line-height: 1.6;
  border: 1px solid;
}

.callout-icon {
  flex-shrink: 0;
  margin-top: 2px;
}

.callout-info {
  background: var(--color-primary-dim);
  border-color: var(--color-primary-border);
  color: var(--color-text-muted);
}
.callout-info .callout-icon { color: var(--color-primary); }

.callout-warning {
  background: rgba(251,191,36,0.08);
  border-color: rgba(251,191,36,0.15);
  color: var(--color-text-muted);
}
.callout-warning .callout-icon { color: var(--color-warning); }

.callout-error {
  background: rgba(248,113,113,0.08);
  border-color: rgba(248,113,113,0.15);
  color: var(--color-text-muted);
}
.callout-error .callout-icon { color: var(--color-error); }

/* ============================================================
   Steps (Quickstart)
   ============================================================ */

.steps {
  counter-reset: step;
  padding-left: 0;
  list-style: none;
}

.step {
  counter-increment: step;
  position: relative;
  padding-left: var(--space-8);
  padding-bottom: var(--space-6);
  border-left: 1px solid var(--color-border);
  margin-left: 14px;
}

.step:last-child {
  border-left: none;
  padding-bottom: 0;
}

.step::before {
  content: counter(step);
  position: absolute;
  left: -14px;
  top: 0;
  width: 28px;
  height: 28px;
  background: var(--color-primary);
  color: #0a0a0a;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  font-family: var(--font-display);
  font-size: 12px;
  font-weight: 700;
}

.step h3 {
  margin-top: 0;
  margin-bottom: var(--space-2);
}

/* ============================================================
   Footer
   ============================================================ */

.docs-footer {
  padding: var(--space-6) var(--space-5);
  border-top: 1px solid var(--color-border);
  text-align: center;
  font-size: var(--text-xs);
  color: var(--color-text-faint);
  flex-shrink: 0;
  width: 100%;
  margin-top: auto;
}

.docs-footer a {
  color: var(--color-text-faint);
  text-decoration: none;
  transition: color var(--transition-fast);
}

.docs-footer a:hover {
  color: var(--color-text-muted);
}

/* ============================================================
   Mobile Overlay
   ============================================================ */

.sidebar-overlay {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0,0,0,0.5);
  z-index: 99;
}

.sidebar-overlay.visible {
  display: block;
}

/* ============================================================
   Responsive
   ============================================================ */

@media (max-width: 1100px) {
  .docs-toc {
    display: none;
  }
  .docs-content {
    max-width: 100%;
  }
}

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

  .header-search {
    display: none;
  }

  .docs-sidebar {
    position: fixed;
    left: 0;
    top: var(--header-height);
    bottom: 0;
    z-index: 100;
    transform: translateX(-100%);
    transition: transform 300ms var(--ease-out);
    width: min(var(--sidebar-width), 85vw);
    box-shadow: var(--shadow-md);
  }

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

  .docs-content {
    padding: var(--space-5) var(--space-4);
  }

  .docs-main h1 {
    font-size: var(--text-lg);
  }

  .endpoint-header {
    flex-wrap: wrap;
    gap: var(--space-2);
  }

  .endpoint-path {
    font-size: var(--text-xs);
    word-break: break-all;
  }

  .docs-main table {
    display: block;
    overflow-x: auto;
  }
}

/* ============================================================
   Scrollbar Styling
   ============================================================ */

::-webkit-scrollbar {
  width: 6px;
  height: 6px;
}

::-webkit-scrollbar-track {
  background: transparent;
}

::-webkit-scrollbar-thumb {
  background: var(--color-border);
  border-radius: 3px;
}

::-webkit-scrollbar-thumb:hover {
  background: var(--color-text-faint);
}

/* ============================================================
   Misc Utilities
   ============================================================ */

.flex-row {
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.tag {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 11px;
  padding: 1px 6px;
  border-radius: var(--radius-sm);
  background: var(--color-surface-2);
  color: var(--color-text-muted);
  border: 1px solid var(--color-border-subtle);
}

.required-tag {
  color: var(--color-error);
  background: rgba(248,113,113,0.08);
  border-color: rgba(248,113,113,0.15);
}

.optional-tag {
  color: var(--color-text-faint);
}

/* Param table special styling */
.param-name {
  font-family: var(--font-mono);
  font-weight: 500;
  color: var(--color-text);
  font-size: 13px;
}

.param-type {
  font-family: var(--font-mono);
  color: var(--color-text-faint);
  font-size: 12px;
}

/* Flow diagram */
.flow-diagram {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-4);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  margin-bottom: var(--space-5);
  overflow-x: auto;
  font-size: var(--text-xs);
  color: var(--color-text-muted);
}

.flow-step {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  background: var(--color-surface-2);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  white-space: nowrap;
  font-family: var(--font-mono);
  font-size: 12px;
}

.flow-arrow {
  color: var(--color-text-faint);
  flex-shrink: 0;
}

/* Anchor link */
.anchor-link {
  opacity: 0;
  color: var(--color-text-faint);
  text-decoration: none;
  margin-left: var(--space-2);
  font-size: 0.8em;
  transition: opacity var(--transition-fast);
}
h2:hover .anchor-link,
h3:hover .anchor-link {
  opacity: 1;
}

/* Skip to content */
.skip-link {
  position: absolute;
  top: -100%;
  left: var(--space-4);
  background: var(--color-primary);
  color: #0a0a0a;
  padding: var(--space-2) var(--space-4);
  border-radius: var(--radius-md);
  font-size: var(--text-sm);
  font-weight: 600;
  z-index: 200;
  text-decoration: none;
}

.skip-link:focus {
  top: var(--space-2);
}
