/* ===========================================================================
   Migasender API reference
   ---------------------------------------------------------------------------
   Written for this page, not inherited from the user manual. The manual is a
   long read: one column, generous measure, chapter cards. A reference is a
   lookup surface — you arrive knowing the endpoint you want, and you want its
   parameters and a runnable example without scrolling. So: every endpoint
   listed in the sidebar, and prose beside code rather than under it.

   Colour tokens are shared with the manual so the two still look like one
   product.
   ========================================================================= */

:root {
  --brand:        #16a34a;
  --brand-soft:   #dcfce7;
  --brand-ink:    #14532d;

  --bg:           #ffffff;
  --surface:      #f8fafc;
  --surface-2:    #f1f5f9;
  --border:       #e2e8f0;
  --border-soft:  #eef2f7;
  --text:         #0f172a;
  --muted:        #64748b;

  --note:         #2563eb;  --note-bg:   #eff6ff;
  --tip:          #16a34a;  --tip-bg:    #f0fdf4;
  --warn:         #d97706;  --warn-bg:   #fffbeb;
  --danger:       #dc2626;  --danger-bg: #fef2f2;

  /* code panel keeps one dark palette in both themes: a snippet you are about
     to paste into a terminal should look the same whichever theme you read in */
  --code-bg:      #0f172a;
  --code-bg-2:    #1e293b;
  --code-fg:      #e2e8f0;
  --code-muted:   #94a3b8;
  --t-str:        #86efac;
  --t-num:        #fca5a5;
  --t-key:        #93c5fd;
  --t-lit:        #f0abfc;
  --t-com:        #64748b;
  --t-var:        #fcd34d;

  --radius:   10px;
  --side-w:   300px;
  --head-h:   56px;
  --pane-w:   470px;

  --mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;

  color-scheme: light;
}

:root[data-theme="dark"] {
  --brand:        #22c55e;
  --brand-soft:   #052e16;
  --brand-ink:    #bbf7d0;

  --bg:           #0b1220;
  --surface:      #111a2b;
  --surface-2:    #16213a;
  --border:       #1e293b;
  --border-soft:  #172033;
  --text:         #e2e8f0;
  --muted:        #94a3b8;

  --note-bg:      #0e1c33;
  --tip-bg:       #06210f;
  --warn-bg:      #241a05;
  --danger-bg:    #2a0f0f;

  --code-bg:      #060b16;
  --code-bg-2:    #111a2b;

  color-scheme: dark;
}

*, *::before, *::after { box-sizing: border-box; }

html { scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }

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

a { color: var(--brand); text-decoration: none; }
a:hover { text-decoration: underline; }

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

/* inline code inside prose */
p code, li code, td code, .prm__desc code, .sub__note code, .pane__note code, .err__why code {
  font-size: .875em;
  background: var(--surface-2);
  border: 1px solid var(--border-soft);
  border-radius: 5px;
  padding: .08em .38em;
  word-break: break-word;
}

/* ── header ──────────────────────────────────────────────────────────────── */

.top {
  position: sticky; top: 0; z-index: 60;
  height: var(--head-h);
  display: flex; align-items: center; gap: 12px;
  padding: 0 16px;
  background: color-mix(in srgb, var(--bg) 88%, transparent);
  backdrop-filter: saturate(180%) blur(12px);
  border-bottom: 1px solid var(--border);
}

.brand { display: flex; align-items: center; gap: 9px; flex: none; }
.brand:hover { text-decoration: none; }
.brand__logo { height: 22px; width: auto; display: block; }
.brand__tag {
  font-size: 11px; font-weight: 700; letter-spacing: .1em;
  color: var(--muted); padding-left: 9px; border-left: 1px solid var(--border);
}

.logo--dark { display: none; }
:root[data-theme="dark"] .logo--light { display: none; }
:root[data-theme="dark"] .logo--dark  { display: block; }

.search {
  flex: 1 1 auto; max-width: 520px; margin: 0 auto;
  position: relative; display: flex; align-items: center;
}
.search svg {
  position: absolute; left: 11px; width: 15px; height: 15px;
  color: var(--muted); pointer-events: none;
}
.search input {
  width: 100%; height: 34px;
  padding: 0 62px 0 33px;
  font: inherit; font-size: 13.5px; color: var(--text);
  background: var(--surface-2);
  border: 1px solid var(--border);
  border-radius: 8px;
}
.search input:focus { outline: none; border-color: var(--brand); background: var(--bg); }
.search input::placeholder { color: var(--muted); }
.search kbd {
  position: absolute; right: 8px;
  font-size: 10px; color: var(--muted);
  background: var(--bg); border: 1px solid var(--border);
  border-radius: 5px; padding: 2px 6px;
}

.iconbtn {
  flex: none; width: 34px; height: 34px;
  display: inline-flex; align-items: center; justify-content: center;
  background: none; border: 1px solid var(--border); border-radius: 8px;
  color: var(--muted); cursor: pointer;
}
.iconbtn:hover { color: var(--text); background: var(--surface-2); }
.iconbtn svg { width: 16px; height: 16px; }
.menubtn { display: none; }

/* ── layout ──────────────────────────────────────────────────────────────── */

.layout { display: flex; align-items: flex-start; }

.toc {
  position: sticky; top: var(--head-h);
  flex: none; width: var(--side-w);
  height: calc(100vh - var(--head-h));
  overflow-y: auto; overscroll-behavior: contain;
  padding: 20px 12px 60px;
  border-right: 1px solid var(--border);
}
.toc__h {
  margin: 0 0 10px 10px;
  font-size: 11px; font-weight: 700; letter-spacing: .1em;
  text-transform: uppercase; color: var(--muted);
}
.toc__list, .fam__eps { list-style: none; margin: 0; padding: 0; }

.fam { margin-bottom: 14px; }
.fam__link {
  display: flex; align-items: center; gap: 8px;
  padding: 6px 10px; border-radius: 7px;
  color: var(--text); font-size: 13.5px; font-weight: 650;
}
.fam__link:hover { background: var(--surface-2); text-decoration: none; }
.fam__link > span:first-child { flex: 1 1 auto; min-width: 0; }
.fam__n {
  flex: none; font-size: 11px; color: var(--muted);
  font-variant-numeric: tabular-nums;
}

.fam__eps { margin: 2px 0 0; border-left: 1px solid var(--border); margin-left: 14px; }
.fam__eps a {
  display: flex; align-items: center; gap: 8px;
  padding: 5px 10px 5px 12px; margin-left: -1px;
  border-left: 2px solid transparent;
  color: var(--muted); font-size: 13px; line-height: 1.35;
}
.fam__eps a:hover { color: var(--text); text-decoration: none; }
.fam__eps a.is-active {
  color: var(--text); font-weight: 600;
  border-left-color: var(--brand);
  background: linear-gradient(90deg, var(--brand-soft), transparent 70%);
}

/* method chip in the sidebar */
.m {
  flex: none; width: 40px; text-align: right;
  font-family: var(--mono); font-size: 9.5px; font-weight: 700;
  letter-spacing: .04em;
}
.m--get { color: #2563eb; }
.m--post { color: var(--brand); }
.m--put { color: #d97706; }
.m--patch { color: #7c3aed; }
.m--delete { color: #dc2626; }

.toc__empty {
  display: none; margin: 16px 10px; font-size: 13px; color: var(--muted);
}
.toc__empty.is-shown { display: block; }
.fam.is-hidden, .fam__eps li.is-hidden { display: none; }

.content {
  flex: 1 1 auto; min-width: 0;
  padding: 34px 34px 120px;
  max-width: 1320px;
}

/* ── hero ────────────────────────────────────────────────────────────────── */

.hero { padding-bottom: 26px; border-bottom: 1px solid var(--border); margin-bottom: 8px; }
.hero h1 { margin: 0 0 6px; font-size: 30px; line-height: 1.2; letter-spacing: -.02em; }
.hero__lede { margin: 0 0 14px; font-size: 14px; color: var(--brand); font-weight: 650; }
.hero__base {
  display: inline-flex; align-items: center; gap: 10px; flex-wrap: wrap;
  padding: 9px 14px; border: 1px solid var(--border); border-radius: 9px;
  background: var(--surface-2); font-size: 13px;
}
.hero__base > span { color: var(--muted); font-size: 11px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; }
.hero__base code { font-size: 13px; background: none; border: 0; padding: 0; word-break: break-all; }
.hero__base b { color: var(--brand); font-weight: 600; }
.hero__base a { font-size: 12px; font-weight: 600; }

/* ── family section ──────────────────────────────────────────────────────── */

.fam-sec { scroll-margin-top: calc(var(--head-h) + 16px); padding-top: 40px; }
.fam-hd { margin-bottom: 20px; }
.fam-hd__kicker {
  margin: 0 0 6px; font-size: 11px; font-weight: 700; letter-spacing: .09em;
  text-transform: uppercase; color: var(--brand);
}
.fam-hd h2 { margin: 0 0 6px; font-size: 24px; letter-spacing: -.015em; }
.fam-hd__sub { margin: 0; color: var(--muted); max-width: 74ch; }

/* the prose blocks that sit above a family's endpoints */
.brief {
  border: 1px solid var(--border); border-radius: var(--radius);
  padding: 18px 22px; margin: 16px 0; background: var(--surface);
}
.brief { scroll-margin-top: calc(var(--head-h) + 16px); }
.brief > h3 { margin: 0 0 10px; font-size: 15px; }
.brief > :last-child { margin-bottom: 0; }
.brief ul { margin: 8px 0; padding-left: 20px; }
.brief li { margin: 5px 0; }
.brief p { margin: 8px 0; }

/* ── endpoint ────────────────────────────────────────────────────────────── */

.ep {
  scroll-margin-top: calc(var(--head-h) + 16px);
  padding: 26px 0 30px;
  border-top: 1px solid var(--border);
}
.ep__bar {
  display: flex; align-items: center; gap: 10px; flex-wrap: wrap;
  margin-bottom: 14px;
}
.verb {
  flex: none;
  font-family: var(--mono); font-size: 11px; font-weight: 700; letter-spacing: .05em;
  padding: 3px 9px; border-radius: 6px; color: #fff;
}
.verb--get { background: #2563eb; }
.verb--post { background: var(--brand); }
.verb--put { background: #d97706; }
.verb--patch { background: #7c3aed; }
.verb--delete { background: #dc2626; }
.ep__path { font-size: 13.5px; font-weight: 600; word-break: break-all; }

.ep__grid { display: grid; grid-template-columns: minmax(0, 1fr) var(--pane-w); gap: 34px; align-items: start; }
.ep__doc { min-width: 0; }
.ep__name { margin: 0 0 6px; font-size: 18px; letter-spacing: -.01em; }
.ep__doc > p { margin: 0 0 14px; color: var(--muted); }
.ep__doc > p:first-of-type { color: var(--text); }

.ep__aside { min-width: 0; }
.panel { position: sticky; top: calc(var(--head-h) + 18px); }
.panel__sec + .panel__sec { margin-top: 16px; }
.panel__h {
  margin: 0 0 8px;
  font-size: 11px; font-weight: 700; letter-spacing: .09em;
  text-transform: uppercase; color: var(--muted);
}

/* sub-headings inside the doc column */
.sub {
  margin: 22px 0 8px;
  font-size: 11px; font-weight: 700; letter-spacing: .09em;
  text-transform: uppercase; color: var(--muted);
}
.sub__note { margin: 0 0 10px; font-size: 13.5px; color: var(--muted); }

/* ── parameters ──────────────────────────────────────────────────────────── */

.prms { border-top: 1px solid var(--border); }
.prm { padding: 12px 0; border-bottom: 1px solid var(--border); }
.prm__sig { display: flex; align-items: baseline; gap: 9px; flex-wrap: wrap; }
.prm__name {
  font-size: 13.5px; font-weight: 650; color: var(--text);
  background: none; border: 0; padding: 0;
}
.prm__type { font-family: var(--mono); font-size: 12px; color: var(--muted); }
.prm__desc { margin-top: 4px; font-size: 14px; color: var(--muted); }
.prm__desc strong { color: var(--text); }

.req {
  font-size: 10px; font-weight: 700; letter-spacing: .05em; text-transform: uppercase;
  padding: 1px 6px; border-radius: 4px; border: 1px solid transparent; white-space: nowrap;
}
.req--required    { color: #b91c1c; background: var(--danger-bg); border-color: #fecaca; }
.req--conditional { color: #b45309; background: var(--warn-bg);   border-color: #fde68a; }
.req--optional    { color: var(--muted); background: var(--surface-2); border-color: var(--border); }
:root[data-theme="dark"] .req--required    { color: #fca5a5; border-color: #4c1d1d; }
:root[data-theme="dark"] .req--conditional { color: #fcd34d; border-color: #4d3d16; }

/* ── errors ──────────────────────────────────────────────────────────────── */

.errs {
  margin: 22px 0 0;
  border: 1px solid var(--border); border-radius: var(--radius);
  background: var(--surface);
}
.errs > summary {
  display: flex; align-items: center; gap: 8px;
  padding: 11px 15px; cursor: pointer; list-style: none;
  font-size: 12px; font-weight: 700; letter-spacing: .07em;
  text-transform: uppercase; color: var(--muted);
}
.errs > summary::-webkit-details-marker { display: none; }
.errs > summary::before {
  content: '▸'; font-size: 10px; transition: transform .15s;
}
.errs[open] > summary::before { transform: rotate(90deg); }
.errs > summary:hover { color: var(--text); }
.errs__n {
  margin-left: auto; font-size: 11px; font-weight: 600;
  color: var(--muted); background: var(--surface-2);
  border: 1px solid var(--border); border-radius: 999px; padding: 0 7px;
}
.errs__body { padding: 0 15px 6px; }
.err { padding: 10px 0; border-top: 1px solid var(--border); }
.err__msg {
  display: inline-block; font-size: 12.5px; line-height: 1.5;
  color: #b91c1c; background: var(--danger-bg);
  border: 1px solid #fecaca; border-radius: 5px; padding: 2px 7px;
}
:root[data-theme="dark"] .err__msg { color: #fca5a5; border-color: #4c1d1d; }
.err__why { margin-top: 5px; font-size: 13.5px; color: var(--muted); }

/* ── callouts ────────────────────────────────────────────────────────────── */

.box {
  margin: 16px 0; padding: 12px 16px;
  border-left: 3px solid var(--note);
  border-radius: 0 8px 8px 0;
  background: var(--note-bg);
  font-size: 14px;
}
.box p { margin: 4px 0; }
.box > :last-child { margin-bottom: 0; }
.box__label {
  display: block; margin-bottom: 3px;
  font-size: 11px; font-weight: 700; letter-spacing: .07em;
  text-transform: uppercase; color: var(--note);
}
.box--tip    { border-left-color: var(--tip);    background: var(--tip-bg); }
.box--tip .box__label { color: var(--tip); }
.box--warn   { border-left-color: var(--warn);   background: var(--warn-bg); }
.box--warn .box__label { color: var(--warn); }
.box--danger { border-left-color: var(--danger); background: var(--danger-bg); }
.box--danger .box__label { color: var(--danger); }

/* ── tables that survive inside brief blocks ─────────────────────────────── */

.tablewrap { overflow-x: auto; margin: 12px 0; }
table { width: 100%; border-collapse: collapse; font-size: 13.5px; }
th, td { text-align: left; padding: 9px 12px; border-bottom: 1px solid var(--border); vertical-align: top; }
th {
  font-size: 10.5px; font-weight: 700; letter-spacing: .07em; text-transform: uppercase;
  color: var(--muted); border-bottom: 1px solid var(--border);
}
tbody tr:last-child td { border-bottom: 0; }

/* ── code ────────────────────────────────────────────────────────────────── */

.tabs { display: flex; gap: 4px; flex-wrap: wrap; margin-bottom: 8px; }
.tab {
  font: inherit; font-size: 12px; font-weight: 600;
  padding: 4px 10px; border-radius: 6px; cursor: pointer;
  color: var(--muted); background: none; border: 1px solid transparent;
}
.tab:hover { color: var(--text); background: var(--surface-2); }
.tab.is-on { color: var(--text); background: var(--surface-2); border-color: var(--border); }
.pane { display: none; }
.pane.is-on { display: block; }
.pane__title { margin: 0 0 6px; font-size: 12.5px; font-weight: 650; }
.pane__note { margin: 0 0 8px; font-size: 13px; color: var(--muted); }

.resp + .resp { margin-top: 12px; }

.code { border-radius: 9px; overflow: hidden; border: 1px solid var(--code-bg-2); }
.code + .code { margin-top: 10px; }

/* header strip: the language label and Copy used to sit on top of the first
   line of code, where a long curl URL ran straight underneath them */
.code__bar {
  display: flex; align-items: center; justify-content: space-between;
  padding: 5px 8px 5px 12px;
  background: var(--code-bg-2);
}
.code__lang {
  font-family: var(--mono); font-size: 9.5px; font-weight: 700;
  letter-spacing: .11em; text-transform: uppercase; color: var(--code-muted);
}
.code__copy {
  font: inherit; font-size: 11px; font-weight: 600;
  padding: 2px 9px; border-radius: 5px; cursor: pointer;
  color: var(--code-muted); background: transparent;
  border: 1px solid transparent;
}
.code__copy:hover { color: #fff; border-color: rgba(255,255,255,.16); }
.code__copy.is-done { color: var(--brand); }

.code pre {
  margin: 0; padding: 12px 14px;
  background: var(--code-bg);
  font-size: 12.5px; line-height: 1.65;
  color: var(--code-fg);
}
/* Wrap rather than scroll. A curl line with a full URL is wider than any
   sensible pane, and a horizontal scrollbar per snippet is worse to use
   than a wrapped line. */
.code pre code {
  background: none; border: 0; padding: 0; font-size: inherit;
  white-space: pre-wrap; overflow-wrap: anywhere;
}
/* syntax colours, applied by api.js */
.t-str { color: var(--t-str); }
.t-num { color: var(--t-num); }
.t-key { color: var(--t-key); }
.t-lit { color: var(--t-lit); }
.t-com { color: var(--t-com); font-style: italic; }
.t-var { color: var(--t-var); }
.t-fn  { color: var(--t-key); }

/* ── search state ────────────────────────────────────────────────────────── */

.ep.is-filtered, .fam-sec.is-filtered, .brief.is-filtered { display: none; }
.noresults { display: none; margin: 40px 0; color: var(--muted); }
.noresults.is-shown { display: block; }
mark { background: #fde68a; color: #78350f; border-radius: 3px; padding: 0 2px; }
:root[data-theme="dark"] mark { background: #78350f; color: #fde68a; }

/* ── back to top ─────────────────────────────────────────────────────────── */

.totop {
  position: fixed; right: 20px; bottom: 20px; z-index: 40;
  width: 38px; height: 38px; border-radius: 50%;
  display: none; align-items: center; justify-content: center;
  background: var(--bg); color: var(--muted);
  border: 1px solid var(--border); cursor: pointer;
  box-shadow: 0 3px 14px rgba(2, 6, 23, .12);
}
.totop.is-shown { display: flex; }
.totop:hover { color: var(--text); }

.scrim { display: none; }

/* ── narrow ──────────────────────────────────────────────────────────────── */

@media (max-width: 1180px) {
  .ep__grid { grid-template-columns: minmax(0, 1fr); gap: 20px; }
  .panel { position: static; }
  :root { --pane-w: auto; }
}

@media (max-width: 900px) {
  .menubtn { display: inline-flex; }
  .brand__tag { display: none; }
  .search kbd { display: none; }
  .content { padding: 24px 18px 100px; }

  .toc {
    position: fixed; top: var(--head-h); left: 0; z-index: 55;
    width: min(320px, 86vw); height: calc(100vh - var(--head-h));
    background: var(--bg);
    transform: translateX(-100%); transition: transform .22s ease;
  }
  .toc.is-open { transform: none; box-shadow: 0 0 40px rgba(2, 6, 23, .2); }
  .scrim {
    display: block; position: fixed; inset: var(--head-h) 0 0; z-index: 50;
    background: rgba(2, 6, 23, .45);
    opacity: 0; pointer-events: none; transition: opacity .22s;
  }
  .scrim.is-open { opacity: 1; pointer-events: auto; }
  .hero h1 { font-size: 24px; }
}

/* ── print ───────────────────────────────────────────────────────────────── */

@media print {
  .top, .toc, .totop, .scrim, .code__copy, .tabs { display: none !important; }
  .content { padding: 0; max-width: none; }
  .pane { display: block !important; }
  .pane + .pane { margin-top: 10px; }
  .ep__grid { grid-template-columns: 1fr; }
  .errs[open] > summary::before, .errs > summary::before { content: ''; }
  .errs { break-inside: avoid; }
  .errs__body { display: block !important; }
  .ep { break-inside: avoid-page; }
  .code pre { background: #f8fafc; color: #0f172a; border: 1px solid #e2e8f0; }
  .t-str, .t-num, .t-key, .t-lit, .t-var, .t-com { color: #0f172a; }
  a { color: inherit; text-decoration: none; }
}

/* ── language switcher ────────────────────────────────────────────────────── */

.lang { position: relative; flex: none; }
.lang__btn {
  display: inline-flex; align-items: center; gap: 6px;
  height: 34px; padding: 0 10px;
  font: inherit; font-size: 13px; color: var(--muted);
  background: none; border: 1px solid var(--border); border-radius: 8px;
  cursor: pointer; white-space: nowrap;
}
.lang__btn:hover { color: var(--text); background: var(--surface-2); }
.lang__btn svg { width: 15px; height: 15px; flex: none; }

.lang__menu {
  position: absolute; top: calc(100% + 6px); right: 0; z-index: 70;
  min-width: 150px; padding: 5px;
  background: var(--bg); border: 1px solid var(--border);
  border-radius: 9px; box-shadow: 0 8px 26px rgba(2, 6, 23, .16);
  display: none;
}
.lang.is-open .lang__menu { display: block; }
.lang__menu a, .lang__on {
  display: block; padding: 6px 10px; border-radius: 6px;
  font-size: 13.5px; color: var(--text);
}
.lang__menu a:hover { background: var(--surface-2); text-decoration: none; }
.lang__on { color: var(--brand); font-weight: 650; cursor: default; }

@media (max-width: 900px) {
  /* the button keeps its globe, the language name would crowd the bar */
  .lang__btn span { display: none; }
  .lang__btn { padding: 0 9px; }
}

@media print { .lang { display: none !important; } }