/* ==========================================================================
   HumanAPI Docs — dark, thin-line, monospace-accented design system
   No external dependencies. System fonts + inline SVG icons only.
   ========================================================================== */

:root {
  color-scheme: dark;
  --canvas: #08070d;
  --surface: #12101a;
  --raised: #191424;
  --ink: #f8f6fc;
  --muted: #c0b9cb;
  --dim: #9f96ad;
  --violet: #a78bfa;
  --violet-bright: #c4b5fd;
  --violet-deep: #6d28d9;
  --physical: #f0c98a;
  --mint: #8ee3c8;
  --rose: #f2a6b8;
  --line: rgba(221, 211, 255, 0.14);
  --line-strong: rgba(196, 181, 253, 0.32);
  --page: 1180px;
  --sans: "Avenir Next", "Segoe UI Variable", "Segoe UI", system-ui, -apple-system, sans-serif;
  --mono: "SFMono-Regular", "Cascadia Code", Consolas, "Liberation Mono", monospace;
}

* { box-sizing: border-box; }

html {
  background: var(--canvas);
  scroll-behavior: smooth;
  scroll-padding-top: 6.5rem;
}

body {
  min-width: 320px;
  min-height: 100vh;
  margin: 0;
  background: var(--canvas);
  color: var(--ink);
  font-family: var(--sans);
  line-height: 1.6;
  text-rendering: optimizeLegibility;
  -webkit-font-smoothing: antialiased;
}

a { color: inherit; text-decoration: none; }
code, pre, kbd { font-family: var(--mono); }
::selection { background: rgba(167, 139, 250, .34); color: white; }
:where(a, button, summary):focus-visible { outline: 3px solid #e9d5ff; outline-offset: 4px; }

body::before, body::after { position: fixed; inset: 0; z-index: -2; pointer-events: none; content: ""; }
body::before {
  background:
    radial-gradient(circle at 76% 9%, rgba(109, 40, 217, .2), transparent 28rem),
    radial-gradient(circle at 12% 32%, rgba(91, 33, 182, .1), transparent 25rem),
    linear-gradient(180deg, #0b0812, var(--canvas) 42%, #09070f);
}
body::after {
  z-index: -1;
  opacity: .35;
  background-image:
    linear-gradient(rgba(196, 181, 253, .045) 1px, transparent 1px),
    linear-gradient(90deg, rgba(196, 181, 253, .045) 1px, transparent 1px);
  background-size: 64px 64px;
  mask-image: linear-gradient(to bottom, #000, transparent 58%);
  -webkit-mask-image: linear-gradient(to bottom, #000, transparent 58%);
}

/* ---------- skip link ---------- */
.skip-link {
  position: fixed; top: .75rem; left: .75rem; z-index: 999;
  display: inline-flex; min-height: 44px; align-items: center;
  padding: 0 1rem; border-radius: .65rem;
  background: white; color: #17121f; font-weight: 700;
  transform: translateY(-160%); transition: transform .16s ease;
}
.skip-link:focus-visible { transform: translateY(0); }

/* ---------- shell & header ---------- */
.site-shell { position: relative; isolation: isolate; min-height: 100vh; overflow-x: clip; }

.site-header {
  position: sticky; top: 0; z-index: 100;
  border-bottom: 1px solid var(--line);
  background: rgba(8, 7, 13, .84);
  -webkit-backdrop-filter: blur(18px);
  backdrop-filter: blur(18px);
}
.header-inner, .hero-inner, .section, .site-footer, .doc-layout {
  width: min(calc(100% - 2.5rem), var(--page));
  margin-inline: auto;
}
.header-inner { display: flex; min-height: 72px; align-items: center; gap: 1.5rem; }
.brand { display: inline-flex; min-height: 44px; align-items: center; gap: .7rem; font-size: 1.05rem; font-weight: 760; letter-spacing: -.02em; }
.brand-mark {
  width: 32px; height: 32px; overflow: visible;
  fill: var(--canvas); stroke: var(--violet-bright);
  stroke-linecap: round; stroke-linejoin: round; stroke-width: 2.25;
  filter: drop-shadow(0 0 10px rgba(167, 139, 250, .42));
}
.site-nav { margin-left: auto; }
.site-nav ul { display: flex; align-items: center; gap: .15rem; margin: 0; padding: 0; list-style: none; }
.site-nav a {
  display: inline-flex; min-height: 44px; align-items: center;
  padding: 0 .8rem; border-radius: .65rem;
  color: var(--muted); font-size: .875rem; font-weight: 620;
  transition: color .16s ease, background-color .16s ease;
}
.site-nav a:hover { color: white; background: rgba(255, 255, 255, .06); }
.site-nav a[aria-current="page"] { color: var(--violet-bright); background: rgba(167, 139, 250, .09); }
.header-action {
  display: inline-flex; min-height: 44px; flex: 0 0 auto;
  align-items: center; justify-content: center; gap: .45rem;
  padding: 0 1rem; border: 1px solid var(--line-strong); border-radius: 999px;
  background: rgba(167, 139, 250, .07); font-size: .875rem; font-weight: 700;
  transition: border-color .16s ease, background-color .16s ease;
}
.header-action:hover { border-color: rgba(196, 181, 253, .58); background: rgba(167, 139, 250, .14); }

/* ---------- hero ---------- */
.hero { position: relative; padding: clamp(4.5rem, 9vw, 8rem) 0 clamp(5rem, 10vw, 8.5rem); }
.hero::after {
  position: absolute; right: -10rem; bottom: -4rem;
  width: 32rem; height: 32rem;
  border: 1px solid rgba(167, 139, 250, .1); border-radius: 50%;
  box-shadow: 0 0 0 5rem rgba(167, 139, 250, .018), 0 0 0 10rem rgba(167, 139, 250, .012);
  pointer-events none; content: "";
}
.hero-inner {
  position: relative; z-index: 1;
  display: grid; grid-template-columns: minmax(0, 1.03fr) minmax(390px, .97fr);
  align-items: center; gap: clamp(3.5rem, 7vw, 7rem);
}
.hero-copy { min-width: 0; }
.eyebrow, .section-label {
  margin: 0 0 1.45rem; color: var(--violet-bright);
  font-family: var(--mono); font-size: .75rem; font-weight: 700;
  letter-spacing: .105em; line-height: 1.4; text-transform: uppercase;
}
.eyebrow { display: flex; align-items: center; gap: .65rem; }
.eyebrow > span {
  width: 8px; height: 8px; flex: 0 0 auto; border-radius: 50%;
  background: var(--violet);
  box-shadow: 0 0 0 5px rgba(167, 139, 250, .12), 0 0 18px var(--violet);
}
h1 {
  max-width: 760px; margin: 0;
  font-size: clamp(3rem, 6vw, 5.6rem); font-weight: 760;
  letter-spacing: -.06em; line-height: 1.02;
}
h1 em {
  background: linear-gradient(100deg, #fff 5%, var(--violet-bright) 54%, var(--violet) 100%);
  background-clip: text; color: transparent;
  -webkit-background-clip: text; font-style: normal;
}
.hero-lead { max-width: 650px; margin: 2rem 0 0; color: var(--muted); font-size: clamp(1.05rem, 1.5vw, 1.2rem); line-height: 1.8; }
.hero-actions { display: flex; flex-wrap: wrap; gap: .75rem; margin-top: 2.25rem; }
.button {
  display: inline-flex; min-height: 50px; align-items: center; justify-content: center;
  gap: .7rem; padding: .78rem 1.3rem; border: 1px solid transparent; border-radius: .85rem;
  font-size: .95rem; font-weight: 750; line-height: 1.2;
  transition: border-color .16s ease, background-color .16s ease, transform .16s ease;
}
.button.primary {
  border-color: rgba(216, 180, 254, .38);
  background: linear-gradient(135deg, #7133d6, #5b21b6);
  box-shadow: 0 14px 38px rgba(91, 33, 182, .25); color: white;
}
.button.primary:hover { background: linear-gradient(135deg, #6427c5, #4c1d95); transform: translateY(-2px); }
.button.secondary { border-color: var(--line-strong); background: rgba(255, 255, 255, .035); }
.button.secondary:hover { border-color: rgba(196, 181, 253, .58); background: rgba(255, 255, 255, .075); transform: translateY(-2px); }
.hero-facts {
  display: grid; max-width: 660px; grid-template-columns: repeat(3, minmax(0, 1fr));
  margin: 3rem 0 0; padding: 1.15rem 0; border-block: 1px solid var(--line);
}
.hero-facts > div { min-width: 0; padding-inline: 1.2rem; border-left: 1px solid var(--line); }
.hero-facts > div:first-child { padding-left: 0; border-left: 0; }
.hero-facts dt { overflow: hidden; margin-bottom: .22rem; font-size: .92rem; font-weight: 750; text-overflow: ellipsis; white-space: nowrap; }
.hero-facts dt code { color: var(--violet-bright); font-size: .78rem; }
.hero-facts dd { margin: 0; color: var(--dim); font-size: .82rem; }

/* ---------- signal / flow panel ---------- */
.signal {
  position: relative; min-width: 0; margin: 0; overflow: hidden;
  border: 1px solid var(--line-strong); border-radius: 1.6rem;
  background: linear-gradient(145deg, rgba(30, 23, 45, .96), rgba(13, 10, 20, .98));
  box-shadow: 0 36px 90px rgba(0, 0, 0, .42), 0 0 80px rgba(109, 40, 217, .1);
}
.signal::before {
  position: absolute; top: -5rem; right: -5rem; width: 15rem; height: 15rem;
  border-radius: 50%; background: rgba(124, 58, 237, .16); filter: blur(55px); content: "";
}
.signal-bar {
  position: relative; display: flex; min-height: 50px; align-items: center;
  justify-content: space-between; gap: 1rem; padding: .75rem 1rem;
  border-bottom: 1px solid var(--line); color: var(--dim);
  font-family: var(--mono); font-size: .68rem; letter-spacing: .055em; text-transform: uppercase;
}
.signal-bar > span:last-child { display: inline-flex; align-items: center; gap: .45rem; color: var(--violet-bright); }
.signal-bar i { width: 7px; height: 7px; border-radius: 50%; background: var(--violet); box-shadow: 0 0 12px var(--violet); }
.signal-stage {
  position: relative; display: grid;
  grid-template-columns: minmax(90px, 1fr) minmax(108px, 1.15fr) minmax(90px, 1fr);
  align-items: center; gap: .6rem; min-height: 230px; padding: 1.8rem 2rem;
}
.signal-node { display: flex; min-width: 0; flex-direction: column; align-items: center; text-align: center; }
.signal-node > small { margin-bottom: .8rem; color: var(--dim); font-family: var(--mono); font-size: .62rem; font-weight: 700; letter-spacing: .11em; text-transform: uppercase; }
.node-orb {
  display: grid; width: clamp(68px, 9vw, 82px); height: clamp(68px, 9vw, 82px);
  place-items: center; margin-bottom: .75rem;
  border: 1px solid var(--line-strong); border-radius: 50%;
  font-family: var(--mono); font-size: 1rem;
}
.agent-orb { background: radial-gradient(circle at 35% 30%, #8b5cf6, #4c1d95 68%, #281447); box-shadow: 0 0 0 7px rgba(139, 92, 246, .08), 0 0 30px rgba(139, 92, 246, .24); }
.human-orb {
  border-color: rgba(240, 201, 138, .45);
  background: radial-gradient(circle at 35% 30%, #f1d19f, #9a5c31 70%, #462919);
  box-shadow: 0 0 0 7px rgba(240, 201, 138, .06), 0 0 30px rgba(240, 201, 138, .14);
  color: #18100a;
}
.signal-node > strong { font-size: .9rem; }
.signal-node > span { overflow: hidden; max-width: 100%; margin-top: .16rem; color: var(--dim); font-family: var(--mono); font-size: .58rem; text-overflow: ellipsis; white-space: nowrap; }
.signal-track { position: relative; height: 72px; }
.signal-track small { position: absolute; top: 0; left: 50%; color: var(--violet-bright); font-family: var(--mono); font-size: .56rem; font-weight: 700; letter-spacing: .08em; transform: translateX(-50%); white-space: nowrap; }
.signal-track > i { position: absolute; top: 38px; right: 0; left: 0; height: 1px; background: linear-gradient(90deg, var(--violet), var(--violet-bright) 55%, var(--physical)); box-shadow: 0 0 10px rgba(167, 139, 250, .42); }
.signal-track > b {
  position: absolute; top: 28px; left: 50%; z-index: 2;
  display: grid; min-width: 38px; height: 21px; place-items: center;
  border: 1px solid rgba(216, 180, 254, .55); border-radius: .35rem;
  background: #241539; font-family: var(--mono); font-size: .5rem;
  letter-spacing: .05em; transform: translateX(-50%);
}
.signal-track > span { position: absolute; right: -.12rem; bottom: 1px; color: var(--physical); font-family: var(--mono); font-size: .8rem; }
.trace-list { margin: 0 2rem; padding: 0; border-top: 1px solid var(--line); list-style: none; }
.trace-list li {
  display: grid; grid-template-columns: 2rem 5.7rem minmax(0, 1fr);
  align-items: center; gap: .65rem; min-height: 48px;
  border-bottom: 1px solid var(--line); font-size: .7rem;
}
.trace-list li > span { color: var(--dim); font-family: var(--mono); }
.trace-list strong { font-family: var(--mono); font-size: .65rem; letter-spacing: .055em; text-transform: uppercase; }
.trace-list code { overflow: hidden; color: var(--violet-bright); font-size: .61rem; text-align: right; text-overflow: ellipsis; white-space: nowrap; }
.signal figcaption { padding: 1rem 1.2rem; color: var(--dim); font-size: .78rem; text-align: center; }

/* ---------- generic sections ---------- */
.section { position: relative; padding: clamp(4.5rem, 9vw, 7.5rem) 0; scroll-margin-top: 6rem; }
.ruled::before, .site-footer::before {
  position: absolute; top: 0; left: 50%; width: 100%; height: 1px;
  background: linear-gradient(90deg, transparent, var(--line-strong) 16%, var(--line-strong) 84%, transparent);
  content: ""; transform: translateX(-50%);
}
.section-heading { margin-bottom: clamp(2.5rem, 5vw, 4.5rem); }
.split-heading { display: grid; grid-template-columns: minmax(0, 1.3fr) minmax(280px, .7fr); align-items: end; gap: clamp(2rem, 6vw, 7rem); }
h2 { max-width: 820px; margin: 0; font-size: clamp(2rem, 4.2vw, 3.6rem); font-weight: 740; letter-spacing: -.05em; line-height: 1.1; }
h3 { margin: 0 0 .6rem; font-size: 1.05rem; letter-spacing: -.02em; }
.split-heading > p, .tools-intro > p:last-child, .scope-heading > p:last-child, .start-copy > p { margin: 0; color: var(--muted); line-height: 1.75; }
.section-label.warm { color: var(--physical); }
p > code, li > code, td > code, dd > code { padding: .1em .38em; border: 1px solid var(--line); border-radius: .35rem; background: rgba(167, 139, 250, .07); color: var(--violet-bright); font-size: .86em; }

/* ---------- doc cards (landing nav) ---------- */
.card-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 1rem; margin: 0; padding: 0; list-style: none; }
.doc-card {
  display: flex; min-width: 0; flex-direction: column; min-height: 300px;
  padding: clamp(1.4rem, 2.6vw, 2rem);
  border: 1px solid var(--line); border-radius: 1.25rem;
  background: linear-gradient(160deg, rgba(25, 20, 36, .6), rgba(13, 10, 20, .45));
  transition: border-color .18s ease, transform .18s ease;
}
.doc-card:hover { border-color: var(--line-strong); transform: translateY(-3px); }
.doc-card > .card-index { margin-bottom: 1.6rem; color: var(--violet); font-family: var(--mono); font-size: .72rem; font-weight: 700; }
.doc-card h3 { font-size: 1.2rem; }
.doc-card p { margin: 0 0 1.4rem; color: var(--muted); font-size: .9rem; line-height: 1.7; }
.doc-card ul { display: grid; gap: .55rem; margin: 0 0 1.8rem; padding: 0; color: var(--dim); font-size: .82rem; list-style: none; }
.doc-card li { position: relative; padding-left: 1.1rem; }
.doc-card li::before { position: absolute; top: .62em; left: 0; width: 5px; height: 5px; border-radius: 50%; background: var(--violet); box-shadow: 0 0 8px rgba(167, 139, 250, .6); content: ""; }
.doc-card .card-link { display: inline-flex; align-items: center; gap: .5rem; margin-top: auto; color: var(--violet-bright); font-size: .86rem; font-weight: 700; }
.doc-card .card-link::after { content: "→"; transition: transform .16s ease; }
.doc-card:hover .card-link::after { transform: translateX(4px); }

/* ---------- code windows / blocks ---------- */
.integration-section { background: linear-gradient(180deg, rgba(25, 18, 39, .55), rgba(10, 8, 15, .35)); box-shadow: inset 0 1px 0 var(--line), inset 0 -1px 0 var(--line); }
.code-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1rem; }
.code-window { min-width: 0; overflow: hidden; border: 1px solid var(--line-strong); border-radius: 1.25rem; background: rgba(8, 7, 13, .82); box-shadow: 0 22px 55px rgba(0, 0, 0, .22); }
.code-window header { display: flex; min-height: 84px; align-items: center; justify-content: space-between; gap: 1rem; padding: 1rem 1.25rem; border-bottom: 1px solid var(--line); }
.code-window header span { display: block; color: var(--violet); font-family: var(--mono); font-size: .62rem; font-weight: 800; letter-spacing: .11em; text-transform: uppercase; }
.code-window h3 { margin: .2rem 0 0; font-size: 1rem; }
.code-window header > code { flex: 0 0 auto; padding: .38rem .58rem; border: 1px solid var(--line); border-radius: .42rem; color: var(--violet-bright); font-size: .59rem; }
.code-window pre { margin: 0; overflow-x: auto; color: #eeeaf5; font-size: .74rem; line-height: 1.75; tab-size: 2; }
.code-window pre code { display: block; width: max-content; min-width: 100%; padding: 1.45rem; }
.code-window > p { min-height: 84px; margin: 0; padding: 1rem 1.25rem; border-top: 1px solid var(--line); color: var(--muted); font-size: .78rem; line-height: 1.65; }
.code-window > p code { color: var(--violet-bright); }

.code-block { position: relative; min-width: 0; margin: 1.15rem 0; overflow: hidden; border: 1px solid var(--line-strong); border-radius: 1rem; background: #0a0810; }
.code-head {
  display: flex; min-height: 44px; align-items: center; justify-content: space-between;
  gap: 1rem; padding: .45rem .55rem .45rem 1rem;
  border-bottom: 1px solid var(--line); background: rgba(255, 255, 255, .02);
}
.code-label { color: var(--dim); font-family: var(--mono); font-size: .66rem; letter-spacing: .09em; text-transform: uppercase; }
.copy-btn {
  display: inline-flex; align-items: center; gap: .4rem;
  min-height: 32px; padding: 0 .7rem;
  border: 1px solid var(--line); border-radius: .5rem;
  background: rgba(255, 255, 255, .03); color: var(--muted);
  font-family: var(--mono); font-size: .68rem; font-weight: 700;
  cursor: pointer; transition: color .16s ease, border-color .16s ease, background-color .16s ease;
}
.copy-btn:hover { color: var(--violet-bright); border-color: rgba(196, 181, 253, .5); background: rgba(167, 139, 250, .1); }
.copy-btn.copied { color: var(--mint); border-color: rgba(142, 227, 200, .5); background: rgba(142, 227, 200, .08); }
.copy-btn .copy-icon { flex: 0 0 auto; }
.code-block pre { margin: 0; overflow-x: auto; padding: 1.05rem 1.2rem; color: #eeeaf5; font-size: .76rem; line-height: 1.75; }
.code-block pre code { display: block; width: max-content; min-width: 100%; }

/* syntax tokens */
.tok-key { color: var(--violet-bright); }
.tok-str { color: #9fdcb5; }
.tok-num { color: var(--physical); }
.tok-bool { color: var(--rose); }
.tok-kw { color: var(--violet); }
.tok-comment { color: #6f6780; font-style: italic; }

/* ---------- terminal window ---------- */
.terminal { min-width: 0; overflow: hidden; border: 1px solid var(--line-strong); border-radius: 1rem; background: #09070d; box-shadow: 0 25px 65px rgba(0, 0, 0, .28); }
.terminal > .terminal-bar {
  display: flex; min-height: 50px; align-items: center; justify-content: space-between;
  padding: .75rem 1rem; border-bottom: 1px solid var(--line);
  color: var(--dim); font-family: var(--mono); font-size: .68rem;
  letter-spacing: .055em; text-transform: uppercase;
}
.terminal-bar > span:first-child { display: flex; gap: .38rem; }
.terminal-bar i { display: block; width: 8px; height: 8px; border-radius: 50%; background: rgba(196, 181, 253, .32); }
.terminal-bar i:nth-child(2) { background: rgba(167, 139, 250, .55); }
.terminal-bar i:nth-child(3) { background: rgba(240, 201, 138, .62); }
.terminal pre { margin: 0; overflow-x: auto; padding: 1.35rem; color: #eeeaf5; font-size: .74rem; line-height: 1.8; }
.terminal pre code { display: block; width: max-content; min-width: 100%; }

/* ---------- doc layout (api / mcp / getting-started) ---------- */
.doc-layout {
  display: grid; grid-template-columns: minmax(200px, 232px) minmax(0, 1fr);
  gap: clamp(2rem, 5vw, 4.5rem);
  padding: clamp(2.5rem, 6vw, 4.5rem) 0;
  align-items: start;
}
.doc-sidebar {
  position: sticky; top: 6.5rem;
  align-self: start; max-height: calc(100vh - 8.5rem); overflow-y: auto;
}
.doc-nav .nav-group + .nav-group { margin-top: 1.5rem; }
.doc-nav .nav-title { margin: 0 0 .5rem .7rem; color: var(--dim); font-family: var(--mono); font-size: .62rem; font-weight: 700; letter-spacing: .13em; text-transform: uppercase; }
.doc-nav ul { margin: 0; padding: 0; list-style: none; }
.doc-nav a {
  display: block; padding: .42rem .7rem;
  border-left: 1px solid var(--line); color: var(--muted);
  font-size: .84rem; line-height: 1.45;
  transition: color .16s ease, border-color .16s ease, background-color .16s ease;
}
.doc-nav a:hover { color: var(--ink); background: rgba(255, 255, 255, .04); }
.doc-nav a.active { color: var(--violet-bright); border-left-color: var(--violet); background: rgba(167, 139, 250, .07); }
.doc-content { min-width: 0; }
.doc-intro { padding-bottom: 2.5rem; border-bottom: 1px solid var(--line); }
.doc-intro h1 { font-size: clamp(2.3rem, 4.6vw, 3.6rem); }
.doc-intro .doc-lead { max-width: 720px; margin: 1.6rem 0 0; color: var(--muted); font-size: 1.05rem; line-height: 1.8; }
.badge-row { display: flex; flex-wrap: wrap; gap: .5rem; margin-top: 1.8rem; }
.badge {
  display: inline-flex; align-items: center; gap: .4rem;
  padding: .3rem .65rem; border: 1px solid var(--line); border-radius: 999px;
  color: var(--dim); font-family: var(--mono); font-size: .68rem; letter-spacing: .04em;
}
.badge b { color: var(--violet-bright); font-weight: 700; }

.doc-section { padding: clamp(2.75rem, 6vw, 4.25rem) 0; border-bottom: 1px solid var(--line); }
.doc-section:last-child { border-bottom: 0; }
.doc-section > h2 { font-size: clamp(1.6rem, 3vw, 2.2rem); margin-bottom: 1.2rem; }
.doc-section > .section-label { margin-bottom: 1rem; }
.doc-section > p { max-width: 780px; color: var(--muted); line-height: 1.8; }
.doc-section h3 { margin: 2.4rem 0 .8rem; font-size: 1.05rem; }
.doc-section h3:first-of-type { margin-top: 1.6rem; }
.doc-section h4 { margin: 1.8rem 0 .6rem; color: var(--violet-bright); font-family: var(--mono); font-size: .8rem; font-weight: 700; letter-spacing: .06em; }
.doc-section ul.plain { margin: 1rem 0; padding: 0; color: var(--muted); line-height: 1.8; list-style: none; }
.doc-section ul.plain li { position: relative; padding-left: 1.2rem; }
.doc-section ul.plain li::before { position: absolute; top: .68em; left: 0; width: 5px; height: 5px; border-radius: 50%; background: var(--violet); content: ""; }
.doc-section ol.plain { margin: 1rem 0; padding-left: 1.4rem; color: var(--muted); line-height: 1.9; }

/* ---------- endpoint cards ---------- */
.endpoint {
  margin: 1.5rem 0; padding: 1.5rem clamp(1.1rem, 2.5vw, 1.75rem);
  border: 1px solid var(--line); border-radius: 1.15rem;
  background: linear-gradient(160deg, rgba(25, 20, 36, .55), rgba(13, 10, 20, .4));
  scroll-margin-top: 7rem;
}
.endpoint-head { display: flex; flex-wrap: wrap; align-items: center; gap: .8rem; margin-bottom: .8rem; }
.endpoint-path { font-family: var(--mono); font-size: .95rem; font-weight: 700; color: var(--ink); word-break: break-all; }
.endpoint-path .path-base { color: var(--dim); font-weight: 500; }
.endpoint-perm { margin-left: auto; color: var(--dim); font-family: var(--mono); font-size: .66rem; letter-spacing: .06em; text-transform: uppercase; white-space: nowrap; }
.endpoint > p { margin: .4rem 0 1rem; color: var(--muted); font-size: .9rem; line-height: 1.75; }
.method {
  display: inline-flex; min-width: 64px; justify-content: center;
  padding: .2rem .55rem; border: 1px solid; border-radius: .42rem;
  font-family: var(--mono); font-size: .64rem; font-weight: 800; letter-spacing: .08em;
}
.method-get { color: var(--violet-bright); border-color: rgba(196, 181, 253, .45); background: rgba(167, 139, 250, .1); }
.method-post { color: var(--mint); border-color: rgba(142, 227, 200, .4); background: rgba(142, 227, 200, .08); }
.method-put { color: var(--physical); border-color: rgba(240, 201, 138, .4); background: rgba(240, 201, 138, .08); }
.method-delete { color: var(--rose); border-color: rgba(242, 166, 184, .4); background: rgba(242, 166, 184, .08); }

.example-label { display: flex; align-items: center; gap: .6rem; margin: 1.4rem 0 .2rem; color: var(--dim); font-family: var(--mono); font-size: .66rem; font-weight: 700; letter-spacing: .11em; text-transform: uppercase; }
.example-label::after { flex: 1; height: 1px; background: var(--line); content: ""; }

/* ---------- tables ---------- */
.table-wrap { overflow-x: auto; margin: 1.25rem 0; border: 1px solid var(--line); border-radius: .9rem; }
table { width: 100%; border-collapse: collapse; font-size: .84rem; }
th {
  padding: .7rem 1rem; border-bottom: 1px solid var(--line-strong);
  background: rgba(255, 255, 255, .02); color: var(--violet-bright);
  font-family: var(--mono); font-size: .66rem; font-weight: 700;
  letter-spacing: .09em; text-transform: uppercase; text-align: left; white-space: nowrap;
}
td { padding: .7rem 1rem; border-bottom: 1px solid var(--line); color: var(--muted); vertical-align: top; line-height: 1.65; }
tbody tr:last-child td { border-bottom: 0; }
td:first-child { color: var(--ink); }
td code, th code { color: var(--violet-bright); font-size: .82em; }
td .mono { color: var(--violet-bright); font-family: var(--mono); font-size: .82em; }

/* ---------- callouts ---------- */
.note {
  margin: 1.25rem 0; padding: .9rem 1.1rem;
  border: 1px solid var(--line); border-left: 2px solid var(--violet); border-radius: .6rem;
  background: rgba(167, 139, 250, .05); color: var(--muted); font-size: .86rem; line-height: 1.7;
}
.note.warm { border-left-color: var(--physical); background: rgba(240, 201, 138, .05); }
.note b, .note strong { color: var(--ink); }

/* ---------- start strip (landing) ---------- */
.start-section {
  display: grid; grid-template-columns: minmax(0, 1fr) minmax(380px, .84fr);
  align-items: center; gap: clamp(3rem, 8vw, 8rem);
  padding: clamp(3rem, 6vw, 5rem) clamp(1rem, 5vw, 4.5rem);
  border-block: 1px solid var(--line-strong);
  background: linear-gradient(90deg, rgba(124, 58, 237, .055), transparent 45%);
}
.start-copy h2 { font-size: clamp(2rem, 4vw, 3.4rem); }
.start-copy > p { max-width: 590px; margin-top: 1.5rem; }
.start-copy .button { margin-top: 1.6rem; }

/* ---------- scope panel (landing) ---------- */
.scope-panel {
  position: relative; overflow: hidden; padding: clamp(1.6rem, 5vw, 4.5rem);
  border: 1px solid rgba(240, 201, 138, .26); border-radius: 1.7rem;
  background:
    radial-gradient(circle at 92% 8%, rgba(240, 201, 138, .08), transparent 22rem),
    linear-gradient(140deg, rgba(31, 24, 34, .96), rgba(14, 11, 18, .98));
}
.scope-panel::after {
  position: absolute; top: 1.6rem; right: 1.6rem; width: 11px; height: 11px;
  border: 1px solid rgba(240, 201, 138, .58); border-radius: 50%;
  box-shadow: 0 0 18px rgba(240, 201, 138, .3); content: "";
}
.scope-heading { display: grid; grid-template-columns: minmax(0, 1.2fr) minmax(280px, .8fr); align-items: end; gap: 1.5rem 5rem; }
.scope-heading .section-label { grid-column: 1 / -1; margin-bottom: 0; }
.scope-columns { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1px; margin-top: 3.5rem; overflow: hidden; border: 1px solid var(--line); border-radius: 1rem; background: var(--line); }
.scope-columns > div { padding: clamp(1.35rem, 3vw, 2rem); background: rgba(9, 7, 13, .72); }
.scope-columns h3 { margin: 0 0 1.35rem; font-size: 1rem; }
.scope-columns ul { display: grid; gap: .9rem; margin: 0; padding: 0; color: var(--muted); font-size: .9rem; line-height: 1.55; list-style: none; }
.scope-columns li { position: relative; padding-left: 1.35rem; }
.scope-columns li::before { position: absolute; top: .67em; left: 0; width: 6px; height: 6px; border-radius: 50%; content: ""; }
.present-list li::before { background: var(--violet); box-shadow: 0 0 10px rgba(167, 139, 250, .6); }
.next-list li::before { border: 1px solid var(--physical); }
.disclaimer { margin: 1.25rem 0 0; padding-top: 1.25rem; border-top: 1px solid var(--line); color: var(--physical); font-family: var(--mono); font-size: .72rem; }

/* ---------- tool cards (mcp) ---------- */
.tool-group { margin: 2.5rem 0 0; }
.tool-group > h3 { margin: 0 0 1rem; color: var(--violet-bright); font-family: var(--mono); font-size: .8rem; font-weight: 700; letter-spacing: .1em; text-transform: uppercase; }
.tool-card { margin: 0 0 1.4rem; padding: 1.4rem clamp(1.1rem, 2.5vw, 1.6rem); border: 1px solid var(--line); border-radius: 1.15rem; background: linear-gradient(160deg, rgba(25, 20, 36, .55), rgba(13, 10, 20, .4)); scroll-margin-top: 7rem; }
.tool-card .endpoint-head { margin-bottom: .6rem; }
.tool-card > p { margin: .3rem 0 1rem; color: var(--muted); font-size: .9rem; line-height: 1.7; }

/* ---------- footer ---------- */
.site-footer { position: relative; padding: 3rem 0 2rem; }
.footer-main { display: flex; align-items: flex-start; justify-content: space-between; gap: 2rem; }
.footer-main > div > p { margin: .45rem 0 0; color: var(--dim); font-size: .84rem; }
.site-footer nav { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 0 .4rem; }
.site-footer nav a { display: inline-flex; min-height: 44px; align-items: center; padding: 0 .8rem; border-radius: .65rem; color: var(--muted); font-size: .875rem; font-weight: 620; }
.site-footer nav a:hover { color: white; background: rgba(255, 255, 255, .06); }
.footer-meta { display: flex; flex-wrap: wrap; gap: .55rem 1.25rem; margin-top: 2.5rem; padding-top: 1.4rem; border-top: 1px solid var(--line); color: var(--dim); font-family: var(--mono); font-size: .67rem; letter-spacing: .045em; text-transform: uppercase; }

/* ---------- 404 ---------- */
.notfound { display: grid; min-height: calc(100vh - 72px); place-items: center; padding: 4rem 0 6rem; text-align: center; }
.notfound .nf-code { margin: 0; color: var(--violet-bright); font-family: var(--mono); font-size: clamp(4.5rem, 14vw, 9rem); font-weight: 800; letter-spacing: -.04em; line-height: 1; text-shadow: 0 0 60px rgba(167, 139, 250, .35); }
.notfound .nf-label { margin: 1.2rem 0 0; color: var(--dim); font-family: var(--mono); font-size: .72rem; letter-spacing: .18em; text-transform: uppercase; }
.notfound p { max-width: 460px; margin: 1.2rem auto 0; color: var(--muted); line-height: 1.8; }
.notfound .hero-actions { justify-content: center; }

/* ---------- motion ---------- */
@media (prefers-reduced-motion: no-preference) {
  .eyebrow > span, .signal-bar i { animation: pulse 3.2s ease-in-out infinite; }
  @keyframes pulse { 0%, 100% { opacity: .72; } 50% { opacity: 1; box-shadow: 0 0 0 6px rgba(167, 139, 250, .1), 0 0 20px var(--violet); } }
}
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after { scroll-behavior: auto !important; transition-duration: .01ms !important; animation-duration: .01ms !important; animation-iteration-count: 1 !important; }
}

/* ---------- responsive ---------- */
@media (max-width: 980px) {
  .hero-inner, .split-heading, .scope-heading, .code-grid, .card-grid, .start-section { grid-template-columns: minmax(0, 1fr); }
  .hero-copy { max-width: 780px; }
  .signal, .terminal { width: min(100%, 660px); }
  .scope-heading .section-label { grid-column: auto; }
  .doc-card { min-height: 0; }
}
@media (max-width: 900px) {
  .doc-layout { grid-template-columns: minmax(0, 1fr); }
  .doc-sidebar {
    position: static; max-height: none;
    display: flex; gap: 1.5rem; align-items: flex-start;
    overflow-x: auto; padding-bottom: .8rem;
    border-bottom: 1px solid var(--line);
    scrollbar-width: thin;
  }
  .doc-nav { flex: 0 0 auto; }
  .doc-nav a { white-space: nowrap; border-left: 0; border-bottom: 2px solid transparent; }
  .doc-nav a.active { border-bottom-color: var(--violet); }
}
@media (max-width: 800px) {
  html { scroll-padding-top: 8rem; }
  .header-inner { flex-wrap: wrap; gap: 0 1rem; padding-top: .65rem; }
  .site-nav { order: 3; width: 100%; margin-left: 0; overflow-x: auto; scrollbar-width: none; }
  .site-nav::-webkit-scrollbar { display: none; }
  .site-nav ul { justify-content: space-between; }
  .site-nav a { padding: 0 .55rem; font-size: .8rem; white-space: nowrap; }
  .header-action { margin-left: auto; }
  .section { scroll-margin-top: 8rem; }
  .scope-columns { grid-template-columns: minmax(0, 1fr); }
  .footer-main { flex-direction: column; }
  .site-footer nav { justify-content: flex-start; }
}
@media (max-width: 560px) {
  .header-inner, .hero-inner, .section, .site-footer, .doc-layout { width: min(calc(100% - 2rem), var(--page)); }
  body::after { background-size: 42px 42px; }
  .brand { gap: .55rem; }
  .brand-mark { width: 29px; height: 29px; }
  .header-action { padding-inline: .85rem; }
  .hero { padding-top: 3.5rem; }
  h1 { font-size: clamp(2.6rem, 12vw, 3.4rem); }
  .hero-lead { margin-top: 1.6rem; font-size: 1rem; }
  .hero-actions { align-items: stretch; flex-direction: column; }
  .button { width: 100%; }
  .hero-facts { grid-template-columns: 1fr; padding: 0; }
  .hero-facts > div, .hero-facts > div:first-child { display: grid; grid-template-columns: minmax(0, 1fr) auto; align-items: center; padding: .85rem 0; border-top: 1px solid var(--line); border-left: 0; }
  .hero-facts > div:first-child { border-top: 0; }
  .signal-stage { grid-template-columns: minmax(74px, 1fr) minmax(80px, 1fr) minmax(74px, 1fr); gap: .35rem; padding-inline: 1rem; }
  .node-orb { width: 62px; height: 62px; }
  .signal-node > span { display: none; }
  .trace-list { margin-inline: 1rem; }
  .trace-list li { grid-template-columns: 1.6rem 4.7rem minmax(0, 1fr); gap: .4rem; }
  .trace-list code { font-size: .52rem; }
  h2 { font-size: clamp(1.8rem, 9vw, 2.5rem); }
  .doc-intro h1 { font-size: clamp(2rem, 10vw, 2.8rem); }
  .code-window header { align-items: flex-start; flex-direction: column; justify-content: center; }
  .code-window pre, .code-block pre, .terminal pre { font-size: .68rem; }
  .scope-panel { border-radius: 1.25rem; }
  .scope-panel::after { top: 1.25rem; right: 1.25rem; }
  .start-section { width: 100%; padding-inline: 1rem; }
  .site-footer nav { display: grid; width: 100%; grid-template-columns: repeat(2, minmax(0, 1fr)); }
  .site-footer nav a { padding-inline: 0; }
  .endpoint-head { gap: .5rem; }
  .endpoint-perm { margin-left: 0; }
}

/* ---------- forced colors ---------- */
@media (forced-colors: active) {
  h1 em { background: none; color: CanvasText; -webkit-text-fill-color: CanvasText; }
  .node-orb, .button, .header-action, .scope-panel, .code-window, .code-block, .endpoint, .tool-card, .doc-card { border: 1px solid CanvasText; }
}
