/* Shared stylesheet for the developer guides served at /api/guides/*. */

:root {
  --bg: #f6f8fb;
  --surface: #ffffff;
  --surface-2: #eef2f7;
  --text: #0f1b2d;
  --text-muted: #51617a;
  --text-faint: #8392a8;
  --border: #d8e0eb;
  --border-soft: #e7ecf3;
  --accent: #1f5fd6;
  --accent-soft: #e8f0fe;
  --get: #0b7a46;
  --get-soft: #e5f5ec;
  --post: #1f5fd6;
  --post-soft: #e8f0fe;
  --patch: #a35a08;
  --patch-soft: #fdf1e2;
  --delete: #b42323;
  --delete-soft: #fdecec;
  --socket: #7a3fc4;
  --socket-soft: #f2eafd;
  --ok: #0b7a46;
  --warn: #a35a08;
  --warn-soft: #fdf4e7;
  --err: #b42323;
  --code-bg: #0f1b2d;
  --code-text: #d7e3f4;
  --shadow: 0 1px 2px rgba(15, 27, 45, 0.05), 0 6px 18px -10px rgba(15, 27, 45, 0.18);
  --radius: 10px;
  --font-sans: 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-mono: 'JetBrains Mono', ui-monospace, 'SFMono-Regular', Consolas, monospace;
  color-scheme: light;
}

@media (prefers-color-scheme: dark) {
  :root:not([data-theme='light']) {
    --bg: #0b1220;
    --surface: #111a2b;
    --surface-2: #17223a;
    --text: #e3eaf5;
    --text-muted: #9fb0c8;
    --text-faint: #6c7d96;
    --border: #23314c;
    --border-soft: #1b2740;
    --accent: #6ea2ff;
    --accent-soft: #15264a;
    --get: #45c98a;
    --get-soft: #0f2a1d;
    --post: #6ea2ff;
    --post-soft: #15264a;
    --patch: #f0a95a;
    --patch-soft: #2e200f;
    --delete: #f08080;
    --delete-soft: #301414;
    --socket: #b98cf5;
    --socket-soft: #241638;
    --ok: #45c98a;
    --warn: #f0a95a;
    --warn-soft: #2a1d0d;
    --err: #f08080;
    --code-bg: #070d18;
    --shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 8px 24px -12px rgba(0, 0, 0, 0.6);
    color-scheme: dark;
  }
}

* { box-sizing: border-box; }

html { scroll-padding-top: 76px; }
@media (max-width: 900px) { html { scroll-padding-top: 12px; } }

body {
  margin: 0;
  background: var(--bg);
  color: var(--text);
  font-family: var(--font-sans);
  font-size: 15px;
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
}

a { color: var(--accent); text-underline-offset: 2px; }
:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 3px; }

code, pre, .mono {
  font-family: var(--font-mono);
  font-variant-ligatures: none;
  font-feature-settings: 'calt' 0, 'liga' 0;
}

:not(pre) > code {
  font-size: 0.86em;
  background: var(--surface-2);
  border: 1px solid var(--border-soft);
  padding: 1px 6px;
  border-radius: 5px;
  overflow-wrap: anywhere;
}

/* ---------- top bar ---------- */
.topbar {
  position: sticky;
  top: 0;
  z-index: 10;
  background: color-mix(in srgb, var(--surface) 88%, transparent);
  backdrop-filter: saturate(160%) blur(10px);
  border-bottom: 1px solid var(--border);
}
.topbar-inner {
  max-width: 1200px;
  margin: 0 auto;
  padding: 12px 24px;
  display: flex;
  align-items: center;
  gap: 18px;
  flex-wrap: wrap;
}
.brand {
  font-weight: 700;
  letter-spacing: -0.01em;
  color: var(--text);
  text-decoration: none;
  display: flex;
  align-items: center;
  gap: 10px;
}
.brand-mark {
  width: 28px;
  height: 28px;
  border-radius: 50%;
  display: block;
  box-shadow: 0 0 0 1px var(--border);
}
.brand small { font-weight: 500; color: var(--text-faint); }
.topnav { display: flex; gap: 4px; flex-wrap: wrap; margin-left: auto; }
.topnav a {
  font-size: 13.5px;
  font-weight: 500;
  color: var(--text-muted);
  text-decoration: none;
  padding: 6px 10px;
  border-radius: 7px;
}
.topnav a:hover { background: var(--surface-2); color: var(--text); }
.topnav a[aria-current='page'] { background: var(--accent-soft); color: var(--accent); }

/* ---------- layout ---------- */
.layout {
  max-width: 1200px;
  margin: 0 auto;
  padding: 0 24px;
  display: grid;
  grid-template-columns: 230px minmax(0, 1fr);
  gap: 48px;
}
.sidebar {
  position: sticky;
  top: 76px;
  align-self: start;
  max-height: calc(100vh - 92px);
  overflow-y: auto;
  padding: 32px 0 24px;
}
.sidebar .label {
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin-bottom: 10px;
}
.sidebar ol { list-style: none; margin: 0; padding: 0; display: grid; gap: 2px; }
.sidebar a {
  display: block;
  font-size: 13.5px;
  color: var(--text-muted);
  text-decoration: none;
  padding: 5px 10px;
  border-left: 2px solid var(--border-soft);
}
.sidebar a:hover { color: var(--text); border-left-color: var(--accent); }
.sidebar a.sub { padding-left: 22px; font-size: 13px; }

main { padding: 40px 0 96px; min-width: 0; }

@media (max-width: 900px) {
  .layout { grid-template-columns: minmax(0, 1fr); gap: 0; padding: 0 16px; }
  .sidebar { display: none; }
  .topbar { position: static; }
  .topbar-inner { padding: 10px 16px; }
  .topnav { margin-left: 0; }
}

/* ---------- headings & text ---------- */
.hero { padding-bottom: 28px; margin-bottom: 36px; border-bottom: 1px solid var(--border); }
.eyebrow {
  font-size: 12px;
  font-weight: 600;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--accent);
}
h1 {
  font-size: clamp(28px, 4vw, 38px);
  line-height: 1.15;
  letter-spacing: -0.02em;
  margin: 10px 0 12px;
  text-wrap: balance;
}
.lede { font-size: 16.5px; color: var(--text-muted); max-width: 70ch; margin: 0; }
.meta { display: flex; flex-wrap: wrap; gap: 10px 28px; margin-top: 20px; }
.meta div { display: grid; gap: 2px; }
.meta .k { font-size: 11px; font-weight: 600; letter-spacing: 0.06em; text-transform: uppercase; color: var(--text-faint); }
.meta .v { font-family: var(--font-mono); font-size: 13px; color: var(--text-muted); }

section { margin-bottom: 56px; }
h2 {
  font-size: 23px;
  letter-spacing: -0.015em;
  margin: 0 0 6px;
  padding-top: 8px;
  text-wrap: balance;
}
h2 .num {
  font-family: var(--font-mono);
  font-size: 14px;
  color: var(--accent);
  margin-right: 10px;
  vertical-align: 2px;
}
h3 { font-size: 17px; margin: 30px 0 8px; letter-spacing: -0.005em; }
h4 { font-size: 14.5px; margin: 18px 0 6px; }
p { margin: 0 0 14px; max-width: 72ch; }
.section-intro { color: var(--text-muted); margin-bottom: 20px; }
ul, ol { padding-left: 22px; margin: 0 0 14px; }
li { margin-bottom: 6px; max-width: 70ch; }

/* ---------- callouts ---------- */
.callout {
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent);
  background: var(--accent-soft);
  border-radius: 0 8px 8px 0;
  padding: 12px 16px;
  margin: 0 0 18px;
  font-size: 14px;
}
.callout p:last-child { margin-bottom: 0; }
.callout .title {
  display: block;
  font-size: 11.5px;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--accent);
  margin-bottom: 4px;
}
.callout.warn { border-left-color: var(--warn); background: var(--warn-soft); }
.callout.warn .title { color: var(--warn); }
.callout.danger { border-left-color: var(--err); background: var(--delete-soft); }
.callout.danger .title { color: var(--err); }

/* ---------- cards & grids ---------- */
.grid-2 { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 16px; margin-bottom: 18px; }
.grid-3 { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 14px; margin-bottom: 18px; }
@media (max-width: 760px) { .grid-2, .grid-3 { grid-template-columns: minmax(0, 1fr); } }

.card {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 18px 20px;
  box-shadow: var(--shadow);
}
.card h3, .card h4 { margin-top: 0; }
.card p { font-size: 14px; color: var(--text-muted); }
.card p:last-child { margin-bottom: 0; }
a.card { text-decoration: none; color: inherit; display: block; transition: border-color 0.15s, transform 0.15s; }
a.card:hover { border-color: var(--accent); transform: translateY(-1px); }

/* ---------- flow strip ---------- */
.flow {
  display: flex;
  align-items: stretch;
  gap: 0;
  overflow-x: auto;
  margin: 0 0 22px;
  padding-bottom: 4px;
}
.flow .step {
  flex: 1 0 140px;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 10px 12px;
  display: grid;
  gap: 2px;
}
.flow .step .n { font-size: 10.5px; font-weight: 700; letter-spacing: 0.08em; text-transform: uppercase; color: var(--accent); }
.flow .step .t { font-size: 13.5px; font-weight: 600; }
.flow .step .p { font-family: var(--font-mono); font-size: 11px; color: var(--text-muted); overflow-wrap: anywhere; }
.flow .arrow {
  flex: 0 0 22px;
  align-self: center;
  height: 2px;
  background: var(--border);
  position: relative;
}
.flow .arrow::after {
  content: '';
  position: absolute;
  right: -1px;
  top: -4px;
  border: 5px solid transparent;
  border-left: 6px solid var(--border);
  border-right: none;
}

/* ---------- endpoint cards ---------- */
.endpoint {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  margin: 0 0 20px;
  box-shadow: var(--shadow);
  overflow: hidden;
}
.endpoint-head {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 8px 12px;
  padding: 12px 16px;
  border-bottom: 1px solid var(--border-soft);
  background: var(--surface-2);
}
.endpoint-head .path { font-family: var(--font-mono); font-size: 13.5px; font-weight: 600; overflow-wrap: anywhere; }
.endpoint-head .right { margin-left: auto; display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
.endpoint-head .what { font-size: 12.5px; color: var(--text-muted); }
.endpoint-body { padding: 16px; display: grid; gap: 14px; min-width: 0; }
.endpoint-body > p { margin: 0; font-size: 14px; color: var(--text-muted); }

.verb {
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.04em;
  padding: 3px 8px;
  border-radius: 5px;
}
.verb.get { color: var(--get); background: var(--get-soft); }
.verb.post { color: var(--post); background: var(--post-soft); }
.verb.patch { color: var(--patch); background: var(--patch-soft); }
.verb.delete { color: var(--delete); background: var(--delete-soft); }
.verb.socket { color: var(--socket); background: var(--socket-soft); }

.chip {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: 11.5px;
  font-weight: 600;
  padding: 2px 9px;
  border-radius: 999px;
  white-space: nowrap;
  background: var(--surface);
  border: 1px solid var(--border);
  color: var(--text-muted);
}
.chip::before { content: ''; width: 6px; height: 6px; border-radius: 50%; background: currentColor; }
.chip.key { color: var(--patch); border-color: color-mix(in srgb, var(--patch) 35%, transparent); }
.chip.jwt { color: var(--accent); border-color: color-mix(in srgb, var(--accent) 35%, transparent); }
.chip.lic { color: var(--socket); border-color: color-mix(in srgb, var(--socket) 35%, transparent); }
.chip.none { color: var(--text-faint); }

.label {
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin-bottom: 6px;
}

/* ---------- field tables ---------- */
.table-wrap { overflow-x: auto; border: 1px solid var(--border); border-radius: 8px; background: var(--surface); margin: 0 0 16px; }
.endpoint .table-wrap { margin: 0; }
table { width: 100%; border-collapse: collapse; font-size: 13.5px; }
th {
  text-align: left;
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--text-faint);
  background: var(--surface-2);
  padding: 9px 12px;
  border-bottom: 1px solid var(--border);
  white-space: nowrap;
}
td { padding: 9px 12px; border-bottom: 1px solid var(--border-soft); vertical-align: top; }
tr:last-child td { border-bottom: none; }
td.f { font-family: var(--font-mono); font-size: 12.5px; color: var(--accent); white-space: nowrap; }
td.t { font-family: var(--font-mono); font-size: 12px; color: var(--text-muted); white-space: nowrap; }
td.s { font-family: var(--font-mono); font-size: 12px; font-weight: 700; white-space: nowrap; }
td.s.ok { color: var(--ok); }
td.s.bad { color: var(--err); }
.req { font-size: 10.5px; font-weight: 700; color: var(--err); margin-left: 6px; text-transform: uppercase; letter-spacing: 0.04em; }
.opt { font-size: 10.5px; font-weight: 600; color: var(--text-faint); margin-left: 6px; text-transform: uppercase; letter-spacing: 0.04em; }

/* ---------- code ---------- */
.code { position: relative; min-width: 0; }
.code .lang {
  position: absolute;
  top: 8px;
  left: 14px;
  font-size: 10.5px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: #7f93b0;
}
.code button.copy {
  position: absolute;
  top: 6px;
  right: 8px;
  font: 600 11px var(--font-sans);
  color: #c4d2e6;
  background: rgba(255, 255, 255, 0.08);
  border: 1px solid rgba(255, 255, 255, 0.14);
  border-radius: 6px;
  padding: 3px 9px;
  cursor: pointer;
}
.code button.copy:hover { background: rgba(255, 255, 255, 0.16); }
pre {
  margin: 0;
  background: var(--code-bg);
  color: var(--code-text);
  border-radius: 8px;
  padding: 32px 16px 14px;
  overflow-x: auto;
  font-size: 12.5px;
  line-height: 1.65;
  tab-size: 2;
}
pre code.hljs { background: transparent; padding: 0; }

/* ---------- tabs (per-language samples) ---------- */
.tabs { min-width: 0; }
.tabs .tab-bar { display: flex; gap: 4px; margin-bottom: 8px; flex-wrap: wrap; }
.tabs .tab-bar button {
  font: 600 12.5px var(--font-sans);
  color: var(--text-muted);
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 7px;
  padding: 4px 11px;
  cursor: pointer;
}
.tabs .tab-bar button[aria-selected='true'] { color: var(--accent); border-color: var(--accent); background: var(--accent-soft); }
.tabs .tab-panel[hidden] { display: none; }

/* ---------- diagrams ---------- */
figure.diagram {
  margin: 0 0 22px;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 18px;
  overflow-x: auto;
}
figure.diagram svg { display: block; width: 100%; min-width: 640px; height: auto; color: var(--text); }
figure.diagram .accent { color: var(--accent); }
figure.diagram .alt { color: var(--socket); }
figure.diagram .muted { color: var(--text-faint); }
figcaption { font-size: 13px; color: var(--text-muted); margin-top: 10px; }

/* ---------- checklist ---------- */
ol.checklist { counter-reset: step; list-style: none; padding: 0; display: grid; gap: 10px; }
ol.checklist > li {
  counter-increment: step;
  position: relative;
  padding: 12px 16px 12px 52px;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 8px;
  max-width: none;
  margin: 0;
}
ol.checklist > li::before {
  content: counter(step);
  position: absolute;
  left: 14px;
  top: 12px;
  width: 26px;
  height: 26px;
  border-radius: 50%;
  background: var(--accent-soft);
  color: var(--accent);
  font: 700 12.5px var(--font-mono);
  display: flex;
  align-items: center;
  justify-content: center;
}

footer.page-footer {
  margin-top: 64px;
  padding-top: 18px;
  border-top: 1px solid var(--border);
  font-size: 13px;
  color: var(--text-faint);
}