@aithe/aithe-ui 26.2.2 → 26.2.3

package/docs/issue/issue_26.2.3.12.md

@@ -0,0 +1,100 @@
+# Issue 26.2.3.12
+
+## 版本信息
+
+- **版本号**: 26.2.3.12
+- **基线版本**: 26.2.3
+- **类型**: Feature
+- **日期**: 2026-05-28
+
+## 变更概述
+
+1. **Markdown 渲染引擎自研** — 新增自研 Markdown 解析引擎（`src/core/markdown/`），包含插件化解析器、15 个内置插件（标题/粗斜体/链接/图片/代码块/引用/列表/表格/删除线/任务列表/锚点/脚注/数学公式/Emoji/目录），`<aithe-markdown>` 从 markdown-it 迁移至自研引擎
+2. **语法高亮引擎** — 新增 `src/core/highlight/` 语法高亮引擎，内置 38 种语言支持，基于正则匹配的轻量级实现
+3. **新 Display 组件** — 新增 `<aithe-code-editor>` 代码编辑器组件（语法高亮、行号、复制、折叠）、`<aithe-markdown-editor>` Markdown 编辑器组件（实时预览、分屏模式）、`<aithe-label>` 标签组件
+4. **Autoform 依赖联动规则引擎** — 新增 `rule-engine.ts` 规则引擎，支持字段间依赖联动、条件显隐、值计算；Autoform 和 AutoformItem 增强以支持 rules 配置
+5. **Theme CSS 变量扩展** — 22 个主题文件新增 `--aithe-code-*` CSS 变量系列（背景色、前景色、关键字、字符串、注释等语法高亮配色）
+6. **Docs-viewer 增强** — 代码块自动转换为 `<aithe-code-editor>` 渲染；guide 文档链接导航修复；新增 display/guides 页面入口
+7. **Demo 编辑器增强** — 新增 `displayCode`、`hideEditor`、`editedJson` 属性支持；新增 code/markdown-editor/label demo 页面
+8. **Autoform Demo 重构** — 重构为 `setupWithFields` 模式，新增字段配置规范化示例
+9. **i18n 扩展** — 10 个语言文件新增 display 和 guides 翻译键
+10. **文档更新** — README 组件数更新（85→90+）、新增 6 个 API 文档、guide.md 新增语法高亮/Markdown 渲染章节
+
+## 破坏性变更
+
+| 变更项                                                 | 旧值                    | 新值                                                                      |
+| ------------------------------------------------------ | ----------------------- | ------------------------------------------------------------------------- |
+| `<aithe-markdown>` 渲染引擎                            | markdown-it（第三方库） | 自研 Markdown 解析引擎（`@core/markdown`）                                |
+| `SimpleMarkdownParser` / `FullMarkdownParser` 构造函数 | 无参数                  | `new SimpleMarkdownParser(plugins?)` / `new FullMarkdownParser(plugins?)` |
+
+## 变更内容
+
+### 新增
+
+- **`src/core/markdown/parser.ts`** — Markdown 插件化解析器核心，`SimpleMarkdownParser`（行内解析）和 `FullMarkdownParser`（完整块级+行内解析），支持自定义插件注册
+- **`src/core/markdown/plugins.ts`** — 15 个内置 Markdown 解析插件：heading、bold、italic、bold-italic、link、image、code-block、inline-code、blockquote、list、table、strikethrough、task-list、anchor、footnote、math、emoji、toc
+- **`src/core/markdown/types.ts`** — Markdown 解析器类型定义：`MarkdownPlugin`、`Token`、`InlineToken`、`BlockToken`、`ParserOptions` 等
+- **`src/core/markdown/index.ts`** — Markdown 模块统一导出入口
+- **`src/core/highlight/`** — 语法高亮引擎，包含 `index.ts`（核心高亮函数）、`registry.ts`（语言注册表）、38 个语言模块（bash, c, cpp, css, dart, go, html, java, javascript, json, python, rust, typescript 等）
+- **`src/components/display/code-editor.ts`** — `<aithe-code-editor>` 代码编辑器组件，支持 `language`、`code`、`readonly`、`showLineNumbers`、`showCopyButton`、`showCollapse`、`maxHeight` 属性；语法高亮、行号显示、一键复制、代码折叠
+- **`src/components/display/markdown-editor.ts`** — `<aithe-markdown-editor>` Markdown 编辑器组件，支持 `value`、`placeholder`、`split`（分屏模式）属性；实时预览
+- **`src/components/display/label.ts`** — `<aithe-label>` 标签组件，支持 `variant`（filled/outlined）、`color`、`size`、`removable`、`icon` 属性；发射 `aithe-remove` 事件
+- **`src/core/autoform/rule-engine.ts`** — 字段依赖联动规则引擎，支持 `when`/`then` 条件规则、`visible` 显隐控制、`required` 必填控制、`value` 值计算、`options` 选项过滤
+- **`docs/api/display/code-editor.md`** — `<aithe-code-editor>` API 文档：属性、方法、事件、用法示例
+- **`docs/api/display/markdown-editor.md`** — `<aithe-markdown-editor>` API 文档：属性、事件、用法示例
+- **`docs/api/display/label.md`** — `<aithe-label>` API 文档：属性、事件、CSS Parts、用法示例
+- **`docs/highlight.md`** — 语法高亮引擎使用文档：支持语言列表、自定义语言注册、用法示例
+- **`docs/markdown.md`** — Markdown 解析引擎使用文档：插件列表、自定义插件、用法示例
+- **`docs/autoform.md`** — Autoform 规则引擎使用文档：规则配置格式、条件表达式、使用示例
+- **`src/apps/demo/pages/code.ts`** — Code Editor 独立 demo 页面，包含基础代码显示、可编辑模式、多语言示例、行号控制、折叠功能 5 个示例
+
+### 修改
+
+#### 新功能集成
+
+- **`src/index.ts`** — 新增导出 `@components/display/code-editor`、`@components/display/markdown-editor`、`@components/display/label`
+- **`docs/api/summary.md`** — Display 组件表新增 Code Editor、Markdown Editor、Label 行
+- **`src/apps/api/demo-data.ts`** — 新增 `display-code-editor`、`display-markdown-editor`、`display-label` demo 数据
+- **`src/apps/api/pages/docs.ts`** — 新增 code-editor、markdown-editor、label、guides API 文档页面入口
+- **`src/apps/demo/app.ts`** — 新增 code demo 页面路由
+- **`src/apps/demo/pages/display.ts`** — 新增 code-editor、markdown-editor、label demo 入口
+- **`src/apps/admin/router/index.ts`** — 路由配置调整
+
+#### Markdown 引擎迁移
+
+- **`src/components/display/markdown.ts`** — 从 markdown-it 迁移至自研 `@core/markdown` 解析引擎；`<aithe-markdown>` 组件使用 `FullMarkdownParser` 替代 markdown-it；移除 markdown-it 依赖代码
+- **`docs/api/display/markdown.md`** — 更新 API 文档，反映自研引擎变更
+
+#### Docs-viewer 增强
+
+- **`src/apps/api/docs-viewer.ts`** — 代码块自动转换为 `<aithe-code-editor>` 渲染（检测 `language` 属性）；guide 文档链接导航修复（相对路径解析）；新增 `.code-block` 样式
+
+#### Demo 编辑器增强
+
+- **`src/apps/demo/editor.ts`** — 新增 `displayCode` 属性（显示代码面板）、`hideEditor` 属性（隐藏编辑器）、`editedJson` 属性（编辑后的 JSON 数据）；demo 区域样式优化
+
+#### Autoform 增强
+
+- **`src/components/form/autoform.ts`** — 新增 `rules` 属性支持（JSON 字符串格式的规则配置）；集成 `RuleEngine` 进行字段依赖联动；`getValues()` 支持规则计算值
+- **`src/components/form/autoform-item.ts`** — 新增规则驱动的 `visible` 显隐控制、`required` 动态必填、`options` 动态选项过滤
+- **`src/core/autoform/index.ts`** — 新增 `RuleEngine` 导出
+- **`src/apps/demo/pages/autoform.ts`** — 重构为 `setupWithFields` 模式；新增字段配置规范化示例；新增依赖联动规则示例
+- **`docs/api/form/autoform.md`** — 更新 API 文档，新增 rules 配置说明
+
+#### Theme CSS 变量扩展
+
+- **`src/styles/theme/*.ts`**（22 个文件）— 每个主题新增 `--aithe-code-bg`、`--aithe-code-fg`、`--aithe-code-keyword`、`--aithe-code-string`、`--aithe-code-comment`、`--aithe-code-function`、`--aithe-code-number`、`--aithe-code-operator`、`--aithe-code-builtin`、`--aithe-code-attr` 等语法高亮 CSS 变量
+
+#### i18n 扩展
+
+- **`src/apps/api/i18n/*.ts`**（10 个文件）— 新增 `api.display.codeEditor`、`api.display.markdownEditor`、`api.display.label`、`api.guides.*` 翻译键
+- **`src/apps/demo/i18n/*.ts`**（10 个文件）— 新增 `demo.code.*` 翻译键（5 个示例描述）
+
+#### 文档更新
+
+- **`README.md`** — 组件总数从 85 更新至 90+；Display 组件列表新增 Code Editor、Markdown Editor、Label
+- **`docs/guide.md`** — 新增"语法高亮"章节（支持语言列表、使用方式、自定义注册）；新增"Markdown 渲染"章节（自研引擎特性、插件系统、使用方式）
+
+### 删除
+
+- **`test.jsonl`** — 测试数据文件（已添加至 git）

package/docs/issue/issue_26.2.3.13.md

@@ -0,0 +1,72 @@
+# Issue 26.2.3.13
+
+## 版本信息
+
+- **版本号**: 26.2.3.13
+- **基线版本**: 26.2.3
+- **类型**: Refactor
+- **日期**: 2026-05-29
+
+## 变更概述
+
+1. **Markdown 解析引擎重构为 AST 架构** — 从正则替换架构全面重构为两阶段 AST 解析架构（块级 → 行内），`MarkdownPlugin` 接口废弃，新增 `AstPlugin` 接口；`SimpleMarkdownParser`/`FullMarkdownParser` 构造函数移除 `linkHooks` 参数，改为 `addLinkHook()` 方法
+2. **AGENTS.md 文件体系** — 为 `src/` 和 `docs/` 下 21 个子目录创建 `AGENTS.md` 文件，用于指引 AI 编程；配置构建插件确保文件随 npm 包发布
+3. **文档同步更新** — `docs/markdown.md` 全面更新为 AST 架构文档；`docs/guide.md` 中 Markdown 解析器使用示例同步更新
+
+## 破坏性变更
+
+| 变更项                          | 旧值                                   | 新值                                                |
+| ------------------------------- | -------------------------------------- | --------------------------------------------------- |
+| `MarkdownPlugin` 接口           | `{ type, block?, regex, replace }`     | 废弃，替换为 `AstPlugin`                            |
+| `AstPlugin` 接口                | —                                      | `{ name, block?, inline? }`                         |
+| `SimpleMarkdownParser` 构造函数 | `new SimpleMarkdownParser(linkHooks?)` | `new SimpleMarkdownParser()`                        |
+| `FullMarkdownParser` 构造函数   | `new FullMarkdownParser(linkHooks?)`   | `new FullMarkdownParser()`                          |
+| `MarkdownParser.use()` 参数类型 | `MarkdownPlugin`                       | `AstPlugin`                                         |
+| `MarkdownParser.parse()` 实现   | 6 阶段正则替换（占位符/转义/恢复）     | 两阶段 AST 解析（块级 → 行内）                      |
+| `createLinkPlugin(hooks)` 导出  | 存在，用于创建带 hooks 的链接插件      | 移除，改用 `parser.addLinkHook()`                   |
+| `MarkdownParser` 新增方法       | —                                      | `parseToAst()`, `addLinkHook()`, `removeLinkHook()` |
+| `@core/markdown` 导出类型       | `MarkdownPlugin`                       | `AstNode`, `AstPlugin`, `MarkdownLinkHook`          |
+| `<aithe-markdown>` 支持语法     | 含 `autolink` `<url>`                  | 移除 `autolink` 支持                                |
+
+## 变更内容
+
+### 新增
+
+- **`src/core/markdown/parser.ts`** — AST 架构重构：新增 `parseToAst()` 方法（返回 `DocumentNode`）、`addLinkHook()`/`removeLinkHook()` 方法；新增 `renderAst()` 渲染器函数；新增 `parseInlines()` 行内解析方法；新增 `defaultInlineParser` 默认行内解析器（处理纯文本和转义）；`parse()` 方法改为基于 AST 渲染
+- **`src/core/markdown/plugins.ts`** — 全部 16 个插件从 `MarkdownPlugin`（regex/replace）重构为 `AstPlugin`（block/inline 解析器）；移除 `createLinkPlugin()` 导出函数；移除 `applyHooks()` 辅助函数
+- **`src/core/markdown/types.ts`** — 新增 `AstNode`、`AstPlugin`、`DocumentNode`、`HeadingNode`、`CodeBlockNode`、`BlockquoteNode`、`ListNode`、`ListItemNode`、`TableNode`、`TableRowNode`、`TableCellNode`、`BoldNode`、`ItalicNode`、`StrikethroughNode`、`LinkNode`、`ImageNode`、`InlineCodeNode`、`EmojiNode`、`IconNode`、`TextNode`、`LineBreakNode` 等 AST 节点类型；`MarkdownLinkHook` 类型签名不变；废弃 `MarkdownPlugin` 类型
+- **`src/core/markdown/index.ts`** — 导出类型从 `MarkdownPlugin` 更新为 `AstNode`、`AstPlugin`、`MarkdownLinkHook`
+- **`src/components/display/label.ts`** — `createParser()` 从构造函数传参改为 `addLinkHook()` 方式
+- **`src/components/display/markdown.ts`** — `createParser()` 从构造函数传参改为 `addLinkHook()` 方式；移除 `autolink` 语法说明；移除 `theme` 属性示例
+- **`vite.config.ts`** — 新增 `copyAgentsMd` 插件（`closeBundle` 钩子），将 `src/` 下所有 `AGENTS.md` 复制到 `dist/` 对应路径
+- **21 个 `AGENTS.md` 文件** — 为 `src/` 下 18 个子目录和 `docs/` 下 3 个子目录创建 AI 编程指引文件
+
+### 修改
+
+#### 核心引擎重构
+
+- **`src/core/markdown/parser.ts`** — 完整重写：984 行变更（+427/-119），从 6 阶段正则替换架构（块级插件 → 段落处理 → HTML 转义 → 占位符恢复 → 行内插件 → 后处理）重构为两阶段 AST 架构（块级解析 → 行内解析 → AST→HTML 渲染）
+- **`src/core/markdown/plugins.ts`** — 完整重写：610 行变更，全部插件从 `MarkdownPlugin` 接口迁移至 `AstPlugin` 接口；块级插件返回 `{ nodes, consumed }`，行内插件返回 `{ nodes, consumed }`
+- **`src/core/markdown/types.ts`** — 188 行变更，新增完整的 AST 节点类型体系
+- **`src/core/markdown/index.ts`** — 导出类型更新
+
+#### 组件适配
+
+- **`src/components/display/label.ts`** — `createParser()` 使用 `addLinkHook()` 替代构造函数传参
+- **`src/components/display/markdown.ts`** — `createParser()` 使用 `addLinkHook()` 替代构造函数传参；移除 `autolink` 语法支持
+
+#### 构建配置
+
+- **`vite.config.ts`** — 新增 `copyAgentsMd` 插件，确保 AGENTS.md 随 npm 包发布到 `dist/`
+
+#### 文档更新
+
+- **`docs/markdown.md`** — 全面更新为 AST 架构文档：解析流程从 6 阶段改为两阶段 AST 解析；`MarkdownPlugin` → `AstPlugin` 接口文档；插件列表移除 `createLinkPlugin`；构造函数移除 `linkHooks` 参数，改为 `addLinkHook()` 方法；自定义插件示例从 regex/replace 改为 block/inline 解析器
+- **`docs/guide.md`** — Markdown 解析器使用示例同步更新：`FullMarkdownParser` 构造函数移除 `linkHooks` 参数，改为 `addLinkHook()` 方法
+
+### 删除
+
+- **`createLinkPlugin(hooks)`** — 从 `plugins.ts` 中移除，链接 hooks 改为通过 `parser.addLinkHook()` 注册
+- **`applyHooks()` 辅助函数** — 从 `plugins.ts` 中移除，链接 hooks 逻辑移至 `MarkdownParser.applyLinkHooks()`
+- **`<aithe-markdown>` 的 `autolink` 语法支持** — 从 `markdown.ts` 组件文档中移除
+- **`<aithe-markdown>` 的 `theme` 属性** — 从 `markdown.ts` 组件文档示例中移除

package/docs/issue/issue_26.2.3.14.md

@@ -0,0 +1,130 @@
+# Issue 26.2.3.14
+
+## 版本信息
+
+- **版本号**: 26.2.3.14
+- **基线版本**: 26.2.3
+- **类型**: Feature
+- **日期**: 2026-06-01
+
+## 变更概述
+
+1. **DataHub APIStyle 业务协议解析机制** — 新增 `DataHubAPIStyle` 接口体系，支持通过 `setAPIStyle()` 设置全局业务协议解析器，自动进行请求体包装和响应解包；新增 `getBuiltinStyle()`/`getBuiltinStyleNames()` 工具函数；内置 `default`（标准 `{ code, message, data }` 结构）和 `k8s`（Kubernetes 风格）两种风格
+2. **DataHub 类型体系重构** — 类型名规范化：`AdapterRequest` → `DataHubAdapterRequest`、`AdapterResponse` → `DataHubAdapterResponse`、`StrategyConfig` → `DataHubStrategyConfig`、`StrategyType` → `DataHubStrategyType`；移除 `DataHubResponse` 类型，新增 `DataHubAPIResult` 类型；适配器 `request` 返回 `DataHubAdapterResponse`（`data` 为原始 JSON，不做业务语义假设）
+3. **DataHub 架构解耦** — 移除 `DataHubCore.ts` 中与传输层无关的业务逻辑：移除 `ApiRegistry` API 注册机制、移除 `DataHubResponse` 业务响应假设；新增 `api-styles.ts` 独立模块管理内置风格
+4. **单次请求临时指定 APIStyle** — `DataHubRequestOptions` 新增 `apiStyle` 字段，支持在单次请求中临时覆盖全局 APIStyle（传入实例或内置风格名称），`request()` 方法优先使用 `options.apiStyle`，回退到 `this.apiStyle`
+5. **Autoform 模块重构** — `rule-engine.ts` 重命名为 `autoform.ts`，合并 `FormRuleEngine` 和 `FormRegistry`；条件表达式解析逻辑提取到独立 `condition.ts`；新增 `types.ts` 统一类型定义（`FormRule`、`FormRuleType`、`FormFieldConfig`、`FormItemOption`），组件层类型引用从本地接口改为 `@core/autoform` 导出
+6. **文档同步更新** — `docs/datahub.md` 全面更新：新增 APIStyle 章节、类型参考更新、移除 API 注册相关文档；`docs/autoform.md` 和 `docs/api/form/autoform.md` 同步更新
+
+## 破坏性变更
+
+| 变更项                                               | 旧值                                            | 新值                                                        |
+| ---------------------------------------------------- | ----------------------------------------------- | ----------------------------------------------------------- |
+| `AdapterRequest` 类型名                              | `AdapterRequest`                                | `DataHubAdapterRequest`                                     |
+| `AdapterResponse` 类型名                             | `AdapterResponse`                               | `DataHubAdapterResponse`                                    |
+| `StrategyConfig` 类型名                              | `StrategyConfig`                                | `DataHubStrategyConfig`                                     |
+| `StrategyType` 类型名                                | `StrategyType`                                  | `DataHubStrategyType`                                       |
+| `DataHubResponse<T>` 类型                            | `{ duration, trace, code, message, data? }`     | 移除，替换为 `DataHubAPIResult<T>`                          |
+| `DataHubAdapterResponse.data` 类型                   | `DataHubResponse<T>`（含业务语义）              | `T`（原始 JSON，无业务假设）                                |
+| `DataHubConfig.onError` 参数类型                     | `(error, AdapterRequest)`                       | `(error, DataHubAdapterRequest)`                            |
+| `DataHubConfig.onRequest` 参数类型                   | `(req: AdapterRequest)`                         | `(req: DataHubAdapterRequest)`                              |
+| `DataHubConfig.onResponse` 参数类型                  | `(res: AdapterResponse, req: AdapterRequest)`   | `(res: DataHubAdapterResponse, req: DataHubAdapterRequest)` |
+| `createDataHub()` 导出                               | 存在，工厂函数                                  | 移除，改用 `new DataHubCore()`                              |
+| `dataHub.registerApi()` / `dataHub.getApiRegistry()` | 存在                                            | 移除                                                        |
+| `ApiRegistry` 类型                                   | 存在                                            | 移除                                                        |
+| 文件路径：`DataHubCore.ts`                           | `src/core/datahub/core/DataHubCore.ts`          | `src/core/datahub/core/datahub-core.ts`                     |
+| 文件路径：`FetchAdapter.ts`                          | `src/core/datahub/core/adapter/FetchAdapter.ts` | `src/core/datahub/core/adapter/fetch-adapter.ts`            |
+| 文件路径：`MockAdapter.ts`                           | `src/core/datahub/core/adapter/MockAdapter.ts`  | `src/core/datahub/core/adapter/mock-adapter.ts`             |
+| 文件路径：`isQuery.ts`                               | `src/core/datahub/utils/isQuery.ts`             | `src/core/datahub/utils/is-query.ts`                        |
+| `DataHubRequestOptions` 新增字段                     | —                                               | `apiStyle?: DataHubAPIStyle \| string`                      |
+| `DataHubCore` 新增方法                               | —                                               | `setAPIStyle()`, `getAPIStyle()`, `resolveRequestStyle()`   |
+| `DependencyState` 接口                               | `DependencyState`                               | `FormDependencyState`                                       |
+| `AutoformRule` 接口                                  | 定义在 `@components/form/autoform`              | 定义在 `@core/autoform`                                     |
+| `AutoformRuleType` 类型                              | 定义在 `@components/form/autoform`              | 定义在 `@core/autoform`                                     |
+| `AutoformFieldConfig` 接口                           | 定义在 `@components/form/autoform`              | 定义在 `@core/autoform`                                     |
+| `AutoformItemOption` 接口                            | 定义在 `@components/form/autoform-item`         | 定义在 `@core/autoform`                                     |
+| 文件路径：`rule-engine.ts`                           | `src/core/autoform/rule-engine.ts`              | 移除，合并到 `autoform.ts`                                  |
+
+## 变更内容
+
+### 新增
+
+- **`DataHubAPIStyle` 接口体系** — `src/core/datahub/types.ts` 新增 `DataHubAPIStyle` 接口（`onRequest`/`onResponse`/`isSuccess`）、`DataHubAPIResult<T>` 类型；`src/core/datahub/core/api-styles.ts` 新增独立模块，包含 `default` 和 `k8s` 两种内置风格实现及 `getBuiltinStyle()`/`getBuiltinStyleNames()` 工具函数
+- **`DataHubCore.setAPIStyle()` / `getAPIStyle()`** — `src/core/datahub/core/datahub-core.ts` 新增 APIStyle 管理方法，支持传入 `DataHubAPIStyle` 实例或内置风格名称字符串
+- **`DataHubCore.resolveRequestStyle()`** — `src/core/datahub/core/datahub-core.ts` 新增私有方法，优先使用 `options.apiStyle`（支持字符串名称解析），回退到 `this.apiStyle`
+- **`DataHubRequestOptions.apiStyle`** — `src/core/datahub/types.ts` 新增 `apiStyle?: DataHubAPIStyle | string` 字段，支持单次请求临时覆盖全局 APIStyle
+- **`docs/datahub.md` APIStyle 章节** — 新增 APIStyle 业务协议解析完整文档：工作机制、内置风格对比表（default/k8s）、基本用法、自定义 APIStyle 示例、单次请求临时指定示例
+
+### 修改
+
+#### DataHub 类型体系重构
+
+- **`src/core/datahub/types.ts`** — 类型名规范化：`AdapterRequest` → `DataHubAdapterRequest`、`AdapterResponse` → `DataHubAdapterResponse`、`StrategyConfig` → `DataHubStrategyConfig`、`StrategyType` → `DataHubStrategyType`；移除 `DataHubResponse<T>` 类型；`DataHubAdapterResponse.data` 从 `DataHubResponse<T>` 改为原始泛型 `T`；`DataHubConfig.onError`/`onRequest`/`onResponse` 参数类型同步更新；JSDoc 全面更新，明确 DataHub 职责边界（只处理传输层，不关心业务协议）
+
+#### DataHub 核心引擎
+
+- **`src/core/datahub/core/datahub-core.ts`** — 文件重命名（`DataHubCore.ts` → `datahub-core.ts`）；移除 `ApiRegistry` 相关代码（`registerApi()`/`getApiRegistry()`/`apiRegistry` 字段）；新增 `apiStyle` 字段和 APIStyle 管理方法；`request()` 方法中请求封装和响应解析两处改为调用 `resolveRequestStyle()` 替代直接使用 `this.apiStyle`；适配器导入路径更新（小写文件名）
+
+#### 适配器模块
+
+- **`src/core/datahub/core/adapter/fetch-adapter.ts`** — 文件重命名（`FetchAdapter.ts` → `fetch-adapter.ts`）；类型引用更新
+- **`src/core/datahub/core/adapter/mock-adapter.ts`** — 文件重命名（`MockAdapter.ts` → `mock-adapter.ts`）；类型引用更新
+- **`src/core/datahub/core/adapter/index.ts`** — 导入路径更新
+
+#### 工具模块
+
+- **`src/core/datahub/utils/is-query.ts`** — 文件重命名（`isQuery.ts` → `is-query.ts`）
+- **`src/core/datahub/utils/common.ts`** — 类型引用更新
+
+#### 策略配置
+
+- **`src/core/datahub/config/strategy.ts`** — 类型引用更新（`StrategyConfig` → `DataHubStrategyConfig`）
+
+#### 模块导出
+
+- **`src/core/datahub/index.ts`** — 导出更新：移除 `createDataHub`、`ApiRegistry`；新增 `DataHubAPIStyle`、`DataHubAPIResult`、`DataHubAdapterRequest`、`DataHubAdapterResponse`、`DataHubStrategyConfig`、`getBuiltinStyle`、`getBuiltinStyleNames`
+- **`src/core/datahub/core/index.ts`** — 导入路径更新（`DataHubCore` → `datahub-core`）
+- **`src/index.ts`** — 导出更新
+
+#### Admin 应用适配
+
+- **`src/apps/admin/datahub/auth.ts`** — 类型引用更新（`DataHubRequestOptions`）
+- **`src/apps/admin/datahub/dashboard.ts`** — 类型引用更新
+- **`src/apps/admin/datahub/index.ts`** — 移除 `registerApi` 调用；类型引用更新
+- **`src/apps/admin/datahub/menu.ts`** — 类型引用更新
+- **`src/apps/admin/datahub/mock/auth.ts`** — 类型引用更新
+- **`src/apps/admin/datahub/mock/dashboard.ts`** — 类型引用更新
+- **`src/apps/admin/datahub/mock/menu.ts`** — 类型引用更新
+- **`src/apps/admin/app.ts`** — 移除 `registerApi` 调用
+- **`src/apps/admin/pages/dashboard-page.ts`** — 类型引用更新
+- **`src/apps/admin/pages/login-page.ts`** — 类型引用更新
+- **`src/apps/admin/router/index.ts`** — 类型引用更新
+- **`src/apps/admin/store/auth.ts`** — 类型引用更新
+- **`src/apps/admin/components/admin-layout.ts`** — 类型引用更新
+
+#### Autoform 模块重构
+
+- **`src/core/autoform/autoform.ts`** — 从 `rule-engine.ts` 重命名并重构：合并 `FormRuleEngine` 和 `FormRegistry`；条件表达式解析逻辑提取到 `condition.ts`；`DependencyState` 重命名为 `FormDependencyState`；移除内联条件解析函数（`toComparable`、`compareValues`、`parseLiteral`、`evaluateCondition`），改为委托 `FormCondition`
+- **`src/core/autoform/index.ts`** — 简化为统一导出入口：移除 `FormRegistry` 类定义（移至 `autoform.ts`）；移除 `FormControlRenderer`/`FormControlContext`/`FormControlDefinition` 类型定义（移至 `autoform.ts`）；新增 `FormCondition`、`FormRule`、`FormRuleType`、`FormFieldConfig`、`FormItemOption` 导出
+- **`src/core/autoform/condition.ts`** — 新增文件：条件表达式解析器 `FormCondition`，支持 `===`/`!==`/`>`/`>=`/`<`/`<=` 运算符和字面量解析
+- **`src/core/autoform/types.ts`** — 新增文件：统一类型定义，包含 `FormRule`、`FormRuleType`、`FormFieldConfig`、`FormItemOption`
+
+#### 组件层适配
+
+- **`src/components/form/autoform.ts`** — 移除本地 `AutoformRule`、`AutoformRuleType`、`AutoformFieldConfig` 接口定义，改为 `export type { ... } from '@core/autoform'` 重导出；`normalizeOptions()`/`normalizeRules()` 方法类型更新
+- **`src/components/form/autoform-item.ts`** — 移除本地 `AutoformItemOption` 接口定义，改为 `export type { FormItemOption } from '@core/autoform'` 重导出；`renderRadioOptions()`/`renderCheckboxOptions()` 参数类型更新
+
+#### 文档更新
+
+- **`docs/autoform.md`** — 类型名同步更新
+- **`docs/api/form/autoform.md`** — 类型名同步更新
+
+### 删除
+
+- **`ApiRegistry` 类型** — 从 `types.ts` 中移除
+- **`createDataHub()` 工厂函数** — 从 `datahub/index.ts` 中移除
+- **`dataHub.registerApi()` / `dataHub.getApiRegistry()`** — 从 `DataHubCore` 中移除
+- **`DataHubResponse<T>` 类型** — 从 `types.ts` 中移除，替换为 `DataHubAPIResult<T>`
+- **`src/core/datahub/api/index.ts`** — API 注册模块文件删除
+- **`src/core/autoform/rule-engine.ts`** — 规则引擎文件删除，合并到 `autoform.ts`
+- **`AutoformRule`/`AutoformRuleType`/`AutoformFieldConfig`/`AutoformItemOption` 本地接口** — 从 `autoform.ts` 和 `autoform-item.ts` 中移除，改为从 `@core/autoform` 重导出

package/docs/issue/issue_26.2.3.15.md

@@ -0,0 +1,208 @@
+# Issue 26.2.3.15
+
+## 版本信息
+
+- **版本号**: 26.2.3.15
+- **基线版本**: 26.2.3
+- **类型**: Feature
+- **日期**: 2026-06-08
+
+## 变更概述
+
+1. **Dropdown 组件重构** — `aithe-dropdown` 从 `@components/navigation` 迁移到 `@components/data`，内部实现改为委托 `<aithe-tree-menu>` 渲染菜单，移除内联菜单渲染逻辑、键盘导航和子菜单定位逻辑；`AitheDropdownItem` 类型废弃并移除
+2. **Theme Picker 组件重构** — `aithe-theme-picker`、`aithe-shape-picker`、`aithe-shadow-picker`、`aithe-typo-picker` 四个选择器组件全面改用 `<aithe-tree-menu>` 渲染选项列表，移除内联选项渲染和浮层定位逻辑；新增 `aithe-theme-switch` 统一外观切换器组件
+3. **类型体系规范化** — `intent` 字段统一重命名为 `variant`（涉及 `AitheSelectOption`、`AitheTableColumnMeta`、`AitheTimelineItemMeta`、`AitheTreeNodeMeta`）；`AitheTreeNodeMeta` 新增 `type?: 'item' | 'divider'` 字段替代原 `divider` 布尔字段；`aithe-locale-switch` 移除内联 locale 选项数据，改为使用 `@styles/i18n` 导出的 `localeMenu`
+4. **语法高亮引擎优化** — 38 个语言文件中正则表达式优化：`[a-zA-Z0-9_]` 统一替换为 `\w`、`(?:q|w|x|r)` 替换为 `[qwxr]`、移除冗余非捕获组
+5. **Markdown 解析器 SonarQube 修复** — `parser.ts` 中 Cognitive Complexity 超标函数重构（`parseBlocks`/`_parseInlines`/`renderAst` 提取独立方法）；`for` 循环内修改循环变量改为 `while` 循环；渲染函数移入 `MarkdownParser` 类作为静态方法；`plugins.ts` 中 `RegExp.test()` 改为 `exec()`、可选链、`parseListItem()` 提取
+6. **Code Editor 国际化** — `code-editor.ts` 硬编码中文 title 替换为 `t()` 调用，10 个 locale 文件添加 `display.codeEditor.*` 翻译键；`renderToolbar` 嵌套三元提取为独立方法
+7. **Autoform 条件表达式优化** — `condition.ts` 中 `expr.match()` 改为 `re.exec()`、可选链、`[a-zA-Z0-9_]` 改为 `\w`；`autoform.ts` 演示页移除多余类型断言
+8. **AitheTranslationValue 类型清理** — 移除未定义的 `AitheTranslationValue` 类型引用，28 个 locale 文件中的类型标注改为 `string`
+9. **Admin 路由类型修复** — `router/index.ts` 使用 `export…from` 重新导出 `RouteConfig` 和 `RouteLocation`
+10. **构建配置优化** — `vite.config.ts` 新增 `litExternalPlugin()` 将 lit 标记为外部依赖；`build` 脚本顺序调整为先类型声明后构建；`lit` 升级到 `^3.3.3`，新增 `lit-html` 依赖
+11. **文档同步更新** — 新增 `aithe-dropdown`、`aithe-metrics`、`aithe-metrics-group`、`aithe-theme-switch` API 文档；`aithe-sidebar` 新增 `itemFilter` 属性文档；`docs/` 下多个指南文档更新
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `aithe-dropdown` 导入路径 | `@components/navigation/dropdown` | `@components/data/dropdown` |
+| `AitheDropdownItem` 类型 | 存在（`AitheTreeNodeMeta` 别名） | 移除 |
+| `AitheSelectOption.intent` | `intent?: AitheVariant` | `variant?: AitheVariant` |
+| `AitheTableColumnMeta.intent` | `intent?: AitheVariant` | `variant?: AitheVariant` |
+| `AitheTimelineItemMeta.type` | `type?: AitheVariant` | `variant?: AitheVariant` |
+| `AitheTreeNodeMeta.intent` | `intent?: AitheVariant` | `variant?: AitheVariant` |
+| `AitheTreeNodeMeta.divider` | `divider?: boolean` | 移除，替换为 `type?: 'item' \| 'divider'` |
+| `aithe-dropdown` 内部实现 | 内联菜单渲染 + 键盘导航 + 子菜单定位 | 委托 `<aithe-tree-menu>` |
+| `aithe-theme-picker` 内部实现 | 内联选项渲染 + 浮层定位 | 委托 `<aithe-tree-menu>` |
+| `aithe-shape-picker` 内部实现 | 内联选项渲染 + 浮层定位 | 委托 `<aithe-tree-menu>` |
+| `aithe-shadow-picker` 内部实现 | 内联选项渲染 + 浮层定位 | 委托 `<aithe-tree-menu>` |
+| `aithe-typo-picker` 内部实现 | 内联选项渲染 + 浮层定位 | 委托 `<aithe-tree-menu>` |
+| `aithe-locale-switch` 内部实现 | 内联 locale 选项数据 | 使用 `@styles/i18n` 的 `localeMenu` |
+| `AitheTranslationValue` 类型 | 从 `@styles/i18n` 导入 | 移除，改用 `string` |
+| `@index.ts` 导出路径：`dropdown` | `@components/navigation/dropdown` | `@components/data/dropdown` |
+| `@index.ts` 新增导出 | — | `aithe-metrics`、`aithe-metrics-group`、`aithe-theme-switch` |
+
+## 变更内容
+
+### 新增
+
+- **`aithe-theme-switch` 组件** — `src/components/theme/theme-switch.ts` 新增统一外观切换器，整合主题/阴影/形状/排版在单个下拉菜单中，使用 `<aithe-tree-menu>` 渲染
+- **`aithe-metrics` 组件** — `src/components/framework/metrics.ts` 新增指标卡片组件
+- **`aithe-metrics-group` 组件** — `src/components/framework/metrics-group.ts` 新增指标卡片组容器组件
+- **`AitheSidebarItemFilter` 类型** — `src/core/types.ts` 新增侧边栏菜单项过滤回调类型
+- **`AitheTreeNodeMeta.type` 字段** — `src/core/types.ts` 新增 `type?: 'item' | 'divider'` 字段
+- **`litExternalPlugin()`** — `vite.config.ts` 新增 lit 外部化插件，将 lit 标记为外部依赖
+- **`docs/api/data/dropdown.md`** — 新增 `aithe-dropdown` API 文档（迁移后）
+- **`docs/api/framework/metrics.md`** — 新增 `aithe-metrics` API 文档
+- **`docs/api/framework/metrics-group.md`** — 新增 `aithe-metrics-group` API 文档
+- **`docs/api/theme/theme-switch.md`** — 新增 `aithe-theme-switch` API 文档
+- **`src/utils/icon.ts`** — 新增图标工具模块
+
+### 修改
+
+#### Dropdown 组件重构
+
+- **`src/components/navigation/dropdown.ts`** — 移除内联菜单渲染逻辑（`renderMenu`/`renderItem`/`renderDivider`/`renderShortcut`）、键盘导航（`handleKeydown`）、子菜单定位（`updateSubmenuPosition`/`submenuDirection`）；改为委托 `<aithe-tree-menu>` 渲染；移除 `aitheScrollbarStyles`、`classMap`、`translateNodeLabel`、`onAitheLocaleChange` 依赖；`openMap`/`submenuDirection` 状态替换为 `activeId`
+- **`src/components/data/dropdown.ts`** — 新增文件，从 `navigation` 迁移并重构后的 `aithe-dropdown` 组件
+- **`docs/api/navigation/dropdown.md`** — 删除（迁移到 `docs/api/data/dropdown.md`）
+
+#### Theme Picker 组件重构
+
+- **`src/components/theme/theme-picker.ts`** — 移除内联选项渲染、浮层定位、`computeFloatingPosition` 依赖；改为委托 `<aithe-tree-menu>` 渲染主题选项
+- **`src/components/theme/shape-picker.ts`** — 同上，形状选择器重构
+- **`src/components/theme/shadow-picker.ts`** — 同上，阴影选择器重构
+- **`src/components/theme/typo-picker.ts`** — 同上，排版选择器重构
+- **`src/components/theme/locale-switch.ts`** — 移除内联 `BUILTIN_LOCALE_LABELS`/`LocaleOption` 定义，改为使用 `@styles/i18n` 导出的 `localeMenu`
+
+#### 类型体系规范化
+
+- **`src/core/types.ts`** — `AitheSelectOption.intent` → `variant`；`AitheTableColumnMeta.intent` → `variant`；`AitheTimelineItemMeta.type` → `variant`；`AitheTreeNodeMeta.intent` → `variant`、`divider` 移除、新增 `type` 字段；移除 `AitheDropdownItem` 类型；新增 `AitheSidebarItemFilter` 类型
+- **`src/components/basic/avatar.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/basic/icon.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/data/table.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/data/table-column.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/data/timeline.ts`** — `type` 引用更新为 `variant`
+- **`src/components/data/tree.ts`** — `intent`/`divider` 引用更新为 `variant`/`type`
+- **`src/components/data/tree-menu.ts`** — `intent`/`divider` 引用更新为 `variant`/`type`；`renderItems` 中嵌套三元提取为独立 `iconContent` 变量
+- **`src/components/form/combobox.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/form/select.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/form/switch.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/form/rate.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/form/form-item.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/form/autoform-item.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/display/markdown-editor.ts`** — `intent` 引用更新为 `variant`
+- **`src/components/framework/header.ts`** — `intent`/`divider` 引用更新为 `variant`/`type`
+- **`src/components/framework/sidebar.ts`** — `intent`/`divider` 引用更新为 `variant`/`type`；新增 `itemFilter` 属性
+- **`src/components/framework/dashboard.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/admin/components/admin-layout.ts`** — `intent`/`divider` 引用更新为 `variant`/`type`
+- **`src/apps/admin/pages/dashboard-page.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/admin/pages/login-page.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/admin/datahub/auth.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/admin/datahub/dashboard.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/admin/datahub/index.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/admin/datahub/menu.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/demo/pages/autoform.ts`** — `intent` 引用更新为 `variant`；移除多余 `as AutoformElement | null` 类型断言
+- **`src/apps/demo/pages/basic.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/demo/pages/data.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/demo/pages/navigation.ts`** — `intent` 引用更新为 `variant`
+- **`src/apps/demo/editor.ts`** — `intent` 引用更新为 `variant`
+
+#### 语法高亮引擎优化
+
+- **`src/core/highlight/lang-bash.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-c.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-cpp.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-dart.ts`** — `[a-zA-Z0-9_]` → `\w`；移除冗余非捕获组
+- **`src/core/highlight/lang-dockerfile.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-fsharp.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-go.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-java.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-jsonline.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-kotlin.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-latex.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-lua.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-markdown.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-objectivec.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-perl.ts** — `[a-zA-Z0-9_]` → `\w`；`(?:q|w|x|r)` → `[qwxr]`
+- **`src/core/highlight/lang-powershell.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-python.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-r.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-ruby.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-rust.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-scala.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-swift.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/lang-wasm.ts`** — `[a-zA-Z0-9_]` → `\w`
+- **`src/core/highlight/registry.ts`** — `[a-zA-Z0-9_]` → `\w`
+
+#### Markdown 解析器 SonarQube 修复
+
+- **`src/core/markdown/parser.ts`** — `createDefaultInlineParser` 中 `for` 循环内 `i++` 修改循环变量改为 `while` 循环；`parseBlocks` 提取 `_matchBlockPlugin`/`_collectParagraph`/`_isBlockStart`；`_parseInlines` 提取 `_matchInlinePlugin`/`_collectPlainText`；`renderAst` 提取 `renderCodeBlock`/`renderListItem`/`renderTable` 独立函数；`esc`/`renderAst`/`renderCodeBlock`/`renderListItem`/`renderTable`/`renderChildren` 移入 `MarkdownParser` 类作为静态方法；修复类结构（闭合 `MarkdownParser`、删除重复代码、恢复 `SimpleMarkdownParser`/`FullMarkdownParser` 为独立类）
+- **`src/core/markdown/plugins.ts`** — `RegExp.test()` 改为 `RegExp.exec()`；`lines[0]!` 守卫 + 可选链；`listPlugin` 嵌套 `if/else if` 提取为 `parseListItem()`；`while` + `line &&` 改为 `for...of` + `line?.includes('|')`
+
+#### Code Editor 国际化
+
+- **`src/components/display/code-editor.ts`** — `renderToolbar` 拆分为 7 个独立方法消除嵌套三元；硬编码中文 title 替换为 `t('display.codeEditor.xxx', 'English fallback')` 国际化调用
+- **`src/styles/i18n/locales/*.ts`** — 10 个 locale 文件添加 `display.codeEditor.*` 翻译键
+
+#### Autoform 条件表达式优化
+
+- **`src/core/autoform/condition.ts`** — `expr.match()` 改为 `re.exec()`；可选链；`[a-zA-Z0-9_]` 改为 `\w`
+
+#### AitheTranslationValue 类型清理
+
+- **`src/apps/admin/i18n/*.ts`** — 10 个文件：移除 `AitheTranslationValue` 导入，类型改为 `string`
+- **`src/apps/api/i18n/*.ts`** — 10 个文件：移除 `AitheTranslationValue` 导入，类型改为 `string`
+- **`src/apps/demo/i18n/*.ts`** — 10 个文件：移除 `AitheTranslationValue` 导入，类型改为 `string`
+
+#### Admin 路由类型修复
+
+- **`src/apps/admin/router/index.ts`** — 使用 `export…from` 重新导出 `RouteConfig` 和 `RouteLocation`
+
+#### 构建配置优化
+
+- **`vite.config.ts`** — 新增 `litExternalPlugin()` 插件；`build` 脚本顺序调整为先 `tsc --emitDeclarationOnly` 后 `vite build`
+- **`package.json`** — `lit` 从 `^3.2.1` 升级到 `^3.3.3`；新增 `lit-html` 依赖
+
+#### 样式体系更新
+
+- **`src/styles/theme/index.ts`** — 新增主题配置
+- **`src/styles/shadow/index.ts`** — 新增阴影配置
+- **`src/styles/shape/index.ts`** — 新增形状配置
+- **`src/styles/typo/index.ts`** — 新增排版配置
+- **`src/styles/aithe-ui.ts`** — 样式单例更新
+- **`src/styles/i18n/index.ts`** — 重构：locale 菜单数据提取到 `localeMenu` 导出；`eslint-disable-next-line prefer-replace-all` 注释消除误报
+
+#### 文档更新
+
+- **`docs/api/summary.md`** — 新增组件条目
+- **`docs/api/AGENTS.md`** — 更新
+- **`docs/api/basic/avatar.md`** — 属性名同步更新
+- **`docs/api/basic/icon.md`** — 属性名同步更新
+- **`docs/api/data/table.md`** — 属性名同步更新
+- **`docs/api/data/table-column.md`** — 属性名同步更新
+- **`docs/api/data/timeline.md`** — 属性名同步更新
+- **`docs/api/data/tree-menu.md`** — 属性名同步更新
+- **`docs/api/data/tree.md`** — 属性名同步更新
+- **`docs/api/form/combobox.md`** — 属性名同步更新
+- **`docs/api/form/select.md`** — 属性名同步更新
+- **`docs/api/form/switch.md`** — 属性名同步更新
+- **`docs/api/framework/dashboard.md`** — 属性名同步更新
+- **`docs/api/framework/header.md`** — 属性名同步更新
+- **`docs/api/framework/sidebar.md`** — 属性名同步更新；新增 `itemFilter` 文档
+- **`docs/api/theme/locale-switch.md`** — 属性名同步更新
+- **`docs/api/theme/shadow-picker.md`** — 属性名同步更新
+- **`docs/api/theme/shape-picker.md`** — 属性名同步更新
+- **`docs/api/theme/theme-picker.md`** — 属性名同步更新
+- **`docs/api/theme/typo-picker.md`** — 属性名同步更新
+- **`docs/datahub.md`** — 更新
+- **`docs/framework-integration.md`** — 更新
+- **`docs/guide.md`** — 更新
+- **`docs/i18n.md`** — 更新
+- **`docs/quickstart.md`** — 更新
+- **`docs/theming.md`** — 更新
+
+### 删除
+
+- **`AitheDropdownItem` 类型** — 从 `src/core/types.ts` 中移除
+- **`AitheTreeNodeMeta.divider` 字段** — 从 `src/core/types.ts` 中移除，替换为 `type`
+- **`docs/api/navigation/dropdown.md`** — 删除（迁移到 `docs/api/data/dropdown.md`）

package/docs/issue/issue_26.2.3.16.md

@@ -0,0 +1,88 @@
+# Issue 26.2.3.16
+
+## 版本信息
+
+- **版本号**: 26.2.3.16
+- **基线版本**: 26.2.3
+- **类型**: Feature
+- **日期**: 2026-06-10
+
+## 变更概述
+
+1. **新增 3 套云厂商主题** — 新增 `huawei`（华为云红）、`tianyi`（天翼云蓝）、`aliyun`（阿里云橙）三套亮色主题，模拟主流云厂商官网色彩风格；`themeMenu` 新增 `cloud-group` 分组；`AitheBuiltinTheme` 类型扩展；`theme-picker` 和 `theme-switch` 适配新分组
+2. **AitheWidget 抽象基类** — `src/core/aithe-widget.ts` 新增 `AitheWidget` 抽象基类，定义 `params`（通用配置）和 `data`（通用数据）两个抽象属性，作为仪表盘面板业务组件的基类
+3. **Metrics 组件数据驱动模式重构** — `aithe-metrics` 和 `aithe-metrics-group` 从继承 `AitheElement` 改为继承 `AitheWidget`，`data`/`params` 替代原 `items` 和 `data` 属性；`aithe-metrics` 新增 `align` 对齐和 `scale` 尺寸规格属性，支持 `left/center/right` 三种对齐和 `small/normal/large` 三种尺寸
+4. **文档同步更新** — `README.md` 主题数量从 22 更新为 25，新增 Cloud 系主题表格；`docs/theming.md` 新增 Cloud 系主题章节；`docs/guide.md` 主题数量同步更新；`docs/api/data/metrics.md` 和 `docs/api/data/metrics-group.md` 新增 `align`/`scale`/`params`/`data` 属性文档
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `aithe-metrics` 基类 | `AitheElement` | `AitheWidget` |
+| `aithe-metrics-group` 基类 | `AitheElement` | `AitheWidget` |
+| `aithe-metrics.data` 类型 | `MetricsData \| null` | `MetricsData \| MetricsData[] \| null` |
+| `aithe-metrics-group.items` 属性 | `MetricsData[] \| null` | 移除，替换为 `data` |
+| `aithe-metrics-group.data` 属性 | — | 新增，`MetricsData \| MetricsData[] \| null` |
+| `aithe-metrics-group.params` 属性 | — | 新增，`MetricsGroupParams` |
+| `aithe-metrics.params` 属性 | — | 新增，`MetricsData` |
+| `AitheBuiltinTheme` 类型 | 24 个主题名 | 新增 `huawei`、`tianyi`、`aliyun` |
+| `themeMenu` 分组 | `light-group`、`dark-group` | 新增 `cloud-group` |
+| `aithe-metrics` 默认 `align` | 无对齐属性 | `'center'` |
+| `aithe-metrics` 默认 `scale` | 无尺寸规格 | `'small'` |
+
+## 变更内容
+
+### 新增
+
+- **`AitheWidget` 抽象基类** — `src/core/aithe-widget.ts` 新增，继承 `AitheElement`，定义 `abstract params: object` 和 `abstract data: unknown` 两个抽象属性，作为仪表盘面板业务组件的统一基类
+- **`huawei` 主题** — `src/styles/theme/huawei.ts` 新增华为云风格亮色主题，primary 色 `#CF102D`
+- **`tianyi` 主题** — `src/styles/theme/tianyi.ts` 新增天翼云风格亮色主题，primary 色 `#0052CC`
+- **`aliyun` 主题** — `src/styles/theme/aliyun.ts` 新增阿里云风格亮色主题，primary 色 `#FF6A00`
+- **`CLOUD_THEMES` 常量** — `src/styles/theme/index.ts` 新增云厂商主题列表
+- **`themeMenu` 新增 `cloud-group`** — `src/styles/theme/index.ts` 主题菜单新增 Cloud 分组
+- **`MetricsAlign` 类型** — `src/components/data/metrics.ts` 新增 `'left' | 'center' | 'right'`
+- **`MetricsScale` 类型** — `src/components/data/metrics.ts` 新增 `'small' | 'normal' | 'large'`
+- **`MetricsData.align` 字段** — `src/components/data/metrics.ts` 新增对齐方式字段
+- **`MetricsData.scale` 字段** — `src/components/data/metrics.ts` 新增尺寸规格字段
+- **`MetricsGroupParams` 接口** — `src/components/data/metrics-group.ts` 新增 `direction`/`gap`/`align` 配置接口
+- **`aithe-metrics` 的 `align` 属性** — 新增 CSS 反射属性，支持 `left/center/right` 三种对齐方式，含对应 CSS 样式
+- **`aithe-metrics` 的 `scale` 属性** — 新增 CSS 反射属性，支持 `small/normal/large` 三种尺寸规格，含对应 CSS 样式（value 字体从 32px/48px/64px 三级，label 字体从 16px/18px/20px 三级）
+- **`aithe-metrics-group` 数据驱动模式** — 新增通过 `params` + `data` 的数据驱动渲染，`data` 支持单个 `MetricsData` 对象自动包装为数组
+- **`aithe-metrics` 数据驱动模式** — 新增通过 `params` + `data` 的数据驱动渲染，`params` 同名字段优先级高于 `data`
+- **API 演示示例** — `src/apps/api/demo-data.ts` 新增 `align` 和 `scale` 演示示例
+
+### 修改
+
+#### 主题系统扩展
+
+- **`src/styles/theme/index.ts`** — 导入并注册 `huaweiThemeTokens`/`tianyiThemeTokens`/`aliyunThemeTokens`；`THEME_COLORS` 新增三个云厂商主题色；`DARK_THEMES` 保持不变；新增 `CLOUD_THEMES` 导出；`themeMenu` 新增 `cloud-group` 分组
+- **`src/styles/types.ts`** — `AitheBuiltinTheme` 联合类型新增 `'huawei'`、`'tianyi'`、`'aliyun'`
+
+#### 组件适配
+
+- **`src/components/theme/theme-picker.ts`** — `handleTreeSelect` 中新增 `'cloud-group'` 跳过逻辑
+- **`src/components/theme/theme-switch.ts`** — `buildThemeMenu` 中 `cloud-group` 的 i18n 键映射为 `'theme.cloud'`
+
+#### Metrics 组件重构
+
+- **`src/components/data/metrics.ts`** — 基类从 `AitheElement` 改为 `AitheWidget`；移除 `data` 独立属性，改为 `override data`；新增 `override params`；新增 `align`/`scale` 反射属性；`render()` 中解析优先级为 `params` → `data` → 独立属性；`data` 支持数组（取首项）；新增 `align`/`scale` CSS 样式
+- **`src/components/data/metrics-group.ts`** — 基类从 `AitheElement` 改为 `AitheWidget`；移除 `items` 属性，改为 `override data`；新增 `override params`；`render()` 中解析优先级为 `params` → 独立属性；`data` 支持单个对象自动包装为数组；新增 `flex: 1` 样式使子元素等宽
+
+#### 文档更新
+
+- **`README.md`** — 主题数量 22 → 25；新增 Cloud 系主题表格（huawei/tianyi/aliyun）；目录结构主题数量同步更新
+- **`docs/theming.md`** — 主题数量 22 → 25；新增 Cloud 系主题章节，含 3 种主题说明和品牌色
+- **`docs/guide.md`** — 主题数量 22 → 25
+- **`docs/api/data/metrics.md`** — 新增 `align`/`scale`/`params` 属性文档；`data` 类型更新为支持数组；新增对齐方式、尺寸规格、params 覆盖示例
+- **`docs/api/data/metrics-group.md`** — 新增 `data`/`params` 属性文档；新增 params 覆盖示例
+
+### 删除
+
+- **`aithe-metrics-group.items` 属性** — 移除，替换为 `data` 属性
+
+### 代码/注释/文档一致性修复
+
+- **`src/components/data/metrics.ts` JSDoc** — 修正 `params` 优先级描述：原描述称 `params` 同名字段优先级高于 `data`，实际实现中 `params` 仅覆盖布局字段（align/scale/showDivider），内容字段（label/value/variant）不从 `params` 读取。已更新为准确描述
+- **所有 10 个 locale 文件** — 补充 `theme.huawei`、`theme.aliyun`、`theme.tianyi` 三个翻译键（zh-CN/zh-TW/zh-HK：华为云/阿里云/天翼云；en-US/es-ES/fr-FR/de-DE/pt-BR：Huawei Cloud/Alibaba Cloud/Tianyi Cloud；ja-JP：華為雲/阿里雲/天翼雲；ko-KR：화웨이 클라우드/알리바바 클라우드/톈이 클라우드）
+- **`AitheUI.onThemeChange` 方法新增** — `src/styles/theme/index.ts` 新增 `themeListeners` 事件集合和 `onAitheThemeChange` 导出函数；`setGlobalTheme` 在主题变更后通知所有监听器；`src/styles/aithe-ui.ts` 导入 `onAitheThemeChange` 并暴露 `onThemeChange` 方法，补齐与其他四个维度（shape/shadow/typo/layout）一致的订阅能力
+- **`docs/theming.md` 文档优化** — 在主题"程序化 API"章节新增 `onThemeChange` 订阅示例（含订阅和取消订阅），与 shape/shadow/typo 章节的 `onXxxChange` 示例保持一致