:root{
  --bg:#f7f8fa; --panel:#ffffff; --ink:#111827; --muted:#5b6472;
  --line:#e3e7ed; --accent:#0b5cab; --accent-soft:#e8f1fb;
  --warn:#b45309; --warn-soft:#fef3c7; --danger:#b42318; --danger-soft:#fee4e2;
  --ok:#046c4e; --ok-soft:#d9f2e6;
  --mono:ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;
  --sans:-apple-system,BlinkMacSystemFont,"Segoe UI",Inter,Roboto,Helvetica,Arial,sans-serif;
}
*{box-sizing:border-box}
html{scroll-behavior:smooth;scroll-padding-top:80px}
body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);
  font-size:15.5px;line-height:1.62;-webkit-font-smoothing:antialiased}

/* ---------- top bar ---------- */
header.top{position:sticky;top:0;z-index:50;background:rgba(255,255,255,.92);
  backdrop-filter:saturate(180%) blur(10px);border-bottom:1px solid var(--line)}
.top-in{max-width:1180px;margin:0 auto;padding:0 24px;display:flex;align-items:center;
  gap:28px;height:60px}
.brand{display:flex;align-items:baseline;gap:10px;text-decoration:none;color:var(--ink)}
.brand b{font-size:16px;letter-spacing:-.01em}
.brand span{font-size:11.5px;color:var(--muted);text-transform:uppercase;letter-spacing:.08em}
nav.top-nav{display:flex;gap:4px;margin-left:auto;flex-wrap:wrap}
nav.top-nav a{font-size:13.5px;color:var(--muted);text-decoration:none;padding:6px 11px;
  border-radius:7px}
nav.top-nav a:hover{background:var(--accent-soft);color:var(--accent)}
nav.top-nav a.on{background:var(--accent);color:#fff}

/* ---------- layout ---------- */
.wrap{max-width:1180px;margin:0 auto;padding:0 24px}
main{padding:38px 0 90px}
.hero{padding:14px 0 30px;border-bottom:1px solid var(--line);margin-bottom:34px}
.eyebrow{font-size:11.5px;text-transform:uppercase;letter-spacing:.1em;color:var(--accent);
  font-weight:650;margin:0 0 8px}
h1{font-size:32px;line-height:1.2;letter-spacing:-.02em;margin:0 0 10px;font-weight:680}
.lede{font-size:16.5px;color:var(--muted);margin:0;max-width:74ch}
h2{font-size:21px;letter-spacing:-.01em;margin:44px 0 12px;padding-top:6px;font-weight:660}
h3{font-size:16px;margin:26px 0 8px;font-weight:650}
h4{font-size:14px;margin:18px 0 6px;font-weight:650;color:var(--muted)}
p{margin:0 0 12px;max-width:82ch}
ul,ol{margin:0 0 14px;padding-left:22px;max-width:82ch}
li{margin:4px 0}
a{color:var(--accent)}
hr{border:0;border-top:1px solid var(--line);margin:38px 0}

/* ---------- cards / panels ---------- */
.panel{background:var(--panel);border:1px solid var(--line);border-radius:12px;
  padding:22px 24px;margin:16px 0}
.grid{display:grid;gap:14px;margin:16px 0}
.g2{grid-template-columns:repeat(auto-fit,minmax(280px,1fr))}
.g3{grid-template-columns:repeat(auto-fit,minmax(215px,1fr))}
.card{background:var(--panel);border:1px solid var(--line);border-radius:11px;padding:16px 18px}
.card h3{margin:0 0 6px;font-size:14.5px}
.card p{font-size:13.5px;color:var(--muted);margin:0}
.card .k{font-family:var(--mono);font-size:12px;color:var(--accent);display:block;margin-top:8px;
  word-break:break-all}

/* ---------- callouts ---------- */
.note{border-left:3px solid var(--accent);background:var(--accent-soft);padding:13px 17px;
  border-radius:0 9px 9px 0;margin:16px 0;font-size:14.5px}
.note.warn{border-color:var(--warn);background:var(--warn-soft)}
.note.danger{border-color:var(--danger);background:var(--danger-soft)}
.note.ok{border-color:var(--ok);background:var(--ok-soft)}
.note p:last-child{margin-bottom:0}
.note b{font-weight:660}

/* ---------- code ---------- */
code{font-family:var(--mono);font-size:.875em;background:#eef1f5;padding:1.5px 5px;
  border-radius:5px;border:1px solid #e0e5ec}
pre{background:#0f172a;color:#e2e8f0;padding:16px 18px;border-radius:10px;overflow-x:auto;
  font-family:var(--mono);font-size:12.8px;line-height:1.6;margin:12px 0;max-width:100%}
pre code{background:none;border:0;padding:0;color:inherit;font-size:inherit}
pre .c{color:#7c8db5}
pre .s{color:#a5d6a7}
pre .k{color:#79b8ff}

/* ---------- tables ---------- */
.tw{overflow-x:auto;margin:14px 0;border:1px solid var(--line);border-radius:10px;
  background:var(--panel)}
table{border-collapse:collapse;width:100%;font-size:13.6px;min-width:520px}
th,td{text-align:left;padding:9px 14px;border-bottom:1px solid var(--line);vertical-align:top}
th{background:#f2f4f8;font-weight:650;font-size:12px;text-transform:uppercase;
  letter-spacing:.05em;color:var(--muted);white-space:nowrap}
tbody tr:last-child td{border-bottom:0}
td code{font-size:12px}

/* ---------- diagram ---------- */
.diagram{background:var(--panel);border:1px solid var(--line);border-radius:12px;
  padding:22px 18px;margin:18px 0;overflow-x:auto}
.diagram .mermaid{display:flex;justify-content:center;min-width:min-content}
.diagram figcaption{font-size:12.5px;color:var(--muted);text-align:center;margin-top:14px;
  padding-top:12px;border-top:1px solid var(--line)}
.legend{display:flex;flex-wrap:wrap;gap:16px;font-size:12.5px;color:var(--muted);
  margin:12px 0 0;justify-content:center}
.legend i{display:inline-block;width:11px;height:11px;border-radius:3px;margin-right:6px;
  vertical-align:-1px}

/* ---------- misc ---------- */
.pill{display:inline-block;font-size:11px;font-weight:650;padding:2.5px 9px;border-radius:20px;
  background:var(--accent-soft);color:var(--accent);text-transform:uppercase;letter-spacing:.05em}
.pill.warn{background:var(--warn-soft);color:var(--warn)}
.pill.danger{background:var(--danger-soft);color:var(--danger)}
.pill.ok{background:var(--ok-soft);color:var(--ok)}
.steps{counter-reset:s;list-style:none;padding-left:0}
.steps>li{counter-increment:s;position:relative;padding-left:38px;margin:16px 0}
.steps>li::before{content:counter(s);position:absolute;left:0;top:1px;width:25px;height:25px;
  border-radius:50%;background:var(--accent);color:#fff;font-size:12.5px;font-weight:650;
  display:flex;align-items:center;justify-content:center}
footer{border-top:1px solid var(--line);padding:26px 0 44px;font-size:12.5px;color:var(--muted)}
.next{display:flex;gap:12px;flex-wrap:wrap;margin-top:34px;padding-top:26px;
  border-top:1px solid var(--line)}
.next a{flex:1 1 240px;background:var(--panel);border:1px solid var(--line);border-radius:11px;
  padding:14px 17px;text-decoration:none;color:var(--ink)}
.next a:hover{border-color:var(--accent)}
.next a span{display:block;font-size:11px;text-transform:uppercase;letter-spacing:.08em;
  color:var(--muted);margin-bottom:3px}
.next a b{font-weight:650;font-size:14.5px;color:var(--accent)}
@media (max-width:720px){
  h1{font-size:25px}.lede{font-size:15px}.top-in{height:auto;padding:10px 18px;flex-wrap:wrap;gap:10px}
  nav.top-nav{margin-left:0;width:100%}
}

/* mermaid renders into the <pre>, so neutralise the code-block styling */
pre.mermaid{background:transparent;color:inherit;padding:0;border-radius:0;
  font-family:var(--sans);font-size:13px;line-height:normal;overflow:visible;
  display:flex;justify-content:center;min-height:60px}
pre.mermaid svg{max-width:100%;height:auto}
pre.mermaid:not([data-processed]){visibility:hidden}