/* ───────────────────────────────────────────────────────────
   Cyboflow site — Docs section
   Sits on tokens.css + site.css. A classic docs layout in the
   paper aesthetic: sticky left rail listing every docs page,
   a 720px reading column, numbered section heads, callouts,
   terminal-style code blocks, and a prev/next pager.
   Shared by every page under /docs/.
   ─────────────────────────────────────────────────────────── */

.docs {
  /* reading ink a touch darker than global body ink (matches changelog) */
  --docs-text: #2c2820;
}

/* ─── Page frame: rail + article ──────────────────────────── */
.docs-frame {
  display: grid;
  grid-template-columns: 216px minmax(0, 1fr);
  gap: 56px;
  width: min(1080px, 100% - 56px);
  margin-inline: auto;
  padding-block: 56px 100px;
}

/* ─── Left rail ───────────────────────────────────────────── */
.docs-rail { font-size: 11px; }
.docs-rail-inner { position: sticky; top: 84px; }
.docs-rail-k {
  display: block;
  font-size: 9px; letter-spacing: .18em; text-transform: uppercase;
  color: var(--cf-ink-4); font-weight: 600;
  margin: 22px 0 10px;
}
.docs-rail-k:first-child { margin-top: 0; }
.docs-rail-nav { display: flex; flex-direction: column; }
.docs-rail-link {
  display: block; text-decoration: none;
  font-size: 11px; line-height: 1.4; color: var(--cf-ink-2);
  padding: 6px 0 6px 13px;
  border-left: 1px solid var(--cf-line);
  transition: color .12s, border-color .12s;
}
.docs-rail-link:hover { color: var(--cf-rust); }
.docs-rail-link:focus-visible { outline: 2px solid var(--cf-rust); outline-offset: 2px; color: var(--cf-ink); }
.docs-rail-link.is-active {
  color: var(--cf-ink); font-weight: 700;
  border-left: 2px solid var(--cf-rust);
  padding-left: 12px;
}
/* second-level: on-page anchors under the active page */
.docs-rail-sub { display: flex; flex-direction: column; }
.docs-rail-sub .docs-rail-link {
  font-size: 10.5px; color: var(--cf-ink-3);
  padding-left: 26px; font-weight: 400;
  border-left: 1px solid var(--cf-line);
}
.docs-rail-sub .docs-rail-link:hover { color: var(--cf-rust); }

/* ─── Article column ──────────────────────────────────────── */
.docs-article { max-width: 720px; min-width: 0; }

.docs-eyebrow {
  font-size: 9px; letter-spacing: .18em; text-transform: uppercase;
  color: var(--cf-ink-3); font-weight: 600;
}
.docs-title {
  font-size: 38px; line-height: 1.05; font-weight: 700;
  letter-spacing: -0.025em; margin: 14px 0 0; color: var(--cf-ink);
}
.docs-title .accent { color: var(--cf-rust); }
.docs-lede {
  font-size: 14px; line-height: 1.65; color: var(--cf-ink-2);
  margin: 16px 0 0; max-width: 600px;
}
.docs-hero { padding-bottom: 28px; border-bottom: 1px solid var(--cf-line-soft); }

/* ─── Prose ───────────────────────────────────────────────── */
.docs-prose { font-size: 13px; line-height: 1.7; color: var(--docs-text); }
.docs-prose > p { margin: 14px 0; }
.docs-prose strong { font-weight: 700; color: var(--cf-ink); }
.docs-prose em { color: var(--cf-ink-2); }
.docs-prose a { color: var(--cf-rust); text-decoration: none; border-bottom: 1px solid rgba(201, 100, 66, .35); transition: border-color .12s; }
.docs-prose a:hover { border-bottom-color: var(--cf-rust); }
.docs-prose a:focus-visible { outline: 2px solid var(--cf-rust); outline-offset: 2px; }
.docs-prose ul, .docs-prose ol { margin: 14px 0; padding-left: 22px; }
.docs-prose li { margin: 7px 0; }
.docs-prose li::marker { color: var(--cf-ink-3); }

/* numbered section head — anchor target for the rail */
.docs-h2 {
  display: flex; align-items: baseline; gap: 12px;
  font-size: 19px; font-weight: 700; letter-spacing: -0.015em; color: var(--cf-ink);
  margin: 52px 0 14px; padding-top: 22px;
  border-top: 1px solid var(--cf-line-soft);
  scroll-margin-top: 76px;
}
.docs-h2 .n {
  font-size: 10px; font-weight: 700; letter-spacing: .1em;
  color: var(--cf-rust); font-variant-numeric: tabular-nums;
  transform: translateY(-1px);
}
.docs-h3 {
  font-size: 14px; font-weight: 700; letter-spacing: -0.005em; color: var(--cf-ink);
  margin: 30px 0 10px; scroll-margin-top: 76px;
}

/* inline code chip (mirrors .cl-code) */
.docs-code {
  font-family: var(--cf-font);
  background: rgba(106, 94, 68, .09);
  border: 1px solid var(--cf-line-soft);
  border-radius: 2px;
  padding: 1px 5px;
  font-size: .9em;
  color: var(--cf-ink);
}

/* UI-label chip — for verbatim button/menu names */
.docs-ui {
  font-size: .85em; font-weight: 700; letter-spacing: .02em;
  color: var(--cf-ink); background: var(--cf-card);
  border: 1px solid var(--cf-line); border-radius: 2px;
  padding: 1px 6px; white-space: nowrap;
}

/* ─── Code block — mini terminal card ─────────────────────── */
.docs-term {
  margin: 18px 0;
  border: 1.4px solid var(--cf-ink);
  background: #fff;
  overflow: hidden;
}
.docs-term-bar {
  height: 28px; display: flex; align-items: center; gap: 8px; padding: 0 12px;
  background: linear-gradient(var(--cf-surface), var(--cf-surface-dim));
  border-bottom: 1px solid var(--cf-line);
  font-size: 9px; letter-spacing: .16em; text-transform: uppercase;
  color: var(--cf-ink-3); font-weight: 700;
}
.docs-term pre {
  margin: 0; padding: 14px 16px;
  font-family: var(--cf-font); font-size: 12px; line-height: 1.7;
  color: var(--cf-ink); overflow-x: auto;
}
.docs-term .dim { color: var(--cf-ink-3); }
.docs-term .ok { color: var(--cf-green); }

/* ─── Callouts ────────────────────────────────────────────── */
.docs-note {
  margin: 18px 0; padding: 13px 15px;
  font-size: 12.5px; line-height: 1.65; color: var(--docs-text);
  background: var(--cf-card);
  border: 1px solid var(--cf-line);
  border-left: 3px solid var(--cf-ink-3);
}
.docs-note-k {
  display: block; margin-bottom: 6px;
  font-size: 8.5px; font-weight: 700; letter-spacing: .16em; text-transform: uppercase;
  color: var(--cf-ink-3);
}
.docs-note--tip { border-left-color: var(--cf-green); }
.docs-note--tip .docs-note-k { color: var(--cf-green); }
.docs-note--warn {
  background: rgba(168, 107, 29, .05);
  border-color: rgba(168, 107, 29, .4); border-left-color: var(--cf-amber);
}
.docs-note--warn .docs-note-k { color: var(--cf-amber); }

/* ─── Step list (getting started) ─────────────────────────── */
.docs-steps { list-style: none; margin: 22px 0; padding: 0; counter-reset: step; }
.docs-step {
  position: relative; padding: 0 0 26px 46px; counter-increment: step;
}
.docs-step::before {
  content: counter(step, decimal-leading-zero);
  position: absolute; left: 0; top: 0;
  width: 28px; height: 28px;
  display: flex; align-items: center; justify-content: center;
  font-size: 10px; font-weight: 700; letter-spacing: .04em;
  color: var(--cf-ink); background: var(--cf-card);
  border: 1.4px solid var(--cf-ink);
  font-variant-numeric: tabular-nums;
}
.docs-step::after {
  content: ""; position: absolute; left: 14px; top: 32px; bottom: 4px; width: 1px;
  background: var(--cf-line);
}
.docs-step:last-child { padding-bottom: 0; }
.docs-step:last-child::after { display: none; }
.docs-step-t { font-size: 13px; font-weight: 700; color: var(--cf-ink); margin: 5px 0 6px; }
.docs-step-b { font-size: 12.5px; line-height: 1.65; color: var(--docs-text); }
.docs-step-b p { margin: 8px 0; }

/* ─── Definition rows (feature fact tables) ───────────────── */
.docs-facts { margin: 18px 0; border: 1px solid var(--cf-line); background: var(--cf-card); }
.docs-fact {
  display: grid; grid-template-columns: 148px 1fr; gap: 14px;
  padding: 10px 14px; border-top: 1px solid var(--cf-line-soft);
  font-size: 12px; line-height: 1.6;
}
.docs-fact:first-child { border-top: none; }
.docs-fact-k {
  font-size: 9.5px; letter-spacing: .12em; text-transform: uppercase;
  color: var(--cf-ink-3); font-weight: 700; padding-top: 2px;
}
.docs-fact-v { color: var(--docs-text); min-width: 0; }

/* ─── Card index (docs home) ──────────────────────────────── */
.docs-cards {
  display: grid; grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 14px; margin-top: 30px;
}
.docs-card {
  display: block; text-decoration: none;
  background: var(--cf-card); border: 1px solid var(--cf-line);
  padding: 18px 18px 16px;
  transition: border-color .12s, box-shadow .12s, transform .12s;
}
.docs-card:hover { border-color: var(--cf-ink); box-shadow: var(--cf-shadow-card-hover); transform: translateY(-1px); }
.docs-card:focus-visible { outline: 2px solid var(--cf-rust); outline-offset: 3px; }
.docs-card-n {
  font-size: 9px; font-weight: 700; letter-spacing: .14em;
  color: var(--cf-rust); font-variant-numeric: tabular-nums;
}
.docs-card-t { font-size: 13.5px; font-weight: 700; color: var(--cf-ink); margin: 8px 0 6px; letter-spacing: -0.005em; }
.docs-card-p { font-size: 11.5px; line-height: 1.6; color: var(--cf-ink-2); margin: 0; }
.docs-card-go {
  display: inline-block; margin-top: 12px;
  font-size: 9px; font-weight: 700; letter-spacing: .14em; text-transform: uppercase;
  color: var(--cf-ink-3); transition: color .12s;
}
.docs-card:hover .docs-card-go { color: var(--cf-rust); }

/* ─── Prev / next pager ───────────────────────────────────── */
.docs-pager {
  display: grid; grid-template-columns: 1fr 1fr; gap: 14px;
  margin-top: 64px; padding-top: 26px; border-top: 1px solid var(--cf-line-soft);
}
.docs-pager-a {
  display: block; text-decoration: none;
  border: 1px solid var(--cf-line); background: var(--cf-card);
  padding: 14px 16px;
  transition: border-color .12s, box-shadow .12s;
}
.docs-pager-a:hover { border-color: var(--cf-ink); box-shadow: var(--cf-shadow-card-hover); }
.docs-pager-a:focus-visible { outline: 2px solid var(--cf-rust); outline-offset: 3px; }
.docs-pager-a--next { text-align: right; grid-column: 2; }
.docs-pager-k {
  display: block; font-size: 8.5px; font-weight: 700; letter-spacing: .16em;
  text-transform: uppercase; color: var(--cf-ink-4); margin-bottom: 6px;
}
.docs-pager-t { font-size: 12.5px; font-weight: 700; color: var(--cf-ink); }
.docs-pager-a:hover .docs-pager-t { color: var(--cf-rust); }

/* ─── Responsive ──────────────────────────────────────────── */
@media (max-width: 860px) {
  .docs-frame {
    grid-template-columns: 1fr;
    gap: 36px;
    width: min(720px, 100% - 40px);
    padding-top: 40px;
  }
  /* rail becomes a bordered index block above the article */
  .docs-rail-inner { position: static; }
  .docs-rail {
    border: 1px solid var(--cf-line); background: var(--cf-card);
    padding: 16px 18px;
  }
  .docs-rail-sub { display: none; } /* anchors are redundant when inline */
  .docs-title { font-size: 30px; }
  .docs-cards { grid-template-columns: 1fr; }
}

@media (max-width: 520px) {
  .docs-fact { grid-template-columns: 1fr; gap: 4px; }
  .docs-pager { grid-template-columns: 1fr; }
  .docs-pager-a--next { grid-column: auto; }
}