/* doc-base.css — 文件排版底（CM-1050）
 *
 * 用途：討論稿／開發規格類單頁文件的共用排版底（token／字級／表格／code／callout／引用）。
 * 由 scripts/deliverables/render_doc.py 於 build 時「內嵌」進產物 <style>，不是 <link> 外連
 * ——Artifact CSP 擋所有外部 host，外連會靜默失效整頁裸奔（見
 * docs/analysis/2026-08-03-doc-html-pipeline.md §6.1）。共用的是本源檔，不是連結。
 *
 * 主題：預設亮色，不跟 prefers-color-scheme 自動切換。原因是 mermaid 圖被 %%{init}%% 鎖成
 * 淺底深字（Artifact 雲端不執行頁面 script，配色只能靠 init 字串），暗底頁面會讓圖與頁打架。
 * 暗色由 doc-artifact.css 的切換鈕主動選擇（存 localStorage）。決策全文見 analysis §5。
 *
 * 與 site.css（SPEC 站）的關係：兩者各自獨立，本檔不動 site.css。共通語意 token 名稱刻意同名
 * （--ink／--bg／--accent／--line），但色盤不同（SPEC 站藏青金／本檔青灰），故不可同頁混掛。
 */

:root {
  --bg: #F6F8F9;
  --surface: #FFFFFF;
  --surface-2: #EEF2F3;
  --ink: #14201F;
  --ink-2: #4A5A5C;
  --ink-3: #7A8A8C;
  --line: #DCE3E4;
  --line-strong: #C7D1D2;
  --accent: #0E7C86;
  --accent-strong: #0B5E66;
  --accent-soft: #E2F0F1;
  --ok: #2E7D5B;
  --ok-soft: #E4F1EA;
  --warn: #9C6B12;
  --warn-soft: #F6EBD5;
  --crit: #B93A2B;
  --crit-soft: #F6E2DE;
  --info: #2B6CB0;
  --info-soft: #E1ECF7;
  --diagram-bg: #FBFCFC;
  --diagram-line: #E4EAEB;
  --shadow: 0 1px 2px rgba(20,32,31,.04), 0 4px 16px rgba(20,32,31,.05);
  --mono: ui-monospace, "SF Mono", SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, "PingFang TC", "Microsoft JhengHei", "Noto Sans TC", sans-serif;
  --maxw: 1080px;
  --prose: 74ch;
}

/* 暗色只在使用者主動切換（切換鈕寫 data-theme）時生效，不掛 @media。
   diagram 底色在暗色下維持淺色——圖本身是淺底深字，容器跟著暗會讓圖浮在深框裡。 */
:root[data-theme="dark"] {
  --bg: #0E1416; --surface: #141B1E; --surface-2: #1B2529;
  --ink: #E7EEEE; --ink-2: #A6B4B6; --ink-3: #6F7F81;
  --line: #263133; --line-strong: #33413F;
  --accent: #34C5CE; --accent-strong: #62D6DD; --accent-soft: #123239;
  --ok: #57C08A; --ok-soft: #14291F; --warn: #D9A441; --warn-soft: #2C2211;
  --crit: #E07666; --crit-soft: #2E1613; --info: #6BA6E8; --info-soft: #15222F;
  --diagram-bg: #F7FAFA; --diagram-line: #E4EAEB;
  --shadow: 0 1px 2px rgba(0,0,0,.3), 0 6px 20px rgba(0,0,0,.32);
}
:root[data-theme="light"] {
  --bg: #F6F8F9; --surface: #FFFFFF; --surface-2: #EEF2F3;
  --ink: #14201F; --ink-2: #4A5A5C; --ink-3: #7A8A8C;
  --line: #DCE3E4; --line-strong: #C7D1D2;
  --accent: #0E7C86; --accent-strong: #0B5E66; --accent-soft: #E2F0F1;
  --ok: #2E7D5B; --ok-soft: #E4F1EA; --warn: #9C6B12; --warn-soft: #F6EBD5;
  --crit: #B93A2B; --crit-soft: #F6E2DE; --info: #2B6CB0; --info-soft: #E1ECF7;
  --diagram-bg: #FBFCFC; --diagram-line: #E4EAEB;
  --shadow: 0 1px 2px rgba(20,32,31,.04), 0 4px 16px rgba(20,32,31,.05);
}

/* ---- 基礎排版 ---- */
* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
body { margin: 0; background: var(--bg); color: var(--ink); font-family: var(--sans); font-size: 16px; line-height: 1.65; -webkit-font-smoothing: antialiased; }
.wrap { max-width: var(--maxw); margin: 0 auto; padding: 0 24px; }

h1 { font-size: clamp(30px, 4.4vw, 46px); line-height: 1.08; letter-spacing: -0.02em; font-weight: 680; margin: 0 0 20px; text-wrap: balance; max-width: 22ch; }
h2 { font-size: clamp(22px, 2.6vw, 28px); letter-spacing: -0.01em; font-weight: 650; margin: 0; }
h3 { font-size: 17px; font-weight: 640; margin: 34px 0 10px; letter-spacing: -0.005em; }
h4 { font-size: 14px; font-weight: 640; margin: 20px 0 6px; color: var(--ink); font-family: var(--mono); letter-spacing: .01em; }
p { max-width: var(--prose); }
section.sec > .wrap > p, section.sec li { color: var(--ink-2); }
li { margin: 4px 0; }
strong { color: var(--ink); font-weight: 600; }
a { color: var(--accent-strong); }
code { font-family: var(--mono); font-size: .86em; background: var(--surface-2); border: 1px solid var(--line); border-radius: 5px; padding: 1px 6px; color: var(--ink); white-space: nowrap; }
.src { font-family: var(--mono); font-size: 12px; color: var(--ink-3); }

/* 章節導言（h2 之後緊接的第一段） */
.sec-lede { color: var(--ink-2); max-width: var(--prose); margin: 6px 0 26px; }

/* ---- 表格 ---- */
table { width: 100%; border-collapse: collapse; font-size: 14.5px; margin: 14px 0 6px; background: var(--surface); border: 1px solid var(--line); border-radius: 10px; overflow: hidden; box-shadow: var(--shadow); }
.table-scroll { overflow-x: auto; border-radius: 10px; }
th { text-align: left; font-family: var(--mono); font-size: 12px; letter-spacing: .06em; text-transform: uppercase; color: var(--ink-3); font-weight: 600; padding: 11px 14px; border-bottom: 1px solid var(--line-strong); background: var(--surface-2); white-space: nowrap; }
td { padding: 11px 14px; border-bottom: 1px solid var(--line); vertical-align: top; color: var(--ink-2); }
tr:last-child td { border-bottom: none; }
td b, td strong { color: var(--ink); }
.num { font-variant-numeric: tabular-nums; }

/* ---- 行內標籤 ---- */
.tag { display: inline-block; font-family: var(--mono); font-size: 11.5px; padding: 2px 9px; border-radius: 999px; white-space: nowrap; }
.tag.ok { color: var(--ok); background: var(--ok-soft); }
.tag.warn { color: var(--warn); background: var(--warn-soft); }
.tag.crit { color: var(--crit); background: var(--crit-soft); }
.tag.info { color: var(--info); background: var(--info-soft); }
.tag.plain { color: var(--ink-2); background: var(--surface-2); border: 1px solid var(--line); }

/* ---- callout ----
   md 寫法：::: {.callout .crit} ... :::
   第一個 <p> 的粗體會被 build 轉成 .co-label（大寫小標）。 */
.callout { border: 1px solid var(--line-strong); border-left: 3px solid var(--accent); background: var(--surface); border-radius: 10px; padding: 18px 20px; margin: 18px 0; box-shadow: var(--shadow); }
.callout .co-label { font-family: var(--mono); font-size: 12px; letter-spacing: .1em; text-transform: uppercase; color: var(--accent-strong); margin: 0 0 8px; font-weight: 600; }
.callout p { margin: 6px 0; }
.callout .rec { margin-top: 10px; padding-top: 10px; border-top: 1px dashed var(--line-strong); }
.callout .rec b, .callout .rec strong { color: var(--ok); }
.callout .con { margin-top: 8px; font-size: 14.5px; }
.callout.decided { border-left-color: var(--ok); background: color-mix(in srgb, var(--ok-soft) 38%, var(--surface)); }
.callout.decided .co-label { color: var(--ok); }
.callout.warn { border-left-color: var(--warn); }
.callout.warn .co-label { color: var(--warn); }
.callout.crit { border-left-color: var(--crit); }
.callout.crit .co-label { color: var(--crit); }
.callout.pending { border-left-color: var(--warn); background: color-mix(in srgb, var(--warn-soft) 38%, var(--surface)); }
.callout.pending .co-label { color: var(--warn); }

/* ---- 引用 ---- */
blockquote { margin: 18px 0; padding: 16px 20px; border-left: 3px solid var(--accent); background: var(--accent-soft); border-radius: 0 10px 10px 0; color: var(--ink); font-size: 16.5px; max-width: var(--prose); }
blockquote p { margin: 0; max-width: none; color: var(--ink); }
blockquote .attr { display: block; margin-top: 8px; font-family: var(--mono); font-size: 12px; color: var(--ink-2); }

/* ---- 程式碼區塊 ----
   pandoc 產 <pre class="sourceCode …">；未標語言則是純 <pre><code>。兩者同一套外觀。 */
pre { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; padding: 16px 18px; overflow-x: auto; font-family: var(--mono); font-size: 13px; line-height: 1.6; color: var(--ink); box-shadow: var(--shadow); }
pre code { background: none; border: none; padding: 0; font-size: inherit; white-space: pre; }
div.sourceCode { margin: 14px 0; }
pre.sourceCode a[href^="#cb"] { display: none; }  /* pandoc 行號錨點，文件站不需要 */

/* pandoc 語法高亮：只上最低限度的三色（註解／字面值／關鍵字），避免彩色雜訊蓋過
   文件本身的重點標示。未列到的 token class 一律繼承 --ink。 */
code span.co, code span.cm { color: var(--ink-3); font-style: italic; }  /* 註解 */
code span.st, code span.ss, code span.vs { color: var(--ok); }           /* 字串 */
code span.dv, code span.bn, code span.fl { color: var(--info); }         /* 數字 */
code span.kw, code span.cf { color: var(--accent-strong); font-weight: 600; }