/* ==========================================================================
   Documentation — Sidebar + Content Layout
   ========================================================================== */

.docs-layout {
  display: flex;
  min-height: 100vh;
  padding-top: var(--header-height);
}

/* ---------- Sidebar ---------- */
.docs-sidebar {
  width: 260px;
  flex-shrink: 0;
  position: sticky;
  top: var(--header-height);
  height: calc(100vh - var(--header-height));
  overflow-y: auto;
  padding: var(--space-6) var(--space-4) var(--space-6) var(--space-6);
  border-right: 1px solid var(--color-border);
  background: var(--color-bg);
  scrollbar-width: thin;
  scrollbar-color: var(--color-border) transparent;
}

.docs-sidebar::-webkit-scrollbar {
  width: 4px;
}

.docs-sidebar::-webkit-scrollbar-thumb {
  background: var(--color-border);
  border-radius: 4px;
}

.docs-sidebar-toggle {
  display: none;
  width: 100%;
  padding: var(--space-3) var(--space-4);
  background: var(--color-bg-alt);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  font-size: var(--text-sm);
  font-weight: var(--font-semibold);
  color: var(--color-secondary);
  cursor: pointer;
  margin-bottom: var(--space-4);
  text-align: left;
}

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

.docs-nav-group-title {
  font-size: var(--text-xs);
  font-weight: var(--font-bold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-text-muted);
  padding: var(--space-2) var(--space-3);
  margin-bottom: var(--space-1);
}

.docs-nav-link {
  display: block;
  padding: var(--space-2) var(--space-3);
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  border-radius: var(--radius-sm);
  transition: all var(--transition-fast);
  text-decoration: none;
}

.docs-nav-link:hover {
  color: var(--color-primary);
  background: var(--color-primary-bg);
}

.docs-nav-link.active {
  color: var(--color-primary);
  background: var(--color-primary-bg);
  font-weight: var(--font-medium);
}

/* ---------- Content ---------- */
.docs-content {
  flex: 1;
  min-width: 0;
  max-width: 860px;
  padding: var(--space-10) var(--space-10) var(--space-16);
}

.docs-content h1 {
  font-size: var(--text-4xl);
  margin-bottom: var(--space-4);
}

.docs-content h2 {
  font-size: var(--text-2xl);
  margin-top: var(--space-16);
  margin-bottom: var(--space-4);
  padding-top: var(--space-8);
  border-top: 1px solid var(--color-border-light);
}

.docs-content h2:first-of-type {
  margin-top: var(--space-8);
  border-top: none;
  padding-top: 0;
}

.docs-content h3 {
  font-size: var(--text-xl);
  margin-top: var(--space-8);
  margin-bottom: var(--space-3);
}

.docs-content h4 {
  font-size: var(--text-lg);
  margin-top: var(--space-6);
  margin-bottom: var(--space-2);
}

.docs-content p {
  margin-bottom: var(--space-4);
  line-height: var(--leading-relaxed);
}

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

.docs-content ul { list-style: disc; }
.docs-content ol { list-style: decimal; }

.docs-content li {
  margin-bottom: var(--space-2);
  color: var(--color-text-secondary);
  line-height: var(--leading-relaxed);
}

.docs-content a {
  color: var(--color-primary);
  text-decoration: underline;
  text-underline-offset: 2px;
}

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

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

.docs-content th {
  font-weight: var(--font-semibold);
  color: var(--color-secondary);
  background: var(--color-bg-alt);
}

.docs-content td {
  color: var(--color-text-secondary);
}

.docs-content blockquote {
  border-left: 3px solid var(--color-primary);
  padding: var(--space-3) var(--space-5);
  margin: var(--space-4) 0;
  background: var(--color-primary-bg);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  color: var(--color-text-secondary);
}

.docs-content .note {
  padding: var(--space-4) var(--space-5);
  background: #EFF6FF;
  border: 1px solid #BFDBFE;
  border-radius: var(--radius-md);
  margin: var(--space-4) 0;
  font-size: var(--text-sm);
}

.docs-content .warning {
  padding: var(--space-4) var(--space-5);
  background: #FFFBEB;
  border: 1px solid #FDE68A;
  border-radius: var(--radius-md);
  margin: var(--space-4) 0;
  font-size: var(--text-sm);
}

/* ---------- Responsive ---------- */
@media (max-width: 900px) {
  .docs-sidebar {
    position: fixed;
    left: -280px;
    top: var(--header-height);
    z-index: var(--z-overlay);
    transition: left var(--transition-base);
    box-shadow: none;
  }

  .docs-sidebar.open {
    left: 0;
    box-shadow: var(--shadow-xl);
  }

  .docs-sidebar-toggle {
    display: block;
  }

  .docs-content {
    padding: var(--space-6) var(--space-4) var(--space-12);
  }
}