/* ─── Docs layout ────────────────────────────────────────────────────────── */
.docs-body {
  display: grid;
  grid-template-columns: 220px 1fr;
  padding-top: var(--nav-h);
  min-height: 100vh;
}

/* ─── Sidebar ────────────────────────────────────────────────────────────── */
.docs-sidebar {
  position: sticky;
  top: var(--nav-h);
  height: calc(100vh - var(--nav-h));
  overflow-y: auto;
  border-right: 1px solid var(--border);
  padding: 20px 0 40px;
  scrollbar-width: thin;
  scrollbar-color: var(--border) transparent;
}
.docs-sidebar::-webkit-scrollbar { width: 4px; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--border); }

.sidebar-back {
  display: flex;
  align-items: center;
  gap: 6px;
  padding: 6px 20px 14px;
  font-size: 0.75rem;
  font-weight: 500;
  color: var(--muted);
  border-bottom: 1px solid var(--border);
  margin-bottom: 8px;
  transition: color 0.12s;
}
.sidebar-back:hover { color: var(--text); }

.sidebar-group-label {
  display: block;
  padding: 14px 20px 5px;
  font-size: 0.625rem;
  font-weight: 600;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--muted);
}
.sidebar-group-label:first-of-type { padding-top: 6px; }

.docs-sidebar a {
  display: block;
  padding: 5px 20px;
  font-size: 0.8125rem;
  color: var(--muted);
  transition: color 0.12s;
  border-left: 2px solid transparent;
  line-height: 1.5;
}
.docs-sidebar a:hover { color: var(--text); }
.docs-sidebar a.active {
  color: var(--accent);
  border-left-color: var(--accent);
  background: var(--accent-dim);
}

/* ─── Main content ───────────────────────────────────────────────────────── */
.docs-content {
  padding: 48px 64px 96px;
  max-width: 860px;
  min-width: 0;
}

/* ─── Page header ────────────────────────────────────────────────────────── */
.docs-page-header {
  padding-bottom: 32px;
  border-bottom: 1px solid var(--border);
}
.docs-page-header h1 {
  font-size: 1.75rem;
  font-weight: 700;
  letter-spacing: -0.03em;
  color: var(--text);
  margin-bottom: 6px;
}
.docs-page-header .page-subtitle {
  font-size: 0.9375rem;
  color: var(--muted);
}
.docs-page-header .page-meta {
  display: flex;
  gap: 8px;
  margin-top: 14px;
  flex-wrap: wrap;
}
.docs-page-header .meta-item {
  font-size: 0.75rem;
  font-family: 'JetBrains Mono', monospace;
  color: var(--muted);
  background: var(--bg-alt);
  border: 1px solid var(--border);
  padding: 3px 9px;
}

/* ─── Overview / index pages ─────────────────────────────────────────────── */
.overview-body { padding-top: var(--nav-h); }

.overview-content {
  max-width: 1100px;
  margin: 0 auto;
  padding: 56px 48px 96px;
}
.overview-header {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 64px;
  align-items: start;
  padding-bottom: 48px;
  border-bottom: 1px solid var(--border);
  margin-bottom: 48px;
}
.overview-eyebrow {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.6875rem;
  font-weight: 500;
  color: var(--accent);
  letter-spacing: 0.07em;
  text-transform: uppercase;
  margin-bottom: 14px;
  opacity: 0.8;
}
.overview-header h1 {
  font-size: clamp(1.875rem, 4vw, 2.875rem);
  font-weight: 800;
  letter-spacing: -0.04em;
  color: var(--text);
  margin-bottom: 14px;
}
.overview-header .overview-desc {
  font-size: 0.9375rem;
  color: var(--text-sec);
  line-height: 1.75;
  margin-bottom: 10px;
}
.overview-meta-box {
  border: 1px solid var(--border);
  align-self: start;
}
.overview-meta-box-label {
  padding: 9px 14px 8px;
  font-size: 0.625rem;
  font-weight: 600;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--muted);
  background: var(--bg-alt);
  border-bottom: 1px solid var(--border);
}
.overview-header .overview-meta {
  display: flex;
  flex-direction: column;
  padding: 0 14px;
}
.overview-meta-row {
  display: flex;
  justify-content: space-between;
  align-items: baseline;
  gap: 16px;
  font-size: 0.8125rem;
  padding: 9px 0;
  border-bottom: 1px solid var(--border);
  color: var(--text-sec);
}
.overview-meta-row:last-child { border-bottom: none; }
.overview-meta-row span:first-child { color: var(--muted); font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.06em; white-space: nowrap; }
.overview-meta-row span:last-child { font-family: 'JetBrains Mono', monospace; font-size: 0.8125rem; color: var(--text); text-align: right; }

/* Category grid */
.category-grid {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 0;
  border: 1px solid var(--border);
  margin-bottom: 0;
  margin-top: 32px;
}
.category-group {
  border-right: 1px solid var(--border);
  border-bottom: 1px solid var(--border);
}
.category-group:nth-child(2n) { border-right: none; }
.category-group:nth-last-child(-n+2) { border-bottom: none; }
.category-group--dev .category-group-header {
  color: var(--accent);
  background: var(--accent-dim);
  border-bottom-color: var(--accent-dim-strong);
  opacity: 0.9;
}
.category-group-header {
  padding: 13px 20px 9px;
  border-bottom: 1px solid var(--border);
  font-size: 0.625rem;
  font-weight: 600;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--muted);
  background: var(--bg-alt);
}
.category-link-list { list-style: none; padding: 5px 0; }
.category-link-list li a {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 8px 20px;
  font-size: 0.8125rem;
  color: var(--text-sec);
  border-left: 2px solid transparent;
  transition: background 0.12s, color 0.12s, border-color 0.12s;
}
.category-link-list li a:hover {
  background: var(--bg-alt);
  color: var(--text);
  border-left-color: var(--accent);
}
.category-link-list li a span { font-size: 0.6875rem; color: var(--muted); }

/* Start-here banner */
.start-here-banner {
  display: grid;
  grid-template-columns: 1fr auto;
  align-items: center;
  gap: 24px;
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent);
  background: var(--accent-dim);
  padding: 20px 24px;
  margin-bottom: 32px;
  transition: background 0.15s;
}
.start-here-banner:hover { background: var(--accent-dim-strong); }
.start-here-banner h3 {
  font-size: 0.9375rem;
  font-weight: 600;
  margin-bottom: 5px;
  color: var(--text);
}
.start-here-banner p {
  font-size: 0.8125rem;
  color: var(--text-sec);
  margin: 0;
  line-height: 1.6;
}

/* Overview button group (replaces inline styles) */
.overview-btn-group {
  margin-top: 20px;
  display: flex;
  gap: 8px;
  flex-wrap: wrap;
}

/* ─── Section headings ───────────────────────────────────────────────────── */
.doc-section {
  margin-top: 48px;
  padding-top: 48px;
  border-top: 1px solid var(--border);
}
.doc-section:first-of-type {
  border-top: none;
  margin-top: 36px;
  padding-top: 0;
}
.docs-content h2 {
  font-size: 1.125rem;
  font-weight: 600;
  letter-spacing: -0.02em;
  color: var(--text);
  margin-bottom: 14px;
}
.docs-content h3 {
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--text);
  margin: 24px 0 8px;
}
.docs-content h4 {
  font-size: 0.8125rem;
  font-weight: 600;
  color: var(--muted);
  margin: 18px 0 6px;
  letter-spacing: 0.02em;
}
.docs-content p {
  font-size: 0.9375rem;
  color: var(--text-sec);
  line-height: 1.75;
  margin-bottom: 12px;
}
.docs-content p strong { color: var(--text); font-weight: 600; }
.docs-content p em { font-style: italic; }
.docs-content ul, .docs-content ol {
  padding-left: 20px;
  margin-bottom: 12px;
}
.docs-content li {
  font-size: 0.9375rem;
  color: var(--text-sec);
  line-height: 1.7;
  margin-bottom: 4px;
}

/* ─── Class / method blocks ──────────────────────────────────────────────── */
.class-block {
  border: 1px solid var(--border);
  margin: 24px 0;
}
.class-block-header {
  padding: 12px 18px;
  background: var(--bg-alt);
  border-bottom: 1px solid var(--border);
}
.class-name {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--text);
  margin-bottom: 2px;
}
.class-desc {
  font-size: 0.8125rem;
  color: var(--muted);
}
.class-block-body { padding: 18px; }

.method-block {
  border-left: 2px solid var(--border);
  padding-left: 16px;
  margin: 18px 0;
  transition: border-left-color 0.15s;
}
.method-block:hover { border-left-color: var(--accent); }
.method-sig {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.8125rem;
  color: var(--text);
  background: var(--bg-alt);
  border: 1px solid var(--border);
  padding: 9px 14px;
  overflow-x: auto;
  white-space: pre;
  margin-bottom: 8px;
}
.method-desc {
  font-size: 0.875rem;
  color: var(--text-sec);
  line-height: 1.65;
  margin: 0;
}

/* ─── Parameter / constant tables ────────────────────────────────────────── */
.param-table, .const-table {
  width: 100%;
  border-collapse: collapse;
  border: 1px solid var(--border);
  font-size: 0.8125rem;
  margin: 12px 0;
}
.param-table thead th, .const-table thead th {
  background: var(--bg-alt);
  border-bottom: 1px solid var(--border);
  padding: 7px 12px;
  text-align: left;
  font-weight: 600;
  font-size: 0.625rem;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--muted);
}
.param-table td, .const-table td {
  padding: 8px 12px;
  border-bottom: 1px solid var(--border);
  color: var(--text-sec);
  vertical-align: top;
  line-height: 1.5;
}
.param-table tr:last-child td,
.const-table tr:last-child td { border-bottom: none; }
.col-name {
  font-family: 'JetBrains Mono', monospace;
  color: var(--text);
  white-space: nowrap;
  font-size: 0.8125rem;
}
.col-type {
  font-family: 'JetBrains Mono', monospace;
  color: var(--accent);
  white-space: nowrap;
}
.col-default {
  font-family: 'JetBrains Mono', monospace;
  color: var(--muted);
  white-space: nowrap;
}

/* ─── Syntax highlighting (highlight.js overrides) ───────────────────────── */
pre code.hljs {
  display: block;
  background: var(--bg-alt) !important;
  border: none;
  padding: 16px 18px !important;
  font-family: 'JetBrains Mono', monospace !important;
  font-size: 0.8125rem !important;
  line-height: 1.65 !important;
  border-radius: 0 !important;
  overflow-x: auto;
  color: var(--text) !important;
}
pre {
  background: var(--bg-alt);
  border: 1px solid var(--border);
  margin: 16px 0;
  overflow: hidden;
}
code {
  font-family: 'JetBrains Mono', monospace;
  font-size: 0.85em;
  color: var(--text);
  background: var(--bg-alt);
  border: 1px solid var(--border);
  padding: 1px 5px;
}
pre code { background: none; border: none; padding: 0; font-size: inherit; }

/* Light mode tokens */
.hljs-keyword   { color: #cf222e; }
.hljs-string    { color: #0a3069; }
.hljs-number    { color: #0550ae; }
.hljs-comment   { color: #6e7781; font-style: italic; }
.hljs-title     { color: #8250df; }
.hljs-built_in  { color: #0550ae; }
.hljs-literal   { color: #0550ae; }
.hljs-params    { color: #24292f; }
.hljs-decorator { color: #953800; }
.hljs-class     { color: #953800; }
.hljs-type      { color: #953800; }
.hljs-attr      { color: #0550ae; }
.hljs-variable  { color: #24292f; }
.hljs-operator  { color: #cf222e; }
.hljs-punctuation { color: #24292f; }

/* Dark mode tokens */
[data-theme="dark"] .hljs-keyword   { color: #ff7b72; }
[data-theme="dark"] .hljs-string    { color: #a5d6ff; }
[data-theme="dark"] .hljs-number    { color: #79c0ff; }
[data-theme="dark"] .hljs-comment   { color: #8b949e; }
[data-theme="dark"] .hljs-title     { color: #d2a8ff; }
[data-theme="dark"] .hljs-built_in  { color: #79c0ff; }
[data-theme="dark"] .hljs-literal   { color: #79c0ff; }
[data-theme="dark"] .hljs-params    { color: #e6edf3; }
[data-theme="dark"] .hljs-decorator { color: #ffa657; }
[data-theme="dark"] .hljs-class     { color: #ffa657; }
[data-theme="dark"] .hljs-type      { color: #ffa657; }
[data-theme="dark"] .hljs-attr      { color: #79c0ff; }
[data-theme="dark"] .hljs-variable  { color: #e6edf3; }
[data-theme="dark"] .hljs-operator  { color: #ff7b72; }
[data-theme="dark"] .hljs-punctuation { color: #e6edf3; }

/* ─── Image / figure containers ──────────────────────────────────────────── */
.doc-figure {
  border: 1px solid var(--border);
  margin: 24px 0;
}
.doc-figure img { width: 100%; display: block; }
.doc-figure figcaption {
  padding: 6px 12px;
  font-size: 0.6875rem;
  color: var(--muted);
  background: var(--bg-alt);
  border-top: 1px solid var(--border);
  letter-spacing: 0.01em;
}
.doc-image-placeholder {
  background: var(--bg-alt);
  border: 1px dashed var(--border-strong);
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  gap: 6px;
  margin: 24px 0;
  padding: 40px 24px;
  color: var(--muted);
  font-size: 0.8125rem;
  text-align: center;
}
.doc-image-placeholder span { font-size: 0.6875rem; opacity: 0.6; }

/* ─── Callouts ───────────────────────────────────────────────────────────── */
.doc-note {
  border-left: 3px solid var(--accent);
  background: var(--accent-dim);
  padding: 11px 16px;
  margin: 16px 0;
  font-size: 0.875rem;
  color: var(--text-sec);
  line-height: 1.65;
}
.doc-note strong { color: var(--text); }
.doc-warning {
  border-left: 3px solid #c0392b;
  background: rgba(192,57,43,0.07);
  padding: 11px 16px;
  margin: 16px 0;
  font-size: 0.875rem;
  color: var(--text-sec);
  line-height: 1.65;
}

/* ─── Next / previous navigation ────────────────────────────────────────── */
.doc-nav-footer {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  margin-top: 64px;
  padding-top: 24px;
  border-top: 1px solid var(--border);
}
.doc-nav-link {
  display: block;
  padding: 14px 18px;
  border: 1px solid var(--border);
  color: var(--text);
  transition: border-color 0.12s, background 0.12s;
}
.doc-nav-link:hover { border-color: var(--accent); background: var(--bg-alt); }
.doc-nav-dir {
  font-size: 0.6875rem;
  color: var(--muted);
  margin-bottom: 4px;
  font-family: 'JetBrains Mono', monospace;
}
.doc-nav-title { font-size: 0.875rem; font-weight: 500; color: var(--text); }
.doc-nav-link--next { text-align: right; }

/* ─── Responsive ─────────────────────────────────────────────────────────── */
@media (max-width: 900px) {
  .docs-body { grid-template-columns: 1fr; }
  .docs-sidebar {
    position: static;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--border);
    padding: 14px 0;
  }
  .docs-content { padding: 32px 24px 64px; }
  .overview-header { grid-template-columns: 1fr; gap: 28px; }
  .overview-meta-box { align-self: stretch; }
  .category-grid { grid-template-columns: 1fr; }
  .category-group { border-right: none; }
  .category-group:nth-last-child(-n+2) { border-bottom: 1px solid var(--border); }
  .category-group:last-child { border-bottom: none; }
  .overview-content { padding: 36px 24px 64px; }
  .doc-nav-footer { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
  .docs-content { padding: 24px 16px 48px; }
  .docs-page-header h1 { font-size: 1.375rem; }
  .start-here-banner { grid-template-columns: 1fr; }
}