/*
  Reference Page Layout
  Desktop: Sidebar TOC on left
  Mobile: Collapsible TOC block at top of content
*/

/* ===========================================
   Layout Container
   =========================================== */
.reference-layout {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: var(--space-xl);
  max-width: 85rem;
  margin: 0 auto;
  padding: var(--space-xl) var(--container-padding);
  min-height: calc(100vh - 200px);
}

/* ===========================================
   TOC Sidebar (Desktop)
   =========================================== */
.toc-sidebar {
  position: sticky;
  top: calc(70px + var(--space-lg));
  height: fit-content;
  max-height: calc(100vh - 100px);
  display: flex;
  flex-direction: column;
  background: var(--sand-2);
  border: 1px solid var(--sand-4);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

/* Toggle button - hidden on desktop */
.toc-toggle {
  display: none;
}

/* ===========================================
   TOC Navigation
   =========================================== */
.toc-nav {
  overflow-y: auto;
  padding: var(--space-md);
}

/* Desktop: add header-like styling to nav */
.toc-nav::before {
  content: 'On this page';
  display: block;
  font-family: var(--font-heading);
  font-size: var(--text-xs);
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--text-3);
  padding: 0 var(--space-sm) var(--space-sm);
  margin-bottom: var(--space-xs);
  border-bottom: 1px solid var(--sand-4);
}

.toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.toc-list li {
  margin: 0;
}

.toc-list a {
  display: block;
  padding: var(--space-sm) var(--space-md);
  font-size: var(--text-sm);
  font-weight: 450;
  color: var(--text-2);
  text-decoration: none;
  border-radius: var(--radius-md);
  border-left: 3px solid transparent;
  transition:
    color 0.15s ease,
    background-color 0.15s ease,
    border-color 0.15s ease;
  line-height: 1.4;
}

.toc-list a:hover {
  color: var(--text-1);
  background-color: var(--sand-3);
}

.toc-list a:focus-visible {
  outline: 2px solid var(--brand-color);
  outline-offset: 2px;
}

/* Active section highlight */
.toc-list a.is-active {
  color: var(--brand-color);
  background-color: var(--orange-1);
  border-left-color: var(--brand-color);
  font-weight: 500;
}

/* Custom scrollbar for TOC */
.toc-nav::-webkit-scrollbar {
  width: 6px;
}

.toc-nav::-webkit-scrollbar-track {
  background: transparent;
}

.toc-nav::-webkit-scrollbar-thumb {
  background: var(--sand-5);
  border-radius: 3px;
}

.toc-nav::-webkit-scrollbar-thumb:hover {
  background: var(--sand-6);
}

/* ===========================================
   Main Content Area
   =========================================== */
.reference-content {
  min-width: 0;
  padding-bottom: var(--space-3xl);
}

.reference-content > h1:first-child {
  margin-top: 0;
}

/* Scroll margin for anchor navigation */
.reference-content h2[id],
.reference-content h3[id] {
  scroll-margin-top: calc(70px + var(--space-xl));
}

.reference-content h2 + h3 {
  margin-top: var(--space-lg);
}

/* ===========================================
   Mobile / Tablet Styles
   =========================================== */
@media (max-width: 900px) {
  /* Switch to single column, TOC above content */
  .reference-layout {
    grid-template-columns: 1fr;
    gap: var(--space-lg);
    padding-top: var(--space-lg);
  }

  /* Sidebar becomes inline collapsible block */
  .toc-sidebar {
    position: static;
    max-height: none;
    order: -1; /* Ensure it's above content */
  }

  /* Show toggle button */
  .toc-toggle {
    display: flex;
    align-items: center;
    justify-content: space-between;
    width: 100%;
    padding: var(--space-md) var(--space-lg);
    background: var(--sand-3);
    border: none;
    border-radius: var(--radius-lg) var(--radius-lg) 0 0;
    font-family: var(--font-heading);
    font-size: var(--text-sm);
    font-weight: 600;
    color: var(--text-2);
    cursor: pointer;
    transition:
      background-color 0.15s ease,
      color 0.15s ease;
  }

  .toc-toggle:hover {
    background: var(--sand-4);
    color: var(--text-1);
  }

  .toc-toggle:focus-visible {
    outline: 2px solid var(--brand-color);
    outline-offset: 2px;
  }

  .toc-toggle-label {
    display: flex;
    align-items: center;
    gap: var(--space-sm);
  }

  .toc-toggle-icon {
    transition: transform 0.2s ease;
  }

  .toc-toggle[aria-expanded="true"] .toc-toggle-icon {
    transform: rotate(180deg);
  }

  /* Hide the desktop header pseudo-element */
  .toc-nav::before {
    display: none;
  }

  /* Collapse the nav by default */
  .toc-nav {
    display: none;
    padding: var(--space-sm) var(--space-md) var(--space-md);
    border-top: 1px solid var(--sand-4);
  }

  .toc-nav.is-expanded {
    display: block;
  }

  /* Adjust sidebar border radius when collapsed vs expanded */
  .toc-sidebar:has(.toc-toggle[aria-expanded="false"]) {
    border-radius: var(--radius-lg);
  }

  .toc-sidebar:has(.toc-toggle[aria-expanded="true"]) .toc-toggle {
    border-radius: var(--radius-lg) var(--radius-lg) 0 0;
  }

  /* Adjust scroll margin for mobile */
  .reference-content h2[id],
  .reference-content h3[id] {
    scroll-margin-top: var(--space-xl);
  }
}

/* ===========================================
   Print Styles
   =========================================== */
@media print {
  .reference-layout {
    display: block;
    max-width: none;
    padding: 0;
  }

  .toc-sidebar {
    display: none;
  }

  .reference-content {
    max-width: none;
  }

  .reference-content h2 {
    page-break-after: avoid;
  }

  .reference-content pre {
    page-break-inside: avoid;
    white-space: pre-wrap;
    word-wrap: break-word;
  }
}

/* ===========================================
   Reduced Motion
   =========================================== */
@media (prefers-reduced-motion: reduce) {
  .toc-toggle-icon {
    transition: none;
  }

  .toc-list a {
    transition: none;
  }
}