/*
 * docs.css — Documentation layout: sidebar, breadcrumbs, prose, prev/next nav
 */

/* ── Docs page shell ─────────────────────────────────────────────────────── */
.docs-layout {
  max-width: var(--content-width);
  margin: 0 auto;
  padding: 0 var(--space-6);
  display: grid;
  grid-template-columns: var(--docs-sidebar-width) 1fr;
  grid-template-areas: "sidebar main";
  gap: var(--space-12);
  align-items: start;
  min-height: calc(100vh - var(--header-height));
}

/* ── Sidebar ─────────────────────────────────────────────────────────────── */
.docs-sidebar {
  grid-area: sidebar;
  position: sticky;
  top: calc(var(--header-height) + var(--space-6));
  padding: var(--space-6) 0;
  overflow-y: auto;
  max-height: calc(100vh - var(--header-height) - var(--space-12));
}

.sidebar-section {
  margin-bottom: var(--space-6);
}

.sidebar-section__heading {
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--color-text-subtle);
  text-transform: uppercase;
  letter-spacing: 0.1em;
  padding: 0 var(--space-3);
  margin-bottom: var(--space-2);
}

.sidebar-nav {
  list-style: none;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.sidebar-nav__item a {
  display: block;
  padding: var(--space-2) var(--space-3);
  border-radius: var(--radius-sm);
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  transition: color var(--transition-fast), background var(--transition-fast);
  text-decoration: none;
}

.sidebar-nav__item a:hover {
  color: var(--color-text);
  background: var(--color-surface);
  text-decoration: none;
}

.sidebar-nav__item a.is-active,
.sidebar-nav__item a[aria-current="page"] {
  color: var(--color-accent);
  background: rgba(88, 166, 255, 0.08);
  font-weight: 500;
}

.sidebar-nav__item--child a {
  padding-left: var(--space-6);
  font-size: var(--text-xs);
}

/* ── Main content ────────────────────────────────────────────────────────── */
.docs-main {
  grid-area: main;
  padding: var(--space-8) 0 var(--space-20);
  min-width: 0; /* prevent overflow in grid */
}

/* ── Breadcrumbs ─────────────────────────────────────────────────────────── */
.breadcrumbs {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--text-sm);
  color: var(--color-text-subtle);
  margin-bottom: var(--space-8);
  flex-wrap: wrap;
}

.breadcrumbs a {
  color: var(--color-text-subtle);
}

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

.breadcrumbs__sep {
  color: var(--color-text-subtle);
}

.breadcrumbs__current {
  color: var(--color-text-muted);
}

/* ── Prose ───────────────────────────────────────────────────────────────── */
.prose {
  color: var(--color-text-muted);
  line-height: 1.75;
}

.prose h1 {
  font-size: var(--text-4xl);
  font-weight: 700;
  letter-spacing: -0.025em;
  color: var(--color-text);
  margin-bottom: var(--space-4);
  line-height: 1.2;
}

.prose h2 {
  font-size: var(--text-2xl);
  font-weight: 600;
  color: var(--color-text);
  margin-top: var(--space-12);
  margin-bottom: var(--space-4);
  padding-bottom: var(--space-3);
  border-bottom: 1px solid var(--color-border);
}

.prose h3 {
  font-size: var(--text-xl);
  font-weight: 600;
  color: var(--color-text);
  margin-top: var(--space-8);
  margin-bottom: var(--space-3);
}

.prose h4 {
  font-size: var(--text-lg);
  font-weight: 600;
  color: var(--color-text);
  margin-top: var(--space-6);
  margin-bottom: var(--space-2);
}

.prose p {
  margin-bottom: var(--space-4);
}

.prose ul,
.prose ol {
  padding-left: var(--space-6);
  margin-bottom: var(--space-4);
}

.prose li {
  margin-bottom: var(--space-2);
}

.prose li::marker {
  color: var(--color-text-subtle);
}

.prose a {
  color: var(--color-accent);
  text-decoration: underline;
  text-underline-offset: 3px;
}

.prose a:hover {
  color: var(--color-accent-hover);
}

.prose blockquote {
  border-left: 3px solid var(--color-accent);
  padding: var(--space-3) var(--space-5);
  background: rgba(88, 166, 255, 0.05);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  margin: var(--space-6) 0;
}

.prose blockquote p {
  margin-bottom: 0;
  color: var(--color-text-muted);
}

.prose table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--space-6) 0;
  font-size: var(--text-sm);
  overflow-x: auto;
  display: block;
}

.prose thead {
  background: var(--color-surface);
}

.prose th {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  font-weight: 600;
  color: var(--color-text);
  border-bottom: 2px solid var(--color-border);
  white-space: nowrap;
}

.prose td {
  padding: var(--space-3) var(--space-4);
  border-bottom: 1px solid var(--color-border-muted);
  color: var(--color-text-muted);
}

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

.prose pre {
  margin: var(--space-6) 0;
}

.prose hr {
  margin: var(--space-10) 0;
}

/* ── Callout / admonition ────────────────────────────────────────────────── */
.callout {
  display: flex;
  gap: var(--space-4);
  padding: var(--space-4) var(--space-5);
  border-radius: var(--radius-md);
  margin: var(--space-6) 0;
  font-size: var(--text-sm);
  line-height: 1.6;
}

.callout--note {
  background: rgba(88, 166, 255, 0.06);
  border: 1px solid rgba(88, 166, 255, 0.2);
}

.callout--warning {
  background: rgba(210, 153, 34, 0.06);
  border: 1px solid rgba(210, 153, 34, 0.25);
}

.callout--tip {
  background: rgba(63, 185, 80, 0.06);
  border: 1px solid rgba(63, 185, 80, 0.2);
}

.callout__icon {
  font-size: 1rem;
  flex-shrink: 0;
  padding-top: 1px;
}

.callout__body p {
  margin-bottom: 0;
  color: inherit;
}

/* ── Prev / Next page nav ────────────────────────────────────────────────── */
.docs-nav-footer {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-4);
  margin-top: var(--space-12);
  padding-top: var(--space-8);
  border-top: 1px solid var(--color-border);
}

.docs-nav-footer__link {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  padding: var(--space-4) var(--space-5);
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  text-decoration: none;
  color: inherit;
  transition: border-color var(--transition-fast);
}

.docs-nav-footer__link:hover {
  border-color: var(--color-accent);
  text-decoration: none;
}

.docs-nav-footer__link--next {
  text-align: right;
  justify-self: end;
}

.docs-nav-footer__label {
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--color-text-subtle);
  text-transform: uppercase;
  letter-spacing: 0.08em;
}

.docs-nav-footer__title {
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--color-accent);
}

/* ── Section index (overview page) ──────────────────────────────────────── */
.doc-index {
  max-width: var(--content-width);
  margin: 0 auto;
  padding: var(--space-12) var(--space-6);
}

.doc-index__title {
  font-size: var(--text-4xl);
  font-weight: 700;
  letter-spacing: -0.025em;
  margin-bottom: var(--space-4);
}

.doc-index__desc {
  font-size: var(--text-lg);
  color: var(--color-text-muted);
  max-width: 52ch;
  margin-bottom: var(--space-12);
  line-height: 1.6;
}

.doc-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: var(--space-4);
}

.doc-card {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
  text-decoration: none;
  color: inherit;
  transition: border-color var(--transition-fast);
}

.doc-card:hover {
  border-color: var(--color-accent);
  text-decoration: none;
}

.doc-card__title {
  font-size: var(--text-base);
  font-weight: 600;
  color: var(--color-text);
}

.doc-card__desc {
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  line-height: 1.5;
}

/* ── Responsive ──────────────────────────────────────────────────────────── */
@media (max-width: 900px) {
  .docs-layout {
    grid-template-columns: 1fr;
    grid-template-areas: "main";
    padding: 0 var(--space-4);
  }

  .docs-sidebar {
    display: none;
  }
}

@media (max-width: 600px) {
  .docs-nav-footer {
    grid-template-columns: 1fr;
  }

  .docs-nav-footer__link--next {
    text-align: left;
    justify-self: stretch;
  }
}