/* FaceNinja docs: sidebar, endpoint headings, code blocks, callouts.
   Builds on the tokens and components of /assets/site.css (colours, type scale, .code, .spec, .table-wrap). */

.docs {
  display: grid;
  grid-template-columns: 248px minmax(0, 1fr);
  gap: var(--space-8);
  align-items: start;
  padding: var(--space-7) 0 var(--space-9);
}
.docs-main { min-width: 0; max-width: 860px; }

/* ---------- sidebar ---------- */
.docs-nav {
  position: sticky;
  top: calc(var(--header-h) + var(--space-4));
  max-height: calc(100vh - var(--header-h) - var(--space-6));
  overflow-y: auto;
  padding-right: var(--space-3);
  font-size: var(--step--1);
  overscroll-behavior: contain;
}
.docs-nav summary { display: none; }
.docs-nav h4 {
  font: 500 .72rem/1 var(--font-mono);
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin: var(--space-5) 0 var(--space-2);
}
.docs-nav h4:first-of-type { margin-top: 0; }
.docs-nav a {
  display: flex;
  align-items: baseline;
  gap: .5rem;
  padding: .28rem 0 .28rem .8rem;
  border-left: 2px solid var(--line);
  color: var(--text-muted);
  text-decoration: none;
}
.docs-nav a:hover { color: var(--text); border-left-color: var(--line-strong); }
.docs-nav a.on { color: var(--text); border-left-color: var(--accent); font-weight: 600; }
.docs-nav .v {
  flex: none;
  width: 3.1em;
  font: 600 .62rem/1 var(--font-mono);
  letter-spacing: .03em;
  color: var(--text-faint);
}
.docs-nav .v.get { color: var(--ok); }
.docs-nav .v.post { color: var(--accent); }
.docs-nav .v.del { color: var(--warn); }

@media (max-width: 960px) {
  .docs { grid-template-columns: minmax(0, 1fr); gap: var(--space-5); padding-top: var(--space-5); }
  .docs-nav {
    position: static; max-height: none; overflow: visible; padding: 0;
    border: 1px solid var(--line); border-radius: var(--radius); background: var(--bg-raised);
  }
  .docs-nav summary {
    display: flex; align-items: center; justify-content: space-between; cursor: pointer;
    padding: .8rem 1rem; font-weight: 600; list-style: none; min-height: 44px;
  }
  .docs-nav summary::-webkit-details-marker { display: none; }
  .docs-nav summary::after { content: "+"; font: 400 1.4rem/1 var(--font-mono); color: var(--accent); }
  .docs-nav[open] summary::after { content: "–"; }
  .docs-nav .nav-body { padding: 0 1rem 1rem; max-height: 60vh; overflow-y: auto; }
}

/* ---------- prose ---------- */
.docs-main h2 {
  font-size: var(--step-3);
  margin: var(--space-9) 0 var(--space-4);
  padding-top: var(--space-6);
  border-top: 1px solid var(--line);
}
.docs-main > section:first-child h2 { margin-top: 0; padding-top: 0; border-top: 0; }
.docs-main h3 { font-size: var(--step-2); margin: var(--space-7) 0 var(--space-3); }
.docs-main h4 { margin: var(--space-6) 0 var(--space-2); font-size: var(--step-1); }
.docs-main .lead { max-width: 70ch; }
.docs-main p, .docs-main li { max-width: 74ch; }
.docs-main td p, .docs-main td li { max-width: none; }
.docs-main td ul { margin: 0; padding-left: 1.1em; }
.docs-main td li + li { margin-top: .15em; }
.docs-main a:not(.btn) { text-decoration-color: color-mix(in srgb, var(--accent) 50%, transparent); }
.docs-main .anchor { color: var(--text-faint); text-decoration: none; margin-left: .35em; opacity: 0; font-weight: 400; }
.docs-main h2:hover .anchor, .docs-main h3:hover .anchor, .docs-main .anchor:focus { opacity: 1; }
.docs-main ol.steps { counter-reset: step; list-style: none; padding: 0; }
.docs-main ol.steps > li { position: relative; padding-left: 2.6rem; margin-bottom: var(--space-5); max-width: none; }
.docs-main ol.steps > li::before {
  counter-increment: step; content: counter(step);
  position: absolute; left: 0; top: .05rem; width: 1.8rem; height: 1.8rem; border-radius: 50%;
  display: grid; place-items: center; font: 600 .8rem var(--font-mono);
  background: var(--accent-soft); color: var(--accent);
}
.docs-main ol.steps > li > p:first-child { margin-bottom: var(--space-2); }

/* ---------- endpoint heading ---------- */
.ep {
  display: flex; flex-wrap: wrap; align-items: center; gap: .5rem .75rem;
  margin: var(--space-8) 0 var(--space-2);
  font-family: var(--font-mono); font-size: var(--step-0); font-weight: 600; letter-spacing: 0;
  line-height: 1.3;
}
.ep code { padding: 0; background: none; font-size: 1em; word-break: break-all; }
.ep .anchor { font-family: var(--font-body); }
.verb {
  display: inline-block; padding: .22rem .55rem; border-radius: var(--radius-s);
  font: 700 .74rem/1.2 var(--font-mono); letter-spacing: .05em;
}
.verb.get { background: color-mix(in srgb, var(--ok) 15%, transparent); color: var(--ok); }
.verb.post { background: var(--accent-soft); color: var(--accent); }
.verb.del { background: var(--warn-soft); color: var(--warn); }
.ep-sum { font-family: var(--font-display); font-size: var(--step-1); font-weight: 600; margin: 0 0 var(--space-3); max-width: none; }
.sub { font: 500 .72rem/1 var(--font-mono); letter-spacing: .08em; text-transform: uppercase; color: var(--text-faint); margin: var(--space-6) 0 var(--space-3); }

/* ---------- code ---------- */
.codeblock { position: relative; margin: 0 0 var(--space-5); min-width: 0; }
.codeblock figcaption {
  display: flex; justify-content: space-between; gap: var(--space-3);
  margin-bottom: var(--space-2);
  font: 500 .75rem var(--font-mono); color: var(--text-muted);
}
.codeblock pre.code { margin: 0; max-width: 100%; white-space: pre; padding: var(--space-4) var(--space-5); font-size: .82rem; line-height: 1.65; }
.codeblock .copy {
  position: absolute; top: 2.1rem; right: .5rem;
  min-height: 30px; padding: .2rem .6rem; border-radius: var(--radius-s);
  border: 1px solid var(--stage-line); background: rgba(255, 255, 255, .06); color: var(--stage-muted);
  font: 500 .72rem var(--font-mono); cursor: pointer;
}
.codeblock .copy:hover { color: var(--stage-text); border-color: var(--stage-muted); }
.codeblock.nocap .copy { top: .5rem; }
.code .k { color: var(--vermilion-300); }
.code .s { color: #a7d7b8; }
.code .c { color: #9a9086; }
.code .n { color: #e7c07a; }

/* ---------- callouts and small parts ---------- */
.callout {
  margin: var(--space-5) 0;
  padding: var(--space-4) var(--space-5);
  border: 1px solid var(--line);
  border-left: 3px solid var(--accent);
  border-radius: var(--radius);
  background: var(--bg-raised);
}
.callout > :last-child { margin-bottom: 0; }
.callout strong:first-child { display: block; margin-bottom: .2rem; }
.callout.ok { border-left-color: var(--ok); }
.callout.warn { border-left-color: var(--warn); background: var(--warn-soft); }
.docs-main .spec code { font-size: .82rem; }
.docs-main .spec td, .docs-main .spec th { vertical-align: top; }
.docs-main .spec thead th { width: auto; }
.docs-main .spec tbody th { width: auto; white-space: nowrap; font-weight: 600; }
.docs-main .spec td.nw, .docs-main .spec th.nw { white-space: nowrap; }
.req { color: var(--accent); font-size: .78rem; font-weight: 600; margin-left: .35em; }
.pill {
  display: inline-block; padding: .1rem .5rem; border-radius: 999px;
  font: 500 .74rem/1.5 var(--font-mono); background: var(--bg-sunk); color: var(--text-muted); border: 1px solid var(--line);
  white-space: nowrap;
}
.pill.live { color: var(--accent); border-color: color-mix(in srgb, var(--accent) 40%, transparent); background: var(--accent-soft); }
.pill.done { color: var(--ok); border-color: color-mix(in srgb, var(--ok) 40%, transparent); background: color-mix(in srgb, var(--ok) 12%, transparent); }
.pill.bad { color: var(--warn); border-color: color-mix(in srgb, var(--warn) 45%, transparent); background: var(--warn-soft); }
.flow {
  display: flex; flex-wrap: wrap; align-items: center; gap: .4rem .5rem;
  margin: var(--space-4) 0 var(--space-5);
}
.flow .arrow { color: var(--text-faint); font-family: var(--font-mono); }
.quick-facts { display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); gap: var(--space-3); margin-top: var(--space-6); }
.quick-facts div { padding: var(--space-3) var(--space-4); border: 1px solid var(--line); border-radius: var(--radius); background: var(--bg-raised); min-width: 0; }
.quick-facts dt { font: 500 .7rem/1 var(--font-mono); letter-spacing: .08em; text-transform: uppercase; color: var(--text-faint); margin-bottom: .4rem; }
.quick-facts dd { margin: 0; font-size: var(--step--1); word-break: break-word; }
.quick-facts { margin-bottom: 0; }
.two-col { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: var(--space-5); }
.two-col > * { min-width: 0; }
@media (max-width: 760px) { .two-col { grid-template-columns: minmax(0, 1fr); } }
.docs-pager { display: flex; justify-content: space-between; gap: var(--space-4); flex-wrap: wrap; margin-top: var(--space-8); padding-top: var(--space-5); border-top: 1px solid var(--line); }
.docs-top-links { display: flex; flex-wrap: wrap; gap: var(--space-2) var(--space-5); margin-top: var(--space-5); font-size: var(--step--1); }
.docs-top-links a { color: var(--text-muted); }
@media (max-width: 620px) {
  .codeblock pre.code { padding: var(--space-3) var(--space-4); font-size: .78rem; }
  .docs-main h2 { margin-top: var(--space-8); }
}