/* Docs layout only. Everything visual is inherited from ../css/site.css. */

.docsbadge {
  font: 400 10px/1 var(--body);
  letter-spacing: -0.005em;
  
  color: var(--accent);
  border: 1px solid color-mix(in srgb, var(--accent) 34%, transparent);
  border-radius: 3px;
  padding: 5px 7px;
  margin-left: -8px;
}

.docs-body {
  display: flex;
  gap: clamp(24px, 3.4vw, 48px);
  max-width: var(--maxw);
  margin: 0 auto;
  padding: 34px var(--gut) 0;
  align-items: flex-start;
}

.docs-side { width: 208px; flex: none; position: sticky; top: calc(var(--hud) + 20px); max-height: calc(100vh - var(--hud) - 40px); overflow-y: auto; }
.docs-main { flex: 1; min-width: 0; max-width: 736px; padding-bottom: 20px; }
.docs-toc { width: 186px; flex: none; position: sticky; top: calc(var(--hud) + 20px); }

/* ── sidebar ───────────────────────────────────────────────────────────── */

.nav-group { margin-bottom: 22px; }
.nav-group h5 {
  margin: 0 0 8px;
  font: 400 10px/1 var(--body);
  letter-spacing: -0.005em;
  
  color: var(--mute);
}
.nav-group a {
  display: block;
  font-size: 13.6px;
  line-height: 1.35;
  color: var(--mute);
  text-decoration: none;
  padding: 6px 10px;
  border-left: 1px solid var(--edge);
  border-radius: 0 3px 3px 0;
}
.nav-group a:hover { color: var(--bone); background: var(--field); }
.nav-group a.is-on {
  color: var(--bone);
  border-left-color: var(--accent);
  background: var(--field);
  font-weight: 400;
}

/* ── article ───────────────────────────────────────────────────────────── */

.docs-main h1 {
  font-size: clamp(30px, 4vw, 42px);
  margin-bottom: 10px;
}
.doc-lead { font-size: 17px; line-height: 1.6; color: var(--mute); margin-bottom: 30px; max-width: 60ch; }

.docs-main h2 {
  font-size: 22px;
  margin: 40px 0 12px;
  scroll-margin-top: calc(var(--hud) + 30px);
}
.docs-main h3 {
  font-family: var(--body);
  font-size: 15px;
  font-weight: 400;
  letter-spacing: 0;
  margin: 26px 0 8px;
  scroll-margin-top: calc(var(--hud) + 30px);
}
.docs-main p { font-size: 15px; line-height: 1.68; color: #B7C4BE; max-width: 68ch; }
.docs-main a { color: var(--accent); }
.docs-main strong { color: var(--bone); font-weight: 400; }
.docs-main code {
  font: 400 12.6px/1 var(--body);
  background: var(--field);
  border: 1px solid var(--edge);
  border-radius: 3px;
  padding: 2px 5px;
  color: var(--bone);
}

.docs-main ul, .docs-main ol { max-width: 68ch; padding-left: 20px; margin: 0 0 16px; }
.docs-main li { font-size: 15px; line-height: 1.66; color: #B7C4BE; margin-bottom: 6px; }
.docs-main li::marker { color: var(--mute); }

/* ── reference tables ──────────────────────────────────────────────────── */

.doc-table { width: 100%; border-collapse: collapse; margin: 18px 0 22px; font-size: 13.4px; }
.doc-table th {
  text-align: left;
  font: 400 10px/1 var(--body);
  letter-spacing: -0.005em;
  
  color: var(--mute);
  padding: 0 12px 9px 0;
  border-bottom: 1px solid var(--edge2);
}
.doc-table td {
  padding: 10px 12px 10px 0;
  border-bottom: 1px solid var(--edge);
  color: #B7C4BE;
  vertical-align: top;
  line-height: 1.5;
}
.doc-table td:first-child { color: var(--bone); font-weight: 400; white-space: nowrap; }
.doc-table td code { white-space: nowrap; }

/* ── figures ───────────────────────────────────────────────────────────── */

.fig {
  margin: 22px 0 26px;
  border: 1px solid var(--edge);
  border-radius: 5px;
  background: var(--field);
  overflow: hidden;
}
.fig-body { padding: 16px; }
.fig-body.flush { padding: 0; line-height: 0; }
.fig figcaption {
  border-top: 1px solid var(--edge);
  padding: 10px 14px;
  font-size: 12.4px;
  line-height: 1.5;
  color: var(--mute);
}
.fig canvas { display: block; width: 100%; height: auto; image-rendering: pixelated; }

.fig-row { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1px; background: var(--edge); }
.fig-cell { background: var(--field); padding: 12px; text-align: center; }
.fig-cell canvas { background: #0d1512; border-radius: 3px; }
.fig-cell b {
  display: block;
  margin-top: 8px;
  font: 400 11px/1 var(--body);
  letter-spacing: 0.06em;
}
.fig-cell i {
  display: block;
  margin-top: 4px;
  font: 400 11px/1.4 var(--body);
  font-style: normal;
  color: var(--mute);
}

/* flow diagrams, built from boxes rather than a runtime */
.flow { display: flex; align-items: stretch; flex-wrap: wrap; gap: 8px; }
.flow-step {
  flex: 1 1 120px;
  border: 1px solid var(--edge2);
  border-radius: 4px;
  padding: 11px 12px;
  background: var(--raise);
}
.flow-step b {
  display: block;
  font: 400 10.5px/1 var(--body);
  letter-spacing: 0.09em;
  
  color: var(--accent);
  margin-bottom: 6px;
}
.flow-step span { font-size: 12.4px; line-height: 1.45; color: #B7C4BE; }
.flow-arrow { align-self: center; color: var(--mute); font-size: 13px; flex: none; }

/* colour swatches */
.swatches { display: grid; grid-template-columns: repeat(auto-fill, minmax(148px, 1fr)); gap: 8px; }
.swatch { display: flex; align-items: center; gap: 9px; font-size: 12.4px; color: #B7C4BE; }
.swatch i { width: 22px; height: 22px; border-radius: 4px; flex: none; }
.swatch code { font-size: 11px; color: var(--mute); background: none; border: 0; padding: 0; }

/* terminal blocks */
.term {
  background: #070C0A;
  border: 1px solid var(--edge);
  border-radius: 5px;
  padding: 14px 16px;
  margin: 18px 0 22px;
  overflow-x: auto;
}
.term pre { margin: 0; font: 400 12.4px/1.7 var(--body); color: #B7C4BE; }
.term .c { color: var(--mute); }
.term .p { color: var(--accent); }

/* health state strip */
.states { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 10px; }
.state { border: 1px solid var(--edge); border-radius: 4px; padding: 12px; background: var(--raise); }
.state .bar { margin: 0 0 9px; }
.state b { display: block; font-size: 13px; margin-bottom: 3px; }
.state span { font-size: 12.2px; line-height: 1.45; color: var(--mute); }

.callout {
  border: 1px solid var(--edge2);
  border-left: 2px solid var(--accent);
  border-radius: 0 4px 4px 0;
  background: var(--raise);
  padding: 13px 16px;
  margin: 20px 0;
}
.callout p { font-size: 13.6px; margin: 0; color: #B7C4BE; }

/* ── on this page ──────────────────────────────────────────────────────── */

.toc-cap {
  font: 400 10px/1 var(--body);
  letter-spacing: -0.005em;
  
  color: var(--mute);
  margin-bottom: 10px;
}
.docs-toc a {
  display: block;
  font-size: 12.6px;
  line-height: 1.4;
  color: var(--mute);
  text-decoration: none;
  padding: 5px 0 5px 11px;
  border-left: 1px solid var(--edge);
}
.docs-toc a:hover { color: var(--bone); }
.docs-toc a.is-on { color: var(--accent); border-left-color: var(--accent); }

/* ── pager ─────────────────────────────────────────────────────────────── */

.docs-pager { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin: 46px 0 0; }
.pglink {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: 14px 16px;
  border: 1px solid var(--edge);
  border-radius: 5px;
  text-decoration: none;
  background: var(--field);
}
.pglink:hover { border-color: var(--edge2); }
.pglink small {
  font: 400 10px/1 var(--body);
  letter-spacing: -0.005em;
  
  color: var(--mute);
}
.pglink b { font-size: 14.5px; color: var(--bone); font-weight: 400; }
.pglink.next { grid-column: 2; text-align: right; align-items: flex-end; }

/* ── mobile drawer ─────────────────────────────────────────────────────── */

.drawerbtn { display: none; background: none; border: 0; padding: 6px; cursor: pointer; flex-direction: column; gap: 4px; }
.drawerbtn span { display: block; width: 18px; height: 1.5px; background: var(--bone); }
.drawer-scrim { position: fixed; inset: 0; background: rgba(0, 0, 0, 0.6); z-index: 44; }

@media (max-width: 1080px) {
  .docs-toc { display: none; }
}
@media (max-width: 860px) {
  .topnav { display: none; }
  .drawerbtn { display: flex; }
  .docs-side {
    position: fixed;
    z-index: 45;
    top: 0;
    bottom: 0;
    left: 0;
    width: 260px;
    max-height: none;
    background: var(--field);
    border-right: 1px solid var(--edge2);
    padding: calc(var(--hud) + 22px) 16px 20px;
    transform: translateX(-100%);
    transition: transform 0.2s;
  }
  .docs-side.is-open { transform: none; }
  .docs-pager { grid-template-columns: 1fr; }
  .pglink.next { grid-column: 1; }
  .fig-row { grid-template-columns: 1fr; }
}
@media (prefers-reduced-motion: reduce) {
  .docs-side { transition: none; }
}

.fig-row.four { grid-template-columns: repeat(4, 1fr); }
@media (max-width: 860px) { .fig-row.four { grid-template-columns: 1fr 1fr; } }

/* interactive trait playground */
.pg-canvas { background: #0d1512; border-radius: 4px; margin-bottom: 14px; }
.pg-controls { display: grid; gap: 10px; }
.pg-row { display: grid; grid-template-columns: 158px 1fr 96px; gap: 12px; align-items: center; }
.pg-row span { font-size: 12.4px; color: #B7C4BE; }
.pg-row input[type=range] { width: 100%; accent-color: var(--accent); }
.pg-row i {
  font: 400 10.5px/1.3 var(--body);
  font-style: normal;
  color: var(--mute);
  text-align: right;
}
@media (max-width: 700px) {
  .pg-row { grid-template-columns: 1fr; gap: 3px; }
  .pg-row i { text-align: left; }
}

/* sparkline grid */
.sparks { display: grid; grid-template-columns: repeat(auto-fit, minmax(168px, 1fr)); gap: 14px; }
.spark { border: 1px solid var(--edge); border-radius: 4px; padding: 10px; background: var(--raise); }
.spark-top { display: flex; justify-content: space-between; align-items: baseline; margin-bottom: 6px; }
.spark-top b { font: 400 12px/1 var(--body); letter-spacing: 0.05em; }
.spark-top u { text-decoration: none; font: 400 11px/1 var(--body); }
.spark-top u.up { color: var(--up); }
.spark-top u.down { color: var(--down); }
.spark-foot { display: flex; justify-content: space-between; margin-top: 4px; }
.spark-foot span { font: 400 10px/1 var(--body); color: var(--mute); }

@media (max-width: 900px) { .docsbadge { display: none; } }
@media (max-width: 620px) {
  .chainchip { margin-left: auto; }
  .drawerbtn { margin-left: 0; }
}
