/* ============================================================
   Design system page styles — chrome for the reference doc itself.
   (Component styles are illustrative inside each card.)
   ============================================================ */

* { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }

body {
  background: var(--color-canvas);
  color: var(--color-ink);
  font-family: var(--font-sans);
  font-size: var(--text-base);
  line-height: var(--leading-normal);
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}

/* ---------- Document shell ---------- */
.ds-shell {
  max-width: 1280px;
  margin: 0 auto;
  padding: var(--space-7) var(--space-6) var(--space-10);
}

.ds-masthead {
  border-bottom: 1px solid var(--color-ink);
  padding-bottom: var(--space-5);
  margin-bottom: var(--space-8);
  display: flex;
  align-items: flex-end;
  justify-content: space-between;
  gap: var(--space-6);
  flex-wrap: wrap;
}
.ds-masthead__left {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
}
.ds-masthead__eyebrow {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  letter-spacing: var(--tracking-wide);
  text-transform: uppercase;
  color: var(--color-ink-muted);
}
.ds-masthead__title {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: var(--text-3xl);
  letter-spacing: var(--tracking-tight);
  line-height: var(--leading-tight);
  margin: 0;
}
.ds-masthead__meta {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: var(--color-ink-muted);
  text-align: right;
}
.ds-masthead__meta dt {
  text-transform: uppercase;
  letter-spacing: var(--tracking-wide);
}
.ds-masthead__meta dd {
  margin: 0 0 var(--space-2) 0;
  color: var(--color-ink);
}

/* ---------- TOC ---------- */
.ds-toc {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
  gap: var(--space-4);
  margin-bottom: var(--space-9);
  padding: var(--space-5) 0;
  border-top: 1px solid var(--color-rule);
  border-bottom: 1px solid var(--color-rule);
}
.ds-toc a {
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  color: var(--color-ink);
  text-decoration: none;
  display: flex;
  justify-content: space-between;
  border-bottom: 1px dotted var(--color-rule);
  padding-bottom: var(--space-2);
}
.ds-toc a:hover { color: var(--color-ink-muted); }
.ds-toc a .num {
  font-variant-numeric: tabular-nums;
  color: var(--color-ink-subtle);
}

/* ---------- Section headers ---------- */
.ds-section {
  margin-bottom: var(--space-10);
  scroll-margin-top: var(--space-6);
}
.ds-section__head {
  display: flex;
  align-items: baseline;
  gap: var(--space-4);
  margin-bottom: var(--space-6);
  padding-bottom: var(--space-3);
  border-bottom: 1px solid var(--color-rule);
}
.ds-section__num {
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  color: var(--color-ink-subtle);
  font-variant-numeric: tabular-nums;
}
.ds-section__title {
  font-family: var(--font-display);
  font-size: var(--text-2xl);
  font-weight: 700;
  letter-spacing: var(--tracking-tight);
  margin: 0;
}
.ds-section__lede {
  font-family: var(--font-display);
  font-size: var(--text-md);
  font-style: italic;
  color: var(--color-ink-muted);
  margin-left: auto;
  max-width: 38ch;
  text-align: right;
  text-wrap: balance;
}

/* ---------- Subsections ---------- */
.ds-sub {
  margin-bottom: var(--space-7);
}
.ds-sub__head {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  margin-bottom: var(--space-4);
}
.ds-sub__title {
  font-family: var(--font-sans);
  font-weight: 600;
  font-size: var(--text-md);
  margin: 0;
  letter-spacing: var(--tracking-flat);
}
.ds-sub__hint {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: var(--color-ink-subtle);
}
.ds-sub__rule {
  flex: 1;
  height: 1px;
  background: var(--color-rule);
}

/* ---------- Inline code + tables ---------- */
code, .mono {
  font-family: var(--font-mono);
  font-size: 0.92em;
  background: var(--color-surface-sunken);
  padding: 2px 6px;
  border-radius: var(--radius-sm);
  white-space: nowrap;
}

.ds-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-sm);
}
.ds-table th, .ds-table td {
  text-align: left;
  padding: var(--space-3) var(--space-4);
  border-bottom: 1px solid var(--color-rule);
  vertical-align: top;
}
.ds-table th {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: var(--tracking-wide);
  color: var(--color-ink-muted);
  font-weight: 500;
  border-bottom: 1px solid var(--color-ink);
}
.ds-table td.mono-cell { font-family: var(--font-mono); font-size: var(--text-xs); }
.ds-table td.mono-cell code { background: transparent; padding: 0; }
.ds-table tr:last-child td { border-bottom: 0; }

/* ---------- Specimen card shell ---------- */
.ds-card {
  background: var(--color-surface);
  border: 1px solid var(--color-rule);
  border-radius: var(--radius-md);
  padding: var(--space-5);
}
.ds-card + .ds-card { margin-top: var(--space-4); }

.ds-grid { display: grid; gap: var(--space-4); }
.ds-grid--2 { grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); }
.ds-grid--3 { grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); }
.ds-grid--4 { grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); }

/* ---------- Notes / callouts ---------- */
.ds-note {
  border-left: 3px solid var(--color-ink);
  padding: var(--space-4) var(--space-5);
  background: var(--color-surface);
  font-size: var(--text-sm);
  line-height: var(--leading-relaxed);
}
.ds-note--warn { border-left-color: oklch(0.55 0.18 30); }
.ds-note__tag {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: var(--tracking-wide);
  color: var(--color-ink-muted);
  margin-bottom: var(--space-2);
}

/* ---------- Tags / chips ---------- */
.ds-tag {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  padding: 2px var(--space-2);
  border: 1px solid var(--color-rule);
  border-radius: var(--radius-sm);
  color: var(--color-ink-muted);
  white-space: nowrap;
}
.ds-tag--ok    { border-color: oklch(0.55 0.15 150); color: oklch(0.45 0.15 150); }
.ds-tag--warn  { border-color: oklch(0.60 0.18  60); color: oklch(0.48 0.18  60); }
.ds-tag--break { border-color: oklch(0.55 0.20  30); color: oklch(0.48 0.20  30); }