:root {
  --bg: #F0EFEF;
  --bg-raised: #FFFFFF;
  --bg-sunken: #E8E7E5;
  --ink: #0F0F0F;
  --ink-2: #52504E;
  --ink-3: #98948F;
  --border: #DEDEDE;
  --border-soft: #EAE8E6;

  --ok: #16A34A; --ok-soft: #DCFCE7; --ok-border: #BBF7D0;
  --info: #2563EB; --info-soft: #DBEAFE; --info-border: #BFDBFE;
  --warn: #D97706; --warn-soft: #FEF3C7; --warn-border: #FDE68A;
  --danger: #DC2626; --danger-soft: #FEE2E2; --danger-border: #FECACA;
  --pending: #98948F; --pending-soft: #E8E7E5;

  --code-bg: #FAF9F7;
  --code-ink: #1F2328;
  --code-border: #E6E4E0;
  --code-ink-3: #8B8A85;
  --syn-k: #57606A; --syn-n: #1A7F37; --syn-s: #0550AE; --syn-c: #6E7781;

  --serif: 'Newsreader', Georgia, 'Times New Roman', serif;
  --sans: 'DM Sans', -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
  --mono: 'DM Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;

  --shell-max: 1440px;
  --nav-h: 56px;
  --shadow-sm: 0 1px 2px rgba(15,15,15,.05);
  --shadow-md: 0 4px 16px rgba(15,15,15,.08);
  --shadow-hi: 0 16px 48px rgba(15,15,15,.18);
  --ease: cubic-bezier(0.22, 1, 0.36, 1);

  /* z-index scale */
  --z-sticky: 80;
  --z-drawer: 90;
  --z-modal: 200;
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg: #131217; --bg-raised: #1C1A22; --bg-sunken: #232028;
    --ink: #F3F1F6; --ink-2: #B8B4C0; --ink-3: #7C7885;
    --border: #302C38; --border-soft: #262330;
    --ok: #4ADE80; --ok-soft: #12291B; --ok-border: #1C3B27;
    --info: #60A5FA; --info-soft: #12213D; --info-border: #1A2E52;
    --warn: #FBBF24; --warn-soft: #332107; --warn-border: #4A3210;
    --danger: #F87171; --danger-soft: #341313; --danger-border: #4A1B1B;
    --pending: #8B8792; --pending-soft: #232028;
    --code-bg: #21252B; --code-ink: #E9E6F0; --code-border: #363B42; --code-ink-3: #7E8593; --syn-k: #8B87A0; --syn-n: #F0C987; --syn-s: #A9E8C4; --syn-c: #6E6A80;
  }
}
:root[data-theme="dark"] {
  --bg: #131217; --bg-raised: #1C1A22; --bg-sunken: #232028;
  --ink: #F3F1F6; --ink-2: #B8B4C0; --ink-3: #7C7885;
  --border: #302C38; --border-soft: #262330;
  --ok: #4ADE80; --ok-soft: #12291B; --ok-border: #1C3B27;
  --info: #60A5FA; --info-soft: #12213D; --info-border: #1A2E52;
  --warn: #FBBF24; --warn-soft: #332107; --warn-border: #4A3210;
  --danger: #F87171; --danger-soft: #341313; --danger-border: #4A1B1B;
  --pending: #8B8792; --pending-soft: #232028;
  --code-bg: #21252B; --code-ink: #E9E6F0; --code-border: #363B42; --code-ink-3: #7E8593; --syn-k: #8B87A0; --syn-n: #F0C987; --syn-s: #A9E8C4; --syn-c: #6E6A80;
}
:root[data-theme="light"] {
  --bg: #F0EFEF; --bg-raised: #FFFFFF; --bg-sunken: #E8E7E5;
  --ink: #0F0F0F; --ink-2: #52504E; --ink-3: #98948F;
  --border: #DEDEDE; --border-soft: #EAE8E6;
  --ok: #16A34A; --ok-soft: #DCFCE7; --ok-border: #BBF7D0;
  --info: #2563EB; --info-soft: #DBEAFE; --info-border: #BFDBFE;
  --warn: #D97706; --warn-soft: #FEF3C7; --warn-border: #FDE68A;
  --danger: #DC2626; --danger-soft: #FEE2E2; --danger-border: #FECACA;
  --pending: #98948F; --pending-soft: #E8E7E5;
  --code-bg: #FAF9F7; --code-ink: #1F2328; --code-border: #E6E4E0; --code-ink-3: #8B8A85; --syn-k: #57606A; --syn-n: #1A7F37; --syn-s: #0550AE; --syn-c: #6E7781;
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  * { animation-duration: 0.001ms !important; transition-duration: 0.001ms !important; }
}

body {
  margin: 0;
  background: var(--bg);
  color: var(--ink);
  font-family: var(--sans);
  font-size: 15.5px;
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
  overflow-x: hidden;
}

/* Links: weight + underline carry meaning, not color — matches Biflus's own
   product design language (status/semantic color only, no decorative brand hue). */
a {
  color: var(--ink); font-weight: 600; text-decoration: underline;
  text-decoration-color: var(--border); text-underline-offset: 2px;
}
a:hover { text-decoration-color: var(--ink); }
a:focus-visible, button:focus-visible, summary:focus-visible, input:focus-visible {
  outline: 2px solid var(--ink);
  outline-offset: 2px;
  border-radius: 3px;
}

code, pre, .mono { font-family: var(--mono); }
svg.icon { width: 16px; height: 16px; flex-shrink: 0; }

/* ---------- Top bar: brand · search · actions ---------- */
.topbar {
  position: sticky; top: 0; z-index: var(--z-sticky);
  height: var(--nav-h);
  background: color-mix(in srgb, var(--bg-raised) 88%, transparent);
  backdrop-filter: saturate(180%) blur(12px);
  -webkit-backdrop-filter: saturate(180%) blur(12px);
  border-bottom: 1px solid var(--border-soft);
  display: flex; align-items: center; gap: 14px;
  padding: 0 18px;
}
.topbar-left { display: flex; align-items: center; gap: 4px; min-width: 0; flex-shrink: 0; }
.menu-toggle {
  display: none;
  border: none; background: none; color: var(--ink);
  width: 32px; height: 32px; border-radius: 8px; cursor: pointer;
  align-items: center; justify-content: center; margin-right: 2px; flex-shrink: 0;
}
.menu-toggle:hover { background: var(--bg-sunken); }
.menu-toggle svg { width: 19px; height: 19px; }
.topbar-brand { display: flex; align-items: center; gap: 9px; text-decoration: none; color: var(--ink); min-width: 0; }
.topbar-brand:hover { text-decoration: none; }
.topbar-mark {
  width: 26px; height: 26px; border-radius: 8px; background: var(--ink); color: var(--bg-raised);
  display: flex; align-items: center; justify-content: center; font-weight: 800; font-size: 12px; flex-shrink: 0;
}
.topbar-name { font-family: var(--serif); font-weight: 600; font-size: 17px; letter-spacing: 0; white-space: nowrap; }
.topbar-tag { font-size: 10.5px; color: var(--ink-3); font-weight: 600; text-transform: uppercase; letter-spacing: 0.06em; margin-left: 2px; white-space: nowrap; }
@media (max-width: 600px) { .topbar-tag { display: none; } }

/* Search trigger (opens the ⌘K palette) */
.topbar-search {
  display: flex; align-items: center; gap: 9px;
  flex: 0 1 380px; margin-left: 22px; min-width: 0;
  height: 36px; padding: 0 8px 0 12px;
  background: var(--bg-sunken); border: 1px solid var(--border-soft);
  border-radius: 10px; cursor: pointer; color: var(--ink-3);
  font-family: var(--sans); font-size: 13.5px; text-align: left;
  transition: border-color 0.15s var(--ease), background 0.15s var(--ease);
}
.topbar-search:hover { border-color: var(--border); background: var(--bg-raised); }
.topbar-search svg { width: 15px; height: 15px; flex-shrink: 0; }
.topbar-search .ts-label { flex: 1; color: var(--ink-2); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
kbd, .ts-kbd {
  font-family: var(--sans); font-size: 11px; font-weight: 600; color: var(--ink-3);
  background: var(--bg-raised); border: 1px solid var(--border);
  border-radius: 6px; padding: 2px 6px; line-height: 1; white-space: nowrap;
  box-shadow: 0 1px 0 var(--border-soft);
}
.ts-kbd { display: inline-flex; align-items: center; gap: 1px; }
.ts-cmd { font-size: 12px; }

.topbar-actions { display: flex; align-items: center; gap: 10px; margin-left: auto; flex-shrink: 0; }
.topbar-link {
  display: inline-flex; align-items: center; gap: 3px;
  color: var(--ink-2); font-size: 13px; font-weight: 600; text-decoration: none; white-space: nowrap;
}
.topbar-link:hover { color: var(--ink); text-decoration: none; }
.topbar-link svg { width: 12px; height: 12px; opacity: 0.7; }
@media (max-width: 720px) { .topbar-link { display: none; } }

.btn {
  display: inline-flex; align-items: center; justify-content: center; gap: 6px;
  height: 34px; padding: 0 14px; border-radius: 9px;
  font-family: var(--sans); font-size: 13px; font-weight: 700; line-height: 1;
  text-decoration: none; cursor: pointer; white-space: nowrap; border: 1px solid transparent;
  transition: transform 0.12s var(--ease), background 0.15s var(--ease), border-color 0.15s var(--ease), box-shadow 0.15s var(--ease);
}
.btn:hover { text-decoration: none; }
.btn:active { transform: translateY(1px); }
.btn-primary { background: var(--ink); color: var(--bg-raised); box-shadow: var(--shadow-sm); }
.btn-primary:hover { box-shadow: var(--shadow-md); }
.btn-secondary { background: var(--bg-raised); color: var(--ink); border-color: var(--border); }
.btn-secondary:hover { background: var(--bg-sunken); border-color: var(--ink-3); }
.btn svg { width: 15px; height: 15px; }
@media (max-width: 560px) { .topbar-cta { display: none; } }

.theme-toggle {
  border: 1px solid var(--border); background: var(--bg-raised); color: var(--ink-2);
  width: 34px; height: 34px; border-radius: 9px; cursor: pointer; display: flex; align-items: center; justify-content: center;
  flex-shrink: 0; transition: background 0.15s var(--ease), border-color 0.15s var(--ease);
}
.theme-toggle:hover { background: var(--bg-sunken); border-color: var(--ink-3); }
.theme-toggle svg { width: 16px; height: 16px; }
@media (max-width: 860px) { .topbar-search { margin-left: 8px; } }

/* ---------- Shell: sidebar | content | on-this-page ---------- */
.shell {
  display: grid;
  grid-template-columns: 250px minmax(0, 1fr) 210px;
  gap: 0;
  max-width: var(--shell-max);
  margin: 0 auto;
  align-items: start;
}
@media (max-width: 1300px) {
  .shell { grid-template-columns: 240px minmax(0, 1fr); }
  .on-this-page { display: none; }
}
@media (max-width: 860px) {
  .shell { grid-template-columns: 1fr; }
  .menu-toggle { display: flex; }
}

/* ---------- Sidebar (desktop: in-flow sticky · mobile: off-canvas drawer) ---------- */
.sidebar {
  position: sticky;
  top: var(--nav-h);
  height: calc(100vh - var(--nav-h));
  overflow-y: auto;
  padding: 22px 14px 40px 22px;
  scrollbar-width: thin;
  background: var(--bg);
}
.sidebar-backdrop { display: none; }
@media (max-width: 860px) {
  .sidebar {
    position: fixed; top: var(--nav-h); left: 0; bottom: 0;
    width: 300px; max-width: 84vw;
    background: var(--bg-raised);
    border-right: 1px solid var(--border-soft);
    box-shadow: var(--shadow-hi);
    z-index: 90;
    transform: translateX(-100%);
    transition: transform 0.22s ease;
    padding: 18px 16px 32px;
  }
  .sidebar.open { transform: translateX(0); }
  .sidebar-backdrop {
    display: block;
    position: fixed; top: var(--nav-h); left: 0; right: 0; bottom: 0;
    background: rgba(0,0,0,.4);
    z-index: 85;
    opacity: 0; pointer-events: none;
    transition: opacity 0.22s ease;
  }
  .sidebar-backdrop.open { opacity: 1; pointer-events: auto; }
}

.sidebar-search {
  display: flex; align-items: center; gap: 8px; width: 100%; margin-bottom: 22px;
  height: 36px; padding: 0 8px 0 11px;
  background: var(--bg-sunken); border: 1px solid var(--border-soft);
  border-radius: 9px; cursor: pointer; color: var(--ink-3);
  font-family: var(--sans); font-size: 13px;
  transition: border-color 0.15s var(--ease), background 0.15s var(--ease);
}
.sidebar-search:hover { border-color: var(--border); background: var(--bg-raised); }
.sidebar-search svg { width: 14px; height: 14px; flex-shrink: 0; }
.sidebar-search span { flex: 1; text-align: left; }
.sidebar-search kbd { display: inline-flex; align-items: center; gap: 1px; }

.nav-group { margin-bottom: 20px; }
.nav-group.is-empty { display: none; }
.nav-group-title {
  font-size: 13px; font-weight: 700; color: var(--ink);
  text-transform: none; letter-spacing: 0; padding: 0 10px; margin-bottom: 8px;
}
.nav-group a {
  display: flex; align-items: center; gap: 8px;
  padding: 6px 10px; border-radius: 8px;
  color: var(--ink-2); text-decoration: none; font-size: 14px; font-weight: 400;
  transition: background 0.12s var(--ease), color 0.12s var(--ease);
}
.nav-group a svg.icon { width: 14px; height: 14px; color: var(--ink-3); }
.nav-group a:hover { background: var(--bg-sunken); color: var(--ink); text-decoration: none; }
.nav-group a:hover svg.icon { color: var(--ink); }
.nav-group a.active { background: var(--bg-sunken); color: var(--ink); font-weight: 600; }
.nav-group a.active svg.icon { color: var(--ink); }
.nav-group a[hidden] { display: none; }
.nav-m {
  font-family: var(--mono); font-size: 8.5px; font-weight: 800; letter-spacing: 0.02em;
  padding: 2px 5px; border-radius: 4px; flex-shrink: 0;
}
.nav-m.get { background: var(--info-soft); color: var(--info); }
.nav-m.post { background: var(--ok-soft); color: var(--ok); }
.nav-m.patch { background: var(--warn-soft); color: var(--warn); }
.nav-m.delete { background: var(--danger-soft); color: var(--danger); }

/* ---------- On-this-page rail ---------- */
.on-this-page {
  position: sticky;
  top: var(--nav-h);
  height: calc(100vh - var(--nav-h));
  overflow-y: auto;
  padding: 22px 20px 40px 16px;
  border-left: 1px solid var(--border-soft);
}
.otp-title {
  font-size: 10.5px; font-weight: 700; color: var(--ink-3);
  text-transform: uppercase; letter-spacing: 0.07em; margin-bottom: 10px;
}
.otp-list { display: flex; flex-direction: column; gap: 1px; }
.otp-list a {
  display: block; padding: 4px 0 4px 12px; border-left: 2px solid var(--border);
  color: var(--ink-3); text-decoration: none; font-size: 12.5px; line-height: 1.4; font-weight: 500;
}
.otp-list a.sub { padding-left: 22px; font-size: 12px; }
.otp-list a:hover { color: var(--ink); text-decoration: none; }
.otp-list a.active { color: var(--ink); border-left-color: var(--ink); font-weight: 700; }

/* ---------- Main content ---------- */
main { padding: 40px 48px 100px; min-width: 0; max-width: 100%; }
@media (max-width: 860px) { main { padding: 26px 24px 80px; } }
@media (max-width: 480px) { main { padding: 18px 14px 60px; } }

.doc-hero { margin-bottom: 40px; }
.doc-hero h1 {
  font-family: var(--serif); font-size: 2.7rem; font-weight: 500; letter-spacing: -0.012em; margin: 0 0 12px;
  line-height: 1.1; text-wrap: balance;
}
@media (max-width: 560px) { .doc-hero h1 { font-size: 2rem; } }
.doc-sub { color: var(--ink-2); font-size: 1.05rem; max-width: 62ch; margin: 0 0 16px; line-height: 1.6; }
.status-line {
  display: flex; flex-wrap: wrap; gap: 6px 14px; align-items: center;
  font-size: 12.5px; color: var(--ink-3); font-family: var(--mono);
  margin-bottom: 28px;
}
.status-line .dot { width: 5px; height: 5px; border-radius: 50%; background: var(--ok); flex-shrink: 0; }
.status-line code.inline { word-break: break-all; }
.crumb {
  display: flex; align-items: center; gap: 6px; font-size: 12.5px; color: var(--ink-3);
  margin-bottom: 14px; flex-wrap: wrap;
}
.crumb a { color: var(--ink-3); font-weight: 600; text-decoration: none; }
.crumb a:hover { color: var(--ink); text-decoration: underline; }
.crumb svg { width: 11px; height: 11px; }

/* ---------- Resource card grid (landing) ---------- */
.resource-grid {
  display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr));
  gap: 12px;
}
.resource-card {
  display: flex; flex-direction: column; gap: 10px;
  border: 1px solid var(--border-soft); border-radius: 18px;
  padding: 18px 18px 16px; background: var(--bg-raised); text-decoration: none; color: var(--ink);
  transition: border-color 0.12s ease, transform 0.12s ease, box-shadow 0.12s ease;
}
.resource-card:hover { border-color: var(--ink-3); text-decoration: none; transform: translateY(-2px); box-shadow: var(--shadow-md); }
.resource-card .rc-icon {
  width: 36px; height: 36px; border-radius: 10px; background: var(--bg-sunken); color: var(--ink-2);
  display: flex; align-items: center; justify-content: center; flex-shrink: 0;
}
.resource-card .rc-icon svg.icon { width: 18px; height: 18px; }
.resource-card .rc-title { font-weight: 800; font-size: 0.98rem; }
.resource-card .rc-desc { font-size: 0.82rem; color: var(--ink-2); line-height: 1.5; flex: 1; }
.resource-card .rc-methods { display: flex; gap: 4px; flex-wrap: wrap; }

section.doc-section { margin-bottom: 64px; scroll-margin-top: 76px; }
section.doc-section h2 {
  display: flex; align-items: center; gap: 10px;
  font-family: var(--serif); font-size: 1.65rem; font-weight: 600; letter-spacing: -0.005em;
  padding-bottom: 12px; border-bottom: 1px solid var(--border-soft); margin: 0 0 20px;
}
section.doc-section h2 .h2-icon {
  width: 30px; height: 30px; border-radius: 9px; background: var(--bg-sunken); color: var(--ink-2);
  display: flex; align-items: center; justify-content: center; flex-shrink: 0;
}
section.doc-section h2 .h2-icon svg.icon { width: 16px; height: 16px; }
section.doc-section h3 {
  font-size: 1.02rem; font-weight: 700; margin: 30px 0 10px; scroll-margin-top: 76px;
}
section.doc-section p { max-width: 68ch; color: var(--ink); margin: 0 0 14px; }
section.doc-section p.muted { color: var(--ink-2); }

.callout {
  display: flex; gap: 12px; align-items: flex-start;
  background: var(--bg-sunken); border: 1px solid transparent; border-radius: 14px;
  padding: 14px 16px; font-size: 13.5px; color: var(--ink); max-width: 68ch;
}
.callout svg.icon { width: 17px; height: 17px; color: var(--ink-2); flex-shrink: 0; margin-top: 1px; }
.callout.pending { background: var(--pending-soft); }
.callout strong { font-weight: 800; }

/* ---------- Best practices / common mistakes ---------- */
.advice-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 14px; margin: 18px 0 30px; }
@media (max-width: 700px) { .advice-grid { grid-template-columns: 1fr; } }
.advice-col {
  border: 1px solid var(--border-soft); border-radius: 16px;
  padding: 16px 18px; background: var(--bg-raised);
}
.advice-head { display: flex; align-items: center; gap: 8px; font-weight: 800; font-size: 0.85rem; margin-bottom: 10px; }
.advice-head svg.icon { width: 16px; height: 16px; }
.advice-col.tips .advice-head { color: var(--ok); }
.advice-col.avoid .advice-head { color: var(--danger); }
.advice-col ul { margin: 0; padding-left: 1.15rem; font-size: 0.86rem; color: var(--ink-2); line-height: 1.6; }
.advice-col li { margin-bottom: 9px; }
.advice-col li:last-child { margin-bottom: 0; }
.advice-col li strong { color: var(--ink); font-weight: 700; }
.advice-col li a { font-weight: 600; }

code.inline {
  background: var(--bg-sunken); color: var(--ink); padding: 0.15em 0.45em;
  border-radius: 5px; font-size: 0.87em; border: 1px solid var(--border-soft);
  word-break: break-word;
}

pre {
  background: transparent; color: var(--code-ink);
  padding: 14px 16px; overflow-x: auto;
  font-size: 0.84rem; line-height: 1.7; margin: 0;
}
pre .k { color: var(--syn-k); }
pre .s { color: var(--syn-s); }
pre .n { color: var(--syn-n); }
pre .c { color: var(--syn-c); font-style: italic; }

/* ---------- Code box: header (never scrolls) + pre (scrolls independently) ---------- */
.code-box, .code-tabs {
  margin: 0 0 14px; border: 1px solid var(--code-border); border-radius: 14px;
  overflow: hidden; background: var(--code-bg);
}
.code-box-head, .code-tabs-nav, .resp-tabs-nav {
  display: flex; align-items: center; justify-content: space-between; gap: 8px;
  padding: 6px 6px 6px 10px; border-bottom: 1px solid var(--code-border);
}
.resp-tabs-nav { border-bottom: none; background: var(--code-bg); border-radius: 14px 14px 0 0; margin-bottom: 0; }
.resp-tabs-left { display: flex; align-items: center; gap: 10px; min-width: 0; }
.code-tabs-btns, .resp-tabs-btns { display: flex; gap: 2px; overflow-x: auto; min-width: 0; scrollbar-width: none; }
.code-tabs-btns::-webkit-scrollbar, .resp-tabs-btns::-webkit-scrollbar { display: none; }
.code-box-label {
  font-family: var(--sans); font-size: 12px; color: var(--code-ink-3); font-weight: 600;
  text-transform: none; letter-spacing: 0; flex-shrink: 0; padding-left: 4px;
}
.code-tab-btn, .resp-tab-btn {
  background: none; border: none; color: var(--code-ink-3); font-family: var(--sans);
  font-size: 13px; font-weight: 500; padding: 6px 7px; cursor: pointer;
  white-space: nowrap; flex-shrink: 0; border-bottom: 2px solid transparent;
  transition: color 0.12s var(--ease), border-color 0.12s var(--ease);
}
.code-tab-btn:hover, .resp-tab-btn:hover { color: var(--code-ink); }
.code-tab-btn.active, .resp-tab-btn.active { color: var(--code-ink); border-bottom-color: var(--code-ink); font-weight: 600; }
.code-tab-panels, .resp-panels { position: relative; }
.code-tab-panel { display: none; }
.code-tab-panel.active { display: block; }
.resp-block { border: 1px solid var(--code-border); border-radius: 14px; overflow: hidden; background: var(--code-bg); margin-top: 14px; }
.resp-panel { display: none; }
.resp-panel.active { display: block; }

/* ---------- Copy button: lives in the header row, never inside scrolling content ---------- */
.copy-btn {
  width: 26px; height: 26px; border-radius: 7px; flex-shrink: 0;
  background: transparent; border: 1px solid var(--code-border);
  color: var(--code-ink-3); cursor: pointer;
  display: flex; align-items: center; justify-content: center;
  transition: background 0.12s ease, color 0.12s ease;
}
.copy-btn:hover { background: rgba(128,128,128,.14); color: var(--code-ink); }
.copy-btn svg { width: 13px; height: 13px; }
.copy-btn.copied { color: var(--ok); }

/* ---------- Endpoint blocks: split pane, code panel sticks to its own content ---------- */
.endpoint {
  border: 1px solid var(--border-soft); border-radius: 18px;
  background: var(--bg-raised); margin-bottom: 16px; overflow: hidden;
  transition: border-color 0.12s ease;
}
.endpoint:hover { border-color: var(--border); }
.endpoint-head {
  display: flex; align-items: center; gap: 10px; padding: 14px 18px; flex-wrap: wrap;
  border-bottom: 1px solid var(--border-soft);
}
.method {
  font-family: var(--mono); font-weight: 800; font-size: 0.7rem; letter-spacing: 0.03em;
  padding: 4px 8px; border-radius: 6px; line-height: 1; flex-shrink: 0;
}
.method.get { background: var(--info-soft); color: var(--info); }
.method.post { background: var(--ok-soft); color: var(--ok); }
.method.patch { background: var(--warn-soft); color: var(--warn); }
.method.delete { background: var(--danger-soft); color: var(--danger); }

.path { font-family: var(--mono); font-size: 0.92rem; font-weight: 600; color: var(--ink); word-break: break-all; }
.endpoint-desc { color: var(--ink-3); font-size: 0.84rem; margin-left: auto; }
@media (max-width: 620px) { .endpoint-desc { margin-left: 0; width: 100%; } }

.badge {
  font-size: 0.63rem; text-transform: uppercase; letter-spacing: 0.05em;
  padding: 3px 8px; border-radius: 999px; font-weight: 800; flex-shrink: 0;
}
.badge.available { background: var(--ok-soft); color: var(--ok); }
.badge.soon { background: var(--pending-soft); color: var(--pending); }

.endpoint-grid {
  display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 440px);
  align-items: start; gap: 0;
}
@media (max-width: 980px) { .endpoint-grid { grid-template-columns: 1fr; } }
.endpoint-main { padding: 18px 20px; min-width: 0; }
.endpoint-main > p:last-child { margin-bottom: 0; }
.endpoint-code {
  padding: 16px; min-width: 0;
  border-left: 1px solid var(--border-soft);
  position: sticky; top: calc(var(--nav-h) + 16px);
}
@media (max-width: 980px) {
  .endpoint-code { border-left: none; border-top: 1px solid var(--border-soft); position: static; }
}

/* ---------- Field list (replaces cramped tables) ---------- */
.field-list {
  border: 1px solid var(--border-soft); border-radius: 16px; overflow: hidden;
  margin: 10px 0 24px; background: var(--bg-raised);
}
.field-list.compact { margin: 0 0 16px; }
.field-row { padding: 13px 16px; border-bottom: 1px solid var(--border-soft); }
.field-row:last-child { border-bottom: none; }
.field-row-head { display: flex; align-items: baseline; gap: 9px; flex-wrap: wrap; }
.field-row-head:not(:last-child) { margin-bottom: 4px; }
.field-name { font-family: var(--mono); font-weight: 700; font-size: 0.9rem; color: var(--ink); }
.field-type { font-family: var(--mono); font-size: 0.75rem; color: var(--ink-3); }
.field-req {
  font-size: 0.6rem; font-weight: 800; text-transform: uppercase; letter-spacing: 0.05em;
  padding: 2px 7px; border-radius: 999px; background: var(--danger-soft); color: var(--danger);
}
.field-desc { font-size: 0.85rem; color: var(--ink-2); line-height: 1.55; margin: 0; }
.field-sub-label { font-size: 0.68rem; font-weight: 800; text-transform: uppercase; letter-spacing: 0.06em; color: var(--ink-3); margin: 0 0 8px; }
.field-note { font-size: 0.82rem; color: var(--ink-2); line-height: 1.55; margin: 12px 0 0; }
.field-note code { font-size: 0.9em; }

table.status-codes { width: 100%; border-collapse: collapse; font-size: 0.9rem; max-width: 68ch; }
table.status-codes td { padding: 10px 12px 10px 0; border-bottom: 1px solid var(--border-soft); vertical-align: top; }
table.status-codes td:first-child { padding-right: 10px; }
table.status-codes .code-pill {
  font-family: var(--mono); font-weight: 800; font-size: 0.76rem;
  padding: 3px 8px; border-radius: 6px; display: inline-block; min-width: 2.6rem; text-align: center;
}
.code-pill.c2 { background: var(--ok-soft); color: var(--ok); }
.code-pill.c4 { background: var(--warn-soft); color: var(--warn); }
.code-pill.c4d { background: var(--danger-soft); color: var(--danger); }
.code-pill.c5 { background: var(--pending-soft); color: var(--ink-2); }
table.status-codes tr:last-child td { border-bottom: none; }

/* ---------- Changelog ---------- */
.changelog-entry { display: flex; gap: 20px; margin-bottom: 20px; flex-wrap: wrap; }
.changelog-date {
  font-family: var(--mono); font-size: 0.76rem; color: var(--ink-3);
  white-space: nowrap; padding-top: 3px; min-width: 6.5rem;
}
.changelog-body { min-width: 0; flex: 1; }
.changelog-body p { margin: 0 0 5px; font-size: 0.92rem; font-weight: 600; }
.changelog-body ul { margin: 4px 0 0; padding-left: 1.1rem; font-size: 0.86rem; color: var(--ink-2); }
.changelog-body li { margin-bottom: 3px; }

/* ---------- Steps ---------- */
.steps { margin: 22px 0 8px; }
.step { display: grid; grid-template-columns: 30px 1fr; column-gap: 16px; position: relative; padding-bottom: 26px; }
.step:last-child { padding-bottom: 0; }
.step:not(:last-child)::before {
  content: ""; position: absolute; left: 14px; top: 30px; bottom: 2px; width: 1px; background: var(--border);
}
.step-marker {
  width: 30px; height: 30px; border-radius: 50%; background: var(--ink); color: var(--bg-raised);
  font-family: var(--mono); font-weight: 800; font-size: 12.5px;
  display: flex; align-items: center; justify-content: center; flex-shrink: 0; position: relative; z-index: 1;
}
.step-body { min-width: 0; }
.step-body h4 { margin: 3px 0 8px; font-size: 0.98rem; font-weight: 700; }
.step-body p { max-width: 62ch; margin: 0 0 8px; color: var(--ink-2); }

/* ---------- Next-step card grid ---------- */
.next-grid {
  display: grid; grid-template-columns: repeat(auto-fit, minmax(210px, 1fr));
  gap: 12px; margin: 18px 0 4px;
}
.next-card {
  display: block; border: 1px solid var(--border-soft); border-radius: 18px;
  padding: 15px 16px; background: var(--bg-raised); text-decoration: none; color: var(--ink);
  transition: border-color 0.12s ease, transform 0.12s ease;
}
.next-card:hover { border-color: var(--ink-3); text-decoration: none; transform: translateY(-1px); }
.next-card .nc-label {
  font-size: 0.65rem; text-transform: uppercase; letter-spacing: 0.06em;
  color: var(--ink-3); font-weight: 800; display: block; margin-bottom: 7px;
}
.next-card .nc-title { font-weight: 700; font-size: 0.93rem; margin-bottom: 4px; }
.next-card .nc-desc { font-size: 0.81rem; color: var(--ink-2); line-height: 1.5; }

footer.doc-footer {
  max-width: 68ch; color: var(--ink-3); font-size: 0.8rem;
  padding-top: 28px; margin-top: 20px; border-top: 1px solid var(--border-soft);
}
footer.doc-footer a { color: var(--ink-3); font-weight: 600; }

/* ==================================================================
   Command palette (⌘K) · hero CTA · page-nav · site footer  (2026-08-08)
   ================================================================== */

/* ---------- Hero CTA row ---------- */
.hero-cta { display: flex; flex-wrap: wrap; gap: 10px; margin: 22px 0 4px; }
.hero-cta .btn { height: 40px; padding: 0 18px; font-size: 14px; border-radius: 10px; }

/* ---------- Command palette ---------- */
.cmdk { position: fixed; inset: 0; z-index: var(--z-modal); display: flex; align-items: flex-start; justify-content: center; }
.cmdk[hidden] { display: none; }
.cmdk-backdrop { position: absolute; inset: 0; background: rgba(15,15,15,.42); backdrop-filter: blur(2px); -webkit-backdrop-filter: blur(2px); animation: cmdk-fade 0.14s var(--ease); }
.cmdk-panel {
  position: relative; margin-top: 11vh; width: min(92vw, 620px);
  background: var(--bg-raised); border: 1px solid var(--border);
  border-radius: 16px; box-shadow: var(--shadow-hi); overflow: hidden;
  display: flex; flex-direction: column; max-height: 66vh;
  animation: cmdk-pop 0.16s var(--ease);
}
@keyframes cmdk-fade { from { opacity: 0; } to { opacity: 1; } }
@keyframes cmdk-pop { from { opacity: 0; transform: translateY(-6px) scale(0.99); } to { opacity: 1; transform: none; } }
@media (prefers-reduced-motion: reduce) {
  .cmdk-backdrop, .cmdk-panel { animation: none; }
}
.cmdk-input-row { display: flex; align-items: center; gap: 10px; padding: 14px 16px; border-bottom: 1px solid var(--border-soft); }
.cmdk-input-row > svg { width: 18px; height: 18px; color: var(--ink-3); flex-shrink: 0; }
.cmdk-input {
  flex: 1; border: none; outline: none; background: transparent;
  font-family: var(--sans); font-size: 16px; color: var(--ink); min-width: 0;
}
.cmdk-input::placeholder { color: var(--ink-3); }
.cmdk-esc { flex-shrink: 0; }
.cmdk-results { overflow-y: auto; padding: 8px; scrollbar-width: thin; }
.cmdk-group-label {
  font-size: 10.5px; font-weight: 700; text-transform: uppercase; letter-spacing: 0.07em;
  color: var(--ink-3); padding: 12px 10px 5px;
}
.cmdk-item {
  display: flex; align-items: center; gap: 11px; width: 100%;
  padding: 9px 10px; border-radius: 9px; cursor: pointer;
  text-decoration: none; color: var(--ink); border: 1px solid transparent; text-align: left;
}
.cmdk-item:hover, .cmdk-item.active { background: var(--bg-sunken); text-decoration: none; }
.cmdk-item.active { border-color: var(--border-soft); }
.cmdk-ico {
  width: 28px; height: 28px; border-radius: 8px; background: var(--bg-sunken);
  color: var(--ink-2); display: flex; align-items: center; justify-content: center; flex-shrink: 0;
}
.cmdk-item.active .cmdk-ico { background: var(--bg-raised); }
.cmdk-ico svg { width: 15px; height: 15px; }
.cmdk-ico.m { font-family: var(--mono); font-size: 8.5px; font-weight: 800; letter-spacing: 0; padding: 0 3px; }
.cmdk-ico.m.get { background: var(--info-soft); color: var(--info); }
.cmdk-ico.m.post { background: var(--ok-soft); color: var(--ok); }
.cmdk-ico.m.patch { background: var(--warn-soft); color: var(--warn); }
.cmdk-ico.m.delete { background: var(--danger-soft); color: var(--danger); }
.cmdk-body { min-width: 0; flex: 1; }
.cmdk-title { font-size: 13.5px; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.cmdk-title mark { background: transparent; color: var(--ink); font-weight: 800; text-decoration: underline; text-decoration-color: var(--border); }
.cmdk-sub { font-size: 11.5px; color: var(--ink-3); }
.cmdk-enter { width: 15px; height: 15px; flex-shrink: 0; color: var(--ink-3); opacity: 0; }
.cmdk-item.active .cmdk-enter { opacity: 1; }
.cmdk-empty { padding: 34px 16px; text-align: center; color: var(--ink-3); font-size: 13.5px; }
.cmdk-foot {
  display: flex; gap: 16px; padding: 9px 16px; border-top: 1px solid var(--border-soft);
  font-size: 11.5px; color: var(--ink-3); background: var(--bg-sunken);
}
.cmdk-foot kbd { font-size: 10px; padding: 1px 5px; }
@media (max-width: 560px) { .cmdk-foot { display: none; } .cmdk-panel { margin-top: 7vh; max-height: 76vh; } }

/* ---------- Prev / next page navigation ---------- */
.page-nav { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin: 48px 0 8px; }
@media (max-width: 520px) { .page-nav { grid-template-columns: 1fr; } }
.page-nav-card {
  display: flex; flex-direction: column; gap: 3px;
  border: 1px solid var(--border-soft); border-radius: 14px; padding: 14px 16px;
  background: var(--bg-raised); text-decoration: none; color: var(--ink);
  transition: border-color 0.14s var(--ease), transform 0.14s var(--ease), box-shadow 0.14s var(--ease);
}
.page-nav-card:hover { border-color: var(--ink-3); text-decoration: none; transform: translateY(-1px); box-shadow: var(--shadow-sm); }
.page-nav-card.next { text-align: right; }
.pn-dir { font-size: 11px; color: var(--ink-3); font-weight: 600; }
.pn-title { font-size: 15px; font-weight: 700; }

/* ---------- Site footer ---------- */
.site-footer {
  border-top: 1px solid var(--border-soft); background: var(--bg-raised);
  margin-top: 8px;
}
.sf-inner {
  max-width: var(--shell-max); margin: 0 auto; padding: 30px 48px 18px;
  display: flex; align-items: flex-start; justify-content: space-between; gap: 28px; flex-wrap: wrap;
}
.sf-brand { display: flex; align-items: center; gap: 11px; }
.sf-name { font-weight: 800; font-size: 14px; }
.sf-tag { font-size: 12.5px; color: var(--ink-3); }
.sf-links { display: flex; flex-wrap: wrap; gap: 6px 20px; }
.sf-links a { color: var(--ink-2); font-size: 13px; font-weight: 600; text-decoration: none; }
.sf-links a:hover { color: var(--ink); text-decoration: underline; }
.sf-legal {
  max-width: var(--shell-max); margin: 0 auto; padding: 0 48px 30px;
  font-size: 12px; color: var(--ink-3);
}
.sf-legal code.inline { font-size: 0.85em; }
@media (max-width: 860px) { .sf-inner, .sf-legal { padding-left: 24px; padding-right: 24px; } }