/* AlkiraiLink Docs — one stylesheet for every page.
   Harbour & Signal: the design system the website and the dashboard use too.
   Token names and values match the design strategy's system.css; only the
   tokens the docs use are here. A navy band frames warm paper, the reading
   ground, and both follow the reader's light or dark setting.
   The docs run no script, and the CSP allows no inline style: every rule is
   in this file. */

:root {
  --navy-950: #071327;
  --navy-900: #0b1d3a;
  --navy-800: #12284d;
  --lime: #d5f365;
  --lime-hi: #e4f99a;

  --paper: #f7f6f1;
  --surface: #ffffff;
  --surface-2: #f8f9fb;
  --sunken: #eceff4;
  --ink: #0d1424;
  --ink-2: #4a5568;
  --ink-3: #5f6a7d;              /* 5.2:1 on paper */
  --line: rgba(11, 29, 58, .10);
  --line-2: rgba(11, 29, 58, .18);
  --focus: #1f5fbf;
  --link: #1f5fbf;
  --brand-ink: #0b1d3a;

  --ok: #1d6b43;   --ok-bg: #e4f3ea;
  --warn: #8a4b00; --warn-bg: #fdf0d8;
  --risk: #b42323; --risk-bg: #fbe8e8;
  --info: #1f5fbf; --info-bg: #e7effc;
  --idle: #556072; --idle-bg: #eef0f4;

  --code-bg: #071327;
  --code-ink: #dbe4f3;
  --code-line: rgba(255, 255, 255, .08);

  --font-display: 'Instrument Sans', 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-body: 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  --font-wordmark: 'Yeseva One', Georgia, 'Times New Roman', serif;

  --r-xs: 6px; --r-sm: 10px; --r-md: 14px;
  --ease: cubic-bezier(.2, .7, .2, 1);
  --t-fast: 120ms;
  --max: 1200px;
  --band: 60px;
  color-scheme: light;
}

@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --paper: #081530; --surface: #0c1c36; --surface-2: #10223f; --sunken: #13284a;
    --ink: #edf1f8; --ink-2: #b3bdcd; --ink-3: #8b97ab;
    --line: rgba(255, 255, 255, .09); --line-2: rgba(255, 255, 255, .17);
    --focus: #d5f365; --link: #9cc3ff; --brand-ink: #e4f99a;
    --ok: #7ad69c;   --ok-bg: rgba(12, 163, 12, .16);
    --warn: #f5c35a; --warn-bg: rgba(250, 178, 25, .14);
    --risk: #ff9b9b; --risk-bg: rgba(208, 59, 59, .18);
    --info: #9cc3ff; --info-bg: rgba(57, 135, 229, .18);
    --idle: #a7b1c2; --idle-bg: rgba(255, 255, 255, .07);
    --code-bg: #050d1d; --code-line: rgba(255, 255, 255, .10);
    color-scheme: dark;
  }
}
:root[data-theme="dark"] {
  --paper: #081530; --surface: #0c1c36; --surface-2: #10223f; --sunken: #13284a;
  --ink: #edf1f8; --ink-2: #b3bdcd; --ink-3: #8b97ab;
  --line: rgba(255, 255, 255, .09); --line-2: rgba(255, 255, 255, .17);
  --focus: #d5f365; --link: #9cc3ff; --brand-ink: #e4f99a;
  --ok: #7ad69c;   --ok-bg: rgba(12, 163, 12, .16);
  --warn: #f5c35a; --warn-bg: rgba(250, 178, 25, .14);
  --risk: #ff9b9b; --risk-bg: rgba(208, 59, 59, .18);
  --info: #9cc3ff; --info-bg: rgba(57, 135, 229, .18);
  --idle: #a7b1c2; --idle-bg: rgba(255, 255, 255, .07);
  --code-bg: #050d1d; --code-line: rgba(255, 255, 255, .10);
  color-scheme: dark;
}

/* ── Base ─────────────────────────────────────────────────────── */
*, *::before, *::after { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; scroll-padding-top: calc(var(--band) + 20px); }
body {
  margin: 0; background: var(--paper); color: var(--ink);
  font: 400 16px/1.65 var(--font-body); -webkit-font-smoothing: antialiased;
}
:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; border-radius: 4px; }
a { color: var(--link); text-underline-offset: 2px; text-decoration-thickness: 1px; }
a:hover { text-decoration-thickness: 2px; }
h1, h2, h3, h4 { font-family: var(--font-display); font-weight: 650; letter-spacing: -.02em; text-wrap: balance; color: var(--ink); }
h1 { font-size: clamp(32px, 4.2vw, 42px); line-height: 1.1; margin: 0 0 12px; font-stretch: 92%; }
h2 { font-size: 25px; line-height: 1.2; margin: 48px 0 12px; padding-top: 28px; border-top: 1px solid var(--line); }
h3 { font-size: 19px; line-height: 1.3; margin: 32px 0 8px; }
h4 { font-size: 15px; line-height: 1.35; margin: 24px 0 6px; }
p, ul, ol, dl, table, pre { margin: 0 0 16px; }
ul, ol { padding-left: 22px; }
li + li { margin-top: 6px; }
strong { font-weight: 600; }
code, pre, kbd { font-family: var(--font-mono); }
:not(pre) > code {
  font-size: .86em; padding: 1px 5px; border-radius: 5px;
  background: var(--sunken); color: var(--ink); overflow-wrap: anywhere;
}
.lede { font-size: 18.5px; line-height: 1.55; color: var(--ink-2); max-width: 64ch; margin-bottom: 28px; }
.eyebrow { font: 600 12px/1.2 var(--font-body); letter-spacing: .09em; text-transform: uppercase; color: var(--ink-3); margin: 0 0 10px; }
.muted { color: var(--ink-3); }
.skip-link {
  position: absolute; top: -100px; left: 16px; z-index: 50; padding: 10px 16px; border-radius: var(--r-xs);
  background: var(--lime); color: var(--navy-900); font-weight: 600; text-decoration: none;
}
.skip-link:focus { top: 8px; }

/* ── The navy band ────────────────────────────────────────────── */
body::before {
  content: ""; position: fixed; inset: 0 0 auto; height: env(safe-area-inset-top, 0px);
  z-index: 30; background: var(--navy-900);
}
.band {
  position: sticky; top: env(safe-area-inset-top, 0px); z-index: 30;
  background: var(--navy-900); color: #fff; border-bottom: 1px solid rgba(255, 255, 255, .08);
}
.band-inner {
  display: flex; align-items: center; gap: 16px; min-height: var(--band);
  max-width: var(--max); margin: 0 auto;
  padding-left: max(16px, env(safe-area-inset-left, 0px));
  padding-right: max(16px, env(safe-area-inset-right, 0px));
}
.brand { display: inline-flex; align-items: baseline; gap: 10px; text-decoration: none; color: #fff; min-width: 0; }
.wordmark {
  font-family: var(--font-wordmark); font-size: 23px; line-height: 1; letter-spacing: -.01em;
  background: linear-gradient(135deg, #c9a227, #d5f365); -webkit-background-clip: text; background-clip: text; color: transparent;
}
.brand-sub { font: 600 13px/1 var(--font-body); letter-spacing: .04em; color: rgba(255, 255, 255, .72); }
.band nav { margin-left: auto; display: flex; gap: 4px; }
.band nav a {
  color: rgba(255, 255, 255, .78); text-decoration: none; font: 500 14px/1 var(--font-body);
  padding: 9px 10px; border-radius: 8px; white-space: nowrap;
}
.band nav a:hover, .band nav a[aria-current="page"] { color: #fff; background: rgba(255, 255, 255, .08); }
.band :focus-visible { outline-color: var(--lime); }

/* ── Layout ───────────────────────────────────────────────────── */
.layout {
  display: grid; grid-template-columns: 236px minmax(0, 1fr); gap: 56px;
  max-width: var(--max); margin: 0 auto;
  padding-left: max(16px, env(safe-area-inset-left, 0px));
  padding-right: max(16px, env(safe-area-inset-right, 0px));
}
.side {
  position: sticky; top: calc(env(safe-area-inset-top, 0px) + var(--band));
  align-self: start; max-height: calc(100vh - var(--band)); overflow-y: auto;
  padding-block: 32px 48px; font-size: 14.5px;
}
.side p { font: 600 11.5px/1.2 var(--font-body); letter-spacing: .08em; text-transform: uppercase; color: var(--ink-3); margin: 22px 0 6px; }
.side p:first-child { margin-top: 0; }
.side ul { list-style: none; padding: 0; margin: 0; }
.side li + li { margin-top: 0; }
.side a {
  display: block; padding: 5px 10px; margin-left: -10px; border-radius: 7px;
  color: var(--ink-2); text-decoration: none; line-height: 1.35;
}
.side a:hover { color: var(--ink); background: var(--sunken); }
.side a[aria-current="page"] { color: var(--brand-ink); background: var(--sunken); font-weight: 600; }
.side ul ul { margin: 2px 0 6px 2px; border-left: 1px solid var(--line); padding-left: 10px; }
.side ul ul a { display: grid; grid-template-columns: 46px minmax(0, 1fr); align-items: baseline; font-size: 13.5px; padding-block: 4px; }
.side .verb { font: 600 10.5px/1 var(--font-mono); color: var(--ink-3); }

.menu { display: none; }
.doc { min-width: 0; max-width: 760px; padding-block: 40px 80px; }
.doc.wide { max-width: 880px; }
.doc > p, .doc > ul, .doc > ol, .doc li { max-width: 68ch; }
.doc > p.code-label, ol.steps p.code-label { max-width: none; }

.foot { border-top: 1px solid var(--line); }
.foot-inner {
  max-width: var(--max); margin: 0 auto; padding-block: 28px 40px;
  padding-left: max(16px, env(safe-area-inset-left, 0px));
  padding-right: max(16px, env(safe-area-inset-right, 0px));
  display: flex; flex-wrap: wrap; gap: 8px 24px; font-size: 13.5px; color: var(--ink-3);
}

@media (max-width: 900px) {
  .layout { grid-template-columns: minmax(0, 1fr); gap: 0; }
  .side { display: none; }
  .menu {
    display: block; margin: 16px 0 24px; border: 1px solid var(--line-2); border-radius: var(--r-sm);
    background: var(--surface);
  }
  .menu summary {
    cursor: pointer; list-style: none; padding: 11px 14px;
    font: 600 14px/1.2 var(--font-body); color: var(--ink);
  }
  .menu summary::-webkit-details-marker { display: none; }
  .menu summary::after { content: "Menu"; float: right; font-weight: 500; color: var(--ink-3); }
  .menu[open] summary::after { content: "Close"; }
  .menu .side { display: block; position: static; max-height: none; padding: 4px 14px 16px; }
  .doc { padding-top: 24px; }
  .band nav a.wide-only { display: none; }
}

/* ── Code ─────────────────────────────────────────────────────── */
pre {
  padding: 16px 18px; border-radius: var(--r-md); overflow-x: auto;
  font: 400 13px/1.65 var(--font-mono); color: var(--code-ink);
  background: var(--code-bg); border: 1px solid var(--code-line);
}
pre .c { color: #8a99b3; }
pre .k { color: #d5f365; }
pre .s { color: #f2c879; }
.code-label {
  display: flex; justify-content: space-between; gap: 12px; margin: 0 0 -1px;
  padding: 8px 18px; border-radius: var(--r-md) var(--r-md) 0 0;
  font: 600 12px/1.2 var(--font-body); letter-spacing: .03em; color: rgba(255, 255, 255, .72);
  background: var(--navy-800); border: 1px solid var(--code-line); border-bottom: 0;
}
.code-label + pre { border-top-left-radius: 0; border-top-right-radius: 0; }

/* ── Callouts and steps ───────────────────────────────────────── */
.callout {
  padding: 14px 16px; border-radius: var(--r-sm); background: var(--info-bg);
  border-left: 3px solid var(--info); margin: 0 0 20px; max-width: 68ch;
}
.callout > :last-child { margin-bottom: 0; }
.callout.warn { background: var(--warn-bg); border-left-color: var(--warn); }
.callout strong:first-child { color: var(--ink); }

ol.steps { list-style: none; padding: 0; counter-reset: step; }
ol.steps > li { counter-increment: step; position: relative; padding-left: 44px; margin: 0 0 28px; max-width: none; }
ol.steps > li::before {
  content: counter(step); position: absolute; left: 0; top: 0;
  width: 28px; height: 28px; border-radius: 50%; display: grid; place-items: center;
  font: 600 13px/1 var(--font-body); color: var(--navy-900); background: var(--lime);
}
ol.steps > li > h3 { margin-top: 2px; }

.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(210px, 1fr)); gap: 14px; margin: 8px 0 24px; }
.card {
  display: block; padding: 18px; border-radius: var(--r-md); text-decoration: none;
  background: var(--surface); border: 1px solid var(--line); color: var(--ink);
  transition: border-color var(--t-fast) var(--ease), transform var(--t-fast) var(--ease);
}
.card:hover { border-color: var(--line-2); transform: translateY(-1px); }
.card strong { display: block; font-family: var(--font-display); font-size: 17px; margin-bottom: 4px; }
.card span { font-size: 14px; color: var(--ink-2); line-height: 1.5; }

/* ── Tables ───────────────────────────────────────────────────── */
.table-wrap { overflow-x: auto; margin: 0 0 20px; border: 1px solid var(--line); border-radius: var(--r-sm); background: var(--surface); }
table { width: 100%; border-collapse: collapse; font-size: 14px; line-height: 1.5; margin: 0; }
th {
  text-align: left; font: 600 11.5px/1.2 var(--font-body); letter-spacing: .05em; text-transform: uppercase;
  color: var(--ink-3); padding: 10px 14px; border-bottom: 1px solid var(--line); background: var(--surface-2);
}
td { padding: 10px 14px; border-bottom: 1px solid var(--line); vertical-align: top; }
tbody tr:last-child td { border-bottom: 0; }
td:first-child { white-space: nowrap; }
td.wrap { white-space: normal; }
td code { white-space: nowrap; overflow-wrap: normal; }
.req { font: 600 11px/1 var(--font-body); color: var(--warn); margin-left: 6px; letter-spacing: .02em; }
.type { font: 500 12.5px/1.4 var(--font-mono); color: var(--ink-3); }
.type a { color: var(--link); }

.pill {
  display: inline-flex; align-items: center; height: 21px; padding: 0 8px; border-radius: 999px;
  font: 600 11.5px/1 var(--font-body); white-space: nowrap; background: var(--idle-bg); color: var(--idle);
}
.pill.yes { background: var(--ok-bg); color: var(--ok); }
.pill.no { background: var(--idle-bg); color: var(--idle); }

/* ── Reference ────────────────────────────────────────────────── */
.verb-badge {
  display: inline-flex; align-items: center; height: 22px; padding: 0 7px; border-radius: 6px;
  font: 600 11.5px/1 var(--font-mono); letter-spacing: .02em;
}
.verb-get { color: var(--info); background: var(--info-bg); }
.verb-post { color: var(--ok); background: var(--ok-bg); }
.verb-delete { color: var(--risk); background: var(--risk-bg); }
.endpoint {
  display: flex; flex-wrap: wrap; align-items: center; gap: 10px; margin: 0 0 14px;
  padding: 10px 12px; border-radius: var(--r-sm); background: var(--surface); border: 1px solid var(--line);
}
.endpoint code { background: none; padding: 0; font-size: 14px; overflow-wrap: anywhere; }
.op { margin-top: 44px; padding-top: 28px; border-top: 1px solid var(--line); }
.op h3 { margin-top: 0; font-size: 22px; }
.op h4 { font-family: var(--font-body); font-size: 12px; font-weight: 600; letter-spacing: .08em; text-transform: uppercase; color: var(--ink-3); margin: 22px 0 8px; }
.tag-head { margin-top: 64px; }
.schema { margin-top: 36px; }
.schema h3 { font-family: var(--font-mono); font-size: 17px; letter-spacing: 0; }
.values { display: flex; flex-wrap: wrap; gap: 6px; list-style: none; padding: 0; }
.values li { margin: 0; }
dl.limits { display: grid; grid-template-columns: max-content minmax(0, 1fr); gap: 6px 16px; font-size: 14.5px; }
dl.limits dt { font-weight: 600; }
dl.limits dd { margin: 0; color: var(--ink-2); }
.anchor { color: inherit; text-decoration: none; }
.anchor:hover { text-decoration: underline; text-decoration-color: var(--line-2); }

@media (max-width: 560px) {
  /* A table becomes a list of rows, each cell headed by its column. */
  .table-wrap table, .table-wrap tbody, .table-wrap tr, .table-wrap td { display: block; }
  .table-wrap thead { display: none; }
  .table-wrap tr { padding: 12px 14px; border-bottom: 1px solid var(--line); }
  .table-wrap tbody tr:last-child { border-bottom: 0; }
  .table-wrap td { padding: 0; border: 0; white-space: normal; }
  .table-wrap td + td { margin-top: 8px; }
  .table-wrap td + td::before {
    content: attr(data-label); display: block; margin-bottom: 2px;
    font: 600 11px/1.4 var(--font-body); letter-spacing: .05em; text-transform: uppercase; color: var(--ink-3);
  }
  h2 { font-size: 22px; }
  .lede { font-size: 17px; }
  ol.steps > li { padding-left: 38px; }
  dl.limits { grid-template-columns: minmax(0, 1fr); }
  dl.limits dd { margin-bottom: 8px; }
}

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after { transition-duration: 0ms !important; }
}