/* guide.css — chrome for the RealBrain Design System style guide page only.
   Everything the guide demonstrates comes from tokens.css. This file adds the
   page layout (top bar, sidebar, sections, demo frames, swatch grids) and
   nothing a product would ship. All values are tokens; the three layout
   constants below are the only page-specific numbers. */

:root {
  --ds-topbar-h: 56px;
  --ds-sidebar-w: 248px;
  --ds-content-w: 880px;
}

/* ─── Skip link ─────────────────────────────────── */
.ds-skip { position: absolute; left: var(--space-3); top: calc(-1 * var(--space-9)); z-index: 60; }
.ds-skip:focus { top: var(--space-3); }

/* ─── Top bar ───────────────────────────────────── */
.ds-topbar {
  position: sticky; top: 0; z-index: 50;
  height: var(--ds-topbar-h);
  display: flex; align-items: center; gap: var(--space-3);
  padding: 0 var(--space-5);
  background: var(--surface);
  border-bottom: 1px solid var(--border);
}
.ds-topbar__brand { display: inline-flex; align-items: center; gap: var(--space-3); color: var(--text-1); }
.ds-topbar__brand:hover { text-decoration: none; }
.ds-topbar__title { font-weight: 600; font-size: var(--fs-2); line-height: var(--lh-2); }
.ds-pill {
  display: inline-flex; align-items: center;
  font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-2);
  color: var(--text-3); border: 1px solid var(--border); border-radius: var(--radius-full);
  padding: 0 var(--space-2);
}
.ds-topbar__spacer { flex: 1; }
.ds-topbar__link {
  font-size: var(--fs-2); line-height: var(--lh-2); font-weight: 500; color: var(--text-2);
  padding: var(--space-1) var(--space-2); border-radius: var(--radius-sm);
}
.ds-topbar__link:hover { color: var(--text-1); background: var(--elevated); text-decoration: none; }

/* Segmented control — density switch. Same 32px height as .theme-toggle. */
.ds-seg { display: inline-flex; border: 1px solid var(--border); border-radius: var(--radius-full); background: var(--surface); overflow: hidden; }
.ds-seg button {
  height: 32px; padding: 0 var(--space-3);
  background: none; border: none; cursor: pointer;
  font-family: var(--font-ui); font-size: var(--fs-2); font-weight: 500; color: var(--text-2);
  transition: background var(--dur-1) var(--ease), color var(--dur-1) var(--ease);
}
.ds-seg button:hover { color: var(--text-1); }
.ds-seg button[aria-pressed="true"] { background: var(--elevated); color: var(--text-1); box-shadow: inset 0 -2px 0 var(--accent); }

.ds-nav-toggle { display: none; }

/* ─── Layout ────────────────────────────────────── */
.ds-layout {
  display: grid;
  grid-template-columns: var(--ds-sidebar-w) minmax(0, 1fr);
  max-width: var(--max-app);
  margin: 0 auto;
}

.ds-sidebar {
  position: sticky; top: var(--ds-topbar-h);
  height: calc(100vh - var(--ds-topbar-h));
  overflow-y: auto;
  scrollbar-width: thin; scrollbar-color: var(--border-strong) transparent;
  padding: var(--space-5) var(--space-4);
  border-right: 1px solid var(--border);
}
.ds-nav-group { margin-bottom: var(--space-5); }
.ds-nav-group h5 {
  font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); font-weight: 500;
  letter-spacing: .08em; text-transform: uppercase; color: var(--text-3);
  margin: 0 var(--space-3) var(--space-2);
}
.ds-nav a {
  display: block; padding: var(--space-1) var(--space-3);
  border-radius: var(--radius-sm);
  color: var(--text-2); font-size: var(--fs-2); line-height: var(--lh-2);
  transition: background var(--dur-1) var(--ease), color var(--dur-1) var(--ease);
}
.ds-nav a:hover { background: var(--elevated); color: var(--text-1); text-decoration: none; }
.ds-nav a[aria-current="true"] { background: var(--elevated); color: var(--text-1); box-shadow: inset 2px 0 0 var(--accent); }

.ds-main { padding: var(--space-7) var(--space-6) var(--space-9); min-width: 0; }
.ds-main > * { max-width: var(--ds-content-w); }

/* ─── Hero ──────────────────────────────────────── */
.ds-hero { padding-bottom: var(--space-7); border-bottom: 1px solid var(--border); }
.ds-hero .eyebrow { font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--accent); letter-spacing: .1em; margin-bottom: var(--space-4); }
.ds-hero h1 { font-size: var(--fs-8); line-height: var(--lh-8); font-weight: 600; letter-spacing: -.01em; max-width: 640px; margin-bottom: var(--space-4); }
.ds-hero .lead { font-size: var(--fs-4); line-height: var(--lh-4); color: var(--text-2); max-width: 560px; }
.ds-hero .cta-row { display: flex; flex-wrap: wrap; gap: var(--space-3); margin-top: var(--space-6); }
.ds-facts { display: flex; flex-wrap: wrap; gap: var(--space-5) var(--space-6); margin-top: var(--space-6); padding-top: var(--space-5); border-top: 1px solid var(--border); }
.ds-fact { display: grid; gap: var(--space-1); }
.ds-fact strong { font-size: var(--fs-5); line-height: var(--lh-5); font-weight: 600; }
.ds-fact span { font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3); letter-spacing: .08em; text-transform: uppercase; }

/* ─── Sections & prose ──────────────────────────── */
.ds-section { padding: var(--space-7) 0; border-bottom: 1px solid var(--border); scroll-margin-top: calc(var(--ds-topbar-h) + var(--space-4)); }
.ds-section:last-of-type { border-bottom: none; }
.ds-section > h2 { font-size: var(--fs-7); line-height: var(--lh-7); font-weight: 600; letter-spacing: -.01em; margin-bottom: var(--space-2); }
.ds-section h3 { font-size: var(--fs-5); line-height: var(--lh-5); font-weight: 600; margin: var(--space-6) 0 var(--space-2); scroll-margin-top: calc(var(--ds-topbar-h) + var(--space-4)); }
.ds-section h3 code { font-size: var(--fs-3); }
.ds-section h4 { font-size: var(--fs-3); line-height: var(--lh-3); font-weight: 600; margin: var(--space-4) 0 var(--space-1); }
.ds-section p, .ds-section li { color: var(--text-2); max-width: 68ch; }
.ds-section p + p { margin-top: var(--space-3); }
.ds-section .intro { font-size: var(--fs-4); line-height: var(--lh-4); margin-bottom: var(--space-4); }
.ds-section ul, .ds-section ol { padding-left: var(--space-5); display: grid; gap: var(--space-2); margin: var(--space-3) 0; }
.ds-section strong { color: var(--text-1); font-weight: 600; }
.ds-section :not(pre) > code {
  font-family: var(--font-mono); font-size: .92em; color: var(--text-1);
  background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius-sm);
  padding: 0 var(--space-1);
}
.ds-note {
  display: grid; gap: var(--space-1);
  padding: var(--space-3) var(--space-4); margin: var(--space-4) 0;
  border: 1px solid var(--border); border-left: 3px solid var(--accent); border-radius: var(--radius-md);
  background: var(--surface); font-size: var(--fs-2); line-height: var(--lh-2);
}
.ds-note strong { font-size: var(--fs-2); }
.ds-section .table-wrap { margin-top: var(--space-4); }
.ds-section .table td, .ds-section .table th { vertical-align: top; }

/* ─── Demo frame ────────────────────────────────── */
.ds-demo { border: 1px solid var(--border); border-radius: var(--radius-md); background: var(--bg); margin-top: var(--space-4); overflow: hidden; }
.ds-demo__stage { padding: var(--space-6); display: flex; flex-wrap: wrap; gap: var(--space-3); align-items: center; }
.ds-demo__stage.is-stack { flex-direction: column; align-items: stretch; }
.ds-demo__stage.is-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); align-items: stretch; }
.ds-demo__stage.is-flush { padding: 0; display: block; }
.ds-demo__bar {
  display: flex; align-items: center; gap: var(--space-3);
  padding: var(--space-2) var(--space-2) var(--space-2) var(--space-4);
  border-top: 1px solid var(--border); background: var(--surface);
  font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3);
}
.ds-demo__bar .btn { --control-h: 28px; margin-left: auto; font-size: var(--fs-1); }

.ds-code {
  position: relative; margin: 0;
  padding: var(--space-4) var(--space-4);
  padding-right: var(--space-9);
  background: var(--surface); border-top: 1px solid var(--border);
  overflow-x: auto; tab-size: 2;
  font-family: var(--font-mono); font-size: var(--fs-2); line-height: var(--lh-2); color: var(--text-2);
}
.ds-code code { font-family: inherit; white-space: pre; }
.ds-code.is-standalone { border: 1px solid var(--border); border-radius: var(--radius-md); margin: var(--space-4) 0; }
.ds-code .ds-copy { position: absolute; top: var(--space-2); right: var(--space-2); --control-h: 28px; font-size: var(--fs-1); }
.ds-code__lang { position: absolute; top: var(--space-2); left: var(--space-4); font-size: var(--fs-1); color: var(--text-3); }
.ds-code.has-lang { padding-top: var(--space-6); }

/* ─── Colour ────────────────────────────────────── */
.ds-swatches { display: grid; grid-template-columns: repeat(auto-fill, minmax(196px, 1fr)); gap: var(--space-3); margin-top: var(--space-4); }
.ds-swatch { border: 1px solid var(--border); border-radius: var(--radius-md); overflow: hidden; background: var(--surface); }
.ds-swatch__chip { height: 72px; border-bottom: 1px solid var(--border); }
.ds-swatch__meta { padding: var(--space-3); display: grid; gap: var(--space-1); }
.ds-swatch__name { font-family: var(--font-mono); font-size: var(--fs-2); line-height: var(--lh-2); color: var(--text-1); }
.ds-swatch__hex { font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3); }
.ds-swatch__role { font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-2); }
.ds-pair { display: inline-flex; align-items: center; gap: var(--space-2); }
.ds-pair i {
  display: inline-grid; place-content: center; width: 28px; height: 28px; flex: none;
  border: 1px solid var(--border); border-radius: var(--radius-sm);
  font-style: normal; font-weight: 600; font-size: var(--fs-1);
}

/* ─── Type ──────────────────────────────────────── */
.ds-type { display: grid; margin-top: var(--space-4); }
.ds-type__row { display: grid; grid-template-columns: 220px 1fr; gap: var(--space-4); align-items: baseline; padding: var(--space-4) 0; border-bottom: 1px solid var(--border); }
.ds-type__meta { display: grid; font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3); }
.ds-type__meta span:first-child { color: var(--text-1); }
.ds-type__sample { color: var(--text-1); overflow-wrap: anywhere; }

/* ─── Spacing / radius / shadow ─────────────────── */
.ds-space { display: grid; gap: var(--space-2); margin-top: var(--space-4); }
.ds-space__row { display: grid; grid-template-columns: 140px 1fr; gap: var(--space-3); align-items: center; font-family: var(--font-mono); font-size: var(--fs-1); color: var(--text-3); }
.ds-space__bar { height: 16px; background: var(--accent); }
.ds-tiles { display: flex; flex-wrap: wrap; gap: var(--space-4); margin-top: var(--space-4); }
.ds-tile {
  width: 132px; height: 88px; display: grid; place-content: center; text-align: center;
  background: var(--surface); border: 1px solid var(--border);
  font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3);
}
.ds-tile b { font-weight: 500; color: var(--text-1); }

/* ─── Motion ────────────────────────────────────── */
.ds-motion { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--space-4); margin-top: var(--space-4); }
.ds-motion__box {
  display: grid; gap: var(--space-3); padding: var(--space-3);
  border: 1px solid var(--border); border-radius: var(--radius-md); background: var(--surface);
}
.ds-motion__track { container-type: inline-size; height: 40px; display: flex; align-items: center; }
.ds-motion__ball { width: 24px; height: 24px; border-radius: var(--radius-full); background: var(--accent); transition: translate var(--d) var(--ease); }
.ds-motion.is-playing .ds-motion__ball { translate: calc(100cqw - 100%) 0; }
.ds-motion__label { font-family: var(--font-mono); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3); }

/* ─── Do / don't ────────────────────────────────── */
.ds-dodont { display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-4); margin-top: var(--space-4); }
.ds-dodont .card h4 { display: flex; align-items: center; gap: var(--space-2); margin: 0 0 var(--space-2); }
.ds-dodont .card ul { margin: 0; padding-left: var(--space-4); gap: var(--space-1); }
.ds-dodont .card li { font-size: var(--fs-2); line-height: var(--lh-2); }

/* ─── Files ─────────────────────────────────────── */
.ds-files { display: grid; gap: var(--space-2); margin-top: var(--space-4); }
.ds-file {
  display: grid; grid-template-columns: 1fr auto; gap: var(--space-3); align-items: center;
  padding: var(--space-3) var(--space-4);
  border: 1px solid var(--border); border-radius: var(--radius-md); background: var(--surface);
}
.ds-file__name { font-family: var(--font-mono); font-size: var(--fs-2); line-height: var(--lh-2); color: var(--text-1); }
.ds-file__desc { font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3); margin-top: var(--space-1); }
.ds-file .btn { --control-h: 32px; }

/* ─── Footer ────────────────────────────────────── */
.ds-footer { display: flex; flex-wrap: wrap; justify-content: space-between; gap: var(--space-4); padding-top: var(--space-6); font-size: var(--fs-1); line-height: var(--lh-1); color: var(--text-3); }
.ds-footer a { color: var(--text-2); }

/* ─── Responsive ────────────────────────────────── */
@media (max-width: 900px) {
  .ds-layout { grid-template-columns: 1fr; }
  .ds-sidebar {
    position: fixed; top: var(--ds-topbar-h); left: 0; bottom: 0; height: auto;
    width: min(320px, 100%); z-index: 40;
    background: var(--surface);
    translate: -100% 0;
    transition: translate var(--dur-2) var(--ease);
  }
  .ds-sidebar.is-open { translate: 0 0; box-shadow: var(--shadow-lg); }
  .ds-nav-toggle { display: inline-flex; }
  .ds-topbar { padding: 0 var(--space-4); }
  .ds-topbar__link, .ds-seg { display: none; }
  .ds-main { padding: var(--space-6) var(--space-4) var(--space-8); }
  .ds-hero h1 { font-size: var(--fs-7); line-height: var(--lh-7); }
  .ds-type__row, .ds-motion, .ds-dodont, .ds-file { grid-template-columns: 1fr; }
  .ds-demo__stage { padding: var(--space-4); }
}

@media (max-width: 600px) {
  /* The bar keeps Contents, the R mark and the theme switch; the wordmark and
     version pill return at wider widths. */
  .ds-topbar__title, .ds-topbar .ds-pill { display: none; }
}