@aithe/aithe-ui 26.2.3 → 26.3.2

package/docs/autoform.md

@@ -41,40 +41,9 @@ interface FormFieldConfig {
 
 ### 内置控件类型
 
-### 顶层结构
-
-`fields` 属性接收一个 JSON 字符串，解析后为 `FormFieldConfig[]`：
-
-```typescript
-interface FormFieldConfig {
-  name?: string; // 字段唯一标识
-  type?: string; // 控件类型
-  label?: string; // 标签文本
-  icon?: string; // 图标名称
-  tooltip?: string; // 悬停提示
-  description?: string; // 说明文字
-  dft?: string; // 缺省值
-  placeholder?: string; // 占位提示
-  disabled?: boolean; // 是否禁用
-  required?: boolean; // 是否必填
-  pattern?: string; // 校验正则
-  message?: string; // 校验失败提示
-  options?: string | FormItemOption[]; // 选项
-  inputType?: string; // HTML input type
-  min?: string; // 最小值
-  max?: string; // 最大值
-  step?: string; // 步长
-  rows?: string; // 文本域行数
-  dependencies?: string[]; // 依赖字段列表
-  rules?: FormRule[]; // 联动规则
-}
-```
-
-### 内置控件类型
-
 | type           | 说明       | 特有属性                                |
 | -------------- | ---------- | --------------------------------------- |
-| `input`        | 文本输入框 | `inputType`（如 `email`、`url`、`tel`） |
+| `input`        | 文本输入框 | `inputType`（如 `email`、`url`、`tel`、`password`；`password` 渲染明文切换按钮） |
 | `textarea`     | 多行文本域 | `rows`                                  |
 | `select`       | 下拉选择   | `options`                               |
 | `radio`        | 单选组     | `options`                               |
@@ -150,6 +119,9 @@ const values: Record<string, unknown> = form.getValues();
 // 重置为缺省值
 form.reset();
 
+// 编程触发表单提交（校验通过后触发 aithe-submit 事件）
+form.submit();
+
 // 监听提交事件
 form.addEventListener('aithe-submit', (e: CustomEvent<{ values: Record<string, unknown> }>) => {
   console.log('提交数据：', e.detail.values);
@@ -257,10 +229,16 @@ FormRegistry.register({
 
 ### 自定义提交按钮
 
-通过 slot 替换内置提交按钮：
+通过 slot 和 `show-submit` 属性控制操作区域：
 
 ```html
+<!-- 使用 slot 添加自定义按钮，同时保留内置提交按钮 -->
 <aithe-autoform fields="[...]">
+  <aithe-button>取消</aithe-button>
+</aithe-autoform>
+
+<!-- 关闭内置提交按钮，完全使用 slot 自定义 -->
+<aithe-autoform fields="[...]" show-submit="false">
   <aithe-button type="primary">保存</aithe-button>
   <aithe-button>取消</aithe-button>
 </aithe-autoform>
@@ -278,6 +256,8 @@ FormRegistry.register({
 | `submit-text`        | `String`  | `''`    | 提交按钮文本             |
 | `loading`            | `Boolean` | `false` | 提交中状态               |
 | `validate-on-change` | `Boolean` | `true`  | 是否在每次变更时实时校验 |
+| `initial-values`     | `Object` / `String` | `{}` | 表单字段初始值，支持对象或 JSON 字符串，覆盖对应字段的 `dft` |
+| `show-submit`        | `Boolean` | `true`  | 是否显示内置提交按钮，设为 `false` 时使用自定义 slot |
 
 ### `<aithe-autoform>` 方法
 
@@ -286,6 +266,7 @@ FormRegistry.register({
 | `validate()`  | `boolean`                 | 校验所有可见字段     |
 | `getValues()` | `Record<string, unknown>` | 获取所有可见字段值   |
 | `reset()`     | `void`                    | 重置所有字段为缺省值 |
+| `submit()`    | `void`                    | 编程触发表单校验和提交，通过后触发 `aithe-submit` 事件 |
 
 ### 事件
 

package/docs/changelog/CHANGELOG.md

@@ -4,6 +4,161 @@
 
 ---
 
+## 26.3.2 (2026-09-11)
+
+### 2026年第3季度第2个月版本 - 只读视图组件、选项分组、DataHub force 选项与文档质量提升
+
+- **新增 `<aithe-autoview>` 只读视图组件**: 基于 `<aithe-desc>` 的轻量适配器，与 `<aithe-autoform>` 共用 `FormFieldConfig` 模型，内置 8 类只读渲染器（input/select/checkbox/switch/date-picker/color-picker/rate/slider），支持依赖联动显隐和 `ViewRegistry` 自定义渲染器
+- **`<aithe-select>` / `<aithe-combobox>` 选项分组**: 选项对象新增 `group` 字段，自动按分组聚合渲染，每组前置标题并缩进组内选项；无 `group` 字段时保持扁平渲染，向后兼容
+- **`<aithe-autoform>` 密码明文切换**: `inputType="password"` 时渲染 `eye`/`eyeOff` 图标按钮，点击切换 `password` 与 `text`
+- **`<aithe-desc>` 描述列表增强**: 新增 `border-style`（`none`/`full`/`row`）和 `label-background`（`filled`/`none`）属性；`border-radius` CSS 变量修正为 `--aithe-container-radius-md`；`labelWidth` 默认值改为 `'150px'`
+- **DataHub `forceDedup` / `forceCache` 请求选项**: 无视 URL 命名约定强制启用并发去重和结果缓存，适用于 URL 不以 `query`/`list`/`get` 结尾但语义为查询的 GET 请求；force 选项为 true 时自动跳过幂等防护
+- **DataHub 缓存命中响应处理修复**: 缓存命中路径跳过 `APIStyle.onResponse` 转换、`isSuccess` 业务校验、全局 `config.onResponse` 拦截器三道处理；抽取统一 `handleResponse` 方法，让缓存命中与实际请求走完全一致的响应处理逻辑
+- **DataHub `request` 方法重构**: 抽取 `executeRequest`/`buildHttpError`/`applyResponseInterceptor`/`isCacheable`/`isDedupable`/`shouldGuardIdempotent` 六个独立方法，降低认知复杂度
+- **`listPlugin` 嵌套子列表与缩进续行支持**: 重写列表解析逻辑，通过递归调用 `listPlugin.block` 生成嵌套 `list` AST 节点；抽取 `collectItemSubLines`/`buildListItemChildren`/`blankLineBelongsToItem`/`lineEndsItem`/`parseSubLines` 五个独立函数治理认知复杂度（52→阈值以内）；删除死代码 `parseListItem`
+- **`<aithe-tree-menu>` / `<aithe-sub-menu>` 激活态样式调整**: 移除 `.group-toggle.active` / `.toggle.active` 的灰底背景，激活态仅靠文字颜色区分；tree-menu `.children` 新增顶部内边距
+- **DataHub GET 请求 body 修复**: `defaultStyle.onRequest` GET 请求跳过 `data` 包装，避免 "GET request with body is unusual" 警告
+- **文档质量提升**: 修复 `autoform.md`/`datahub.md`/`markdown.md`/`i18n.md`/`guide.md`/`theming.md`/`quickstart.md` 等 7 个文档 10 处错误；issue 文件按基线版本拆分到 `26.2.2/`/`26.2.3/`/`26.3.1/`/`26.3.2/` 子目录
+- **组件数量**: 103 个可复用的 UI 组件
+
+### 破坏性变更
+
+- **`<aithe-desc>` 的 `labelWidth` 默认值变更**: `''`（auto）→ `'150px'`
+- **`<aithe-desc>` 的 `border-radius` CSS 变量重命名**: `--aithe-radius-md` → `--aithe-container-radius-md`
+- **`<aithe-desc>` 的 `isBordered` 判定变更**: `this.border` → `this.border || this.borderStyle !== 'none'`
+- **`listPlugin` 的 `parseListItem` 函数删除**: 被 `parseListItemIndented` 完全替代
+- **`listPlugin` 的 `list-item` AST `children` 结构变更**: 单一 `paragraph` → `paragraph` + 嵌套节点
+- **`listPlugin` 的 `list-item` AST `checked` 字段变更**: 透传 `item.checked` → 显式 `null`
+
+### 组件分类
+
+| 分类              | 数量 | 组件                                                                                                                                                            |
+| ----------------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 基础 (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)    | 14   | carousel, comparison, animated-image, markdown, markdown-editor, code-editor, label, mini-box, brief-box, detail-box, profile, desc, desc-item, autoview         |
+| 进度 (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
+
+### 核心特性摘要
+
+- **`<aithe-autoview>` 只读视图**: JSON 驱动的只读详情视图，与 autoform 共用 `FormFieldConfig` 模型，`ViewRegistry` 自定义渲染器
+- **选项分组**: `<aithe-select>`/`<aithe-combobox>` 支持 `group` 字段自动分组渲染
+- **密码明文切换**: `<aithe-autoform>` 密码字段支持 `eye`/`eyeOff` 图标切换
+- **`<aithe-desc>` 增强**: `border-style`/`label-background` 属性，边框样式灵活控制
+- **DataHub force 选项**: `forceDedup`/`forceCache` 无视 URL 命名约定强制启用去重和缓存
+- **DataHub 缓存修复**: 缓存命中路径与实际请求路径走完全一致的响应处理逻辑
+- **`listPlugin` 嵌套子列表**: 递归解析缩进子列表，支持多层嵌套
+- **跨框架兼容**: Web Components 标准，框架无关
+- **样式隔离**: Shadow DOM 确保组件样式不冲突
+- **多主题系统**: 25 套预设主题，支持全局和局部切换
+- **无障碍访问**: ARIA 语义、键盘导航、焦点管理
+- **自定义事件**: `aithe-*` 前缀的统一事件系统
+
+---
+
+## 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-mini-box>`、`<aithe-detail-box>`、`<aithe-brief-box>`、`<aithe-profile>`、`<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个月版本 - 代码规范与架构质量提升