/* docs.css — additive only.
   The visual identity comes from /assets/paitho.css (the live site stylesheet).
   This file adds layout primitives the live site doesn't ship: sidebar, TOC,
   long-form prose tweaks, page-nav. It uses the live tokens — no new colors,
   no new fonts. */

/* ===== Layout shell ===== */
.docs-shell {
  max-width: 1240px;
  margin: 0 auto;
  padding: 88px 24px 0; /* 56px header + 32 breathing */
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 200px;
  gap: 48px;
  align-items: start;
}
@media (max-width: 1100px) {
  .docs-shell { grid-template-columns: 240px minmax(0, 1fr); }
  .toc { display: none; }
}
@media (max-width: 760px) {
  .docs-shell { grid-template-columns: 1fr; padding-top: 80px; }
  .sidebar { display: none; }
}

/* ===== Sidebar ===== */
.sidebar {
  position: sticky;
  top: 88px;
  align-self: start;
  max-height: calc(100vh - 96px);
  overflow-y: auto;
  padding: 8px 0 64px;
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 12.5px;
}
.sidebar-section { margin-bottom: 28px; }
.sidebar-section h4 {
  font-size: 10.5px;
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--ink-faint);
  margin: 0 0 10px 0;
}
.sidebar-section ul { list-style: none; padding: 0; margin: 0; }
.sidebar-section li { margin: 0; }
.sidebar-section a {
  display: block;
  padding: 4px 0 4px 12px;
  margin-left: -12px;
  color: var(--ink-dim);
  text-decoration: none;
  border-left: 1px solid transparent;
  transition: color .15s ease, border-color .15s ease;
}
.sidebar-section a:hover { color: var(--ink); }
.sidebar-section a.is-active {
  color: var(--ink);
  border-left-color: var(--accent);
}

/* ===== Reading column ===== */
.docs-main {
  padding: 8px 0 96px 0;
  min-width: 0;
}
.docs-main article { max-width: 68ch; }

.docs-main h1 {
  font-family: 'Space Grotesk', 'Inter', sans-serif;
  font-weight: 600;
  font-size: clamp(36px, 4.4vw, 52px);
  letter-spacing: -0.03em;
  line-height: 1.05;
  margin: 0 0 18px 0;
  color: var(--ink);
}
.docs-main h2 {
  font-family: 'Space Grotesk', 'Inter', sans-serif;
  font-weight: 600;
  font-size: 24px;
  letter-spacing: -0.025em;
  line-height: 1.2;
  margin: 56px 0 14px 0;
  padding-top: 28px;
  border-top: 1px solid var(--line);
  color: var(--ink);
}
.docs-main h3 {
  font-family: 'Inter', sans-serif;
  font-weight: 600;
  font-size: 17px;
  letter-spacing: -0.01em;
  margin: 28px 0 8px 0;
  color: var(--ink);
}
.docs-main h4 {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-weight: 500;
  font-size: 13px;
  margin: 24px 0 6px 0;
  color: var(--ink-dim);
}

.docs-main .lede {
  font-size: 19px;
  line-height: 1.5;
  color: var(--ink-dim);
  max-width: 60ch;
  margin: 0 0 32px 0;
}

.docs-main .eyebrow {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--ink-faint);
  margin-bottom: 14px;
}

.docs-main p {
  font-size: 16px;
  line-height: 1.65;
  color: var(--ink);
  margin: 0 0 16px 0;
}

.docs-main a {
  color: var(--ink);
  text-decoration: underline;
  text-decoration-color: var(--line-2);
  text-underline-offset: 3px;
  transition: text-decoration-color .15s ease;
}
.docs-main a:hover { text-decoration-color: var(--accent); }

.docs-main ul, .docs-main ol { padding-left: 22px; margin: 0 0 16px 0; }
.docs-main li { margin: 4px 0; line-height: 1.6; }

.docs-main code {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 0.9em;
  background: var(--code-bg);
  padding: 1px 6px;
  border-radius: 4px;
  border: 1px solid var(--line);
  color: var(--ink);
}

.docs-main pre {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  background: var(--code-bg);
  border: 1px solid var(--line);
  border-radius: 8px;
  padding: 14px 18px;
  overflow-x: auto;
  font-size: 13px;
  line-height: 1.6;
  margin: 18px 0;
  color: var(--ink);
}
.docs-main pre code { background: transparent; padding: 0; border: 0; }

.docs-main hr { border: 0; border-top: 1px solid var(--line); margin: 40px 0; }

/* ===== Hero (landing) ===== */
.docs-hero {
  padding: 24px 0 36px 0;
  border-bottom: 1px solid var(--line);
  margin-bottom: 36px;
}
.docs-hero .hero-eyebrow {
  display: flex;
  gap: 12px;
  align-items: center;
  margin-bottom: 18px;
}
.docs-hero h1 { max-width: 18ch; }

/* ===== Cards ===== */
.card-row {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 16px;
  margin: 24px 0;
}
@media (max-width: 700px) { .card-row { grid-template-columns: 1fr; } }

.docs-card {
  display: block;
  border: 1px solid var(--line);
  border-radius: 10px;
  padding: 20px;
  background: var(--panel);
  text-decoration: none !important;
  color: var(--ink);
  transition: border-color .2s ease, background .2s ease;
}
.docs-card:hover {
  border-color: var(--line-2);
  background: var(--surface-hover);
}
.docs-card .card-eyebrow {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--ink-faint);
  margin-bottom: 8px;
}
.docs-card h3 { margin: 0 0 6px 0; font-size: 16px; }
.docs-card p { margin: 0; font-size: 13.5px; color: var(--ink-dim); line-height: 1.5; }

/* ===== Numbered section index ===== */
.section-index {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 0;
  border-top: 1px solid var(--line);
  border-left: 1px solid var(--line);
  margin: 20px 0;
  border-radius: 0;
}
@media (max-width: 700px) { .section-index { grid-template-columns: 1fr; } }
.section-index a {
  display: flex;
  gap: 16px;
  padding: 18px 20px;
  border-right: 1px solid var(--line);
  border-bottom: 1px solid var(--line);
  text-decoration: none !important;
  color: var(--ink);
  background: transparent;
  transition: background .15s ease;
}
.section-index a:hover { background: var(--surface-hover); }
.section-index .num {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 11px;
  color: var(--ink-faint);
  font-feature-settings: "tnum";
  width: 22px;
  flex-shrink: 0;
  padding-top: 2px;
}
.section-index .meta strong {
  display: block;
  font-weight: 500;
  font-size: 15px;
  margin-bottom: 4px;
  color: var(--ink);
}
.section-index .meta span {
  display: block;
  font-size: 13px;
  color: var(--ink-dim);
  line-height: 1.5;
}

/* ===== Read-first list ===== */
.read-first {
  list-style: none !important;
  padding: 0 !important;
  margin: 16px 0 !important;
  border-top: 1px solid var(--line);
}
.read-first li { border-bottom: 1px solid var(--line); margin: 0; }
.read-first a {
  display: flex;
  justify-content: space-between;
  align-items: baseline;
  padding: 12px 0;
  text-decoration: none !important;
  color: var(--ink);
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 13px;
  gap: 16px;
}
.read-first a:hover { color: var(--accent-ink); }
.read-first .arrow { color: var(--ink-faint); transition: transform .15s ease, color .15s ease; }
.read-first a:hover .arrow { transform: translateX(3px); color: var(--accent-ink); }

/* ===== TOC right rail ===== */
.toc {
  position: sticky;
  top: 88px;
  align-self: start;
  padding: 8px 0;
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 11.5px;
  max-height: calc(100vh - 96px);
  overflow-y: auto;
}
.toc h5 {
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--ink-faint);
  margin: 0 0 10px 0;
  font-weight: 500;
}
.toc ul { list-style: none; padding: 0; margin: 0; }
.toc li { margin: 0; }
.toc a {
  display: block;
  padding: 4px 0 4px 10px;
  color: var(--ink-faint);
  text-decoration: none;
  border-left: 1px solid var(--line);
  transition: color .15s ease, border-color .15s ease;
}
.toc a:hover { color: var(--ink); }
.toc a.is-active { color: var(--ink); border-left-color: var(--accent); }

/* ===== Stage list (pipeline) ===== */
.stage-list {
  list-style: none !important;
  padding: 0 !important;
  margin: 20px 0 !important;
  border-top: 1px solid var(--line);
}
.stage-list li {
  display: grid;
  grid-template-columns: 28px 1fr auto;
  gap: 14px;
  align-items: baseline;
  padding: 10px 0;
  border-bottom: 1px solid var(--line);
}
.stage-list .num { font-family: 'JetBrains Mono', ui-monospace, monospace; color: var(--ink-faint); font-size: 11.5px; }
.stage-list .name { font-family: 'JetBrains Mono', ui-monospace, monospace; font-size: 13.5px; }
.stage-list .name a { color: var(--ink); text-decoration: none; }
.stage-list .name a:hover { color: var(--accent-ink); }
.stage-list .gate {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 10.5px;
  color: var(--ink-faint);
  text-transform: uppercase;
  letter-spacing: 0.08em;
}
.stage-list .gate.human { color: var(--accent-ink); }

/* ===== Note callout ===== */
.note {
  border: 1px solid var(--line);
  border-left: 2px solid var(--accent);
  background: var(--accent-tint);
  padding: 14px 18px;
  margin: 24px 0;
  border-radius: 0 8px 8px 0;
}
.note .label {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--accent-ink);
  margin-bottom: 6px;
  display: block;
}
.note p:last-child { margin-bottom: 0; }

/* ===== Tables ===== */
.docs-main table {
  width: 100%;
  border-collapse: collapse;
  margin: 20px 0;
  font-size: 13.5px;
}
.docs-main th, .docs-main td {
  text-align: left;
  padding: 10px 12px;
  border-bottom: 1px solid var(--line);
  vertical-align: top;
  color: var(--ink);
}
.docs-main th {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-weight: 500;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--ink-faint);
  border-bottom-color: var(--line-2);
}

/* ===== Glossary dl ===== */
dl.glossary { margin: 20px 0; }
dl.glossary dt {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-weight: 500;
  font-size: 14px;
  margin-top: 18px;
  color: var(--ink);
}
dl.glossary dd {
  margin: 4px 0 0 0;
  color: var(--ink-dim);
  font-size: 14.5px;
  line-height: 1.6;
}

/* ===== Page nav (prev/next) ===== */
.page-nav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  margin-top: 56px;
  padding-top: 28px;
  border-top: 1px solid var(--line);
}
@media (max-width: 600px) { .page-nav { grid-template-columns: 1fr; } }
.page-nav a {
  display: block;
  padding: 14px 16px;
  border: 1px solid var(--line);
  border-radius: 8px;
  text-decoration: none !important;
  color: var(--ink);
  background: var(--panel);
  transition: border-color .15s ease, background .15s ease;
}
.page-nav a:hover { border-color: var(--line-2); background: var(--surface-hover); }
.page-nav .dir {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--ink-faint);
  display: block;
  margin-bottom: 4px;
}
.page-nav .next { text-align: right; }
.page-nav .title { font-size: 14px; }

/* ===== Header (matches live site) ===== */
.docs-header {
  position: fixed;
  top: 0; left: 0; right: 0;
  z-index: 50;
  height: 56px;
  background: var(--nav-bg);
  backdrop-filter: blur(24px);
  -webkit-backdrop-filter: blur(24px);
  border-bottom: 1px solid var(--line);
}
.docs-header-inner {
  max-width: 1240px;
  margin: 0 auto;
  height: 56px;
  padding: 0 24px;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 24px;
}
.brand {
  display: flex; align-items: center; gap: 10px;
  text-decoration: none !important; color: var(--ink);
}
.brand-name {
  font-family: 'Space Grotesk', 'Inter', sans-serif;
  font-weight: 600;
  font-size: 15.5px;
  letter-spacing: -0.025em;
  color: var(--logo-wordmark);
}
.brand .chip { padding: 2px 7px; font-size: 10px; margin-left: 8px; }
@media (max-width: 768px) { .brand .chip { display: none; } }

.nav-primary {
  display: flex; align-items: center; gap: 28px;
  font-size: 13.5px; color: var(--ink-dim);
}
@media (max-width: 900px) { .nav-primary { display: none; } }
.nav-primary a {
  color: var(--ink-dim);
  text-decoration: none;
  transition: color .15s ease;
}
.nav-primary a:hover { color: var(--ink); }
.nav-primary a.is-active { color: var(--ink); }

.nav-cta { display: flex; align-items: center; gap: 8px; }
.nav-cta .sandbox-link {
  font-size: 13.5px;
  padding: 6px 12px;
  border-radius: 6px;
  color: var(--ink-dim);
  text-decoration: none;
  transition: color .15s ease;
}
.nav-cta .sandbox-link:hover { color: var(--ink); }
@media (max-width: 480px) { .nav-cta .sandbox-link { display: none; } }

/* ===== Footer ===== */
.docs-foot {
  border-top: 1px solid var(--line);
  background: var(--bg);
  padding: 56px 0 40px;
  margin-top: 80px;
}
.docs-foot-inner {
  max-width: 1240px;
  margin: 0 auto;
  padding: 0 24px;
}
.docs-foot-grid {
  display: grid;
  grid-template-columns: 2fr 1fr 1fr 1fr;
  gap: 32px;
  margin-bottom: 40px;
}
@media (max-width: 760px) { .docs-foot-grid { grid-template-columns: 1fr 1fr; } }
.docs-foot-col h6 {
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 10.5px;
  text-transform: uppercase;
  letter-spacing: 0.12em;
  color: var(--ink-faint);
  margin: 0 0 12px 0;
  font-weight: 500;
}
.docs-foot-col ul { list-style: none; padding: 0; margin: 0; }
.docs-foot-col li { margin: 8px 0; }
.docs-foot-col a {
  font-size: 13px;
  color: var(--ink-dim);
  text-decoration: none;
  transition: color .15s ease;
}
.docs-foot-col a:hover { color: var(--ink); }

.docs-foot-bottom {
  padding-top: 24px;
  border-top: 1px solid var(--line);
  display: flex;
  justify-content: space-between;
  align-items: center;
  flex-wrap: wrap;
  gap: 12px;
  font-family: 'JetBrains Mono', ui-monospace, monospace;
  font-size: 12px;
  color: var(--ink-faint);
}
.docs-foot-bottom a { color: var(--ink-faint); text-decoration: none; }
.docs-foot-bottom a:hover { color: var(--ink); }

/* Selection */
::selection { background: var(--accent-tint-2); color: var(--ink); }

/* Reset for in-card text-decoration */
.docs-main .docs-card p, .docs-main .read-first a, .docs-main .section-index a, .docs-main .page-nav a, .docs-main .stage-list a {
  /* leave alone — handled above */
}