/* ============================================================
   Numo Paper — Docs site chrome
   The design of the design-system doc itself.
   ============================================================ */

@import url('tokens.css');

* , *::before, *::after { box-sizing: border-box; }
html, body { margin: 0; padding: 0; min-height: 100%; }
body {
  font-family: var(--font-sans);
  -webkit-font-smoothing: antialiased;
  background: var(--surface-app);
  color: var(--text-secondary);
  font-size: var(--fs-body);
  line-height: var(--lh-body);
}
a { color: inherit; text-decoration: none; }
button { cursor: pointer; border: none; background: none; padding: 0; font: inherit; color: inherit; }
code, kbd { font-family: var(--font-mono); }
::selection { background: var(--butter-200); color: var(--indigo-900); }

/* ============================================================
   TOP NAV
   ============================================================ */
.ds-nav {
  position: sticky; top: 0; z-index: 30;
  background: rgba(255,255,255,0.92);
  backdrop-filter: saturate(180%) blur(8px);
  -webkit-backdrop-filter: saturate(180%) blur(8px);
  border-bottom: 1px solid var(--rule-subtle);
}
.ds-nav-inner {
  max-width: 1240px; margin: 0 auto;
  display: flex; align-items: center; gap: 32px;
  padding: 14px 40px;
}
.ds-nav-brand {
  display: flex; align-items: baseline; gap: 10px;
  color: var(--text-primary);
}
.ds-nav-brand-name {
  font-size: 15px; font-weight: 700; letter-spacing: -0.005em;
}
.ds-nav-brand-tag {
  font-family: var(--font-mono);
  font-size: 10.5px; color: var(--text-tertiary);
  letter-spacing: 0.04em;
}
.ds-nav-links {
  display: flex; align-items: center; gap: 2px; margin-left: 8px;
}
.ds-nav-link {
  padding: 8px 14px;
  font-size: 13px; font-weight: 500; color: var(--text-secondary);
  border-radius: var(--radius-sm);
  transition: background var(--dur-fast) var(--ease-out), color var(--dur-fast) var(--ease-out);
}
.ds-nav-link:hover { background: var(--surface-hover); color: var(--text-primary); }
.ds-nav-link.is-active {
  color: var(--text-primary); font-weight: 600;
  background: var(--brand-tint);
}
.ds-nav-meta {
  margin-left: auto;
  display: flex; align-items: center; gap: 12px;
  font-size: 12px; color: var(--text-tertiary);
}
.ds-nav-version {
  font-family: var(--font-mono);
  font-size: 10.5px; font-weight: 600; letter-spacing: 0.04em;
  padding: 3px 8px; border-radius: var(--radius-xs);
  background: var(--brand-tint); color: var(--text-accent);
}

/* ============================================================
   PAGE
   ============================================================ */
.ds-page {
  max-width: 1240px; margin: 0 auto;
  padding: 48px 40px 120px;
  display: grid; grid-template-columns: 200px 1fr; gap: 56px;
}
.ds-sidenav {
  position: sticky; top: 84px; align-self: start;
  display: flex; flex-direction: column; gap: 2px;
  padding-right: 12px;
  border-right: 1px solid var(--rule-subtle);
}
.ds-sidenav-group {
  font-size: var(--fs-eyebrow);
  font-weight: 700; letter-spacing: var(--ls-eyebrow);
  text-transform: uppercase; color: var(--text-tertiary);
  padding: 14px 10px 6px;
}
.ds-sidenav-link {
  padding: 6px 10px;
  font-size: 13px; color: var(--text-secondary);
  border-radius: var(--radius-sm);
  transition: background var(--dur-fast) var(--ease-out), color var(--dur-fast) var(--ease-out);
}
.ds-sidenav-link:hover { background: var(--surface-hover); color: var(--text-primary); }
.ds-sidenav-link.is-active {
  color: var(--text-primary); font-weight: 600;
  background: var(--brand-tint);
}

.ds-content { min-width: 0; }

/* Hero */
.ds-hero { margin-bottom: 48px; }
.ds-hero-eyebrow {
  font-family: var(--font-mono);
  font-size: 11px; font-weight: 600; letter-spacing: 0.12em;
  text-transform: uppercase; color: var(--text-accent);
  margin-bottom: 14px;
}
.ds-hero-title {
  font-size: 40px; font-weight: 700; color: var(--text-primary);
  letter-spacing: -0.022em; line-height: 1.05; margin: 0 0 16px;
}
.ds-hero-lede {
  font-size: 16px; line-height: 1.6; color: var(--text-secondary);
  max-width: 640px; margin: 0;
}

/* Section — the main unit of reference docs */
.ds-section {
  padding: 36px 0;
  border-top: 1px solid var(--rule-subtle);
}
.ds-section:first-of-type { border-top: none; padding-top: 0; }

.ds-section-head { margin-bottom: 20px; }
.ds-section-title {
  font-size: 22px; font-weight: 700; color: var(--text-primary);
  letter-spacing: -0.012em; line-height: 1.3; margin: 0;
}
.ds-section-lede {
  margin: 8px 0 0; font-size: 14px; color: var(--text-secondary);
  max-width: 680px; line-height: 1.6;
}

.ds-subsection-title {
  font-size: 13px; font-weight: 700;
  letter-spacing: 0.08em; text-transform: uppercase;
  color: var(--text-tertiary);
  margin: 28px 0 14px;
}

/* Prose */
.ds-p { font-size: 14px; line-height: 1.65; color: var(--text-secondary); margin: 0 0 12px; max-width: 680px; }
.ds-p + .ds-p { margin-top: 12px; }
.ds-p strong { color: var(--text-primary); font-weight: 600; }
.ds-p code {
  background: var(--surface-code); color: var(--text-primary);
  padding: 1px 6px; border-radius: var(--radius-xs);
  font-size: 12.5px; font-weight: 500;
}

.ds-kbd {
  font-family: var(--font-mono);
  font-size: 11px; font-weight: 600;
  padding: 2px 6px; border-radius: var(--radius-xs);
  background: var(--surface-code); color: var(--text-primary);
  border: 1px solid var(--rule-subtle);
  border-bottom-width: 2px;
}

/* Example / spec stage */
.ds-stage {
  position: relative;
  background: var(--surface-card);
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-md);
  padding: 32px;
  display: flex; flex-wrap: wrap; gap: 20px;
  align-items: center;
}
.ds-stage-sunk {
  background: var(--surface-sunk);
}
.ds-stage-label {
  position: absolute; top: -9px; left: 16px;
  font-family: var(--font-mono);
  font-size: 10px; font-weight: 600; letter-spacing: 0.08em;
  text-transform: uppercase; color: var(--text-tertiary);
  background: var(--surface-app); padding: 0 6px;
}
.ds-stage-col {
  display: flex; flex-direction: column; gap: 16px;
  align-items: flex-start;
}
.ds-stage-row {
  display: flex; flex-wrap: wrap; gap: 16px; align-items: center;
}

/* Spec table — the referencing workhorse */
.ds-spec {
  width: 100%; border-collapse: collapse; margin-top: 16px;
  font-size: 13px;
}
.ds-spec th, .ds-spec td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px dashed var(--rule-subtle);
  vertical-align: top;
}
.ds-spec th {
  font-size: var(--fs-eyebrow);
  font-weight: 700; letter-spacing: var(--ls-eyebrow);
  text-transform: uppercase; color: var(--text-tertiary);
  border-bottom: 1px solid var(--rule-strong);
}
.ds-spec td.mono {
  font-family: var(--font-mono); color: var(--text-primary);
  font-size: 12.5px; font-weight: 500;
}
.ds-spec td:first-child { width: 220px; }
.ds-spec tr:last-child td { border-bottom: none; }

/* Swatch */
.ds-swatch {
  display: inline-flex; align-items: center; gap: 10px;
}
.ds-swatch-chip {
  width: 20px; height: 20px; border-radius: var(--radius-xs);
  border: 1px solid rgba(0,0,0,0.06);
}
.ds-swatch-label { font-size: 12.5px; color: var(--text-primary); font-weight: 500; }
.ds-swatch-value { font-family: var(--font-mono); font-size: 11.5px; color: var(--text-tertiary); }

/* Callouts */
.ds-callout {
  padding: 14px 18px; border-radius: var(--radius-sm);
  display: flex; gap: 12px; align-items: flex-start;
  font-size: 13px; line-height: 1.55;
  margin: 18px 0;
}
.ds-callout-do    { background: var(--status-success-bg); color: var(--status-success); }
.ds-callout-dont  { background: var(--status-danger-bg);  color: var(--status-danger); }
.ds-callout-note  { background: var(--brand-tint);        color: var(--text-accent); }
.ds-callout-title {
  font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase;
  font-size: 11px; margin-bottom: 3px;
}

/* State label above a stage */
.ds-state-label {
  font-size: 11px; font-weight: 600; color: var(--text-tertiary);
  letter-spacing: 0.06em; text-transform: uppercase;
  margin-bottom: 8px;
}

/* Grid of state samples */
.ds-state-grid {
  display: grid; gap: 16px;
  grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
}
.ds-state-cell {
  padding: 20px 16px;
  background: var(--surface-card);
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-sm);
  display: flex; flex-direction: column; align-items: flex-start; gap: 10px;
}
.ds-state-cell.sunk { background: var(--surface-sunk); }

/* Dividers */
.ds-hr { border: none; border-top: 1px solid var(--rule-subtle); margin: 28px 0; }

/* Index cards (Overview home page) */
.ds-index {
  display: grid; grid-template-columns: repeat(2, 1fr); gap: 18px; margin-top: 28px;
}
.ds-index-card {
  padding: 22px 24px;
  background: var(--surface-card);
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-md);
  transition: border-color var(--dur-fast) var(--ease-out),
              transform var(--dur-fast) var(--ease-out),
              box-shadow var(--dur-fast) var(--ease-out);
  display: block;
}
.ds-index-card:hover {
  border-color: var(--rule-strong);
  transform: translateY(-1px);
  box-shadow: var(--shadow-1);
}
.ds-index-card-title {
  font-size: 16px; font-weight: 700; color: var(--text-primary);
  margin: 0 0 4px;
}
.ds-index-card-desc {
  font-size: 13px; color: var(--text-tertiary); margin: 0;
}
.ds-index-card-meta {
  margin-top: 14px;
  font-family: var(--font-mono); font-size: 10.5px; color: var(--text-quiet);
  letter-spacing: 0.06em; text-transform: uppercase;
}