/* ============================================================
   docs.css — Shared shell for the HumanDeploy Design Universe
   Depends on: tokens.css (loaded first)
   ============================================================ */

*, *::before, *::after { box-sizing: border-box; }
html, body { margin: 0; padding: 0; overflow-x: clip; }
body {
  font-family: var(--sans);
  background: var(--paper);
  color: var(--ink);
  transition: background var(--dur-base), color var(--dur-base);
}

/* ---- Shell grid ---- */
.docs-shell { display: grid; grid-template-columns: 260px 1fr; min-height: 100vh; }

/* ---- Side nav ---- */
.docs-nav {
  background: var(--surface-soft);
  border-right: 1px solid var(--hairline);
  padding: 0 0 20px;
  position: sticky; top: 0; height: 100vh;
  overflow-y: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--hairline) transparent;
}
.docs-nav::-webkit-scrollbar { width: 4px; }
.docs-nav::-webkit-scrollbar-thumb { background: var(--hairline); border-radius: 2px; }

/* Brand block — exact same box model as .docs-topbar so border-bottom lines align */
.docs-brand {
  height: var(--docs-topbar-h, 53px);
  padding: 0 20px;
  display: flex; align-items: center; gap: 10px;
  margin-bottom: 8px;
  text-decoration: none;
  color: inherit;
  white-space: nowrap;
}
.docs-brand:hover { color: inherit; }

/* Pixel H mark in nav — 20×15 grid version */
.docs-brand-mark {
  width: 24px;
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  grid-template-rows: repeat(3, 1fr);
  aspect-ratio: 4 / 3;
  gap: 1px;
}
.docs-brand-mark i {
  display: block;
  border-radius: 0.5px;
}
.docs-brand-mark .p1 { grid-column: 2; grid-row: 1; background: var(--ink); }
.docs-brand-mark .p2 { grid-column: 1; grid-row: 2; background: var(--coral); }
.docs-brand-mark .p3 { grid-column: 3; grid-row: 2; background: var(--ink); }
.docs-brand-mark .p4 { grid-column: 2; grid-row: 3; background: var(--ink); }
.docs-brand-mark .p5 { grid-column: 4; grid-row: 1 / 4; background: var(--ink); }

.docs-brand-name {
  font-family: var(--serif);
  font-variation-settings: "opsz" 18;
  font-size: 14px;
  font-weight: 500;
  letter-spacing: -0.005em;
}
.docs-brand-name em { font-style: italic; }

/* Nav group headers */
.docs-nav-group {
  margin-bottom: 2px;
}
.docs-nav-group-head {
  display: flex; align-items: center; gap: 8px;
  padding: 10px 20px 6px;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-quiet);
  cursor: pointer;
  user-select: none;
  border: 0; background: 0; width: 100%;
  text-align: left;
}
.docs-nav-group-head:hover { color: var(--ink-soft); }

.docs-nav-group-head .num {
  color: var(--coral);
  font-weight: 500;
}
.docs-nav-group-head .chevron {
  margin-left: auto;
  font-size: 8px;
  transition: transform var(--dur-fast);
  color: var(--ink-faint);
}
.docs-nav-group.open .docs-nav-group-head .chevron { transform: rotate(90deg); }

/* Nav links */
.docs-nav-children {
  display: none;
  padding-bottom: 4px;
}
.docs-nav-group.open .docs-nav-children { display: block; }

.docs-nav a {
  display: block;
  padding: 10px 20px 10px 34px;
  font-family: var(--sans);
  font-size: 13px;
  color: var(--ink-soft);
  text-decoration: none;
  border-left: 2px solid transparent;
  transition: color var(--dur-fast), border-color var(--dur-fast), background var(--dur-fast);
}
.docs-nav a:hover {
  color: var(--ink);
  background: var(--surface);
}
.docs-nav a.active {
  color: var(--coral);
  border-left-color: var(--coral);
  background: var(--surface);
}
.docs-nav a .badge {
  display: inline-block;
  font-family: var(--mono);
  font-size: 9px;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  padding: 1px 5px;
  border-radius: var(--r-sm);
  background: var(--coral-wash);
  color: var(--coral);
  margin-left: 6px;
  vertical-align: 1px;
}
.docs-nav a .badge.stub {
  background: var(--surface);
  color: var(--ink-faint);
}

/* Flat section label (legacy compat — for pages that don't use collapsible groups) */
.docs-nav-section {
  padding: 12px 20px 6px;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-quiet);
}

/* ---- Main column ---- */
.docs-main {
  padding: 0;
  max-width: none;
  min-width: 0;
}

/* Topbar — shares --docs-topbar-h with .docs-brand for aligned border-bottom */
.docs-topbar {
  position: sticky; top: 0; z-index: 10;
  display: flex; align-items: center; justify-content: space-between;
  height: var(--docs-topbar-h, 53px);
  padding: 0 32px;
  background: rgba(245, 239, 228, 0.85);
  backdrop-filter: blur(20px);
  -webkit-backdrop-filter: blur(20px);
}
[data-theme="dark"] .docs-topbar { background: rgba(26, 23, 20, 0.85); }

.docs-topbar-title {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-quiet);
}
.docs-topbar-title strong { color: var(--ink); font-weight: 500; }

.theme-toggle {
  display: inline-flex;
  background: var(--surface);
  border: 1px solid var(--hairline);
  border-radius: var(--r-pill);
  padding: 3px;
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.06em;
  text-transform: uppercase;
}
.theme-toggle button {
  padding: 6px 14px;
  border-radius: var(--r-pill);
  background: transparent;
  border: 0;
  color: var(--ink-quiet);
  cursor: pointer;
  font: inherit;
  letter-spacing: inherit;
  text-transform: inherit;
}
.theme-toggle button.active {
  background: var(--ink);
  color: var(--paper);
}

/* ---- Content area ---- */
.docs-content { padding: 32px 32px 24px; }

/* Page hero */
.page-hero {
  border-bottom: 1px solid var(--hairline);
  padding-bottom: 32px;
  margin-bottom: 48px;
}
.page-hero .eyebrow { margin-bottom: 12px; }
.page-hero h1 {
  font-family: var(--serif);
  font-variation-settings: "opsz" 60;
  font-size: 3rem;
  font-weight: 400;
  line-height: 1.05;
  letter-spacing: -0.02em;
  margin: 0 0 14px;
}
.page-hero h1 em { font-style: italic; }
.page-hero p {
  font-family: var(--serif);
  font-size: 18px;
  color: var(--ink-soft);
  line-height: 1.55;
  max-width: 680px;
  margin: 0;
}

/* ---- Section ---- */
.section { margin-bottom: 64px; scroll-margin-top: 80px; }
.section-head { margin-bottom: 24px; }
.section-eyebrow {
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--coral);
  margin-bottom: 8px;
}
.section h2 {
  font-family: var(--serif);
  font-variation-settings: "opsz" 32;
  font-size: 28px;
  font-weight: 500;
  margin: 0 0 8px;
  letter-spacing: -0.015em;
}
.section h2 em { font-style: italic; }
.section-desc {
  font-family: var(--serif);
  font-size: 15.5px;
  color: var(--ink-soft);
  max-width: 620px;
  line-height: 1.5;
}

/* Subsection */
.sub { margin-top: 32px; }
.sub-head {
  display: flex; align-items: baseline; gap: 12px;
  margin-bottom: 14px;
}
.sub h3 {
  font-family: var(--serif);
  font-variation-settings: "opsz" 24;
  font-size: 19px;
  font-weight: 500;
  margin: 0;
  letter-spacing: -0.01em;
}
.sub-meta {
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.06em;
  color: var(--ink-quiet);
}

/* ---- Specimen (demo surface) ---- */
.specimen {
  background: var(--paper);
  border: 1px solid var(--hairline);
  border-radius: var(--r-lg);
  padding: 32px;
  position: relative;
  overflow: hidden;
}
.specimen--soft { background: var(--surface-soft); }
.specimen--ink { background: var(--ink); color: var(--paper); }

/* State rows */
.state-row {
  display: grid;
  grid-template-columns: 140px 1fr;
  gap: 24px;
  align-items: center;
  padding: 14px 0;
  border-top: 1px solid var(--hairline);
}
.state-row:first-child { border-top: 0; padding-top: 0; }
.state-row:last-child { padding-bottom: 0; }
.state-label {
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ink-quiet);
}
.state-items { display: flex; flex-wrap: wrap; gap: 12px; align-items: center; }

/* Grid helpers */
.grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }
.grid-3 { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 16px; }
.grid-4 { display: grid; grid-template-columns: repeat(4, 1fr); gap: 12px; }

/* Token swatches */
.swatch {
  display: flex; flex-direction: column; gap: 8px;
  padding: 14px;
  border-radius: var(--r-md);
  border: 1px solid var(--hairline);
  background: var(--surface);
}
.swatch-chip {
  height: 64px;
  border-radius: var(--r-sm);
  border: 1px solid var(--hairline);
}
.swatch-name {
  font-family: var(--mono);
  font-size: 11px;
  color: var(--ink);
  font-weight: 500;
}
.swatch-val {
  font-family: var(--mono);
  font-size: 10px;
  color: var(--ink-quiet);
}

/* Type specimens */
.type-row {
  display: grid;
  grid-template-columns: 200px 1fr;
  gap: 24px;
  align-items: baseline;
  padding: 18px 0;
  border-top: 1px solid var(--hairline);
}
.type-row:first-child { border-top: 0; padding-top: 0; }
.type-meta {
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.06em;
  color: var(--ink-quiet);
}
.type-meta .tm-name { display: block; color: var(--ink); margin-bottom: 4px; }

/* Surface preview */
.surface-prev {
  background: var(--paper);
  border: 1px solid var(--hairline);
  border-radius: var(--r-lg);
  padding: 28px 32px;
  overflow: hidden;
}
.surface-prev--soft { background: var(--surface-soft); }

/* ---- Portal: card grid ---- */
.portal-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 16px;
  margin-top: 32px;
}
.portal-card {
  display: flex;
  flex-direction: column;
  gap: 10px;
  padding: 24px;
  background: var(--surface);
  border: 1px solid var(--hairline);
  border-radius: var(--r-lg);
  text-decoration: none;
  color: inherit;
  transition: box-shadow var(--dur-base), border-color var(--dur-base);
}
.portal-card:hover {
  border-color: var(--hairline-strong);
  box-shadow: var(--shadow-soft);
}
.portal-card-num {
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--coral);
}
.portal-card h3 {
  font-family: var(--serif);
  font-variation-settings: "opsz" 24;
  font-size: 20px;
  font-weight: 500;
  margin: 0;
  letter-spacing: -0.01em;
}
.portal-card p {
  font-family: var(--serif);
  font-size: 14px;
  color: var(--ink-soft);
  line-height: 1.5;
  margin: 0;
}
.portal-card-meta {
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.06em;
  color: var(--ink-faint);
  margin-top: auto;
}

/* ---- Stub page placeholder ---- */
.stub-hero {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  text-align: center;
  min-height: 50vh;
  gap: 16px;
}
.stub-hero .stub-icon {
  font-size: 48px;
  opacity: 0.2;
  line-height: 1;
}
.stub-hero h2 {
  font-family: var(--serif);
  font-variation-settings: "opsz" 32;
  font-size: 24px;
  font-weight: 500;
  margin: 0;
  color: var(--ink-soft);
}
.stub-hero p {
  font-family: var(--serif);
  font-size: 15px;
  color: var(--ink-quiet);
  max-width: 400px;
  line-height: 1.5;
}

/* ---- Prev / Next page navigation ---- */
.docs-prev-next {
  display: flex;
  justify-content: space-between;
  gap: 24px;
  margin-top: 48px;
}
.docs-prev-next a {
  display: flex;
  flex-direction: column;
  gap: 4px;
  text-decoration: none;
  padding: 16px 20px;
  border: 1px solid var(--hairline);
  border-radius: 8px;
  min-width: 160px;
  transition: border-color 0.15s, background 0.15s;
}
.docs-prev-next a:hover {
  border-color: var(--coral);
  background: rgba(232, 106, 78, 0.04);
}
.docs-prev-next .docs-next { margin-left: auto; text-align: right; }
.docs-pn-dir {
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-quiet);
}
.docs-pn-title {
  font-family: var(--serif);
  font-size: 15px;
  font-weight: 500;
  color: var(--ink);
}
.docs-prev-next a:hover .docs-pn-title { color: var(--coral); }
@media (max-width: 600px) {
  .docs-prev-next { flex-direction: column; }
  .docs-prev-next .docs-next { margin-left: 0; text-align: left; }
}

/* ---- Responsive: content grids ---- */
@media (max-width: 768px) {
  .state-row { grid-template-columns: 1fr; gap: 8px; }
  .type-row  { grid-template-columns: 1fr; gap: 8px; }
  .grid-2    { grid-template-columns: 1fr; }
  .grid-3    { grid-template-columns: 1fr; }
  .grid-4    { grid-template-columns: 1fr 1fr; }
  .docs-content { padding: 20px 16px 64px; }
  .page-hero h1 { font-size: 2rem; }
  .section h2 { font-size: 22px; }
}
@media (max-width: 480px) {
  .grid-4    { grid-template-columns: 1fr; }
  .docs-content { padding: 16px 12px 48px; }
}

/* ---- Responsive: shell ---- */
@media (max-width: 1024px) {
  .docs-shell { grid-template-columns: 1fr; }
  .docs-nav {
    position: fixed; left: -280px; top: 0; z-index: 100;
    width: 280px;
    transition: left var(--dur-base);
    box-shadow: none;
  }
  .docs-nav.open { left: 0; box-shadow: var(--shadow-popover); }
  .docs-scrim {
    display: none;
    position: fixed; inset: 0; z-index: 99;
    background: var(--scrim, rgba(0,0,0,0.4));
  }
  .docs-nav.open ~ .docs-scrim { display: block; }
  .docs-hamburger { display: flex !important; }
}
@media (min-width: 1025px) {
  .docs-hamburger { display: none !important; }
}

.docs-hamburger {
  display: none;
  align-items: center;
  justify-content: center;
  width: 36px; height: 36px;
  border: 1px solid var(--hairline);
  border-radius: var(--r-sm);
  background: var(--surface);
  cursor: pointer;
  font-size: 16px;
  color: var(--ink-soft);
}

/* ---- Shared JS targets ---- */
/* scrollspy + theme toggle + nav collapse handled by docs.js */