/* ============================================================
   LAABS Audio — Documentation Page Styles
   ============================================================ */

/* ── ─── ─── DOCS LAYOUT ─── ─── ── */

.docs-hero {
  padding-top: 100px;
  padding-bottom: clamp(var(--space-10), 5vw, var(--space-16));
  background: linear-gradient(180deg, var(--forest-900) 0%, var(--bg-light) 100%);
  border-bottom: 1px solid var(--border-light);
}

.docs-hero__inner {
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
}

.docs-hero__breadcrumb {
  font-size: var(--text-sm);
  color: var(--forest-500);
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.docs-hero__breadcrumb a {
  color: var(--forest-500);
  transition: color var(--duration-fast);
}

.docs-hero__breadcrumb a:hover {
  color: var(--forest-800);
}

.docs-hero__breadcrumb span {
  color: var(--stone-400);
}

.docs-hero__title {
  font-family: var(--font-display);
  font-size: var(--text-4xl);
  line-height: 1.1;
  color: var(--text-dark);
}

.docs-hero__subtitle {
  font-size: var(--text-lg);
  color: var(--stone-600);
  max-width: 56ch;
  line-height: 1.65;
}

/* ── ─── ─── DOCS MAIN LAYOUT ─── ─── ── */

.docs-body {
  background-color: var(--bg-light);
  min-height: 60vh;
}

.docs-layout {
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: clamp(var(--space-8), 4vw, var(--space-16));
  align-items: start;
  padding-block: clamp(var(--space-10), 5vw, var(--space-16));
}

/* ── ─── ─── SIDEBAR ─── ─── ── */

.docs-sidebar {
  position: sticky;
  top: 90px;
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
}

.docs-sidebar__title {
  font-size: var(--text-xs);
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--stone-400);
  margin-bottom: var(--space-2);
  padding-bottom: var(--space-2);
  border-bottom: 1px solid var(--border-light);
}

.docs-sidebar__link {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  border-radius: var(--radius-md);
  font-size: var(--text-sm);
  color: var(--stone-600);
  transition: background-color var(--duration-fast), color var(--duration-fast);
  border-left: 2px solid transparent;
}

.docs-sidebar__link:hover {
  background-color: var(--forest-100);
  color: var(--forest-800);
}

.docs-sidebar__link.is-active {
  background-color: var(--forest-100);
  color: var(--forest-800);
  border-left-color: var(--forest-600);
  font-weight: 600;
}

.docs-sidebar__icon {
  font-size: 1rem;
  flex-shrink: 0;
}

/* ── ─── ─── DOCS CONTENT ─── ─── ── */

.docs-content {
  max-width: 72ch;
}

.docs-section {
  margin-bottom: clamp(var(--space-12), 6vw, var(--space-20));
  scroll-margin-top: 90px;
}

.docs-section__header {
  display: flex;
  align-items: center;
  gap: var(--space-4);
  margin-bottom: var(--space-6);
  padding-bottom: var(--space-4);
  border-bottom: 1px solid var(--border-light);
}

.docs-section__icon {
  font-size: 1.75rem;
  flex-shrink: 0;
}

.docs-section__title {
  font-family: var(--font-display);
  font-size: var(--text-2xl);
  line-height: 1.2;
  color: var(--text-dark);
}

.docs-section__body {
  display: flex;
  flex-direction: column;
  gap: var(--space-5);
}

.docs-section__body p {
  font-size: var(--text-base);
  line-height: 1.8;
  color: var(--stone-600);
}

.docs-section__body h3 {
  font-family: var(--font-display);
  font-size: var(--text-lg);
  color: var(--text-dark);
  margin-top: var(--space-4);
  margin-bottom: var(--space-2);
}

.docs-section__body ul {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  padding-left: var(--space-5);
  list-style: none;
}

.docs-section__body ul li {
  position: relative;
  font-size: var(--text-base);
  line-height: 1.7;
  color: var(--stone-600);
}

.docs-section__body ul li::before {
  content: '·';
  position: absolute;
  left: calc(-1 * var(--space-4));
  color: var(--forest-500);
  font-weight: 700;
  font-size: 1.2em;
}

/* Note/callout */
.docs-callout {
  padding: var(--space-5) var(--space-6);
  border-radius: var(--radius-lg);
  border-left: 3px solid;
  background-color: var(--stone-50);
  font-size: var(--text-sm);
  line-height: 1.7;
  color: var(--stone-600);
}

.docs-callout--info {
  border-color: var(--forest-500);
  background-color: var(--forest-50);
}

.docs-callout--warning {
  border-color: var(--amber-500);
  background-color: var(--amber-100);
  color: var(--forest-800);
}

.docs-callout__icon {
  margin-bottom: var(--space-1);
  font-weight: 700;
  font-size: var(--text-sm);
  color: inherit;
}

/* Code inline */
.docs-content code {
  font-family: 'Courier New', Courier, monospace;
  font-size: 0.875em;
  background-color: var(--forest-100);
  color: var(--forest-800);
  padding: 2px 6px;
  border-radius: 4px;
}

/* Steps */
.docs-steps {
  counter-reset: step;
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
}

.docs-step {
  display: grid;
  grid-template-columns: 32px 1fr;
  gap: var(--space-4);
  align-items: start;
}

.docs-step__number {
  counter-increment: step;
  width: 32px;
  height: 32px;
  border-radius: 50%;
  background-color: var(--forest-600);
  color: var(--cream);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: var(--text-sm);
  font-weight: 700;
  flex-shrink: 0;
  margin-top: 2px;
}

.docs-step__content {
  padding-top: 4px;
}

.docs-step__title {
  font-weight: 600;
  font-size: var(--text-base);
  color: var(--text-dark);
  margin-bottom: var(--space-1);
}

.docs-step__desc {
  font-size: var(--text-sm);
  color: var(--stone-600);
  line-height: 1.7;
}

/* ── ─── ─── COMING SOON BANNER ─── ─── ── */

.docs-wip-banner {
  background-color: var(--forest-900);
  color: var(--forest-300);
  text-align: center;
  padding: var(--space-4) var(--space-6);
  font-size: var(--text-sm);
  border-bottom: 1px solid var(--border-dark);
}

.docs-wip-banner strong {
  color: var(--amber-400);
}

/* ── ─── ─── RESPONSIVE ─── ─── ── */

@media (max-width: 768px) {
  .docs-layout {
    grid-template-columns: 1fr;
  }

  .docs-sidebar {
    position: static;
    flex-direction: row;
    flex-wrap: wrap;
    gap: var(--space-2);
    padding: var(--space-4);
    background-color: var(--forest-50);
    border-radius: var(--radius-lg);
    border: 1px solid var(--border-light);
  }

  .docs-sidebar__title {
    width: 100%;
    margin-bottom: 0;
    padding-bottom: 0;
    border-bottom: none;
  }

  .docs-sidebar__link {
    border-left: none;
    background-color: var(--forest-100);
    border-radius: var(--radius-full);
    padding: var(--space-2) var(--space-4);
  }

  .docs-sidebar__link.is-active {
    background-color: var(--forest-600);
    color: var(--cream);
    border-left: none;
  }
}