/* SUB — Documentation page styles.
   Two-column layout with sidebar, prose styles, API reference, callouts. */

/* ── Layout ── */
.docs-layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  gap: 0;
  min-height: calc(100vh - 60px);
}

.docs-sidebar {
  background: var(--bg-alt);
  border-right: 1px solid var(--border-soft);
  padding: 24px 0;
  position: sticky;
  top: 60px;
  height: calc(100vh - 60px);
  overflow-y: auto;
}

.docs-sidebar-inner { padding: 0 20px; }

.docs-sidebar h4 {
  font-size: 0.72rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--muted);
  margin: 20px 0 8px;
}
.docs-sidebar h4:first-child { margin-top: 0; }

.docs-sidebar a {
  display: block;
  color: var(--text-dim);
  font-size: 0.88rem;
  padding: 5px 0;
  text-decoration: none;
  transition: color 0.15s;
}
.docs-sidebar a:hover { color: var(--text); text-decoration: none; }
.docs-sidebar a.active { color: var(--accent); font-weight: 600; }

.docs-content {
  padding: 40px 48px 80px;
  max-width: 820px;
  min-width: 0;
}

/* ── Breadcrumbs ── */
.breadcrumbs {
  display: flex;
  align-items: center;
  gap: 8px;
  font-size: 0.82rem;
  color: var(--muted);
  margin-bottom: 24px;
}
.breadcrumbs a { color: var(--text-dim); }
.breadcrumbs a:hover { color: var(--accent); text-decoration: none; }
.breadcrumbs .sep { color: var(--border); }

/* ── Prose ── */
.prose h1 {
  font-size: clamp(1.6rem, 4vw, 2.2rem);
  margin-bottom: 12px;
  letter-spacing: -0.02em;
}
.prose h2 {
  font-size: 1.35rem;
  margin-top: 48px;
  margin-bottom: 16px;
  padding-bottom: 8px;
  border-bottom: 1px solid var(--border-soft);
}
.prose h3 {
  font-size: 1.08rem;
  margin-top: 32px;
  margin-bottom: 12px;
}
.prose p {
  color: var(--text-dim);
  margin-bottom: 16px;
  line-height: 1.75;
}
.prose ul, .prose ol {
  color: var(--text-dim);
  margin-bottom: 16px;
  padding-left: 24px;
}
.prose li { margin-bottom: 6px; line-height: 1.7; }
.prose strong { color: var(--text); font-weight: 600; }
.prose hr {
  border: none;
  border-top: 1px solid var(--border-soft);
  margin: 32px 0;
}

/* ── Code blocks in docs ── */
.prose pre {
  background: var(--code-bg);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 16px 20px;
  margin-bottom: 20px;
  overflow-x: auto;
  font-size: 0.85rem;
  line-height: 1.7;
}
.prose pre code {
  background: none;
  border: none;
  padding: 0;
  color: var(--text);
  white-space: pre;
}

/* ── Tables ── */
.prose table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: 24px;
  font-size: 0.9rem;
}
.prose th {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 2px solid var(--border);
  color: var(--text);
  font-weight: 600;
  font-size: 0.82rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}
.prose td {
  padding: 10px 14px;
  border-bottom: 1px solid var(--border-soft);
  color: var(--text-dim);
}
.prose tr:last-child td { border-bottom: none; }

/* ── Callout boxes ── */
.callout {
  border-radius: var(--radius);
  padding: 16px 20px;
  margin-bottom: 20px;
  font-size: 0.9rem;
  line-height: 1.65;
  border-left: 3px solid;
}
.callout p { margin-bottom: 0; }
.callout-info {
  background: rgba(79, 156, 249, 0.08);
  border-color: var(--accent);
  color: var(--text-dim);
}
.callout-warn {
  background: rgba(217, 161, 108, 0.08);
  border-color: #d9a16c;
  color: var(--text-dim);
}
.callout-tip {
  background: rgba(158, 203, 122, 0.08);
  border-color: #9ecb7a;
  color: var(--text-dim);
}
.callout strong { color: var(--text); }

/* ── API reference ── */
.api-fn {
  background: var(--panel);
  border: 1px solid var(--border-soft);
  border-radius: var(--radius);
  padding: 20px 24px;
  margin-bottom: 16px;
}
.api-fn h3 {
  margin: 0 0 8px;
  font-family: var(--mono);
  font-size: 0.92rem;
  color: var(--accent);
}
.api-fn p {
  margin: 0;
  font-size: 0.9rem;
}
.api-fn .api-since {
  font-size: 0.75rem;
  color: var(--muted);
  font-family: var(--mono);
}

/* ── Mobile sidebar toggle ── */
.sidebar-toggle {
  display: none;
  background: var(--panel);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  color: var(--text);
  padding: 8px 16px;
  font-size: 0.88rem;
  cursor: pointer;
  margin-bottom: 16px;
  font-family: var(--sans);
}

/* ── Responsive ── */
@media (max-width: 860px) {
  .docs-layout { grid-template-columns: 1fr; }
  .docs-sidebar {
    position: static;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--border-soft);
    display: none;
  }
  .docs-sidebar.open { display: block; }
  .sidebar-toggle { display: block; }
  .docs-content { padding: 24px 18px 60px; }
}

/* ── Print ── */
@media print {
  .docs-sidebar, .site-header, .site-footer, .sidebar-toggle { display: none; }
  .docs-layout { grid-template-columns: 1fr; }
  .docs-content { max-width: 100%; padding: 0; }
}

/* ── Examples gallery ── */
.example-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
  gap: 16px;
  margin-bottom: 32px;
}
.example-card {
  background: var(--panel);
  border: 1px solid var(--border-soft);
  border-radius: var(--radius);
  padding: 20px;
  transition: border-color 0.2s;
}
.example-card:hover { border-color: var(--border); }
.example-card h3 { margin-bottom: 8px; }
.example-card p { color: var(--text-dim); font-size: 0.88rem; margin-bottom: 12px; }

/* ── Changelog ── */
.changelog-entry {
  margin-bottom: 32px;
  padding-bottom: 32px;
  border-bottom: 1px solid var(--border-soft);
}
.changelog-entry:last-child { border-bottom: none; }
.changelog-version {
  font-family: var(--mono);
  font-size: 0.82rem;
  color: var(--accent);
  background: var(--accent-dim);
  border: 1px solid var(--accent-border);
  border-radius: 999px;
  padding: 2px 10px;
  display: inline-block;
  margin-bottom: 8px;
}
.changelog-date {
  font-size: 0.82rem;
  color: var(--muted);
  margin-bottom: 12px;
}

/* ── Roadmap status badges ── */
.status {
  font-size: 0.72rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  border-radius: 999px;
  padding: 2px 8px;
  display: inline-block;
}
.status-planned { background: rgba(125, 138, 151, 0.15); color: var(--muted); }
.status-progress { background: var(--accent-dim); color: var(--accent); border: 1px solid var(--accent-border); }
.status-done { background: rgba(158, 203, 122, 0.12); color: #9ecb7a; border: 1px solid rgba(158, 203, 122, 0.3); }
