NextUI 架构与开发规范

1. 核心目标

建立一个物理隔离、API 稳定、文档驱动的基础 UI 框架，支持多端应用的一致性交付。

2. 物理结构

• src/NextUI.Tokens: 原子级设计变量 (JSON/C#)。
  • Exports/: 跨平台导出资源（CSS/JS/JSON），供 Blazor 和纯 HTML 页面共享使用
• src/NextUI.Assets: 品牌资产 (Fonts, Icons, SVGs)。
• src/NextUI.Core: UI 底层引擎 (i18n 翻译引擎、Theme 主题状态管理、SxComponentBase 基类)。
• src/NextUI.Blazor: 基础 UI 组件库。
  • wwwroot/js/: Blazor 组件专用的 JavaScript 文件
  • wwwroot/Styles/: Blazor 组件专用的 CSS 文件
• workbench/: (规划中) 独立开发工作台，包含组件画廊和交互式 Playground。

3. 开发铁律 (AI 与开发者必须遵守)

• 文档先行: 任何 API 修改必须先更新 docs/components/*.md。
• 基类继承: 所有 UI 组件必须继承 SxComponentBase。
• 样式解耦: 禁止使用硬编码颜色，必须引用 Token 变量。
• 三位一体: 文档、演示 (Demo)、代码必须保持物理同源（通过嵌入式资源或 MDSX 实现）。

4. 交付与集成

• 采用语义化版本号 (SemVer)。
• 通过 NuGet (本地/私有) 进行分发，确保下游应用的稳定性。