/* =============================================================
   穿山甲 · Pangolin — 架构设计文档样式
   令牌部分逐字拷贝自 design/colors_and_type.css（唯一真相源）；
   改令牌请先改源文件再同步此处。文档版式附在令牌之后。
   ============================================================= */

@import url('https://fonts.googleapis.com/css2?family=Sora:wght@500;600;700&family=Manrope:wght@400;500;600;700&family=Noto+Sans+SC:wght@400;500;700&family=JetBrains+Mono:wght@400;500&display=swap');

:root {
  /* Clay / Copper — the pangolin-armor primary (warm earth) */
  --clay-50:  #FAF3ED;
  --clay-100: #F2E2D4;
  --clay-200: #E6C7AC;
  --clay-300: #D9A982;
  --clay-400: #CC8B5C;
  --clay-500: #B96A3D;   /* ← brand primary */
  --clay-600: #9E5630;
  --clay-700: #7E4426;
  --clay-800: #5E331D;
  --clay-900: #3D2213;

  /* Sand / Taupe — warm neutral ramp */
  --sand-50:  #FAF8F4;
  --sand-100: #F2EEE7;
  --sand-200: #E6DFD3;
  --sand-300: #D2C8B8;
  --sand-400: #B0A491;
  --sand-500: #8C8270;
  --sand-600: #6B6253;
  --sand-700: #4E4940;
  --sand-800: #2E2A24;
  --sand-900: #1F1C18;
  --sand-950: #14110E;

  /* Semantic hues (earth-tuned) */
  --green-400: #7FB07A;
  --green-500: #5B8C5A;
  --green-600: #467046;
  --amber-400: #E2B05A;
  --amber-500: #D69A3C;
  --amber-600: #B47E29;
  --red-400:   #D4715A;
  --red-500:   #C0533B;
  --red-600:   #9E4230;

  /* Semantic tokens — light */
  --bg:        var(--sand-50);
  --bg-subtle: var(--sand-100);
  --surface:   #FFFFFF;
  --surface-2: var(--sand-50);
  --overlay:   rgba(31, 28, 24, 0.45);

  --fg1: var(--sand-900);
  --fg2: var(--sand-600);
  --fg3: var(--sand-500);
  --fg-on-accent: #FFFFFF;

  --accent:        var(--clay-500);
  --accent-hover:  var(--clay-600);
  --accent-press:  var(--clay-700);
  --accent-subtle: var(--clay-50);
  --accent-border: var(--clay-200);

  --border:        var(--sand-200);
  --border-strong: var(--sand-300);
  --ring: rgba(185, 106, 61, 0.35);

  --success: var(--green-500);
  --success-subtle: #E9F0E6;
  --warning: var(--amber-500);
  --warning-subtle: #F8EED6;
  --danger:  var(--red-500);
  --danger-subtle: #F6E1DA;

  /* Typography */
  --font-display: 'Sora', 'Noto Sans SC', system-ui, sans-serif;
  --font-sans:    'Manrope', 'Noto Sans SC', system-ui, sans-serif;
  --font-cjk:     'Noto Sans SC', 'Manrope', system-ui, sans-serif;
  --font-mono:    'JetBrains Mono', ui-monospace, 'SFMono-Regular', monospace;

  --text-display-xl: 3rem;
  --text-display:    2.25rem;
  --text-h1:         1.875rem;
  --text-h2:         1.5rem;
  --text-h3:         1.25rem;
  --text-body-lg:    1.125rem;
  --text-body:       1rem;
  --text-sm:         0.875rem;
  --text-caption:    0.75rem;

  --leading-tight: 1.15;
  --leading-snug:  1.3;
  --leading-normal:1.5;
  --leading-relaxed:1.65;

  --tracking-tight: -0.02em;
  --tracking-snug:  -0.01em;
  --tracking-wide:  0.04em;
  --tracking-caps:  0.08em;

  /* Spacing (4px base) */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-5: 1.25rem;
  --space-6: 1.5rem;
  --space-8: 2rem;
  --space-10: 2.5rem;
  --space-12: 3rem;
  --space-16: 4rem;

  /* Radii */
  --radius-sm:  6px;
  --radius-md:  10px;
  --radius-lg:  14px;
  --radius-xl:  20px;
  --radius-2xl: 28px;
  --radius-full: 999px;

  /* Shadows (warm-tinted, soft) */
  --shadow-sm: 0 1px 2px rgba(45, 30, 20, 0.06);
  --shadow-md: 0 4px 14px rgba(45, 30, 20, 0.08);
  --shadow-lg: 0 12px 32px rgba(45, 30, 20, 0.12);
  --shadow-xl: 0 24px 60px rgba(45, 30, 20, 0.16);
  --shadow-focus: 0 0 0 4px var(--ring);

  /* Motion */
  --ease-out: cubic-bezier(0.22, 1, 0.36, 1);
  --ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
  --dur-fast: 140ms;
  --dur-base: 220ms;
  --dur-slow: 360ms;
}

[data-theme="dark"] {
  --bg:        var(--sand-950);
  --bg-subtle: var(--sand-900);
  --surface:   #221E19;
  --surface-2: #2A251F;
  --overlay:   rgba(0, 0, 0, 0.6);

  --fg1: #F4EFE8;
  --fg2: #B6AC9C;
  --fg3: #897F6F;
  --fg-on-accent: #1F1C18;

  --accent:        var(--clay-400);
  --accent-hover:  var(--clay-300);
  --accent-press:  var(--clay-500);
  --accent-subtle: rgba(204, 139, 92, 0.14);
  --accent-border: rgba(204, 139, 92, 0.30);

  --border:        rgba(242, 238, 231, 0.10);
  --border-strong: rgba(242, 238, 231, 0.18);
  --ring: rgba(204, 139, 92, 0.45);

  --success: var(--green-400);
  --success-subtle: rgba(127, 176, 122, 0.16);
  --warning: var(--amber-400);
  --warning-subtle: rgba(226, 176, 90, 0.16);
  --danger:  var(--red-400);
  --danger-subtle: rgba(212, 113, 90, 0.16);

  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.4);
  --shadow-md: 0 4px 14px rgba(0, 0, 0, 0.45);
  --shadow-lg: 0 12px 32px rgba(0, 0, 0, 0.5);
  --shadow-xl: 0 24px 60px rgba(0, 0, 0, 0.55);
}

/* =============================================================
   文档版式（doc-only）
   ============================================================= */

* { box-sizing: border-box; margin: 0; padding: 0; }
html { scroll-behavior: smooth; }
body {
  background: var(--bg);
  color: var(--fg1);
  font-family: var(--font-sans);
  font-size: var(--text-body);
  line-height: var(--leading-normal);
  transition: background-color var(--dur-base) var(--ease-in-out), color var(--dur-base) var(--ease-in-out);
}
a { color: var(--accent); text-decoration: none; transition: color var(--dur-fast) var(--ease-in-out); }
a:hover { color: var(--accent-hover); }
strong { font-weight: 600; }

/* ---- 顶栏 ---- */
.site-header {
  position: sticky; top: 0; z-index: 50;
  backdrop-filter: blur(12px);
  background: color-mix(in srgb, var(--bg) 82%, transparent);
  border-bottom: 1px solid var(--border);
}
.site-header .inner {
  max-width: 1120px; margin: 0 auto;
  display: flex; align-items: center; gap: var(--space-4);
  padding: var(--space-3) var(--space-6);
}
.brand { display: flex; align-items: center; gap: var(--space-2); color: var(--fg1); }
.brand img { width: 26px; height: 26px; display: block; }
.brand .zh { font-family: var(--font-display); font-weight: 600; font-size: var(--text-body); letter-spacing: var(--tracking-snug); }
.brand .en { font-size: 0.625rem; font-weight: 600; letter-spacing: var(--tracking-caps); color: var(--fg3); text-transform: uppercase; }
.site-nav { margin-left: auto; display: flex; gap: 2px; flex-wrap: wrap; }
.site-nav a {
  padding: 5px 11px; border-radius: var(--radius-full);
  font-size: var(--text-sm); color: var(--fg2); white-space: nowrap;
  transition: background-color var(--dur-fast) var(--ease-in-out), color var(--dur-fast) var(--ease-in-out);
}
.site-nav a:hover { background: var(--accent-subtle); color: var(--accent); }
.site-nav a.active { background: var(--accent-subtle); color: var(--accent); font-weight: 600; }
.theme-btn {
  margin-left: var(--space-2);
  width: 32px; height: 32px; border-radius: var(--radius-full);
  border: 1px solid var(--border); background: var(--surface); color: var(--fg2);
  cursor: pointer; display: grid; place-items: center;
  transition: border-color var(--dur-fast) var(--ease-in-out);
}
.theme-btn:hover { border-color: var(--accent-border); color: var(--accent); }
.theme-btn svg { width: 15px; height: 15px; }

/* ---- 正文容器 ---- */
.doc { max-width: 1120px; margin: 0 auto; padding: var(--space-12) var(--space-6) var(--space-16); }

.doc-hero { max-width: 760px; margin-bottom: var(--space-10); }
.overline {
  font-size: var(--text-caption); font-weight: 600;
  letter-spacing: var(--tracking-caps); text-transform: uppercase;
  color: var(--accent); margin-bottom: var(--space-3);
}
h1 {
  font-family: var(--font-display); font-size: var(--text-display);
  font-weight: 700; line-height: var(--leading-tight); letter-spacing: var(--tracking-tight);
  margin-bottom: var(--space-4);
}
.doc-hero .lede { color: var(--fg2); font-size: var(--text-body-lg); line-height: var(--leading-relaxed); }
.doc-meta { display: flex; gap: var(--space-4); margin-top: var(--space-5); font-size: var(--text-caption); color: var(--fg3); font-family: var(--font-mono); }

section { margin-top: var(--space-12); }
h2 {
  font-family: var(--font-display); font-size: var(--text-h2); font-weight: 600;
  letter-spacing: var(--tracking-snug); line-height: var(--leading-snug);
  margin-bottom: var(--space-5);
  padding-top: var(--space-2);
}
h2 .num { color: var(--accent); font-family: var(--font-mono); font-size: var(--text-body); font-weight: 500; margin-right: var(--space-2); }
h3 { font-size: var(--text-h3); font-weight: 600; margin: var(--space-8) 0 var(--space-3); }
h4 { font-size: var(--text-body); font-weight: 600; margin: var(--space-6) 0 var(--space-2); }
p { margin-bottom: var(--space-3); color: var(--fg1); max-width: 76ch; }
p.muted, .muted { color: var(--fg2); }
ul, ol { margin: 0 0 var(--space-4) 1.25em; max-width: 76ch; }
li { margin-bottom: var(--space-1); }
li::marker { color: var(--accent); }

/* ---- 卡片与栅格 ---- */
.card {
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius-xl); padding: var(--space-6);
  box-shadow: var(--shadow-sm);
}
.grid2 { display: grid; grid-template-columns: repeat(2, 1fr); gap: var(--space-4); }
.grid3 { display: grid; grid-template-columns: repeat(3, 1fr); gap: var(--space-4); }
@media (max-width: 860px) { .grid2, .grid3 { grid-template-columns: 1fr; } }

/* 章节导航卡（index 用） */
.chapter-card {
  display: block; background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius-xl); padding: var(--space-6);
  box-shadow: var(--shadow-sm); color: var(--fg1);
  transition: box-shadow var(--dur-base) var(--ease-out), transform var(--dur-base) var(--ease-out), border-color var(--dur-base) var(--ease-out);
}
.chapter-card:hover { box-shadow: var(--shadow-md); transform: translateY(-2px); border-color: var(--accent-border); color: var(--fg1); }
.chapter-card .ic {
  width: 38px; height: 38px; border-radius: var(--radius-md);
  background: var(--accent-subtle); color: var(--accent);
  display: grid; place-items: center; margin-bottom: var(--space-3);
}
.chapter-card .ic svg { width: 19px; height: 19px; }
.chapter-card .no { font-family: var(--font-mono); font-size: var(--text-caption); color: var(--fg3); }
.chapter-card b { display: block; font-family: var(--font-display); font-size: var(--text-body-lg); font-weight: 600; margin: 2px 0 var(--space-2); }
.chapter-card p { font-size: var(--text-sm); color: var(--fg2); margin: 0; }

/* ---- 表格 ---- */
.tbl-wrap { overflow-x: auto; border: 1px solid var(--border); border-radius: var(--radius-lg); background: var(--surface); box-shadow: var(--shadow-sm); margin-bottom: var(--space-4); }
table { width: 100%; border-collapse: collapse; font-size: var(--text-sm); }
th {
  text-align: left; background: var(--bg-subtle); color: var(--fg2);
  font-size: var(--text-caption); font-weight: 600; letter-spacing: var(--tracking-wide);
  padding: 10px 14px; border-bottom: 1px solid var(--border); white-space: nowrap;
}
td { padding: 11px 14px; border-bottom: 1px solid var(--border); vertical-align: top; }
tr:last-child td { border-bottom: none; }
td code, li code, p code {
  font-family: var(--font-mono); font-size: 0.85em;
  background: var(--bg-subtle); border: 1px solid var(--border);
  padding: 1px 6px; border-radius: var(--radius-sm); white-space: nowrap;
}

/* ---- 代码块 ---- */
pre {
  background: var(--sand-900); color: #F4EFE8;
  padding: var(--space-5); border-radius: var(--radius-lg);
  overflow-x: auto; font-size: var(--text-sm); line-height: 1.65;
  margin-bottom: var(--space-4); box-shadow: var(--shadow-sm);
}
pre code { font-family: var(--font-mono); background: none; border: none; padding: 0; }
pre .c { color: #8C8270; }  /* comment */
pre .k { color: #CC8B5C; }  /* keyword (clay-400) */
pre .s { color: #7FB07A; }  /* string (green-400) */
[data-theme="dark"] pre { background: var(--surface-2); border: 1px solid var(--border); }

/* ---- 状态胶囊（色点 + 文字，铁律 7） ---- */
.pill {
  display: inline-flex; align-items: center; gap: 6px;
  padding: 2px 10px; border-radius: var(--radius-full);
  font-size: var(--text-caption); font-weight: 600; white-space: nowrap;
}
.pill .dot { width: 7px; height: 7px; border-radius: 50%; flex: none; }
.pill.ok    { background: var(--success-subtle); color: var(--success); }
.pill.ok .dot { background: var(--success); }
.pill.warn  { background: var(--warning-subtle); color: var(--warning); }
.pill.warn .dot { background: var(--warning); }
.pill.bad   { background: var(--danger-subtle); color: var(--danger); }
.pill.bad .dot { background: var(--danger); }
.pill.brand { background: var(--accent-subtle); color: var(--accent); }
.pill.brand .dot { background: var(--accent); }
.pill.dim   { background: var(--bg-subtle); color: var(--fg2); }
.pill.dim .dot { background: var(--fg3); }

/* ---- 提示块 ---- */
.callout {
  border-left: 3px solid var(--accent); background: var(--accent-subtle);
  border-radius: var(--radius-md); padding: var(--space-4) var(--space-5);
  margin: var(--space-4) 0; font-size: var(--text-sm); max-width: 86ch;
}
.callout b:first-child { display: block; margin-bottom: 4px; }
.callout.warn { border-left-color: var(--warning); background: var(--warning-subtle); }
.callout.danger { border-left-color: var(--danger); background: var(--danger-subtle); }
.callout.ok { border-left-color: var(--success); background: var(--success-subtle); }
.callout p { margin-bottom: var(--space-2); }
.callout p:last-child, .callout ul:last-child { margin-bottom: 0; }

/* ---- 流程图（CSS 盒 + 箭头） ---- */
.diagram {
  background: var(--bg-subtle); border: 1px solid var(--border);
  border-radius: var(--radius-xl); padding: var(--space-6);
  overflow-x: auto; margin-bottom: var(--space-4);
}
.diagram .cap {
  font-size: var(--text-caption); color: var(--fg3); text-align: center;
  margin-top: var(--space-4); font-family: var(--font-mono);
}
.flow { display: flex; align-items: center; gap: var(--space-2); flex-wrap: wrap; }
.flow + .flow { margin-top: var(--space-4); }
.fbox {
  background: var(--surface); border: 1.5px solid var(--border-strong);
  border-radius: var(--radius-lg); padding: var(--space-3) var(--space-4);
  min-width: 110px; text-align: center; flex: none;
  box-shadow: var(--shadow-sm);
}
.fbox b { display: block; font-size: var(--text-sm); font-weight: 600; }
.fbox span { display: block; font-size: var(--text-caption); color: var(--fg3); margin-top: 2px; }
.fbox.accent { border-color: var(--accent-border); background: var(--accent-subtle); }
.fbox.accent b { color: var(--accent); }
.fbox.ok { border-color: var(--success); background: var(--success-subtle); }
.fbox.ok b { color: var(--success); }
.fbox.warn { border-color: var(--warning); background: var(--warning-subtle); }
.fbox.warn b { color: var(--warning); }
.fbox.bad { border-color: var(--danger); background: var(--danger-subtle); }
.fbox.bad b { color: var(--danger); }
.fbox.ghost { border-style: dashed; background: transparent; }
.farr { color: var(--fg3); font-family: var(--font-mono); font-size: var(--text-sm); flex: none; padding: 0 2px; }
.fnote { font-size: var(--text-caption); color: var(--fg3); flex-basis: 100%; }

/* 分层堆叠图 */
.stack { display: flex; flex-direction: column; gap: var(--space-2); }
.stack .layer {
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius-lg); padding: var(--space-3) var(--space-5);
  display: flex; align-items: baseline; gap: var(--space-4); flex-wrap: wrap;
}
.stack .layer .t { font-weight: 600; font-size: var(--text-sm); min-width: 11em; }
.stack .layer .d { font-size: var(--text-caption); color: var(--fg2); }
.stack .layer.accent { background: var(--accent-subtle); border-color: var(--accent-border); }
.stack .layer.accent .t { color: var(--accent); }

/* ---- 翻页 ---- */
.pager {
  max-width: 1120px; margin: 0 auto; padding: 0 var(--space-6) var(--space-16);
  display: flex; justify-content: space-between; gap: var(--space-4);
}
.pager a {
  flex: 1; max-width: 380px; display: block;
  background: var(--surface); border: 1px solid var(--border);
  border-radius: var(--radius-lg); padding: var(--space-4) var(--space-5);
  color: var(--fg1); box-shadow: var(--shadow-sm);
  transition: border-color var(--dur-fast) var(--ease-in-out), box-shadow var(--dur-base) var(--ease-out);
}
.pager a:hover { border-color: var(--accent-border); box-shadow: var(--shadow-md); }
.pager a span { display: block; font-size: var(--text-caption); color: var(--fg3); margin-bottom: 2px; }
.pager a b { font-size: var(--text-sm); font-weight: 600; }
.pager a.next { text-align: right; margin-left: auto; }

footer.colophon {
  text-align: center; padding: var(--space-8) var(--space-6) var(--space-12);
  font-size: var(--text-caption); color: var(--fg3); border-top: 1px solid var(--border);
}