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

/* ---------- Docs Layout ---------- */

.docs-layout {
  display: grid;
  grid-template-columns: 250px 1fr;
  gap: var(--space-2xl);
  max-width: var(--container-max);
  margin-inline: auto;
  padding-inline: var(--container-padding);
  padding-top: calc(64px + var(--space-2xl));
  padding-bottom: var(--space-4xl);
  min-height: 100vh;
}

/* ---------- Sidebar ---------- */

.docs-sidebar {
  position: sticky;
  top: 80px;
  max-height: calc(100vh - 80px);
  overflow-y: auto;
  padding-right: var(--space-md);
  padding-bottom: var(--space-2xl);
  scrollbar-width: thin;
  scrollbar-color: var(--color-border) transparent;
}

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

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

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

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

/* Sidebar nav */

.docs-nav__section {
  margin-bottom: var(--space-lg);
}

.docs-nav__title {
  display: block;
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--color-text-secondary);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  margin-bottom: var(--space-sm);
  padding-left: var(--space-sm);
}

.docs-nav__list {
  display: flex;
  flex-direction: column;
}

.docs-nav__link {
  display: block;
  padding: 6px var(--space-sm);
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  border-left: 2px solid transparent;
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  transition: color var(--transition-fast), border-color var(--transition-fast), background-color var(--transition-fast);
}

.docs-nav__link:hover {
  color: var(--color-text-primary);
  background-color: var(--color-bg-elevated);
}

.docs-nav__link.active {
  color: var(--color-accent);
  border-left-color: var(--color-accent);
  background-color: var(--color-bg-elevated);
}

/* Nested links */

.docs-nav__sublist {
  display: flex;
  flex-direction: column;
  padding-left: var(--space-md);
}

.docs-nav__sublist .docs-nav__link {
  font-size: var(--text-xs);
  padding: 4px var(--space-sm);
}

/* ---------- Content ---------- */

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

/* Anchor offset for fixed nav */

.docs-content [id] {
  scroll-margin-top: 80px;
}

/* Heading spacing */

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

.docs-content h2 {
  font-size: var(--text-2xl);
  margin-top: var(--space-3xl);
  margin-bottom: var(--space-lg);
  padding-bottom: var(--space-sm);
  border-bottom: 1px solid var(--color-border);
}

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

.docs-content h2:first-of-type {
  margin-top: var(--space-2xl);
}

/* Paragraphs and lists in docs */

.docs-content p {
  color: var(--color-text-secondary);
  line-height: var(--leading-normal);
  margin-bottom: var(--space-md);
}

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

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

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

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

.docs-content li code {
  font-size: var(--text-xs);
}

/* Enhanced code blocks for docs */

.docs-content .code-block {
  margin-bottom: var(--space-lg);
}

.docs-content pre {
  margin-bottom: var(--space-lg);
}

/* Shortcode reference styling */

.docs-shortcode {
  background-color: var(--color-bg-elevated);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-lg);
  margin-bottom: var(--space-md);
}

.docs-shortcode__name {
  font-family: var(--font-code);
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--color-accent);
  margin-bottom: var(--space-xs);
}

.docs-shortcode__desc {
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  margin-bottom: var(--space-sm);
}

.docs-shortcode__params {
  font-size: var(--text-xs);
  color: var(--color-text-secondary);
}

.docs-shortcode__params code {
  font-size: var(--text-xs);
  color: var(--color-accent-secondary);
}

/* Hook reference */

.docs-hook {
  background-color: var(--color-bg-elevated);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-lg);
  margin-bottom: var(--space-md);
}

.docs-hook__name {
  font-family: var(--font-code);
  font-size: var(--text-sm);
  color: var(--color-accent);
  margin-bottom: var(--space-xs);
}

.docs-hook__type {
  display: inline-block;
  font-size: var(--text-xs);
  font-weight: 500;
  color: var(--color-accent-secondary);
  background-color: var(--color-bg-subtle);
  padding: 2px 8px;
  border-radius: var(--radius-full);
  margin-bottom: var(--space-sm);
}

.docs-hook__desc {
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
}

/* API endpoint styling */

.docs-endpoint {
  display: flex;
  align-items: center;
  gap: var(--space-sm);
  margin-bottom: var(--space-sm);
}

.docs-endpoint__method {
  display: inline-block;
  font-size: var(--text-xs);
  font-weight: 700;
  padding: 2px 8px;
  border-radius: var(--radius-sm);
  font-family: var(--font-code);
}

.docs-endpoint__method--get {
  background-color: rgba(16, 185, 129, 0.15);
  color: var(--color-success);
}

.docs-endpoint__method--post {
  background-color: rgba(99, 102, 241, 0.15);
  color: var(--color-accent);
}

.docs-endpoint__method--put {
  background-color: rgba(209, 154, 102, 0.15);
  color: #d19a66;
}

.docs-endpoint__method--delete {
  background-color: rgba(224, 108, 117, 0.15);
  color: #e06c75;
}

.docs-endpoint__path {
  font-family: var(--font-code);
  font-size: var(--text-sm);
  color: var(--color-text-primary);
}

/* Notification list */

.docs-notification {
  display: flex;
  align-items: flex-start;
  gap: var(--space-sm);
  padding: var(--space-sm) 0;
  border-bottom: 1px solid var(--color-border);
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
}

.docs-notification:last-child {
  border-bottom: none;
}

.docs-notification__icon {
  flex-shrink: 0;
  width: 6px;
  height: 6px;
  margin-top: 8px;
  border-radius: 50%;
  background-color: var(--color-accent);
}

/* FAQ */

.docs-faq {
  margin-bottom: var(--space-lg);
}

.docs-faq__question {
  font-size: var(--text-base);
  font-weight: 600;
  color: var(--color-text-primary);
  margin-bottom: var(--space-sm);
}

.docs-faq__answer {
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  line-height: var(--leading-normal);
}

/* Intro text */

.docs-intro {
  font-size: var(--text-lg);
  color: var(--color-text-secondary);
  margin-bottom: var(--space-2xl);
  max-width: 600px;
}

/* ---------- Mobile Sidebar Toggle ---------- */

.docs-sidebar-toggle {
  display: none;
  position: fixed;
  bottom: var(--space-lg);
  right: var(--space-lg);
  z-index: var(--z-overlay);
  width: 48px;
  height: 48px;
  align-items: center;
  justify-content: center;
  background-color: var(--color-accent);
  color: #fff;
  border-radius: 50%;
  box-shadow: var(--shadow-lg);
  transition: background-color var(--transition-fast);
}

.docs-sidebar-toggle:hover {
  background-color: var(--color-accent-hover);
}

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

/* ---------- Docs Hub (index) ---------- */

.docs-hub {
  max-width: var(--container-max);
  margin-inline: auto;
  padding-inline: var(--container-padding);
  padding-top: calc(64px + var(--space-3xl));
  padding-bottom: var(--space-4xl);
  min-height: 100vh;
}

.docs-hub h1 {
  font-size: var(--text-3xl);
  margin-bottom: var(--space-md);
}

.docs-hub__grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--space-xl);
  margin-top: var(--space-2xl);
}

.docs-hub__card {
  display: flex;
  flex-direction: column;
  padding: var(--space-xl);
  background-color: var(--color-bg-elevated);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}

.docs-hub__card:hover {
  border-color: var(--color-accent);
  box-shadow: 0 0 0 1px var(--color-accent);
}

.docs-hub__card-title {
  font-size: var(--text-xl);
  font-weight: 600;
  color: var(--color-text-primary);
  margin-bottom: var(--space-sm);
}

.docs-hub__card-desc {
  font-size: var(--text-sm);
  color: var(--color-text-secondary);
  line-height: var(--leading-normal);
  margin-bottom: var(--space-lg);
  flex: 1;
}

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

/* ---------- Responsive: Tablet & Mobile ---------- */

@media (max-width: 768px) {
  .docs-layout {
    grid-template-columns: 1fr;
    padding-top: calc(64px + var(--space-lg));
  }

  .docs-sidebar {
    position: fixed;
    top: 64px;
    left: 0;
    right: 0;
    bottom: 0;
    z-index: var(--z-overlay);
    max-height: none;
    background-color: var(--color-bg-primary);
    padding: var(--space-lg) var(--container-padding);
    transform: translateX(-100%);
    transition: transform var(--transition-base);
    overflow-y: auto;
  }

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

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

  .docs-sidebar-overlay {
    display: none;
    position: fixed;
    top: 64px;
    left: 0;
    right: 0;
    bottom: 0;
    z-index: calc(var(--z-overlay) - 1);
    background-color: rgba(0, 0, 0, 0.5);
  }

  .docs-sidebar-overlay.open {
    display: block;
  }

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

  .docs-content h2 {
    margin-top: var(--space-2xl);
  }

  .docs-content h3 {
    margin-top: var(--space-xl);
  }

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