/* Verity docs — layout on top of ../assets/style.css (read-only reuse).
   Sidebar TOC + readable main column; proportional sans for prose, mono for
   all code/identifiers/data. No external requests: system fonts only. */

/* Prose face for docs running text. The main site sets body { font-family:
   var(--mono) }; docs prose reads better proportional, so we opt paragraphs,
   lists and tables into --sans and re-assert mono on every code/identifier. */
.doc-main p, .doc-main li, .doc-main dd, .doc-main dt,
.doc-main td, .doc-main th, .doc-main .callout, .doc-main figcaption,
.doc-card p, .doc-lede {
  font-family: var(--sans);
  line-height: 1.65;
}
.doc-main p code, .doc-main li code, .doc-main td code, .doc-main th code,
.doc-main dd code, .doc-main dt code, .doc-main .callout code,
.doc-card p code, .doc-lede code, .doc-main h2 code, .doc-main h3 code,
.doc-main h4 code {
  font-family: var(--mono);
  color: var(--text);
  background: var(--panel2);
  border: 1px solid var(--border);
  border-radius: 4px;
  padding: 0 5px;
  font-size: .9em;
  white-space: nowrap;
}

/* ---------- docs shell: sidebar + main ---------- */

.doc-shell {
  max-width: 1180px;
  margin: 0 auto;
  padding: 0 20px;
  display: grid;
  grid-template-columns: 232px minmax(0, 1fr);
  gap: 40px;
  align-items: start;
}

.doc-side {
  position: sticky;
  top: 58px;
  align-self: start;
  max-height: calc(100vh - 70px);
  overflow-y: auto;
  padding: 24px 0 40px;
  font-size: 13px;
}
.doc-side nav + nav { margin-top: 20px; }
.doc-side .side-h {
  font-size: 11px; text-transform: uppercase; letter-spacing: .11em;
  color: var(--dim); font-weight: 700; margin: 0 0 8px; font-family: var(--mono);
}
.doc-side ul { list-style: none; }
.doc-side li { margin: 0; }
.doc-side a {
  display: block; color: var(--dim); padding: 3px 10px;
  border-left: 2px solid transparent; line-height: 1.45;
}
.doc-side a:hover { color: var(--accent); text-decoration: none; }
.doc-side a.active {
  color: var(--text); border-left-color: var(--accent);
  background: color-mix(in srgb, var(--accent) 8%, transparent);
}
.doc-side a.sub { padding-left: 22px; font-size: 12.5px; }
.doc-side .cur { color: var(--text); font-weight: 700; }

.doc-main { padding: 26px 0 60px; min-width: 0; }
.doc-main > *:first-child { margin-top: 0; }

/* ---------- prose typography ---------- */

.doc-eyebrow {
  font-size: var(--fs-eyebrow); font-weight: 700; text-transform: uppercase;
  letter-spacing: .12em; color: var(--accent); margin-bottom: 8px;
  font-family: var(--mono);
}
.doc-main h1 {
  font-size: clamp(26px, 3.4vw, 33px); line-height: 1.2; font-weight: 700;
  letter-spacing: -.02em; margin: 2px 0 14px; text-wrap: balance;
}
.doc-lede { color: var(--dim); font-size: var(--fs-lede); max-width: 68ch; margin-bottom: 8px; }
.doc-lede b, .doc-lede strong { color: var(--text); font-weight: 600; }

.doc-main h2 {
  font-size: 20px; font-weight: 700; letter-spacing: -.01em;
  margin: 40px 0 12px; padding-top: 8px; scroll-margin-top: 66px;
}
.doc-main h3 {
  font-size: 15.5px; font-weight: 700; margin: 26px 0 8px; scroll-margin-top: 66px;
}
.doc-main h4 {
  font-size: 13.5px; font-weight: 700; margin: 20px 0 6px; color: var(--text);
  scroll-margin-top: 66px; font-family: var(--mono);
}
.doc-main p, .doc-main ul, .doc-main ol, .doc-main .callout,
.doc-main .codeblock, .doc-main .tscroll, .doc-main figure, .doc-main dl { margin-bottom: 14px; }
.doc-main ul, .doc-main ol { padding-left: 22px; }
.doc-main li { margin-bottom: 5px; color: var(--text); }
.doc-main p { color: var(--text); max-width: 74ch; }
.doc-main strong, .doc-main b { color: var(--text); font-weight: 600; }
.doc-main hr { border: 0; border-top: 1px solid var(--border); margin: 34px 0; }

/* anchored headings: a subtle hash on hover */
.doc-main .anchor {
  color: var(--dim); font-family: var(--mono); font-weight: 400;
  margin-left: 8px; opacity: 0; text-decoration: none; font-size: .8em;
}
.doc-main h2:hover .anchor, .doc-main h3:hover .anchor,
.doc-main h4:hover .anchor, .anchor:focus-visible { opacity: 1; }

/* ---------- definition lists ---------- */
.doc-main dl { border: 1px solid var(--border); border-radius: var(--r-card); background: var(--panel); overflow: hidden; }
.doc-main dt {
  font-family: var(--mono); font-weight: 700; color: var(--text);
  padding: 10px 14px 2px; font-size: 13px;
}
.doc-main dd { padding: 0 14px 10px; color: var(--dim); font-size: 13.5px; }
.doc-main dd + dt { border-top: 1px solid var(--border); margin-top: 4px; }

/* ---------- callouts ---------- */
.callout {
  border-left: 3px solid var(--accent); background: var(--panel);
  border-radius: 0 var(--r-card) var(--r-card) 0; padding: 12px 16px; color: var(--dim);
  font-size: 13.5px;
}
.callout b, .callout strong { color: var(--text); }
.callout.warn { border-left-color: var(--amber); }
.callout.danger { border-left-color: var(--red); }
.callout.good { border-left-color: var(--green); }
.callout .tag {
  display: inline-block; font-family: var(--mono); font-size: 11px;
  text-transform: uppercase; letter-spacing: .08em; font-weight: 700;
  margin-right: 8px; color: var(--accent);
}
.callout.warn .tag { color: var(--amber); }
.callout.danger .tag { color: var(--red); }
.callout.good .tag { color: var(--green); }

/* ---------- code blocks (mirror site .codeblock, add lang label) ---------- */
.doc-main .codeblock pre {
  background: var(--panel); border: 1px solid var(--border); border-radius: var(--r-card);
  padding: 14px 16px; overflow-x: auto; font-size: 12.5px; line-height: 1.7;
}
.doc-main .codeblock code { font-family: var(--mono); color: var(--text); white-space: pre; }
.doc-main .codeblock .c { color: var(--dim); }
.doc-main .codeblock .k { color: var(--accent); }
.doc-main .codeblock .s { color: var(--green); }
.doc-main .codeblock .f { color: var(--amber); }
.doc-main .codeblock .n { color: var(--blue); }
.codeblock .lang {
  position: absolute; top: 8px; right: 66px; font-family: var(--mono);
  font-size: 10.5px; text-transform: uppercase; letter-spacing: .08em; color: var(--dim);
  pointer-events: none;
}

/* ---------- tables in prose ---------- */
.doc-main table.grid {
  border-collapse: collapse; width: 100%; font-size: 12.5px; min-width: 520px;
}
.doc-main table.grid th, .doc-main table.grid td {
  border: 1px solid var(--border); padding: 7px 10px; text-align: left; vertical-align: top;
}
.doc-main table.grid th {
  background: var(--panel2); color: var(--dim); font-weight: 700;
  text-transform: uppercase; font-size: 11px; letter-spacing: .04em; white-space: nowrap;
}
.doc-main table.grid td code { white-space: nowrap; }
.doc-main table.grid tr:nth-child(even) td { background: color-mix(in srgb, var(--panel) 50%, transparent); }

/* ---------- card grid (home) ---------- */
.doc-cards {
  display: grid; grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: 14px; margin: 6px 0 8px;
}
.doc-card {
  display: block; border: 1px solid var(--border); border-radius: var(--r-card);
  background: var(--panel); padding: 16px 18px; color: var(--text);
}
.doc-card:hover { border-color: var(--accent); text-decoration: none; }
.doc-card h3 { font-size: 15px; font-weight: 700; margin-bottom: 5px; color: var(--text); }
.doc-card:hover h3 { color: var(--accent); }
.doc-card p { color: var(--dim); font-size: 13px; margin: 0; }
.doc-card .idx { font-family: var(--mono); color: var(--dim); font-size: 11px; }
.doc-card.priority { border-color: color-mix(in srgb, var(--accent) 40%, var(--border)); }
.doc-card .flag {
  display: inline-block; font-family: var(--mono); font-size: 10px; font-weight: 700;
  text-transform: uppercase; letter-spacing: .06em; color: var(--accent);
  border: 1px solid color-mix(in srgb, var(--accent) 45%, transparent);
  border-radius: var(--r-pill); padding: 0 7px; margin-left: 8px; vertical-align: 1px;
}

/* ---------- steps / worked examples ---------- */
.worked {
  border: 1px solid var(--border); border-radius: var(--r-card); background: var(--panel);
  padding: 4px 18px 14px; margin-bottom: 18px;
}
.worked > .worked-h {
  font-family: var(--mono); font-size: 12px; font-weight: 700; color: var(--accent);
  text-transform: uppercase; letter-spacing: .08em;
  border-bottom: 1px solid var(--border); padding: 12px 0 10px; margin: 0 0 12px;
}
.worked .codeblock { margin-bottom: 12px; }

.stepnum {
  display: inline-flex; align-items: center; justify-content: center;
  width: 22px; height: 22px; border-radius: 50%; flex: none;
  background: color-mix(in srgb, var(--accent) 14%, transparent);
  border: 1px solid color-mix(in srgb, var(--accent) 45%, transparent);
  color: var(--accent); font-family: var(--mono); font-size: 12px; font-weight: 700;
  margin-right: 8px; vertical-align: -4px;
}

/* ---------- "start simple" prescriptive callout (top of heavy pages) ---------- */
/* One opinionated recommendation before the comprehensive content. Visually
   distinct from a plain .callout: a filled accent-tinted panel with a compass
   label, so a first-time reader knows exactly where to go before the depth. */
.startsimple {
  display: flex; gap: 14px; align-items: flex-start;
  border: 1px solid color-mix(in srgb, var(--accent) 40%, var(--border));
  background: color-mix(in srgb, var(--accent) 7%, var(--panel));
  border-radius: var(--r-card); padding: 14px 16px; margin: 14px 0 24px;
  font-family: var(--sans);
}
.startsimple .ss-badge {
  flex: none; font-family: var(--mono); font-size: 10.5px; font-weight: 700;
  text-transform: uppercase; letter-spacing: .09em; color: var(--accent);
  border: 1px solid color-mix(in srgb, var(--accent) 45%, transparent);
  border-radius: var(--r-control); padding: 4px 9px; margin-top: 1px; white-space: nowrap;
}
.startsimple .ss-body { color: var(--text); font-size: 13.8px; line-height: 1.6; min-width: 0; }
.startsimple .ss-body b, .startsimple .ss-body strong { color: var(--text); font-weight: 700; }
.startsimple .ss-body p { margin: 0; max-width: none; }
.startsimple .ss-body p + p { margin-top: 6px; }
.startsimple .ss-body .ss-then {
  display: block; margin-top: 8px; font-size: 12.5px; color: var(--dim);
  font-family: var(--mono);
}

/* ---------- home tiers (Diátaxis altitudes) ---------- */
.tier { margin: 0 0 10px; }
.tier-h {
  display: flex; align-items: baseline; gap: 10px; margin: 26px 0 12px;
}
.tier-h .tier-k {
  font-family: var(--mono); font-size: 11px; font-weight: 700; text-transform: uppercase;
  letter-spacing: .13em; color: var(--accent);
}
.tier-h .tier-note { font-size: 12.5px; color: var(--dim); font-family: var(--sans); }
/* the card's one-line "who it's for / when you need it" */
.doc-card .who {
  display: block; margin-top: 8px; font-family: var(--mono); font-size: 11px;
  color: var(--dim); letter-spacing: .01em; line-height: 1.5;
}
.doc-card .who b { color: color-mix(in srgb, var(--accent) 80%, var(--text)); font-weight: 700; }

/* ---------- get-started hero (home front door) ---------- */
.gp-hero {
  border: 1px solid color-mix(in srgb, var(--accent) 45%, var(--border));
  background:
    linear-gradient(180deg, color-mix(in srgb, var(--accent) 9%, var(--panel)), var(--panel));
  border-radius: var(--r-feature); padding: 22px 22px 20px; margin: 6px 0 18px;
}
.gp-hero .gp-eyebrow {
  font-family: var(--mono); font-size: 11px; font-weight: 700; text-transform: uppercase;
  letter-spacing: .12em; color: var(--accent); margin: 0 0 8px;
}
.gp-hero h2 {
  margin: 0 0 8px; font-size: 21px; letter-spacing: -.01em; padding-top: 0;
  scroll-margin-top: 66px;
}
.gp-hero p { color: var(--dim); font-size: 14px; max-width: 66ch; margin: 0 0 14px; }
.gp-hero p b { color: var(--text); font-weight: 600; }
.gp-cta {
  display: inline-flex; align-items: center; gap: 8px;
  border: 1px solid var(--accent); border-radius: var(--r-control); padding: 9px 16px;
  background: color-mix(in srgb, var(--accent) 14%, transparent);
  color: var(--accent); font-family: var(--mono); font-size: 13px; font-weight: 700;
}
.gp-cta:hover { background: color-mix(in srgb, var(--accent) 22%, transparent); text-decoration: none; }
.gp-cta .arr { transition: transform .15s ease; }
.gp-cta:hover .arr { transform: translateX(3px); }
@media (prefers-reduced-motion: reduce) { .gp-cta .arr { transition: none; } }
.gp-hero .gp-sub {
  display: block; margin-top: 10px; font-size: 12.5px; color: var(--dim); font-family: var(--sans);
}

/* ---------- golden-path numbered steps (get-started page) ---------- */
.gp-step {
  border: 1px solid var(--border); border-radius: var(--r-card); background: var(--panel);
  padding: 16px 18px 6px; margin-bottom: 16px; position: relative;
}
.gp-step > h3 {
  display: flex; align-items: center; gap: 10px; margin: 0 0 10px;
  font-size: 15.5px; scroll-margin-top: 66px;
}
.gp-step > h3 .n {
  display: inline-flex; align-items: center; justify-content: center;
  width: 26px; height: 26px; border-radius: 50%; flex: none;
  background: color-mix(in srgb, var(--accent) 15%, transparent);
  border: 1px solid color-mix(in srgb, var(--accent) 50%, transparent);
  color: var(--accent); font-family: var(--mono); font-size: 13px; font-weight: 700;
}
.gp-step .seen {
  font-family: var(--mono); font-size: 11px; text-transform: uppercase; letter-spacing: .08em;
  color: var(--dim); font-weight: 700; margin: 4px 0 6px;
}
.gp-step .payoff {
  position: relative;
  border-top: 1px solid var(--border); margin: 4px 0 0; padding: 11px 0 12px 24px;
  font-family: var(--sans); font-size: 13.5px; line-height: 1.6; color: var(--text);
}
.gp-step .payoff::before {
  content: "✓"; position: absolute; left: 0; top: 11px;
  color: var(--green); font-weight: 700; line-height: 1.5;
}
.gp-step .payoff b { color: var(--text); font-weight: 700; }
.gp-prereq {
  display: flex; gap: 12px; align-items: baseline;
  border: 1px dashed var(--border); border-radius: var(--r-card); background: var(--panel2);
  padding: 12px 16px; margin-bottom: 20px; font-size: 13.5px; color: var(--dim);
  font-family: var(--sans);
}
.gp-prereq .k {
  font-family: var(--mono); font-size: 11px; font-weight: 700; text-transform: uppercase;
  letter-spacing: .08em; color: var(--accent); flex: none;
}
.gp-prereq code { white-space: normal; }

/* ---------- cookbook recipe cards ---------- */
.recipe {
  border: 1px solid var(--border); border-radius: var(--r-card); background: var(--panel);
  padding: 16px 18px 6px; margin-bottom: 16px;
}
.recipe > h3 {
  margin: 0 0 4px; font-size: 15px; scroll-margin-top: 66px;
  display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap;
}
.recipe > h3 .goal { color: var(--dim); font-weight: 400; font-size: 12.5px; font-family: var(--sans); }
.recipe .recipe-more {
  display: block; border-top: 1px solid var(--border); margin-top: 2px;
  padding: 9px 0 10px; font-size: 12.5px; color: var(--dim); font-family: var(--sans);
}
.recipe .recipe-more a { font-family: var(--mono); }

/* ---------- inline provenance / status pills reuse site badges ---------- */
.pill {
  display: inline-block; padding: 1px 8px; border-radius: var(--r-pill); font-size: 11px;
  border: 1px solid; margin: 1px 2px; white-space: nowrap; font-family: var(--mono);
}
.pill.ok   { color: var(--green); border-color: color-mix(in srgb, var(--green) 50%, transparent); background: color-mix(in srgb, var(--green) 8%, transparent); }
.pill.warn { color: var(--amber); border-color: color-mix(in srgb, var(--amber) 50%, transparent); background: color-mix(in srgb, var(--amber) 8%, transparent); }
.pill.info { color: var(--blue);  border-color: color-mix(in srgb, var(--blue) 50%, transparent);  background: color-mix(in srgb, var(--blue) 8%, transparent); }
.pill.bad  { color: var(--red);   border-color: color-mix(in srgb, var(--red) 50%, transparent);   background: color-mix(in srgb, var(--red) 8%, transparent); }

/* ---------- diagrams (author-drawn inline SVG) ---------- */
.doc-fig { overflow-x: auto; margin: 4px 0 8px; }
.doc-fig svg { display: block; width: 100%; height: auto; }
.doc-fig figcaption { color: var(--dim); font-size: 12px; margin-top: 6px; }
.dg-box  { fill: var(--panel);  stroke: var(--border); }
.dg-box2 { fill: var(--panel2); stroke: var(--border); }
.dg-boxa { fill: color-mix(in srgb, var(--accent) 10%, var(--panel)); stroke: color-mix(in srgb, var(--accent) 45%, var(--border)); }
.dg-boxr { fill: color-mix(in srgb, var(--red) 10%, var(--panel)); stroke: color-mix(in srgb, var(--red) 45%, var(--border)); }
.dg-boxk { fill: none; stroke: var(--dim); stroke-dasharray: 4 4; }
.dg-t  { fill: var(--text); font-family: var(--mono); font-size: 12px; font-weight: 600; }
.dg-d  { fill: var(--dim);  font-family: var(--mono); font-size: 10.5px; }
.dg-a  { fill: var(--accent); font-family: var(--mono); font-size: 10.5px; font-weight: 600; }
.dg-g  { fill: var(--green); font-family: var(--mono); font-size: 10.5px; font-weight: 600; }
.dg-r  { fill: var(--red); font-family: var(--mono); font-size: 10.5px; font-weight: 600; }
.dg-line { stroke: var(--dim); stroke-width: 1; fill: none; }
.dg-lined { stroke: var(--dim); stroke-width: 1; fill: none; stroke-dasharray: 4 4; }

/* ---------- prev / next ---------- */
.doc-nav {
  display: flex; gap: 14px; justify-content: space-between; flex-wrap: wrap;
  border-top: 1px solid var(--border); margin-top: 40px; padding-top: 20px;
}
.doc-nav a {
  flex: 1 1 220px; border: 1px solid var(--border); border-radius: var(--r-card);
  background: var(--panel); padding: 12px 16px; color: var(--text);
}
.doc-nav a:hover { border-color: var(--accent); text-decoration: none; }
.doc-nav a.next { text-align: right; }
.doc-nav .dir { display: block; font-family: var(--mono); font-size: 11px; color: var(--dim); text-transform: uppercase; letter-spacing: .08em; }
.doc-nav a:hover .lbl { color: var(--accent); }

/* ---------- mobile TOC toggle ---------- */
.doc-toc-toggle { display: none; }

@media (max-width: 900px) {
  .doc-shell { grid-template-columns: 1fr; gap: 0; }
  .doc-side {
    position: static; max-height: none; overflow: visible;
    border-bottom: 1px solid var(--border); padding: 12px 0;
  }
  .doc-side-inner { display: none; }
  .doc-side.open .doc-side-inner { display: block; }
  .doc-toc-toggle {
    display: inline-flex; align-items: center; gap: 8px; width: 100%;
    background: var(--panel); border: 1px solid var(--border); border-radius: var(--r-control);
    color: var(--text); font-family: var(--mono); font-size: 13px;
    padding: 8px 12px; cursor: pointer;
  }
  .doc-toc-toggle::after { content: "▾"; margin-left: auto; color: var(--dim); }
  .doc-side.open .doc-toc-toggle::after { content: "▴"; }
}
@media (max-width: 560px) {
  .doc-shell { padding: 0 14px; }
}