/* =====================================================================
   Settld Design System — Documentation Site Styles
   Imported by every page. Uses tokens.css for all values.
   ===================================================================== */

@import url('tokens.css');

*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
html { scroll-behavior: smooth; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }

body {
  background: var(--s-canvas);
  color: var(--ink);
  font-family: var(--font-body);
  font-size: 15px;
  line-height: 1.55;
}

/* paper grain */
body::before {
  content: "";
  position: fixed; inset: 0;
  pointer-events: none;
  z-index: var(--z-grain);
  opacity: .3;
  background-image: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='180' height='180'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' stitchTiles='stitch'/><feColorMatrix values='0 0 0 0 0.09 0 0 0 0 0.08 0 0 0 0 0.07 0 0 0 0.06 0'/></filter><rect width='100%' height='100%' filter='url(%23n)'/></svg>");
  mix-blend-mode: multiply;
}

/* ---- Layout shell ---- */
.ds-layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  min-height: 100vh;
}
@media (max-width: 900px) {
  .ds-layout { grid-template-columns: 1fr; }
  .ds-sidebar { display: none; }
}

/* ---- Sidebar ---- */
.ds-sidebar {
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
  padding: 32px 24px;
  border-right: 1px solid var(--ink-line);
  background: var(--s-paper);
}
.ds-sidebar-logo {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 20px;
  letter-spacing: -0.045em;
  color: var(--wm-teal);
  text-decoration: none;
  display: block;
  margin-bottom: 32px;
}
.ds-sidebar-section {
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--ink-mute);
  margin: 24px 0 8px;
}
.ds-sidebar a {
  display: block;
  padding: 6px 12px;
  margin: 0 -12px;
  border-radius: var(--r-xs);
  color: var(--ink-body);
  text-decoration: none;
  font-size: 14px;
  font-weight: 500;
  transition: background var(--d-fast) var(--ease-out), color var(--d-fast) var(--ease-out);
}
.ds-sidebar a:hover { background: var(--s-warm); color: var(--ink); }
.ds-sidebar a.active { background: var(--teal-pale); color: var(--teal); font-weight: 600; }

/* ---- Main content ---- */
.ds-main {
  padding: 48px 56px 120px;
  max-width: 960px;
}
@media (max-width: 900px) {
  .ds-main { padding: 32px 20px 80px; }
}

/* ---- Page header ---- */
.ds-page-title {
  font-family: var(--font-display);
  font-size: clamp(32px, 4vw, 48px);
  font-weight: 600;
  letter-spacing: -0.03em;
  line-height: 1;
  margin-bottom: 8px;
}
.ds-page-desc {
  font-size: 17px;
  color: var(--ink-body);
  max-width: 60ch;
  line-height: 1.55;
  margin-bottom: 48px;
}

/* ---- Section headings ---- */
.ds-h2 {
  font-family: var(--font-display);
  font-size: 24px;
  font-weight: 600;
  letter-spacing: -0.02em;
  margin: 56px 0 16px;
  padding-bottom: 12px;
  border-bottom: 1px solid var(--ink-line);
}
.ds-h3 {
  font-family: var(--font-display);
  font-size: 18px;
  font-weight: 600;
  letter-spacing: -0.015em;
  margin: 32px 0 12px;
}

/* ---- Prose ---- */
.ds-prose { max-width: 65ch; }
.ds-prose p { margin-bottom: 12px; }
.ds-prose ul, .ds-prose ol { margin: 8px 0 16px 20px; }
.ds-prose li { margin-bottom: 4px; }
.ds-prose code {
  font-family: var(--font-mono);
  font-size: 13px;
  background: var(--s-warm);
  padding: 1px 6px;
  border-radius: 4px;
  color: var(--teal);
}

/* ---- Preview box (component stage) ---- */
.ds-preview {
  background: var(--s-paper);
  border: 1px solid var(--ink-line);
  border-radius: var(--r-lg);
  padding: 40px;
  margin: 16px 0;
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 16px;
}
.ds-preview.dark {
  background: var(--dark-canvas);
  border-color: var(--dark-border);
}
.ds-preview.col {
  flex-direction: column;
  align-items: flex-start;
}
.ds-preview.center {
  justify-content: center;
}

/* ---- Code block ---- */
.ds-code {
  background: var(--ink);
  color: var(--dark-text);
  border-radius: var(--r-md);
  padding: 20px 24px;
  margin: 12px 0 24px;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.6;
  tab-size: 2;
}
.ds-code .comment { color: rgba(251,248,240,0.35); }
.ds-code .key     { color: #E76F51; }
.ds-code .string  { color: #F4C94E; }
.ds-code .value   { color: #2A9D8F; }
.ds-code .tag     { color: #E76F51; }
.ds-code .attr    { color: #F4C94E; }

/* ---- Spec table ---- */
.ds-table {
  width: 100%;
  border-collapse: collapse;
  margin: 12px 0 24px;
  font-size: 14px;
}
.ds-table th {
  text-align: left;
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--ink-mute);
  padding: 8px 12px;
  border-bottom: 2px solid var(--ink-line);
  font-weight: 500;
}
.ds-table td {
  padding: 10px 12px;
  border-bottom: 1px solid var(--ink-line);
  vertical-align: top;
}
.ds-table td code {
  font-family: var(--font-mono);
  font-size: 12px;
  background: var(--s-warm);
  padding: 1px 5px;
  border-radius: 3px;
  color: var(--teal);
}

/* ---- Swatch grid (for color pages) ---- */
.ds-swatches {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(140px, 1fr));
  gap: 12px;
  margin: 16px 0 24px;
}
.ds-swatch {
  border-radius: var(--r-sm);
  overflow: hidden;
  border: 1px solid var(--ink-line);
}
.ds-swatch-color {
  height: 64px;
}
.ds-swatch-label {
  padding: 8px 10px;
  background: var(--s-paper);
  font-size: 12px;
}
.ds-swatch-label strong {
  display: block;
  font-size: 13px;
  font-weight: 600;
  margin-bottom: 2px;
}
.ds-swatch-label code {
  font-family: var(--font-mono);
  font-size: 11px;
  color: var(--ink-mute);
}

/* ---- Do / Don't cards ---- */
.ds-dos {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 16px;
  margin: 16px 0 24px;
}
@media (max-width: 600px) { .ds-dos { grid-template-columns: 1fr; } }
.ds-do, .ds-dont {
  border-radius: var(--r-md);
  padding: 20px;
  font-size: 14px;
  line-height: 1.5;
}
.ds-do {
  background: var(--success-bg);
  border-top: 3px solid var(--success);
}
.ds-dont {
  background: var(--error-bg);
  border-top: 3px solid var(--error);
}
.ds-do strong, .ds-dont strong {
  display: block;
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  margin-bottom: 8px;
}
.ds-do strong { color: var(--success); }
.ds-dont strong { color: var(--error); }

/* ---- Anatomy diagram ---- */
.ds-anatomy {
  position: relative;
  background: var(--s-warm);
  border: 1px solid var(--ink-line);
  border-radius: var(--r-lg);
  padding: 40px;
  margin: 16px 0 24px;
  display: flex;
  justify-content: center;
  align-items: center;
}

/* ---- Badge / tag helpers ---- */
.ds-badge {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  padding: 3px 8px;
  border-radius: var(--r-xs);
  font-weight: 600;
}
.ds-badge.required { background: var(--coral-pale); color: var(--coral); }
.ds-badge.optional { background: var(--s-warm); color: var(--ink-mute); }
.ds-badge.new      { background: var(--teal-pale); color: var(--teal); }

/* ---- Accessibility note ---- */
.ds-a11y {
  background: var(--info-bg);
  border-left: 3px solid var(--info);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
  padding: 16px 20px;
  margin: 16px 0 24px;
  font-size: 14px;
  line-height: 1.5;
}
.ds-a11y strong {
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--info);
  display: block;
  margin-bottom: 4px;
}