/* docs.aeron.sh — the reference surface.
   Same tokens as the product pages; a different object. The product pages
   float a physical thing next to a headline. Documentation is a spec sheet:
   numbered sections in the gutter, code arriving as stamped forms, data in
   ledger rows. */
:root{
  --canvas:#ffffff;--ink:#0a0a0a;--charcoal:#3b3b3b;--slate:#4a4a4a;--ash:#676767;
  --mute:#8a8a8a;--stone:#ababab;--hairline:#d0d5db;--hairline-soft:#e5e7eb;
  --accent:#09f875;--accent-deep:#059a4c;--paper:#fafbfa;
  --display:'Space Grotesk',sans-serif;--body:'Inter','Helvetica Neue',Arial,sans-serif;
  --mono:ui-monospace,SFMono-Regular,Menlo,monospace;
}
*{box-sizing:border-box;margin:0;padding:0}
html{scroll-behavior:smooth}
body{background:var(--canvas);color:var(--ink);font-family:var(--body);font-size:16px;line-height:1.65}
a{color:inherit}
a:focus-visible,button:focus-visible{outline:2px solid var(--ink);outline-offset:2px}
.skip{position:absolute;left:-9999px;top:0;background:var(--accent);color:var(--ink);padding:10px 16px;
  font:600 13px var(--display);z-index:20}
.skip:focus{left:12px;top:12px}

/* ── top bar ─────────────────────────────────────────────────────────── */
.topbar{position:sticky;top:0;z-index:10;background:rgba(255,255,255,.94);backdrop-filter:blur(8px);
  border-bottom:1px solid var(--hairline-soft)}
.topbar-inner{max-width:1180px;margin:0 auto;padding:0 24px;height:60px;display:flex;align-items:center;gap:24px}
.brand{display:flex;align-items:center;gap:10px;text-decoration:none}
.brand img{height:16px;width:auto;display:block}
.brand span{font:600 11px var(--display);letter-spacing:.16em;text-transform:uppercase;color:var(--accent-deep);
  border-left:1px solid var(--hairline);padding-left:10px}
.top-links{display:flex;gap:20px;margin-left:auto}
.top-links a{font:500 13.5px var(--display);text-decoration:none;color:var(--charcoal)}
.top-links a:hover{color:var(--accent-deep)}
.gh{font:500 13.5px var(--display);text-decoration:none;color:var(--ink);border:1px solid var(--hairline);
  border-radius:6px;padding:7px 13px;line-height:1}
.gh:hover{border-color:var(--ink)}

/* ── frame ───────────────────────────────────────────────────────────── */
.doc{max-width:1180px;margin:0 auto;padding:0 24px;display:grid;grid-template-columns:224px minmax(0,1fr);gap:64px}
.side{padding:40px 0 60px;position:sticky;top:60px;align-self:start;max-height:calc(100vh - 60px);overflow-y:auto}
.side-group{margin-bottom:26px}
.side-label{display:block;font:600 10px var(--display);letter-spacing:.16em;text-transform:uppercase;
  color:var(--mute);padding-bottom:9px;border-bottom:1px solid var(--hairline-soft);margin-bottom:6px}
.side ul{list-style:none}
.side li a{display:block;padding:6px 0 6px 12px;font:500 14px var(--display);color:var(--charcoal);
  text-decoration:none;border-left:2px solid transparent}
.side li a:hover{color:var(--ink)}
.side li a[aria-current]{color:var(--ink);border-left-color:var(--accent);font-weight:600}

.main{padding:44px 0 40px;min-width:0;max-width:760px}
.page-head{padding-bottom:26px;border-bottom:1px solid var(--hairline)}
.eyebrow{display:inline-block;background:var(--accent);color:var(--ink);border-radius:5px;padding:6px 10px;
  font:600 11px var(--display);letter-spacing:.1em;text-transform:uppercase;line-height:1}
.page-head h1{font:500 clamp(30px,3.4vw,44px)/1.12 var(--display);letter-spacing:-.015em;margin:16px 0 12px}
.lede{color:var(--slate);font-size:17.5px;max-width:640px}

/* ── prose ───────────────────────────────────────────────────────────── */
.prose{counter-reset:sec}
.prose h2{counter-increment:sec;position:relative;font:500 25px/1.25 var(--display);letter-spacing:-.01em;
  margin:64px 0 14px;padding-top:22px;border-top:1px solid var(--hairline-soft)}
.prose h2::before{content:counter(sec,decimal-leading-zero);position:absolute;top:22px;left:-42px;
  font:600 12px var(--mono);color:var(--accent-deep);letter-spacing:.04em;line-height:1.4}
.prose h3{font:600 16.5px var(--display);margin:32px 0 8px}
.prose h4{font:600 13px var(--display);letter-spacing:.06em;text-transform:uppercase;color:var(--ash);margin:26px 0 8px}
.prose p{color:var(--charcoal);margin:12px 0}
.prose p.tight{margin-top:4px}
.prose a{color:var(--accent-deep);text-decoration:underline;text-underline-offset:2px;text-decoration-thickness:1px}
.prose a:hover{color:var(--ink)}
.prose ul,.prose ol{margin:12px 0 12px 20px;color:var(--charcoal)}
.prose li{margin:6px 0}
.prose li::marker{color:var(--stone)}
.prose strong{font-weight:600;color:var(--ink)}
.prose code{font:13.5px var(--mono);background:var(--hairline-soft);border-radius:4px;padding:1.5px 5px;
  color:var(--ink);word-break:break-word}
.prose hr{border:0;border-top:1px solid var(--hairline-soft);margin:36px 0}

/* ── code, as a stamped form ─────────────────────────────────────────── */
figure.code{margin:18px 0;border:1px solid var(--ink);border-radius:8px;overflow:hidden}
figure.code figcaption{background:var(--ink);color:var(--stone);font:600 10px var(--display);letter-spacing:.16em;
  text-transform:uppercase;padding:9px 16px 0;display:flex;justify-content:space-between;gap:12px}
figure.code figcaption em{font-style:normal;color:var(--accent);letter-spacing:.1em}
figure.code pre{background:var(--ink);color:#f2f2f2;padding:12px 16px 18px;overflow-x:auto;
  font:13px/1.65 var(--mono);tab-size:2}
figure.code pre b{color:var(--accent);font-weight:400}
figure.code pre i{color:#8d8d8d;font-style:normal}
figure.code pre u{color:#ff8f6b;text-decoration:none}

/* ── ledger tables ───────────────────────────────────────────────────── */
.prose table{width:100%;border-collapse:collapse;margin:18px 0;font-size:14.5px}
.prose th{text-align:left;font:600 10px var(--display);letter-spacing:.14em;text-transform:uppercase;
  color:var(--ash);padding:0 14px 9px 0;border-bottom:1px solid var(--hairline)}
.prose td{padding:11px 14px 11px 0;border-bottom:1px solid var(--hairline-soft);color:var(--charcoal);
  vertical-align:top;font-variant-numeric:tabular-nums}
.prose td:first-child{color:var(--ink)}
.prose td code{background:none;padding:0;font-size:13px}
.prose .wrap td{overflow-wrap:break-word}
/* identifier columns must not break mid-token */
.prose table.keys td:first-child{white-space:nowrap;padding-right:24px}

/* ── plates: a notice with its tag in the corner ─────────────────────── */
.plate{position:relative;border:1px solid var(--hairline);border-radius:8px;background:var(--paper);
  padding:22px 22px 18px;margin:26px 0}
.plate .tag{position:absolute;top:-9px;left:16px;background:var(--canvas);padding:0 8px;
  font:600 10px var(--display);letter-spacing:.16em;text-transform:uppercase;color:var(--ash)}
.plate p{margin:6px 0;color:var(--charcoal);font-size:15px}
.plate p:first-child{margin-top:0}
.plate.hot{border-color:var(--accent-deep);background:#f4fff9}
.plate.hot .tag{color:var(--accent-deep)}
.plate.warn{border-color:#e6b800;background:#fffdf2}
.plate.warn .tag{color:#8a6d00}

/* ── the constants strip ─────────────────────────────────────────────── */
.facts{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:0;border:1px solid var(--hairline);
  border-radius:8px;overflow:hidden;margin:22px 0}
.facts div{padding:14px 16px;border-right:1px solid var(--hairline-soft);border-bottom:1px solid var(--hairline-soft)}
.facts div:nth-child(2n){border-right:0}
.facts dt{font:600 10px var(--display);letter-spacing:.14em;text-transform:uppercase;color:var(--ash)}
.facts dd{font:13px var(--mono);color:var(--ink);margin-top:5px;word-break:break-all}

/* ── step list: the flow, numbered like a receipt ────────────────────── */
ol.steps{list-style:none;margin:20px 0;counter-reset:step}
ol.steps li{counter-increment:step;position:relative;padding:14px 0 14px 44px;border-bottom:1px dotted var(--hairline)}
ol.steps li:last-child{border-bottom:0}
ol.steps li::before{content:counter(step,decimal-leading-zero);position:absolute;left:0;top:15px;
  font:600 11px var(--mono);color:var(--accent-deep)}
ol.steps b{display:block;font:600 15px var(--display);color:var(--ink);margin-bottom:2px}

/* ── card links ──────────────────────────────────────────────────────── */
.cards{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:14px;margin:22px 0}
.cards a{border:1px solid var(--hairline-soft);border-radius:8px;padding:20px;text-decoration:none;
  display:block;transition:border-color 160ms ease,transform 160ms ease}
.cards a:hover{border-color:var(--hairline);transform:translateY(-2px)}
.cards h3{font:600 16px var(--display);color:var(--ink);margin-bottom:5px}
.cards p{font-size:14px;color:var(--slate);margin:0}
.cards .k{font:600 10px var(--mono);letter-spacing:.1em;text-transform:uppercase;color:var(--accent-deep);
  display:block;margin-bottom:9px}

/* ── pager + stamp ───────────────────────────────────────────────────── */
.pager{display:flex;justify-content:space-between;gap:16px;margin-top:64px;padding-top:22px;
  border-top:1px solid var(--hairline)}
.pg{text-decoration:none;padding:12px 16px;border:1px solid var(--hairline-soft);border-radius:8px;min-width:160px}
.pg:hover{border-color:var(--hairline)}
.pg-next{text-align:right;margin-left:auto}
.pg-k{display:block;font:600 10px var(--display);letter-spacing:.14em;text-transform:uppercase;color:var(--mute)}
.pg-t{display:block;font:600 15px var(--display);color:var(--ink);margin-top:3px}
.stamp{margin-top:28px;font-size:13px;color:var(--mute)}
.stamp a{color:var(--ash)}

/* ── footer ──────────────────────────────────────────────────────────── */
footer.site{margin-top:80px;border-top:1px solid var(--hairline);padding:26px 0 60px}
.foot-inner{max-width:1180px;margin:0 auto;padding:0 24px;display:flex;flex-direction:column;gap:14px}
footer.site img{height:15px;width:auto;align-self:flex-start}
.f-links{display:flex;gap:18px;flex-wrap:wrap}
.f-links a{font:500 13.5px var(--display);color:var(--charcoal);text-decoration:none}
.f-links a:hover{color:var(--accent-deep)}
.fine{color:var(--mute);font-size:12.5px}

@media (max-width:960px){
  .doc{grid-template-columns:1fr;gap:0}
  .side{position:static;max-height:none;padding:14px 0 0;overflow:visible;
    border-bottom:1px solid var(--hairline-soft)}
  /* the whole nav becomes one horizontally scrolled strip; the flex row has
     to be the element that holds the groups, not the aside around it. */
  .side nav{display:flex;gap:24px;overflow-x:auto;padding-bottom:10px}
  .side-group{margin-bottom:0;min-width:max-content}
  .side ul{display:flex;gap:14px}
  .side li a{border-left:0;border-bottom:2px solid transparent;padding:4px 0}
  .side li a[aria-current]{border-bottom-color:var(--accent)}
  .prose h2::before{position:static;display:block;margin-bottom:6px}
  .top-links{display:none}
}
@media (max-width:620px){
  .facts,.cards{grid-template-columns:1fr}
  .pager{flex-direction:column}
  .pg-next{text-align:left;margin-left:0}
}