/* ==========================================================================
   TLAY docs — layout on top of tlay.css (tokens, fonts, nav, footer)
   Sidebar + article. No build step; the sidebar tree is authored in the HTML
   and only highlighted by docs.js.
   ========================================================================== */

.docs-shell {
  display: grid;
  grid-template-columns: 292px minmax(0, 1fr);
  gap: clamp(32px, 4vw, 64px);
  max-width: 1320px;
  margin: 0 auto;
  padding: 104px var(--gut) 0;
  align-items: start;
}

/* ---------- sidebar ---------- */
.docs-side {
  position: sticky;
  top: 84px;
  max-height: calc(100vh - 104px);
  overflow-y: auto;
  overscroll-behavior: contain;
  padding: 24px 12px 48px 0;
  scrollbar-width: thin;
  scrollbar-color: var(--line-2) transparent;
}
.docs-side::-webkit-scrollbar { width: 6px; }
.docs-side::-webkit-scrollbar-thumb { background: var(--line-2); border-radius: 3px; }

.docs-side-head {
  display: block;
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  color: var(--text-faint);
  padding-bottom: 14px;
  margin-bottom: 10px;
  border-bottom: 1px solid var(--line);
}

a.docs-side-head:hover { color: var(--accent); }

.docs-onepage {
  display: block;
  margin-top: 20px;
  padding: 11px 12px;
  border-top: 1px solid var(--line);
  font-family: var(--mono);
  font-size: 12px;
  color: var(--text-faint);
  transition: color .18s;
}
.docs-onepage:hover { color: var(--accent); }

.docs-nav ol { list-style: none; margin: 0; padding: 0; }
.docs-nav > ol > li { margin-bottom: 1px; }

.docs-nav a {
  display: block;
  padding: 7px 12px;
  border-radius: 7px;
  font-size: 14px;
  line-height: 1.35;
  color: var(--text-dim);
  border-left: 2px solid transparent;
  transition: color .18s, background .18s, border-color .18s;
}
.docs-nav a:hover { color: var(--text); background: var(--surface); }

.docs-nav .ch > a { font-weight: 500; }
.docs-nav .ch > a .n {
  font-family: var(--mono);
  font-size: 11.5px;
  color: var(--text-faint);
  margin-right: 8px;
}
.docs-nav .ch > a.active {
  color: var(--accent);
  background: var(--accent-dim);
  border-left-color: var(--accent);
}
.docs-nav .ch > a.active .n { color: var(--accent); }

/* subsections: only the open chapter shows them */
.docs-nav .sub {
  display: none;
  margin: 2px 0 8px 13px;
  border-left: 1px solid var(--line);
  padding-left: 5px;
}
.docs-nav .ch.open .sub { display: block; }
.docs-nav .sub a { font-size: 13px; padding: 5px 11px; color: var(--text-faint); }
.docs-nav .sub a:hover { color: var(--text-dim); }
.docs-nav .sub a.active { color: var(--accent); background: transparent; }

/* ---------- article ---------- */
.docs-main { min-width: 0; padding-bottom: 96px; }
.docs-body { max-width: 1010px; }
/* prose keeps a readable measure; figures, tables and code use the full column */
.docs-body :is(p, ul, ol, .callout, .docs-meta) { max-width: 76ch; }

.docs-body h1 {
  font-size: clamp(30px, 4vw, 44px);
  font-weight: 700;
  letter-spacing: -0.032em;
  line-height: 1.06;
  margin-bottom: 10px;
}
/* --- chapter page: h2 is a subsection, h3 is a labelled block --- */
.docs-body h2 {
  font-size: clamp(19px, 2.2vw, 23px);
  font-weight: 600;
  letter-spacing: -0.015em;
  margin: 46px 0 14px;
}
.docs-body h3 {
  font-family: var(--mono);
  font-size: 13px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--accent);
  margin: 32px 0 12px;
}
/* --- one-page view: h2 is a chapter, h3 a subsection, h4 a labelled block --- */
.docs-body.full h2 {
  font-size: clamp(25px, 3.1vw, 34px);
  font-weight: 600;
  letter-spacing: -0.025em;
  line-height: 1.15;
  margin: 76px 0 20px;
  padding-top: 30px;
  border-top: 1px solid var(--line);
}
.docs-body.full .docs-meta + h2 { border-top: 0; margin-top: 30px; padding-top: 0; }
.docs-body.full h3 {
  font-family: var(--display);
  font-size: clamp(19px, 2.2vw, 22px);
  font-weight: 600;
  letter-spacing: -0.015em;
  text-transform: none;
  color: var(--text);
  margin: 46px 0 14px;
}
.docs-body.full h4 {
  font-family: var(--mono);
  font-size: 13px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--accent);
  margin: 32px 0 12px;
}
.docs-body :is(h1,h2,h3,h4) { scroll-margin-top: 92px; }

.docs-body p { color: var(--text-dim); margin: 1em 0; line-height: 1.68; font-size: 16px; }
.docs-body strong { color: var(--text); font-weight: 600; }
.docs-body a { color: var(--accent-2); text-decoration: underline; text-underline-offset: 3px; text-decoration-thickness: 1px; }
.docs-body a:hover { color: var(--accent); }

.docs-body ul, .docs-body ol { margin: 1em 0 1em 1.35em; color: var(--text-dim); }
.docs-body li { margin: 0.42em 0; line-height: 1.6; font-size: 16px; }
.docs-body li::marker { color: var(--text-faint); }
.docs-body ol > li::marker { font-family: var(--mono); font-size: 13px; }

.docs-body code {
  font-family: var(--mono);
  font-size: 0.875em;
  color: var(--accent-2);
  background: var(--accent-dim);
  border: 1px solid var(--accent-dim);
  border-radius: 5px;
  padding: 1.5px 6px;
}

.docs-rule { border: 0; border-top: 1px solid var(--line); margin: 0; opacity: 0; }

/* heading anchors */
.docs-body .anchor {
  margin-left: 10px;
  color: var(--text-faint);
  text-decoration: none;
  opacity: 0;
  font-weight: 400;
  transition: opacity .18s, color .18s;
}
.docs-body :is(h2,h3,h4):hover .anchor { opacity: 1; }
.docs-body .anchor:hover { color: var(--accent); }

/* ---------- callout ---------- */
.callout {
  margin: 28px 0;
  border: 1px solid var(--accent-dim);
  border-left: 3px solid var(--accent);
  border-radius: 12px;
  background: linear-gradient(160deg, var(--accent-dim), transparent 70%);
  padding: 22px 26px;
}
.callout p {
  margin: 0;
  color: var(--text);
  font-family: var(--display);
  font-size: 18px;
  font-weight: 500;
  line-height: 1.45;
  letter-spacing: -0.01em;
}

/* ---------- tables ---------- */
.table-wrap { overflow-x: auto; margin: 26px 0; border: 1px solid var(--line); border-radius: 12px; }
.docs-body table { border-collapse: collapse; width: 100%; min-width: 480px; font-size: 14.5px; }
.docs-body th, .docs-body td { text-align: left; padding: 13px 18px; vertical-align: top; }
.docs-body thead th {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-faint);
  background: var(--surface);
  font-weight: 500;
  white-space: nowrap;
}
.docs-body tbody tr { border-top: 1px solid var(--line); }
.docs-body tbody td { color: var(--text-dim); line-height: 1.55; }
.docs-body tbody td:first-child { color: var(--text); }

/* ---------- code blocks ---------- */
.code-wrap { margin: 26px 0; border: 1px solid var(--line); border-radius: 12px; background: var(--surface); overflow: hidden; }
.docs-body pre.code { overflow-x: auto; padding: 20px 22px; margin: 0; }
.docs-body pre.code code {
  font-family: var(--mono);
  font-size: 13px;
  line-height: 1.65;
  color: var(--text-dim);
  background: none;
  border: 0;
  padding: 0;
  white-space: pre;
}

/* ---------- figures ---------- */
.figure, .figure-wide { margin: 34px 0; border: 1px solid var(--line); border-radius: 14px; background: var(--surface); padding: 26px; }
.figure svg { width: 100%; height: auto; display: block; }
.figure-wide { overflow-x: auto; }
.figure-wide svg { height: auto; display: block; min-width: 660px; }

/* ---------- doc header block ---------- */
.docs-kicker {
  font-family: var(--mono);
  font-size: 11.5px;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  color: var(--accent);
  margin-bottom: 16px;
  display: flex;
  align-items: center;
  gap: 10px;
}
.docs-kicker::before { content: ""; width: 26px; height: 1px; background: var(--accent); }
.docs-meta {
  font-family: var(--mono);
  font-size: 12px;
  color: var(--text-faint);
  display: flex;
  flex-wrap: wrap;
  gap: 8px 18px;
  margin: 22px 0 8px;
  padding-bottom: 26px;
  border-bottom: 1px solid var(--line);
}

/* ---------- prev / next ---------- */
.docs-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 16px;
  margin-top: 72px;
  padding-top: 34px;
  border-top: 1px solid var(--line);
  max-width: 1010px;
}
@media (max-width: 620px) { .docs-pager { grid-template-columns: 1fr; } }
.docs-pager .pg {
  display: flex;
  flex-direction: column;
  gap: 8px;
  border: 1px solid var(--line);
  border-radius: 14px;
  background: var(--surface);
  padding: 20px 24px;
  min-height: 88px;
  justify-content: center;
  transition: border-color .22s, transform .22s, background .22s;
}
.docs-pager a.pg:hover { border-color: var(--accent); transform: translateY(-2px); background: var(--surface-2); }
.docs-pager .pg-k { font-family: var(--mono); font-size: 11px; letter-spacing: 0.12em; text-transform: uppercase; color: var(--accent); }
.docs-pager .pg-t { font-family: var(--display); font-size: 16px; font-weight: 500; color: var(--text); letter-spacing: -0.01em; line-height: 1.3; }
.docs-pager .pg-next { text-align: right; align-items: flex-end; }
.docs-pager .pg-empty { border: 0; background: none; min-height: 0; padding: 0; }
@media (max-width: 620px) { .docs-pager .pg-empty { display: none; } }

/* ---------- prev/next + edit ---------- */
.docs-end {
  margin-top: 72px;
  padding-top: 28px;
  border-top: 1px solid var(--line);
  display: flex;
  justify-content: space-between;
  gap: 18px;
  flex-wrap: wrap;
  font-family: var(--mono);
  font-size: 12.5px;
  color: var(--text-faint);
}
.docs-end a { color: var(--text-dim); text-decoration: none; }
.docs-end a:hover { color: var(--accent); }

/* ---------- mobile ---------- */
.docs-side-toggle {
  display: none;
  position: sticky;
  top: 64px;
  z-index: 30;
  width: 100%;
  align-items: center;
  gap: 10px;
  padding: 13px var(--gut);
  background: rgba(7,9,12,0.92);
  backdrop-filter: blur(10px);
  border-bottom: 1px solid var(--line);
  font-family: var(--mono);
  font-size: 12.5px;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--text-dim);
  cursor: pointer;
}
.docs-side-toggle .chev { color: var(--accent); transition: transform .25s; }
.docs-side-toggle[aria-expanded="true"] .chev { transform: rotate(180deg); }

@media (max-width: 1000px) {
  .docs-shell { grid-template-columns: minmax(0, 1fr); padding-top: 0; gap: 0; }
  .docs-side-toggle { display: flex; }
  .docs-side {
    display: none;
    position: static;
    max-height: none;
    padding: 18px 0 26px;
    border-bottom: 1px solid var(--line);
  }
  .docs-side.open { display: block; }
  .docs-nav .sub { display: block; }
  .docs-main { padding-top: 40px; }
  .docs-body { max-width: none; }
  .docs-body :is(p, ul, ol, .callout, .docs-meta) { max-width: none; }
}

@media (prefers-reduced-motion: reduce) {
  .docs-nav a, .docs-side-toggle .chev, .docs-body .anchor { transition: none; }
}

/* ==========================================================================
   Figures and callouts — TLAY Docs Visual System
   The artwork is a designed 16:9 card with its own background, so the frame
   adds only a border; no padding, or it would sit on a second surface.
   ========================================================================== */
.fig { margin: 38px 0; max-width: 1010px; }
.fig-frame {
  display: block;
  border: 1px solid var(--line);
  border-radius: 14px;
  overflow: hidden;
  background: #0a0e14;
  text-decoration: none;
  transition: border-color .22s;
}
.fig-frame:hover { border-color: var(--accent); }
.fig-frame svg { display: block; width: 100%; height: auto; }
.fig figcaption {
  margin-top: 14px;
  font-size: 14px;
  line-height: 1.55;
  color: var(--text-faint);
  max-width: 76ch;
}
.fig figcaption b { color: var(--text-dim); font-weight: 600; }

/* semantic callouts: the colour carries meaning, so each also carries a label */
.cbox {
  --cb: var(--accent);
  display: block;
  margin: 26px 0;
  max-width: 76ch;
  border: 1px solid var(--line);
  border-left: 3px solid var(--cb);
  border-radius: 12px;
  background: var(--surface);
  padding: 18px 22px;
}
.cbox-important { --cb: #4CA7FF; }
.cbox-security  { --cb: #FF7E8B; }
.cbox-principle { --cb: #F2C96D; }
.cbox-k {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--cb);
  margin-bottom: 8px;
}
.cbox p { margin: 0; color: var(--text-dim); font-size: 15.5px; line-height: 1.6; max-width: none; }
.cbox p b { color: var(--text); font-weight: 600; }

@media (max-width: 1000px) {
  .fig { max-width: none; }
  .fig figcaption, .cbox { max-width: none; }
}