/* =========================================================
 *  style.css
 *  風格：莫蘭迪（Morandi）低飽和配色 + 手繪素描質感
 *  Light = 米灰紙張 / Dark = 暖灰炭筆
 * ========================================================= */

:root{
  /* ---- 莫蘭迪 淺色（紙張） ---- */
  --bg:#F5F5F5;            /* 淺灰背景 */
  --panel:#FFFFFF;         /* 內容面板 */
  --panel2:#F0F0F0;        /* 次級底色 */
  --line:#D6D6D6;          /* 細分隔線 */
  --line2:#A8A8A8;         /* 深分隔線 */
  --txt:#1F1F1F;           /* 主要文字 */
  --txt2:#606060;          /* 次要文字 */
  --txt3:#8A8A8A;          /* 提示文字 */

  --brand:#2A2A2A;         /* 黑色主色 */
  --brand2:#505050;
  --brandbg:#E8E8E8;

  --clay:#4A4A4A;          /* 深灰提醒色 */
  --claybg:#EDEDED;
  --blue:#606060;          /* 中灰輔助色 */
  --bluebg:#E9E9E9;
  --mustard:#5A5A5A;       /* 灰黑標記色 */
  --mustardbg:#ECECEC;
  --lilac:#666666;         /* 灰色輔助色 */
  --lilacbg:#E8E8E8;

  --code-bg:#F1F1F1;
  --code-line:#D7D7D7;
  --kw:#333333;            /* 關鍵字 */
  --str:#555555;           /* 字串 */
  --cmt:#888888;           /* 註解 */
  --num:#666666;           /* 數字 */

  --mark:#E0E0E0;
  --ink-shadow:2px 2px 0 rgba(0,0,0,.10);
  --ink-shadow-lg:3px 3px 0 rgba(0,0,0,.08);

  --nav-w:286px; --toc-w:216px; --head-h:58px;

  /* 手寫感字體（Windows 內建標楷體；無則退回一般字體） */
  --font-hand:"DFKai-SB","標楷體","KaiTi","Segoe Print","Bradley Hand",
              "Microsoft JhengHei","PingFang TC",sans-serif;
  --font-body:"Segoe UI","Microsoft JhengHei","PingFang TC","Noto Sans TC",
              "Helvetica Neue",Arial,sans-serif;
  --font-mono:"Cascadia Mono",Consolas,"Courier New",monospace;

  /* 不規則邊角（手繪感） */
  --r-hand:14px 7px 16px 9px/9px 16px 7px 14px;
  --r-hand2:9px 15px 7px 13px/13px 7px 15px 9px;
  --r-soft:10px 6px 11px 7px/7px 11px 6px 10px;
}

html[data-theme="dark"]{
  --bg:#171717;
  --panel:#222222;
  --panel2:#2C2C2C;
  --line:#454545;
  --line2:#626262;
  --txt:#F1F1F1;
  --txt2:#C8C8C8;
  --txt3:#999999;

  --brand:#E2E2E2;
  --brand2:#FFFFFF;
  --brandbg:#3A3A3A;

  --clay:#D0D0D0;  --claybg:#3A3A3A;
  --blue:#BDBDBD;  --bluebg:#343434;
  --mustard:#D7D7D7; --mustardbg:#424242;
  --lilac:#C4C4C4; --lilacbg:#383838;

  --code-bg:#1E1E1E;
  --code-line:#3F3F3F;
  --kw:#E4E4E4;
  --str:#C8C8C8;
  --cmt:#8E8E8E;
  --num:#D2D2D2;

  --mark:#575757;
  --ink-shadow:2px 2px 0 rgba(0,0,0,.30);
  --ink-shadow-lg:3px 3px 0 rgba(0,0,0,.26);
}

*{box-sizing:border-box}
html,body{margin:0;padding:0}

body{
  background-color:var(--bg);
  /* 紙張纖維紋理（SVG 雜訊，離線內嵌） */
  background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='180' height='180'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='3' stitchTiles='stitch'/><feColorMatrix type='saturate' values='0'/></filter><rect width='180' height='180' filter='url(%23n)' opacity='0.05'/></svg>");
  color:var(--txt);
  font:15px/1.8 var(--font-body);
  -webkit-font-smoothing:antialiased;
}
html[data-theme="dark"] body{background-blend-mode:overlay}

a{color:var(--brand);text-decoration:none}
a:hover{color:var(--clay)}

/* 手繪底線（波浪 SVG） */
.doc a:not(.anchor){
  background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='30' height='4'><path d='M0 2.6 q3.5 -2 7 0 t7 0 t7 0 t7 0' fill='none' stroke='%234A4A4A' stroke-width='1.1' opacity='.75'/></svg>");
  background-repeat:repeat-x;background-position:0 100%;padding-bottom:2px;
}
.doc a:not(.anchor):hover{background-position:0 95%}

/* ---------- 頂欄 ---------- */
header.top{
  position:fixed;inset:0 0 auto 0;height:var(--head-h);z-index:50;
  display:flex;align-items:center;gap:14px;padding:0 16px;
  background:var(--panel);
  border-bottom:2px solid var(--line);
}
.brand{display:flex;align-items:center;gap:10px;min-width:220px}
.logo{
  width:32px;height:32px;flex:0 0 auto;
  background:var(--brandbg);
  border:2px solid var(--brand);
  border-radius:var(--r-hand2);
  display:flex;align-items:center;justify-content:center;
  color:var(--brand);font-weight:700;font-size:15px;
  font-family:var(--font-hand);
  transform:rotate(-2.5deg);
  box-shadow:var(--ink-shadow);
  cursor:pointer;
}
#site-title{font-size:16px;font-weight:700;line-height:1.25;font-family:var(--font-hand);
  letter-spacing:.5px}
#site-sub{font-size:11.5px;color:var(--txt3);line-height:1.2}

.search-box{position:relative;flex:1;max-width:560px}
#search{
  width:100%;height:36px;padding:0 12px 0 34px;
  border:2px solid var(--line);
  border-radius:var(--r-soft);
  background:var(--panel2);color:var(--txt);
  font-size:13.5px;font-family:var(--font-body);outline:none;
  transition:border-color .15s;
}
#search:focus{border-color:var(--brand);background:var(--panel);box-shadow:var(--ink-shadow)}
.search-box::before{
  content:"";position:absolute;left:12px;top:11px;width:12px;height:12px;
  border:1.8px solid var(--txt3);border-radius:50%;opacity:.8;pointer-events:none;
}
.search-box::after{
  content:"";position:absolute;left:22px;top:22px;width:7px;height:1.8px;
  background:var(--txt3);transform:rotate(45deg);opacity:.8;pointer-events:none;
}
#results{
  position:absolute;top:44px;left:0;right:0;max-height:62vh;overflow:auto;
  background:var(--panel);border:2px solid var(--line2);
  border-radius:var(--r-hand);box-shadow:var(--ink-shadow-lg);z-index:80;
}
.res-info{padding:9px 13px;font-size:12px;color:var(--txt3);
  border-bottom:1.5px dashed var(--line)}
.res{padding:10px 13px;cursor:pointer;border-bottom:1.5px dashed var(--line)}
.res:last-child{border-bottom:0}
.res:hover{background:var(--brandbg)}
.res-t{font-weight:700;font-size:13.5px;font-family:var(--font-hand)}
.res-p{font-size:11.5px;color:var(--txt3);margin:1px 0 3px}
.res-s{font-size:12.5px;color:var(--txt2);line-height:1.6}
.res-s mark,mark{background:var(--mark);color:inherit;border-radius:3px;padding:0 3px}

.tools{margin-left:auto;display:flex;gap:7px}
.tools button,#menu-btn{
  height:33px;min-width:36px;padding:0 11px;cursor:pointer;
  border:2px solid var(--line);
  border-radius:var(--r-soft);
  background:var(--panel2);color:var(--txt2);
  font-size:13px;font-family:var(--font-body);
  transition:all .13s;
}
.tools button:hover,#menu-btn:hover{
  background:var(--brandbg);color:var(--brand);border-color:var(--brand);
  box-shadow:var(--ink-shadow);transform:translate(-1px,-1px);
}
#menu-btn{display:none}

/* ---------- 左側選單 ---------- */
nav.side{
  position:fixed;top:var(--head-h);left:0;bottom:0;width:var(--nav-w);
  overflow:auto;background:var(--panel);
  border-right:2px solid var(--line);padding:14px 10px 40px;
}
.side-h{
  display:flex;align-items:center;justify-content:space-between;
  padding:4px 10px 10px;font-size:11.5px;color:var(--txt3);letter-spacing:1px;
  font-family:var(--font-hand);
}
.grp{margin-bottom:4px}
.grp-h{
  display:flex;align-items:center;gap:8px;padding:8px 10px;
  border-radius:var(--r-soft);cursor:pointer;
  font-size:14px;font-weight:700;color:var(--txt);
  font-family:var(--font-hand);letter-spacing:.4px;
  border:2px solid transparent;
}
.grp-h:hover{background:var(--panel2);border-color:var(--line)}
.grp.open>.grp-h{background:var(--brandbg);border-color:var(--brand)}
.caret{font-size:10px;color:var(--txt3);transition:transform .16s}
.grp.open .caret{transform:rotate(90deg)}
.grp-name{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
.grp-cnt{
  font-size:11px;color:var(--txt2);background:var(--panel2);
  border:1.5px solid var(--line);border-radius:9px;padding:0 7px;
}
.grp-b{display:none;padding:4px 0 8px 16px;
  border-left:1.5px dashed var(--line);margin-left:14px}
.grp.open .grp-b{display:block}
.doc-link{
  display:block;padding:5px 10px;border-radius:var(--r-soft);
  font-size:13px;color:var(--txt2);
  white-space:normal;overflow-wrap:anywhere;word-break:break-word;
  border:2px solid transparent;
}
.doc-link:hover{background:var(--panel2);color:var(--txt);border-color:var(--line)}
.doc-link.active{
  background:var(--claybg);color:var(--clay);font-weight:700;
  border-color:var(--clay);box-shadow:var(--ink-shadow);
}

/* ---------- 主內容 ---------- */
main{
  margin:var(--head-h) var(--toc-w) 0 var(--nav-w);
  padding:20px 36px 90px;max-width:1030px;
}
#crumb{font-size:12.5px;color:var(--txt3);margin-bottom:16px}
#crumb i{font-style:normal;margin:0 5px;color:var(--line2)}
#crumb b{color:var(--txt2)}
.loading{padding:44px;color:var(--txt3)}

.doc h1,.doc h2,.doc h3{font-family:var(--font-hand);letter-spacing:.6px}
.doc h1,.doc h2,.doc h3,.doc h4,.doc h5,.doc h6{
  line-height:1.45;margin:1.8em 0 .7em;font-weight:700;scroll-margin-top:74px;
}
.doc h1{
  font-size:29px;margin-top:.2em;padding-bottom:12px;
  border-bottom:0;position:relative;
}
.doc h1::after{
  content:"";position:absolute;left:0;right:0;bottom:0;height:7px;
  background:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='120' height='7'><path d='M0 4 q15 -3.5 30 0 t30 0 t30 0 t30 0' fill='none' stroke='%232A2A2A' stroke-width='2.2'/></svg>") repeat-x;
}
html[data-theme="dark"] .doc h1::after{
  background:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='120' height='7'><path d='M0 4 q15 -3.5 30 0 t30 0 t30 0 t30 0' fill='none' stroke='%23E2E2E2' stroke-width='2.2'/></svg>") repeat-x;
}
.doc h2{
  font-size:22px;padding:2px 0 7px;
  border-bottom:2px dashed var(--line);
}
.doc h3{font-size:18px;color:var(--clay)}
.doc h4{font-size:15.5px;color:var(--txt2)}
.anchor{opacity:0;margin-left:8px;color:var(--txt3);font-weight:400;font-size:.78em}
.doc h1:hover .anchor,.doc h2:hover .anchor,
.doc h3:hover .anchor,.doc h4:hover .anchor{opacity:1}

.doc p{margin:.9em 0}
.doc ul,.doc ol{margin:.75em 0;padding-left:1.8em}
.doc li{margin:.3em 0}
.doc ul li::marker{color:var(--brand)}
.doc ol li::marker{color:var(--brand);font-weight:700}
.doc li.task{list-style:none;margin-left:-1.3em}
.doc li.task input{accent-color:var(--brand);margin-right:6px}
.doc hr{
  border:0;height:6px;margin:2em 0;
  background:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='120' height='6'><path d='M0 3 q15 -2.5 30 0 t30 0 t30 0 t30 0' fill='none' stroke='%23D6D6D6' stroke-width='1.8'/></svg>") repeat-x;
}
.doc img{max-width:100%;border:2px solid var(--line);border-radius:var(--r-soft)}

.doc code.inline{
  background:var(--claybg);border:1.5px solid var(--line);
  border-radius:5px 3px 6px 4px/4px 6px 3px 5px;
  padding:1px 6px;font-size:.87em;color:var(--clay);
  font-family:var(--font-mono);
}

/* 引言 / 提示框 */
blockquote.bq{
  margin:1.1em 0;padding:12px 18px;
  border:2px solid var(--line);border-left-width:5px;
  border-radius:var(--r-soft);
  background:var(--panel2);color:var(--txt2);
  box-shadow:var(--ink-shadow);
}
blockquote.bq p{margin:.35em 0}
blockquote.note{border-color:var(--blue);background:var(--bluebg);color:var(--txt)}
blockquote.warn{border-color:var(--clay);background:var(--claybg);color:var(--txt)}
blockquote.tip{border-color:var(--brand);background:var(--brandbg);color:var(--txt)}

/* 表格 */
.table-wrap{
  overflow-x:auto;margin:1.2em 0;
  border:2px solid var(--line2);border-radius:var(--r-hand);
  background:var(--panel);box-shadow:var(--ink-shadow);
}
.doc table{border-collapse:collapse;width:100%;font-size:13.5px}
.doc th,.doc td{
  padding:9px 13px;
  border-bottom:1.5px dashed var(--line);
  border-right:1.5px dashed var(--line);
}
.doc th{
  background:var(--brandbg);font-weight:700;white-space:nowrap;
  font-family:var(--font-hand);letter-spacing:.4px;color:var(--txt);
  border-bottom:2px solid var(--line2);
}
.doc tr:last-child td{border-bottom:0}
.doc th:last-child,.doc td:last-child{border-right:0}
.doc tbody tr:nth-child(even){background:rgba(0,0,0,.018)}
html[data-theme="dark"] .doc tbody tr:nth-child(even){background:rgba(255,255,255,.022)}
.doc tbody tr:hover{background:var(--mustardbg)}

/* 程式碼 */
.code-wrap{
  margin:1.2em 0;border:2px solid var(--code-line);
  border-radius:var(--r-hand);overflow:hidden;
  box-shadow:var(--ink-shadow);background:var(--code-bg);
}
.code-bar{
  display:flex;align-items:center;justify-content:space-between;
  padding:6px 12px;background:var(--panel2);
  border-bottom:1.5px dashed var(--code-line);
}
.code-lang{font-size:11px;color:var(--txt3);text-transform:uppercase;letter-spacing:1px}
.code-copy{
  border:1.5px solid var(--line);background:var(--panel);color:var(--txt2);
  border-radius:6px 4px 7px 5px/5px 7px 4px 6px;
  font-size:11.5px;padding:2px 10px;cursor:pointer;font-family:var(--font-body);
}
.code-copy:hover{color:var(--brand);border-color:var(--brand);background:var(--brandbg)}
pre.code{
  margin:0;padding:14px 16px;overflow-x:auto;background:var(--code-bg);
  font:13px/1.7 var(--font-mono);
}
pre.code code{white-space:pre}
.tok-kw{color:var(--kw);font-weight:700}
.tok-str{color:var(--str)}
.tok-cmt{color:var(--cmt);font-style:italic}
.tok-num{color:var(--num)}

/* 手繪流程圖 */
.mermaid-box{margin:1.3em 0}
.flow-wrap{
  position:relative;border:2px solid var(--line);
  border-radius:var(--r-hand);background:var(--panel);
  padding:16px 12px;overflow-x:auto;text-align:center;
  box-shadow:var(--ink-shadow);
}
svg.flow{display:inline-block}
.flow-src-btn{
  position:absolute;top:9px;right:11px;
  border:1.5px solid var(--line);background:var(--panel2);color:var(--txt3);
  border-radius:6px 4px 7px 5px/5px 7px 4px 6px;
  font-size:11px;padding:2px 9px;cursor:pointer;font-family:var(--font-body);
}
.flow-src-btn:hover{color:var(--brand);border-color:var(--brand)}

svg.flow .node-fill{fill:var(--brandbg)}
svg.flow .node-stroke{fill:none;stroke:var(--brand);stroke-width:1.7;
  stroke-linecap:round;stroke-linejoin:round;opacity:.9}
svg.flow .node-diamond-fill{fill:var(--mustardbg)}
svg.flow .node-diamond-stroke{fill:none;stroke:var(--mustard);stroke-width:1.7;
  stroke-linecap:round;opacity:.9}
svg.flow .node-circle-fill{fill:var(--claybg)}
svg.flow .node-circle-stroke{fill:none;stroke:var(--clay);stroke-width:1.7;
  stroke-linecap:round;opacity:.9}
svg.flow .node-db-fill{fill:var(--lilacbg)}
svg.flow .node-db-stroke{fill:none;stroke:var(--lilac);stroke-width:1.7;
  stroke-linecap:round;opacity:.9}
svg.flow .node-round-fill{fill:var(--bluebg)}
svg.flow .node-round-stroke{fill:none;stroke:var(--blue);stroke-width:1.7;
  stroke-linecap:round;opacity:.9}
svg.flow .node-lbl{
  fill:var(--txt);font-size:13.5px;text-anchor:middle;
  font-family:var(--font-hand);letter-spacing:.4px;
}
svg.flow .edge{fill:none;stroke:var(--line2);stroke-width:1.8;stroke-linecap:round}
svg.flow .edge-dash{stroke-dasharray:6 5}
svg.flow .edge-thick{stroke-width:3}
svg.flow .arrow-head{fill:var(--line2)}
svg.flow .edge-lbl{fill:var(--txt2);font-size:11.5px;text-anchor:middle;
  font-family:var(--font-body)}
svg.flow .edge-lbl-bg{fill:var(--panel);stroke:var(--line);stroke-width:1.2}

.mermaid-src{
  margin:12px 0 0;padding:11px;background:var(--code-bg);
  border:1.5px dashed var(--line);border-radius:var(--r-soft);
  font:12px/1.65 var(--font-mono);overflow-x:auto;color:var(--txt2);text-align:left;
}

.doc-foot{
  margin-top:48px;padding-top:14px;font-size:12px;color:var(--txt3);
  border-top:2px dashed var(--line);
}
.err{
  padding:28px;border:2px solid var(--clay);border-radius:var(--r-hand);
  background:var(--claybg);box-shadow:var(--ink-shadow);
}
.err h2{margin-top:0;color:var(--clay);font-family:var(--font-hand)}

/* ---------- 右側目錄 ---------- */
aside.toc{
  position:fixed;top:var(--head-h);right:0;bottom:0;width:var(--toc-w);
  overflow:auto;padding:24px 14px 60px;
  border-left:2px dashed var(--line);
}
.toc-h{font-size:11.5px;color:var(--txt3);letter-spacing:1px;margin-bottom:10px;
  font-family:var(--font-hand)}
.toc-i{
  display:block;font-size:12.5px;color:var(--txt2);padding:4px 9px;
  border-left:2px solid var(--line);line-height:1.5;
  overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
.toc-i:hover{color:var(--brand);background:var(--brandbg)}
.toc-i.lv1{padding-left:19px}
.toc-i.lv2{padding-left:29px;font-size:12px}
.toc-i.on{
  color:var(--clay);border-left:3px solid var(--clay);
  font-weight:700;background:var(--claybg);
}

/* ---------- 首頁 ---------- */
.home h1{font-size:32px;margin:14px 0 6px;font-family:var(--font-hand);letter-spacing:1px}
.home-sub{color:var(--txt2);margin:0 0 24px;font-size:14px}
.stats{display:flex;gap:14px;margin-bottom:30px;flex-wrap:wrap}
.stat{
  background:var(--panel);border:2px solid var(--line2);
  border-radius:var(--r-hand);padding:13px 22px;min-width:108px;
  box-shadow:var(--ink-shadow);
}
.stat:nth-child(1){transform:rotate(-1.2deg)}
.stat:nth-child(2){transform:rotate(.8deg)}
.stat:nth-child(3){transform:rotate(-.6deg)}
.stat b{display:block;font-size:27px;color:var(--brand);line-height:1.2;
  font-family:var(--font-hand)}
.stat:nth-child(2) b{color:var(--clay)}
.stat:nth-child(3) b{color:var(--blue)}
.stat span{font-size:12px;color:var(--txt3)}

.cards{display:grid;grid-template-columns:repeat(auto-fill,minmax(252px,1fr));gap:18px}
.card{
  background:var(--panel);border:2px solid var(--line2);
  border-radius:var(--r-hand);padding:15px 18px;
  box-shadow:var(--ink-shadow-lg);
  transition:transform .14s,border-color .14s,box-shadow .14s;
}
.card:nth-child(3n+1){transform:rotate(-.7deg)}
.card:nth-child(3n+2){transform:rotate(.5deg)}
.card:nth-child(3n){transform:rotate(-.4deg)}
.card:hover{
  transform:translate(-2px,-3px) rotate(0deg);
  border-color:var(--clay);box-shadow:5px 6px 0 rgba(120,108,92,.16);
}
.card h3{margin:0 0 10px;font-size:16.5px;font-family:var(--font-hand);
  letter-spacing:.5px;color:var(--brand)}
.card-files{display:flex;flex-direction:column;gap:4px}
.card-files a{font-size:12.8px;color:var(--txt2)}
.card-files a:hover{color:var(--clay)}
.more{font-size:12px;color:var(--txt3)}
.card-foot{
  margin-top:11px;font-size:11.5px;color:var(--txt3);
  border-top:1.5px dashed var(--line);padding-top:8px;
}

/* ---------- RWD ---------- */
@media (max-width:1180px){
  aside.toc{display:none}
  main{margin-right:0}
}
@media (max-width:860px){
  #menu-btn{display:block}
  .brand{min-width:auto} #site-sub{display:none}
  nav.side{transform:translateX(-100%);transition:transform .22s;z-index:60;
    box-shadow:var(--ink-shadow-lg)}
  body.nav-open nav.side{transform:none}
  main{margin-left:0;padding:16px 16px 70px}
  .card{transform:none!important}
}

/* ---------- 列印 ---------- */
@media print{
  header.top,nav.side,aside.toc,#crumb,.code-copy,.flow-src-btn{display:none!important}
  main{margin:0;padding:0;max-width:none}
  body{background:#fff;background-image:none}
  .code-wrap,.table-wrap,.flow-wrap,blockquote.bq{break-inside:avoid;box-shadow:none}
  .doc h1,.doc h2{break-after:avoid}
  .card,.stat{transform:none!important;box-shadow:none}
}