@aithe/aithe-ui 26.2.3 → 26.3.2

package/docs/issue/26.3.2/issue_26.3.2.1.md

@@ -0,0 +1,46 @@
+# Issue 26.3.2.1
+
+## 版本信息
+
+- **版本号**: 26.3.2.1
+- **基线版本**: 26.3.2
+- **类型**: Quality / Bug Fix
+- **日期**: 2026-08-25
+
+## 变更概述
+
+1. **DataHub 缓存命中响应处理修复** — 缓存命中时原本直接返回缓存对象，跳过 `APIStyle.onResponse` 转换、`isSuccess` 业务校验、全局 `config.onResponse` 拦截器三道处理，导致缓存返回的 `data` 仍是原始业务包（未解包）、业务错误被静默吞掉、全局拦截器失效。抽取统一响应处理方法 `handleResponse`，让缓存命中路径与实际请求路径走完全一致的响应处理逻辑
+2. **`<aithe-tree-menu>` 激活态样式调整** — 移除分组切换按钮 `.group-toggle.active` 的灰底背景（`--aithe-color-surface-muted`），激活态仅靠文字颜色区分；子级容器 `.children` 新增顶部内边距 `--aithe-space-2`
+3. **`<aithe-sub-menu>` 激活态样式调整** — 移除切换按钮 `.toggle.active` 的灰底背景（`--aithe-color-surface-muted`），与 `<aithe-tree-menu>` 激活态视觉风格保持一致
+
+## 破坏性变更
+
+无。
+
+## 变更内容
+
+### 新增
+
+#### DataHub 统一响应处理方法
+
+- **`src/core/datahub/core/datahub-core.ts`** — `DataHubCore` 类新增私有方法 `handleResponse<T>(res, requestStyle, traceId, fullUrl)`，封装「APIStyle `onResponse` 转换 + `isSuccess` 业务校验 + 返回业务数据」三步逻辑。无 APIStyle 时直接返回原始响应；业务校验失败抛出 `DataHubError`（含 `code`/`message`/`trace`/`status`/`url`）。供实际请求路径与缓存命中路径共同调用，确保两条路径行为一致
+
+### 修改
+
+#### DataHub 缓存命中响应处理修复
+
+- **`src/core/datahub/core/datahub-core.ts`** — 缓存命中路径（`cacheGet` 命中后）原本 `return cached` 直接返回，现改为：先执行全局 `config.onResponse` 拦截器（与实际请求路径第 8 步一致），再调用 `handleResponse` 完成 APIStyle 转换与 `isSuccess` 校验。修复 3 个缺陷：①缓存返回的 `data` 未经过 `onResponse` 解包，仍是 `{code, message, data}` 整包；②缓存命中跳过 `isSuccess` 校验，业务错误被静默吞掉；③缓存命中跳过全局 `config.onResponse` 拦截器，鉴权刷新/日志埋点/错误码归一化等全局逻辑失效
+- **`src/core/datahub/core/datahub-core.ts`** — 实际请求路径（`execute` 内 HTTP 2xx 成功分支）原本内联 `onResponse` + `isSuccess` + `return` 逻辑，现替换为调用 `handleResponse`，消除两条路径的代码重复。缓存写入仍保留原始 `res`（转换前），保持现有缓存存储行为不变
+
+#### `<aithe-tree-menu>` 激活态样式调整
+
+- **`src/components/data/tree-menu.ts`** — `.group-toggle.active` 移除 `background: var(--aithe-color-surface-muted)`，激活态不再使用灰底背景，仅靠 `color: var(--aithe-color-text)` 区分
+- **`src/components/data/tree-menu.ts`** — `.children` 容器新增 `padding-top: var(--aithe-space-2)`，增加子级内容顶部间距
+
+#### `<aithe-sub-menu>` 激活态样式调整
+
+- **`src/components/navigation/sub-menu.ts`** — `.toggle.active` 移除 `background: var(--aithe-color-surface-muted)`，与 `<aithe-tree-menu>` 激活态视觉风格统一
+
+### 删除
+
+无。

package/docs/issue/26.3.2/issue_26.3.2.2.md

@@ -0,0 +1,82 @@
+# Issue 26.3.2.2
+
+## 版本信息
+
+- **版本号**: 26.3.2.2
+- **基线版本**: 26.3.2
+- **类型**: Feature
+- **日期**: 2026-09-03
+
+## 变更概述
+
+1. **新增 `<aithe-autoview>` 只读视图组件** — 基于 `<aithe-desc>` 的轻量适配器，与 `<aithe-autoform>` 共用同一份 `FormFieldConfig` 模型，将字段值渲染为结构化描述列表。内置类型感知的只读渲染器（input/textarea 纯文本、select/radio label 反查、checkbox 标签组、switch 是/否徽章、date-picker/time-picker 格式化日期、color-picker 色块+色值、rate/slider 纯数值），支持依赖联动显隐（仅 `show`/`hide` 生效），支持通过 `ViewRegistry` 注册自定义渲染器
+2. **新增 `ViewRegistry` 只读视图注册表** — `src/core/autoform/autoview.ts` 新增与 `FormRegistry` 对称的静态注册表，定义 `ViewFieldConfig`/`ViewRenderContext`/`ViewRenderer`/`ViewControlDefinition` 类型，允许注册自定义只读渲染器扩展 autoview
+3. **`<aithe-desc>` 描述列表增强** — 新增 `border-style` 属性（`none`/`full`/`row` 三种边框样式）和 `label-background` 属性（`filled`/`none` 标签背景）；修复 `border-radius` CSS 变量名 `--aithe-radius-md` → `--aithe-container-radius-md`；`labelWidth` 默认值由 `''` 改为 `'150px'`
+4. **DataHub 新增 `forceDedup` / `forceCache` 请求选项** — 允许无视 URL 命名约定强制启用去重和缓存，适用于 URL 不以 `query`/`list`/`get` 结尾但语义为查询的 GET 请求；当 `forceDedup` 或 `forceCache` 为 true 时自动跳过幂等防护，避免并发查询请求被误判为重复提交
+5. **DataHub `request` 方法重构** — 将内联 `execute` 函数和 HTTP 错误构造逻辑抽成 `executeRequest`/`buildHttpError`/`applyResponseInterceptor` 三个独立方法，force 选项判断抽成 `isCacheable`/`isDedupable`/`shouldGuardIdempotent` 三个辅助方法，降低认知复杂度
+6. **文档与演示同步更新** — 新增 `docs/api/display/autoview.md` API 文档；`docs/api/display/desc.md` 补充 `border-style`/`label-background` 属性文档和示例；`docs/api/summary.md` 新增 autoview 条目；新增 `src/apps/demo/pages/autoview.ts` 演示页（9 个示例覆盖基础/选择/高级/联动/完整档案/空值/三种边框样式）；11 种语言 i18n 文件同步更新
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `aithe-desc` 的 `labelWidth` 默认值 | `''`（auto） | `'150px'` |
+| `aithe-desc` 的 `border-radius` CSS 变量 | `--aithe-radius-md` | `--aithe-container-radius-md` |
+
+## 变更内容
+
+### 新增
+
+#### AutoView 组件
+
+- **`aithe-autoview` 组件** — `src/components/display/autoview.ts` 新增，基于 `<aithe-desc>` 的轻量适配器，JSON 驱动的只读详情视图。支持 `fields`（JSON 字符串）/`data`（对象或 JSON 字符串）属性，透传 `column`/`border`/`border-style`/`label-background`/`direction`/`label-width`/`size`/`title`/`show-title`/`max-rows`/`empty-text` 到 desc。内置 8 类只读渲染器，支持依赖联动显隐和 `ViewRegistry` 自定义渲染器。`firstUpdated` 中发射 `aithe-view-ready` 事件携带可见字段值
+- **`ViewRegistry` 注册表** — `src/core/autoform/autoview.ts` 新增，与 `FormRegistry` 对称的静态注册表，提供 `register`/`unregister`/`get`/`has`/`types` 方法，重复注册抛错
+- **`ViewFieldConfig` 类型** — `src/core/autoform/autoview.ts` 新增，扩展 `FormFieldConfig`，追加 `filter`/`emptyText`/`span`/`rowspan`/`align`/`hideLabel` 可选展示属性
+- **`ViewRenderContext` 类型** — `src/core/autoform/autoview.ts` 新增，传递给只读渲染器的上下文，含 `value`/`rawValue`/`options`/`field`/`emptyText`
+- **`ViewRenderer` 类型** — `src/core/autoform/autoview.ts` 新增，只读视图渲染函数 `(ctx) => TemplateResult`
+- **`ViewControlDefinition` 类型** — `src/core/autoform/autoview.ts` 新增，只读视图控件类型定义，含 `type` 和 `render`
+- **`docs/api/display/autoview.md`** — 新增 `aithe-autoview` API 文档，含属性/方法/事件/插槽/支持的字段类型/字段配置/自定义视图注册表/依赖联动/示例
+- **`src/apps/demo/pages/autoview.ts`** — 新增 autoview 演示页，9 个示例：基础展示、选择类展示、高级控件展示、联动显隐、完整档案、空值展示、无边框、完整边框、行分隔线
+
+#### DataHub force 选项
+
+- **`DataHubRequestOptions.forceDedup`** — `src/core/datahub/types.ts` 新增，为 true 时无视 URL 命名约定强制启用并发去重
+- **`DataHubRequestOptions.forceCache`** — `src/core/datahub/types.ts` 新增，为 true 时无视 URL 命名约定强制启用结果缓存，配合 `cacheTTL` 控制有效期
+- **`src/core/datahub/__tests__/force-options.test.ts`** — 新增测试文件，8 个用例覆盖 forceDedup 去重、forceCache 缓存命中、force 选项跳过幂等守卫等场景
+
+#### i18n 翻译键
+
+- **`form.autoView.empty`** — 11 个 locale 文件新增，空值占位符（zh-CN/zh-TW/zh-HK：`--`；其他语言：`--`）
+- **`form.autoView.yes`** — 11 个 locale 文件新增，switch 开启状态文案（zh-CN：`是`；en-US：`Yes`；ja-JP：`はい`；ko-KR：`예` 等）
+- **`form.autoView.no`** — 11 个 locale 文件新增，switch 关闭状态文案（zh-CN：`否`；en-US：`No`；ja-JP：`いいえ`；ko-KR：`아니오` 等）
+- **`api.display.autoview`** — 11 个 `src/apps/api/i18n/` 文件新增，API 文档侧边栏条目（zh-CN：`自动视图`；en-US：`Auto View` 等）
+- **`demo.autoView.*`** — 11 个 `src/apps/demo/i18n/` 文件新增，演示页标题和 9 个示例的标题/描述翻译
+
+### 修改
+
+#### `<aithe-desc>` 描述列表增强
+
+- **`src/components/display/desc.ts`** — 新增 `border-style` 属性（`'none' | 'full' | 'row'`，默认 `'none'`），`border-style="row"` 仅显示行分隔线无外框和列分隔线；新增 `label-background` 属性（`'filled' | 'none'`，默认 `'filled'`），`label-background="none"` 标签背景透明；`isBordered` 判定改为 `border || borderStyle !== 'none'`；新增 `row` 边框样式和 `none` 标签背景的 CSS 规则；标签单元格新增 `padding`；内容单元格新增 `display: flex; align-items: center`
+- **`src/components/display/desc.ts`** — `border-radius` CSS 变量 `--aithe-radius-md` 修正为 `--aithe-container-radius-md`（2 处）
+- **`docs/api/display/desc.md`** — 属性表新增 `border-style`/`label-background` 行；`border` 描述更新为等同 `border-style="full"`；`labelWidth` 默认值更新为 `'150px'`；新增「Border Styles」和「Label Background」示例章节
+
+#### DataHub force 选项实现与重构
+
+- **`src/core/datahub/core/datahub-core.ts`** — `request` 方法新增 force 选项支持：`cacheable` 改为 `strategy.cacheable || merged.forceCache`；`dedupable` 改为 `strategy.dedupable || merged.forceDedup`；幂等防护新增 `forceQuery` 判断，`forceDedup`/`forceCache` 为 true 时跳过
+- **`src/core/datahub/core/datahub-core.ts`** — `request` 方法重构降低认知复杂度：内联 `execute` 函数抽成 `executeRequest<T>()` 独立方法；HTTP 错误构造抽成 `buildHttpError()`；响应拦截器应用抽成 `applyResponseInterceptor()`（缓存命中与实际请求路径共用）；force 选项判断抽成 `isCacheable()`/`isDedupable()`/`shouldGuardIdempotent()` 三个辅助方法
+- **`src/core/datahub/core/datahub-core.ts`** — 新增 `DataHubStrategyConfig` 类型导入和 `DataHubError` 类型导入（别名 `DataHubErrorType`）
+
+#### 导出与入口
+
+- **`src/index.ts`** — 新增 `export * from '@components/display/autoview'`
+- **`src/core/autoform/index.ts`** — 新增导出 `ViewRegistry` 和 `ViewFieldConfig`/`ViewRenderContext`/`ViewRenderer`/`ViewControlDefinition` 类型
+
+#### 演示与文档应用
+
+- **`src/apps/demo/app.ts`** — 导入 `autoViewPage` 并加入 `demoPages` 数组
+- **`src/apps/api/pages/docs.ts`** — 导入 `autoviewHtml`，`docCategories` display 分类新增 `disp-autoview` 条目
+- **`docs/api/summary.md`** — display 分类新增 `Auto View` 条目
+
+### 删除
+
+无。

package/docs/issue/26.3.2/issue_26.3.2.3.md

@@ -0,0 +1,57 @@
+# Issue 26.3.2.3
+
+## 版本信息
+
+- **版本号**: 26.3.2.3
+- **基线版本**: 26.3.2
+- **类型**: Feature
+- **日期**: 2026-09-08
+
+## 变更概述
+
+1. **`<aithe-select>` / `<aithe-combobox>` 新增选项分组能力** — 选项对象新增 `group` 字段，渲染时若任一选项携带 `group` 则自动按分组聚合输出，每组前置 `.group-header` 标题并缩进组内选项；无 `group` 字段时保持原扁平渲染，向后兼容。两个组件对称实现，select 用 `groupedOptions` getter，combobox 用 `groupedOptions()` 方法
+2. **`<aithe-autoform>` 密码字段支持明文切换** — `autoform-item` 在 `inputType="password"` 时于输入框 `slot="suffix"` 渲染 `eye`/`eyeOff` 图标按钮，点击切换 `type` 在 `password` 与 `text` 之间切换；新增 `_passwordVisible` state 与 `togglePasswordVisible()` 方法
+3. **Demo 页面同步补充示例** — `form.ts` 新增「Grouped Select & Combobox」示例（中文城市按华东/华北/华南分组、预设搜索按 Analytics/Automation 分组）；`autoform.ts` 新增 `password` 字段示例
+
+## 破坏性变更
+
+无。
+
+## 变更内容
+
+### 新增
+
+#### Select / Combobox 选项分组
+
+- **`AitheComboboxOption.group` 字段** — `src/components/form/combobox.ts` 新增可选 `group?: string` 字段，用于分组聚合
+- **`AitheCombobox.groupedOptions()` 方法** — `src/components/form/combobox.ts` 新增，按 `group` 字段用 `Map` 聚合选项，保留插入顺序，无 `group` 的项归入无标题分组
+- **`AitheCombobox.renderOption()` 方法** — `src/components/form/combobox.ts` 抽出单选项渲染逻辑，供扁平与分组两种路径复用
+- **`AitheSelect.groupedOptions` getter** — `src/components/form/select.ts` 新增，按 `group` 字段用 `Map` 聚合 `filteredOptions`，保留插入顺序
+- **`AitheSelect.renderOption()` 方法** — `src/components/form/select.ts` 抽出单选项渲染逻辑，供扁平与分组两种路径复用；分组模式下用 `flatIndex++` 维护 `activeIndex` 与原键盘导航逻辑兼容
+- **`.group-header` / `.group .item` / `.group .option` 样式** — `src/components/form/combobox.ts` 与 `src/components/form/select.ts` 新增，分组标题使用 `--aithe-color-text-muted` + `xs` 字号 + `medium` 字重，组内选项 `padding-left: var(--aithe-space-6)` 缩进
+
+#### Autoform 密码明文切换
+
+- **`AitheAutoformItem._passwordVisible` state** — `src/components/form/autoform-item.ts` 新增，记录密码是否明文显示
+- **`AitheAutoformItem.togglePasswordVisible()` 方法** — `src/components/form/autoform-item.ts` 新增，切换 `_passwordVisible` 状态
+- **密码字段后缀图标按钮** — `src/components/form/autoform-item.ts` `input` 类型渲染分支新增，`inputType="password"` 时在 `slot="suffix"` 渲染 `<aithe-icon name="eye|eyeOff">`，点击切换 `type` 在 `password`/`text` 之间
+
+#### Demo 示例
+
+- **`src/apps/demo/pages/form.ts`** — 新增「Grouped Select & Combobox」示例，含 `<aithe-select>` 城市分组（上海/杭州/北京/天津/广州/深圳 按 华东/华北/华南 分组）和 `<aithe-combobox>` 预设搜索分组（A/B Test/Funnel/Assistant Shell/Workflow Editor 按 Analytics/Automation 分组）
+- **`src/apps/demo/pages/autoform.ts`** — `basicFields` 新增 `password` 字段示例（`inputType: 'password'`，含 `lock` 图标和必填校验）
+
+### 修改
+
+#### Select / Combobox 渲染逻辑重构
+
+- **`src/components/form/select.ts`** — `renderOptions()` 内 `this.filteredOptions.map(...)` 内联渲染改为：先判断 `hasGroup`，无分组走 `renderOption()` 扁平路径，有分组走 `groupedOptions` + `flatIndex++` 分组路径
+- **`src/components/form/combobox.ts`** — `renderOptions()` 内 `options.map(...)` 内联渲染改为：先判断 `hasGroup`，无分组走 `renderOption()` 扁平路径，有分组走 `groupedOptions()` 分组路径
+
+#### Autoform input 类型渲染
+
+- **`src/components/form/autoform-item.ts`** — `input` case 新增 `isPassword`/`effectiveType` 局部变量，`.type` 由 `this.inputType || 'text'` 改为 `effectiveType`（密码字段根据 `_passwordVisible` 切换 `text`/`password`，非密码字段保持原 `inputType || 'text'` 行为）
+
+### 删除
+
+无。

package/docs/issue/26.3.2/issue_26.3.2.4.md

@@ -0,0 +1,43 @@
+# Issue 26.3.2.4
+
+## 版本信息
+
+- **版本号**: 26.3.2.4
+- **基线版本**: 26.3.2
+- **类型**: Quality / Bug Fix
+- **日期**: 2026-09-11
+
+## 变更概述
+
+1. **`listPlugin` 列表解析器新增嵌套子列表与缩进续行支持** — 原 `listPlugin.block` 仅能解析扁平单行列表项，无法识别缩进子列表和跨行续行。重写解析逻辑：以首行确定列表类型与 `baseIndent`，逐项收集同级列表项并归集其后续缩进行，通过递归调用 `listPlugin.block` 生成嵌套 `list` AST 节点；空行后通过前瞻判断是否仍属当前列表项的缩进续行
+2. **`listPlugin.block` 认知复杂度治理** — 原实现认知复杂度 52（超过 sonarjs 上限 15），通过抽取 `collectItemSubLines`、`buildListItemChildren`、`blankLineBelongsToItem`、`lineEndsItem`、`parseSubLines` 五个独立函数分层拆解，主循环复杂度降至阈值以内，修复 ESLint `sonarjs/cognitive-complexity` 错误
+3. **`parseSubLines` 剩余行递归处理修正** — 原实现将嵌套列表解析后的 `remaining` 行直接 `join` 拍平为单一段落，导致更深一层的嵌套列表被错误扁平化；改为递归调用 `parseSubLines(remaining, parentIndent)` 正确处理多层嵌套
+4. **清理死代码与非空断言** — 删除被 `parseListItemIndented` 完全替代且无任何引用的 `parseListItem` 函数；`listPlugin.block` 内大量 `line!` 非空断言改为 `undefined` 显式判断与类型收窄
+
+## 破坏性变更
+
+无。
+
+## 变更内容
+
+### 新增
+
+#### 列表嵌套解析辅助函数
+
+- **`parseListItemIndented()`** — `src/core/markdown/plugins.ts` 新增，在原 `parseListItem` 基础上增加前导空格识别，返回 `indent` 字段，支持 `minIndent` 参数过滤缩进不足的行
+- **`isBlankLine()`** — `src/core/markdown/plugins.ts` 新增，判断行是否为空字符串或仅含空白
+- **`collectItemSubLines()`** — `src/core/markdown/plugins.ts` 新增，收集列表项标记行之后的缩进续行或子列表行，返回 `{ subLines, nextI }`；处理空行前瞻（仅当空行后仍为更深缩进时才续接）和同级/更少缩进行终止判断
+- **`blankLineBelongsToItem()`** — `src/core/markdown/plugins.ts` 新增，空行后定位下一个非空行，判断其是否仍为当前列表项的缩进续行
+- **`lineEndsItem()`** — `src/core/markdown/plugins.ts` 新增，判断非空行是否结束当前列表项的续行收集（同级列表项或更少缩进的非列表行返回 `true`）
+- **`buildListItemChildren()`** — `src/core/markdown/plugins.ts` 新增，为单个列表项构建子节点：标记行文本包装为 `paragraph` + `raw-inline`，续行通过 `parseSubLines` 递归解析
+- **`parseSubLines()`** — `src/core/markdown/plugins.ts` 新增，解析列表项下的缩进子行：首行缩进大于父级时递归调用 `listPlugin.block` 生成嵌套列表，剩余行递归调用自身处理多层嵌套；非列表续行则 `join` 为段落
+
+### 修改
+
+#### `listPlugin` 列表解析器重写
+
+- **`src/core/markdown/plugins.ts`** — `listPlugin.block` 重写：首行通过 `parseListItemIndented` 确定列表类型（有序/无序）、`start` 序号与 `baseIndent`；主循环逐项解析同级列表项（`indent === baseIndent` 且 marker 类型一致），通过 `collectItemSubLines` 归集续行，通过 `buildListItemChildren` 构建子节点；`list-item` 的 `children` 由原单一 `paragraph` 改为 `paragraph` + 嵌套节点；`checked` 由透传 `item.checked` 改为显式 `null`
+
+### 删除
+
+- **`parseListItem()`** — `src/core/markdown/plugins.ts` 删除，该函数被 `parseListItemIndented` 完全替代，全仓库无任何引用

package/docs/issue/AGENTS.md

@@ -6,9 +6,30 @@
 
 ## 目录结构
 
-| 文件                 | 说明                |
-| -------------------- | ------------------- |
-| `issue_{version}.md` | 各 Issue 的变更文档 |
+按基线版本分目录存放，每个基线版本对应一个子目录：
+
+| 路径                            | 说明                                    |
+| ------------------------------- | --------------------------------------- |
+| `{baseline}/`                   | 基线版本子目录（如 `26.3.2/`）          |
+| `{baseline}/issue_{version}.md` | 该基线下的各 Issue 变更文档（如 `26.3.2/issue_26.3.2.4.md`） |
+| `AGENTS.md`                     | 本目录的约定说明                        |
+
+示例：
+
+```
+docs/issue/
+├── AGENTS.md
+├── 26.2.2/
+│   ├── issue_26.2.2.1.md
+│   └── ...
+├── 26.2.3/
+│   ├── issue_26.2.3.1.md
+│   └── ...
+├── 26.3.1/
+│   └── ...
+└── 26.3.2/
+    └── ...
+```
 
 ## 文档格式
 

package/docs/markdown.md

@@ -159,7 +159,7 @@ parser.parse('**Bold** ~~strike~~ `code` :smile:');
 | ---- | ------------------ | -------------------- | ------------------------------------ |
 | 6    | `blockquotePlugin` | `> text`             | `<blockquote class="md-blockquote">` |
 | 7    | `taskListPlugin`   | `- [ ]` / `- [x]`    | `<li><input type="checkbox">`        |
-| 8    | `listPlugin`       | `- item` / `1. item` | `<li class="md-li">`                 |
+| 8    | `listPlugin`       | `- item` / `1. item` | `<ul>` / `<ol>`（支持嵌套子列表和缩进续行） |
 
 **Inlines / 行内：**
 
@@ -247,7 +247,7 @@ type MarkdownLinkHook = (url: string, text: string) => string | undefined | null
 | `codeFencePlugin`     | `'code-fence'`     | ✅    | 围栏代码块 ` ``` ` / `~~~`   |
 | `tablePlugin`         | `'table'`          | ✅    | GFM 表格                     |
 | `blockquotePlugin`    | `'blockquote'`     | ✅    | 引用块 `>`                   |
-| `listPlugin`          | `'list'`           | ✅    | 无序/有序列表                |
+| `listPlugin`          | `'list'`           | ✅    | 无序/有序列表，支持嵌套子列表和缩进续行 |
 | `taskListPlugin`      | `'task-list'`      | ✅    | 任务列表 `- [ ]` / `- [x]`   |
 | `boldPlugin`          | `'bold'`           | ❌    | 加粗 `**text**`              |
 | `italicPlugin`        | `'italic'`         | ❌    | 斜体 `*text*` / `_text_`     |

package/docs/quickstart.md

@@ -1,6 +1,6 @@
 # Quick Start / 快速上手
 
-Aithe UI 是基于 Lit 3.x 的 Web Components 组件库，提供 83 个可复用 UI 组件、22 种内置主题、8 种形状风格、9 种阴影风格、4 种排版风格和完整的国际化支持。
+Aithe UI 是基于 Lit 3.x 的 Web Components 组件库，提供 103 个可复用 UI 组件、25 种内置主题、8 种形状风格、9 种阴影风格、4 种排版风格和完整的国际化支持。
 
 ## 安装
 
@@ -19,8 +19,8 @@ import '@aithe/aithe-ui';
 
 仅此一行即可使用所有组件——`import '@aithe/aithe-ui'` 会自动完成：
 
-- 注册全部 83 个 Custom Elements
-- 注入 22 种主题的 CSS 变量
+- 注册全部 103 个 Custom Elements
+- 注入 25 种主题的 CSS 变量
 - 初始化 i18n（默认 `en-US`）
 
 ### 2. 在 HTML 中使用组件
@@ -242,8 +242,8 @@ const res = await dataHub.request(
 ## 下一步
 
 - [使用指南](guide.md) — 组件通用 API、事件、插槽、形状风格、布局密度、路由
-- [主题系统](theming.md) — 22 种内置主题、8 种形状风格、9 种阴影风格、自定义主题、CSS 变量
+- [主题系统](theming.md) — 25 种内置主题、8 种形状风格、9 种阴影风格、自定义主题、CSS 变量
 - [国际化](i18n.md) — 多语言支持、自定义翻译
 - [DataHub 数据中间层](datahub.md) — 请求调度、缓存、去重、Mock
 - [框架集成](framework-integration.md) — React / Vue / Angular / Svelte 集成
-- [API 参考](api/summary.md) — 全部 83 个组件的详细 API 文档
+- [API 参考](api/summary.md) — 全部 103 个组件的详细 API 文档

package/docs/theming.md

@@ -425,9 +425,10 @@ const unsubscribe = aitheUI.onTypoChange(() => {
 
 通过 `aitheUI.setTheme()` 设置全局主题，作用于 `<html>` 元素的 `data-aithe-theme` 属性：
 
-````ts
+```ts
 aitheUI.setTheme('dark');
-// <html data-aithe-theme="dark">```
+// <html data-aithe-theme="dark">
+```
 
 ### 局部主题覆盖
 
@@ -438,7 +439,7 @@ aitheUI.setTheme('dark');
 <aithe-card theme="dark">
   <aithe-button type="primary">Dark Button</aithe-button>
 </aithe-card>
-````
+```
 
 组件内部通过 `computedTheme` getter 解析最终主题（本地覆盖 → 最近带主题祖先 → 全局）。
 
@@ -643,4 +644,4 @@ static override readonly styles = [
 
 - [国际化](i18n.md) — 多语言支持
 - [使用指南](guide.md) — 组件通用 API、形状风格、阴影风格、排版风格、布局密度
-- [API 参考](api/summary.md) — 全部 83 个组件详细 API
+- [API 参考](api/summary.md) — 全部 103 个组件详细 API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aithe/aithe-ui",
-  "version": "26.2.3",
+  "version": "26.3.2",
   "description": "A cross-framework Web Components design system built with Lit 3.x and TypeScript — 79 components, 22 themes, i18n, and accessible semantics.",
   "license": "MIT",
   "type": "module",
@@ -52,6 +52,8 @@
     "preview": "vite preview",
     "preview:api": "vite preview --outDir dist/apps/api",
     "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
     "format": "prettier --check src/",
@@ -78,6 +80,7 @@
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.59.3",
     "vite": "^8.0.12",
-    "vite-plugin-markdown": "^2.2.0"
+    "vite-plugin-markdown": "^2.2.0",
+    "vitest": "^4.1.6"
   }
 }

package/dist/components/navigation/dropdown.d.ts

@@ -1,56 +0,0 @@
-import type { PropertyValues } from 'lit';
-import { AitheAnchoredOverlayElement } from '../../core/anchored-overlay';
-import type { AitheTreeNodeMeta } from '../../core/types';
-/**
- * Dropdown menu with nested submenus, keyboard navigation, and hover/click triggers.
- * Internally uses `<aithe-tree-menu>` for menu rendering.
- * 下拉菜单，支持嵌套子菜单、键盘导航和悬停/点击触发。内部使用 `<aithe-tree-menu>` 渲染菜单。
- *
- * @slot - Default slot for the trigger element. 触发元素内容。
- * @fires aithe-select - Emitted when a menu item is selected, with `{ item, path, id }`. 菜单项选中时触发。
- * @fires aithe-open-change - Emitted when open state changes, with `{ open }`. 开关状态变更时触发。
- * @example
- * ```html
- * <aithe-dropdown trigger="click" items='[{"id":"a","label":"Action"},{"id":"b","label":"Another"}]'>
- *   <button>Menu</button>
- * </aithe-dropdown>
- * ```
- */
-export declare class AitheDropdown extends AitheAnchoredOverlayElement {
-    /** Trigger mode: click or hover. 触发方式：点击或悬停。 */
-    trigger: 'click' | 'hover';
-    /** Display title for the dropdown trigger (shown as tooltip). 下拉菜单触发器的显示标题（作为工具提示）。 */
-    title: string;
-    /** Icon name to display before the trigger slot content. 在触发器插槽内容前显示的图标名称。 */
-    icon: string;
-    /** JSON string of dropdown menu items. 下拉菜单项的 JSON 字符串。 */
-    itemsJson: string;
-    /** Array of dropdown menu item objects. 下拉菜单项对象数组。 */
-    items: readonly AitheTreeNodeMeta[];
-    /** Dropdown panel placement. 下拉面板位置。 */
-    placement: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
-    private readonly panel?;
-    private activeId;
-    protected willUpdate(changed: PropertyValues<this>): void;
-    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    protected get panelElement(): HTMLElement | null;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    protected updated(changed: PropertyValues<this>): void;
-    /** Closes dropdown on outside pointer events. 点击外部时关闭下拉菜单。 */
-    private readonly handleOutsidePointer;
-    /** Closes dropdown on Escape key. 按 Escape 键关闭下拉菜单。 */
-    private readonly handleDocumentKeydown;
-    /** Toggles dropdown open state (click trigger only). 切换下拉菜单开关状态（仅点击触发）。 */
-    private readonly toggleOpen;
-    /** Opens dropdown on hover (hover trigger only). 悬停时打开下拉菜单（仅悬停触发）。 */
-    private readonly openOnHover;
-    /** Closes dropdown on hover end (hover trigger only). 悬停结束时关闭下拉菜单（仅悬停触发）。 */
-    private readonly closeOnHoverEnd;
-    /** Handles item selection from the tree-menu and emits aithe-select. 处理 tree-menu 的选中事件并触发 aithe-select。 */
-    private readonly handleTreeSelect;
-    /** Recursively finds an item by id. 递归查找指定 id 的菜单项。 */
-    private findItemById;
-    render(): import("lit-html").TemplateResult<1>;
-}
-//# sourceMappingURL=dropdown.d.ts.map

package/dist/components/navigation/dropdown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/dropdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAI1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;;;;;;;;;GAcG;AACH,qBACa,aAAc,SAAQ,2BAA2B;IAC5D,gDAAgD;IACpB,OAAO,EAAE,OAAO,GAAG,OAAO,CAAW;IACjE,uFAAuF;IAC3D,KAAK,SAAM;IACvC,8EAA8E;IAClD,IAAI,SAAM;IACtC,2DAA2D;IACX,SAAS,SAAM;IAC/D,sDAAsD;IACtB,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAM;IACzE,wCAAwC;IACZ,SAAS,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAC7E;IAEA,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;IAE7C,OAAO,CAAC,QAAQ,CAAM;IAE/B,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+BpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAYtD,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQnC;IAEF,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAIzB;IAEF,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAI9B;IAEF,4GAA4G;IAC5G,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAO/B;IAEF,uDAAuD;IACvD,OAAO,CAAC,YAAY;IAcpB,MAAM;CAkCP"}