/**
 * Documentation-specific styles
 */

/* ========================================
   DOCS LAYOUT
   ======================================== */

.docs-layout {
  display: grid;
  grid-template-columns: var(--sidebar-width) minmax(0, 1fr);
  gap: var(--space-8);
  max-width: calc(var(--container-max) + var(--sidebar-width) + 200px);
  margin: 0 auto;
  padding: calc(var(--header-height) + var(--space-8)) var(--space-6) var(--space-16);
}

/* With TOC */
.docs-layout:has(.docs-toc) {
  grid-template-columns: var(--sidebar-width) minmax(0, 1fr) 200px;
}

/* ========================================
   SIDEBAR
   ======================================== */

.sidebar {
  position: sticky;
  top: calc(var(--header-height) + var(--space-8));
  height: fit-content;
  max-height: calc(100vh - var(--header-height) - var(--space-16));
  overflow-y: auto;
  padding-right: var(--space-4);

  /* Custom scrollbar */
  scrollbar-width: thin;
  scrollbar-color: var(--border-medium) transparent;
}

.sidebar::-webkit-scrollbar {
  width: 6px;
}

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

.sidebar::-webkit-scrollbar-thumb {
  background: var(--border-medium);
  border-radius: var(--radius-full);
}

.sidebar-nav {
  display: flex;
  flex-direction: column;
  gap: var(--space-6);
}

.sidebar-section {
  /* Section styling */
}

.sidebar-title {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-family: var(--font-display);
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-muted);
  margin-bottom: var(--space-3);
  padding: 0 var(--space-3);
}

.sidebar-title svg {
  width: 14px;
  height: 14px;
  opacity: 0.6;
}

.sidebar-links {
  list-style: none;
  display: flex;
  flex-direction: column;
  gap: var(--space-0_5);
}

.sidebar-links a {
  display: block;
  padding: var(--space-2) var(--space-3);
  font-size: var(--text-sm);
  color: var(--text-secondary);
  border-radius: var(--radius-md);
  transition: all var(--duration-fast) var(--ease-gentle);
  border-left: 2px solid transparent;
}

.sidebar-links a:hover {
  background: var(--bg-glass);
  color: var(--text-primary);
}

.sidebar-links a.active {
  background: var(--accent-subtle);
  color: var(--accent-text);
  border-left-color: var(--accent-primary);
  font-weight: 500;
}

/* Mobile sidebar toggle */
.sidebar-mobile-toggle {
  display: none;
  position: fixed;
  bottom: var(--space-6);
  left: var(--space-6);
  width: 48px;
  height: 48px;
  background: var(--bg-elevated);
  border: 1px solid var(--border-medium);
  border-radius: var(--radius-full);
  color: var(--text-muted);
  cursor: pointer;
  box-shadow: var(--shadow-lg);
  z-index: 100;
  align-items: center;
  justify-content: center;
}

.sidebar-mobile-toggle:hover {
  background: var(--bg-tertiary);
  color: var(--text-primary);
}

/* ========================================
   DOCS CONTENT
   ======================================== */

.docs-content {
  min-width: 0;
  max-width: 800px;
}

.docs-breadcrumb {
  margin-bottom: var(--space-4);
}

.docs-breadcrumb ol {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  list-style: none;
  font-size: var(--text-sm);
}

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

.docs-breadcrumb li:not(:last-child)::after {
  content: '/';
  color: var(--text-dimmed);
}

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

.docs-breadcrumb a:hover {
  color: var(--text-primary);
}

.docs-breadcrumb span {
  color: var(--text-secondary);
}

.docs-header {
  margin-bottom: var(--space-8);
  padding-bottom: var(--space-6);
  border-bottom: 1px solid var(--border-subtle);
}

.docs-category {
  display: inline-block;
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--accent-primary);
  background: var(--accent-subtle);
  padding: var(--space-1) var(--space-2);
  border-radius: var(--radius-sm);
  margin-bottom: var(--space-3);
}

.docs-header h1 {
  font-size: var(--text-4xl);
  font-weight: 800;
  line-height: 1.1;
  margin-bottom: var(--space-4);
}

.docs-subtitle {
  font-size: var(--text-lg);
  color: var(--text-secondary);
  line-height: 1.6;
}

/* ========================================
   PROSE STYLES (content)
   ======================================== */

.prose {
  font-size: var(--text-base);
  line-height: 1.75;
  color: var(--text-secondary);
}

.prose h2 {
  font-size: var(--text-2xl);
  font-weight: 700;
  color: var(--text-primary);
  margin-top: var(--space-12);
  margin-bottom: var(--space-4);
  scroll-margin-top: calc(var(--header-height) + var(--space-8));
}

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

.prose h4 {
  font-size: var(--text-lg);
  font-weight: 600;
  color: var(--text-primary);
  margin-top: var(--space-6);
  margin-bottom: var(--space-2);
  scroll-margin-top: calc(var(--header-height) + var(--space-8));
}

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

.prose a {
  color: var(--accent-text);
  text-decoration: underline;
  text-underline-offset: 2px;
  transition: color var(--duration-fast);
}

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

.prose strong {
  font-weight: 600;
  color: var(--text-primary);
}

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

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

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

.prose blockquote {
  border-left: 3px solid var(--accent-primary);
  padding-left: var(--space-4);
  margin: var(--space-6) 0;
  color: var(--text-secondary);
  font-style: italic;
}

.prose hr {
  border: none;
  height: 1px;
  background: var(--border-subtle);
  margin: var(--space-12) 0;
}

.prose img {
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-lg);
  margin: var(--space-6) 0;
}

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

.prose th,
.prose td {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  border-bottom: 1px solid var(--border-subtle);
}

.prose th {
  font-weight: 600;
  color: var(--text-primary);
  background: var(--bg-secondary);
}

.prose tr:hover td {
  background: var(--bg-glass);
}

/* Inline code */
.prose code:not(pre code) {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background: var(--bg-code-inline);
  padding: 0.15em 0.4em;
  border-radius: var(--radius-xs);
  color: var(--text-primary);
}

/* Code blocks in prose */
.prose pre {
  margin: var(--space-6) 0;
  background: var(--bg-code);
  border-radius: var(--radius-lg);
  overflow-x: auto;
}

.prose pre code {
  display: block;
  padding: var(--space-4);
  font-size: var(--text-sm);
  line-height: 1.7;
  color: var(--text-primary);
}

/* ========================================
   TABLE OF CONTENTS
   ======================================== */

.docs-toc {
  position: sticky;
  top: calc(var(--header-height) + var(--space-8));
  height: fit-content;
  max-height: calc(100vh - var(--header-height) - var(--space-16));
  overflow-y: auto;
}

.docs-toc-inner {
  padding-left: var(--space-4);
  border-left: 1px solid var(--border-subtle);
}

.docs-toc h4 {
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-muted);
  margin-bottom: var(--space-3);
}

.docs-toc-nav {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
}

.docs-toc-nav a {
  font-size: var(--text-sm);
  color: var(--text-muted);
  padding: var(--space-1) 0;
  transition: color var(--duration-fast);
}

.docs-toc-nav a:hover,
.docs-toc-nav a.active {
  color: var(--text-primary);
}

.docs-toc-nav a.active {
  color: var(--accent-text);
}

/* Nested TOC links */
.docs-toc-nav a[data-level='3'] {
  padding-left: var(--space-4);
  font-size: var(--text-xs);
}

/* ========================================
   PAGINATION
   ======================================== */

.docs-pagination {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-4);
  margin-top: var(--space-16);
  padding-top: var(--space-8);
  border-top: 1px solid var(--border-subtle);
}

.docs-pagination-prev,
.docs-pagination-next {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  padding: var(--space-4);
  background: var(--bg-elevated);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-lg);
  transition: all var(--duration-fast) var(--ease-gentle);
}

.docs-pagination-prev:hover,
.docs-pagination-next:hover {
  border-color: var(--border-medium);
  background: var(--bg-tertiary);
}

.docs-pagination-next {
  text-align: right;
}

.docs-pagination-label {
  font-size: var(--text-xs);
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-muted);
}

.docs-pagination-title {
  font-weight: 600;
  color: var(--text-primary);
}

/* ========================================
   CALLOUTS / ALERTS
   ======================================== */

.callout {
  display: flex;
  gap: var(--space-3);
  padding: var(--space-4);
  border-radius: var(--radius-lg);
  margin: var(--space-6) 0;
}

.callout-icon {
  flex-shrink: 0;
  width: 20px;
  height: 20px;
}

.callout-content {
  flex: 1;
}

.callout-title {
  font-weight: 600;
  margin-bottom: var(--space-1);
}

.callout-body {
  font-size: var(--text-sm);
}

.callout-info {
  background: var(--info-bg);
  border: 1px solid var(--info);
}

.callout-info .callout-icon {
  color: var(--info);
}
.callout-info .callout-title {
  color: var(--info);
}

.callout-warning {
  background: var(--warning-bg);
  border: 1px solid var(--warning);
}

.callout-warning .callout-icon {
  color: var(--warning);
}
.callout-warning .callout-title {
  color: var(--warning);
}

.callout-error {
  background: var(--error-bg);
  border: 1px solid var(--error);
}

.callout-error .callout-icon {
  color: var(--error);
}
.callout-error .callout-title {
  color: var(--error);
}

.callout-success {
  background: var(--success-bg);
  border: 1px solid var(--success);
}

.callout-success .callout-icon {
  color: var(--success);
}
.callout-success .callout-title {
  color: var(--success);
}

/* ========================================
   RESPONSIVE
   ======================================== */

@media (max-width: 1280px) {
  .docs-layout:has(.docs-toc) {
    grid-template-columns: var(--sidebar-width) minmax(0, 1fr);
  }

  .docs-toc {
    display: none;
  }
}

@media (max-width: 1024px) {
  .docs-layout {
    grid-template-columns: 1fr;
    padding-top: calc(var(--header-height) + var(--space-6));
  }

  .sidebar {
    position: fixed;
    top: var(--header-height);
    left: 0;
    bottom: 0;
    width: var(--sidebar-width);
    background: var(--bg-primary);
    border-right: 1px solid var(--border-subtle);
    padding: var(--space-6);
    transform: translateX(-100%);
    transition: transform var(--duration-slow) var(--ease-out);
    z-index: 900;
    max-height: none;
  }

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

  .sidebar-mobile-toggle {
    display: flex;
  }

  .docs-content {
    max-width: 100%;
  }
}

@media (max-width: 640px) {
  .docs-header h1 {
    font-size: var(--text-3xl);
  }

  .docs-pagination {
    grid-template-columns: 1fr;
  }

  .docs-pagination-next {
    text-align: left;
  }
}