/* doc-artifact.css — 文件站頁面版型（CM-1050／CM-1067）
 *
 * 疊在 doc-base.css 之上，提供只有「單頁討論稿／規格稿」會用到的東西：
 * 側欄／頂欄／首屏／章節框／主題切換鈕／statgrid／grid2 卡片／diagram 容器／pager／footer。
 * 由 render_doc.py 以 <link> 外連（CM-1053 起；停用 Artifact 後 CSP 限制消失）。
 *
 * 檔名保留 "artifact" 是歷史沿革（原為 Artifact 頁專屬），Artifact 已停用（CM-1053），
 * 現在的使用情境是 repo 本地／靜態站。改名會動到既有 115 頁產物的 <link>，
 * 收益不抵噪音，故只在此註記。
 */

/* ---- 側欄（CM-1067：資料驅動，內容由 doc-nav.js 填） ----
   色盤是 doc-base.css 的青灰系（--accent #0E7C86），刻意不同於 SPEC 站側欄的藏青金
   ——兩站讀者情境不同，且 site.css 一字不動是本案的硬約束。 */
.doclayout { display: flex; align-items: flex-start; min-height: 100vh; }
.docmain { flex: 1; min-width: 0; }
.docnav {
  width: 252px; flex: none; position: sticky; top: 0; height: 100vh; overflow-y: auto;
  background: var(--surface); border-right: 1px solid var(--line);
  padding: 20px 0 40px; font-size: 13.5px;
}
/* 側欄佔掉左側後，內容區的 .wrap 若仍置中於整個視窗會偏右；改為在 docmain 內置中 */
.doclayout .wrap { margin: 0 auto; }
.docnav-brand { padding: 0 18px 14px; border-bottom: 1px solid var(--line); margin-bottom: 10px; }
.docnav-brand .t { font-size: 14.5px; font-weight: 650; color: var(--ink); line-height: 1.4; }
.docnav-brand .v { display: inline-block; margin-top: 7px; font-family: var(--mono); font-size: 11px;
  color: var(--accent-strong); background: var(--accent-soft); padding: 1px 8px; border-radius: 9px; }
/* 子資料夾群標（大型需求的階段目錄，如 01-flow-template-management/） */
.docnav-dir { margin: 16px 0 2px; padding: 0 18px; font-family: var(--mono); font-size: 11.5px;
  color: var(--accent-strong); letter-spacing: .02em; }
/* 小節標題（階段分組）：可收合，狀態記 localStorage */
.docnav-group { margin: 12px 0 3px; padding: 0 18px; font-family: var(--mono); font-size: 11px;
  letter-spacing: .12em; text-transform: uppercase; color: var(--ink-3);
  cursor: pointer; user-select: none; display: flex; align-items: center; gap: 6px; }
.docnav-group:hover { color: var(--accent); }
.docnav .chev { display: inline-block; font-size: 9px; transition: transform .15s ease; }
.docnav-group.closed .chev { transform: rotate(-90deg); }
.docnav-sec.closed { display: none; }
.docnav a { display: block; padding: 5px 16px 5px 22px; color: var(--ink-2);
  text-decoration: none; line-height: 1.45; border-left: 3px solid transparent; }
.docnav a:hover { background: var(--surface-2); color: var(--ink); }
.docnav a.current { background: var(--accent-soft); color: var(--accent-strong);
  border-left-color: var(--accent); font-weight: 600; }
.docnav a.home { font-weight: 640; color: var(--ink); }
/* 相關 SPEC（CM-1427/1429）：外站連結，尾端綴箭頭與本站頁面區隔 */
.docnav a.ext::after { content: " ↗"; font-size: 10px; color: var(--ink-3, var(--ink-2)); }
.docnav-error { padding: 10px 18px; color: var(--crit); font-size: 12px; line-height: 1.6; }
.docnav-error code { white-space: normal; font-size: 11.5px; }
/* 窄視窗整條隱藏——頁尾 pager 與頂欄的回首頁仍在，出得去 */
@media (max-width: 1000px) { .docnav { display: none; } }

/* ---- 頂欄 ---- */
.topbar { position: sticky; top: 0; z-index: 20; background: color-mix(in srgb, var(--bg) 88%, transparent); backdrop-filter: blur(10px); border-bottom: 1px solid var(--line); }
/* height 固定＋nowrap：章節多的文件（handoff 動輒十幾個 h2）若讓 topnav 折行，
   整條頂欄會長到三行並蓋住首屏標題（實測）。超出改橫向捲動，頂欄永遠只有一行。 */
.topbar .wrap { display: flex; align-items: center; justify-content: space-between; height: 54px; gap: 16px; }
.topbar .brand { flex: none; }
.topbar .brand { display: flex; align-items: center; gap: 10px; font-family: var(--mono); font-size: 13px; letter-spacing: .02em; color: var(--ink-2); }
.topbar .brand b { color: var(--ink); font-weight: 600; }
.dot { width: 8px; height: 8px; border-radius: 50%; background: var(--accent); box-shadow: 0 0 0 3px var(--accent-soft); }
.topnav { display: flex; gap: 4px; overflow-x: auto; scrollbar-width: none; min-width: 0; }
.topnav::-webkit-scrollbar { display: none; }
.topnav a { font-family: var(--mono); font-size: 12px; color: var(--ink-3); text-decoration: none; padding: 5px 9px; border-radius: 6px; white-space: nowrap; flex: none; }
.topnav a:hover { color: var(--accent); background: var(--accent-soft); }
/* 回首頁與章節錨點性質不同（跨頁 vs 頁內），給一條分隔線與實色，避免被當成第 N 章。
   它擺在 .topnav 外層、不隨章節捲走——這是離開本頁的唯一出口，捲不到等於沒有。 */
.topbar .home { flex: none; font-family: var(--mono); font-size: 12px; color: var(--accent-strong); text-decoration: none; padding: 5px 9px; border-radius: 6px; white-space: nowrap; border: 1px solid transparent; }
.topbar .home:hover { background: var(--accent-soft); border-color: color-mix(in srgb, var(--accent) 30%, transparent); }
/* 回需求中心（CM-1427）：與「回需求首頁」同型但降一階，出口層級一眼可辨 */
.topbar .home.hub { color: var(--ink-2); }
.topbar .home.hub:hover { color: var(--accent-strong); }
/* 窄視窗只藏章節錨點，回首頁留著 */
@media (max-width: 900px) { .topnav { display: none; } }

/* ---- 首屏 ---- */
header.hero { padding: 66px 0 40px; border-bottom: 1px solid var(--line); }
.eyebrow { font-family: var(--mono); font-size: 12px; letter-spacing: .16em; text-transform: uppercase; color: var(--accent); margin: 0 0 18px; }
.lede { font-size: clamp(17px, 2vw, 20px); color: var(--ink-2); max-width: 62ch; margin: 0; line-height: 1.55; }
.meta-row { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 28px; }
.chip { font-family: var(--mono); font-size: 12px; padding: 5px 11px; border-radius: 999px; border: 1px solid var(--line-strong); color: var(--ink-2); background: var(--surface); display: inline-flex; align-items: center; gap: 6px; }
.chip.accent { color: var(--accent-strong); border-color: color-mix(in srgb, var(--accent) 40%, var(--line)); background: var(--accent-soft); }
.chip.warn { color: var(--warn); border-color: color-mix(in srgb, var(--warn) 35%, var(--line)); background: var(--warn-soft); }
.chip.ok { color: var(--ok); border-color: color-mix(in srgb, var(--ok) 35%, var(--line)); background: var(--ok-soft); }
.chip.crit { color: var(--crit); border-color: color-mix(in srgb, var(--crit) 35%, var(--line)); background: var(--crit-soft); }

/* ---- 章節（build 由 h2 自動切段並編號 §N） ----
   刻意用 .sec 而非裸 section：pandoc 遇到「fenced div 內第一個元素是標題」會輸出
   <section class="card …">，裸 section 選擇器會把卡片也套上章節分隔線。 */
section.sec { padding: 52px 0; border-bottom: 1px solid var(--line); }
.sec-head { display: flex; align-items: baseline; gap: 14px; margin-bottom: 8px; }
.sec-no { font-family: var(--mono); font-size: 13px; color: var(--accent); }

/* ---- 主題切換鈕 ----
   top: 58px 不可貼頂：Artifact viewer 自己有一條頂欄，貼頂會被蓋住（實測）。 */
.themetoggle { position: fixed; top: 58px; right: 18px; z-index: 30; font-family: var(--mono); font-size: 12px; color: var(--ink-2); background: var(--surface); border: 1px solid var(--line-strong); border-radius: 999px; padding: 6px 13px; cursor: pointer; box-shadow: var(--shadow); display: inline-flex; align-items: center; gap: 6px; }
.themetoggle:hover { color: var(--accent); border-color: var(--accent); }
.themetoggle:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }

/* ---- 圖 ----
   Artifact 雲端用內建 mermaid renderer；每張圖第一行的 %%{init}%% 決定配色，
   容器只負責留白與橫向捲動。 */
.diagram { background: var(--diagram-bg); border: 1px solid var(--diagram-line); border-radius: 12px; padding: 20px; margin: 18px 0; overflow-x: auto; }
.diagram pre.mermaid { margin: 0; text-align: center; min-width: 520px; background: none; border: none; box-shadow: none; padding: 0; }
.diagram pre.mermaid code { white-space: pre; }
.diagram-caption { font-family: var(--mono); font-size: 12px; color: var(--ink-3); text-align: center; margin-top: 10px; }

/* ---- 雙欄卡片 ---- */
.grid2 { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin: 16px 0; }
@media (max-width: 760px) { .grid2 { grid-template-columns: 1fr; } }
.card { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 18px 20px; box-shadow: var(--shadow); }
.card h4 { margin: 0 0 8px; font-size: 15px; font-weight: 640; font-family: var(--sans); }
.card p { font-size: 14.5px; margin: 6px 0; }
.card.ok { border-top: 3px solid var(--ok); }
.card.warn { border-top: 3px solid var(--warn); }
.card.crit { border-top: 3px solid var(--crit); }

/* ---- 統計卡 ----
   md 寫法：::: statgrid / ::: {.stat .crit} / [234]{.v}[控制項總數]{.k} */
.statgrid { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 12px; margin: 18px 0; }
.stat { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 16px 18px; box-shadow: var(--shadow); }
.stat p { margin: 0; max-width: none; }
.stat .v { display: block; font-family: var(--mono); font-size: 26px; font-weight: 600; color: var(--accent-strong); line-height: 1.1; font-variant-numeric: tabular-nums; }
.stat .k { display: block; font-size: 13px; color: var(--ink-2); margin-top: 6px; }
.stat .k code { white-space: normal; }
.stat.crit .v { color: var(--crit); }
.stat.warn .v { color: var(--warn); }

/* ---- 站內導覽 pager（CM-1053） ----
   頁尾的上一份／需求首頁／下一份。小螢幕 .topnav 整條隱藏，此列是唯一的離開出口，
   故三欄在窄視窗改直排而非隱藏。空槽也保留（用 span 佔位），讓「下一份」永遠靠右。 */
.pager { border-top: 1px solid var(--line); padding: 26px 0; }
.pager .wrap { display: grid; grid-template-columns: 1fr auto 1fr; align-items: center; gap: 16px; }
.pager-slot { display: flex; flex-direction: column; gap: 3px; text-decoration: none; min-width: 0; }
.pager-slot.next { text-align: right; align-items: flex-end; }
.pager-dir { font-family: var(--mono); font-size: 11.5px; letter-spacing: .08em; text-transform: uppercase; color: var(--ink-3); }
.pager-title { font-size: 14.5px; color: var(--accent-strong); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 100%; }
a.pager-slot:hover .pager-title { text-decoration: underline; }
.pager-home { font-family: var(--mono); font-size: 12px; color: var(--ink-2); text-decoration: none; border: 1px solid var(--line-strong); border-radius: 999px; padding: 6px 14px; background: var(--surface); white-space: nowrap; }
a.pager-home:hover { color: var(--accent); border-color: var(--accent); }
@media (max-width: 700px) {
  .pager .wrap { grid-template-columns: 1fr; }
  .pager-slot.next { text-align: left; align-items: flex-start; }
  .pager-home { justify-self: start; }
  .pager-slot:empty { display: none; }
}

footer { padding: 40px 0 64px; color: var(--ink-3); font-family: var(--mono); font-size: 12.5px; }
footer .wrap { max-width: var(--maxw); }
