:root{
  --bg:#faf7f1;
  --panel:#fffdf9;
  --ink:#2b2620;
  --ink-soft:#5d554b;
  --ink-faint:#8b8175;
  --line:#e7dfd2;
  --line-strong:#d8ccb8;
  --accent:#c0573a;
  --accent-dark:#a4452c;
  --accent-soft:#f6e7e0;
  --code-bg:#24211d;
  --code-ink:#ece6db;
  --code-mut:#a99f8f;
  --table-head:#f1e9dc;
  --callout-bg:#fbf3e6;
  --callout-bar:#d2a24c;
  --shadow:0 10px 30px -18px rgba(60,45,20,.35);
  --radius:14px;
  --sidebar-w:300px;
  --toc-w:248px;
  --serif:"Songti SC","Noto Serif SC","Source Han Serif SC",Georgia,"Times New Roman",serif;
  --sans:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei","Helvetica Neue",Arial,sans-serif;
  --mono:"JetBrains Mono","SFMono-Regular",ui-monospace,Menlo,Consolas,"Liberation Mono",monospace;
}
*{box-sizing:border-box}
html{scroll-behavior:smooth}
body{
  margin:0;background:var(--bg);color:var(--ink);
  font-family:var(--sans-serif);font-size:16px;line-height:1.8;
  -webkit-font-smoothing:antialiased;
}
a{color:var(--accent);text-decoration:none}
a:hover{color:var(--accent-dark)}
button{font-family:inherit;cursor:pointer}
::selection{background:var(--accent-soft)}
#progress-bar{position:fixed;top:0;left:0;height:3px;width:0;background:linear-gradient(90deg,var(--accent),#df8a5f);z-index:100;transition:width .12s linear}

/* layout */
#app{display:flex;min-height:100vh}
#sidebar{
  width:var(--sidebar-w);flex:0 0 var(--sidebar-w);
  background:var(--panel);border-right:1px solid var(--line);
  display:flex;flex-direction:column;position:sticky;top:0;height:100vh;
}
#main{flex:1;min-width:0;display:flex;flex-direction:column}
.layout{flex:1;display:flex;gap:34px;max-width:var(--layout-w,1280px);width:100%;margin:0 auto;padding:0 32px;align-items:flex-start}
.content{min-width:0;flex:1;max-width:var(--content-w,860px);padding:8px 0 60px}

/* sidebar */
.side-head{display:flex;align-items:center;gap:10px;padding:18px 16px;border-bottom:1px solid var(--line)}
.brand{display:flex;align-items:center;gap:10px;color:var(--ink);flex:1;min-width:0}
.brand:hover{color:var(--ink)}
.brand-mark{width:36px;height:36px;border-radius:10px;background:#fff;border:1px solid var(--line);object-fit:contain;padding:3px;flex:0 0 36px;box-shadow:0 2px 6px rgba(60,45,25,.08)}
.brand-text{display:flex;flex-direction:column;line-height:1.25;min-width:0}
.brand-text strong{font-size:14px;letter-spacing:.2px}
.brand-text small{color:var(--ink-faint);font-size:11px}
.icon-btn{border:1px solid transparent;background:transparent;color:var(--ink-soft);border-radius:9px;width:34px;height:34px;display:grid;place-items:center;padding:0}
.icon-btn:hover{background:#f2ebdd;color:var(--ink)}
.side-nav{flex:1;overflow-y:auto;padding:12px 10px 20px}
.side-section{margin-bottom:14px}
.side-section-title{display:flex;align-items:center;gap:8px;padding:8px 10px;font-size:12.5px;font-weight:700;letter-spacing:.6px;color:var(--ink-faint);text-transform:uppercase}
.side-group>.group-head{display:flex;align-items:center;gap:6px;width:100%;text-align:left;background:none;border:0;padding:7px 10px;border-radius:8px;color:var(--ink);font-size:14px;font-weight:600}
.side-group>.group-head:hover{background:#f4ede1}
.group-head .twist{transition:transform .15s;color:var(--ink-faint);font-size:11px;width:14px;text-align:center}
.side-group.collapsed .group-head .twist{transform:rotate(-90deg)}
.group-head .gname{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.group-kids{margin:2px 0 4px 14px;padding-left:9px;border-left:1px dashed var(--line-strong)}
.side-group.collapsed .group-kids{display:none}
.side-link{display:block;padding:6px 10px;border-radius:8px;color:var(--ink-soft);font-size:13.5px;line-height:1.45}
.side-link:hover{background:#f4ede1;color:var(--ink)}
.side-link.active{background:var(--accent-soft);color:var(--accent-dark);font-weight:600}
.side-leaf{margin:1px 0}
.side-foot{padding:12px 18px;border-top:1px solid var(--line);color:var(--ink-faint);font-size:11.5px}

/* topbar */
.topbar{display:flex;align-items:center;gap:14px;padding:14px 32px;position:sticky;top:0;background:rgba(250,247,241,.86);backdrop-filter:blur(8px);z-index:40;border-bottom:1px solid var(--line)}
.breadcrumb{flex:1;min-width:0;font-size:13px;color:var(--ink-faint);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.breadcrumb a{color:var(--ink-soft)}
.breadcrumb .sep{margin:0 7px;color:var(--line-strong)}
.breadcrumb .cur{color:var(--ink)}
.ghost-btn{border:1px solid var(--line-strong);background:var(--panel);border-radius:9px;padding:6px 12px;font-size:13px;color:var(--ink-soft);display:inline-flex;gap:8px;align-items:center}
.ghost-btn:hover{border-color:var(--accent);color:var(--accent)}
kbd{font-family:var(--mono);font-size:11px;background:#f1eadf;border:1px solid var(--line-strong);border-bottom-width:2px;border-radius:5px;padding:1px 5px;color:var(--ink-soft)}
.menu-btn{display:none}

/* home */
.home{max-width:1040px;margin:0 auto;padding:40px 0 20px}
.hero{padding:34px 4px 26px;display:flex;align-items:center;gap:34px}
.hero-logo{flex:0 0 120px;width:120px;height:120px;object-fit:contain;filter:drop-shadow(0 10px 18px rgba(60,45,25,.12))}
.hero-text{min-width:0;flex:1}
.hero h1{font-family:var(--serif);font-size:40px;line-height:1.25;margin:0 0 12px;letter-spacing:.5px}
.hero p{color:var(--ink-soft);font-size:17px;max-width:720px;margin:0}
.home-stats{display:flex;gap:12px;flex-wrap:wrap;margin:22px 0 8px}
.stat{background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:12px 18px;box-shadow:var(--shadow)}
.stat b{font-size:22px;color:var(--accent)}
.stat span{display:block;font-size:12.5px;color:var(--ink-faint)}
.section-cards{display:grid;grid-template-columns:repeat(2,1fr);gap:22px;margin-top:26px}
.section-card{display:block;background:var(--panel);border:1px solid var(--line);border-radius:18px;padding:26px;box-shadow:var(--shadow);color:var(--ink);transition:transform .15s,box-shadow .15s,border-color .15s}
.section-card:hover{transform:translateY(-3px);border-color:var(--accent);color:var(--ink)}
.section-card .idx{font-size:12px;font-weight:700;letter-spacing:1px;color:var(--accent)}
.section-card h2{font-family:var(--serif);font-size:25px;margin:8px 0 8px}
.section-card p{color:var(--ink-soft);font-size:14.5px;margin:0 0 16px}
.section-card .meta{font-size:13px;color:var(--ink-faint);display:flex;gap:16px;flex-wrap:wrap}

/* article */
.article-head{padding:26px 0 18px;border-bottom:1px solid var(--line);margin-bottom:26px}
.article-head h1{font-family:var(--serif);font-size:33px;line-height:1.3;margin:6px 0 0;letter-spacing:.3px}
.content h2{font-family:var(--serif);font-size:25px;margin:40px 0 14px;padding-top:8px}
.content h3{font-family:var(--serif);font-size:20px;margin:30px 0 10px}
.content h4{font-size:17px;margin:22px 0 8px}
.content h2 .anchor,.content h3 .anchor{color:var(--line-strong);opacity:0;margin-left:6px;font-size:.8em}
.content h2:hover .anchor,.content h3:hover .anchor{opacity:1}
.content p{margin:13px 0}
.content ul,.content ol{padding-left:24px;margin:13px 0}
.content li{margin:5px 0}
.content blockquote{margin:16px 0;padding:6px 16px;border-left:3px solid var(--line-strong);color:var(--ink-soft);background:#f6f1e8;border-radius:0 8px 8px 0}
.content hr{border:0;border-top:1px solid var(--line);margin:30px 0}
.content strong{font-weight:700}
.content a{border-bottom:1px solid rgba(192,87,58,.35)}
.content a:hover{border-bottom-color:var(--accent)}
.content img{max-width:100%;border-radius:10px}

/* inline code */
.content :not(pre)>code{font-family:var(--mono);font-size:.88em;background:#f0e8da;border:1px solid var(--line);border-radius:6px;padding:1.5px 6px;color:#8a3c26;white-space:normal;word-break:break-word}

/* code block */
.code-wrap{position:relative;margin:18px 0;border-radius:12px;background:var(--code-bg);box-shadow:var(--shadow)}
.code-wrap pre{margin:0;padding:18px 18px 16px;overflow:auto;max-height:none}
.code-wrap pre>code{
  display:block;font-family:var(--mono);font-size:13.5px;line-height:1.7;color:var(--code-ink);
  background:none;border:0;padding:0;white-space:pre-wrap;word-break:break-word;overflow-wrap:anywhere;
  tab-size:2;
}
.code-wrap .lang-tag{position:absolute;top:8px;left:14px;font-size:11px;color:var(--code-mut);letter-spacing:.5px;pointer-events:none}
.code-wrap .copy-btn{
  position:absolute;top:8px;right:8px;font-size:12px;color:var(--code-mut);
  background:rgba(255,255,255,.08);border:1px solid rgba(255,255,255,.14);border-radius:7px;padding:3px 10px;
}
.code-wrap .copy-btn:hover{color:#fff;background:rgba(255,255,255,.18)}
.code-wrap .copy-btn.done{color:#9ad29a;border-color:rgba(154,210,154,.4)}

/* tables */
.table-wrap{margin:18px 0;overflow-x:auto;border:1px solid var(--line);border-radius:12px;background:var(--panel)}
.table-wrap table{border-collapse:collapse;width:100%;font-size:14px;line-height:1.65}
.table-wrap th,.table-wrap td{border:1px solid var(--line);padding:9px 13px;text-align:left;vertical-align:top;min-width:72px}
.table-wrap thead th{background:var(--table-head);font-weight:700;white-space:nowrap}
.table-wrap tbody tr:nth-child(even of tr:not(.case-row)){background:#fbf7ef}
.table-wrap td.copyable{position:relative}
.copy-cell-btn{position:absolute;top:4px;right:4px;opacity:0;border:1px solid var(--line-strong);background:var(--panel);color:var(--ink-faint);border-radius:6px;font-size:11px;padding:1px 7px}
.table-wrap td.copyable:hover .copy-cell-btn{opacity:1}
.copy-cell-btn:hover{color:var(--accent);border-color:var(--accent)}

/* callout */
.callout{display:flex;gap:12px;background:var(--callout-bg);border:1px solid #eeddbb;border-left:4px solid var(--callout-bar);border-radius:0 12px 12px 0;padding:13px 16px;margin:18px 0}
.callout .callout-ico{flex:0 0 26px;font-size:18px;line-height:1.7}
.callout .callout-body{min-width:0;flex:1}
.callout .callout-body>:first-child{margin-top:0}
.callout .callout-body>:last-child{margin-bottom:0}

/* columns */
.columns{display:flex;gap:16px;margin:18px 0;flex-wrap:wrap}
.columns .col{flex:1 1 0;min-width:220px;background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:4px 16px 12px}
.columns .col>:first-child{margin-top:10px}

/* external cards */
.ext-card{display:flex;align-items:center;gap:14px;margin:18px 0;padding:16px 18px;background:var(--panel);border:1px solid var(--line);border-radius:12px;box-shadow:var(--shadow);color:var(--ink)}
.ext-card:hover{border-color:var(--accent);transform:translateY(-1px)}
.ext-card .ext-badge{flex:0 0 44px;height:44px;border-radius:11px;display:grid;place-items:center;font-weight:800;color:#fff;font-size:13px;letter-spacing:.5px}
.ext-card.figma .ext-badge{background:#a259ff}
.ext-card.demo .ext-badge{background:#2f9e6e}
.ext-card .ext-meta b{display:block;font-size:15px}
.ext-card .ext-meta span{font-size:12.5px;color:var(--ink-faint)}
.ext-card .ext-go{margin-left:auto;color:var(--ink-faint)}

/* mermaid diagrams */
.diagram{margin:22px 0;background:var(--panel);border:1px solid var(--line);border-radius:14px;padding:20px;box-shadow:var(--shadow);text-align:center;overflow-x:auto}
.diagram .mermaid{display:inline-block;min-width:0;font-family:var(--sans)}
.diagram.is-fallback{text-align:left}
.diagram pre.mermaid-src{margin:0;font-family:var(--mono);font-size:12.5px;white-space:pre-wrap;word-break:break-word;background:#f6f1e8;padding:14px;border-radius:8px;color:var(--ink-soft)}

/* pager */
.pager{display:flex;gap:14px;max-width:1280px;width:100%;margin:0 auto;padding:18px 32px 10px}
.pager a{flex:1;background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:13px 16px;color:var(--ink);box-shadow:var(--shadow)}
.pager a:hover{border-color:var(--accent)}
.pager .pager-label{display:block;font-size:11.5px;color:var(--ink-faint)}
.pager .next{text-align:right}
.pager .pager-title{font-size:14px;font-weight:600;margin-top:2px}

/* toc */
.toc-wrap{flex:0 0 var(--toc-w);width:var(--toc-w);position:sticky;top:72px;max-height:calc(100vh - 92px);overflow-y:auto;padding:16px 0}
.toc-head{display:flex;align-items:center;justify-content:space-between;padding:0 10px 8px 12px}
.toc-head-title{font-size:11.5px;letter-spacing:1px;color:var(--ink-faint);text-transform:uppercase;font-weight:700}
.toc-collapse-btn{display:grid;place-items:center;width:24px;height:24px;border-radius:6px;border:1px solid transparent;background:none;color:var(--ink-faint)}
.toc-collapse-btn:hover{color:var(--ink);border-color:var(--line);background:var(--panel)}
.toc{font-size:13px;border-left:1px solid var(--line)}
.toc a{display:block;padding:4px 12px;color:var(--ink-faint);border-left:2px solid transparent;margin-left:-1px;line-height:1.5}
.toc a.lvl3{padding-left:24px;font-size:12.5px}
.toc a:hover{color:var(--ink)}
.toc a.active{color:var(--accent);border-left-color:var(--accent);font-weight:600}
.site-foot{max-width:1280px;width:100%;margin:0 auto;padding:22px 32px 40px;color:var(--ink-faint);font-size:12.5px;border-top:1px solid var(--line)}

/* search */
.search-overlay[hidden]{display:none}
.search-overlay{position:fixed;inset:0;background:rgba(40,32,20,.42);z-index:90;display:flex;justify-content:center;padding:8vh 16px 0;backdrop-filter:blur(2px)}
.search-box{background:var(--panel);width:100%;max-width:640px;border-radius:16px;box-shadow:0 30px 70px -20px rgba(0,0,0,.5);overflow:hidden;align-self:flex-start;display:flex;flex-direction:column;max-height:78vh}
.search-input-row{display:flex;align-items:center;gap:10px;padding:15px 18px;border-bottom:1px solid var(--line);color:var(--ink-faint)}
.search-input-row input{flex:1;border:0;outline:0;background:none;font-size:16px;color:var(--ink);font-family:inherit}
.search-results{overflow-y:auto;padding:8px;flex:1}
.search-item{display:block;width:100%;text-align:left;background:none;border:0;border-radius:10px;padding:10px 12px;color:var(--ink)}
.search-item.sel,.search-item:hover{background:var(--accent-soft)}
.search-item .si-crumb{font-size:11.5px;color:var(--ink-faint)}
.search-item .si-title{font-weight:600;font-size:14.5px;margin:2px 0}
.search-item .si-snip{font-size:12.5px;color:var(--ink-soft);line-height:1.5;overflow:hidden;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}
.search-item mark{background:#ffe08a;padding:0 2px;border-radius:3px}
.search-empty{padding:26px;text-align:center;color:var(--ink-faint);font-size:14px}
.search-hint{padding:10px 18px;border-top:1px solid var(--line);font-size:11.5px;color:var(--ink-faint);display:flex;gap:6px;align-items:center}

.sidebar-mask{display:none}
.empty-note{color:var(--ink-faint);font-size:13px;padding:6px 10px}

/* responsive */
@media (max-width:1100px){
  .toc-wrap{display:none}
}
@media (max-width:860px){
  body{font-size:15px}
  #sidebar{position:fixed;left:0;top:0;bottom:0;z-index:70;transform:translateX(-100%);transition:transform .22s ease;box-shadow:0 0 40px rgba(0,0,0,.2)}
  #sidebar.open{transform:none}
  .sidebar-mask{display:none;position:fixed;inset:0;background:rgba(40,32,20,.4);z-index:60}
  .sidebar-mask.show{display:block}
  .menu-btn{display:grid}
  .topbar{padding:12px 16px}
  .layout{padding:0 16px;gap:0}
  .pager{padding:14px 16px 6px;flex-direction:column}
  .pager .next{text-align:left}
  .site-foot{padding:20px 16px 34px}
  .hero h1{font-size:30px}
  .section-cards{grid-template-columns:1fr;gap:16px}
  .article-head h1{font-size:26px}
  .content h2{font-size:21px}
  .columns .col{min-width:100%}
  .ghost-btn kbd{display:none}
}

/* 首屏加载占位 */
.boot-loading{display:flex;align-items:center;justify-content:center;gap:12px;min-height:40vh;color:var(--muted,#8a8072);font-size:15px;letter-spacing:.04em}
.boot-loading img{width:40px;height:40px;object-fit:contain;animation:bootbob 1.1s ease-in-out infinite}
@keyframes bootbob{0%,100%{transform:translateY(0) rotate(-2deg)}50%{transform:translateY(-5px) rotate(2deg)}}

/* 首页吉祥物移动端堆叠 */
@media (max-width:720px){
  .hero{flex-direction:column-reverse;align-items:flex-start;gap:18px;text-align:left}
  .hero-logo{flex-basis:84px;width:84px;height:84px}
  .hero h1{font-size:30px}
}

/* 桌面端：左侧导航 / 右侧目录可收起 */
@media (min-width:861px){
  #sidebar{transition:flex-basis .22s ease,width .22s ease,border-color .22s ease;overflow:hidden}
  body.side-collapsed #sidebar{flex-basis:0;width:0;border-right-color:transparent}
  body.side-collapsed .menu-btn{display:grid}
  /* 收起后内容区随之拓宽并居中，阅读宽度随收起档位递增 */
  body.side-collapsed{--layout-w:1380px;--content-w:920px}
  body.toc-collapsed{--layout-w:1420px;--content-w:1010px}
  body.side-collapsed.toc-collapsed{--layout-w:1560px;--content-w:1180px}
  body.side-collapsed .content,body.toc-collapsed .content{margin-left:auto;margin-right:auto}
  /* 收起后 topbar 左侧留出展开按钮位 */
  .side-head{white-space:nowrap}
  body.toc-collapsed .toc-wrap{display:none !important}
  .ghost-btn.toc-toggle{padding:5px 12px;font-size:13px}
}
/* 窄屏无右侧目录，隐藏其切换按钮；目录收起时高亮切换钮 */
@media (max-width:1100px){
  .ghost-btn.toc-toggle{display:none !important}
}
body.toc-collapsed .ghost-btn.toc-toggle{color:var(--accent);border-color:var(--accent)}

/* ========== 正文术语内嵌案例 ========== */
.table-wrap tbody tr.case-row > td{background:transparent;border:0;padding:0}
.case-inline{margin:0;background:#fffdf9;border-top:1px dashed var(--line-strong)}
.case-toggle{width:100%;display:flex;align-items:center;gap:10px;padding:9px 14px;background:transparent;border:0;text-align:left;color:var(--ink-soft);font-family:inherit}
.case-toggle:hover{background:#fdf3ed}
.case-bulb{font-size:14px;line-height:1;flex:0 0 auto}
.case-term{font-weight:700;color:var(--accent-dark);font-size:13px;white-space:nowrap;flex:0 0 auto}
.case-label{color:var(--ink-faint);font-size:12.5px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:1;min-width:0}
.case-chev{color:var(--ink-faint);transition:transform .2s ease;flex:0 0 auto}
.case-toggle[aria-expanded="true"]{background:#fdf3ed}
.case-toggle[aria-expanded="true"] .case-chev{transform:rotate(180deg)}
.case-panel{border-top:1px solid var(--line);background:#fdfaf4}
.case-body{padding:14px 16px 16px;display:flex;flex-direction:column;gap:13px}
.case-product{display:flex;gap:10px;align-items:flex-start}
.case-k{flex:0 0 auto;font-size:11px;font-weight:700;color:#fff;background:var(--accent);border-radius:6px;padding:2px 8px;margin-top:2px;letter-spacing:.5px}
.case-prod{display:block;font-size:13.5px;color:var(--ink);line-height:1.5}
.case-note{margin:4px 0 0;font-size:13px;color:var(--ink-soft);line-height:1.75}
.case-code{margin:0}
.case-code pre{padding-top:30px;max-height:360px}

/* 可交互 Demo 运行器（默认折叠，点击才注入沙箱） */
.demo-runner{border:1px solid var(--line);border-radius:12px;overflow:hidden;background:#fff}
.demo-run-btn{width:100%;display:flex;align-items:center;justify-content:center;gap:8px;padding:11px;border:0;background:#f3ece0;color:var(--accent-dark);font-size:13.5px;font-weight:600;font-family:inherit}
.demo-run-btn:hover{background:#fbe9e0}
.demo-run-btn[hidden]{display:none}
.demo-play{font-size:10px}
.demo-stage{background:#faf7f1}
.demo-bar{display:flex;align-items:center;justify-content:space-between;gap:10px;padding:7px 12px;background:#f1e9dc;border-bottom:1px solid var(--line);font-size:12px;color:var(--ink-faint)}
.demo-stop{border:1px solid var(--line-strong);background:#fff;border-radius:6px;font-size:11.5px;padding:2px 10px;color:var(--ink-soft);font-family:inherit;flex:0 0 auto}
.demo-stop:hover{color:var(--accent);border-color:var(--accent)}
.demo-frame{display:block;width:100%;height:420px;border:0;background:#faf7f1}
@media (max-width:720px){
  .demo-frame{height:360px}
  .case-label{display:none}
  .case-term{white-space:normal}
}