/*
 * guide.css — 介紹頁的樣式（單一檔案、零外部請求）。
 *
 * 為什麼不直接 `@import` tokens.css：介紹頁是**獨立靜態頁**，可能被單獨部署或快取，
 * 也可能跟 React 產品版一起出（而產品版的 CSS 是一份釘住的建置產物）。
 * 讓它只依賴自己這一份檔案，就不會出現「頁面有、樣式沒跟過去」的情況。
 *
 * 代價是顏色會重複。所以這件事交給檢查而不是自律：
 * `tools/check-seo.js` 會驗證這份檔案裡的每一個色碼都出現在 `app/css/tokens.css`，
 * 品牌色不可能在這裡悄悄漂移。
 *
 * 版面以「讀長文」為目標：單欄、行長受限、行高 1.7、表格可橫向捲動。
 * 深色模式只調整顏色，不改變版面。
 */

:root {
  --color-canvas: #FCFBFF;
  --color-surface: #FFFFFF;
  --color-surface-subtle: #F7F5FA;
  --color-ink: #18151F;
  --color-ink-secondary: #4A4453;
  --color-muted: #6F6878;
  --color-border: #EAE5F0;
  --color-primary: #6C4DFF;
  --color-primary-hover: #5636F0;
  --color-primary-subtle: #F3F0FF;
  --color-green: #10B981;
  --color-green-bg: #ECFDF5;
  --color-green-border: #A7F3D0;
  --color-green-text: #065F46;
  --color-yellow: #D97706;
  --color-yellow-bg: #FFFBEB;
  --color-yellow-border: #FDE68A;
  --color-yellow-text: #92400E;
  --color-red: #EF4444;
  --color-red-bg: #FEF2F2;
  --color-red-border: #FECACA;
  --color-red-text: #991B1B;
  --color-mint: #5ED6B3;
  --guide-measure: 44rem;
}

* { box-sizing: border-box; }

html { -webkit-text-size-adjust: 100%; }

body {
  margin: 0;
  background: var(--color-canvas);
  color: var(--color-ink);
  font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
    "PingFang TC", "Noto Sans TC", "Microsoft JhengHei", "PingFang SC", "Noto Sans SC", sans-serif;
  font-size: 1.0625rem;
  line-height: 1.75;
}

/* 跳到主內容：看不見直到被鍵盤聚焦。 */
.skip {
  position: absolute;
  left: -9999px;
  top: 0;
  background: var(--color-primary);
  color: #fff;
  padding: 0.75rem 1rem;
  border-radius: 0 0 0.5rem 0;
  z-index: 100;
}
.skip:focus { left: 0; }

.site-header {
  border-bottom: 1px solid var(--color-border);
  background: var(--color-surface);
}
.header-inner {
  max-width: 68rem;
  margin: 0 auto;
  padding: 0.75rem 1.25rem;
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem 1rem;
  align-items: center;
  justify-content: space-between;
}
.brand-link {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  text-decoration: none;
  color: inherit;
}
.brand-logo-svg { width: 34px; height: 34px; flex: none; }
.brand-name { font-weight: 700; }
.brand-badge {
  display: block;
  font-size: 0.8rem;
  color: var(--color-muted);
  font-weight: 500;
}
.header-controls {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  align-items: center;
}
.ctrl-btn {
  display: inline-block;
  padding: 0.4rem 0.7rem;
  border: 1px solid var(--color-border);
  border-radius: 0.6rem;
  background: var(--color-surface);
  color: var(--color-ink-secondary);
  font-size: 0.875rem;
  text-decoration: none;
}
.ctrl-btn:hover { border-color: var(--color-primary); color: var(--color-primary); }
.ctrl-btn.active {
  background: var(--color-primary-subtle);
  border-color: var(--color-primary);
  color: var(--color-primary);
  font-weight: 700;
}

main { display: block; }

.article-wrap {
  max-width: var(--guide-measure);
  margin: 0 auto;
  padding: 2rem 1.25rem 3rem;
}

h1 {
  font-size: clamp(1.6rem, 1.2rem + 2vw, 2.3rem);
  line-height: 1.3;
  margin: 0 0 1rem;
}
h2 {
  font-size: 1.35rem;
  line-height: 1.4;
  margin: 2.75rem 0 0.75rem;
  padding-top: 0.5rem;
  border-top: 1px solid var(--color-border);
}
h3 { font-size: 1.1rem; margin: 1.75rem 0 0.5rem; }
p { margin: 0 0 1rem; }
ul, ol { margin: 0 0 1rem; padding-left: 1.35rem; }
li { margin-bottom: 0.4rem; }
strong { font-weight: 700; }
a { color: var(--color-primary); text-underline-offset: 0.18em; }
a:hover { color: var(--color-primary-hover); }

.lede {
  font-size: 1.1rem;
  color: var(--color-ink-secondary);
  border-left: 4px solid var(--color-mint);
  padding-left: 1rem;
  margin-bottom: 1.5rem;
}

.key-points {
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: 0.9rem;
  padding: 1rem 1.25rem;
  margin-bottom: 1.5rem;
}
.key-points h2 {
  margin: 0 0 0.5rem;
  border: 0;
  padding: 0;
  font-size: 1rem;
  text-transform: none;
  color: var(--color-muted);
}
.key-points ul { margin-bottom: 0; }

.toc {
  background: var(--color-surface-subtle);
  border: 1px solid var(--color-border);
  border-radius: 0.9rem;
  padding: 1rem 1.25rem;
  margin-bottom: 1.5rem;
}
.toc h2 { margin: 0 0 0.5rem; border: 0; padding: 0; font-size: 1rem; color: var(--color-muted); }
.toc ol { margin: 0; padding-left: 1.25rem; columns: 2; column-gap: 2rem; }
.toc li { margin-bottom: 0.25rem; }

table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 1.25rem;
  font-size: 0.95rem;
  display: block;
  overflow-x: auto;
}
caption {
  text-align: left;
  font-size: 0.875rem;
  color: var(--color-muted);
  padding-bottom: 0.5rem;
}
th, td {
  border: 1px solid var(--color-border);
  padding: 0.5rem 0.65rem;
  vertical-align: top;
  text-align: left;
}
thead th { background: var(--color-surface-subtle); }
tbody th { background: var(--color-surface); font-weight: 600; }

details {
  border: 1px solid var(--color-border);
  border-radius: 0.7rem;
  background: var(--color-surface);
  padding: 0.5rem 0.9rem;
  margin-bottom: 0.6rem;
}
details[open] { background: var(--color-surface); }
summary {
  cursor: pointer;
  font-weight: 600;
  padding: 0.35rem 0;
}
summary::marker { color: var(--color-primary); }
details p { margin: 0.5rem 0 0.75rem; }

dl { margin: 0 0 1rem; }
dt { font-weight: 700; margin-top: 0.75rem; }
dd { margin: 0.15rem 0 0 0; color: var(--color-ink-secondary); }

.disclaimer {
  background: var(--color-yellow-bg);
  border: 1px solid var(--color-yellow-border);
  color: var(--color-yellow-text);
  border-radius: 0.9rem;
  padding: 0.9rem 1.1rem;
  margin: 0 0 1.5rem;
  font-size: 0.95rem;
}
.disclaimer strong { color: var(--color-yellow-text); }

.site-footer {
  border-top: 1px solid var(--color-border);
  background: var(--color-surface);
  color: var(--color-muted);
  font-size: 0.875rem;
}
.footer-inner {
  max-width: 68rem;
  margin: 0 auto;
  padding: 1.5rem 1.25rem 2rem;
}
.footer-inner p { margin: 0 0 0.4rem; }

@media (max-width: 640px) {
  .toc ol { columns: 1; }
  body { font-size: 1rem; }
}

@media (prefers-color-scheme: dark) {
  :root {
    --color-canvas: #14121A;
    --color-surface: #1C1926;
    --color-surface-subtle: #241F31;
    --color-ink: #F4F2F8;
    --color-ink-secondary: #CFC9DA;
    --color-muted: #A49CB4;
    --color-border: #332C44;
    --color-primary: #A692FF;
    --color-primary-hover: #BCACFF;
    --color-primary-subtle: #2A2340;
    --color-green-bg: #10281F;
    --color-green-border: #1E5A44;
    --color-green-text: #7FE3BE;
    --color-yellow-bg: #2C2210;
    --color-yellow-border: #5C4611;
    --color-yellow-text: #F4CE7A;
    --color-red-bg: #2E1618;
    --color-red-border: #6B2A2A;
    --color-red-text: #FCA5A5;
  }
}