/* Docs-specific layout and component styles, layered on top of colors_and_type.css */

/* ── Layout ───────────────────────────────────────────────────────────────── */

.docs-shell {
  display: grid;
  grid-template-columns: 260px 1fr;
  grid-template-rows: auto 1fr;
  min-height: 100vh;
}

.docs-topbar {
  grid-column: 1 / -1;
  background: var(--bg-inverse);
  color: var(--fg-on-dark);
  display: flex;
  align-items: center;
  gap: var(--space-4);
  padding: 0 var(--space-6);
  height: 56px;
  border-bottom: 3px solid var(--auburn-orange);
}

.docs-topbar a {
  color: var(--fg-on-dark);
  text-decoration: none;
  font-weight: var(--fw-semibold);
  font-size: var(--fs-small);
  letter-spacing: var(--tracking-wide);
  text-transform: uppercase;
  opacity: 0.75;
  transition: opacity var(--dur-fast) var(--ease-standard);
}
.docs-topbar a:hover { opacity: 1; }
.docs-topbar a.home {
  font-family: var(--font-display);
  font-size: 1.1rem;
  letter-spacing: normal;
  text-transform: none;
  opacity: 1;
  margin-right: auto;
}

.docs-sidebar {
  background: var(--bg-alt);
  border-right: 1px solid var(--border);
  padding: var(--space-6) var(--space-5);
  overflow-y: auto;
}

.docs-sidebar nav { display: flex; flex-direction: column; gap: var(--space-6); }

.sidebar-section-label {
  font-size: var(--fs-eyebrow);
  font-weight: var(--fw-bold);
  letter-spacing: var(--tracking-caps);
  text-transform: uppercase;
  color: var(--fg-muted);
  margin-bottom: var(--space-2);
}

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

.docs-sidebar a {
  display: block;
  padding: var(--space-2) var(--space-3);
  border-radius: var(--radius-sm);
  color: var(--fg);
  text-decoration: none;
  font-size: var(--fs-small);
  transition: background var(--dur-fast) var(--ease-standard), color var(--dur-fast) var(--ease-standard);
}
.docs-sidebar a:hover { background: var(--border); color: var(--fg-1); }
.docs-sidebar a.active { background: var(--auburn-navy); color: var(--fg-on-dark); }

.docs-content {
  padding: var(--space-8) var(--space-8);
  max-width: 860px;
}

/* ── Typography helpers for docs ─────────────────────────────────────────── */

.doc-eyebrow {
  font-size: var(--fs-eyebrow);
  font-weight: var(--fw-bold);
  letter-spacing: var(--tracking-caps);
  text-transform: uppercase;
  color: var(--auburn-orange);
  margin-bottom: var(--space-2);
}

.doc-title {
  font-family: var(--font-display);
  font-size: var(--fs-h1);
  line-height: var(--lh-tight);
  color: var(--fg-1);
  margin: 0 0 var(--space-3);
}

.doc-lead {
  font-size: var(--fs-lead);
  color: var(--fg-2);
  line-height: var(--lh-relaxed);
  margin-bottom: var(--space-7);
  max-width: 60ch;
}

.doc-section { margin-bottom: var(--space-9); }

.doc-section h2 {
  font-size: var(--fs-h2);
  color: var(--fg-1);
  border-bottom: 2px solid var(--border);
  padding-bottom: var(--space-3);
  margin-bottom: var(--space-5);
}

.doc-section h3 {
  font-size: var(--fs-h3);
  color: var(--fg-1);
  margin: var(--space-6) 0 var(--space-3);
}

/* ── Status badges ────────────────────────────────────────────────────────── */

.badge {
  display: inline-block;
  font-size: var(--fs-micro);
  font-weight: var(--fw-bold);
  letter-spacing: var(--tracking-caps);
  text-transform: uppercase;
  padding: 2px var(--space-2);
  border-radius: var(--radius-pill);
  vertical-align: middle;
}
.badge-draft    { background: var(--auburn-yellow);      color: #5a3a00; }
.badge-active   { background: var(--auburn-medium-green); color: #fff; }
.badge-review   { background: var(--auburn-medium-blue);  color: #fff; }
.badge-stable   { background: var(--auburn-navy);         color: #fff; }

/* ── Cards (index page) ───────────────────────────────────────────────────── */

.doc-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: var(--space-5);
  margin-top: var(--space-6);
}

.doc-card {
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  padding: var(--space-5);
  text-decoration: none;
  color: inherit;
  display: block;
  box-shadow: var(--shadow-xs);
  transition: box-shadow var(--dur-base) var(--ease-standard), border-color var(--dur-base) var(--ease-standard);
}
.doc-card:hover {
  box-shadow: var(--shadow-md);
  border-color: var(--border-strong);
  color: inherit;
}
.doc-card h3 {
  font-size: var(--fs-h4);
  margin: var(--space-3) 0 var(--space-2);
  color: var(--fg-1);
}
.doc-card p {
  font-size: var(--fs-small);
  color: var(--fg-2);
  margin: 0;
  max-width: none;
}
.card-icon {
  font-size: 1.75rem;
  line-height: 1;
}

/* ── Responsive ───────────────────────────────────────────────────────────── */

@media (max-width: 768px) {
  .docs-shell {
    grid-template-columns: 1fr;
  }
  .docs-sidebar {
    display: none; /* TODO: mobile drawer */
  }
  .docs-content {
    padding: var(--space-5);
  }
}