/* ============ Tokens ============ */
:root {
  --text-xs: clamp(0.75rem, 0.7rem + 0.25vw, 0.8125rem);
  --text-sm: clamp(0.875rem, 0.84rem + 0.2vw, 0.9375rem);
  --text-base: clamp(0.9688rem, 0.94rem + 0.2vw, 1.0313rem);
  --text-lg: clamp(1.125rem, 1.05rem + 0.4vw, 1.3125rem);
  --text-xl: clamp(1.5rem, 1.3rem + 0.9vw, 2rem);

  --space-1: .25rem; --space-2: .5rem; --space-3: .75rem; --space-4: 1rem;
  --space-5: 1.25rem; --space-6: 1.5rem; --space-8: 2rem; --space-10: 2.5rem;
  --space-12: 3rem; --space-16: 4rem; --space-20: 5rem;

  --radius-sm: .375rem; --radius-md: .5rem; --radius-lg: .75rem;
  --font-body: 'General Sans', 'Segoe UI', system-ui, sans-serif;
  --font-mono: 'JetBrains Mono', ui-monospace, 'Cascadia Code', Consolas, monospace;
  --header-h: 3.5rem;
  --sidebar-w: 17rem;
  --toc-w: 14rem;
  --ease: cubic-bezier(.2,.7,.2,1);
}

:root, [data-theme="light"] {
  --color-bg: #f5f7f9;
  --color-surface: #ffffff;
  --color-surface-2: #eef2f5;
  --color-border: #d9e0e6;
  --color-divider: #e4e9ee;
  --color-text: #17212b;
  --color-text-muted: #56636f;
  --color-text-faint: #8b97a2;
  --color-primary: #0b7ea3;
  --color-primary-hover: #086a8a;
  --color-primary-soft: #e0f1f7;
  --color-warn: #9a5b00;
  --color-warn-soft: #fbf0dc;
  --color-bad: #b23b2e;
  --color-bad-soft: #f9e3df;
  --color-good: #2e7d3a;
  --color-good-soft: #e2f2e4;
  --code-bg: #f0f3f6;
  --code-text: #1f2a35;
  --hl-kw: #8a3fb8; --hl-str: #2a7a3a; --hl-num: #a0560a; --hl-com: #7c8893;
  --hl-type: #0b7ea3; --hl-attr: #b0372a; --hl-fn: #2257a8;
  --shadow: 0 1px 2px rgba(20,30,40,.05), 0 8px 24px rgba(20,30,40,.06);
}

[data-theme="dark"] {
  --color-bg: #10161d;
  --color-surface: #161e26;
  --color-surface-2: #1d2731;
  --color-border: #2a3642;
  --color-divider: #222d38;
  --color-text: #d8e2ea;
  --color-text-muted: #94a5b4;
  --color-text-faint: #64768a;
  --color-primary: #4fc3e8;
  --color-primary-hover: #7dd4f0;
  --color-primary-soft: rgba(79,195,232,.12);
  --color-warn: #e8b44f;
  --color-warn-soft: rgba(232,180,79,.11);
  --color-bad: #e8776b;
  --color-bad-soft: rgba(232,119,107,.11);
  --color-good: #7fd98c;
  --color-good-soft: rgba(127,217,140,.1);
  --code-bg: #0c1218;
  --code-text: #d3dee7;
  --hl-kw: #c792ea; --hl-str: #a5d6a7; --hl-num: #f5b971; --hl-com: #637585;
  --hl-type: #4fc3e8; --hl-attr: #f28b82; --hl-fn: #82aaff;
  --shadow: 0 1px 2px rgba(0,0,0,.3), 0 10px 30px rgba(0,0,0,.25);
}

/* ============ Base ============ */
*, *::before, *::after { box-sizing: border-box; }
html { scroll-padding-top: calc(var(--header-h) + var(--space-6)); -webkit-text-size-adjust: 100%; }
body {
  margin: 0; font-family: var(--font-body); font-size: var(--text-base); line-height: 1.65;
  color: var(--color-text); background: var(--color-bg);
  -webkit-font-smoothing: antialiased; text-rendering: optimizeLegibility;
}
a { color: var(--color-primary); text-decoration: none; }
a:hover { text-decoration: underline; text-underline-offset: 3px; }
:focus-visible { outline: 2px solid var(--color-primary); outline-offset: 2px; border-radius: 4px; }
::selection { background: var(--color-primary-soft); }
button { font: inherit; color: inherit; }

/* ============ Header ============ */
.topbar {
  position: sticky; top: 0; z-index: 30; height: var(--header-h);
  display: flex; align-items: center; gap: var(--space-4);
  padding: 0 var(--space-5);
  background: color-mix(in srgb, var(--color-bg) 86%, transparent);
  backdrop-filter: saturate(1.4) blur(10px);
  border-bottom: 1px solid var(--color-divider);
}
.brand { display: flex; align-items: center; gap: var(--space-2); color: var(--color-text); font-weight: 600; font-size: var(--text-sm); white-space: nowrap; }
.brand:hover { text-decoration: none; }
.brand svg { color: var(--color-primary); flex: none; }
.brand .ver { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-text-muted); border: 1px solid var(--color-border); padding: 0 var(--space-2); border-radius: 999px; font-weight: 500; }
.topbar .spacer { flex: 1; }
.search-btn {
  display: flex; align-items: center; gap: var(--space-2);
  min-width: 15rem; padding: var(--space-2) var(--space-3);
  background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-md);
  color: var(--color-text-muted); font-size: var(--text-sm); cursor: pointer; transition: border-color .15s;
}
.search-btn:hover { border-color: var(--color-primary); }
.search-btn kbd { margin-left: auto; }
kbd {
  font-family: var(--font-mono); font-size: .75rem; padding: 0 .4em; border-radius: 4px;
  border: 1px solid var(--color-border); background: var(--color-surface-2); color: var(--color-text-muted);
  line-height: 1.6;
}
.icon-btn {
  display: grid; place-items: center; width: 2.25rem; height: 2.25rem; border-radius: var(--radius-md);
  border: 1px solid transparent; background: transparent; cursor: pointer; color: var(--color-text-muted);
}
.icon-btn:hover { background: var(--color-surface-2); color: var(--color-text); }
.menu-btn { display: none; }

/* ============ Layout ============ */
.layout { display: grid; grid-template-columns: var(--sidebar-w) minmax(0,1fr) var(--toc-w); max-width: 92rem; margin: 0 auto; }
.sidebar {
  position: sticky; top: var(--header-h); height: calc(100dvh - var(--header-h)); overflow-y: auto;
  padding: var(--space-6) var(--space-4) var(--space-12) var(--space-5);
  border-right: 1px solid var(--color-divider);
  scrollbar-width: thin;
}
.nav-group { margin-bottom: var(--space-5); }
.nav-group h4 {
  margin: 0 0 var(--space-2); font-size: var(--text-xs); text-transform: uppercase; letter-spacing: .08em;
  color: var(--color-text-faint); font-weight: 600;
}
.nav-group a {
  display: block; padding: .3rem var(--space-3); margin-left: calc(-1 * var(--space-3));
  border-radius: var(--radius-sm); color: var(--color-text-muted); font-size: var(--text-sm); line-height: 1.4;
}
.nav-group a:hover { color: var(--color-text); background: var(--color-surface-2); text-decoration: none; }
.nav-group a.active { color: var(--color-primary); background: var(--color-primary-soft); font-weight: 500; }

main { min-width: 0; padding: var(--space-10) clamp(var(--space-5), 4vw, var(--space-16)) var(--space-20); }
.content { max-width: 48rem; }

.toc {
  position: sticky; top: var(--header-h); height: calc(100dvh - var(--header-h)); overflow-y: auto;
  padding: var(--space-10) var(--space-5) var(--space-8) var(--space-2); font-size: var(--text-xs);
}
.toc h5 { margin: 0 0 var(--space-3); font-size: var(--text-xs); color: var(--color-text-faint); text-transform: uppercase; letter-spacing: .08em; font-weight: 600; }
.toc a { display: block; padding: .22rem 0 .22rem var(--space-3); color: var(--color-text-muted); border-left: 1px solid var(--color-divider); line-height: 1.4; }
.toc a:hover { color: var(--color-text); text-decoration: none; }
.toc a.active { color: var(--color-primary); border-left-color: var(--color-primary); }

/* ============ Typography in content ============ */
.hero { padding-bottom: var(--space-8); margin-bottom: var(--space-8); border-bottom: 1px solid var(--color-divider); }
.eyebrow { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-primary); letter-spacing: .04em; margin: 0 0 var(--space-3); }
h1 { font-size: var(--text-xl); line-height: 1.15; letter-spacing: -.015em; margin: 0 0 var(--space-4); font-weight: 600; }
.lead { font-size: var(--text-lg); color: var(--color-text-muted); margin: 0; max-width: 40rem; line-height: 1.5; }
section.doc { padding-top: var(--space-12); }
section.doc > h2 {
  font-size: var(--text-xl); font-weight: 600; letter-spacing: -.01em; line-height: 1.2;
  margin: 0 0 var(--space-4); display: flex; align-items: baseline; gap: var(--space-3);
}
section.doc > h2 .num { font-family: var(--font-mono); font-size: var(--text-sm); color: var(--color-text-faint); font-weight: 500; }
h3 { font-size: var(--text-lg); font-weight: 600; margin: var(--space-10) 0 var(--space-3); line-height: 1.3; }
h4 { font-size: var(--text-base); font-weight: 600; margin: var(--space-6) 0 var(--space-2); }
p { margin: 0 0 var(--space-4); }
ul, ol { margin: 0 0 var(--space-4); padding-left: var(--space-6); }
li { margin-bottom: var(--space-1); }
li::marker { color: var(--color-text-faint); }
strong { font-weight: 600; }
.anchor { opacity: 0; margin-left: var(--space-2); color: var(--color-text-faint); font-weight: 400; transition: opacity .15s; }
h2:hover .anchor, h3:hover .anchor { opacity: 1; }
.anchor:hover { color: var(--color-primary); text-decoration: none; }

:not(pre) > code {
  font-family: var(--font-mono); font-size: .86em; padding: .1em .38em; border-radius: 4px;
  background: var(--color-surface-2); border: 1px solid var(--color-divider); color: var(--color-text);
  overflow-wrap: anywhere;
}

/* ============ Code blocks ============ */
.code { position: relative; margin: 0 0 var(--space-5); border: 1px solid var(--color-border); border-radius: var(--radius-lg); background: var(--code-bg); overflow: hidden; }
.code-head {
  display: flex; align-items: center; justify-content: space-between; gap: var(--space-2);
  padding: var(--space-2) var(--space-2) var(--space-2) var(--space-4);
  border-bottom: 1px solid var(--color-border); font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-text-muted);
  background: color-mix(in srgb, var(--code-bg) 70%, var(--color-surface-2));
}
.copy-btn {
  border: 1px solid var(--color-border); background: var(--color-surface); color: var(--color-text-muted);
  font-size: var(--text-xs); padding: .15rem .6rem; border-radius: var(--radius-sm); cursor: pointer; font-family: var(--font-body);
}
.copy-btn:hover { color: var(--color-text); border-color: var(--color-primary); }
.copy-btn.done { color: var(--color-good); border-color: var(--color-good); }
pre { margin: 0; padding: var(--space-4); overflow-x: auto; font-family: var(--font-mono); font-size: .84rem; line-height: 1.6; color: var(--code-text); tab-size: 4; }
pre code { font-family: inherit; }
.hljs-keyword, .hljs-built_in, .hljs-literal { color: var(--hl-kw); }
.hljs-string, .hljs-attr + .hljs-string { color: var(--hl-str); }
.hljs-number { color: var(--hl-num); }
.hljs-comment { color: var(--hl-com); font-style: italic; }
.hljs-title, .hljs-title.class_, .hljs-type { color: var(--hl-type); }
.hljs-attr, .hljs-meta { color: var(--hl-attr); }
.hljs-title.function_ { color: var(--hl-fn); }
.hljs-section { color: var(--hl-type); font-weight: 600; }

/* ============ Callouts ============ */
.callout { display: grid; grid-template-columns: auto 1fr; gap: var(--space-3); padding: var(--space-4) var(--space-5); border-radius: var(--radius-lg); margin: 0 0 var(--space-5); border: 1px solid; font-size: var(--text-sm); }
.callout p:last-child, .callout ul:last-child { margin-bottom: 0; }
.callout .ic { width: 1.15rem; height: 1.15rem; margin-top: .2rem; }
.callout strong.t { display: block; margin-bottom: var(--space-1); font-size: var(--text-sm); }
.callout.info { background: var(--color-primary-soft); border-color: color-mix(in srgb, var(--color-primary) 30%, transparent); }
.callout.info .ic { color: var(--color-primary); }
.callout.warn { background: var(--color-warn-soft); border-color: color-mix(in srgb, var(--color-warn) 35%, transparent); }
.callout.warn .ic { color: var(--color-warn); }
.callout.bad { background: var(--color-bad-soft); border-color: color-mix(in srgb, var(--color-bad) 35%, transparent); }
.callout.bad .ic { color: var(--color-bad); }
.callout.good { background: var(--color-good-soft); border-color: color-mix(in srgb, var(--color-good) 35%, transparent); }
.callout.good .ic { color: var(--color-good); }

/* ============ Tables ============ */
.table-wrap { overflow-x: auto; margin: 0 0 var(--space-5); border: 1px solid var(--color-border); border-radius: var(--radius-lg); background: var(--color-surface); }
table { width: 100%; border-collapse: collapse; font-size: var(--text-sm); }
th, td { text-align: left; padding: var(--space-2) var(--space-4); border-bottom: 1px solid var(--color-divider); vertical-align: top; }
th { font-weight: 600; font-size: var(--text-xs); text-transform: uppercase; letter-spacing: .05em; color: var(--color-text-muted); background: var(--color-surface-2); white-space: nowrap; }
tr:last-child td { border-bottom: 0; }
td code { white-space: nowrap; }
td.wrap code { white-space: normal; }
.type { font-family: var(--font-mono); font-size: .8rem; color: var(--hl-type); white-space: nowrap; }
.def { font-family: var(--font-mono); font-size: .8rem; color: var(--color-text-muted); white-space: nowrap; }
.req { display: inline-block; font-size: .68rem; font-weight: 600; text-transform: uppercase; letter-spacing: .04em; color: var(--color-bad); margin-left: var(--space-1); }

/* ============ Cards / Steps / Misc ============ */
.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(14rem, 1fr)); gap: var(--space-4); margin: 0 0 var(--space-6); }
.card { display: block; padding: var(--space-5); background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-lg); color: var(--color-text); transition: border-color .15s, transform .15s var(--ease); }
a.card:hover { border-color: var(--color-primary); text-decoration: none; transform: translateY(-1px); }
.card h4 { margin: 0 0 var(--space-1); font-size: var(--text-base); }
.card p { margin: 0; color: var(--color-text-muted); font-size: var(--text-sm); }
.card .k { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-primary); margin-bottom: var(--space-2); display: block; }

ol.steps { list-style: none; padding: 0; counter-reset: s; margin: 0 0 var(--space-6); }
ol.steps > li { position: relative; padding-left: var(--space-10); margin-bottom: var(--space-5); counter-increment: s; }
ol.steps > li::before {
  content: counter(s); position: absolute; left: 0; top: 0; width: 1.75rem; height: 1.75rem; border-radius: 50%;
  display: grid; place-items: center; font-family: var(--font-mono); font-size: var(--text-xs); font-weight: 600;
  background: var(--color-primary-soft); color: var(--color-primary); border: 1px solid color-mix(in srgb, var(--color-primary) 35%, transparent);
}
ol.steps > li > strong:first-child { display: block; margin-bottom: var(--space-1); }

.tree { font-family: var(--font-mono); font-size: .82rem; line-height: 1.7; }
.tree .c { color: var(--hl-com); }

.flow { display: grid; gap: 0; margin: 0 0 var(--space-6); border: 1px solid var(--color-border); border-radius: var(--radius-lg); background: var(--color-surface); overflow: hidden; }
.flow-step { display: grid; grid-template-columns: 9.5rem 1fr; gap: var(--space-4); padding: var(--space-3) var(--space-5); border-bottom: 1px solid var(--color-divider); font-size: var(--text-sm); }
.flow-step:last-child { border-bottom: 0; }
.flow-step .when { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--color-primary); padding-top: .15rem; }
.flow-step p { margin: 0; }

.filter { display: flex; gap: var(--space-2); margin: 0 0 var(--space-3); }
.filter input {
  flex: 1; padding: var(--space-2) var(--space-3); border-radius: var(--radius-md); border: 1px solid var(--color-border);
  background: var(--color-surface); color: var(--color-text); font: inherit; font-size: var(--text-sm);
}
.filter input:focus { outline: none; border-color: var(--color-primary); box-shadow: 0 0 0 3px var(--color-primary-soft); }

details.faq { border: 1px solid var(--color-border); border-radius: var(--radius-lg); background: var(--color-surface); margin-bottom: var(--space-3); }
details.faq summary { cursor: pointer; padding: var(--space-3) var(--space-5); font-weight: 500; list-style: none; display: flex; justify-content: space-between; gap: var(--space-4); }
details.faq summary::-webkit-details-marker { display: none; }
details.faq summary::after { content: '+'; color: var(--color-text-faint); font-family: var(--font-mono); }
details.faq[open] summary::after { content: '–'; }
details.faq > div { padding: 0 var(--space-5) var(--space-4); font-size: var(--text-sm); }
details.faq > div p:last-child { margin-bottom: 0; }

.foot { margin-top: var(--space-20); padding-top: var(--space-6); border-top: 1px solid var(--color-divider); color: var(--color-text-faint); font-size: var(--text-xs); }

/* ============ Search modal ============ */
.search-overlay { position: fixed; inset: 0; z-index: 60; background: rgba(8,12,16,.45); backdrop-filter: blur(3px); display: none; align-items: flex-start; justify-content: center; padding: 10vh var(--space-4) var(--space-4); }
.search-overlay.open { display: flex; }
.search-box { width: min(40rem, 100%); max-height: 72vh; display: flex; flex-direction: column; background: var(--color-surface); border: 1px solid var(--color-border); border-radius: var(--radius-lg); box-shadow: var(--shadow); overflow: hidden; }
.search-input-row { display: flex; align-items: center; gap: var(--space-3); padding: var(--space-3) var(--space-4); border-bottom: 1px solid var(--color-divider); }
.search-input-row svg { color: var(--color-text-faint); flex: none; }
.search-input-row input { flex: 1; border: 0; outline: 0; background: transparent; color: var(--color-text); font: inherit; font-size: var(--text-base); padding: var(--space-1) 0; }
.search-results { overflow-y: auto; padding: var(--space-2); }
.result { display: block; padding: var(--space-2) var(--space-3); border-radius: var(--radius-md); color: var(--color-text); cursor: pointer; }
.result:hover, .result.sel { background: var(--color-primary-soft); text-decoration: none; }
.result .crumb { font-size: var(--text-xs); color: var(--color-text-faint); }
.result .ttl { font-weight: 500; font-size: var(--text-sm); }
.result .snip { font-size: var(--text-xs); color: var(--color-text-muted); display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
.result mark { background: color-mix(in srgb, var(--color-primary) 25%, transparent); color: inherit; border-radius: 2px; padding: 0 1px; }
.search-empty { padding: var(--space-8) var(--space-4); text-align: center; color: var(--color-text-muted); font-size: var(--text-sm); }
.search-foot { display: flex; gap: var(--space-4); padding: var(--space-2) var(--space-4); border-top: 1px solid var(--color-divider); font-size: var(--text-xs); color: var(--color-text-faint); }

.flash { animation: flash 1.6s var(--ease); }
@keyframes flash { 0%,30% { background: var(--color-primary-soft); } 100% { background: transparent; } }

/* ============ Responsive ============ */
@media (max-width: 1240px) {
  .layout { grid-template-columns: var(--sidebar-w) minmax(0,1fr); }
  .toc { display: none; }
}
@media (max-width: 860px) {
  .layout { grid-template-columns: minmax(0,1fr); }
  .menu-btn { display: grid; }
  .sidebar {
    position: fixed; top: var(--header-h); left: 0; width: min(19rem, 86vw); z-index: 40; background: var(--color-bg);
    transform: translateX(-102%); transition: transform .22s var(--ease); box-shadow: var(--shadow);
  }
  body.nav-open .sidebar { transform: none; }
  .search-btn { min-width: 0; }
  .search-btn .lbl, .search-btn kbd { display: none; }
  .flow-step { grid-template-columns: 1fr; gap: var(--space-1); }
  main { padding-top: var(--space-6); }
}
@media (prefers-reduced-motion: reduce) { * { transition: none !important; animation: none !important; } }
@media (max-width: 480px) {
  .topbar { gap: var(--space-2); padding: 0 var(--space-3); }
  .brand .ver { display: none; }
}
.lang-btn {
  display: grid; place-items: center; height: 2.25rem; min-width: 2.25rem; padding: 0 var(--space-2);
  border-radius: var(--radius-md); border: 1px solid var(--color-border);
  font-family: var(--font-mono); font-size: var(--text-xs); font-weight: 600; letter-spacing: .04em;
  color: var(--color-text-muted); transition: color .15s, border-color .15s;
}
.lang-btn:hover { color: var(--color-primary); border-color: var(--color-primary); text-decoration: none; }