@deernova/style 0.2.0 → 0.3.1

package/skill/assets/tokens.json

@@ -0,0 +1,1686 @@
+{
+  "name": "Deernova",
+  "version": 4,
+  "themes": [
+    {
+      "id": "light",
+      "name": "浅色"
+    },
+    {
+      "id": "dark",
+      "name": "深色"
+    }
+  ],
+  "densities": [
+    {
+      "id": "desktop",
+      "name": "桌面",
+      "scenes": "Web 应用 · macOS 内容区",
+      "note": "指针操作。tokens.css 的默认值：正文 15/24，控件 28，侧边栏行 32。macOS 的侧边栏、工具栏、菜单用系统控件和系统尺寸，自己画的内容区用这一档。"
+    },
+    {
+      "id": "touch",
+      "name": "触控",
+      "scenes": "iOS · iPadOS · Web 触屏",
+      "note": "手指操作。正文 17pt，按钮看起来 36pt，点击区域至少 44pt。"
+    },
+    {
+      "id": "comfortable",
+      "name": "舒展",
+      "scenes": "官网与文档",
+      "note": "以阅读为主。字号和留白更大，控件只用于少量导航。"
+    }
+  ],
+  "scenes": [
+    {
+      "id": "web",
+      "name": "Web 应用",
+      "density": "desktop",
+      "input": "指针",
+      "apply": "tokens.css 的默认值",
+      "reference": "references/scenes/web.md"
+    },
+    {
+      "id": "web-touch",
+      "name": "Web 触屏",
+      "density": "touch",
+      "input": "触摸",
+      "apply": "`@media (pointer: coarse)` 自动切换",
+      "reference": "references/scenes/web.md"
+    },
+    {
+      "id": "macos",
+      "name": "macOS",
+      "density": "desktop",
+      "input": "指针",
+      "apply": "系统控件用系统尺寸；内容区用 `DeernovaTokens.swift` 的 `#if os(macOS)`",
+      "reference": "references/scenes/macos.md"
+    },
+    {
+      "id": "ios",
+      "name": "iOS",
+      "density": "touch",
+      "input": "触摸",
+      "apply": "`DeernovaTokens.swift` 的 `#else`",
+      "reference": "references/scenes/ios.md"
+    },
+    {
+      "id": "ipados",
+      "name": "iPadOS",
+      "density": "touch",
+      "input": "触摸和指针",
+      "apply": "同 iOS；分栏布局另见场景说明",
+      "reference": "references/scenes/ipados.md"
+    },
+    {
+      "id": "marketing",
+      "name": "官网与文档",
+      "density": "comfortable",
+      "input": "指针",
+      "apply": "根元素加 `data-density=\"comfortable\"`",
+      "reference": "references/scenes/web-marketing.md"
+    }
+  ],
+  "palette": {
+    "note": "原始色板。名字里的数字是 HSL 亮度（0 黑，100 白）。只在 tokens.json 里被语义颜色引用，代码里不要直接用。",
+    "tokens": [
+      {
+        "name": "gray-100",
+        "value": "#ffffff"
+      },
+      {
+        "name": "gray-98",
+        "value": "#fafafa"
+      },
+      {
+        "name": "gray-96",
+        "value": "#f5f5f5"
+      },
+      {
+        "name": "gray-93",
+        "value": "#ededed"
+      },
+      {
+        "name": "gray-92",
+        "value": "#ebebeb"
+      },
+      {
+        "name": "gray-91",
+        "value": "#e8e8e8"
+      },
+      {
+        "name": "gray-89",
+        "value": "#e3e3e3"
+      },
+      {
+        "name": "gray-64",
+        "value": "#a3a3a3"
+      },
+      {
+        "name": "gray-55",
+        "value": "#8c8c8c"
+      },
+      {
+        "name": "gray-54",
+        "value": "#8a8a8a"
+      },
+      {
+        "name": "gray-45",
+        "value": "#737373"
+      },
+      {
+        "name": "gray-40",
+        "value": "#666666"
+      },
+      {
+        "name": "gray-32",
+        "value": "#525252"
+      },
+      {
+        "name": "gray-18",
+        "value": "#2f2f2f"
+      },
+      {
+        "name": "gray-15",
+        "value": "#252525"
+      },
+      {
+        "name": "gray-11",
+        "value": "#1c1c1c"
+      },
+      {
+        "name": "gray-9",
+        "value": "#171717"
+      },
+      {
+        "name": "gray-7",
+        "value": "#111111"
+      },
+      {
+        "name": "teal-90",
+        "value": "#ddeeec"
+      },
+      {
+        "name": "teal-59",
+        "value": "#6cc3b4"
+      },
+      {
+        "name": "teal-27",
+        "value": "#1f6b66"
+      },
+      {
+        "name": "teal-15",
+        "value": "#183230"
+      },
+      {
+        "name": "amber-89",
+        "value": "#f5ead3"
+      },
+      {
+        "name": "amber-61",
+        "value": "#e2b054"
+      },
+      {
+        "name": "amber-29",
+        "value": "#8a5a0b"
+      },
+      {
+        "name": "amber-16",
+        "value": "#3a2e17"
+      },
+      {
+        "name": "crimson-93",
+        "value": "#f7e1e4"
+      },
+      {
+        "name": "crimson-71",
+        "value": "#f07a8a"
+      },
+      {
+        "name": "crimson-42",
+        "value": "#b0283f"
+      },
+      {
+        "name": "crimson-18",
+        "value": "#3d2027"
+      },
+      {
+        "name": "blue-92",
+        "value": "#e1ebf3"
+      },
+      {
+        "name": "blue-69",
+        "value": "#82b4dc"
+      },
+      {
+        "name": "blue-35",
+        "value": "#2c5f86"
+      },
+      {
+        "name": "blue-17",
+        "value": "#1d2c3a"
+      }
+    ]
+  },
+  "color": {
+    "note": "语义颜色，按主题取值。代码里只用这些名字。",
+    "tokens": [
+      {
+        "name": "canvas",
+        "value": {
+          "light": "{gray-96}",
+          "dark": "{gray-9}"
+        },
+        "usage": "窗口底色、Web 应用的内容区、分组列表的底色。最底层的纸面。"
+      },
+      {
+        "name": "surface",
+        "value": {
+          "light": "{gray-98}",
+          "dark": "{gray-11}"
+        },
+        "usage": "卡片、侧边栏（比内容区亮一层）。"
+      },
+      {
+        "name": "surface-raised",
+        "value": {
+          "light": "{gray-100}",
+          "dark": "{gray-15}"
+        },
+        "usage": "输入框、Composer、用户消息气泡、分组列表、弹出层。最亮的纸面。"
+      },
+      {
+        "name": "surface-sunken",
+        "value": {
+          "light": "{gray-92}",
+          "dark": "{gray-7}"
+        },
+        "usage": "代码块、展开的步骤详情。凹下去的纸面。"
+      },
+      {
+        "name": "ink",
+        "value": {
+          "light": "{gray-9}",
+          "dark": "{gray-93}"
+        },
+        "usage": "正文与标题，在四种纸面上不低于 13:1。"
+      },
+      {
+        "name": "ink-secondary",
+        "value": {
+          "light": "{gray-32}",
+          "dark": "{gray-64}"
+        },
+        "usage": "次要文字、说明、列表的值、未选中的图标，在四种纸面上不低于 6:1。"
+      },
+      {
+        "name": "ink-tertiary",
+        "value": {
+          "light": "{gray-40}",
+          "dark": "{gray-55}"
+        },
+        "usage": "占位符、时间戳、计数、分组标题，在四种纸面上不低于 4.5:1。"
+      },
+      {
+        "name": "line",
+        "value": {
+          "light": "{gray-89}",
+          "dark": "{gray-18}"
+        },
+        "usage": "分隔线、卡片描边、按钮描边。装饰性，不承载信息。"
+      },
+      {
+        "name": "line-control",
+        "value": {
+          "light": "{gray-54}",
+          "dark": "{gray-45}"
+        },
+        "usage": "输入框边框、拖拽条、链接下划线。在 canvas、surface、surface-raised 上不低于 3:1。"
+      },
+      {
+        "name": "accent",
+        "value": "{ink}",
+        "usage": "强调：主按钮填充、选中指示、焦点环。就是墨色本身，浅色主题是黑，深色主题是白。"
+      },
+      {
+        "name": "accent-soft",
+        "value": {
+          "light": "{gray-91}",
+          "dark": "{gray-18}"
+        },
+        "usage": "强调的浅底：列表图标底、输入框聚焦光晕。上面的文字用 ink。"
+      },
+      {
+        "name": "on-accent",
+        "value": {
+          "light": "{gray-100}",
+          "dark": "{gray-9}"
+        },
+        "usage": "accent 填充上的文字和图标：浅色主题白字，深色主题黑字。"
+      },
+      {
+        "name": "focus-ring",
+        "value": "{accent}",
+        "usage": "键盘焦点环：stroke-focus 宽的实线，外偏移 focus-offset。"
+      },
+      {
+        "name": "success",
+        "value": {
+          "light": "{teal-27}",
+          "dark": "{teal-59}"
+        },
+        "usage": "成功、已完成、已同步、开关打开。作为文字用在纸面和 success-soft 上。"
+      },
+      {
+        "name": "success-soft",
+        "value": {
+          "light": "{teal-90}",
+          "dark": "{teal-15}"
+        },
+        "usage": "成功状态的浅底（标签、横幅）。"
+      },
+      {
+        "name": "warning",
+        "value": {
+          "light": "{amber-29}",
+          "dark": "{amber-61}"
+        },
+        "usage": "需要注意但不阻断：额度将用完、网络较慢。"
+      },
+      {
+        "name": "warning-soft",
+        "value": {
+          "light": "{amber-89}",
+          "dark": "{amber-16}"
+        },
+        "usage": "警告状态的浅底。"
+      },
+      {
+        "name": "danger",
+        "value": {
+          "light": "{crimson-42}",
+          "dark": "{crimson-71}"
+        },
+        "usage": "错误、失败、删除。永远同时配图标或文字。"
+      },
+      {
+        "name": "danger-soft",
+        "value": {
+          "light": "{crimson-93}",
+          "dark": "{crimson-18}"
+        },
+        "usage": "错误状态的浅底、危险按钮的底色。"
+      },
+      {
+        "name": "info",
+        "value": {
+          "light": "{blue-35}",
+          "dark": "{blue-69}"
+        },
+        "usage": "中性提示。"
+      },
+      {
+        "name": "info-soft",
+        "value": {
+          "light": "{blue-92}",
+          "dark": "{blue-17}"
+        },
+        "usage": "提示状态的浅底。"
+      },
+      {
+        "name": "fill-hover",
+        "value": {
+          "light": "#0000000a",
+          "dark": "#ffffff0f"
+        },
+        "usage": "悬停底色，叠在任何纸面上（列表行、文字按钮、侧边栏项）。"
+      },
+      {
+        "name": "fill-selected",
+        "value": {
+          "light": "#00000017",
+          "dark": "#ffffff26"
+        },
+        "usage": "选中底色：侧边栏当前项、分段控件底槽、次按钮、中性标签底。比悬停明显，一眼能看出当前在哪。"
+      },
+      {
+        "name": "knob",
+        "value": {
+          "light": "{gray-100}",
+          "dark": "{gray-100}"
+        },
+        "usage": "开关的圆钮，两套主题都是白色，与系统一致。"
+      },
+      {
+        "name": "scrim",
+        "value": {
+          "light": "#00000052",
+          "dark": "#00000080"
+        },
+        "usage": "弹窗背后压暗内容的遮罩。"
+      },
+      {
+        "name": "glass-fill",
+        "value": {
+          "light": "#ffffffa6",
+          "dark": "#2a2a2aa6"
+        },
+        "platforms": [
+          "web"
+        ],
+        "usage": "仅官网与文档的页眉：用 backdrop-filter 近似玻璃。Web 应用不用玻璃；App 里用系统玻璃。"
+      },
+      {
+        "name": "glass-stroke",
+        "value": {
+          "light": "#ffffffcc",
+          "dark": "#ffffff24"
+        },
+        "platforms": [
+          "web"
+        ],
+        "usage": "仅官网与文档的页眉：玻璃边缘的高光描边。"
+      }
+    ]
+  },
+  "type": {
+    "note": "字号按角色组织，每个角色在三种密度下各有一组字号和行高。界面文字和 AI 回答都用无衬线；衬线只给 display、title 和文章类长文 prose。iOS 用文本样式，让动态字体生效。",
+    "families": {
+      "serif": "ui-serif, \"New York\", \"Iowan Old Style\", Georgia, \"PingFang SC\", serif",
+      "sans": "-apple-system, BlinkMacSystemFont, \"SF Pro Text\", \"PingFang SC\", \"Hiragino Sans GB\", system-ui, sans-serif",
+      "mono": "ui-monospace, \"SF Mono\", Menlo, \"PingFang SC\", monospace"
+    },
+    "weights": [
+      {
+        "name": "weight-regular",
+        "value": 400,
+        "usage": "正文、说明、输入的文字。"
+      },
+      {
+        "name": "weight-medium",
+        "value": 500,
+        "usage": "按钮、标签、侧边栏选中项、表单标签。"
+      },
+      {
+        "name": "weight-semibold",
+        "value": 600,
+        "usage": "标题、区块标题、列表行标题。不用 700 以上。"
+      }
+    ],
+    "roles": [
+      {
+        "name": "display",
+        "family": "serif",
+        "weight": 600,
+        "tracking": "-0.01em",
+        "sample": "还没有笔记",
+        "usage": "空状态、引导页、页面的大标题（衬线）。每屏最多一个。",
+        "values": {
+          "desktop": [
+            26,
+            32
+          ],
+          "touch": [
+            30,
+            36
+          ],
+          "comfortable": [
+            44,
+            52
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 26, weight: .semibold, design: .serif)",
+          "ios": ".system(.largeTitle, design: .serif).weight(.semibold)"
+        }
+      },
+      {
+        "name": "title",
+        "family": "serif",
+        "weight": 600,
+        "sample": "本周回顾",
+        "usage": "文章标题、弹窗标题（衬线）。",
+        "values": {
+          "desktop": [
+            18,
+            24
+          ],
+          "touch": [
+            20,
+            25
+          ],
+          "comfortable": [
+            24,
+            32
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 18, weight: .semibold, design: .serif)",
+          "ios": ".system(.title3, design: .serif).weight(.semibold)"
+        }
+      },
+      {
+        "name": "headline",
+        "family": "sans",
+        "weight": 600,
+        "sample": "最近项目",
+        "usage": "区块标题、卡片标题、横幅标题、列表行标题。",
+        "values": {
+          "desktop": [
+            15,
+            22
+          ],
+          "touch": [
+            17,
+            22
+          ],
+          "comfortable": [
+            16,
+            24
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 15, weight: .semibold)",
+          "ios": ".headline"
+        }
+      },
+      {
+        "name": "body",
+        "family": "sans",
+        "weight": 400,
+        "sample": "同步到 iCloud 后，所有设备上都能看到这条笔记。",
+        "usage": "界面正文、AI 回答、用户消息、列表、表单。",
+        "values": {
+          "desktop": [
+            15,
+            24
+          ],
+          "touch": [
+            17,
+            23
+          ],
+          "comfortable": [
+            15,
+            24
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 15)",
+          "ios": ".body"
+        }
+      },
+      {
+        "name": "prose",
+        "family": "serif",
+        "weight": 400,
+        "sample": "长文和 AI 的回答用衬线排，读起来更像一页纸，而不是一块界面。",
+        "usage": "文章、文档这类长文阅读（衬线）。AI 回答不用它。",
+        "values": {
+          "desktop": [
+            16,
+            26
+          ],
+          "touch": [
+            17,
+            26
+          ],
+          "comfortable": [
+            17,
+            28
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 16, design: .serif)",
+          "ios": ".system(.body, design: .serif)"
+        }
+      },
+      {
+        "name": "callout",
+        "family": "sans",
+        "weight": 400,
+        "sample": "上次同步：今天 09:41",
+        "usage": "说明文字、弹窗正文、输入区下方的模型和权限信息。",
+        "values": {
+          "desktop": [
+            14,
+            20
+          ],
+          "touch": [
+            15,
+            20
+          ],
+          "comfortable": [
+            14,
+            22
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 14)",
+          "ios": ".callout"
+        }
+      },
+      {
+        "name": "footnote",
+        "family": "sans",
+        "weight": 400,
+        "sample": "资料库",
+        "usage": "侧边栏分组标题、分组列表的页头页脚、卡片摘要。",
+        "values": {
+          "desktop": [
+            13,
+            18
+          ],
+          "touch": [
+            13,
+            17
+          ],
+          "comfortable": [
+            13,
+            20
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 13)",
+          "ios": ".footnote"
+        }
+      },
+      {
+        "name": "caption",
+        "family": "sans",
+        "weight": 400,
+        "sample": "3 个文件 · 12 KB",
+        "usage": "时间戳、计数、标签。界面里最小的字。",
+        "values": {
+          "desktop": [
+            12,
+            16
+          ],
+          "touch": [
+            12,
+            15
+          ],
+          "comfortable": [
+            12,
+            16
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 12)",
+          "ios": ".caption"
+        }
+      },
+      {
+        "name": "code",
+        "family": "mono",
+        "weight": 400,
+        "sample": "let total = items.reduce(0, +)",
+        "usage": "代码块、命令、文件路径、需要对齐的数据。",
+        "values": {
+          "desktop": [
+            13,
+            20
+          ],
+          "touch": [
+            13,
+            18
+          ],
+          "comfortable": [
+            13,
+            20
+          ]
+        },
+        "swiftui": {
+          "macos": ".system(size: 13, design: .monospaced)",
+          "ios": ".system(.footnote, design: .monospaced)"
+        }
+      }
+    ]
+  },
+  "space": {
+    "note": "4pt 网格。刻度是固定值；语义间距按密度取值。组与组之间的间距至少是组内的 2 倍。",
+    "tokens": [
+      {
+        "name": "space-1",
+        "value": "4px",
+        "usage": "图标与文字之间、标题与摘要之间。"
+      },
+      {
+        "name": "space-2",
+        "value": "8px",
+        "usage": "列表项内边距、横幅上下内边距、卡片网格间距。"
+      },
+      {
+        "name": "space-3",
+        "value": "12px",
+        "usage": "卡片内边距、横幅左右内边距。"
+      },
+      {
+        "name": "space-4",
+        "value": "16px",
+        "usage": "内容区里段落、工具调用行、卡片之间。"
+      },
+      {
+        "name": "space-5",
+        "value": "20px",
+        "usage": "分组之间、区块之间。"
+      },
+      {
+        "name": "space-6",
+        "value": "24px",
+        "usage": "空状态内边距、大区块之间。"
+      },
+      {
+        "name": "space-8",
+        "value": "32px",
+        "usage": "页面级留白。"
+      },
+      {
+        "name": "space-10",
+        "value": "40px",
+        "usage": "引导页、首屏的留白。"
+      },
+      {
+        "name": "space-12",
+        "value": "48px",
+        "usage": "官网与文档的章节间距。"
+      },
+      {
+        "name": "space-16",
+        "value": "64px",
+        "usage": "官网首屏的上下留白。"
+      },
+      {
+        "name": "gap-inline",
+        "values": {
+          "desktop": 6,
+          "touch": 6,
+          "comfortable": 8
+        },
+        "usage": "同一行里图标和文字之间、按钮里图标和标签之间。"
+      },
+      {
+        "name": "gap-stack",
+        "values": {
+          "desktop": 8,
+          "touch": 8,
+          "comfortable": 12
+        },
+        "usage": "同一组里相邻元素之间：表单项、卡片里的段落、并排的按钮。"
+      },
+      {
+        "name": "gap-group",
+        "values": {
+          "desktop": 24,
+          "touch": 20,
+          "comfortable": 48
+        },
+        "usage": "组与组之间：设置分组、页面区块。至少是 gap-stack 的 2 倍。"
+      },
+      {
+        "name": "page-margin",
+        "values": {
+          "desktop": 32,
+          "touch": 16,
+          "comfortable": 32
+        },
+        "usage": "页面和内容区的左右边距。"
+      }
+    ]
+  },
+  "radius": {
+    "note": "圆角刻度。各组件实际用哪一档见组件尺寸里的 *-radius。嵌套保持同心：内圆角 = 外圆角 − 内边距。",
+    "tokens": [
+      {
+        "name": "radius-xs",
+        "value": "4px",
+        "usage": "标签、复选框、小按钮。"
+      },
+      {
+        "name": "radius-sm",
+        "value": "6px",
+        "usage": "桌面端的按钮、输入框、工具栏图标按钮。"
+      },
+      {
+        "name": "radius-md",
+        "value": "8px",
+        "usage": "侧边栏选中块、代码块、弹出菜单。"
+      },
+      {
+        "name": "radius-lg",
+        "value": "12px",
+        "usage": "卡片、用户消息气泡、分组列表、任务清单。"
+      },
+      {
+        "name": "radius-xl",
+        "value": "24px",
+        "usage": "底部弹窗、触控端单行 Composer。"
+      },
+      {
+        "name": "radius-full",
+        "value": "999px",
+        "usage": "胶囊与圆形：触控端按钮、玻璃按钮、状态圆点。"
+      }
+    ]
+  },
+  "stroke": {
+    "note": "线宽。",
+    "tokens": [
+      {
+        "name": "stroke-line",
+        "value": "1px",
+        "usage": "分隔线、卡片、输入区、侧边栏和顶栏的边线。SwiftUI 里自己画的边框用 1pt，系统自带的分隔线保持系统样式。"
+      },
+      {
+        "name": "stroke-control",
+        "value": "1px",
+        "usage": "输入框边框、选中卡片的描边（配 line-control 或 ink 色）。"
+      },
+      {
+        "name": "stroke-focus",
+        "value": "2px",
+        "usage": "键盘焦点环。"
+      },
+      {
+        "name": "focus-offset",
+        "value": "2px",
+        "usage": "焦点环和控件边缘之间的距离。"
+      }
+    ]
+  },
+  "line": {
+    "note": "线形：线条画成什么样。",
+    "tokens": [
+      {
+        "name": "line-style-divider",
+        "value": "solid",
+        "usage": "分隔线、卡片和输入框的边框。界面里的线默认都是实线。"
+      },
+      {
+        "name": "line-style-dropzone",
+        "value": "dashed",
+        "usage": "拖放区、待添加的占位块。只有这类“还空着”的区域用虚线。"
+      },
+      {
+        "name": "line-dash",
+        "value": "4 4",
+        "platforms": [
+          "web"
+        ],
+        "usage": "SVG 虚线的 stroke-dasharray。"
+      },
+      {
+        "name": "line-cap",
+        "value": "round",
+        "usage": "图标和自绘线条的端点。"
+      },
+      {
+        "name": "line-join",
+        "value": "round",
+        "usage": "图标和自绘线条的拐角。"
+      }
+    ]
+  },
+  "shadow": {
+    "note": "阴影就是层级。卡片不加阴影，只有真正浮起来的东西才有。",
+    "tokens": [
+      {
+        "name": "shadow-control",
+        "value": {
+          "light": "0 1px 1px rgba(0, 0, 0, 0.05)",
+          "dark": "0 1px 1px rgba(0, 0, 0, 0.30)"
+        },
+        "usage": "第 1 层：次按钮、分段控件的选中块，一点点厚度。"
+      },
+      {
+        "name": "shadow-float",
+        "value": {
+          "light": "0 1px 2px rgba(0, 0, 0, 0.05), 0 6px 20px rgba(0, 0, 0, 0.08)",
+          "dark": "0 1px 2px rgba(0, 0, 0, 0.40), 0 6px 20px rgba(0, 0, 0, 0.45)"
+        },
+        "usage": "第 2 层：Composer、弹出菜单、弹窗、浮动面板。"
+      },
+      {
+        "name": "shadow-glass",
+        "value": {
+          "light": "0 4px 14px rgba(0, 0, 0, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.70)",
+          "dark": "0 4px 14px rgba(0, 0, 0, 0.40), inset 0 1px 0 rgba(255, 255, 255, 0.10)"
+        },
+        "platforms": [
+          "web"
+        ],
+        "usage": "仅网页：模拟玻璃的阴影和顶部高光。App 里系统玻璃自带阴影。"
+      }
+    ]
+  },
+  "layer": {
+    "note": "叠放顺序（z-index）。和阴影的层级一一对应。",
+    "tokens": [
+      {
+        "name": "z-sticky",
+        "value": 10,
+        "swift": false,
+        "usage": "吸顶的工具栏和页眉。"
+      },
+      {
+        "name": "z-dropdown",
+        "value": 100,
+        "swift": false,
+        "usage": "弹出菜单、下拉列表、popover。"
+      },
+      {
+        "name": "z-overlay",
+        "value": 1000,
+        "swift": false,
+        "usage": "遮罩和弹窗。"
+      },
+      {
+        "name": "z-toast",
+        "value": 1100,
+        "swift": false,
+        "usage": "轻提示，压在弹窗之上。"
+      }
+    ]
+  },
+  "motion": {
+    "note": "动效时长和缓动。SwiftUI 里默认用 .spring(response: 0.35, dampingFraction: 0.85)。",
+    "tokens": [
+      {
+        "name": "duration-instant",
+        "value": "120ms",
+        "usage": "悬停、按压、选中这类即时反馈。"
+      },
+      {
+        "name": "duration-base",
+        "value": "200ms",
+        "usage": "展开、收起、切换、开关。"
+      },
+      {
+        "name": "duration-slow",
+        "value": "320ms",
+        "usage": "面板滑入、页面级转场。"
+      },
+      {
+        "name": "ease-standard",
+        "value": "cubic-bezier(0.2, 0.8, 0.2, 1)",
+        "swift": false,
+        "usage": "默认缓动：快进、缓停。"
+      }
+    ]
+  },
+  "opacity": {
+    "note": "不透明度。",
+    "tokens": [
+      {
+        "name": "opacity-disabled",
+        "value": 0.35,
+        "usage": "禁用的控件。禁用时保持原位，不隐藏。"
+      },
+      {
+        "name": "opacity-solid-hover",
+        "value": 0.88,
+        "usage": "实色（accent 填充）按钮悬停和按下。"
+      }
+    ]
+  },
+  "glass": {
+    "note": "仅官网与文档的页眉：用 backdrop-filter 近似 Liquid Glass。Web 应用不用玻璃，App 里用系统玻璃。",
+    "tokens": [
+      {
+        "name": "glass-blur",
+        "value": "16px",
+        "platforms": [
+          "web"
+        ],
+        "usage": "官网页眉玻璃背后的模糊半径。"
+      },
+      {
+        "name": "glass-saturate",
+        "value": 1.4,
+        "platforms": [
+          "web"
+        ],
+        "usage": "官网页眉玻璃背后的饱和度增强。"
+      }
+    ]
+  },
+  "layout": {
+    "note": "布局尺寸。断点只能写在媒体查询里，所以不生成 CSS 变量。",
+    "tokens": [
+      {
+        "name": "content-max",
+        "value": "680px",
+        "usage": "对话栏和长文阅读栏的最大宽度。"
+      },
+      {
+        "name": "breakpoint-sm",
+        "value": "760px",
+        "css": false,
+        "usage": "窄屏：侧边栏收起，多栏变单栏。"
+      },
+      {
+        "name": "breakpoint-md",
+        "value": "960px",
+        "css": false,
+        "usage": "中等宽度：目录和次要栏收起。"
+      },
+      {
+        "name": "breakpoint-lg",
+        "value": "1280px",
+        "css": false,
+        "usage": "宽屏：内容不再继续变宽，两侧留白。"
+      },
+      {
+        "name": "hit-min",
+        "values": {
+          "desktop": 24,
+          "touch": 44,
+          "comfortable": 24
+        },
+        "usage": "最小点击区域。可见尺寸比它小时，用透明的命中区补足，不加大可见的按钮。"
+      },
+      {
+        "name": "sidebar-width",
+        "values": {
+          "desktop": 288,
+          "touch": 320,
+          "comfortable": 260
+        },
+        "usage": "侧边栏默认宽度。iPhone 没有侧边栏；macOS 用系统侧边栏，宽度只作参考。"
+      },
+      {
+        "name": "toolbar-height",
+        "values": {
+          "desktop": 44,
+          "touch": 44,
+          "comfortable": 52
+        },
+        "usage": "Web 应用顶栏、侧面板标签头的高度。macOS 用系统工具栏。"
+      }
+    ]
+  },
+  "components": [
+    {
+      "id": "button",
+      "title": "按钮",
+      "reference": "references/components/button.md",
+      "tokens": [
+        {
+          "name": "button-height-sm",
+          "values": {
+            "desktop": 24,
+            "touch": 30,
+            "comfortable": 32
+          },
+          "usage": "小按钮的可见高度：列表行、卡片角落里的行内操作。"
+        },
+        {
+          "name": "button-height-md",
+          "values": {
+            "desktop": 28,
+            "touch": 36,
+            "comfortable": 36
+          },
+          "usage": "默认按钮、图标按钮、发送按钮、步骤行的高度。"
+        },
+        {
+          "name": "button-height-lg",
+          "values": {
+            "desktop": 32,
+            "touch": 46,
+            "comfortable": 44
+          },
+          "usage": "大按钮：空状态、引导页；触控端是整页唯一的通栏主按钮。"
+        },
+        {
+          "name": "button-padding-x-sm",
+          "values": {
+            "desktop": 8,
+            "touch": 12,
+            "comfortable": 14
+          },
+          "usage": "小按钮左右内边距。上下内边距永远是 0。"
+        },
+        {
+          "name": "button-padding-x-md",
+          "values": {
+            "desktop": 12,
+            "touch": 16,
+            "comfortable": 18
+          },
+          "usage": "默认按钮左右内边距。"
+        },
+        {
+          "name": "button-padding-x-lg",
+          "values": {
+            "desktop": 16,
+            "touch": 20,
+            "comfortable": 24
+          },
+          "usage": "大按钮左右内边距。"
+        },
+        {
+          "name": "button-font-size-sm",
+          "values": {
+            "desktop": 12,
+            "touch": 13,
+            "comfortable": 13
+          },
+          "usage": "小按钮字号。"
+        },
+        {
+          "name": "button-font-size-md",
+          "values": {
+            "desktop": 14,
+            "touch": 15,
+            "comfortable": 14
+          },
+          "usage": "默认按钮字号。"
+        },
+        {
+          "name": "button-font-size-lg",
+          "values": {
+            "desktop": 14,
+            "touch": 16,
+            "comfortable": 15
+          },
+          "usage": "大按钮字号。"
+        },
+        {
+          "name": "button-font-weight",
+          "values": {
+            "desktop": 500,
+            "touch": 600,
+            "comfortable": 500
+          },
+          "unit": "",
+          "usage": "按钮字重。"
+        },
+        {
+          "name": "button-radius",
+          "values": {
+            "desktop": 6,
+            "touch": 999,
+            "comfortable": 999
+          },
+          "usage": "默认和大按钮的圆角：指针端是 radius-sm，触控端和官网是胶囊。"
+        },
+        {
+          "name": "button-radius-sm",
+          "values": {
+            "desktop": 4,
+            "touch": 999,
+            "comfortable": 999
+          },
+          "usage": "小按钮的圆角。"
+        }
+      ]
+    },
+    {
+      "id": "toolbar",
+      "title": "顶栏与侧面板",
+      "reference": "references/components/toolbar.md",
+      "tokens": [
+        {
+          "name": "toolbar-title-size",
+          "values": {
+            "desktop": 15,
+            "touch": 17,
+            "comfortable": 15
+          },
+          "usage": "顶栏标题字号（常规字重）。"
+        },
+        {
+          "name": "panel-tab-height",
+          "values": {
+            "desktop": 28,
+            "touch": 36,
+            "comfortable": 32
+          },
+          "usage": "侧面板标签头里每个标签的高度。"
+        }
+      ]
+    },
+    {
+      "id": "glass-controls",
+      "title": "玻璃操作层",
+      "reference": "references/components/glass-controls.md",
+      "tokens": [
+        {
+          "name": "glass-button-size",
+          "values": {
+            "desktop": 34,
+            "touch": 44,
+            "comfortable": 36
+          },
+          "usage": "玻璃按钮的边长：macOS 26 工具栏按钮约 34（系统绘制，这里只作参考和自绘时对齐），官网页眉的图标按钮也用它；按钮组里的按钮比它小 8。Web 应用的工具栏不用玻璃，用 button-height-md。"
+        }
+      ]
+    },
+    {
+      "id": "segmented",
+      "title": "分段控件",
+      "reference": "references/components/segmented.md",
+      "tokens": [
+        {
+          "name": "segmented-height",
+          "values": {
+            "desktop": 24,
+            "touch": 28,
+            "comfortable": 28
+          },
+          "usage": "选项块的高度；外层再加上下各 segmented-padding。"
+        },
+        {
+          "name": "segmented-padding",
+          "values": {
+            "desktop": 2,
+            "touch": 2,
+            "comfortable": 2
+          },
+          "usage": "底槽内边距。"
+        },
+        {
+          "name": "segmented-padding-x",
+          "values": {
+            "desktop": 12,
+            "touch": 16,
+            "comfortable": 16
+          },
+          "usage": "选项块左右内边距。"
+        },
+        {
+          "name": "segmented-font-size",
+          "values": {
+            "desktop": 13,
+            "touch": 14,
+            "comfortable": 14
+          },
+          "usage": "选项字号。"
+        },
+        {
+          "name": "segmented-radius",
+          "values": {
+            "desktop": 6,
+            "touch": 999,
+            "comfortable": 999
+          },
+          "usage": "底槽圆角；选项块圆角 = 它减去 segmented-padding。"
+        }
+      ]
+    },
+    {
+      "id": "text-field",
+      "title": "文本框",
+      "reference": "references/components/text-field.md",
+      "tokens": [
+        {
+          "name": "field-height",
+          "values": {
+            "desktop": 28,
+            "touch": 44,
+            "comfortable": 40
+          },
+          "usage": "单行输入框和下拉选择的高度。"
+        },
+        {
+          "name": "field-padding-x",
+          "values": {
+            "desktop": 10,
+            "touch": 12,
+            "comfortable": 14
+          },
+          "usage": "输入框左右内边距。"
+        },
+        {
+          "name": "field-font-size",
+          "values": {
+            "desktop": 14,
+            "touch": 17,
+            "comfortable": 15
+          },
+          "usage": "输入文字字号。触控端不小于 16，避免浏览器放大页面。"
+        },
+        {
+          "name": "field-radius",
+          "values": {
+            "desktop": 6,
+            "touch": 8,
+            "comfortable": 8
+          },
+          "usage": "输入框圆角。"
+        }
+      ]
+    },
+    {
+      "id": "composer",
+      "title": "Composer 输入区",
+      "reference": "references/components/composer.md",
+      "tokens": [
+        {
+          "name": "composer-radius",
+          "values": {
+            "desktop": 14,
+            "touch": 24,
+            "comfortable": 16
+          },
+          "usage": "Composer 外框圆角。"
+        },
+        {
+          "name": "composer-min-height",
+          "values": {
+            "desktop": 44,
+            "touch": 44,
+            "comfortable": 48
+          },
+          "usage": "单行时的高度：加号、输入、发送排在同一行，输入多行时向上长高。"
+        }
+      ]
+    },
+    {
+      "id": "sidebar",
+      "title": "侧边栏与列表行",
+      "reference": "references/components/sidebar.md",
+      "tokens": [
+        {
+          "name": "row-height",
+          "values": {
+            "desktop": 32,
+            "touch": 44,
+            "comfortable": 40
+          },
+          "usage": "侧边栏项、列表行的最小高度。"
+        },
+        {
+          "name": "row-padding-x",
+          "values": {
+            "desktop": 10,
+            "touch": 16,
+            "comfortable": 12
+          },
+          "usage": "行的左右内边距；分隔线从这里开始。"
+        },
+        {
+          "name": "row-radius",
+          "values": {
+            "desktop": 8,
+            "touch": 10,
+            "comfortable": 8
+          },
+          "usage": "悬停和选中底色的圆角。"
+        },
+        {
+          "name": "row-gap",
+          "values": {
+            "desktop": 2,
+            "touch": 0,
+            "comfortable": 2
+          },
+          "usage": "侧边栏项之间的间隔。触控端的列表用分隔线，不留间隔。"
+        }
+      ]
+    },
+    {
+      "id": "list",
+      "title": "分组列表与设置页",
+      "reference": "references/components/list.md",
+      "tokens": [
+        {
+          "name": "row-icon-size",
+          "values": {
+            "desktop": 20,
+            "touch": 28,
+            "comfortable": 24
+          },
+          "usage": "列表行左侧图标底的边长。"
+        },
+        {
+          "name": "switch-width",
+          "values": {
+            "desktop": 36,
+            "touch": 51,
+            "comfortable": 44
+          },
+          "usage": "开关宽度。"
+        },
+        {
+          "name": "switch-height",
+          "values": {
+            "desktop": 20,
+            "touch": 31,
+            "comfortable": 24
+          },
+          "usage": "开关高度；圆钮直径 = 高度 − 4。"
+        }
+      ]
+    },
+    {
+      "id": "card",
+      "title": "卡片",
+      "reference": "references/components/card.md",
+      "tokens": [
+        {
+          "name": "card-padding-x",
+          "values": {
+            "desktop": 16,
+            "touch": 16,
+            "comfortable": 24
+          },
+          "usage": "卡片左右内边距。"
+        },
+        {
+          "name": "card-padding-y",
+          "values": {
+            "desktop": 12,
+            "touch": 14,
+            "comfortable": 24
+          },
+          "usage": "卡片上下内边距。"
+        },
+        {
+          "name": "card-radius",
+          "values": {
+            "desktop": 12,
+            "touch": 12,
+            "comfortable": 12
+          },
+          "usage": "卡片、分组列表、任务清单的圆角。"
+        },
+        {
+          "name": "card-gap",
+          "values": {
+            "desktop": 12,
+            "touch": 12,
+            "comfortable": 16
+          },
+          "usage": "卡片网格的间距。"
+        }
+      ]
+    },
+    {
+      "id": "tag",
+      "title": "标签",
+      "reference": "references/components/tag.md",
+      "tokens": [
+        {
+          "name": "tag-height",
+          "values": {
+            "desktop": 20,
+            "touch": 22,
+            "comfortable": 24
+          },
+          "usage": "标签高度。"
+        },
+        {
+          "name": "tag-padding-x",
+          "values": {
+            "desktop": 6,
+            "touch": 8,
+            "comfortable": 10
+          },
+          "usage": "标签左右内边距。"
+        },
+        {
+          "name": "tag-font-size",
+          "values": {
+            "desktop": 12,
+            "touch": 12,
+            "comfortable": 12
+          },
+          "usage": "标签字号。"
+        },
+        {
+          "name": "tag-radius",
+          "values": {
+            "desktop": 4,
+            "touch": 999,
+            "comfortable": 999
+          },
+          "usage": "标签圆角。"
+        }
+      ]
+    },
+    {
+      "id": "code-block",
+      "title": "代码块",
+      "reference": "references/components/code-block.md",
+      "tokens": [
+        {
+          "name": "code-header-height",
+          "values": {
+            "desktop": 32,
+            "touch": 36,
+            "comfortable": 36
+          },
+          "usage": "代码块表头的高度。"
+        }
+      ]
+    },
+    {
+      "id": "task-list",
+      "title": "任务清单",
+      "reference": "references/components/task-list.md",
+      "tokens": [
+        {
+          "name": "task-row-height",
+          "values": {
+            "desktop": 28,
+            "touch": 44,
+            "comfortable": 32
+          },
+          "usage": "任务清单每一行的高度。"
+        },
+        {
+          "name": "task-glyph-size",
+          "values": {
+            "desktop": 16,
+            "touch": 20,
+            "comfortable": 18
+          },
+          "usage": "左侧状态圈的直径。"
+        }
+      ]
+    },
+    {
+      "id": "empty-state",
+      "title": "空状态",
+      "reference": "references/components/empty-state.md",
+      "tokens": [
+        {
+          "name": "empty-title-size",
+          "values": {
+            "desktop": 24,
+            "touch": 20,
+            "comfortable": 32
+          },
+          "usage": "空状态标题（衬线）字号。"
+        },
+        {
+          "name": "empty-icon-size",
+          "values": {
+            "desktop": 32,
+            "touch": 36,
+            "comfortable": 40
+          },
+          "usage": "空状态图标的边长。"
+        }
+      ]
+    },
+    {
+      "id": "banner",
+      "title": "横幅与轻提示",
+      "reference": "references/components/banner.md",
+      "tokens": [
+        {
+          "name": "toast-height",
+          "values": {
+            "desktop": 36,
+            "touch": 40,
+            "comfortable": 40
+          },
+          "usage": "轻提示胶囊的高度。"
+        },
+        {
+          "name": "banner-radius",
+          "values": {
+            "desktop": 10,
+            "touch": 12,
+            "comfortable": 12
+          },
+          "usage": "横幅和贴在输入区上方的提示条的圆角。"
+        }
+      ]
+    },
+    {
+      "id": "sheet",
+      "title": "弹窗与底部弹窗",
+      "reference": "references/components/sheet.md",
+      "tokens": [
+        {
+          "name": "sheet-radius",
+          "values": {
+            "desktop": 12,
+            "touch": 24,
+            "comfortable": 16
+          },
+          "usage": "弹窗和底部弹窗的圆角。"
+        },
+        {
+          "name": "menu-radius",
+          "values": {
+            "desktop": 8,
+            "touch": 12,
+            "comfortable": 12
+          },
+          "usage": "弹出菜单、popover 的圆角。"
+        }
+      ]
+    },
+    {
+      "id": "message",
+      "title": "消息",
+      "reference": "references/components/message.md",
+      "tokens": [
+        {
+          "name": "message-font-size",
+          "values": {
+            "desktop": 15,
+            "touch": 15,
+            "comfortable": 15
+          },
+          "usage": "用户消息气泡的字号。AI 回答用 type-body，和界面正文一致。"
+        },
+        {
+          "name": "message-action-size",
+          "values": {
+            "desktop": 24,
+            "touch": 32,
+            "comfortable": 28
+          },
+          "usage": "AI 消息下方操作按钮的可见尺寸。"
+        }
+      ]
+    },
+    {
+      "id": "icon",
+      "title": "图标",
+      "reference": "references/foundations/iconography.md",
+      "tokens": [
+        {
+          "name": "icon-size-sm",
+          "values": {
+            "desktop": 14,
+            "touch": 17,
+            "comfortable": 16
+          },
+          "usage": "按钮和标签里的图标。"
+        },
+        {
+          "name": "icon-size-md",
+          "values": {
+            "desktop": 16,
+            "touch": 20,
+            "comfortable": 18
+          },
+          "usage": "侧边栏、列表、横幅、工具栏里的图标。"
+        },
+        {
+          "name": "icon-size-lg",
+          "values": {
+            "desktop": 20,
+            "touch": 24,
+            "comfortable": 24
+          },
+          "usage": "玻璃按钮、标签栏里的图标。"
+        },
+        {
+          "name": "icon-stroke",
+          "value": "1.75px",
+          "platforms": [
+            "web"
+          ],
+          "usage": "线性图标在 24×24 viewBox 里的描边宽度，接近 SF Symbols 的常规粗细。"
+        }
+      ]
+    }
+  ]
+}