@aithe/aithe-ui 26.2.2 → 26.3.1

package/docs/changelog/CHANGELOG.md

@@ -4,6 +4,163 @@
 
 ---
 
+## 26.3.1 (2026-08-06)
+
+### 2026年第3季度第1个月版本 - 组件功能增强与质量提升
+
+- **树形菜单伸缩与事件改造**: `<aithe-tree-menu>` 新增 `expand-all`/`collapse-all` 方法与 `aithe-tree-toggle` 事件，事件参数统一为 `{ node, expanded }`
+- **Filter 数据格式化框架**: 新增 `@core/filter` 模块，提供 `registerFilter()`/`getFilter()`/`applyFilter()` API，内置 12 种过滤器（date/number/currency/percent/truncate/upper/lower/capitalize/strip-html/default/yes-no/enum）
+- **Table 六项新功能**: 列固定（sticky）、`max-visible-tabs` 溢出折叠、`has-fixed` 属性、斑马纹行固定列背景修复、`selection-cell` sticky 固定、`min-width: max-content` 控制
+- **Autoform 增强**: 条件渲染、字段联动、自定义控件注册表扩展
+- **Tabs 溢出折叠**: `<aithe-tabs>` 新增 `max-visible-tabs` 属性，溢出 tab 折叠为下拉选择；新增 `extra` 具名插槽
+- **Display 组件系列新增**: 新增 `<aithe-desc>`、`<aithe-desc-item>`、`<aithe-log-panel>`、`<aithe-mini-box>`、`<aithe-detail-box>`、`<aithe-brief-box>`、`<aithe-box-table>` 7 个新组件
+- **主题 CSS 变量统一**: 25 个主题统一新增 8 个 CSS 变量（`--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover` 等），CSS 自定义属性命名规范化
+- **DataHub 错误处理增强**: HTTP 非 2xx 错误响应优先用 APIStyle 解析，`DataHubError` 新增 `data` 字段；K8s APIStyle 支持 `Status` 对象解析
+- **SSR 环境适配**: 4 个组件 `window` 引用改为 `globalThis`，兼容非浏览器环境
+- **测试框架集成**: 集成 vitest 测试框架，Filter 模块测试导入路径规范化
+- **SonarQube 代码质量修复**: 消除 S3358/S3776 等告警，提取公共方法
+- **AitheUI 浏览器环境检测**: 新增 `isMobile`/`isAndroid`/`isIOS`/`isChrome`/`isEdge`/`isWechat` 等 10 个环境检测 getter
+- **`AitheSelectableType` 类型重构**: 从 `boolean | 'single'` 改为 `'none' | 'multi' | 'single'` 纯字符串枚举
+- **组件数量**: 100 个可复用的 UI 组件
+
+### 破坏性变更
+
+- **事件名统一**: `aithe-open-change` → `aithe-dropdown-change`
+- **`cellRenderer` 签名变更**: 渲染函数参数结构调整
+- **`AitheSelectableType` 重构**: `boolean | 'single'` → `'none' | 'multi' | 'single'`，Box 组件族 `selectable` 从 `Boolean` 统一为 `AitheSelectableType`
+- **`danger` 属性废弃**: 相关组件移除 `danger` 属性，改用 `variant="danger"`
+- **CSS 自定义属性重命名**: `--aithe-duration-normal` → `--aithe-duration-base`/`--aithe-duration-slow`，`--aithe-container-radius` → `--aithe-container-radius-md`，`--aithe-border-radius-md` → `--aithe-radius-md`，`--aithe-font-mono` → `--aithe-font-family-mono`
+- **`<aithe-desc>` 布局重构**: label+content 合并单元格改为独立 grid 列，移除 `desc-item` 的 `labelWidth` 属性
+- **`<aithe-box-table>` 重构**: 移除自建卡片 DOM，改用 `<aithe-brief-box>` 组件；移除 `content` 列插槽
+
+### 组件分类
+
+| 分类              | 数量 | 组件                                                                                                                                                            |
+| ----------------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 基础 (basic)      | 12   | button, button-group, icon, input, textarea, card, tag, badge, avatar, divider, empty, chip                                                                     |
+| 布局 (layout)     | 8    | container, row, col, flex, space, collapse, collapse-item, affix                                                                                                |
+| 导航 (navigation) | 7    | menu, menu-item, sub-menu, breadcrumb, breadcrumb-item, steps, back-top                                                                                         |
+| 表单 (form)       | 18   | autoform, autoform-item, checkbox, checkbox-group, radio, radio-group, select, switch, color-picker, combobox, date-picker, time-picker, slider, rate, form, form-item, upload, transfer |
+| 反馈 (feedback)   | 9    | dialog, modal, drawer, tooltip, popover, toast, alert, notification, loading                                                                                    |
+| 数据展示 (data)   | 14   | table, table-column, tabs, tab-pane, tab-group, tree, tree-menu, dropdown, metrics, metrics-group, pagination, timeline, timeline-item, box-table                |
+| 展示 (display)    | 13   | carousel, comparison, animated-image, markdown, markdown-editor, code-editor, label, mini-box, brief-box, detail-box, profile, desc, desc-item                   |
+| 进度 (progress)   | 4    | progress-bar, progress-ring, spinner, skeleton                                                                                                                  |
+| 容器 (container)  | 4    | callout, details, scroller, split-panel                                                                                                                         |
+| 主题 (theme)      | 7    | theme-picker, shape-picker, shadow-picker, typo-picker, theme-preview, locale-switch, theme-switch                                                              |
+| 框架 (framework)  | 7    | page, body, header, sidebar, dashboard, dashboard-panel, log-panel                                                                                               |
+
+### 主题列表
+
+**Light 系 (11)**: light, blue, festive, orange, purple, pink, teal, indigo, cyan, amber, gray
+
+**Dark 系 (11)**: dark, slate, charcoal, midnight, obsidian, graphite, ink, onyx, ebony, navy, raisin
+
+**云主题 (3)**: aliyun, huawei, tianyi
+
+### 阴影风格列表
+
+**内置阴影 (9)**: flat, neumorphism, skeuomorphic, glassmorphism, cyber, deep, diffuse, sharp-business, retro
+
+### 形状风格列表
+
+**内置形状 (8)**: sharp, smooth, rounded, rounder, pill, circle, chamfer, organic
+
+### 核心特性摘要
+
+- **Filter 数据格式化框架**: `@core/filter` 模块，12 种内置过滤器，支持自定义注册
+- **Table 列固定**: sticky 定位实现列固定，斑马纹背景修复
+- **Tabs 溢出折叠**: `max-visible-tabs` 属性，溢出 tab 折叠为下拉选择
+- **Display 组件系列**: 7 个新组件覆盖描述列表、日志面板、卡片表格等场景
+- **主题 CSS 变量统一**: 25 个主题统一 8 个 CSS 变量，命名规范化
+- **DataHub 错误处理**: APIStyle 解析错误响应，K8s Status 对象支持
+- **SSR 环境适配**: `globalThis` 替代 `window`，兼容非浏览器环境
+- **测试框架集成**: vitest 测试框架，Filter 模块测试覆盖
+- **浏览器环境检测**: `AitheUI` 类新增 10 个环境检测 getter
+- **跨框架兼容**: Web Components 标准，框架无关
+- **样式隔离**: Shadow DOM 确保组件样式不冲突
+- **多主题系统**: 25 套预设主题，支持全局和局部切换
+- **无障碍访问**: ARIA 语义、键盘导航、焦点管理
+- **自定义事件**: `aithe-*` 前缀的统一事件系统
+
+---
+
+## 26.2.3 (2026-05-14)
+
+### 2026年第2季度第3个月版本 - 代码规范与架构质量提升
+
+- **路径别名体系**: 从 `@/*` 单一通配改为 `@base/*`、`@components/*`、`@core/*`、`@styles/*`、`@types/*`、`@utils/*` 二级目录别名，87+ 文件全量替换
+- **类型统一**: `AitheIntent` 合并至 `AitheVariant`，消除语义重复
+- **SonarQube 合规**: 修复 `any` 类型、重复字符串常量、`readonly` 修饰符
+- **构建优化**: 新增 `tsc-alias` 步骤，确保 dist 产物无别名残留
+- **侧边栏折叠**: `aithe-menu-item` / `aithe-sub-menu` 新增 `collapsed` 模式
+- **设计令牌**: 新增 `--aithe-color-text-on-primary`，9 个组件硬编码颜色替换为令牌
+- **开发规范**: 新增 `CONTRIBUTING.md`，定义导入、readonly、编码、文档等规范
+- **国际化扩展**: 新增 8 个主流 locale（zh-TW / zh-HK / ja-JP / ko-KR / es-ES / pt-BR / fr-FR / de-DE），`aithe-locale-switch` 支持 10 种语言切换，新增 `locales` 属性限定显示语言
+- **DataHub 数据中间层**: Admin 应用集成 DataHub，菜单、仪表盘、登录均通过 DataHub 获取数据，支持 Mock 模式
+- **形状风格系统**: 新增 8 种内置形状风格（sharp / smooth / rounded / rounder / pill / circle / chamfer / organic），支持 Theme × Shape 自由组合
+- **阴影风格系统**: 新增 9 种内置阴影风格（flat / neumorphism / skeuomorphic / glassmorphism / cyber / deep / diffuse / sharp-business / retro），支持 Theme × Shape × Shadow 自由组合
+- **aitheUI 单例**: 统一的 `AitheUI` 类，整合 theme、shape、shadow、layout、i18n 管理
+- **Autoform 自动表单**: JSON 配置驱动的自动渲染表单组件，支持 13 种内置控件类型和自定义控件注册表
+- **Dashboard 仪表盘**: 拖拽式仪表盘组件，支持格子布局、拖拽排列、面板调整大小和状态持久化
+- **Markdown 引擎自研**: 自研 Markdown 解析引擎替代 markdown-it，支持 15 个内置插件
+- **Markdown 引擎重构**: Markdown 解析引擎从正则替换架构重构为 AST 架构（两阶段解析：块级 → 行内），`MarkdownPlugin` 接口废弃，新增 `AstPlugin` 接口；`SimpleMarkdownParser`/`FullMarkdownParser` 构造函数移除 `linkHooks` 参数，改为 `addLinkHook()` 方法
+- **AGENTS.md 文件体系**: 为 `src/` 和 `docs/` 下 21 个子目录创建 AI 编程指引文件
+- **语法高亮引擎**: 新增语法高亮引擎，内置 38 种语言支持
+- **新 Display 组件**: `<aithe-code-editor>`、`<aithe-markdown-editor>`、`<aithe-label>` 三个新组件
+- **DataHub APIStyle**: 新增业务协议解析机制（default/k8s 两种内置风格），类型体系重构，架构解耦（移除 ApiRegistry），支持单次请求临时指定 APIStyle
+- **Autoform 模块重构**: `rule-engine.ts` 合并至 `autoform.ts`，新增 `condition.ts`/`types.ts` 独立模块
+- **组件数量**: 90 个可复用的 UI 组件
+
+### 组件分类
+
+| 分类              | 数量 | 组件                                                                                                                                                            |
+| ----------------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 基础 (basic)      | 12   | button, button-group, icon, input, textarea, card, tag, badge, avatar, divider, empty, chip                                                                     |
+| 布局 (layout)     | 10   | container, row, col, flex, space, page-container, page, collapse, collapse-item, affix                                                                          |
+| 导航 (navigation) | 7    | menu, menu-item, sub-menu, breadcrumb, breadcrumb-item, steps, back-top                                                                                         |
+| 表单 (form)       | 18   | autoform, autoform-item, checkbox, checkbox-group, radio, radio-group, select, switch, color-picker, combobox, date-picker, time-picker, slider, rate, form, form-item, upload, transfer |
+| 反馈 (feedback)   | 9    | dialog, modal, drawer, tooltip, popover, toast, alert, notification, loading                                                                                    |
+| 数据展示 (data)   | 12   | table, table-column, tabs, tab-pane, tree, tree-menu, timeline, timeline-item, pagination, dropdown, metrics, metrics-group                                      |
+| 展示 (display)    | 7    | carousel, comparison, animated-image, markdown, code-editor, markdown-editor, label                                                                              |
+| 进度 (progress)   | 4    | progress-bar, progress-ring, spinner, skeleton                                                                                                                  |
+| 容器 (container)  | 4    | callout, details, scroller, split-panel                                                                                                                         |
+| 主题 (theme)      | 7    | theme-picker, shape-picker, shadow-picker, typo-picker, theme-preview, locale-switch, theme-switch                                                              |
+
+### 主题列表
+
+**Light 系 (11)**: light, blue, festive, orange, purple, pink, teal, indigo, cyan, amber, gray
+
+**Dark 系 (11)**: dark, slate, charcoal, midnight, obsidian, graphite, ink, onyx, ebony, navy, raisin
+
+### 阴影风格列表
+
+**内置阴影 (9)**: flat, neumorphism, skeuomorphic, glassmorphism, cyber, deep, diffuse, sharp-business, retro
+
+### 形状风格列表
+
+**内置形状 (8)**: sharp, smooth, rounded, rounder, pill, circle, chamfer, organic
+
+### 核心特性摘要
+
+- **路径别名体系**: `@base/*`、`@components/*`、`@core/*`、`@styles/*`、`@types/*`、`@utils/*` 二级目录别名
+- **类型统一**: `AitheVariant` 统一视觉变体类型（含 `'neutral'` 和字符串扩展）
+- **SonarQube 合规**: 消除 `any` 类型、重复字符串、`readonly` 缺失等告警
+- **构建保障**: `tsc-alias` 自动替换 `.d.ts` 别名，dist 产物无残留
+- **跨框架兼容**: Web Components 标准，框架无关
+- **样式隔离**: Shadow DOM 确保组件样式不冲突
+- **多主题系统**: 22 套预设主题（11 Light + 11 Dark），支持全局和局部切换
+- **DataHub 数据中间层**: 统一数据接口层，支持 Mock 模式
+- **形状风格系统**: 8 种内置形状风格，支持 Theme × Shape 自由组合
+- **阴影风格系统**: 9 种内置阴影风格，支持 Theme × Shape × Shadow 自由组合
+- **aitheUI 单例**: 统一的配置管理，整合 theme、shape、shadow、layout、i18n
+- **自研 Markdown 引擎**: 插件化 Markdown 解析引擎，替代 markdown-it
+- **语法高亮引擎**: 内置 38 种语言的语法高亮引擎
+- **无障碍访问**: ARIA 语义、键盘导航、焦点管理
+- **企业级功能**: 表单验证、数据表格、布局系统
+- **自定义事件**: `aithe-*` 前缀的统一事件系统
+
+---
+
 ## 26.2.2 (2026-05-09)
 
 ### 2026年第2季度第2个月版本 - 基线版本
@@ -28,7 +185,7 @@
 | 展示 (display)    | 4    | carousel, comparison, animated-image, markdown                                                                                                                  |
 | 进度 (progress)   | 4    | progress-bar, progress-ring, spinner, skeleton                                                                                                                  |
 | 容器 (container)  | 4    | callout, details, scroller, split-panel                                                                                                                         |
-| 主题 (theme)      | 3    | theme-picker, theme-preview, locale-switch                                                                                                                      |
+| 主题 (theme)      | 4    | theme-picker, theme-preview, locale-switch, shadow-picker                                                                                                       |
 
 ### 主题列表
 
@@ -36,6 +193,14 @@
 
 **Dark 系 (11)**: dark, slate, charcoal, midnight, obsidian, graphite, ink, onyx, ebony, navy, raisin
 
+### 阴影风格列表
+
+**内置阴影 (9)**: flat, neumorphism, skeuomorphic, glassmorphism, cyber, deep, diffuse, sharp-business, retro
+
+### 形状风格列表
+
+**内置形状 (8)**: sharp, smooth, rounded, rounder, pill, circle, chamfer, organic
+
 ### 核心特性摘要
 
 - **跨框架兼容**: Web Components 标准，框架无关