/* ============================================================================
   av-guide.css — guides & articles on the living layer.
   Two concerns:
     1. Doc reading shell (sticky TOC sidebar + prose column) for living-doc.pug.
        Prose typography is shared from av-legal.css (.av-doc); this adds the
        shell, the TOC, and guide-specific blocks (code, tables, callouts).
     2. Hub card grid, shared by the guides hub and the new articles index.
   Built on av-tokens + av-components. Monochrome + orange accent. Day/night.
   ========================================================================== */

/* ── Doc shell: sticky TOC + prose ───────────────────────────────────────── */

.av-doc-shell {
  max-width: 1140px;
  margin: 0 auto;
  padding: calc(64px + var(--av-space-8)) var(--av-space-5) var(--av-space-10);
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr);
  gap: var(--av-space-8);
  align-items: start;
}

/* Prose column — override av-legal.css .av-doc's centered 760px box; here it
   lives in the grid track and owns its own padding. */
.av-doc.av-doc-prose {
  max-width: 760px;
  margin: 0;
  padding: 0;
}

/* ── TOC sidebar ─────────────────────────────────────────────────────────── */

.av-doc-toc {
  position: sticky;
  top: calc(64px + var(--av-space-5));
  align-self: start;
  font-size: 0.875rem;
}

/* JS builds: details.av-doc-toc__d[open] > summary + nav.av-doc-toc__nav > a */
.av-doc-toc__d {
  border-left: 1px solid var(--av-border);
  padding-left: var(--av-space-4);
}

.av-doc-toc__summary {
  font-family: var(--av-font-display);
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--av-text-muted);
  cursor: pointer;
  list-style: none;
  margin-bottom: var(--av-space-3);
}

.av-doc-toc__summary::-webkit-details-marker { display: none; }

.av-doc-toc__nav {
  display: flex;
  flex-direction: column;
  gap: var(--av-space-1);
}

.av-doc-toc__link {
  color: var(--av-text-muted);
  text-decoration: none;
  line-height: 1.4;
  padding: 3px 0;
  border-left: 2px solid transparent;
  margin-left: -1px;
  padding-left: var(--av-space-3);
  transition: color 0.15s, border-color 0.15s;
}

.av-doc-toc__link:hover { color: var(--av-text); }

.av-doc-toc__link.is-sub {
  padding-left: var(--av-space-5);
  font-size: 0.8125rem;
}

.av-doc-toc__link.is-active {
  color: var(--av-orange);
  border-left-color: var(--av-orange);
}

/* Page title + byline (guides/articles carry their h1 inside the prose column;
   av-legal.css styles h2/h3 but not h1, since legal used a separate header). */
.av-doc-prose h1 {
  font-family: var(--av-font-display);
  font-size: clamp(1.9rem, 4.5vw, 2.6rem);
  font-weight: 700;
  line-height: 1.12;
  letter-spacing: -0.02em;
  color: var(--av-text);
  margin: 0 0 var(--av-space-3);
}

.av-doc-meta {
  font-size: 0.875rem;
  color: var(--av-text-muted);
  margin: 0 0 var(--av-space-7);
}

/* ── Guide-specific prose blocks (atop the shared .av-doc typography) ─────── */

/* Fenced code blocks */
.av-doc-prose pre {
  background: var(--av-surface-raise);
  border: 1px solid var(--av-border);
  border-radius: var(--av-radius);
  padding: var(--av-space-4) var(--av-space-5);
  overflow-x: auto;
  margin: 0 0 var(--av-space-4);
  font-size: 0.875rem;
  line-height: 1.6;
}

.av-doc-prose pre code {
  background: none;
  border: none;
  padding: 0;
  color: var(--av-text);
  font-family: 'Courier New', Courier, monospace;
}

/* Tables (command references) */
.av-doc-prose table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 var(--av-space-5);
  font-size: 0.9375rem;
  border: 1px solid var(--av-border);
  border-radius: var(--av-radius);
  overflow: hidden;
}

.av-doc-prose thead {
  background: var(--av-coal);
  color: #fff;
}

[data-theme="light"] .av-doc-prose thead {
  background: #333;
}

.av-doc-prose th,
.av-doc-prose td {
  padding: var(--av-space-3) var(--av-space-4);
  text-align: left;
  vertical-align: top;
  border-bottom: 1px solid var(--av-border);
}

.av-doc-prose th {
  font-family: var(--av-font-display);
  font-weight: 600;
  font-size: 0.875rem;
}

.av-doc-prose tbody tr:nth-child(even) { background: var(--av-surface); }
.av-doc-prose tbody tr:last-child td { border-bottom: none; }

/* Callout / note */
.av-note {
  border-left: 3px solid var(--av-orange);
  background: var(--av-surface);
  border-radius: 0 var(--av-radius) var(--av-radius) 0;
  padding: var(--av-space-4) var(--av-space-5);
  margin: 0 0 var(--av-space-4);
  color: var(--av-text-muted);
}

.av-note strong { color: var(--av-text); }

/* ── Mobile: single column, TOC collapses to a disclosure at top ─────────── */

@media (max-width: 900px) {
  .av-doc-shell {
    grid-template-columns: minmax(0, 1fr);
    gap: var(--av-space-5);
  }

  .av-doc-toc {
    position: static;
    top: auto;
  }

  .av-doc-toc__d {
    border-left: none;
    border: 1px solid var(--av-border);
    border-radius: var(--av-radius);
    padding: var(--av-space-3) var(--av-space-4);
  }

  .av-doc-toc__summary { margin-bottom: 0; }
  .av-doc-toc__d[open] .av-doc-toc__summary { margin-bottom: var(--av-space-3); }
}

/* On desktop the TOC is always open and the summary label is decorative;
   keep the summary visible as the "On this page" header. */
@media (min-width: 901px) {
  .av-doc-toc__d { pointer-events: auto; }
  .av-doc-toc__summary { cursor: default; }
}

/* ── Hub: section card grid (guides hub + articles index) ────────────────── */

.av-hub {
  max-width: 1060px;
  margin: 0 auto;
  padding: calc(64px + var(--av-space-9)) var(--av-space-5) var(--av-space-10);
}

.av-hub__title {
  font-family: var(--av-font-display);
  font-size: clamp(2rem, 5vw, 3rem);
  font-weight: 700;
  letter-spacing: -0.02em;
  color: var(--av-text);
  margin: 0 0 var(--av-space-3);
}

.av-hub__lead {
  font-size: 1.0625rem;
  color: var(--av-text-muted);
  line-height: 1.65;
  max-width: 640px;
  margin: 0 0 var(--av-space-6);
}

.av-hub__section {
  font-family: var(--av-font-display);
  font-size: 0.72rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--av-orange);
  margin: var(--av-space-9) 0 var(--av-space-4);
  padding-bottom: var(--av-space-3);
  border-bottom: 1px solid var(--av-border);
}

.av-hub__section:first-of-type { margin-top: 0; }

.av-hub__grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: var(--av-space-4);
}

.av-hub__card {
  display: block;
  text-decoration: none;
  border: 1px solid var(--av-border);
  border-radius: var(--av-radius-lg);
  background: var(--av-surface);
  padding: var(--av-space-5);
  transition: border-color 0.15s, transform 0.15s, box-shadow 0.15s;
}

.av-hub__card:hover {
  border-color: var(--av-orange);
  transform: translateY(-2px);
  box-shadow: 0 0.5rem 1.25rem rgba(0, 0, 0, 0.12);
}

.av-hub__card-title {
  font-family: var(--av-font-display);
  font-size: 1.05rem;
  font-weight: 600;
  color: var(--av-text);
  margin: 0 0 var(--av-space-2);
}

.av-hub__card-desc {
  font-size: 0.9rem;
  color: var(--av-text-muted);
  line-height: 1.55;
  margin: 0;
}

.av-hub__card-tag {
  display: inline-block;
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--av-orange);
  margin-bottom: var(--av-space-2);
}

/* ── Article header (byline — no date) ───────────────────────────────────── */

.av-doc-header {
  margin: 0 0 var(--av-space-7);
}

.av-doc-byline {
  font-size: 0.8rem;
  color: var(--av-text-muted);
  font-variant-caps: small-caps;
  letter-spacing: 0.04em;
  margin: 0;
}

/* ── Compare table ────────────────────────────────────────────────────────── */

.av-compare-table-wrap {
  overflow-x: auto;
  margin: 0 0 var(--av-space-6);
}

.av-compare-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9375rem;
  border: 1px solid var(--av-border);
  border-radius: var(--av-radius);
  overflow: hidden;
}

.av-compare-table thead {
  background: var(--av-coal);
  color: #fff;
}

[data-theme="light"] .av-compare-table thead {
  background: #333;
}

.av-compare-table th,
.av-compare-table td {
  padding: var(--av-space-3) var(--av-space-4);
  text-align: left;
  vertical-align: top;
  border-bottom: 1px solid var(--av-border);
}

.av-compare-table th {
  font-family: var(--av-font-display);
  font-weight: 600;
  font-size: 0.875rem;
}

.av-compare-table .av-compare-table__feature-th {
  color: var(--av-text-muted);
}

.av-compare-table .av-compare-table__col--ours {
  font-weight: 600;
  border-bottom: 1px solid var(--av-orange);
}

.av-compare-table tbody .av-compare-table__col--ours {
  border-bottom: 1px solid var(--av-border);
}

.av-compare-table tbody tr:nth-child(even) {
  background: var(--av-surface);
}

.av-compare-table tbody tr:last-child td {
  border-bottom: none;
}

.av-compare-table__caption {
  caption-side: bottom;
  font-size: 0.78rem;
  color: var(--av-text-muted);
  padding: var(--av-space-2) 0;
  text-align: left;
}

/* Mobile: stacked card, no h-scroll */
@media (max-width: 639px) {
  .av-compare-table thead {
    display: none;
  }

  .av-compare-table,
  .av-compare-table tbody,
  .av-compare-table tr,
  .av-compare-table td {
    display: block;
    width: 100%;
  }

  .av-compare-table tr {
    border: 1px solid var(--av-border);
    border-radius: var(--av-radius);
    margin-bottom: var(--av-space-3);
    padding: var(--av-space-3);
    background: var(--av-surface);
  }

  .av-compare-table td {
    border-bottom: none;
    padding: var(--av-space-1) 0;
  }

  .av-compare-table .av-compare-table__feature-cell {
    font-weight: 700;
    font-size: 0.9rem;
    color: var(--av-text);
    padding-bottom: var(--av-space-2);
    margin-bottom: var(--av-space-1);
    border-bottom: 1px solid var(--av-border);
  }

  .av-compare-table td[data-label]::before {
    content: attr(data-label) ": ";
    font-weight: 600;
    font-size: 0.78rem;
    color: var(--av-text-muted);
    display: block;
  }
}