/* ============================================================================
   Guidant 文件站設計系統 — docs-system.css（跨專案共用單一來源）
   ----------------------------------------------------------------------------
   萃取自 architecture-deck 的米金/紙感設計語言，補上「側欄文件站」版式。
   未來 test repo 與其他新專案的文件站都 <link> 這一支。

   結構：
     1. Design tokens（色 / 字體 / 尺寸）
     2. 基礎 typography
     3. 文件站版式（側欄 + TOC + scroll-spy + hero + 麵包屑）
     4. 元件庫（callout / role-cards / vs / stat / pill / takeaways / flow-diagram）
     5. 手寫 SVG 圖用 class（node / edge / label）
     6. 首頁 landing
     7. 響應式
   ============================================================================ */

/* ── 1. Design tokens ─────────────────────────────────────────────────── */
:root {
  color-scheme: light;

  /* 紙感底 + 表面 */
  --paper: #FBF8F3;
  --paper-raised: #FFFFFF;
  --surface: #F7F3EC;
  --surface-2: #F1EBE0;

  /* 線 */
  --line: #E4DCCF;
  --line-strong: #D8CDB8;

  /* 墨（文字） */
  --ink: #2B2420;
  --ink-mid: #4A4038;
  --ink-soft: #6B5F53;
  --ink-faint: #A79A88;

  /* 品牌米金 */
  --brand: #A57C3E;
  --brand-hover: #8A6531;
  --brand-deep: #533C1B;
  --brand-tint: #F3E9D6;
  --brand-soft: #FAF4E8;

  /* 語意色 */
  --ok: #4C7A52;      --ok-bg: #E8F0E9;
  --warn: #A8770A;    --warn-bg: #F6EEDB;
  --stop: #B03A2E;    --stop-bg: #F6E4E1;

  --code-bg: #F1EBE0;
  --code-text: #8A5A1E;

  /* 字體 */
  --serif: "Noto Serif TC", "Songti TC", "PMingLiU", Georgia, serif;
  --sans: "PingFang TC", "Microsoft JhengHei", "Noto Sans TC", -apple-system, "Helvetica Neue", sans-serif;
  --mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;

  --radius: 8px;
  --maxw: 860px;
}

* { box-sizing: border-box; }
html { background: var(--paper); scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }

body {
  margin: 0; background: var(--paper); color: var(--ink);
  font-family: var(--sans); font-size: 16px; line-height: 1.8;
  -webkit-font-smoothing: antialiased;
}
::selection { background: var(--brand); color: var(--paper); }

/* ── 2. Typography ────────────────────────────────────────────────────── */
h1, h2, h3, h4 { font-family: var(--serif); }
strong, b { color: var(--brand-deep); font-weight: 700; }
a { color: var(--brand); text-decoration: none; }
a:hover { color: var(--brand-hover); }
ul, ol { padding-left: 1.4rem; }
li { margin: .35rem 0; }

code {
  font-family: var(--mono); font-size: .85em;
  background: var(--code-bg); color: var(--code-text);
  padding: .1em .4em; border-radius: 4px;
}
pre {
  background: var(--code-bg); border: 1px solid var(--line);
  border-radius: var(--radius); padding: 16px 18px; overflow-x: auto;
  font-size: 13px; line-height: 1.7; margin: 16px 0;
}
pre code { background: none; padding: 0; color: var(--ink-mid); }

table {
  width: 100%; border-collapse: collapse; margin: 18px 0; font-size: 14.5px;
  background: var(--paper-raised); border: 1px solid var(--line);
  border-radius: var(--radius); overflow: hidden;
}
th, td { padding: 10px 14px; text-align: left; border-bottom: 1px solid var(--line); vertical-align: top; }
th { background: var(--surface-2); font-size: 12.5px; letter-spacing: .3px; color: var(--ink-mid); font-weight: 700; }
tr:last-child td { border-bottom: none; }
td code { font-size: 12px; }

blockquote {
  margin: 18px 0; padding: 12px 18px;
  background: var(--surface); border-left: 3px solid var(--brand);
  border-radius: 0 var(--radius) var(--radius) 0; color: var(--ink-mid); font-size: 14.5px;
}
blockquote p { margin: 6px 0; }

/* ── 3. 文件站版式（側欄 + 內文） ─────────────────────────────────────── */
.layout { display: grid; grid-template-columns: 292px 1fr; min-height: 100vh; }

aside {
  background: var(--surface); border-right: 1px solid var(--line);
  padding: 26px 18px 40px; position: sticky; top: 0; height: 100vh; overflow-y: auto;
}
aside .brand { font-family: var(--serif); font-size: 16px; font-weight: 700; letter-spacing: .04em; margin-bottom: 3px; color: var(--ink); text-decoration: none; display: block; }
aside .brand span { color: var(--brand); }
aside .sub { font-size: 12px; color: var(--ink-soft); margin-bottom: 22px; }

aside .grouplabel {
  font-family: var(--mono); font-size: 10.5px; text-transform: uppercase; letter-spacing: .12em;
  color: var(--ink-faint); font-weight: 700; margin: 20px 0 8px 10px;
}
aside .grouplabel.planned { color: var(--line-strong); }

aside nav a.page {
  display: block; color: var(--ink-mid); text-decoration: none;
  font-size: 14px; font-weight: 600; padding: 7px 10px; border-radius: 6px;
  margin-bottom: 2px; transition: .12s;
}
aside nav a.page:hover { background: var(--surface-2); color: var(--ink); }
aside nav a.page.active { background: var(--brand-tint); color: var(--brand-deep); }

aside nav .toc { margin: 2px 0 4px 4px; padding-left: 8px; border-left: 1px solid var(--line-strong); }
aside nav a.anchor {
  display: block; color: var(--ink-soft); text-decoration: none;
  font-size: 12.8px; padding: 4px 10px; border-radius: 6px; margin-bottom: 1px;
  border-left: 2px solid transparent; margin-left: -9px; transition: .12s;
}
aside nav a.anchor:hover { color: var(--ink); background: var(--surface-2); }
aside nav a.anchor.active { color: var(--brand-deep); border-left-color: var(--brand); background: var(--brand-tint); }

aside nav .planned-item {
  display: flex; align-items: center; justify-content: space-between;
  color: var(--ink-faint); font-size: 13.5px; padding: 6px 10px; cursor: default;
}
aside nav .planned-item .pill {
  font-family: var(--mono); font-size: 9.5px; color: var(--ink-faint); background: var(--surface-2);
  border-radius: 4px; padding: 2px 7px; letter-spacing: .05em; text-transform: uppercase;
}

main { padding: 52px 52px 120px; max-width: calc(var(--maxw) + 104px); }

.crumb { font-family: var(--mono); font-size: 11.5px; letter-spacing: .03em; color: var(--ink-soft); margin-bottom: 18px; }
.crumb a { color: var(--ink-soft); text-decoration: none; }
.crumb a:hover { color: var(--brand); }
.crumb span { color: var(--ink-faint); }

.hero {
  background: var(--brand-soft); border: 1px solid var(--line);
  border-top: 4px solid var(--brand);
  border-radius: 10px; padding: 30px 32px; margin-bottom: 40px;
}
.hero h1 { font-family: var(--serif); margin: 0 0 12px; font-size: 27px; line-height: 1.35; letter-spacing: .04em; color: var(--brand-deep); }
.hero p { margin: 0; color: var(--ink-mid); font-size: 15.5px; }
.hero .meta { font-family: var(--mono); margin-top: 16px; font-size: 11.5px; letter-spacing: .02em; color: var(--ink-soft); }

h2 {
  font-family: var(--serif); font-size: 22px; margin: 54px 0 16px; padding-bottom: 10px;
  border-bottom: 1px solid var(--line); scroll-margin-top: 20px; color: var(--brand-deep); letter-spacing: .03em;
}
h2 .num {
  font-family: var(--mono); color: var(--brand); font-size: 15px; font-weight: 700;
  border: 1px solid var(--line-strong); border-radius: 999px; padding: 1px 10px; margin-right: 12px;
  vertical-align: middle;
}
h3 { font-family: var(--serif); font-size: 17px; margin: 28px 0 10px; color: var(--ink); }
p { margin: 12px 0; color: var(--ink); }

/* ── 4. 元件庫 ────────────────────────────────────────────────────────── */

/* callout（三色語意） */
.callout {
  border-left: 4px solid var(--brand); background: var(--brand-tint);
  border-radius: 0 6px 6px 0; padding: 13px 18px; margin: 20px 0; font-size: 14.5px; color: var(--ink-mid);
}
.callout.ok { border-left-color: var(--ok); background: var(--ok-bg); }
.callout.warn { border-left-color: var(--warn); background: var(--warn-bg); }
.callout b:first-child { color: var(--brand-deep); }
.callout.ok b:first-child { color: var(--ok); }
.callout.warn b:first-child { color: var(--warn); }

/* role-cards（角色卡；owner brain=金 helper=綠 you=墨/中性）
   .roles = 2 欄；.roles.trio = 3 欄（人/首腦/小弟三層） */
.roles { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin: 22px 0; }
.roles.trio { grid-template-columns: 1fr 1fr 1fr; }
.role-card { background: var(--paper-raised); border: 1px solid var(--line); border-radius: 10px; padding: 20px; }
.role-card .tag { font-family: var(--mono); font-size: 11px; font-weight: 700; letter-spacing: .05em; padding: 3px 10px; border-radius: 4px; display: inline-block; margin-bottom: 10px; text-transform: uppercase; }
.role-card.brain { border-top: 3px solid var(--brand); }
.role-card.brain .tag { background: var(--brand-tint); color: var(--brand-deep); }
.role-card.helper { border-top: 3px solid var(--ok); }
.role-card.helper .tag { background: var(--ok-bg); color: var(--ok); }
.role-card.you { border-top: 3px solid var(--ink-soft); }
.role-card.you .tag { background: var(--surface-2); color: var(--ink); }
.role-card h4 { margin: 0 0 8px; font-size: 15.5px; color: var(--ink); }
.role-card p { margin: 4px 0; font-size: 13.5px; color: var(--ink-mid); }
.role-card p.no { color: var(--ink-faint); }

/* vs 對比卡（痛點/目標） */
.vs { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin: 22px 0; }
.vs-card { border: 1px solid var(--line); border-radius: 8px; padding: 16px 18px; background: var(--paper-raised); }
.vs-card.now { border-top: 3px solid var(--stop); }
.vs-card.goal { border-top: 3px solid var(--ok); }
.vs-card h4 { margin: 0 0 8px; font-family: var(--serif); font-size: 15px; }
.vs-card.now h4 { color: var(--stop); }
.vs-card.goal h4 { color: var(--ok); }
.vs-card ul { margin: 0; padding-left: 1.1rem; font-size: 13.5px; color: var(--ink-mid); }

/* stat 數字牆 */
.stats { display: grid; grid-template-columns: repeat(4, 1fr); gap: 12px; margin: 22px 0; }
.stat { text-align: center; border: 1px solid var(--line); border-radius: 8px; padding: 16px 8px; background: var(--paper-raised); }
.stat b { display: block; font-family: var(--serif); font-size: 26px; color: var(--brand); line-height: 1.1; }
.stat span { font-size: 12px; color: var(--ink-soft); }

/* pill 徽章（inline 狀態） */
.pill { display: inline-block; font-family: var(--mono); font-size: 10.5px; font-weight: 700; letter-spacing: .04em; padding: 2px 8px; border-radius: 4px; vertical-align: middle; text-transform: uppercase; }
.pill.done { background: var(--ok-bg); color: var(--ok); }
.pill.doing { background: var(--brand-tint); color: var(--brand-deep); }
.pill.todo { background: var(--surface-2); color: var(--ink-soft); }

/* takeaways 自動編號重點 */
.takeaways { counter-reset: t; list-style: none; padding: 0; margin: 18px 0; }
.takeaways li { counter-increment: t; position: relative; padding: 8px 0 8px 40px; border-bottom: 1px dashed var(--line); font-size: 15px; color: var(--ink-mid); }
.takeaways li:last-child { border-bottom: none; }
.takeaways li::before {
  content: counter(t); position: absolute; left: 0; top: 8px;
  width: 26px; height: 26px; border-radius: 50%; background: var(--brand); color: #fff;
  font-family: var(--mono); font-size: 12.5px; font-weight: 700;
  display: flex; align-items: center; justify-content: center;
}

/* ── flow-diagram（手刻階段流程卡片圖） ── */
.flowdiag { background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 30px 26px; margin: 22px 0; display: flex; flex-direction: column; align-items: center; }
.flowdiag .stage { display: flex; flex-direction: column; align-items: center; }
.flowdiag .wave {
  display: inline-block; font-family: var(--mono); font-size: 11px; font-weight: 700; letter-spacing: .08em;
  color: var(--ink-soft); background: var(--paper-raised); border: 1px solid var(--line-strong);
  border-radius: 999px; padding: 4px 16px; margin: 0 0 4px; text-transform: uppercase;
}
.flowdiag .row { display: flex; gap: 14px; justify-content: center; flex-wrap: wrap; }
.flowdiag .node { background: var(--paper-raised); border: 1.5px solid var(--line-strong); border-radius: 8px; padding: 12px 18px; min-width: 132px; text-align: center; }
.flowdiag .node .nt { font-family: var(--serif); font-size: 14.5px; font-weight: 700; color: var(--ink); }
.flowdiag .node .ns { font-size: 12px; color: var(--ink-soft); margin-top: 3px; }
.flowdiag .node.you { border-color: var(--brand); background: var(--brand-soft); }
.flowdiag .node.you .nt { color: var(--brand-deep); }
.flowdiag .node.ai { border-color: var(--ok); background: var(--ok-bg); }
.flowdiag .node.ai .nt { color: var(--ok); }
.flowdiag .arrow { color: var(--brand); font-size: 16px; line-height: 1; margin: 6px 0; }
.flowdiag .aside { margin-top: 22px; padding-top: 20px; border-top: 1px dashed var(--line-strong); display: flex; align-items: center; justify-content: center; gap: 14px; flex-wrap: wrap; }
.flowdiag .aside .lbl { font-size: 12.5px; color: var(--ink-soft); }

/* 視覺截圖（教學視覺的真實畫面範例） */
.visual-shot { margin: 14px 0 26px; }
.visual-shot img {
  display: block; width: 100%; max-width: 720px;
  border: 1px solid var(--line-strong); border-radius: 8px;
  box-shadow: 0 2px 10px rgba(43,36,32,.08);
}
.visual-shot figcaption { font-size: 12.5px; color: var(--ink-soft); margin-top: 6px; }

/* ── 5. 手寫 SVG 圖用 class ────────────────────────────────────────────── */
.fig { overflow-x: auto; margin: 22px 0 6px; }
.fig svg { display: block; width: 100%; height: auto; min-width: 440px; }
.figcap { font-size: 12.5px; color: var(--ink-soft); text-align: center; margin: 4px 0 0; }

svg text { font-family: var(--sans); }
.n-box { fill: var(--paper-raised); stroke: var(--brand); stroke-width: 1.5; }
.n-hi { fill: var(--brand-tint); stroke: var(--brand); stroke-width: 2; }
.n-soft { fill: var(--brand-soft); stroke: var(--brand); stroke-width: 1.3; }
.n-ok { fill: var(--ok-bg); stroke: var(--ok); stroke-width: 1.5; }
.n-t { fill: var(--brand-deep); font-weight: 700; }
.n-s { fill: var(--ink-soft); }
.n-okt { fill: var(--ok); font-weight: 700; }
.edge { stroke: var(--brand); stroke-width: 1.6; fill: none; }
.edge-d { stroke: var(--ok); stroke-width: 1.6; fill: none; stroke-dasharray: 5 4; }
.lbl { fill: var(--ink-soft); font-weight: 600; }
.lbl-ok { fill: var(--ok); font-weight: 700; }

/* ── 6. 首頁 landing ──────────────────────────────────────────────────── */
.landing { max-width: 1000px; margin: 0 auto; padding: 72px 32px 120px; }
.landing-head .kicker { font-family: var(--mono); font-size: 12px; font-weight: 700; letter-spacing: .18em; text-transform: uppercase; color: var(--brand); }
.landing-head h1 { font-family: var(--serif); font-size: 34px; line-height: 1.25; letter-spacing: .04em; margin: 12px 0 14px; color: var(--brand-deep); }
.landing-head p { font-size: 16px; color: var(--ink-mid); max-width: 640px; margin: 0; }

.section-label { font-family: var(--mono); font-size: 11px; font-weight: 700; text-transform: uppercase; letter-spacing: .12em; color: var(--ink-faint); margin: 48px 0 14px; }

.section-label .section-hint { text-transform: none; letter-spacing: 0; font-weight: 400; color: var(--ink-faint); margin-left: 10px; }

/* 步驟列（live 頁有閱讀順序 → 直排，左側大編號） */
.steps { display: flex; flex-direction: column; gap: 12px; }
.step-card {
  display: flex; align-items: center; gap: 18px; text-decoration: none; color: inherit;
  background: var(--paper-raised); border: 1px solid var(--line); border-left: 3px solid var(--brand);
  border-radius: 12px; padding: 18px 22px; transition: .15s; position: relative;
}
.step-card:hover { border-color: var(--brand); box-shadow: 0 6px 22px rgba(165,124,62,.12); transform: translateX(4px); }
.step-no {
  font-family: var(--serif); font-size: 30px; font-weight: 700; color: var(--brand);
  min-width: 46px; text-align: center; line-height: 1;
}
.step-icon { font-size: 22px; }
.step-body { flex: 1; min-width: 0; }
.step-title { display: block; font-family: var(--serif); font-size: 17px; font-weight: 700; color: var(--brand-deep); margin-bottom: 3px; }
.step-blurb { display: block; font-size: 13.5px; color: var(--ink-soft); line-height: 1.6; }
.step-go { font-family: var(--mono); font-size: 12.5px; font-weight: 700; color: var(--brand); white-space: nowrap; }

.cards { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 18px; }
.card {
  display: block; text-decoration: none; color: inherit;
  background: var(--paper-raised); border: 1px solid var(--line); border-radius: 12px;
  padding: 24px 24px 22px; transition: .15s; position: relative;
}
.card.live { border-top: 3px solid var(--brand); }
.card.live:hover { border-color: var(--brand); box-shadow: 0 6px 22px rgba(165,124,62,.12); transform: translateY(-2px); }
.card.soon { opacity: .72; cursor: default; background: var(--surface); }
.card .icon { font-size: 22px; margin-bottom: 12px; display: block; }
.card h3 { font-family: var(--serif); margin: 0 0 6px; font-size: 17px; color: var(--brand-deep); }
.card p { margin: 0; font-size: 13.5px; color: var(--ink-soft); line-height: 1.6; }
.card .status { position: absolute; top: 18px; right: 18px; font-family: var(--mono); font-size: 10px; font-weight: 700; letter-spacing: .05em; padding: 2px 9px; border-radius: 4px; text-transform: uppercase; }
.card .status.ready { background: var(--ok-bg); color: var(--ok); }
.card .status.planned { background: var(--surface-2); color: var(--ink-faint); }
.card .go { margin-top: 14px; font-family: var(--mono); font-size: 12.5px; font-weight: 700; color: var(--brand); }

/* 頁尾上一頁/下一頁 */
.pager { display: flex; justify-content: space-between; gap: 16px; margin-top: 56px; }
.pager a {
  display: inline-block; border: 1px solid var(--line); border-radius: 8px;
  padding: 10px 18px; font-size: 14px; font-weight: 600; color: var(--brand-deep);
  background: var(--paper-raised); text-decoration: none; transition: .15s;
}
.pager a:hover { border-color: var(--brand); color: var(--brand); }

footer { margin-top: 80px; padding-top: 24px; border-top: 1px solid var(--line); color: var(--ink-faint); font-size: 12.5px; }
.landing footer { max-width: 1000px; margin: 0 auto; }

/* ── 7. 響應式 ────────────────────────────────────────────────────────── */
@media (max-width: 860px) {
  .layout { grid-template-columns: 1fr; }
  aside { position: static; height: auto; border-right: none; border-bottom: 1px solid var(--line); }
  main { padding: 32px 20px 80px; }
  .roles, .roles.trio, .vs { grid-template-columns: 1fr; }
  .step-card { flex-wrap: wrap; gap: 10px; }
  .step-go { width: 100%; text-align: right; }
  .stats { grid-template-columns: repeat(2, 1fr); }
  .landing { padding: 44px 20px 80px; }
  .landing-head h1 { font-size: 27px; }
}