{
  "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"
      },
      {
        "name": "vermilion-91",
        "value": "#fae6df"
      },
      {
        "name": "vermilion-67",
        "value": "#ec8a6c"
      },
      {
        "name": "vermilion-41",
        "value": "#ab3e26"
      },
      {
        "name": "vermilion-17",
        "value": "#3a221b"
      },
      {
        "name": "indigo-93",
        "value": "#e2e9f5"
      },
      {
        "name": "indigo-74",
        "value": "#8db0ea"
      },
      {
        "name": "indigo-40",
        "value": "#2d5aa0"
      },
      {
        "name": "indigo-17",
        "value": "#1d2739"
      }
    ]
  },
  "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": "分隔线、卡片描边、输入框和 Composer 的浅线、按钮描边。"
      },
      {
        "name": "line-control",
        "value": {
          "light": "{gray-54}",
          "dark": "{gray-45}"
        },
        "usage": "需要明确边界的自绘控件、拖拽条、链接下划线。在 canvas、surface、surface-raised 上不低于 3:1；输入框用浅色的 line 描边，不用它。"
      },
      {
        "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": "{link}",
        "usage": "键盘焦点环的颜色，就是靛青 `link`。只在 `:focus-visible` 时画在按钮、链接、卡片、开关这类非输入控件外面，在 canvas、surface、surface-raised 上不低于 3:1。输入框和菜单项不用它。"
      },
      {
        "name": "brand",
        "value": {
          "light": "{vermilion-41}",
          "dark": "{vermilion-67}"
        },
        "usage": "朱砂，像纸上的一枚印章：只表示「AI 正在做事」。生成中、运行中的任务、思考、加载动画，以及 Deernova 的标志。只做图标、动画和一行状态文字的颜色，不做按钮、不做大面积填充。"
      },
      {
        "name": "brand-soft",
        "value": {
          "light": "{vermilion-91}",
          "dark": "{vermilion-17}"
        },
        "usage": "朱砂的浅底，少用：AI 正在写的那一段的标记底。上面的文字用 brand 或 ink。"
      },
      {
        "name": "link",
        "value": {
          "light": "{indigo-40}",
          "dark": "{indigo-74}"
        },
        "usage": "靛青，像校对的蓝笔：可以点过去的东西。链接文字、引用（产物、文件、@ 提及）、键盘焦点环。不用于按钮填充和选中行。"
      },
      {
        "name": "link-soft",
        "value": {
          "light": "{indigo-93}",
          "dark": "{indigo-17}"
        },
        "usage": "引用小块的浅底：正文里的产物、文件、@ 提及。上面的文字用 link。"
      },
      {
        "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",
      "display": "ui-serif, \"New York\", \"Iowan Old Style\", Georgia, \"Noto Serif SC\", \"Source Han Serif SC\", \"Songti SC\", \"PingFang SC\", serif"
    },
    "weights": [
      {
        "name": "weight-regular",
        "value": 400,
        "usage": "正文、说明、输入的文字。",
        "dark": 360
      },
      {
        "name": "weight-medium",
        "value": 500,
        "usage": "按钮、标签、侧边栏选中项、表单标签。",
        "dark": 460
      },
      {
        "name": "weight-semibold",
        "value": 600,
        "usage": "标题、区块标题、列表行标题。不用 700 以上。",
        "dark": 560
      }
    ],
    "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": "说明文字、弹窗正文、AI 输入框右下方的模型、权限和上下文用量。",
        "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)"
        }
      }
    ],
    "weightsNote": "深色主题里浅字在深底上显得更粗，所以每档字重减 40（400 → 360、500 → 460、600 → 560）。SF Pro 是可变字体，能渲染中间字重；苹方没有这些档位，仍按原来的字重显示。另外生成 `--weight-shift`（浅色 0、深色 -40），给自带字重的组件变量用：`calc(var(--button-font-weight) + var(--weight-shift))`。SwiftUI 只有固定档位，原生端不做补偿。"
  },
  "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": "分隔线、卡片、输入框、Composer、侧边栏和顶栏的边线。SwiftUI 里自己画的边框用 1pt，系统自带的分隔线保持系统样式。"
      },
      {
        "name": "stroke-control",
        "value": "1px",
        "usage": "确实需要明确边界的控件描边，配 line-control；输入框、下拉框用 stroke-line 加浅色 line，激活态不画深色边框。"
      },
      {
        "name": "stroke-focus",
        "value": "2px",
        "usage": "键盘焦点环的粗细。"
      },
      {
        "name": "focus-offset",
        "value": "2px",
        "usage": "焦点环和控件之间的空隙。侧边栏项、分段控件、选项行这类贴着容器的元素，环改为向内画（偏移取负的 stroke-focus）。"
      }
    ]
  },
  "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": "阴影表达层级，不用于激活装饰；输入框聚焦时只加一层 `shadow-control`，表示它浮起来可以输入。",
    "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": "轻提示，压在弹窗之上。"
      },
      {
        "name": "z-tooltip",
        "value": 1200,
        "swift": false,
        "usage": "tooltip 和悬停卡片，压在所有层之上。"
      }
    ]
  },
  "motion": {
    "note": "动效时长和缓动。进入用 ease-enter，退出用 ease-exit 并降一档时长，从屏幕边缘滑入的面板用 ease-drawer。SwiftUI 里默认用 .smooth（等同 .spring(response: 0.35, dampingFraction: 0.85) 的手感）。",
    "tokens": [
      {
        "name": "duration-instant",
        "value": "120ms",
        "usage": "悬停、按压、选中这类即时反馈；tooltip 的进出；菜单、popover 的退出。"
      },
      {
        "name": "duration-base",
        "value": "200ms",
        "usage": "菜单、popover、轻提示的进入；展开收起；弹窗和抽屉的退出。"
      },
      {
        "name": "duration-slow",
        "value": "320ms",
        "usage": "弹窗、底部弹窗、侧边抽屉的进入，页面级转场。"
      },
      {
        "name": "duration-press",
        "value": "60ms",
        "usage": "按下时底色缩小，要立刻跟手。"
      },
      {
        "name": "duration-release",
        "value": "450ms",
        "usage": "松开后底色弹回原大，配 `ease-release`。"
      },
      {
        "name": "ease-standard",
        "value": "cubic-bezier(0.2, 0.8, 0.2, 1)",
        "swift": false,
        "usage": "状态变化和展开收起：颜色、高度、箭头旋转。快进、缓停。"
      },
      {
        "name": "ease-enter",
        "value": "cubic-bezier(0.16, 1, 0.3, 1)",
        "swift": false,
        "usage": "出现：菜单、popover、弹窗、轻提示。起步快、停得很柔，前一半时间就完成大部分位移。"
      },
      {
        "name": "ease-exit",
        "value": "cubic-bezier(0.4, 0, 0.2, 1)",
        "swift": false,
        "usage": "消失：配比进入低一档的时长，不拖泥带水。"
      },
      {
        "name": "ease-drawer",
        "value": "cubic-bezier(0.32, 0.72, 0, 1)",
        "swift": false,
        "usage": "从屏幕边缘滑入滑出的面板：侧边抽屉、底部弹窗，进出都用它。"
      },
      {
        "name": "ease-release",
        "value": "linear(0, 0.2459, 0.6526, 0.9468, 1.0764, 1.0915, 1.0585, 1.0219, 0.9993, 0.9914, 0.9921, 0.9957, 0.9988, 1.0004, 1)",
        "swift": false,
        "usage": "按钮松开后底色弹回原大：带一点回弹，先冲过 1 再落回来。只用于 `transform`，配 `duration-release`。"
      },
      {
        "name": "press-scale",
        "value": 0.975,
        "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": "form-max",
        "value": "560px",
        "usage": "表单页、设置页内容栏的最大宽度。"
      },
      {
        "name": "wide-max",
        "value": "1120px",
        "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": "sidebar-width-min",
        "values": {
          "desktop": 200,
          "touch": 260,
          "comfortable": 200
        },
        "usage": "侧边栏拖动时的最小宽度。"
      },
      {
        "name": "sidebar-width-max",
        "values": {
          "desktop": 400,
          "touch": 400,
          "comfortable": 320
        },
        "usage": "侧边栏拖动时的最大宽度。"
      },
      {
        "name": "pane-width",
        "values": {
          "desktop": 320,
          "touch": 360,
          "comfortable": 320
        },
        "usage": "列表加详情里列表栏的默认宽度，也是右侧 inspector 的默认宽度。"
      },
      {
        "name": "toolbar-height",
        "values": {
          "desktop": 44,
          "touch": 44,
          "comfortable": 52
        },
        "usage": "Web 应用顶栏、侧面板标签头的高度。macOS 用系统工具栏。"
      },
      {
        "name": "grid-gutter",
        "values": {
          "desktop": 24,
          "touch": 16,
          "comfortable": 32
        },
        "usage": "官网和文档 12 栏网格的栏间距。应用里的卡片网格用 card-gap。"
      },
      {
        "name": "scrollbar-size",
        "value": "10px",
        "platforms": [
          "web"
        ],
        "usage": "网页滚动条占的宽度（横向滚动条是高度）。"
      },
      {
        "name": "scrollbar-thumb-size",
        "value": "6px",
        "platforms": [
          "web"
        ],
        "usage": "滚动条里胶囊滑块的粗细，两边各留 (scrollbar-size − 它) ÷ 2。"
      }
    ]
  },
  "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": "输入框圆角。"
        },
        {
          "name": "field-action-size",
          "values": {
            "desktop": 20,
            "touch": 32,
            "comfortable": 28
          },
          "usage": "输入框内部图标按钮（清除、显示密码）的可见尺寸，四周离边缘相等；命中区用 hit-min 补足。"
        }
      ]
    },
    {
      "id": "composer",
      "title": "Composer 输入区（AI 输入框）",
      "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": "单行布局的高度：加号、输入、发送排在同一行，输入多行时向上长高。"
        },
        {
          "name": "composer-thumb-size",
          "values": {
            "desktop": 48,
            "touch": 56,
            "comfortable": 56
          },
          "usage": "图片附件缩略图的边长。"
        },
        {
          "name": "composer-attachment-max-width",
          "value": "240px",
          "usage": "文件附件条的最大宽度，文件名放不下时中间省略。"
        }
      ]
    },
    {
      "id": "mention",
      "title": "提及与命令",
      "reference": "references/components/mention.md",
      "tokens": [
        {
          "name": "mention-height",
          "values": {
            "desktop": 20,
            "touch": 24,
            "comfortable": 22
          },
          "usage": "文字里提及标签的高度，放进正文的一行里不撑高行距。"
        },
        {
          "name": "mention-padding-x",
          "values": {
            "desktop": 4,
            "touch": 6,
            "comfortable": 6
          },
          "usage": "提及标签左右内边距。"
        },
        {
          "name": "mention-radius",
          "values": {
            "desktop": 4,
            "touch": 6,
            "comfortable": 6
          },
          "usage": "提及标签圆角。"
        },
        {
          "name": "suggest-width",
          "value": "360px",
          "usage": "@、/、# 建议浮层的宽度；窄屏时和 Composer 同宽。"
        }
      ]
    },
    {
      "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": "横幅和贴在输入区上方的提示条的圆角。"
        },
        {
          "name": "toast-max-width",
          "value": "420px",
          "usage": "轻提示的最大宽度，文字超出时截断。"
        }
      ]
    },
    {
      "id": "menu",
      "title": "菜单与下拉",
      "reference": "references/components/menu.md",
      "tokens": [
        {
          "name": "menu-item-height",
          "values": {
            "desktop": 28,
            "touch": 44,
            "comfortable": 36
          },
          "usage": "菜单项和下拉选项的高度。"
        },
        {
          "name": "menu-item-padding-x",
          "values": {
            "desktop": 8,
            "touch": 10,
            "comfortable": 10
          },
          "usage": "菜单项左右内边距。"
        },
        {
          "name": "menu-font-size",
          "values": {
            "desktop": 14,
            "touch": 17,
            "comfortable": 15
          },
          "usage": "菜单项字号。"
        },
        {
          "name": "menu-padding",
          "values": {
            "desktop": 4,
            "touch": 6,
            "comfortable": 6
          },
          "usage": "菜单面板的内边距，也是分隔线上下的间距。"
        },
        {
          "name": "menu-radius",
          "values": {
            "desktop": 8,
            "touch": 12,
            "comfortable": 12
          },
          "usage": "菜单和 popover 的圆角；菜单项的圆角 = 它减去 menu-padding。"
        },
        {
          "name": "menu-offset",
          "values": {
            "desktop": 4,
            "touch": 8,
            "comfortable": 8
          },
          "usage": "菜单和触发它的控件之间的距离。"
        },
        {
          "name": "menu-min-width",
          "values": {
            "desktop": 160,
            "touch": 220,
            "comfortable": 200
          },
          "usage": "菜单最小宽度；同时不窄于触发器。"
        },
        {
          "name": "menu-max-width",
          "value": "320px",
          "usage": "菜单最大宽度；放不下的文字用省略号。"
        }
      ]
    },
    {
      "id": "sheet",
      "title": "弹窗、抽屉与 popover",
      "reference": "references/components/sheet.md",
      "tokens": [
        {
          "name": "sheet-width-sm",
          "values": {
            "desktop": 360,
            "touch": 360,
            "comfortable": 400
          },
          "usage": "确认弹窗、只有一两句话的提示。"
        },
        {
          "name": "sheet-width-md",
          "values": {
            "desktop": 480,
            "touch": 540,
            "comfortable": 560
          },
          "usage": "默认宽度：短表单、选择分享方式这类短任务。"
        },
        {
          "name": "sheet-width-lg",
          "values": {
            "desktop": 720,
            "touch": 720,
            "comfortable": 800
          },
          "usage": "预览、较长的设置，或分两栏的内容。"
        },
        {
          "name": "sheet-padding",
          "values": {
            "desktop": 20,
            "touch": 20,
            "comfortable": 24
          },
          "usage": "弹窗内边距；标题、内容和按钮区都和它对齐。"
        },
        {
          "name": "sheet-margin",
          "values": {
            "desktop": 32,
            "touch": 8,
            "comfortable": 32
          },
          "usage": "弹窗离窗口边缘的最小距离；触屏上底部弹窗悬浮时离屏幕边缘的距离。"
        },
        {
          "name": "sheet-radius",
          "values": {
            "desktop": 12,
            "touch": 24,
            "comfortable": 16
          },
          "usage": "弹窗和底部弹窗的圆角。"
        },
        {
          "name": "sheet-grabber-width",
          "value": "36px",
          "usage": "底部弹窗顶部拖拽条的宽度。"
        },
        {
          "name": "sheet-grabber-height",
          "value": "5px",
          "usage": "拖拽条的高度。"
        },
        {
          "name": "popover-padding",
          "values": {
            "desktop": 12,
            "touch": 16,
            "comfortable": 16
          },
          "usage": "popover 的内边距；圆角用 menu-radius，宽度不超过 sheet-width-sm。"
        }
      ]
    },
    {
      "id": "tooltip",
      "title": "Tooltip 与悬停浮层",
      "reference": "references/components/tooltip.md",
      "tokens": [
        {
          "name": "tooltip-height",
          "values": {
            "desktop": 24,
            "touch": 28,
            "comfortable": 28
          },
          "usage": "单行 tooltip 的高度；折成两行时随内容长高。"
        },
        {
          "name": "tooltip-padding-x",
          "values": {
            "desktop": 8,
            "touch": 10,
            "comfortable": 10
          },
          "usage": "tooltip 左右内边距。"
        },
        {
          "name": "tooltip-font-size",
          "values": {
            "desktop": 12,
            "touch": 13,
            "comfortable": 13
          },
          "usage": "tooltip 字号。"
        },
        {
          "name": "tooltip-radius",
          "values": {
            "desktop": 6,
            "touch": 8,
            "comfortable": 8
          },
          "usage": "tooltip 圆角。"
        },
        {
          "name": "tooltip-offset",
          "value": "8px",
          "usage": "tooltip 和触发它的控件之间的距离。"
        },
        {
          "name": "tooltip-max-width",
          "value": "240px",
          "usage": "tooltip 最大宽度，超过时折行，最多两行。"
        },
        {
          "name": "tooltip-delay",
          "value": "500ms",
          "platforms": [
            "web"
          ],
          "usage": "指针停留多久后显示 tooltip 和悬停卡片。SwiftUI 的 .help() 用系统的时间。"
        },
        {
          "name": "tooltip-skip-window",
          "value": "300ms",
          "platforms": [
            "web"
          ],
          "usage": "一个 tooltip 刚关闭的这段时间里，移到相邻控件立即显示，不再等待。"
        }
      ]
    },
    {
      "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 消息下方操作按钮的可见尺寸。"
        },
        {
          "name": "cite-height",
          "values": {
            "desktop": 16,
            "touch": 18,
            "comfortable": 18
          },
          "usage": "正文里引用角标的高度。"
        }
      ]
    },
    {
      "id": "approval",
      "title": "确认与审批",
      "reference": "references/components/approval.md",
      "tokens": [
        {
          "name": "diff-line-height",
          "values": {
            "desktop": 20,
            "touch": 22,
            "comfortable": 22
          },
          "usage": "变更对比里每一行的高度。"
        },
        {
          "name": "diff-gutter-width",
          "value": "40px",
          "usage": "变更对比左侧行号栏的宽度。"
        },
        {
          "name": "approval-code-max-height",
          "value": "160px",
          "usage": "确认卡里命令、参数块的最大高度，超出时内部滚动。"
        }
      ]
    },
    {
      "id": "step-row",
      "title": "思考、工具调用与执行步骤",
      "reference": "references/components/step-row.md",
      "tokens": [
        {
          "name": "tool-key-width",
          "values": {
            "desktop": 88,
            "touch": 96,
            "comfortable": 96
          },
          "usage": "工具详情预览里参数名一栏的宽度，超长时截断。"
        },
        {
          "name": "tool-detail-max-height",
          "value": "320px",
          "usage": "工具详情（预览或 JSON）的最大高度，超出时在块内滚动。"
        }
      ]
    },
    {
      "id": "question",
      "title": "AI 提问",
      "reference": "references/components/question.md",
      "tokens": [
        {
          "name": "question-option-height",
          "values": {
            "desktop": 36,
            "touch": 48,
            "comfortable": 40
          },
          "usage": "提问卡里每个选项的最小高度（只有一行字时的高度）。"
        }
      ]
    },
    {
      "id": "notification",
      "title": "通知",
      "reference": "references/components/notification.md",
      "tokens": [
        {
          "name": "badge-size",
          "values": {
            "desktop": 16,
            "touch": 18,
            "comfortable": 16
          },
          "usage": "数字角标的高度和最小宽度。"
        },
        {
          "name": "badge-dot-size",
          "value": "8px",
          "usage": "未读和状态小圆点的直径。"
        },
        {
          "name": "notification-panel-width",
          "value": "360px",
          "usage": "通知中心浮层的宽度。"
        },
        {
          "name": "notification-panel-max-height",
          "value": "480px",
          "usage": "通知中心浮层的最大高度，超出时列表内部滚动。"
        }
      ]
    },
    {
      "id": "choice",
      "title": "选择控件",
      "reference": "references/components/choice.md",
      "tokens": [
        {
          "name": "check-size",
          "values": {
            "desktop": 16,
            "touch": 22,
            "comfortable": 18
          },
          "usage": "复选框和单选的边长。"
        },
        {
          "name": "slider-thumb-size",
          "values": {
            "desktop": 16,
            "touch": 24,
            "comfortable": 20
          },
          "usage": "滑块圆钮的直径。"
        },
        {
          "name": "slider-track-height",
          "value": "4px",
          "usage": "滑块轨道的高度。"
        }
      ]
    },
    {
      "id": "form",
      "title": "表单",
      "reference": "references/components/form.md",
      "tokens": [
        {
          "name": "form-label-width",
          "value": "160px",
          "usage": "标签在左的表单里标签栏的宽度。"
        }
      ]
    },
    {
      "id": "table",
      "title": "表格",
      "reference": "references/components/table.md",
      "tokens": [
        {
          "name": "table-row-height",
          "values": {
            "desktop": 36,
            "touch": 44,
            "comfortable": 40
          },
          "usage": "表格每一行（包括表头）的高度。"
        },
        {
          "name": "table-cell-padding-x",
          "values": {
            "desktop": 12,
            "touch": 16,
            "comfortable": 12
          },
          "usage": "单元格左右内边距。"
        }
      ]
    },
    {
      "id": "command",
      "title": "命令面板",
      "reference": "references/components/command.md",
      "tokens": [
        {
          "name": "command-width",
          "value": "560px",
          "usage": "命令面板的宽度。"
        },
        {
          "name": "command-input-height",
          "values": {
            "desktop": 48,
            "touch": 52,
            "comfortable": 52
          },
          "usage": "命令面板搜索框的高度。"
        }
      ]
    },
    {
      "id": "skeleton",
      "title": "加载状态",
      "reference": "references/components/skeleton.md",
      "tokens": [
        {
          "name": "skeleton-line-height",
          "values": {
            "desktop": 12,
            "touch": 14,
            "comfortable": 12
          },
          "usage": "骨架里每一行文字块的高度。"
        },
        {
          "name": "progress-height",
          "value": "4px",
          "usage": "进度条的高度。"
        },
        {
          "name": "shimmer-duration",
          "value": "1600ms",
          "usage": "骨架微光和文字微光扫过一次的时间。",
          "platforms": [
            "web"
          ]
        }
      ]
    },
    {
      "id": "suggestion",
      "title": "建议与新对话",
      "reference": "references/components/suggestion.md",
      "tokens": [
        {
          "name": "suggestion-max-width",
          "value": "260px",
          "usage": "起始建议按钮的最大宽度。"
        }
      ]
    },
    {
      "id": "artifact",
      "title": "产物与预览",
      "reference": "references/components/artifact.md",
      "tokens": [
        {
          "name": "artifact-card-height",
          "values": {
            "desktop": 56,
            "touch": 64,
            "comfortable": 60
          },
          "usage": "回答里产物卡片的高度。"
        },
        {
          "name": "artifact-icon-size",
          "values": {
            "desktop": 36,
            "touch": 40,
            "comfortable": 40
          },
          "usage": "产物卡片左侧类型图标块的边长。"
        }
      ]
    },
    {
      "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 的常规粗细。"
        }
      ]
    }
  ]
}
