/* =====================================================================
   Hudhud Iraq (هدهد العراق) — public API documentation
   Self-contained: none of the console's app CSS, so this page stays fast
   and cacheable on its own. Brand colours and the 'Hudhud' typeface come
   from fonts/fonts.css (loaded first); this file maps them to the UI.
   Light = warm paper with navy ink. Dark = the brand's navy world.
   Crest red is used for one thing only: the active sidebar marker
   (and, in the navy world, as the interactive accent per the brand kit).
   ===================================================================== */
:root{
  /* interactive accent (links, selected, focus) — Navy 2 on paper */
  --blue:var(--hh-navy-2); --blue-dark:var(--hh-navy);
  --blue-soft:#E8ECF5; --blue-border:#B9C3DB;
  --link:var(--hh-navy-3); --link-line:#B9C3DB;
  --get:var(--hh-navy-2); --get-soft:#E8ECF5; --get-border:#B9C3DB;
  --marker:var(--hh-crest);
  --kicker:var(--hh-sand-ink);
  /* paper canvas, navy ink */
  --ink:#141B2D; --ink2:#2C3446; --ink3:#475069; --muted:#636B80;
  --line:#E8E1D3; --line2:#D8CEBB; --panel:#F4EFE4; --bg:#FAF7F0; --surface:#FFFFFF;
  /* semantic colours keep their own hues (danger is crimson, never crest) */
  --green:#067A4B; --green-soft:#EAF6EF; --green-border:#A9DCC0;
  --amber:#A34A06; --amber-soft:#FDF4E3; --amber-border:#F0D29A;
  --red:#BE1E3C; --red-soft:#FBEBEE; --red-border:#F0BCC6;
  --shadow:0 1px 2px rgba(13,27,62,.06),0 1px 1px rgba(13,27,62,.04);
  --shadow-lg:0 18px 40px rgba(13,27,62,.14);
  --seg-on:var(--hh-navy-2); --seg-on-ink:var(--hh-cream);
  --focus:var(--hh-navy-2);
  --select:rgba(27,45,92,.14);
  /* code: white sheet on paper; hues harmonised with the palette */
  --code-bg:#FFFFFF; --code-line:#E8E1D3; --gut:#B3A992;
  --c-com:#7A7363; --c-str:#2B7A4B; --c-kw:#7A3E9D; --c-num:#A9550A;
  --c-fn:#2F4FA0; --c-cst:var(--hh-sand-ink); --c-typ:#2E6A8E; --c-var:#B0306A; --c-op:#8C8676;
  /* the top bar is Hudhud Navy in both themes */
  --bar:var(--hh-navy); --bar-ink:var(--hh-cream); --bar-ink2:var(--hh-sand);
  --bar-raise:var(--hh-navy-2); --bar-line:rgba(255,241,215,.16); --bar-edge:var(--hh-navy);
  --foot:var(--hh-deep);
  --sidebar:264px; --head:64px;
  color-scheme:light;
}
:root[data-theme="dark"]{
  /* on navy the accent is sand, as in the console; the crest stays the one red */
  --blue:var(--hh-sand); --blue-dark:#EBDCC2;
  --blue-soft:rgba(216,193,159,.13); --blue-border:rgba(216,193,159,.38);
  --link:var(--hh-sand); --link-line:rgba(216,193,159,.45);
  --get:#AFC2F2; --get-soft:rgba(143,170,240,.12); --get-border:rgba(143,170,240,.32);
  --kicker:var(--hh-sand);
  --ink:#FBF3E4; --ink2:#E6DAC3; --ink3:#C9BBA0; --muted:#9AA6C4;
  --line:#1B2D5C; --line2:#26396B; --panel:#13244B; --bg:#08122A; --surface:#0D1B3E;
  --green:#4FD08E; --green-soft:rgba(79,208,142,.12); --green-border:rgba(79,208,142,.32);
  --amber:#F6B544; --amber-soft:rgba(246,181,68,.12); --amber-border:rgba(246,181,68,.32);
  --red:#FF7D92; --red-soft:rgba(255,125,146,.12); --red-border:rgba(255,125,146,.32);
  --shadow:0 1px 2px rgba(0,0,0,.35);
  --shadow-lg:0 18px 40px rgba(0,0,0,.45);
  --seg-on:#26396B; --seg-on-ink:#FBF3E4;
  --focus:var(--hh-sand);
  --select:rgba(253,78,25,.3);
  --code-bg:#0A1633; --code-line:#1B2D5C; --gut:#4A5B88;
  --c-com:#8390B2; --c-str:#8FD9A8; --c-kw:#C9A8FF; --c-num:#FFB877;
  --c-fn:#93B6FF; --c-cst:var(--hh-sand); --c-typ:#86C9E8; --c-var:#FF9CC7; --c-op:#7C88A8;
  --bar-line:#26396B; --bar-edge:#1B2D5C;
  --foot:var(--hh-navy);
  color-scheme:dark;
}
*{box-sizing:border-box;margin:0;padding:0}
html{scroll-behavior:smooth;scroll-padding-top:calc(var(--head) + 18px)}
body{font-family:var(--font);
  background:var(--bg);color:var(--ink);-webkit-font-smoothing:antialiased;line-height:1.8}
::selection{background:var(--select)}
:focus-visible{outline:2px solid var(--focus);outline-offset:2px}
a{color:var(--link);text-decoration:underline;text-decoration-color:var(--link-line);
  text-decoration-thickness:1px;text-underline-offset:4px;transition:text-decoration-color .13s}
a:hover{text-decoration-color:currentColor}
button{font-family:inherit;cursor:pointer}
code,pre{font-family:ui-monospace,SFMono-Regular,"SF Mono","JetBrains Mono",Menlo,Consolas,monospace}
/* RTL page: code always reads left-to-right. Inline code is isolated so its
   punctuation never reorders the Arabic sentence around it. */
code{direction:ltr;unicode-bidi:isolate}
pre{direction:ltr;unicode-bidi:isolate}
/* plain-language sample blocks (checklists, example wording) are Arabic */
pre[dir="rtl"]{direction:rtl;line-height:1.9}
pre[dir="rtl"],pre[dir="rtl"] code{font-family:var(--font)}
pre[dir="rtl"] code{direction:rtl;unicode-bidi:normal}

/* ---- top bar: Hudhud Navy, cream lettering ------------------------- */
.top{position:sticky;top:0;z-index:40;height:var(--head);display:flex;align-items:center;
  gap:14px;padding:0 22px;background:var(--bar);color:var(--bar-ink);
  border-bottom:1px solid var(--bar-edge);box-shadow:0 2px 10px rgba(13,27,62,.1)}
.top :focus-visible{outline-color:var(--bar-ink)}
.brand{display:flex;align-items:center;gap:16px;color:var(--bar-ink);text-decoration:none;flex:none}
.brand picture{display:block;line-height:0}
.brand img{display:block;height:30px;width:auto}
.brand-tag{display:inline-flex;align-items:center;height:24px;padding:0 11px;border-radius:999px;
  font-size:12px;font-weight:600;line-height:1;color:var(--bar-ink2);
  background:rgba(216,193,159,.1);border:1px solid rgba(216,193,159,.3);white-space:nowrap}
.top-sp{flex:1}
.top-a{font-size:13.5px;font-weight:500;color:var(--bar-ink);padding:7px 13px;border-radius:10px;
  white-space:nowrap;text-decoration:none;border:1px solid var(--bar-line);transition:.14s}
.top-a:hover{background:var(--bar-raise);border-color:transparent}
.icon-btn{display:grid;place-items:center;width:36px;height:36px;border:1px solid var(--bar-line);
  border-radius:10px;background:transparent;color:var(--bar-ink2);transition:.14s;flex:none}
.icon-btn:hover{background:var(--bar-raise);border-color:transparent;color:var(--bar-ink)}
.burger{display:none}

/* ---- search (sits on the navy bar) --------------------------------- */
.search{position:relative;width:min(340px,36vw)}
.search input{width:100%;height:38px;padding:0 36px;border:1px solid var(--bar-line);border-radius:10px;
  background:rgba(255,241,215,.07);color:var(--bar-ink);font-size:13.5px;font-family:inherit;outline:none;
  transition:border-color .14s,background .14s,box-shadow .14s}
.search input::placeholder{color:var(--bar-ink2);opacity:.85}
.search input:hover{background:rgba(255,241,215,.1)}
.search input:focus{border-color:rgba(255,241,215,.5);background:var(--bar-raise);
  box-shadow:0 0 0 3px rgba(255,241,215,.12)}
.search svg{position:absolute;inset-inline-start:12px;top:50%;transform:translateY(-50%);color:var(--bar-ink2)}
.search kbd{position:absolute;inset-inline-end:9px;top:50%;transform:translateY(-50%);font-size:10.5px;
  padding:2px 6px;border:1px solid var(--bar-line);border-radius:5px;color:var(--bar-ink2);
  background:rgba(255,241,215,.06);font-family:inherit;line-height:1.4}
.sresults{position:absolute;top:calc(100% + 8px);inset-inline-start:0;inset-inline-end:0;background:var(--surface);
  border:1px solid var(--line);border-radius:14px;box-shadow:var(--shadow-lg);color:var(--ink);
  padding:6px;max-height:60vh;overflow:auto;display:none;z-index:60;line-height:1.6}
.sresults.on{display:block}
.sres{display:block;width:100%;text-align:start;border:none;background:none;padding:8px 11px;
  border-radius:9px;color:var(--ink);font-size:13.5px}
.sres:hover,.sres.cur{background:var(--blue-soft)}
.sres small{display:block;color:var(--muted);font-size:11.5px}

/* ---- shell --------------------------------------------------------- */
.shell{display:grid;grid-template-columns:var(--sidebar) minmax(0,1fr);max-width:1500px;margin:0 auto}
.side{position:sticky;top:var(--head);align-self:start;height:calc(100vh - var(--head));
  overflow:auto;padding:24px 14px 40px;border-inline-end:1px solid var(--line)}
.side h4{font-size:12px;font-weight:700;line-height:1.6;
  color:var(--kicker);margin:20px 0 6px;padding-inline-start:13px}
.side h4:first-child{margin-top:0}
.side a{position:relative;display:block;padding:6px 13px;border-radius:9px;font-size:13.5px;line-height:1.75;
  color:var(--ink3);text-decoration:none;transition:background .13s,color .13s}
.side a:hover{background:var(--panel);color:var(--ink)}
/* active item: navy-2 tint, and the page's one crest-red mark */
.side a.on{background:var(--blue-soft);color:var(--hh-navy-2);font-weight:600}
.side a.on::before{content:"";position:absolute;inset-inline-start:4px;top:50%;width:3px;height:16px;
  margin-top:-8px;border-radius:3px;background:var(--marker)}
:root[data-theme="dark"] .side a.on{background:var(--hh-navy-2);color:var(--ink)}

/* ---- content ------------------------------------------------------- */
main{padding:40px 44px 100px;min-width:0}
.sec{scroll-margin-top:calc(var(--head) + 20px);padding-bottom:38px;margin-bottom:38px;
  border-bottom:1px solid var(--line)}
.sec:last-of-type{border-bottom:none}
.split{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:28px;align-items:start}
h1,h2,h3{color:var(--ink);line-height:1.45}
h1{font-size:34px;font-weight:700;line-height:1.35}
h2{font-size:23px;font-weight:650;margin-bottom:10px}
h3{font-size:15.5px;font-weight:650;margin:22px 0 8px}
.lede{font-size:16px;color:var(--ink3);margin-top:12px;max-width:62ch;line-height:1.85}
p{margin:10px 0;color:var(--ink2);max-width:70ch;line-height:1.85}
ul,ol{margin-block:10px;margin-inline:20px 0;color:var(--ink2);line-height:1.85}
li{margin:6px 0}
li::marker{color:var(--muted)}
.anchor{color:var(--muted);opacity:0;font-weight:400;margin-inline-start:8px;font-size:.8em;text-decoration:none}
h2:hover .anchor,h3:hover .anchor{opacity:1}
strong,b{color:var(--ink);font-weight:650}
main code:not(pre code){background:var(--panel);border:1px solid var(--line);border-radius:6px;
  padding:1px 5px;font-size:.86em;color:var(--ink)}

/* pills, notes, tables */
.pill{display:inline-flex;align-items:center;gap:6px;padding:3px 10px;border-radius:999px;
  font-size:11.5px;font-weight:700;letter-spacing:.03em;line-height:1.5;border:1px solid var(--line);
  background:var(--panel);color:var(--ink3)}
.pill.post{background:var(--green-soft);border-color:var(--green-border);color:var(--green)}
.pill.get{background:var(--get-soft);border-color:var(--get-border);color:var(--get)}
.pill.put{background:var(--amber-soft);border-color:var(--amber-border);color:var(--amber)}
.pill.del{background:var(--red-soft);border-color:var(--red-border);color:var(--red)}
.route{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin:14px 0 4px}
.route code{font-size:13.5px;font-weight:600}
.note{display:flex;gap:11px;padding:13px 15px;border-radius:14px;font-size:13.5px;line-height:1.8;
  border:1px solid var(--line);background:var(--panel);margin:14px 0;color:var(--ink2)}
.note b{color:var(--ink)}
.note.warn{background:var(--amber-soft);border-color:var(--amber-border)}
.note.ok{background:var(--green-soft);border-color:var(--green-border)}
.note svg{flex:none;margin-top:4px;color:var(--muted)}
.note.warn svg{color:var(--amber)}
.note.ok svg{color:var(--green)}
table{width:100%;border-collapse:separate;border-spacing:0;margin:14px 0;font-size:13.5px;line-height:1.7;
  border:1px solid var(--line);border-radius:14px;overflow:hidden;background:var(--surface)}
th{text-align:start;background:var(--panel);color:var(--ink3);font-weight:650;font-size:12.5px;
  padding:10px 13px;border-bottom:1px solid var(--line)}
td{padding:11px 13px;border-bottom:1px solid var(--line);color:var(--ink2);vertical-align:top}
tr:last-child td{border-bottom:none}
td code{white-space:nowrap}
.req{color:var(--red);font-weight:700;font-size:11px}
.opt{color:var(--muted);font-size:11px}

/* ---- code panel ---------------------------------------------------- */
.panel{position:sticky;top:calc(var(--head) + 20px)}
.langs{display:flex;gap:3px;padding:4px;border-radius:12px;background:var(--panel);
  border:1px solid var(--line);margin-bottom:10px;overflow:auto}
.langs button{border:none;background:none;font-size:12px;font-weight:650;color:var(--muted);
  padding:6px 12px;border-radius:8px;white-space:nowrap;transition:.13s}
.langs button:hover{color:var(--ink)}
.langs button.on{background:var(--seg-on);color:var(--seg-on-ink);box-shadow:var(--shadow)}
.code{border:1px solid var(--code-line);border-radius:14px;overflow:hidden;background:var(--code-bg);
  margin-bottom:14px;box-shadow:var(--shadow)}
.code-top{display:flex;align-items:center;gap:8px;padding:7px 12px;background:var(--panel);
  border-bottom:1px solid var(--code-line);line-height:1.6}
.dot{width:7px;height:7px;border-radius:50%;background:var(--hh-sand);flex:none}
.code-top span{font-size:11.5px;font-weight:700;color:var(--muted)}
.code-top span[data-name]{letter-spacing:.04em;text-transform:uppercase}
.copy{margin-inline-start:auto;border:none;background:none;color:var(--muted);font-size:11.5px;
  font-weight:650;padding:3px 9px;border-radius:7px;transition:.13s}
.copy:hover{background:var(--line);color:var(--ink)}
.copy.done{color:var(--green)}
pre{margin:0;padding:12px 0;overflow:auto;font-size:12.5px;line-height:1.65;
  max-height:520px;color:var(--ink2)}
pre code{display:block;width:max-content;min-width:100%}
.ln{display:block;min-height:1.65em;padding-inline-end:14px;white-space:pre}
.ln::before{counter-increment:l;content:counter(l);position:sticky;inset-inline-start:0;display:inline-block;
  width:3.2em;padding-inline-end:1em;margin-inline-end:.9em;text-align:end;color:var(--gut);
  background:var(--code-bg);border-inline-end:1px solid var(--code-line);user-select:none}
pre{counter-reset:l}
.c-com{color:var(--c-com);font-style:italic}.c-str{color:var(--c-str)}
.c-kw{color:var(--c-kw);font-weight:600}.c-num{color:var(--c-num)}
.c-fn{color:var(--c-fn)}.c-cst{color:var(--c-cst)}.c-typ{color:var(--c-typ)}
.c-var{color:var(--c-var)}.c-op{color:var(--c-op)}.c-key{color:var(--c-typ)}

.hide{display:none !important}
.tot{position:fixed;inset-inline-end:20px;bottom:20px;z-index:30;display:none;place-items:center;
  width:42px;height:42px;border-radius:12px;border:1px solid var(--bar-line);background:var(--bar);
  color:var(--bar-ink);box-shadow:var(--shadow-lg);transition:background .14s}
.tot:hover{background:var(--bar-raise)}
.tot.on{display:grid}

/* footer: Deep Navy band at the end of the content */
footer{background:var(--foot);color:var(--hh-sand);border-radius:16px;padding:20px 24px;margin-top:8px;
  font-size:13px;line-height:1.7;display:flex;gap:8px 18px;flex-wrap:wrap;align-items:center}
footer .foot-mark{display:block;height:24px;width:auto;margin-inline-end:4px}
footer span{color:var(--hh-cream);font-weight:600;margin-inline-end:auto}
footer a{color:var(--hh-sand);text-decoration:none}
footer a:hover{color:var(--hh-cream);text-decoration:underline;text-decoration-color:currentColor}
footer :focus-visible{outline-color:var(--hh-cream)}
:root[data-theme="dark"] footer{border:1px solid var(--line)}

@media (max-width:1120px){
  /* minmax(0,…): a long code line must scroll inside its block, not widen the
     page (in RTL that overflow would push the text off the left edge) */
  .split{grid-template-columns:minmax(0,1fr)}
  .panel{position:static}
}
@media (max-width:900px){
  :root{--head:60px}
  .top{gap:10px;padding:0 16px}
  .shell{grid-template-columns:1fr}
  .side{position:fixed;top:var(--head);inset-inline-start:0;width:280px;background:var(--surface);z-index:35;
    transform:translateX(102%);transition:transform .22s cubic-bezier(.2,.8,.25,1); /* RTL: drawer sits on the right, hides off to the right */
    box-shadow:var(--shadow-lg)}
  .side.open{transform:none}
  .burger{display:grid}
  main{padding:28px 16px 80px}
  .top-sp{display:none}
  .search{width:auto;flex:1;min-width:0}
  .search kbd{display:none}
  .search input{padding-inline-end:12px}
  h1{font-size:27px}
}
@media (max-width:640px){
  .top-a,.brand-tag{display:none}
  .top{gap:8px;padding:0 12px}
  .brand img{height:28px} /* 121px wide: the lockup's 120px minimum */
  .icon-btn{width:34px;height:34px}
  .search input{padding-inline-start:31px;padding-inline-end:10px;font-size:13px}
  .search svg{inset-inline-start:10px}
  footer span{flex-basis:100%;margin-inline-end:0}
}
@media (prefers-reduced-motion:reduce){
  html{scroll-behavior:auto}
  .side{transition:none}
}