flutter-design-system

Flutter 设计系统

构建服务于产品的语义系统，不要强加通用组件库。

流程

1. 梳理现有的 ThemeData、扩展、常量、文本样式、颜色、圆角、间距、共享组件和软件包依赖项。
2. 确定视觉语言和产品约束。阅读 references/visual-direction.md、references/typography-and-color.md 和 references/layout-and-density.md。
3. 先定义语义角色，再确定具体值：
   • 表面、内容、边框、强调色、状态和交互状态；
   • 展示、标题、正文、标签和数字排版角色；
   • 间距、圆角、海拔、图标尺寸、控件高度和动效角色。 对于跨多个领域的产品，请阅读 references/connected-product-workflows.md；为各领域设置语义强调色，同时避免拆分共享系统。
4. 将角色映射到 ColorScheme、TextTheme、组件主题和作用范围有限的 ThemeExtension。
5. 支持浅色/深色对比度和平台行为，避免在各组件中重复使用原始值。
6. 定义组件契约，涵盖行为和状态，而不仅是外观。
7. 逐步迁移。除非新系统能解决已记录的问题，否则不要替换成熟的项目基础组件。

规则

• 在组件代码中优先使用 surfaceRaised 这类语义名称，而不是 gray100 这类颜色名称。
• 如果局部组件更清晰，就不要把领域含义放进通用基础组件。
• 避免令普通 UI 修改需要深入追溯系统的过度细分令牌。
• 测试文本缩放、RTL、禁用/错误状态和主题切换。
• 修改库时保持软件包 API 稳定。

将 assets/starter/ 中的入门素材用作适配示例，而非强制架构。

交付内容

记录令牌决策、迁移边界、组件契约、主题覆盖范围和已执行的验证。说明有意设置的例外。