/*
 * Long-form pages: /docs and /legal/*. Builds on /assets/tokens.css (load that first).
 * Monochrome only. Status colours come from tokens and appear only in .notice / .badge.
 */

@media (prefers-reduced-motion: no-preference) {
  html { scroll-behavior: smooth; }
}

/* ------------------------------------------------------------------ header */
.site-header {
  position: sticky;
  top: 0;
  z-index: 50;
  background: var(--bg);
  border-bottom: var(--hairline);
}
.site-header .container {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--s-4);
  min-height: var(--header-h);
}
.site-nav { display: flex; align-items: center; gap: var(--s-5); font-size: var(--fs-sm); }
.site-nav a:not(.btn) { color: var(--ink-2); text-decoration: none; transition: color var(--dur-1) var(--ease); }
.site-nav a:not(.btn):hover,
.site-nav a[aria-current='page'] { color: var(--ink); }
.site-nav a[aria-current='page'] { text-decoration: underline; text-decoration-thickness: 1px; text-underline-offset: 6px; }
@media (max-width: 420px) {
  .site-nav { gap: var(--s-3); }
}
/* Docs and Log in stay in the footer on phones; Help and Support stay in the header. */
@media (max-width: 560px) {
  .site-nav .nav-secondary { display: none; }
}
/* Room for the theme switch on the smallest phones: Support is one tap away from Help. */
@media (max-width: 400px) {
  .site-nav .nav-tight { display: none; }
}

/* ------------------------------------------------------------------ page head (black band) */
.page-head { padding: var(--s-8) 0 var(--s-7); }
.page-head .label { color: var(--ink-2); margin: 0 0 var(--s-4); }
.page-head h1 { margin: 0 0 var(--s-4); max-width: 16ch; }
.page-head .lead { margin: 0; color: var(--ink-2); max-width: 60ch; }
.page-head-legal { padding: var(--s-7) 0 var(--s-6); }
.page-head-legal h1 { font-size: clamp(2rem, 1.4rem + 2.6vw, 3.25rem); max-width: none; }
.page-head-legal .meta { margin: 0; font-family: var(--font-mono); font-size: var(--fs-sm); color: var(--ink-2); }

/* spec strip under the docs headline: four facts on hairlines */
.facts-wrap { position: relative; margin: var(--s-7) 0 0; padding-top: var(--s-5); }
.facts-wrap > .rule-draw { position: absolute; top: 0; left: 0; right: 0; background: var(--rule-strong); }
.facts {
  display: grid;
  grid-template-columns: repeat(4, minmax(0, 1fr));
  margin: 0;
}
.facts > div { padding-right: var(--s-5); }
.facts > div + div { padding-left: var(--s-5); border-left: 1px solid var(--rule); }
.facts dt { margin: 0 0 6px; }
.facts dd { margin: 0; font-family: var(--font-mono); font-size: var(--fs-sm); color: var(--ink); overflow-wrap: anywhere; }
@media (max-width: 860px) {
  .facts { grid-template-columns: repeat(2, minmax(0, 1fr)); row-gap: var(--s-5); }
  .facts > div:nth-child(odd) { padding-left: 0; border-left: 0; }
}
@media (max-width: 420px) {
  .facts { grid-template-columns: 1fr; }
  .facts > div + div { padding-left: 0; border-left: 0; }
}

/* ------------------------------------------------------------------ two-column manual layout */
.manual {
  display: grid;
  grid-template-columns: 232px minmax(0, 1fr);
  gap: var(--s-8);
  padding: var(--s-7) 0 var(--s-9);
}
@media (max-width: 960px) {
  .manual { grid-template-columns: 1fr; gap: var(--s-6); padding-top: var(--s-6); }
}

/* ------------------------------------------------------------------ table of contents */
.toc {
  position: sticky;
  top: calc(var(--header-h) + var(--s-5));
  align-self: start;
  max-height: calc(100vh - var(--header-h) - var(--s-7));
  overflow-y: auto;
  overscroll-behavior: contain;
}
.toc-title { margin: 0 0 var(--s-3); }
.toc-list {
  position: relative;
  margin: 0;
  padding: 0;
  list-style: none;
  border-left: 1px solid var(--rule);
}
.toc-list li { margin: 0; }
.toc-list a {
  display: grid;
  grid-template-columns: 16px minmax(0, 1fr);
  align-items: center;
  gap: 10px;
  padding: 7px 0 7px 14px;
  font-size: var(--fs-sm);
  line-height: 1.35;
  color: var(--ink-2);
  text-decoration: none;
  transition: color var(--dur-1) var(--ease);
}
.toc-list a .icon { color: var(--ink-3); transition: color var(--dur-1) var(--ease); }
.toc-list a:hover { color: var(--ink); }
.toc-list a:hover .icon { color: var(--ink); }
.toc-list a.is-active,
.toc-list a[aria-current='page'] { color: var(--ink); font-weight: 500; }
.toc-list a.is-active .icon,
.toc-list a[aria-current='page'] .icon { color: var(--ink); }

/* active-section bar: positioned by /assets/docs.js through --toc-y / --toc-h */
.toc-indicator {
  position: absolute;
  top: 0;
  left: -1px;
  width: 2px;
  height: var(--toc-h, 0px);
  background: var(--ink);
  opacity: 0;
  transform: translateY(var(--toc-y, 0px));
  transition: transform var(--dur-3) var(--ease), height var(--dur-3) var(--ease), opacity var(--dur-1) var(--ease);
  pointer-events: none;
}
.toc-list.has-active .toc-indicator { opacity: 1; }
/* legal pages have no script: the current document gets a static bar */
.toc-list a[aria-current='page'] { border-left: 2px solid var(--ink); margin-left: -1px; padding-left: 13px; }

@media (max-width: 960px) {
  .toc { position: static; max-height: none; overflow: visible; padding-bottom: var(--s-5); border-bottom: var(--hairline); }
  .toc-list { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); column-gap: var(--s-4); border-left: 0; }
  .toc-list a { padding-left: 0; }
  .toc-list a[aria-current='page'] { border-left: 0; margin-left: 0; padding-left: 0; text-decoration: underline; text-underline-offset: 4px; }
  .toc-indicator { display: none; }
}
@media (max-width: 420px) {
  .toc-list { grid-template-columns: 1fr; }
}

/* ------------------------------------------------------------------ prose */
.prose { min-width: 0; max-width: 820px; }
.prose p, .prose li { max-width: var(--w-measure); }
.prose ul, .prose ol { margin: 0 0 1em; padding-left: 1.25em; }
.prose li { margin: 0 0 6px; }
.prose li::marker { color: var(--ink-3); }
.prose ol > li::marker { font-family: var(--font-mono); font-size: 0.9em; }
.prose h2 {
  display: flex;
  align-items: baseline;
  gap: 14px;
  margin: 0 0 var(--s-4);
  font-size: clamp(1.5rem, 1.25rem + 1vw, 2rem);
  line-height: 1.15;
}
.prose h3 { margin: var(--s-6) 0 var(--s-3); font-size: var(--fs-h3); }
.prose .sec-num {
  flex: 0 0 auto;
  font-family: var(--font-mono);
  font-size: var(--fs-sm);
  font-weight: 500;
  letter-spacing: var(--tracking-label);
  color: var(--ink-3);
  transform: translateY(-0.2em);
}
.prose .table-wrap { margin: var(--s-4) 0 var(--s-5); }
.prose .notice { margin: var(--s-5) 0; max-width: var(--w-measure); }
.prose .code-block { margin: var(--s-4) 0 var(--s-5); }
.prose .endpoint { margin: 0 0 var(--s-4); }

/* each manual section is separated by a hairline */
.doc-section { padding: var(--s-7) 0 var(--s-2); border-top: var(--hairline); }
.doc-section:first-child { padding-top: 0; border-top: 0; }

/* HTTP method + path line */
.endpoint {
  display: inline-flex;
  align-items: center;
  gap: 10px;
  font-family: var(--font-mono);
  font-size: var(--fs-sm);
}
.method {
  display: inline-block;
  padding: 2px 7px;
  border-radius: 3px;
  background: var(--ink);
  color: var(--bg);
  font-size: var(--fs-xs);
  font-weight: 500;
  letter-spacing: var(--tracking-label);
}
.method-quiet { padding: 1px 6px; background: transparent; color: var(--ink); border: 1px solid var(--ink); }

/* several endpoints of one resource: method + path, then a one-line note */
.prose .endpoint-list { list-style: none; margin: 0 0 var(--s-5); padding: 0; border-top: var(--hairline); }
.prose .endpoint-list li {
  display: grid;
  grid-template-columns: minmax(0, max-content) minmax(0, 1fr);
  gap: 4px var(--s-5);
  align-items: baseline;
  max-width: none;
  margin: 0;
  padding: 10px 0;
  border-bottom: var(--hairline);
}
.prose .endpoint-list .endpoint { margin: 0; overflow-wrap: anywhere; }
.prose .endpoint-list .method { min-width: 4.6em; text-align: center; }
.endpoint-note { font-size: var(--fs-sm); color: var(--ink-2); }
@media (max-width: 720px) {
  .prose .endpoint-list li { grid-template-columns: minmax(0, 1fr); }
}

/* code blocks inside the manual */
.code-block .code-head .label { color: var(--ink-2); }
.code-block pre { font-size: 13px; }
.code-block code[data-lang] { display: block; min-width: max-content; }

/* key/value line under the overview */
.kv { display: grid; grid-template-columns: max-content minmax(0, 1fr); gap: 6px var(--s-5); margin: var(--s-4) 0 var(--s-5); font-size: var(--fs-sm); }
.kv dt { margin: 0; }
.kv dd { margin: 0; }

/* ------------------------------------------------------------------ legal */
.legal h2 { font-size: var(--fs-h3); margin-top: var(--s-7); padding-top: var(--s-5); border-top: var(--hairline); }
.legal h2:first-of-type { margin-top: var(--s-6); }
.legal .clause { display: block; }
.legal .caps { font-size: var(--fs-sm); letter-spacing: 0.01em; }
.legal-note { margin-top: var(--s-7); padding-top: var(--s-4); border-top: var(--hairline); font-size: var(--fs-sm); color: var(--ink-2); }

/* ------------------------------------------------------------------ footer (black band) */
.site-footer { padding: var(--s-7) 0 var(--s-6); font-size: var(--fs-sm); }
.site-footer .container { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: var(--s-5) var(--s-7); align-items: start; }
.site-footer p { margin: var(--s-3) 0 0; color: var(--ink-2); max-width: 44ch; }
.footer-nav { display: flex; flex-wrap: wrap; gap: var(--s-3) var(--s-5); }
.footer-nav a { color: var(--ink-2); text-decoration: none; transition: color var(--dur-1) var(--ease); }
.footer-nav a:hover { color: var(--ink); text-decoration: underline; }
.footer-base { grid-column: 1 / -1; padding-top: var(--s-5); border-top: 1px solid var(--rule); color: var(--ink-3); font-family: var(--font-mono); font-size: var(--fs-xs); letter-spacing: var(--tracking-label); text-transform: uppercase; }
@media (max-width: 640px) {
  .site-footer .container { grid-template-columns: 1fr; }
}

/* ------------------------------------------------------------------ reduced motion */
@media (prefers-reduced-motion: reduce) {
  .toc-indicator, .toc-list a, .toc-list a .icon, .site-nav a, .footer-nav a { transition: none; }
}
