/* API reference page. Standalone: no dependency on styles.css, so it can look like developer docs.
   Markup is generated by scripts/website/buildApiDocs.ts. */

:root {
  --bg: #ffffff;
  --bg-soft: #f6f8fa;
  --bg-nav: #fbfbfc;
  --ink: #0f172a;
  --ink-2: #334155;
  --ink-3: #64748b;
  --line: #e2e8f0;
  --accent: #2563eb;
  --accent-soft: #e8f0fe;
  --inline-bg: #eef2f7;
  --inline-ink: #0f172a;

  --get: #15803d;
  --post: #2563eb;
  --patch: #c2410c;
  --delete: #dc2626;

  --callout-bg: #eff6ff;
  --callout-line: #bfdbfe;
  --warn-bg: #fff7ed;
  --warn-line: #fed7aa;

  --code-bg: #0b1220;
  --code-head: #111a2e;
  --code-line: #1e293b;
  --code-ink: #dbe4f0;
  --code-muted: #64748b;
  --tok-key: #7dd3fc;
  --tok-str: #86efac;
  --tok-num: #fbbf24;
  --tok-bool: #f0abfc;

  --font: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, Roboto, "Helvetica Neue", Arial, sans-serif;
  --mono: "JetBrains Mono", "SF Mono", ui-monospace, "Cascadia Code", Menlo, Consolas, "Liberation Mono", monospace;

  --bar-h: 52px;
  --code-w: 44%;
  --offset: 76px;
  color-scheme: light dark;
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg: #0f1623;
    --bg-soft: #151d2d;
    --bg-nav: #0c1220;
    --ink: #e5ecf6;
    --ink-2: #b6c2d4;
    --ink-3: #8394ab;
    --line: #243047;
    --accent: #6ea8fe;
    --accent-soft: #1b2a47;
    --inline-bg: #1c2740;
    --inline-ink: #dbe7f7;
    --get: #4ade80;
    --post: #6ea8fe;
    --patch: #fb923c;
    --delete: #f87171;
    --callout-bg: #12233f;
    --callout-line: #234472;
    --warn-bg: #2a1c12;
    --warn-line: #5b3a1d;
    --code-bg: #070c16;
    --code-head: #0d1526;
    --code-line: #1a2438;
  }
}

* { box-sizing: border-box; }

html { scroll-padding-top: var(--offset); }

body.api-page {
  margin: 0;
  background: var(--bg);
  color: var(--ink-2);
  font-family: var(--font);
  font-size: 15px;
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
}

/* ---------------------------------------------------------------- top bar */

.api-bar {
  position: sticky;
  top: 0;
  z-index: 40;
  height: var(--bar-h);
  background: var(--bg);
  border-bottom: 1px solid var(--line);
}

.api-bar-inner {
  display: flex;
  align-items: center;
  gap: 10px;
  height: 100%;
  padding: 0 20px;
}

.api-brand {
  display: flex;
  align-items: center;
  gap: 8px;
  color: var(--ink);
  font-weight: 700;
  text-decoration: none;
  white-space: nowrap;
}

.api-brand img { border-radius: 5px; }

.api-sep { color: var(--line); font-size: 1.3rem; }

.api-title { color: var(--ink); white-space: nowrap; }

.api-ver {
  padding: 0 7px;
  border-radius: 5px;
  background: var(--accent-soft);
  color: var(--accent);
  font-family: var(--mono);
  font-size: 0.74rem;
  font-weight: 600;
  line-height: 20px;
}

.api-base {
  margin-left: 6px;
  min-width: 0;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
  font-family: var(--mono);
  font-size: 0.78rem;
  color: var(--ink-3);
}

.api-spacer { flex: 1; }

.lang-switch-bar {
  display: flex;
  gap: 2px;
  padding: 3px;
  border-radius: 8px;
  background: var(--bg-soft);
  border: 1px solid var(--line);
}

.lang-switch-bar button {
  padding: 3px 11px;
  border: 0;
  border-radius: 6px;
  background: transparent;
  color: var(--ink-3);
  font: inherit;
  font-size: 0.8rem;
  font-weight: 600;
  cursor: pointer;
}

.lang-switch-bar button:hover { color: var(--ink); }

.lang-switch-bar button[aria-selected="true"] {
  background: var(--bg);
  color: var(--ink);
  box-shadow: 0 0 0 1px var(--line);
}

.bar-link {
  padding: 5px 10px;
  border-radius: 7px;
  color: var(--ink-2);
  font-size: 0.85rem;
  font-weight: 500;
  text-decoration: none;
  white-space: nowrap;
}

.bar-link:hover { background: var(--bg-soft); color: var(--ink); }

.bar-cta {
  background: var(--accent);
  color: #fff;
  font-weight: 600;
}

.bar-cta:hover { background: var(--accent); color: #fff; filter: brightness(1.1); }

/* ------------------------------------------------------------------ shell */

.api-shell {
  display: grid;
  grid-template-columns: 264px minmax(0, 1fr);
  align-items: start;
}

.api-nav {
  position: sticky;
  top: var(--bar-h);
  height: calc(100vh - var(--bar-h));
  border-right: 1px solid var(--line);
  background: var(--bg-nav);
}

.api-nav-toggle { display: none; }

.api-nav-list {
  height: 100%;
  overflow-y: auto;
  padding: 18px 12px 40px 16px;
  font-size: 0.86rem;
}

.api-nav h4 {
  margin: 18px 0 4px 8px;
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ink-3);
}

.api-nav h4:first-child { margin-top: 0; }

.api-nav ul { list-style: none; margin: 0; padding: 0; }

.api-nav a {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 4px 8px;
  border-radius: 6px;
  color: var(--ink-2);
  text-decoration: none;
  line-height: 1.35;
}

.api-nav a:hover { background: var(--bg-soft); color: var(--ink); }

.api-nav a.is-current {
  background: var(--accent-soft);
  color: var(--accent);
  font-weight: 600;
}

.nv {
  flex: 0 0 42px;
  font-family: var(--mono);
  font-size: 0.62rem;
  font-weight: 700;
}

.nv.get { color: var(--get); }
.nv.post { color: var(--post); }
.nv.patch { color: var(--patch); }
.nv.delete { color: var(--delete); }

/* ------------------------------------------------------------------- rows */

.api-main {
  min-width: 0;
  background: linear-gradient(to right, var(--bg) calc(100% - var(--code-w)), var(--code-bg) 0);
}

.row {
  display: grid;
  grid-template-columns: minmax(0, 1fr) var(--code-w);
  scroll-margin-top: var(--offset);
}

.row .doc {
  min-width: 0;
  padding: 40px 44px 40px 52px;
  border-top: 1px solid var(--line);
}

.row .code {
  min-width: 0;
  padding: 40px 28px;
  border-top: 1px solid var(--code-line);
}

.row:first-child .doc,
.row:first-child .code { border-top: 0; }

/* The examples stay in view while a long description scrolls past. */
.code-stick {
  position: sticky;
  top: calc(var(--bar-h) + 24px);
  max-height: calc(100vh - var(--bar-h) - 48px);
  overflow-y: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--code-line) transparent;
}

.row .doc h2 {
  margin: 0 0 14px;
  color: var(--ink);
  font-size: 1.75rem;
  font-weight: 700;
  letter-spacing: -0.02em;
  line-height: 1.2;
}

.row .doc h3 {
  margin: 0 0 12px;
  color: var(--ink);
  font-size: 1.3rem;
  font-weight: 700;
  letter-spacing: -0.015em;
  line-height: 1.25;
}

.row .doc h4 {
  margin: 24px 0 8px;
  color: var(--ink);
  font-size: 0.95rem;
  font-weight: 650;
}

.row .doc p,
.row .doc ul,
.row .doc ol { margin: 0 0 14px; }

.row .doc ul,
.row .doc ol { padding-left: 1.3em; }

.row .doc li { margin-bottom: 6px; }

.row .doc a { color: var(--accent); text-decoration: none; }
.row .doc a:hover { text-decoration: underline; }

.row .doc code {
  padding: 1px 5px;
  border-radius: 5px;
  background: var(--inline-bg);
  color: var(--inline-ink);
  font-family: var(--mono);
  font-size: 0.85em;
  word-break: break-word;
}

.row .doc .note { color: var(--ink-3); font-size: 0.88rem; }

.sub-head .doc,
.sub-head .code { border-top: 2px solid var(--ink); }

.sub-head .code { border-top-color: var(--code-line); }

.steps { padding-left: 1.4em; }

/* ---------------------------------------------------------- endpoint bits */

.ep-line {
  display: flex;
  align-items: center;
  gap: 10px;
  margin: 0 0 8px;
  padding: 7px 12px;
  border: 1px solid var(--line);
  border-radius: 8px;
  background: var(--bg-soft);
  overflow-x: auto;
}

.row .doc .ep-path {
  padding: 0;
  background: none;
  font-size: 0.9rem;
  white-space: nowrap;
}

.verb {
  display: inline-block;
  min-width: 54px;
  padding: 1px 8px;
  border-radius: 5px;
  text-align: center;
  font-family: var(--mono);
  font-size: 0.72rem;
  font-weight: 700;
  color: #fff;
}

.verb.get { background: #16a34a; }
.verb.post { background: #2563eb; }
.verb.patch { background: #ea580c; }
.verb.delete { background: #dc2626; }

.row .doc .scope-line { color: var(--ink-3); font-size: 0.85rem; }

.params-title {
  padding-bottom: 8px;
  border-bottom: 1px solid var(--line);
  color: var(--ink-3) !important;
  font-size: 0.72rem !important;
  font-weight: 700 !important;
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.row .doc ul.params { list-style: none; margin: 0 0 16px; padding: 0; }

.params li { margin: 0; padding: 11px 0; border-bottom: 1px solid var(--line); }

.params li p { margin: 3px 0 0 !important; font-size: 0.9rem; }

.param-head { display: flex; flex-wrap: wrap; align-items: baseline; gap: 2px 10px; }

.row .doc .param-name {
  padding: 0;
  background: none;
  color: var(--ink);
  font-size: 0.88rem;
  font-weight: 700;
}

.param-type { color: var(--ink-3); font-family: var(--mono); font-size: 0.75rem; }

.param-req {
  color: var(--delete);
  font-size: 0.68rem;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

.callout {
  margin: 0 0 16px;
  padding: 11px 15px;
  border: 1px solid var(--callout-line);
  border-radius: 8px;
  background: var(--callout-bg);
  color: var(--ink);
}

.callout.warn { border-color: var(--warn-line); background: var(--warn-bg); }
.callout p:last-child { margin-bottom: 0 !important; }

.table-wrap {
  margin: 0 0 16px;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: 8px;
}

.table-wrap table { width: 100%; border-collapse: collapse; font-size: 0.86rem; }

.table-wrap th,
.table-wrap td {
  padding: 8px 12px;
  border-bottom: 1px solid var(--line);
  text-align: left;
  vertical-align: top;
}

.table-wrap tr:last-child td { border-bottom: 0; }

.table-wrap th {
  background: var(--bg-soft);
  color: var(--ink-3);
  font-size: 0.7rem;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  white-space: nowrap;
}

.table-wrap td:first-child { white-space: nowrap; }

/* ------------------------------------------------------------- code cards */

.card {
  margin: 0 0 16px;
  overflow: hidden;
  border: 1px solid var(--code-line);
  border-radius: 8px;
  background: var(--code-bg);
}

.card:last-child { margin-bottom: 0; }

.card-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 7px 14px;
  border-bottom: 1px solid var(--code-line);
  background: var(--code-head);
  color: var(--code-muted);
  font-size: 0.68rem;
  font-weight: 700;
  letter-spacing: 0.09em;
  text-transform: uppercase;
}

.status {
  padding: 0 7px;
  border-radius: 5px;
  font-family: var(--mono);
  font-size: 0.74rem;
  letter-spacing: 0;
}

.status.ok { background: rgba(74, 222, 128, 0.14); color: #4ade80; }
.status.err { background: rgba(248, 113, 113, 0.16); color: #f87171; }

.lang-panel[hidden] { display: none; }

.code-block {
  position: relative;
  max-height: 560px;
  margin: 0;
  padding: 14px 16px;
  overflow: auto;
  background: transparent;
  color: var(--code-ink);
  font-family: var(--mono);
  font-size: 0.78rem;
  line-height: 1.7;
  tab-size: 2;
}

.code-block code {
  padding: 0;
  background: none;
  color: inherit;
  font: inherit;
  white-space: pre;
}

.code-block .k { color: var(--tok-key); }
.code-block .s { color: var(--tok-str); }
.code-block .n { color: var(--tok-num); }
.code-block .b { color: var(--tok-bool); }
.code-block .c { color: var(--code-muted); font-style: italic; }

.copy-btn {
  position: sticky;
  top: 0;
  float: right;
  margin: -4px -6px 0 8px;
  padding: 2px 8px;
  border: 1px solid #2a3750;
  border-radius: 6px;
  background: var(--code-head);
  color: var(--code-ink);
  font: inherit;
  font-family: var(--font);
  font-size: 0.7rem;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.12s;
}

.code-block:hover .copy-btn,
.copy-btn:focus-visible { opacity: 1; }

.copy-btn:hover { background: #1a2640; }

/* One fixed pane on desktop (built by js/api.js): the examples of the section being read slide in. */

.api-main.has-pane {
  display: grid;
  grid-template-columns: minmax(0, 1fr) var(--code-w);
  align-items: start;
}

.api-main.has-pane .row { display: block; grid-column: 1; }
.api-main.has-pane .row .code { display: none; }

.code-pane {
  grid-column: 2;
  grid-row: 1 / span 120;
  position: sticky;
  top: var(--bar-h);
  height: calc(100vh - var(--bar-h));
  min-width: 0;
  padding: 32px 28px;
  overflow-y: auto;
  scrollbar-width: thin;
  scrollbar-color: var(--code-line) transparent;
}

.code-pane .code-stick {
  display: none;
  position: static;
  max-height: none;
  overflow: visible;
}

.code-pane .code-stick.is-active { display: block; animation: pane-in 0.3s ease both; }

.code-pane .code-block { max-height: none; }

@keyframes pane-in {
  from { opacity: 0; transform: translateY(-16px); }
  to { opacity: 1; transform: none; }
}

@media (prefers-reduced-motion: reduce) {
  .code-pane .code-stick.is-active { animation: none; }
}

/* ----------------------------------------------------------------- footer */

.api-foot {
  display: flex;
  flex-wrap: wrap;
  gap: 8px 22px;
  padding: 22px 52px;
  border-top: 1px solid var(--line);
  background: var(--bg-nav);
  color: var(--ink-3);
  font-size: 0.82rem;
}

.api-foot a { color: var(--ink-3); text-decoration: none; }
.api-foot a:hover { color: var(--ink); }

/* ----------------------------------------------------------------- narrow */

@media (max-width: 1180px) {
  :root { --code-w: 48%; }
  .code-pane { padding: 28px 20px; }
  .row .doc { padding: 34px 28px 34px 32px; }
  .row .code { padding: 34px 20px; }
  .api-base { display: none; }
}

@media (max-width: 980px) {
  :root { --offset: 108px; }

  .api-shell { grid-template-columns: minmax(0, 1fr); }

  .api-nav {
    z-index: 30;
    height: auto;
    border-right: 0;
    border-bottom: 1px solid var(--line);
  }

  .api-nav-toggle {
    display: block;
    width: 100%;
    padding: 11px 20px;
    border: 0;
    background: transparent;
    color: var(--ink);
    font: inherit;
    font-weight: 600;
    text-align: left;
    cursor: pointer;
  }

  .api-nav-list { display: none; height: auto; max-height: 60vh; }
  .api-nav.is-open .api-nav-list { display: block; }

  .api-main { background: var(--bg); }

  .row { grid-template-columns: minmax(0, 1fr); }
  .row .doc { padding: 30px 20px 8px; }

  .row .code {
    padding: 8px 20px 30px;
    border-top: 0;
    background: var(--code-bg);
  }

  .row .code:empty { display: none; }
  .code-stick { position: static; max-height: none; overflow: visible; }

  .api-foot { padding: 20px; }
  .bar-link:not(.bar-cta) { display: none; }
  .api-sep, .api-title { display: none; }
}

@media (max-width: 520px) {
  .api-bar-inner { padding: 0 12px; gap: 8px; }
  .api-brand { font-size: 0; gap: 0; }
  .bar-cta { display: none; }
}