/* ============================================================
   Design system page chrome
   Sidebar, section layouts, spec panels — page-only, not part
   of the production component set.
   ============================================================ */

.ds-app {
  display: grid;
  grid-template-columns: 260px 1fr;
  min-height: 100vh;
}
@media (max-width: 960px) { .ds-app { grid-template-columns: 1fr; } }

/* ── Sidebar ─────────────────────────────────────────────── */
.ds-sidebar {
  position: sticky;
  top: 0;
  align-self: start;
  max-height: 100vh;
  overflow-y: auto;
  background: var(--color-surface-card);
  border-right: 1px solid var(--color-border);
  padding: var(--space-6) var(--space-4) var(--space-8);
}
@media (max-width: 960px) {
  .ds-sidebar { position: relative; max-height: none; border-right: 0; border-bottom: 1px solid var(--color-border); }
}
.ds-brand { display: flex; align-items: center; gap: var(--space-2); padding: 0 var(--space-2) var(--space-6); border-bottom: 1px solid var(--color-border-subtle); margin-bottom: var(--space-4); }
.ds-brand-wordmark { font-family: var(--font-sans); font-weight: 600; font-size: 18px; letter-spacing: -0.02em; color: var(--color-text-heading); }
.ds-brand-wordmark .pm { color: var(--color-primary); }
.ds-brand-version { font-family: var(--font-mono); font-size: 10px; color: var(--color-text-muted); margin-left: auto; background: var(--color-surface-raised); padding: 2px 6px; border-radius: var(--radius-sm); letter-spacing: 0.04em; }

.ds-sidenav { display: flex; flex-direction: column; gap: 2px; }
.ds-sidenav-group { font-size: 10px; font-weight: 600; color: var(--color-text-muted); text-transform: uppercase; letter-spacing: 0.08em; padding: var(--space-4) var(--space-2) var(--space-1); }
.ds-sidenav a {
  display: flex; align-items: center; gap: var(--space-2);
  padding: 6px var(--space-2);
  border-radius: var(--radius-md);
  font-size: var(--fs-body-sm);
  color: var(--color-text-body);
  text-decoration: none;
  line-height: 1.4;
}
.ds-sidenav a:hover { background: var(--color-surface-raised); color: var(--color-text-heading); text-decoration: none; }
.ds-sidenav a.is-active { background: var(--color-primary-subtle); color: var(--color-primary); font-weight: 500; }
.ds-sidenav .num { font-family: var(--font-mono); font-size: 10px; color: var(--color-text-muted); width: 22px; flex-shrink: 0; }
.ds-sidenav a.is-active .num { color: var(--color-primary); }

/* ── Main content ─────────────────────────────────────── */
.ds-main { padding: var(--space-10) var(--space-8) var(--space-24); min-width: 0; max-width: 1100px; }
@media (max-width: 640px) { .ds-main { padding: var(--space-6) var(--space-4) var(--space-16); } }

.ds-hero { margin-bottom: var(--space-12); }
.ds-hero-eyebrow { font-family: var(--font-mono); font-size: 11px; letter-spacing: 0.1em; text-transform: uppercase; color: var(--color-primary); margin-bottom: var(--space-3); }
.ds-hero-title  { font-family: var(--font-sans); font-size: 48px; font-weight: 700; letter-spacing: -0.03em; color: var(--color-text-heading); margin: 0 0 var(--space-3); }
.ds-hero-sub    { font-size: var(--fs-body-lg); color: var(--color-text-body); margin: 0 0 var(--space-6); max-width: 680px; }
.ds-hero-meta   { display: flex; gap: var(--space-6); flex-wrap: wrap; font-size: var(--fs-body-sm); color: var(--color-text-muted); padding-top: var(--space-6); border-top: 1px solid var(--color-border-subtle); }
.ds-hero-meta b { color: var(--color-text-heading); font-weight: 500; }
@media (max-width: 640px) { .ds-hero-title { font-size: 32px; } }

/* Section */
.ds-section { margin-bottom: var(--space-24); scroll-margin-top: var(--space-6); }
.ds-section-head { margin-bottom: var(--space-8); }
.ds-section-num { font-family: var(--font-mono); font-size: 12px; letter-spacing: 0.08em; color: var(--color-primary); margin-bottom: var(--space-2); }
.ds-section-title { font-family: var(--font-sans); font-size: 32px; font-weight: 600; letter-spacing: -0.02em; color: var(--color-text-heading); margin: 0 0 var(--space-2); }
.ds-section-sub   { font-size: var(--fs-body); color: var(--color-text-muted); margin: 0; max-width: 680px; }

/* Subsection */
.ds-sub { margin-bottom: var(--space-10); }
.ds-sub-title { font-family: var(--font-sans); font-size: var(--fs-h3); font-weight: var(--fw-h3); letter-spacing: -0.01em; color: var(--color-text-heading); margin: 0 0 var(--space-1); }
.ds-sub-sub   { font-size: var(--fs-body-sm); color: var(--color-text-muted); margin: 0 0 var(--space-4); max-width: 600px; }

/* Specimen container — frames a live example with optional caption */
.ds-specimen {
  background: var(--color-surface-card);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-xl);
  padding: var(--space-6);
  margin-bottom: var(--space-3);
}
.ds-specimen.is-flush { padding: 0; overflow: hidden; }
.ds-specimen.is-dark { background: var(--color-text-heading); border-color: var(--color-text-heading); }
.ds-specimen.is-tinted { background: var(--color-surface-raised); }
.ds-specimen-row { display: flex; flex-wrap: wrap; align-items: flex-end; gap: var(--space-6); }
.ds-specimen-col { display: flex; flex-direction: column; gap: var(--space-3); flex: 1; min-width: 200px; }
.ds-specimen-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: var(--space-4); }
.ds-specimen-stack { display: flex; flex-direction: column; gap: var(--space-3); }

/* Caption + token reference under a specimen */
.ds-caption { display: flex; align-items: center; gap: var(--space-3); font-family: var(--font-mono); font-size: 11px; color: var(--color-text-muted); margin-top: var(--space-2); flex-wrap: wrap; }
.ds-caption code { font-family: var(--font-mono); color: var(--color-text-heading); background: var(--color-surface-raised); padding: 2px 6px; border-radius: var(--radius-sm); font-size: 11px; }

/* ── Color cards ─────────────────────────────────────── */
.ds-color-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: var(--space-3); }
.ds-color-card {
  background: var(--color-surface-card);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  overflow: hidden;
}
.ds-color-swatch { aspect-ratio: 16 / 9; }
.ds-color-meta { padding: var(--space-3); border-top: 1px solid var(--color-border-subtle); }
.ds-color-name { font-family: var(--font-mono); font-size: 11px; color: var(--color-text-heading); font-weight: 500; margin: 0; word-break: break-all; }
.ds-color-value { font-family: var(--font-mono); font-size: 10px; color: var(--color-text-muted); margin-top: 2px; text-transform: uppercase; letter-spacing: 0.04em; }
.ds-color-contrast { font-family: var(--font-mono); font-size: 10px; color: var(--color-success-text); margin-top: 4px; display: flex; align-items: center; gap: 4px; }
.ds-color-contrast.is-fail { color: var(--color-error-text); }

/* ── Type specimen ────────────────────────────────────── */
.ds-type-row {
  display: grid;
  grid-template-columns: 200px 1fr;
  gap: var(--space-6);
  padding: var(--space-5) 0;
  border-bottom: 1px solid var(--color-border-subtle);
  align-items: baseline;
}
.ds-type-row:last-child { border-bottom: 0; }
.ds-type-meta { font-family: var(--font-mono); font-size: 11px; color: var(--color-text-muted); line-height: 1.6; }
.ds-type-meta-name { color: var(--color-text-heading); font-weight: 600; display: block; margin-bottom: 2px; }
.ds-type-sample { min-width: 0; overflow: hidden; }
@media (max-width: 640px) { .ds-type-row { grid-template-columns: 1fr; gap: var(--space-2); } }

/* ── Spacing ruler ────────────────────────────────────── */
.ds-spacing-row { display: grid; grid-template-columns: 120px 1fr 80px; gap: var(--space-4); align-items: center; padding: var(--space-2) 0; }
.ds-spacing-token { font-family: var(--font-mono); font-size: 12px; color: var(--color-text-heading); }
.ds-spacing-bar { height: 12px; background: var(--color-primary); border-radius: 2px; }
.ds-spacing-value { font-family: var(--font-mono); font-size: 11px; color: var(--color-text-muted); text-align: right; }

/* ── State matrix ─────────────────────────────────────── */
.ds-matrix { display: grid; gap: var(--space-4); }
.ds-matrix-row { display: flex; align-items: center; gap: var(--space-4); flex-wrap: wrap; }
.ds-matrix-label { font-family: var(--font-mono); font-size: 10px; text-transform: uppercase; letter-spacing: 0.06em; color: var(--color-text-muted); min-width: 100px; }

/* ── Code block ───────────────────────────────────────── */
.ds-code {
  font-family: var(--font-mono);
  font-size: 12px;
  background: var(--color-text-heading);
  color: #E5E7EB;
  padding: var(--space-3) var(--space-4);
  border-radius: var(--radius-md);
  white-space: pre;
  overflow-x: auto;
}

/* ── Icon grid ────────────────────────────────────────── */
.ds-icon-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(140px, 1fr)); gap: var(--space-2); }
.ds-icon-cell {
  display: flex; flex-direction: column; align-items: center; gap: var(--space-2);
  padding: var(--space-4) var(--space-2);
  border: 1px solid var(--color-border-subtle);
  border-radius: var(--radius-lg);
  background: var(--color-surface-card);
  text-align: center;
}
.ds-icon-cell svg { color: var(--color-text-heading); }
.ds-icon-cell-name { font-family: var(--font-mono); font-size: 10px; color: var(--color-text-muted); word-break: break-all; }
.ds-icon-cell-use  { font-size: 11px; color: var(--color-text-heading); font-weight: 500; }

/* ── Heading anchor bar (in-section) ──────────────────── */
.ds-anchor { display: flex; align-items: center; gap: var(--space-2); margin-bottom: var(--space-3); }
.ds-anchor-pill { font-family: var(--font-mono); font-size: 10px; padding: 2px 8px; border-radius: var(--radius-full); background: var(--color-primary-subtle); color: var(--color-primary); letter-spacing: 0.04em; text-transform: uppercase; }

/* ── Token table ──────────────────────────────────────── */
.ds-token-table { width: 100%; border-collapse: collapse; font-size: var(--fs-body-sm); }
.ds-token-table th, .ds-token-table td { padding: var(--space-2) var(--space-3); border-bottom: 1px solid var(--color-border-subtle); text-align: left; }
.ds-token-table th { font-size: var(--fs-label); font-weight: 500; color: var(--color-text-muted); text-transform: uppercase; letter-spacing: 0.04em; }
.ds-token-table td.token { font-family: var(--font-mono); color: var(--color-text-heading); font-size: 12px; }
.ds-token-table td.val   { font-family: var(--font-mono); color: var(--color-text-muted); font-size: 12px; }
