:root{
  --bg:#fff; --bg-soft:#f7f7f8; --bg-code:#0f1117; --bg-code-fg:#dfe3ea;
  --fg:#1b1b1f; --fg-mut:#6b6b75; --line:#e5e5ea; --line-soft:#efeff3;
  --accent:#5b46d9; --accent-soft:#f1eeff; --accent-fg:#4b38c9;
  --ok:#12805c; --bad:#c02b3f; --warn:#b45309;
  --mono:ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,"Liberation Mono",monospace;
  --sans:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Inter,Helvetica,Arial,sans-serif;
  --r:10px;
}
html[data-theme="dark"]{
  --bg:#0c0d11; --bg-soft:#14161c; --bg-code:#08090d; --bg-code-fg:#d7dbe4;
  --fg:#e9e9ef; --fg-mut:#9a9aa6; --line:#23252e; --line-soft:#1b1d24;
  --accent:#a294ff; --accent-soft:#1a182c; --accent-fg:#b3a7ff;
}
*{box-sizing:border-box}
html{scroll-behavior:smooth}
body{margin:0;background:var(--bg);color:var(--fg);font:15px/1.65 var(--sans);-webkit-font-smoothing:antialiased}
a{color:var(--accent-fg);text-decoration:none}
a:hover{text-decoration:underline}
code{font-family:var(--mono);font-size:.88em;background:var(--bg-soft);border:1px solid var(--line-soft);
  padding:.1em .35em;border-radius:5px}
kbd{font-family:var(--mono);font-size:11px;border:1px solid var(--line);border-radius:5px;padding:1px 5px;
  color:var(--fg-mut);background:var(--bg-soft)}
.muted{color:var(--fg-mut)}
.sm{font-size:12px}

/* -------------------------------- top bar ------------------------------- */
.top{position:sticky;top:0;z-index:40;background:color-mix(in srgb,var(--bg) 88%,transparent);
  backdrop-filter:blur(10px);border-bottom:1px solid var(--line)}
.top-in{max-width:1240px;margin:0 auto;display:flex;align-items:center;gap:18px;height:56px;padding:0 20px}
.brand{display:flex;align-items:center;gap:8px;font-weight:650;font-size:15px;color:var(--fg)}
.brand:hover{text-decoration:none}
.logo{display:grid;place-items:center;width:24px;height:24px;border-radius:7px;background:var(--accent);
  color:#fff;font-weight:800;font-size:13px}
.brand-sub{color:var(--fg-mut);font-weight:400;font-size:12px;margin-left:2px}
.search{flex:1;max-width:520px;display:flex;align-items:center;gap:8px;height:34px;padding:0 10px;
  border:1px solid var(--line);border-radius:8px;background:var(--bg-soft)}
.search:focus-within{border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
.search .i{width:16px;height:16px;color:var(--fg-mut);flex:none}
.search input{flex:1;border:0;outline:0;background:transparent;color:var(--fg);font:inherit;font-size:13.5px}
.search input::-webkit-search-cancel-button{display:none}
.top-nav{display:flex;gap:16px;font-size:13.5px}
.top-nav a{color:var(--fg-mut)}
.top-nav a.on{color:var(--fg);font-weight:600}
.icon-btn{width:32px;height:32px;border:1px solid var(--line);border-radius:8px;background:transparent;
  color:var(--fg-mut);cursor:pointer;font-size:14px;line-height:1}
.icon-btn:hover{background:var(--bg-soft);color:var(--fg)}

/* prefs popover */
.prefs{position:absolute;right:20px;top:60px;width:280px;background:var(--bg);border:1px solid var(--line);
  border-radius:12px;box-shadow:0 18px 50px rgba(10,10,20,.16);padding:14px;z-index:50}
.prefs h4{margin:0 0 10px;font-size:13px;letter-spacing:.02em;text-transform:uppercase;color:var(--fg-mut)}
.field{display:block;font-size:13px;margin-bottom:12px;color:var(--fg-mut)}
.field select,.field input[type=range]{display:block;width:100%;margin-top:5px}
.field select{padding:6px 8px;border:1px solid var(--line);border-radius:7px;background:var(--bg-soft);
  color:var(--fg);font:inherit;font-size:13px}
.check{display:flex;align-items:center;gap:8px;font-size:13px;color:var(--fg-mut);margin-bottom:12px}
.prefs-foot{display:flex;align-items:center;justify-content:space-between;gap:8px;
  border-top:1px solid var(--line-soft);padding-top:10px}

/* -------------------------------- layout -------------------------------- */
.layout{max-width:1240px;margin:0 auto;display:grid;grid-template-columns:220px minmax(0,1fr);gap:44px;
  padding:0 20px}
.sidebar{position:sticky;top:56px;align-self:start;padding:28px 0 60px;font-size:13.5px}
.side-h{margin:18px 0 6px;font-size:11px;letter-spacing:.08em;text-transform:uppercase;color:var(--fg-mut);
  font-weight:600}
.sidebar a,.toc a{display:block;padding:4px 10px;border-left:2px solid transparent;color:var(--fg-mut);
  border-radius:0 6px 6px 0}
.sidebar a:hover,.toc a:hover{color:var(--fg);background:var(--bg-soft);text-decoration:none}
.sidebar a.on{color:var(--accent-fg);border-left-color:var(--accent);font-weight:600;background:var(--accent-soft)}
main{display:grid;grid-template-columns:minmax(0,1fr) 180px;gap:40px;padding:28px 0 80px}
article{min-width:0;max-width:720px}
.toc{position:sticky;top:56px;align-self:start;font-size:13px;padding-top:34px}
.crumbs{font-size:12.5px;color:var(--fg-mut);margin:0 0 10px}
.crumbs span{margin:0 6px;opacity:.6}
h1{font-size:34px;line-height:1.2;letter-spacing:-.02em;margin:.1em 0 .5em}
.lede{font-size:16.5px;color:#3d3d46;max-width:64ch}
html[data-theme="dark"] .lede{color:#c3c3ce}
h2{font-size:20px;letter-spacing:-.01em;margin:2.1em 0 .5em;padding-top:.2em}
h2:target{scroll-margin-top:80px}
p{margin:0 0 14px}
.meta{font-size:12.5px;color:var(--fg-mut);border-bottom:1px solid var(--line);padding-bottom:18px}

/* ------------------------------ code blocks ----------------------------- */
.codetabs{border:1px solid var(--line);border-radius:var(--r);overflow:hidden;margin:16px 0 18px}
.ct-head{display:flex;gap:2px;background:var(--bg-soft);border-bottom:1px solid var(--line);padding:6px 8px}
.ct{font:inherit;font-size:12.5px;border:0;background:transparent;color:var(--fg-mut);padding:4px 10px;
  border-radius:6px;cursor:pointer}
.ct.on{background:var(--bg);color:var(--fg);box-shadow:0 1px 2px rgba(0,0,0,.08);font-weight:600}
.block{font-family:var(--mono);font-size:13px;line-height:1.7;background:var(--bg-code);color:var(--bg-code-fg);
  margin:0;padding:14px 16px;overflow-x:auto;border-radius:var(--r)}
.codetabs .block{border-radius:0}
.callout{border-left:3px solid var(--accent);background:var(--accent-soft);padding:12px 16px;
  border-radius:0 8px 8px 0;font-size:14px;margin:16px 0}

/* ----------------------------- walkthrough ------------------------------ */
.walk{margin:34px 0 10px;border:1px solid var(--line);border-radius:14px;background:var(--bg);
  box-shadow:0 1px 2px rgba(15,15,30,.04);overflow:hidden}
.walk-head{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;padding:16px 18px 12px;
  cursor:pointer}
.walk-head:focus-visible{outline:2px solid var(--accent);outline-offset:-2px}
.walk-title{min-width:0}
.walk-head h2{margin:0;font-size:17px}
.walk-sub{margin:4px 0 0;font-size:13px;color:var(--fg-mut);max-width:52ch}
.walk-head-right{display:flex;align-items:center;gap:10px;flex-shrink:0}
.walk .chev{color:var(--fg-mut);font-size:12px;transition:transform .18s;line-height:1}
.walk.closed .walk-sub{display:none}
.walk.closed .walk-body{display:none}
.walk.closed .walk-head{align-items:center;padding:11px 18px}
.walk:not(.closed) #walkChev{transform:rotate(180deg)}

.pill{display:inline-flex;align-items:center;gap:7px;font-size:12px;padding:4px 10px;border-radius:999px;
  border:1px solid var(--line);background:var(--bg-soft);color:var(--fg-mut);white-space:nowrap}
.pill .dot{width:7px;height:7px;border-radius:50%;background:var(--fg-mut);flex:none}
.pill.thinking .dot{background:var(--warn);animation:pulse 1s infinite}
.pill.typing .dot{background:var(--accent);animation:pulse .7s infinite}
.pill.ok .dot{background:var(--ok)}
.pill.error .dot{background:var(--bad)}
@keyframes pulse{50%{opacity:.25}}

.tabs{display:flex;gap:2px;padding:0 12px;border-bottom:1px solid var(--line);overflow-x:auto}
.tab{font-family:var(--mono);font-size:12px;border:0;background:transparent;color:var(--fg-mut);
  padding:8px 10px;border-bottom:2px solid transparent;cursor:pointer;white-space:nowrap}
.tab.on{color:var(--fg);border-bottom-color:var(--accent)}

.editor{background:var(--bg-code);max-height:340px;overflow:auto}
.editor-inner{display:flex;min-height:220px}
.gutter{flex:none;padding:14px 10px 14px 14px;text-align:right;color:#4a5162;font-family:var(--mono);
  font-size:13px;line-height:1.7;user-select:none;position:sticky;left:0;background:var(--bg-code);
  border-right:1px solid #1c212c}
.gutter span{display:block}
.code{margin:0;padding:14px 16px 14px 12px;font-family:var(--mono);font-size:13px;line-height:1.7;
  color:var(--bg-code-fg);white-space:pre;tab-size:2}
.caret{display:inline-block;width:2px;height:1.05em;background:var(--accent);vertical-align:-.16em;
  margin-left:1px;animation:blink 1s steps(1) infinite}
@keyframes blink{50%{opacity:0}}

.walk-foot{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 14px;
  border-top:1px solid var(--line);background:var(--bg-soft);flex-wrap:wrap}
.pos{font-family:var(--mono);font-size:12px;color:var(--fg-mut)}
.pos b{color:var(--fg);font-weight:600}
.controls{display:flex;gap:8px}
.primary{font:inherit;font-size:13px;font-weight:600;color:#fff;background:var(--accent);border:0;
  padding:8px 16px;border-radius:8px;cursor:pointer;display:inline-flex;align-items:center;gap:8px}
.primary:hover{filter:brightness(1.06)}
.primary:disabled{opacity:.55;cursor:progress}
.primary .k{font-size:10.5px;opacity:.8;border:1px solid rgba(255,255,255,.35);border-radius:4px;padding:0 4px}
.ghost{font:inherit;font-size:13px;background:transparent;color:var(--fg-mut);border:1px solid var(--line);
  padding:7px 12px;border-radius:8px;cursor:pointer}
.ghost:hover{color:var(--fg);background:var(--bg)}
.hint{margin:0;padding:10px 16px 14px;font-size:12.5px;color:var(--fg-mut);border-top:1px solid var(--line-soft)}

/* --------------------------------- faq ---------------------------------- */
.faq{border-top:1px solid var(--line);margin-top:22px}
.faq-item{border-bottom:1px solid var(--line)}
.faq-q{width:100%;display:flex;justify-content:space-between;align-items:center;gap:16px;font:inherit;
  font-size:15px;font-weight:600;text-align:left;background:transparent;border:0;color:var(--fg);
  padding:14px 2px;cursor:pointer}
.faq-q .chev{color:var(--fg-mut);transition:transform .18s;font-size:12px}
.faq-item.open .faq-q .chev{transform:rotate(180deg)}
.faq-a{display:none;padding:0 2px 16px;font-size:14.5px;color:var(--fg-mut)}
.faq-item.open .faq-a{display:block}
.guide{margin-top:14px;border:1px solid var(--line);border-radius:10px;background:var(--bg-soft)}
.guide summary{cursor:pointer;padding:10px 14px;font-size:13px;font-weight:600;color:var(--fg);list-style:none}
.guide summary::-webkit-details-marker{display:none}
.guide summary::before{content:"▸ ";color:var(--accent)}
.guide[open] summary::before{content:"▾ "}
.guide-body{padding:4px 14px 8px}
.guide-body .ghost{margin:6px 14px 12px}
.guidelist{list-style:none;margin:0;padding:0;font-size:13px}
.guidelist li{border-top:1px solid var(--line);padding:9px 0}
.guidelist li:first-child{border-top:0}
.guidelist li.done{opacity:.5}
.ghead{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap;margin-bottom:5px}
.gnum{font-family:var(--mono);font-size:11px;color:var(--fg-mut);border:1px solid var(--line);
  border-radius:5px;padding:0 5px}
.ghead code{font-size:11.5px}
.gnote{color:var(--fg-mut);font-size:12.5px}
.gcode{font-family:var(--mono);font-size:12px;line-height:1.6;background:var(--bg-code);color:var(--bg-code-fg);
  margin:0;padding:8px 10px;border-radius:7px;overflow-x:auto}
.foot{display:flex;justify-content:space-between;margin-top:44px;padding-top:18px;border-top:1px solid var(--line);
  font-size:12.5px;color:var(--fg-mut)}

.toast{position:fixed;right:18px;bottom:18px;max-width:380px;background:#1b1b22;color:#fff;font-size:13px;
  padding:11px 14px;border-radius:10px;box-shadow:0 12px 30px rgba(0,0,0,.25);z-index:100}

/* ------------------------------- panic mode ----------------------------- */
/* Alt+H: every AI surface disappears, the page stays a plain docs page.   */
html.panic [data-ai]{display:none !important}
html.panic #toast{display:none !important}
html.panic #apiState{display:none !important}

/* ------------------------------- responsive ----------------------------- */
@media (max-width:1080px){
  main{grid-template-columns:minmax(0,1fr)}
  .toc{display:none}
}
@media (max-width:820px){
  .layout{grid-template-columns:minmax(0,1fr);gap:0}
  .sidebar{display:none}
  .top-nav{display:none}
  .search{max-width:none}
  h1{font-size:27px}
  article{padding-top:20px}
}