:root {
  --ink: #0a0a0a;
  --ink-soft: #404040;
  --mute: #737373;
  --border-soft: #e5e5e5;
  --surface: #ffffff;
  --surface-soft: #fafafa;
  --olive: #5b644a;
  --olive-light: #a5aa71;
  --olive-deep: #4a5239;
  --olive-ink: #2e3526;
  --sand: #f4f0ed;
  --radius: 10px;
  --sidebar-w: 268px;
  --toc-w: 220px;
  --font-sans: "Inter", system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
  --font-mono: ui-monospace, SFMono-Regular, "JetBrains Mono", Menlo, Consolas, "Liberation Mono", monospace;
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; scroll-padding-top: 88px; }

body {
  margin: 0;
  background: var(--surface);
  color: var(--ink);
  font-family: var(--font-sans);
  font-size: 15.5px;
  line-height: 1.7;
  -webkit-font-smoothing: antialiased;
  font-feature-settings: "liga", "kern", "cv11";
}

a { color: var(--olive-deep); text-underline-offset: 3px; }
a:hover { color: var(--olive-ink); }

code, pre, kbd { font-family: var(--font-mono); }

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

.topbar {
  position: sticky;
  top: 0;
  z-index: 50;
  background: var(--olive-ink);
  color: #fff;
  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
}

.topbar-inner {
  display: flex;
  align-items: center;
  gap: 20px;
  padding: 12px 24px;
}

.topbar-brand { display: flex; align-items: center; gap: 12px; text-decoration: none; }
.topbar-brand img { height: 26px; display: block; }
.topbar-brand span {
  font-size: 11px;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: rgba(255, 255, 255, 0.6);
  border-left: 1px solid rgba(255, 255, 255, 0.2);
  padding-left: 12px;
}

.topbar-links { margin-left: auto; display: flex; align-items: center; gap: 22px; }
.topbar-links a {
  color: rgba(255, 255, 255, 0.78);
  font-size: 13.5px;
  text-decoration: none;
}
.topbar-links a:hover { color: #fff; }
.topbar-links .cta {
  background: var(--olive-light);
  color: #fff;
  border-radius: 999px;
  padding: 7px 16px;
}
.topbar-links .cta:hover { background: var(--olive); color: #fff; }

.menu-toggle {
  display: none;
  background: none;
  border: 1px solid rgba(255, 255, 255, 0.25);
  color: #fff;
  border-radius: 8px;
  padding: 5px 10px;
  font-size: 13px;
  cursor: pointer;
}

/* ---------- layout ---------- */

.shell {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  gap: 0;
  max-width: 1440px;
  margin: 0 auto;
}

.sidebar {
  border-right: 1px solid var(--border-soft);
  background: var(--surface-soft);
  padding: 28px 20px 64px;
  position: sticky;
  top: 51px;
  height: calc(100vh - 51px);
  overflow-y: auto;
}

.search-wrap { position: relative; margin-bottom: 22px; }
.search-wrap input {
  width: 100%;
  border: 1px solid var(--border-soft);
  background: #fff;
  border-radius: 8px;
  padding: 8px 11px;
  font: inherit;
  font-size: 13.5px;
  color: var(--ink);
}
.search-wrap input:focus { outline: 2px solid var(--olive-light); outline-offset: -1px; }

.nav-group { margin-bottom: 22px; }
.nav-group h4 {
  margin: 0 0 8px;
  font-size: 10.5px;
  letter-spacing: 0.13em;
  text-transform: uppercase;
  color: var(--mute);
  font-weight: 600;
}
.nav-group a {
  display: block;
  padding: 5px 10px;
  margin-left: -10px;
  border-radius: 7px;
  font-size: 14px;
  color: var(--ink-soft);
  text-decoration: none;
}
.nav-group a:hover { background: var(--sand); color: var(--ink); }
.nav-group a.active {
  background: var(--olive-ink);
  color: #fff;
  font-weight: 500;
}
.nav-group a.hidden { display: none; }

main {
  padding: 44px 56px 120px;
  min-width: 0;
}

.toc {
  position: sticky;
  top: 51px;
  height: calc(100vh - 51px);
  overflow-y: auto;
  padding: 48px 24px 64px 0;
  font-size: 13px;
}
.toc h4 {
  margin: 0 0 10px;
  font-size: 10.5px;
  letter-spacing: 0.13em;
  text-transform: uppercase;
  color: var(--mute);
  font-weight: 600;
}
.toc a {
  display: block;
  padding: 3px 0 3px 12px;
  border-left: 2px solid var(--border-soft);
  color: var(--mute);
  text-decoration: none;
  line-height: 1.5;
  margin-bottom: 2px;
}
.toc a:hover { color: var(--ink); border-left-color: var(--olive-light); }
.toc a.active { color: var(--olive-deep); border-left-color: var(--olive); font-weight: 500; }
.toc a.lvl3 { padding-left: 24px; font-size: 12.5px; }

/* ---------- typography ---------- */

.eyebrow {
  font-size: 11px;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--olive);
  font-weight: 600;
  margin: 0 0 10px;
}

main h1 {
  font-size: 34px;
  line-height: 1.2;
  letter-spacing: -0.02em;
  margin: 0 0 14px;
  font-weight: 700;
}

.lede {
  font-size: 17.5px;
  line-height: 1.65;
  color: var(--ink-soft);
  margin: 0 0 36px;
  max-width: 62ch;
}

main h2 {
  font-size: 23px;
  letter-spacing: -0.01em;
  margin: 52px 0 14px;
  padding-top: 26px;
  border-top: 1px solid var(--border-soft);
  font-weight: 650;
}

main h3 { font-size: 17px; margin: 34px 0 10px; font-weight: 650; }
main h4 { font-size: 14.5px; margin: 24px 0 8px; font-weight: 650; }

main p { max-width: 74ch; }
main ul, main ol { max-width: 74ch; padding-left: 22px; }
main li { margin: 5px 0; }

main p code, main li code, main td code, main h3 code {
  background: var(--sand);
  border: 1px solid #e7e0da;
  border-radius: 5px;
  padding: 1px 5px;
  font-size: 0.87em;
  color: var(--olive-ink);
}

/* ---------- code blocks ---------- */

.code {
  position: relative;
  margin: 18px 0 24px;
  background: #16180f;
  border-radius: var(--radius);
  overflow: hidden;
}
.code-head {
  display: flex;
  align-items: center;
  gap: 10px;
  padding: 8px 14px;
  background: rgba(255, 255, 255, 0.05);
  border-bottom: 1px solid rgba(255, 255, 255, 0.07);
  font-size: 11.5px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: rgba(255, 255, 255, 0.55);
}
.code pre {
  margin: 0;
  padding: 16px 18px;
  overflow-x: auto;
  font-size: 13px;
  line-height: 1.65;
  color: #e6e6dd;
  tab-size: 2;
}
.copy-btn {
  margin-left: auto;
  background: rgba(255, 255, 255, 0.08);
  border: none;
  color: rgba(255, 255, 255, 0.72);
  border-radius: 6px;
  padding: 3px 10px;
  font: inherit;
  font-size: 11px;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  cursor: pointer;
}
.copy-btn:hover { background: rgba(255, 255, 255, 0.16); color: #fff; }

.tok-key { color: #a5aa71; }
.tok-str { color: #d7c9a7; }
.tok-num { color: #c7d1b0; }
.tok-bool { color: #8fb5a0; }
.tok-com { color: #6d7263; font-style: italic; }
.tok-cmd { color: #ffffff; }
.tok-flag { color: #a5aa71; }

/* ---------- endpoint blocks ---------- */

.endpoint {
  border: 1px solid var(--border-soft);
  border-radius: var(--radius);
  margin: 20px 0 28px;
  overflow: hidden;
}
.endpoint-head {
  display: flex;
  align-items: center;
  gap: 12px;
  flex-wrap: wrap;
  padding: 12px 16px;
  background: var(--surface-soft);
  border-bottom: 1px solid var(--border-soft);
}
.endpoint-body { padding: 4px 16px 14px; }
.endpoint-body p { margin: 10px 0; }

.method {
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.06em;
  padding: 3px 8px;
  border-radius: 5px;
  color: #fff;
  text-transform: uppercase;
}
.method.get { background: #4a5239; }
.method.post { background: #5b644a; }
.method.put { background: #7d7a4e; }
.method.delete { background: #8a4b3c; }

.path { font-family: var(--font-mono); font-size: 13.5px; color: var(--ink); }

.scope-tag {
  margin-left: auto;
  font-family: var(--font-mono);
  font-size: 11.5px;
  background: var(--sand);
  border: 1px solid #e7e0da;
  color: var(--olive-ink);
  border-radius: 999px;
  padding: 2px 10px;
  white-space: nowrap;
}

/* ---------- tables ---------- */

table {
  width: 100%;
  border-collapse: collapse;
  margin: 18px 0 26px;
  font-size: 14px;
}
th {
  text-align: left;
  font-size: 11px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--mute);
  font-weight: 600;
  padding: 0 14px 8px 0;
  border-bottom: 1px solid var(--border-soft);
}
td {
  padding: 9px 14px 9px 0;
  border-bottom: 1px solid #f0f0f0;
  vertical-align: top;
}
td:last-child, th:last-child { padding-right: 0; }
td code { white-space: nowrap; }
.req { color: #8a4b3c; font-size: 12px; }
.opt { color: var(--mute); font-size: 12px; }

/* ---------- callouts ---------- */

.note {
  border-left: 3px solid var(--olive-light);
  background: var(--sand);
  border-radius: 0 var(--radius) var(--radius) 0;
  padding: 14px 18px;
  margin: 22px 0;
  max-width: 74ch;
}
.note p { margin: 0; }
.note p + p { margin-top: 10px; }
.note strong { color: var(--olive-ink); }
.note.warn { border-left-color: #8a4b3c; background: #fbf2ef; }

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

.cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(230px, 1fr));
  gap: 14px;
  margin: 24px 0 34px;
}
.card {
  display: block;
  border: 1px solid var(--border-soft);
  border-radius: var(--radius);
  padding: 18px;
  text-decoration: none;
  color: var(--ink);
  background: #fff;
}
.card:hover { border-color: var(--olive-light); background: var(--surface-soft); color: var(--ink); }
.card strong { display: block; font-size: 15px; margin-bottom: 5px; }
.card span { font-size: 13.5px; color: var(--mute); line-height: 1.55; }

/* ---------- steps ---------- */

.steps { counter-reset: step; list-style: none; padding-left: 0; margin: 24px 0; }
.steps > li {
  counter-increment: step;
  position: relative;
  padding-left: 42px;
  margin-bottom: 26px;
}
.steps > li::before {
  content: counter(step);
  position: absolute;
  left: 0;
  top: 1px;
  width: 27px;
  height: 27px;
  border-radius: 50%;
  background: var(--olive-ink);
  color: #fff;
  font-size: 13px;
  font-weight: 600;
  display: flex;
  align-items: center;
  justify-content: center;
}
.steps > li > strong { display: block; margin-bottom: 4px; }

/* ---------- hero ---------- */

.hero {
  background: linear-gradient(135deg, var(--olive-ink) 0%, var(--olive-deep) 55%, var(--olive) 100%);
  color: #fff;
  border-radius: 14px;
  padding: 44px 44px 40px;
  margin: 0 0 40px;
}
.hero .eyebrow { color: rgba(255, 255, 255, 0.65); }
.hero h1 { color: #fff; margin-bottom: 16px; }
.hero p { color: rgba(255, 255, 255, 0.82); font-size: 17px; max-width: 60ch; margin: 0 0 24px; }
.hero .btn-row { display: flex; flex-wrap: wrap; gap: 12px; }
.hero a.btn {
  display: inline-block;
  border-radius: 999px;
  padding: 9px 20px;
  font-size: 14px;
  text-decoration: none;
  background: var(--olive-light);
  color: #fff;
}
.hero a.btn:hover { background: #fff; color: var(--olive-ink); }
.hero a.btn.ghost { background: transparent; border: 1px solid rgba(255, 255, 255, 0.35); }
.hero a.btn.ghost:hover { background: rgba(255, 255, 255, 0.1); color: #fff; }

/* ---------- page footer nav ---------- */

.page-nav {
  display: flex;
  gap: 14px;
  margin-top: 64px;
  padding-top: 26px;
  border-top: 1px solid var(--border-soft);
}
.page-nav a {
  flex: 1;
  border: 1px solid var(--border-soft);
  border-radius: var(--radius);
  padding: 14px 18px;
  text-decoration: none;
  color: var(--ink);
}
.page-nav a:hover { border-color: var(--olive-light); background: var(--surface-soft); }
.page-nav span { display: block; font-size: 11px; letter-spacing: 0.1em; text-transform: uppercase; color: var(--mute); margin-bottom: 3px; }
.page-nav .next { text-align: right; }

.footer {
  border-top: 1px solid var(--border-soft);
  padding: 26px 56px 40px;
  font-size: 13px;
  color: var(--mute);
  max-width: 1440px;
  margin: 0 auto;
}
.footer a { color: var(--ink-soft); }

/* ---------- pill row ---------- */

.pills { display: flex; flex-wrap: wrap; gap: 7px; margin: 14px 0 22px; }
.pills code {
  background: var(--sand);
  border: 1px solid #e7e0da;
  border-radius: 6px;
  padding: 3px 9px;
  font-size: 12.5px;
  color: var(--olive-ink);
}

/* ---------- responsive ---------- */

@media (max-width: 1180px) {
  .shell { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); }
  .toc { display: none; }
  main { padding: 40px 40px 100px; }
}

@media (max-width: 860px) {
  .shell { grid-template-columns: minmax(0, 1fr); }
  .menu-toggle { display: block; }
  .topbar-links a:not(.cta) { display: none; }
  .sidebar {
    display: none;
    position: static;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--border-soft);
  }
  .sidebar.open { display: block; }
  main { padding: 30px 20px 80px; }
  .hero { padding: 32px 24px; }
  main h1 { font-size: 27px; }
  .footer { padding: 24px 20px 36px; }
  .endpoint-head { gap: 8px; }
  .scope-tag { margin-left: 0; }
}