/* ============================================
   Docs Layout
   ============================================ */

.docs-layout {
  display: flex;
  min-height: 100vh;
  padding-top: 64px;
}

/* ============================================
   Sidebar
   ============================================ */

.docs-sidebar {
  position: fixed;
  top: 64px;
  left: 0;
  bottom: 0;
  width: 280px;
  overflow-y: auto;
  padding: var(--space-8) var(--space-5);
  border-right: 1px solid var(--color-border);
  background: var(--color-bg-alt);
  z-index: var(--z-dropdown);
  transition: background-color var(--transition-theme), border-color var(--transition-theme), transform var(--transition-base);
}

/* Subtle top gradient fade inside sidebar */
.docs-sidebar::before {
  content: '';
  position: sticky;
  top: 0;
  display: block;
  height: 24px;
  margin: calc(var(--space-8) * -1) calc(var(--space-5) * -1) var(--space-4);
  background: linear-gradient(to bottom, var(--color-bg-alt), transparent);
  z-index: 1;
  pointer-events: none;
}

.docs-sidebar__group {
  margin-bottom: var(--space-6);
}

.docs-sidebar__group-title {
  font-family: var(--font-display);
  font-size: 0.65rem;
  font-weight: var(--weight-bold);
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--color-text-muted);
  margin-bottom: var(--space-2);
  padding-left: var(--space-3);
}

.docs-sidebar__link {
  display: block;
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  padding: 6px var(--space-3);
  border-radius: var(--radius-md);
  transition: all var(--transition-fast);
  text-decoration: none;
  line-height: 1.5;
  border-left: 2px solid transparent;
}

.docs-sidebar__link:hover {
  color: var(--color-text);
  background: var(--color-accent-subtle);
}

.docs-sidebar__link.active {
  color: var(--color-accent);
  background: var(--color-accent-subtle);
  font-weight: var(--weight-medium);
  border-left-color: var(--color-accent);
}

/* Nested links */
.docs-sidebar__nested {
  padding-left: var(--space-4);
}

.docs-sidebar__nested .docs-sidebar__link {
  font-size: var(--text-xs);
  padding: var(--space-1) var(--space-3);
}

/* Collapsible sections */
.docs-sidebar__toggle {
  display: flex;
  align-items: center;
  justify-content: space-between;
  width: 100%;
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  padding: 6px var(--space-3);
  border-radius: var(--radius-md);
  transition: all var(--transition-fast);
  text-align: left;
}

.docs-sidebar__toggle:hover {
  color: var(--color-text);
  background: var(--color-accent-subtle);
}

.docs-sidebar__toggle.active {
  color: var(--color-accent);
}

.docs-sidebar__toggle-icon {
  width: 14px;
  height: 14px;
  transition: transform var(--transition-fast);
  flex-shrink: 0;
  opacity: 0.5;
}

.docs-sidebar__toggle:hover .docs-sidebar__toggle-icon {
  opacity: 1;
}

.docs-sidebar__toggle.expanded .docs-sidebar__toggle-icon {
  transform: rotate(90deg);
  opacity: 1;
}

.docs-sidebar__collapsible {
  display: none;
  padding-left: var(--space-4);
  margin-top: var(--space-1);
  margin-bottom: var(--space-1);
  border-left: 1px solid var(--color-border);
  margin-left: var(--space-3);
}

.docs-sidebar__collapsible.open {
  display: block;
}

/* Mobile sidebar */
.docs-sidebar__overlay {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.6);
  backdrop-filter: blur(4px);
  -webkit-backdrop-filter: blur(4px);
  z-index: calc(var(--z-dropdown) - 1);
}

@media (max-width: 1023px) {
  .docs-sidebar {
    transform: translateX(-100%);
    z-index: var(--z-overlay);
    box-shadow: 4px 0 24px rgba(0, 0, 0, 0.3);
  }

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

  .docs-sidebar.open ~ .docs-sidebar__overlay {
    display: block;
  }
}

/* ============================================
   Docs Content
   ============================================ */

.docs-content {
  flex: 1;
  margin-left: 280px;
  padding: var(--space-12) var(--space-12);
  max-width: 960px;
  min-width: 0;
}

@media (max-width: 1023px) {
  .docs-content {
    margin-left: 0;
    padding: var(--space-8) var(--space-6);
    max-width: none;
  }
}

@media (max-width: 640px) {
  .docs-content {
    padding: var(--space-6) var(--space-4);
  }
}

/* Mobile sidebar toggle */
.docs-mobile-toggle {
  display: none;
  position: fixed;
  bottom: var(--space-6);
  right: var(--space-6);
  width: 52px;
  height: 52px;
  background: linear-gradient(135deg, var(--color-accent), var(--color-secondary, var(--color-accent-hover)));
  color: #fff;
  border-radius: 50%;
  align-items: center;
  justify-content: center;
  box-shadow: 0 4px 20px var(--color-accent-glow);
  z-index: var(--z-sticky);
  transition: transform var(--transition-fast), box-shadow var(--transition-fast);
}

.docs-mobile-toggle:hover {
  transform: scale(1.08);
  box-shadow: 0 6px 28px var(--color-accent-glow);
}

.docs-mobile-toggle svg {
  width: 20px;
  height: 20px;
}

@media (max-width: 1023px) {
  .docs-mobile-toggle {
    display: flex;
  }
}

/* ============================================
   Docs Typography
   ============================================ */

.docs-content h2 {
  margin-top: var(--space-16);
  margin-bottom: var(--space-6);
  padding-bottom: var(--space-4);
  border-bottom: 1px solid var(--color-border);
  position: relative;
}

/* Accent underline on h2 */
.docs-content h2::after {
  content: '';
  position: absolute;
  bottom: -1px;
  left: 0;
  width: 48px;
  height: 2px;
  background: linear-gradient(90deg, var(--color-accent), var(--color-secondary, var(--color-accent-hover)));
  border-radius: 1px;
}

.docs-content h2:first-child {
  margin-top: 0;
}

.docs-content h3 {
  margin-top: var(--space-10);
  margin-bottom: var(--space-4);
  color: var(--color-text);
}

.docs-content h4 {
  margin-top: var(--space-8);
  margin-bottom: var(--space-3);
}

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

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

.docs-content ul {
  list-style: none;
}

.docs-content ul > li {
  position: relative;
  padding-left: var(--space-4);
}

/* Custom bullet — small accent dot */
.docs-content ul > li::before {
  content: '';
  position: absolute;
  left: 0;
  top: 0.65em;
  width: 5px;
  height: 5px;
  border-radius: 50%;
  background: var(--color-accent);
  opacity: 0.6;
}

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

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

.docs-content li code {
  font-size: 0.85em;
}

.docs-content .code-block {
  margin: var(--space-6) 0;
}

.docs-content blockquote {
  border-left: 3px solid var(--color-accent);
  padding: var(--space-4) var(--space-6);
  margin: var(--space-6) 0;
  background: var(--color-accent-subtle);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
}

.docs-content blockquote p {
  margin: 0;
  font-size: var(--text-sm);
  color: var(--color-text);
}

/* ============================================
   Docs Info Callout
   ============================================ */

.docs-callout {
  padding: var(--space-5) var(--space-6);
  border-radius: var(--radius-lg);
  margin: var(--space-6) 0;
  font-size: var(--text-sm);
  line-height: var(--leading-relaxed);
  border: 1px solid transparent;
}

.docs-callout--info {
  background: var(--color-accent-subtle);
  border-left: 3px solid var(--color-accent);
  border-color: var(--color-accent-subtle);
  border-left-color: var(--color-accent);
  color: var(--color-text);
}

.docs-callout--warning {
  background: rgba(251, 191, 36, 0.06);
  border-color: rgba(251, 191, 36, 0.1);
  border-left: 3px solid var(--color-warning);
  color: var(--color-text);
}

.docs-callout--tip {
  background: rgba(52, 211, 153, 0.06);
  border-color: rgba(52, 211, 153, 0.1);
  border-left: 3px solid var(--color-success);
  color: var(--color-text);
}

.docs-callout strong {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  margin-bottom: var(--space-2);
  font-family: var(--font-display);
  font-size: var(--text-sm);
  letter-spacing: -0.01em;
}

/* ============================================
   Method Signatures
   ============================================ */

.docs-method {
  background: var(--color-bg-code);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  padding: var(--space-4) var(--space-6);
  margin: var(--space-4) 0;
  font-family: var(--font-code);
  font-size: var(--text-sm);
  overflow-x: auto;
  transition: background-color var(--transition-theme), border-color var(--transition-base);
  line-height: 1.7;
}

.docs-method:hover {
  border-color: var(--color-border-strong);
}

/* ============================================
   Tables — Refined
   ============================================ */

.docs-content .table-wrap {
  border-radius: var(--radius-lg);
  overflow-x: auto;
  border: 1px solid var(--color-border);
  -webkit-overflow-scrolling: touch;
}

.docs-content table {
  margin: 0;
}

.docs-content th {
  font-family: var(--font-display);
  font-size: var(--text-xs);
  font-weight: var(--weight-semibold);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-text-muted);
  padding: var(--space-3) var(--space-5);
}

.docs-content td {
  padding: var(--space-3) var(--space-5);
  font-size: var(--text-sm);
}

/* ============================================
   Docs Sections Spacing
   ============================================ */

.docs-section {
  margin-bottom: var(--space-16);
}

.docs-section:last-child {
  margin-bottom: var(--space-24);
}

/* ============================================
   Docs-specific scrollbar (sidebar)
   ============================================ */

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

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

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

.docs-sidebar::-webkit-scrollbar-thumb:hover {
  background: var(--color-border-strong);
}

/* ============================================
   Mobile Responsive Fixes
   ============================================ */

@media (max-width: 640px) {
  .docs-content h2 {
    font-size: var(--text-xl);
    margin-top: var(--space-12);
  }

  .docs-content h3 {
    font-size: var(--text-lg);
  }

  .docs-content .code-block {
    margin-left: calc(var(--space-4) * -1);
    margin-right: calc(var(--space-4) * -1);
    border-radius: 0;
  }

  .docs-method {
    padding: var(--space-3) var(--space-4);
    font-size: var(--text-xs);
  }

  .docs-callout {
    padding: var(--space-4);
  }

  .docs-content th,
  .docs-content td {
    padding: var(--space-2) var(--space-3);
    font-size: var(--text-xs);
  }

  .docs-content blockquote {
    padding: var(--space-3) var(--space-4);
  }
}