/* Docs-specific styles. Loaded after styles.css on doc pages only. */

.docs-container {
  max-width: 1100px;
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: var(--space-7);
  align-items: start;
}

/* Sidebar (left rail) */
.docs-sidebar {
  position: sticky;
  top: var(--space-5);
  font-size: 14px;
  line-height: 1.45;
}
.docs-sidebar .docs-nav > ul {
  list-style: none;
  padding: 0;
  margin: 0;
}
.docs-nav-section h2 {
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--text-tertiary);
  margin: var(--space-5) 0 var(--space-2);
}
.docs-nav-section:first-child h2 {
  margin-top: 0;
}
.docs-nav-section ul {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
}
.docs-nav-section a {
  color: var(--text-secondary);
  border-bottom: none;
  display: block;
  padding: 4px 0;
}
.docs-nav-section a:hover {
  color: var(--text-primary);
}
.docs-nav-section a[aria-current="page"] {
  color: var(--brand-bright);
  font-weight: 600;
}

/* Mobile disclosure version of the nav */
.docs-nav-disclosure {
  display: none;
  margin-bottom: var(--space-5);
  border: 1px solid var(--divider);
  border-radius: var(--radius-md);
  padding: var(--space-3) var(--space-4);
  background: var(--surface-raised);
}
.docs-nav-disclosure summary {
  cursor: pointer;
  font-weight: 600;
}
.docs-nav-disclosure[open] summary {
  margin-bottom: var(--space-3);
}
.docs-nav-disclosure .docs-nav-section ul {
  margin-bottom: var(--space-3);
}

/* Article column */
.docs-article {
  min-width: 0;
}

/* Breadcrumbs */
.breadcrumbs ol {
  list-style: none;
  padding: 0;
  margin: 0 0 var(--space-3);
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
  font-size: 13px;
  color: var(--text-tertiary);
}
.breadcrumbs li + li::before {
  content: "›";
  margin-right: var(--space-2);
  color: var(--text-tertiary);
}
.breadcrumbs a {
  color: var(--text-secondary);
  border-bottom: none;
}
.breadcrumbs a:hover {
  color: var(--text-primary);
}
.breadcrumbs li[aria-current="page"] {
  color: var(--text-secondary);
}

/* Callouts (rendered from `> [!tip|warning|note]` blockquotes) */
.callout {
  background: var(--surface-raised);
  border-left: 3px solid var(--brand);
  border-radius: var(--radius-md);
  padding: var(--space-4) var(--space-5);
  margin: var(--space-5) 0;
}
.callout p { margin: 0; }
.callout p + p { margin-top: var(--space-3); }
.callout.warning {
  border-left-color: var(--color-warning);
  background: #241A08;
}
.callout.note {
  border-left-color: var(--text-tertiary);
}

/* Body — code formatting */
.docs-article code {
  background: var(--surface-overlay);
  padding: 1px 6px;
  border-radius: var(--radius-sm);
  font-size: 0.92em;
  color: var(--text-primary);
}
.docs-article pre {
  background: var(--surface-overlay);
  padding: var(--space-4);
  border-radius: var(--radius-md);
  overflow-x: auto;
  font-size: 14px;
  line-height: 1.5;
}
.docs-article pre code {
  background: none;
  padding: 0;
}

/* Updated stamp */
.docs-updated {
  margin-top: var(--space-7);
  padding-top: var(--space-4);
  border-top: 1px solid var(--divider);
  font-size: 13px;
  color: var(--text-tertiary);
}

/* Prev/next */
.docs-prev-next {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-4);
  margin-top: var(--space-6);
}
.docs-prev-next a {
  display: flex;
  flex-direction: column;
  padding: var(--space-4);
  background: var(--surface-raised);
  border: 1px solid var(--divider);
  border-radius: var(--radius-md);
  border-bottom: 1px solid var(--divider);
  text-decoration: none;
  color: var(--text-primary);
}
.docs-prev-next a:hover {
  border-color: var(--brand);
}
.docs-prev-next .docs-next {
  text-align: right;
}
.docs-prev-next .docs-prev-label,
.docs-prev-next .docs-next-label {
  font-size: 12px;
  color: var(--text-tertiary);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  margin-bottom: 2px;
}
.docs-prev-next .docs-prev-title,
.docs-prev-next .docs-next-title {
  font-weight: 600;
  color: var(--brand-bright);
}

/* Hub */
.docs-hub-section {
  margin-bottom: var(--space-7);
}
.docs-hub-section + .docs-hub-section {
  border-top: none;
  padding-top: 0;
}
.docs-hub-list {
  list-style: none;
  padding: 0;
  margin: 0;
  display: grid;
  gap: var(--space-3);
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
}
.docs-hub-item a {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  padding: var(--space-4);
  background: var(--surface-raised);
  border: 1px solid var(--divider);
  border-radius: var(--radius-md);
  border-bottom: 1px solid var(--divider);
  height: 100%;
  text-decoration: none;
  color: var(--text-primary);
}
.docs-hub-item a:hover {
  border-color: var(--brand);
}
.docs-hub-item-title {
  font-weight: 600;
  color: var(--brand-bright);
}
.docs-hub-item-desc {
  font-size: 14px;
  color: var(--text-secondary);
}

/* Responsive */
@media (max-width: 860px) {
  .docs-container {
    grid-template-columns: 1fr;
  }
  .docs-sidebar {
    display: none;
  }
  .docs-nav-disclosure {
    display: block;
  }
}