@aithe/aithe-ui 26.2.2 → 26.3.1

package/docs/issue/issue_26.3.1.0.md

@@ -0,0 +1,84 @@
+# Issue 26.3.1.0
+
+## 版本信息
+
+- **版本号**: 26.3.1.0
+- **基线版本**: 26.3.1
+- **类型**: Feature
+- **日期**: 2026-06-15
+
+## 变更概述
+
+1. **aithe-tree-menu 伸缩功能** — 新增 `collapsible`、`collapsed`、`collapsed-width`、`expanded-width` 属性，支持侧边栏收起/展开场景；collapsed 状态下隐藏标签和箭头、按钮居中、无图标时显示首字母 fallback；子菜单无浮层效果，正常向下展开
+2. **aithe-sidebar 改用 aithe-tree-menu** — 移除自有菜单渲染逻辑（`renderItems`/`renderIcon`/`toggleExpand`/`selectItem`/`isGroupActive`/`collectKeys` 等），center 区域改用 `<aithe-tree-menu>` 组件；`handleTreeSelect` 仅更新 `this.active`，不再 re-emit（事件 `composed: true` 自动穿透 shadow DOM）
+3. **aithe-dropdown 移除 findItemById** — `handleTreeSelect` 仅关闭面板，不再 re-emit；移除 `findItemById` 递归方法；删除 `src/components/navigation/dropdown.ts` 旧文件
+4. **aithe-theme-switch 用 item.category 替代遍历** — `buildThemeMenu` 给每个子项添加 `category` 字段；`handleTreeSelect` 直接从 `item.category` 读取分类，替代遍历菜单数组
+5. **aithe-admin-layout 移除 findMenuNode** — `handleSidebarSelect` 直接使用事件中的 `item` 对象，移除 `findMenuNode` 递归方法
+6. **aithe-tree-menu 选中背景内缩** — `.item.active` 增加 `padding` 和 `margin`，选中背景不铺满
+7. **aithe-tree-menu selectItem 改为接收 AitheTreeNodeMeta** — `aithe-select` 事件 detail 从 `{ value }` 改为 `{ value, item }`
+8. **Admin 仪表盘取数修复** — `fetchStats` 增加 `AbortController` 防竞态、`disconnectedCallback` 中 abort、loading URL 匹配从 `includes` 改为 `endsWith`、双重解包防御
+9. **文档同步更新** — tree-menu.md、dropdown.md、sidebar.md、theme-switch.md 更新
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `aithe-tree-menu` 的 `aithe-select` 事件 detail | `{ value: string }` | `{ value: string, item: AitheTreeNodeMeta }` |
+| `aithe-dropdown` 的 `aithe-select` 事件 | 组件 re-emit，detail 含 `{ item, path, id }` | 不再 re-emit，事件由 `aithe-tree-menu` 的 `composed: true` 自动穿透，detail 为 `{ value, item }` |
+| `aithe-sidebar` 的 `aithe-select` 事件 | 组件 re-emit | 不再 re-emit，事件由 `aithe-tree-menu` 的 `composed: true` 自动穿透 |
+| `aithe-tree-menu.selectItem` 参数 | `key: string` | `item: AitheTreeNodeMeta` |
+| `src/components/navigation/dropdown.ts` | 存在（旧版 dropdown） | 删除 |
+
+## 变更内容
+
+### 新增
+
+- **`aithe-tree-menu` 的 `collapsible` 属性** — 布尔属性，控制树菜单是否支持伸缩切换
+- **`aithe-tree-menu` 的 `collapsed` 属性** — 布尔属性（reflect），控制树菜单当前是否收起
+- **`aithe-tree-menu` 的 `collapsed-width` 属性** — 收起时的宽度，默认 `64px`
+- **`aithe-tree-menu` 的 `expanded-width` 属性** — 展开时的宽度，默认 `260px`
+- **`aithe-tree-menu` 的 `renderIcon` 方法** — 统一渲染图标逻辑，collapsed 无图标时显示首字母 fallback（`.fallback-icon` 样式）
+- **`aithe-tree-menu` collapsed 样式** — `:host([collapsed])` 下隐藏 `.item-label`/`.group-toggle-text`/`.arrow`；按钮居中；子菜单 `padding-left: 0`、`position: relative`、`z-index` 溢出显示
+- **`aithe-tree-menu` 选中背景内缩** — `.item.active` 增加 `padding: var(--aithe-space-1) var(--aithe-space-3)` 和 `margin: 0`
+- **`aithe-tree-menu` 宽度过渡动画** — `:host` 增加 `transition: width` 动画
+
+### 修改
+
+#### aithe-tree-menu 伸缩与事件改造
+
+- **`src/components/data/tree-menu.ts`** — 新增 `collapsible`/`collapsed`/`collapsedWidth`/`expandedWidth` 四个属性；`selectItem` 参数从 `key: string` 改为 `item: AitheTreeNodeMeta`，事件 detail 从 `{ value }` 改为 `{ value, item }`；新增 `renderIcon` 方法统一图标渲染逻辑；`handleDocumentPointer` 仅 horizontal 模式点击外部关闭；`renderItems` 中 group-toggle 和 leaf item 均改用 `renderIcon`；leaf item 标签包裹 `<span class="item-label">`；group-toggle 文本包裹 `<span class="group-toggle-text">`；collapsed 时按钮增加 `title` 属性；新增 `applyWidth` 方法和 `updated` 中监听 `collapsed`/`expandedWidth`/`collapsedWidth` 变化
+
+#### aithe-sidebar 改用 aithe-tree-menu
+
+- **`src/components/framework/sidebar.ts`** — 移除 `expanded` 状态、`collectKeys`/`isGroupActive`/`toggleExpand`/`selectItem`/`renderIcon`/`renderItems` 方法；移除 `.menu`/`.item`/`.item-icon`/`.fallback-icon`/`.item-label`/`.item.active`/`.group-toggle`/`.group-toggle-label`/`.group-toggle-icon`/`.group-toggle-text`/`.arrow`/`.children` 等大量 CSS 样式；center 区域改为 `<aithe-tree-menu>` 组件，传入 `items`/`active`/`expandAll`/`collapsible`/`collapsed`/`itemFilter`/`collapsedWidth`/`expandedWidth`；`handleTreeSelect` 仅更新 `this.active`；`:host([collapsed])` 增加 `overflow: visible`；`:host([collapsed]) .center` 增加 `overflow: visible`；移除 `classMap`/`translateNodeLabel` 导入
+
+#### aithe-dropdown 移除 findItemById
+
+- **`src/components/data/dropdown.ts`** — `handleTreeSelect` 不再 re-emit，仅关闭面板；移除 `findItemById` 递归方法；导入路径从相对路径改为 `@core/` 别名
+- **`src/components/navigation/dropdown.ts`** — 删除旧版 dropdown 文件
+
+#### aithe-theme-switch 用 item.category 替代遍历
+
+- **`src/components/theme/theme-switch.ts`** — `buildThemeMenu` 中 theme 组子项添加 `category: 'theme'`；shadow/shape/typo 子项分别添加 `category` 字段；`handleTreeSelect` 直接从 `item.category` 读取分类，移除遍历 `themeMenu`/`shadowMenu`/`shapeMenu`/`typoMenu` 的逻辑
+
+#### aithe-admin-layout 移除 findMenuNode
+
+- **`src/apps/admin/components/admin-layout.ts`** — `handleSidebarSelect` 直接使用 `e.detail.item` 替代 `findMenuNode` 递归查找；移除 `findMenuNode` 方法；`fetchMenuData` 调用加 `void`；`router.navigate` 调用加 `void`
+
+#### Admin 仪表盘取数修复
+
+- **`src/apps/admin/pages/dashboard-page.ts`** — 新增 `abortController` 属性；`fetchStats` 中每次请求前 abort 上一次、创建新 `AbortController`、传入 `signal`；请求后检查 `aborted` 跳过；双重解包防御（`res.data` 仍有 `data` 嵌套时自动解包）；`disconnectedCallback` 中 abort；loading URL 匹配从 `includes` 改为 `endsWith`
+
+#### 文档更新
+
+- **`docs/api/data/tree-menu.md`** — 新增 `collapsible`/`collapsed`/`collapsed-width`/`expanded-width` 属性文档；`itemRenderer` 说明；collapsed 模式行为说明；`aithe-select` 事件 detail 更新为 `{ value, item }`；事件传播说明（`composed: true`）
+- **`docs/api/data/dropdown.md`** — `aithe-select` 事件 detail 更新为 `{ value, item }`
+- **`docs/api/framework/sidebar.md`** — 新增 composed 透传说明
+- **`docs/api/theme/theme-switch.md`** — `category` 来自 `item.category` 说明
+
+### 删除
+
+- **`src/components/navigation/dropdown.ts`** — 删除旧版 dropdown 文件（已迁移至 `src/components/data/dropdown.ts`）
+- **`aithe-sidebar` 自有菜单渲染逻辑** — 移除 `renderItems`/`renderIcon`/`toggleExpand`/`selectItem`/`isGroupActive`/`collectKeys`/`expanded` 状态及对应 CSS 样式
+- **`aithe-dropdown` 的 `findItemById` 方法** — 移除递归查找方法
+- **`aithe-admin-layout` 的 `findMenuNode` 方法** — 移除递归查找方法

package/docs/issue/issue_26.3.1.1.md

@@ -0,0 +1,72 @@
+# Issue 26.3.1.1
+
+## 版本信息
+
+- **版本号**: 26.3.1.1
+- **基线版本**: 26.3.1
+- **类型**: Feature
+- **日期**: 2026-06-16
+
+## 变更概述
+
+1. **`AitheSidebarItemFilter` 类型重命名** — 改为 `AitheTreeNodeFilter`，语义更通用，适用于所有树形菜单组件的过滤场景
+2. **`aithe-tree-menu` 默认权限过滤** — 新增内置 `itemFilter` 默认值，检查 `item.hasPermission !== false`，支持通过 `hasPermission` 字段控制菜单项显隐
+3. **`aithe-dropdown` 新增 `itemFilter` 属性** — 透传给内部 `<aithe-tree-menu>`，支持上层使用者定制菜单项过滤
+4. **`Markdown`解析器增强** — 新增 `RawInlineNode` 类型和 `_resolveRawInlines` 方法，支持列表项内行内解析（粗体、链接等）；`paragraph` 渲染增加 `md-p` CSS 类；新增 `span` 节点类型渲染；新增粗体 CSS 样式
+5. **`Dashboard CSS` 变量修复** — `border-radius` 使用 `--aithe-container-radius-lg` 替代硬编码 `--aithe-radius-lg`
+6. **`publish.js` 跨平台兼容** — Windows 平台下 spawn 增加 `shell: true` 选项
+7. **文档同步更新** — `aithe-tree-menu`、`aithe-sidebar`、`aithe-dropdown` API 文档更新 `item-filter` 属性描述，新增 `hasPermission` 字段说明
+8. **Sonar 技术债务清理** — 共修复 11 处 Sonar 问题：
+   - `code.ts`：LaTeX 字符串改用 `String.raw` 消除转义反斜杠
+   - `code-editor.ts`：移除冗余类型断言 `as AitheBuiltinTheme`；移除未使用的 `AitheBuiltinTheme` 导入
+   - `form-item.ts`：合并 `querySelector` 泛型与类型断言，移除中间变量
+   - `affix.ts` / `back-top.ts`：移除 `removeEventListener` 中多余的 `as EventListener` 断言
+   - `theme-preview.ts`：`value` 属性类型由 `AitheBuiltinTheme | string` 简化为 `string`；移除未使用的 `AitheBuiltinTheme` 导入
+   - `theme-switch.ts`：移除 `as ThemeCategory` 冗余类型断言
+   - `dedup.ts`：`data` 参数移除多余的 `| undefined` 联合类型
+   - `LoggerCore.ts`：移除 `payload as unknown[]` 冗余类型断言
+   - `index.ts`（i18n）：移除 `raw as AitheLocale` 冗余类型断言
+   - `plugins.ts`：所有 `String.match()` 替换为 `RegExp.exec()`
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `AitheSidebarItemFilter` 类型名 | `AitheSidebarItemFilter` | `AitheTreeNodeFilter` |
+| `aithe-tree-menu.itemFilter` 默认值 | `null`（不过滤） | `(item) => item.hasPermission !== false`（过滤 `hasPermission: false` 的项） |
+
+## 变更内容
+
+### 新增
+
+- **`aithe-dropdown.itemFilter` 属性** — `src/components/data/dropdown.ts` 新增 `itemFilter: AitheTreeNodeFilter | null` 属性，透传给内部 `<aithe-tree-menu>`，支持上层使用者定制菜单项过滤
+- **`RawInlineNode` 类型** — `src/core/markdown/types.ts` 新增 `raw-inline` 节点类型定义，用于列表项内行内文本的二次解析
+- **`_resolveRawInlines` 方法** — `src/core/markdown/parser.ts` 新增私有方法，递归遍历 AST 将 `raw-inline` 节点解析为行内 AST 节点（粗体、链接等）
+- **`span` 节点渲染** — `src/core/markdown/parser.ts` `renderAst` 新增 `span` 类型处理，渲染子节点
+- **粗体 CSS 样式** — `src/components/display/markdown.ts` 新增 `.md-strong` 样式，`font-weight: 700`
+
+### 修改
+
+- **`src/core/types.ts`** — `AitheSidebarItemFilter` 类型重命名为 `AitheTreeNodeFilter`，JSDoc 同步更新
+- **`src/components/data/tree-menu.ts`** — 属性类型 `AitheSidebarItemFilter` → `AitheTreeNodeFilter`；`renderItems` 中 `itemFilter` 默认值改为 `(item) => item.hasPermission !== false`，当未设置自定义 filter 时自动过滤 `hasPermission: false` 的节点；`updated` 中 `collapsed`/`expandedWidth`/`collapsedWidth` 条件合并；`render` 中移除冗余的 `applyWidth` 调用（已由 `updated` 处理）
+- **`src/components/framework/sidebar.ts`** — 属性类型 `AitheSidebarItemFilter` → `AitheTreeNodeFilter`
+- **`src/components/data/dropdown.ts`** — 导入新增 `AitheTreeNodeFilter` 类型；模板中透传 `.itemFilter` 给内部 `<aithe-tree-menu>`
+- **`src/core/markdown/parser.ts`** — `parseBlocks` 末尾调用 `_resolveRawInlines`；`renderAst` 中 `paragraph` 渲染增加 `<p class="md-p">` 包裹；新增 `span` 节点渲染
+- **`src/core/markdown/plugins.ts`** — `listPlugin` 和 `taskListPlugin` 中列表项文本节点类型由 `text` 改为 `raw-inline`，以支持行内解析；所有 `String.match()` 替换为 `RegExp.exec()`（Sonar 规则 `prefer-regexp-exec`）
+- **`src/components/framework/dashboard.ts`** — CSS `border-radius` 使用 `--aithe-container-radius-lg` 替代 `--aithe-radius-lg`
+- **`src/components/display/markdown.ts`** — 新增 `.md-strong` CSS 样式
+- **`publish.js`** — Windows 平台兼容，spawn 增加 `shell: process.platform === 'win32'` 选项
+- **Sonar 技术债务修复**：
+  - **`src/apps/demo/pages/code.ts`** — LaTeX 字符串改用 `String.raw` 模板字面量，消除转义反斜杠
+  - **`src/components/display/code-editor.ts`** — 移除冗余类型断言 `as AitheBuiltinTheme` 及未使用的 `AitheBuiltinTheme` 导入
+  - **`src/components/form/form-item.ts`** — 合并 `querySelector` 泛型与类型断言，移除中间变量 `typedControl`
+  - **`src/components/layout/affix.ts`** — 移除 `removeEventListener` 中多余的 `as EventListener` 断言
+  - **`src/components/navigation/back-top.ts`** — 同上
+  - **`src/components/theme/theme-preview.ts`** — `value` 属性类型由 `AitheBuiltinTheme | string` 简化为 `string`；移除未使用的 `AitheBuiltinTheme` 导入
+  - **`src/components/theme/theme-switch.ts`** — 移除 `as ThemeCategory` 冗余类型断言
+  - **`src/core/datahub/utils/dedup.ts`** — `data` 参数移除多余的 `| undefined` 联合类型
+  - **`src/core/logger/LoggerCore.ts`** — 移除 `payload as unknown[]` 冗余类型断言
+  - **`src/styles/i18n/index.ts`** — 移除 `raw as AitheLocale` 冗余类型断言
+- **`docs/api/data/tree-menu.md`** — `item-filter` 属性 Default 改为"内置默认值"，描述补充默认过滤逻辑；Data Item Fields 新增 `hasPermission` 字段
+- **`docs/api/framework/sidebar.md`** — 同上
+- **`docs/api/data/dropdown.md`** — Properties 表格新增 `item-filter` 属性行

package/docs/issue/issue_26.3.1.2.md

@@ -0,0 +1,75 @@
+# Issue 26.3.1.2
+
+## 版本信息
+
+- **版本号**: 26.3.1.2
+- **基线版本**: 26.3.1
+- **类型**: Feature
+- **日期**: 2026-06-18
+
+## 变更概述
+
+1. **Filter 数据格式化框架** — 新增轻量 Filter 模块，支持声明式过滤器表达式，零第三方依赖；内置 5 种过滤器（金额、日期、空值替换、字节数、时间友好显示）；支持链式过滤和自定义扩展
+2. **`<aithe-metrics>` 集成 filter** — `MetricsData` 接口新增 `filter` 字段，支持通过 `data.filter` / `params.filter` 设置过滤器表达式格式化指标值
+3. **`<aithe-table-column>` 集成 filter** — 新增 `filter` 属性，支持对列单元格值进行格式化，优先级：`cellRenderer` > `filter` > 原始值
+4. **`<aithe-table>` 集成 filter** — `syncSlotColumns` 同步 `filter` 到列元数据；`renderCell` 新增 filter 格式化逻辑
+5. **`<aithe-modal>` / `<aithe-drawer>` transform 定位修复** — 将 `transform` 动画从 `.panel` 移至内部 `.panel-inner` 包装层，避免破坏内部 `fixed` 定位子元素的参考系
+6. **`MockAdapter` 增强** — 新增 `mockPath` 支持，可通过 URL 加载远程 Mock 数据文件
+7. **国际化扩展** — `zh-CN` / `en-US` 新增 `filter.timeAgo.*` 翻译键（共 18 条），支持时间友好显示的本地化文案
+8. **测试框架集成** — 安装 `vitest@^4.1.6`，新增 `vitest.config.ts` 配置，添加 `test` / `test:watch` 脚本；Filter 模块 38 个测试用例全部通过
+9. **文档同步更新** — 新增 `docs/filter.md`（完整 Filter 模块文档）；更新 `docs/guide.md`（新增 Filter 数据格式化章节）；更新 `metrics.md`、`table.md`、`table-column.md` API 文档（新增 `filter` 字段说明）
+
+## 破坏性变更
+
+无。
+
+## 变更内容
+
+### 新增
+
+- **Filter 数据格式化模块** — `src/core/filter/` 目录下新建 4 个核心文件：
+  - `types.ts` — 定义 `Filter<T, R>` 接口、`FilterExpression`、`FilterConfig` 类型
+  - `builtins.ts` — 5 个内置过滤器：`AmountFilter`（金额保留两位小数）、`DateFilter`（日期格式化，支持自定义格式占位符）、`EmptyFilter`（空值替换，支持自定义占位符）、`BytesFilter`（字节数格式化，IEC/SI 双标准）、`TimeAgoFilter`（时间友好显示，支持过去/未来时间，超 1 年显示日期）
+  - `factory.ts` — `FilterFactory` 工厂类，提供 `register`/`get`/`has`/`names`/`format`/`parse`/`stringify` 方法；支持链式表达式解析（如 `"date yyyy/MM/dd | empty"`）
+  - `index.ts` — 模块统一导出入口，导出 `filterFactory` 全局实例
+- **`src/index.ts`** — 新增 `export * from '@core/filter'`，Filter 模块对外导出
+- **`<aithe-table-column.filter>` 属性** — `src/components/data/table-column.ts` 新增 `@property({ type: String }) filter = ''`，支持声明式过滤器表达式
+- **`vitest.config.ts`** — 新增 Vitest 配置文件，配置 `@core`/`@styles` 路径别名，`node` 测试环境
+- **`docs/filter.md`** — 完整 Filter 模块文档（332 行），包含快速开始、5 个内置过滤器详解（输入输出对照表）、表达式语法、组件集成示例、编程式使用、自定义过滤器开发指南、类型定义和 API 参考
+- **国际化翻译键** — `zh-CN.ts` 和 `en-US.ts` 各新增 9 条 `filter.timeAgo.*` 翻译键（justNow、minutesAgo、minutesLater、hoursAgo、hoursLater、daysAgo、daysLater、monthsAgo、monthsLater）
+
+### 修改
+
+#### Filter 模块
+
+- **`src/core/types.ts`** — `AitheTableColumnMeta` 接口新增 `filter?: string` 字段
+
+#### 组件集成
+
+- **`src/components/data/metrics.ts`** — `MetricsData` 接口新增 `filter?: string` 字段（含 JSDoc 优先级说明和 `@see` 链接）；`renderMetrics` 中解析 `data.filter` / `params.filter` 优先级，通过 `filterFactory.format()` 格式化值
+- **`src/components/data/table.ts`** — 导入 `filterFactory`；`syncSlotColumns` 同步 `filter` 到列元数据；`renderCell` 新增 filter 格式化逻辑，优先级：`cellRender` > `filter` > 原始值
+
+#### modal/drawer transform 定位修复
+
+- **`src/components/feedback/modal.ts`** — 将 `transform` 动画从 `.panel` 移至内部新增的 `.panel-inner` 包装层，`.panel` 自身不再持有 `transform`，避免破坏内部 `fixed` 定位子元素
+- **`src/components/feedback/drawer.ts`** — 同上，将 `placement` 相关的 `transform`（`top`/`right`/`bottom`/`left`）移至 `.panel-inner`；`.overlay.open .panel-inner` 控制动画归零
+
+#### MockAdapter 增强
+
+- **`src/core/datahub/core/adapter/mock-adapter.ts`** — 重构 `request` 方法：支持 `mockData` 和 `mockPath` 两种模式；`mockPath` 模式下通过 `fetch` 加载远程 JSON 文件；提取 `mockDelay` 配置项
+
+#### 文档更新
+
+- **`docs/api/data/metrics.md`** — Properties 表格新增 `filter` 字段行
+- **`docs/api/data/table-column.md`** — Properties 表格新增 `filter` 字段行
+- **`docs/api/data/table.md`** — Column Fields 表格新增 `filter` 字段行
+- **`docs/guide.md`** — 在 TypeScript 支持之后新增 Filter 数据格式化章节（基本用法、内置过滤器一览表、组件使用示例、自定义过滤器示例），并在"下一步"链接中新增 filter.md 入口
+
+#### 构建与测试
+
+- **`package.json`** — 新增 `test` / `test:watch` 脚本；新增 `vitest@^4.1.6` 开发依赖
+- **`package-lock.json`** — 更新 lockfile，新增 vitest 及其子依赖（`@vitest/*`、`tinybench`、`tinyexec`、`tinyrainbow`、`std-env`、`stackback`、`why-is-node-running`、`siginfo`、`pathe`、`expect-type`、`obug` 等）
+
+### 删除
+
+无。

package/docs/issue/issue_26.3.1.3.md

@@ -0,0 +1,78 @@
+# Issue 26.3.1.3
+
+## 版本信息
+
+- **版本号**: 26.3.1.3
+- **基线版本**: 26.3.1
+- **类型**: Feature
+- **日期**: 2026-06-23
+
+## 变更概述
+
+1. **`<aithe-autoform>` 增强** — 新增 `initial-values` 属性支持外部初始值覆盖 `dft`；新增 `show-submit` 属性控制内置提交按钮显隐；新增 `submit()` 方法编程触发提交；操作区改用 `<aithe-button-group>` 包裹 slot 和内置按钮
+2. **`<aithe-anchored-overlay>` 含入块偏移修正** — 修复 `position:fixed` 面板在 `transform`/`filter` 等祖先元素内定位偏移的问题，通过临时设置 `left:0;top:0` 测量含入块偏移量并补偿
+3. **事件名统一** — `<aithe-dropdown>`、`<aithe-popover>`、`<aithe-tooltip>`、`<aithe-select>` 的开关状态变更事件由 `aithe-open-change` 统一为 `aithe-dropdown-change`
+4. **原生事件冒泡控制** — `<aithe-input>`、`<aithe-textarea>`、`<aithe-code-editor>`、`<aithe-combobox>` 在原生事件处理器中调用 `event.stopPropagation()`，防止原生事件逃逸到组件外部
+5. **文档与注释同步更新** — 更新 `autoform.ts`/`anchored-overlay.ts` JSDoc；更新 `docs/autoform.md`/`docs/api/form/autoform.md`；更新 6 个 AGENTS.md
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `<aithe-dropdown>` 开关状态事件名 | `aithe-open-change` | `aithe-dropdown-change` |
+| `<aithe-popover>` 开关状态事件名 | `aithe-open-change` | `aithe-dropdown-change` |
+| `<aithe-tooltip>` 开关状态事件名 | `aithe-open-change` | `aithe-dropdown-change` |
+| `<aithe-select>` 开关状态事件名 | `aithe-open-change` | `aithe-dropdown-change` |
+| `<aithe-autoform>` slot 行为 | 传入 slot 内容时替换内置提交按钮 | slot 与内置按钮共存，通过 `show-submit` 控制显隐 |
+
+## 变更内容
+
+### 新增
+
+- **`<aithe-autoform>.initial-values` 属性** — `src/components/form/autoform.ts` 新增 `@property({ type: Object, attribute: 'initial-values' })`，支持对象或 JSON 字符串，匹配字段名覆盖 `dft` 值
+- **`<aithe-autoform>.show-submit` 属性** — `src/components/form/autoform.ts` 新增 `@property({ type: Boolean, attribute: 'show-submit' })`，控制内置提交按钮显隐，默认 `true`
+- **`<aithe-autoform>.submit()` 方法** — `src/components/form/autoform.ts` 新增 `submit(): void` 方法，编程触发表单校验和提交，通过后触发 `aithe-submit` 事件
+
+### 修改
+
+#### `<aithe-autoform>` 重构
+
+- **`src/components/form/autoform.ts`** — 移除 `@queryAssignedElements`/`@state hasActionSlot`/`syncActionSlot`/`aithe-divider`；新增 `initial-values`/`show-submit`/`submit()`；操作区改用 `<aithe-button-group>` 包裹 `<slot>` 和内置按钮，通过 `show-submit` 条件渲染；`field.dft` 改为优先取 `initVals[field.name]`；移除 `.autoform-actions` CSS；`@property` 导入移除 `queryAssignedElements`；新增 `nothing` 导入
+- **`src/components/form/autoform-item.ts`** — 移除 `connectedCallback` 和 `updated` 中的两处 `console.log` 调试日志
+
+#### 事件名统一（`aithe-open-change` → `aithe-dropdown-change`）
+
+- **`src/components/data/dropdown.ts`** — JSDoc `@fires` 更新；`updated` 中事件名改为 `aithe-dropdown-change`
+- **`src/components/feedback/popover.ts`** — JSDoc `@fires` 更新；`updated` 中事件名改为 `aithe-dropdown-change`
+- **`src/components/feedback/tooltip.ts`** — JSDoc `@fires` 更新
+- **`src/components/form/select.ts`** — JSDoc `@fires` 更新；`updated` 中事件名改为 `aithe-dropdown-change`
+
+#### 原生事件冒泡控制
+
+- **`src/components/basic/input.ts`** — `handleInput` 和 `handleChange` 中增加 `event.stopPropagation()`
+- **`src/components/basic/textarea.ts`** — `handleInput` 和 `handleChange` 中增加 `event.stopPropagation()`
+- **`src/components/display/code-editor.ts`** — `handleInput` 中增加 `e.stopPropagation()`
+- **`src/components/form/combobox.ts`** — `handleInput` 中增加 `event.stopPropagation()`
+
+#### `<aithe-anchored-overlay>` 含入块偏移修正
+
+- **`src/core/anchored-overlay.ts`** — `updateFloatingPosition` 中新增含入块偏移测量逻辑：临时设置 `panel.style.left = '0px'` 和 `panel.style.top = '0px'`，通过 `getBoundingClientRect()` 获取含入块偏移 `cbOffsetX`/`cbOffsetY`，最终定位时减去偏移量；类 JSDoc 补充含入块偏移修正说明
+
+#### 文档更新
+
+- **`docs/autoform.md`** — API 参考表格新增 `initial-values`/`show-submit` 属性、`submit()` 方法；自定义提交按钮示例更新为 slot + `show-submit` 两种模式；JavaScript API 示例新增 `form.submit()`
+- **`docs/api/form/autoform.md`** — Properties 表格新增 `initial-values`/`show-submit`；Methods 表格新增 `submit`；Slots 描述更新为 slot 与 `show-submit` 配合使用
+- **`src/components/form/autoform.ts`** — `@slot` JSDoc 更新，说明 slot 配合 `show-submit` 使用
+- **`src/core/anchored-overlay.ts`** — 类 JSDoc 补充含入块偏移修正说明
+- **`src/components/form/AGENTS.md`** — 新增 autoform 新属性/方法约定、select 事件名、combobox stopPropagation
+- **`src/components/basic/AGENTS.md`** — 新增输入类组件 `stopPropagation` 约定
+- **`src/components/display/AGENTS.md`** — 新增 code-editor `stopPropagation` 约定
+- **`src/components/feedback/AGENTS.md`** — 新增浮层组件统一使用 `aithe-dropdown-change` 事件名
+- **`src/components/data/AGENTS.md`** — 新增 dropdown 事件名 `aithe-dropdown-change`
+- **`src/core/AGENTS.md`** — anchored-overlay 描述补充含入块偏移修正
+
+### 删除
+
+- **`<aithe-autoform>` 的 `hasActionSlot` 状态和 `syncActionSlot` 方法** — 移除 `@queryAssignedElements actionNodes`、`@state hasActionSlot`、`syncActionSlot` 方法，改用 `show-submit` 属性控制
+- **`<aithe-autoform>` 的 `.autoform-actions` CSS** — 移除操作区容器样式
+- **`<aithe-autoform>` 的 `<aithe-divider>`** — 移除表单与操作区之间的分割线

package/docs/issue/issue_26.3.1.4.md

@@ -0,0 +1,113 @@
+# Issue 26.3.1.4
+
+## 版本信息
+
+- **版本号**: 26.3.1.4
+- **基线版本**: 26.3.1
+- **类型**: Feature
+- **日期**: 2026-06-26
+
+## 变更概述
+
+1. **`<aithe-table>` 六项新功能** — 列固定（`fixed`）、列宽拖拽调整（`resizable`）、列拖拽排序（`draggable`）、loading 加载占位、行单选模式（`selectable="single"`）、键盘导航（ArrowDown/ArrowUp/空格/Enter）
+2. **`<aithe-button>` variant 重构** — 废弃 `danger` 属性，统一使用 `variant` 属性控制按钮危险样式
+3. **`<aithe-tag>` 尺寸系统与 variant 重构** — 新增 `size` 属性（sm/md/lg），`type` 标记为 `@deprecated`，推荐使用 `variant`；移除 `min-height` 硬编码
+4. **`<aithe-table-column>` 属性扩展** — 新增 `fixed`、`resizable`、`draggable`、`min-width`、`box` 属性；`cellRenderer` 签名变更为 `(key, value, record)`
+5. **类型系统增强** — 新增 `AitheSelectableType`、`AitheColumnFixed`、`AitheDataRenderer`、`AitheDataProvider` 类型
+6. **`<aithe-box-table>` 导出** — 新增 `box-table` 组件导出，支持卡片式布局模式
+7. **Display 组件系列** — 新增 `mini-box`、`brief-box`、`detail-box`、`profile`、`desc`、`desc-item` 六个 display 组件导出
+8. **API 应用 Demo 页** — 新增 `docs` 页面，11 种语言 i18n 翻译，`demo-data.ts` 增强
+9. **Demo 页面增强** — `data.ts` 新增 7 个 table 示例（固定列、调整宽度、拖拽排序、loading、单选、键盘导航、box-table）；`display.ts` 新增 225 行 display 示例
+10. **SonarQube 代码质量修复** — 修复 `table.ts`、`profile.ts`、`box-table.ts`、`desc.ts` 中的 S3358、S6660、S1128、S7761、S4325、S3776、S1854、S2156 等 15+ 项告警；更新 `CONTRIBUTING.md` 新增 8 条规则
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `AitheTableColumnMeta.render` 签名 | `(value, record, rowIndex)` | `(key, value, record)` — 移除 `rowIndex`，新增 `key` 参数 |
+| `AitheTableColumn.cellRenderer` 签名 | `(value, record, rowIndex)` | `(key, value, record)` — 同上 |
+| `<aithe-button>` `danger` 属性 | 独立 `@property` | 废弃，改用 `variant="danger"` |
+| `<aithe-table>` `selectedKeys` 状态 | `string[]` | `selectionSet: Set<string>` |
+| `<aithe-table>` `aithe-selection-change` 事件载荷 | `{ selectedKeys }` | `{ selectionSet }` |
+| `<aithe-table>` `renderCell` 方法签名 | `(column, record, rowIndex)` | `(column, record)` — 移除 `rowIndex` 参数 |
+
+## 变更内容
+
+### 新增
+
+- **`<aithe-table>` 列固定** — `src/components/data/table.ts` 新增 `fixed` 属性支持，使用 `position: sticky` + `left`/`right` 偏移计算；新增 `_getFixedStyle`、`_calcLeftOffset`、`_calcRightOffset`、`_hasFixedLeft`、`_hasFixedRight` 方法；新增 `.fixed-left-shadow` / `.fixed-right-shadow` CSS 阴影指示器
+- **`<aithe-table>` 列宽拖拽调整** — `src/components/data/table.ts` 新增 `resizable` 属性支持；新增 `_onResizeStart`、`_onResizeMove`、`_onResizeEnd` 方法；document 级别 mousemove/mouseup 监听；新增 `aithe-column-resize` 事件
+- **`<aithe-table>` 列拖拽排序** — `src/components/data/table.ts` 新增 `draggable` 属性支持；新增 `_onThMouseDown`、`_startDrag`、`_onDragMove`、`_onDragEnd`、`_clearDragClasses`、`_findDropTarget`、`_applyColumnReorder` 方法；5px 拖拽阈值；新增 `aithe-column-reorder` 事件
+- **`<aithe-table>` loading 加载占位** — `src/components/data/table.ts` 新增 `loading`、`loadingText` 属性；半透明遮罩层 + 旋转 spinner + shimmer 动画占位行；`loading` 具名插槽支持自定义内容
+- **`<aithe-table>` 行单选模式** — `src/components/data/table.ts` 新增 `selectable="single"` 支持；单选使用 radio input，隐藏全选 checkbox；`selectionSet` 在单选模式下 clear 后 add
+- **`<aithe-table>` 键盘导航** — `src/components/data/table.ts` 新增 `_onKeyDown` 处理器；ArrowDown/ArrowUp 移动焦点行；空格切换选中；Enter 触发行点击；`_scrollRowIntoView` 自动滚动
+- **`<aithe-tag>` 尺寸系统** — `src/components/basic/tag.ts` 新增 `size` 属性（sm/md/lg），对应 `.size-sm` / `.size-md` / `.size-lg` CSS 类；通过垂直 padding 控制高度
+- **`src/index.ts` 导出扩展** — 新增 `box-table`、`mini-box`、`brief-box`、`detail-box`、`profile`、`desc`、`desc-item` 组件导出
+- **`src/core/types.ts` 类型定义** — 新增 `AitheSelectableType`、`AitheColumnFixed`、`AitheDataRenderer`、`AitheDataProvider` 类型
+- **`src/apps/api/pages/docs.ts`** — 新增 API 文档 Demo 页面
+- **`src/apps/api/i18n/`** — 11 种语言新增翻译键
+- **`src/apps/demo/pages/display.ts`** — 新增 225 行 display 组件示例
+- **`src/apps/demo/pages/data.ts`** — 新增 7 个 table 演示示例（固定列、调整宽度、拖拽排序、loading、单选、键盘导航、box-table）
+- **`CONTRIBUTING.md`** — 新增 8 条 SonarQube 规则（S7735、S3358、S6660、S6551、S1128、S7761、S3776、S1854）
+
+### 修改
+
+#### `<aithe-table>` 重构
+
+- **`src/components/data/table.ts`** — 完整重写（1035 行变更），主要变更：
+    - `selectable` 类型扩展为 `AitheSelectableType`，添加自定义 converter 支持 `"single"` 属性值
+    - `selectedKeys: string[]` → `selectionSet: Set<string>`，事件载荷同步变更
+    - `renderCell` 签名移除 `rowIndex` 参数
+    - `renderColumnHeader` 新增 drag handle 和 resize handle 渲染
+    - `render()` 新增 `tabindex="0"`、loading 遮罩层、固定列 CSS 类、`data-column-id` 属性
+    - 提取 `_renderTableBody`、`_renderSelectAllCheckbox`、`_renderSelectionCell`、`_renderLoadingRows` 方法
+    - 新增 `columnOrder` 状态管理拖拽排序后的列顺序
+    - `syncSlotColumns` 同步读取 `fixed`、`resizable`、`draggable`、`minWidth`、`box` 属性
+    - 提取常量：`SELECTION_COL_WIDTH(52)`、`MIN_COL_WIDTH(40)`、`DEFAULT_COL_WIDTH(120)`、`DRAG_THRESHOLD(5)`、`SHADOW_WIDTH(15)`
+    - 新增 `updated` 生命周期，data/sort 变化时重置 `focusedRowIndex`
+
+#### `<aithe-table-column>` 属性扩展
+
+- **`src/components/data/table-column.ts`** — 新增 `fixed`、`resizable`、`draggable`、`min-width`、`box` 属性；`cellRenderer` 类型变更为 `AitheDataRenderer`；移除未使用的 `CellRenderer` 类型别名
+
+#### `<aithe-button>` variant 重构
+
+- **`src/components/basic/button.ts`** — 移除 `danger` 属性；`type` 移除 `'primary'` 枚举值（primary 通过 variant 控制）；CSS 选择器从 `.danger.primary` 改为 `:host([variant='danger']) .primary`；classMap 使用 `this.variant` 替代 `this.danger`
+
+#### `<aithe-tag>` 重构
+
+- **`src/components/basic/tag.ts`** — `type` 属性标记为 `@deprecated`；新增 `size` 属性；CSS 变体选择器从 `.primary` 等 class 改为 `:host([variant='primary']) .tag`；保留 `type` class 向后兼容；移除 `min-height: 30px` 硬编码
+
+#### 类型系统
+
+- **`src/core/types.ts`** — `AitheTableColumnMeta` 新增 `minWidth`、`fixed`、`resizable`、`draggable`、`box` 字段；`render` 签名变更为 `AitheDataRenderer`
+
+#### SonarQube 代码质量修复
+
+- **`src/components/data/table.ts`** — 修复 S2156（箭头函数成员添加 `readonly`）、S7761（`.dataset` 替代 `getAttribute`）、S4325（移除无用断言）、S1854（移除无用赋值）、S6660（合并 else if）、S3358（嵌套三元提取为独立方法）、S3776（认知复杂度拆分：`_onDragEnd`、`render`、`_getFixedStyle` 各拆分为 3 个子方法）
+- **`src/components/data/profile.ts`** — 修复 S3358、S6660、S7735
+- **`src/components/data/box-table.ts`** — 修复 S3358（提取 `_renderBoxSelection` 方法）
+- **`src/components/data/desc.ts`** — 修复 S1128（移除未使用的 `TemplateResult` 导入）
+
+#### Demo 页面
+
+- **`src/apps/demo/pages/data.ts`** — 提取 `TABLE_DATA`、`TABLE_COLUMNS` 公共常量；新增 7 个 table 示例
+- **`src/apps/demo/pages/basic.ts`** — 适配 button/tag 变更
+- **`src/apps/demo/pages/dashboard.ts`** — 适配 button 变更
+- **`src/apps/demo/pages/layout.ts`** — 适配 button 变更
+- **`src/apps/demo/editor.ts`** — 适配 button 变更
+- **`src/apps/demo/i18n/`** — 11 种语言新增 table 相关翻译键
+
+#### 文档更新
+
+- **`docs/api/data/table.md`** — Properties/Events/Column Fields/Examples 全部更新，新增固定列、调整宽度、拖拽排序、loading、单选、键盘导航示例
+- **`docs/api/data/table-column.md`** — Properties 表格新增 `fixed`、`resizable`、`draggable`、`min-width`、`box` 字段
+- **`docs/api/basic/button.md`** — 适配 `variant` 变更
+- **`docs/api/basic/tag.md`** — 适配 `size` 和 `variant` 变更
+- **`docs/api/summary.md`** — 新增 display 组件入口
+
+### 删除
+
+- **`<aithe-button>` `danger` 属性** — `src/components/basic/button.ts` 移除 `@property({ type: Boolean, reflect: true }) danger`
+- **`<aithe-button>` `type` 中的 `'primary'`** — `src/components/basic/button.ts` 移除 `'primary'` 枚举值
+- **`<aithe-tag>` `min-height: 30px`** — `src/components/basic/tag.ts` 移除硬编码高度

package/docs/issue/issue_26.3.1.5.md

@@ -0,0 +1,142 @@
+# Issue 26.3.1.5
+
+## 版本信息
+
+- **版本号**: 26.3.1.5
+- **基线版本**: 26.3.1
+- **类型**: Feature
+- **日期**: 2026-06-30
+
+## 变更概述
+
+1. **`<aithe-tabs>` 组件增强** — 修复 line 模式边框重复、修复 button 模式 icon 前景色、新增 `max-visible-tabs` 溢出折叠、新增 `extra` 具名插槽、溢出菜单改用 `<aithe-select>` 组件、提取 `renderTab` 方法、代码注释全面增强（9 个 CSS Parts、10 个 CSS 自定义属性）
+2. **`<aithe-tab-pane>` 注释增强** — 所有属性扩展为多行双语注释，补充 JSDoc 标签
+3. **`<aithe-table>` 列固定优化** — 选择列 `selection-cell` 改为 `position: sticky` 固定左侧、新增 `has-fixed` 属性控制 `table` 的 `min-width: max-content`、修复斑马纹行固定列背景色
+4. **`<aithe-desc>` 描述列表重构** — 布局算法从 label+content 合并单元格改为独立 grid 列、新增 `content`/`filter` 属性支持过滤器、`label-width` 默认值改为 `150px`、移除 `desc-item` 的 `labelWidth` 属性、边框样式重构
+5. **`<aithe-desc-item>` 属性扩展** — 新增 `content` 和 `filter` 属性，支持直接传入值并应用过滤器
+6. **`<aithe-box-table>` 卡片表格重构** — 移除自建卡片 DOM，改用 `<aithe-brief-box>` 组件渲染卡片、移除 `content` 列插槽、`boxCols=0` 时改为自适应流式布局
+7. **`<aithe-detail-box>` 插槽动态隐藏** — 新增 `_hasContent`/`_hasActions` 状态，空插槽自动 `hidden`，添加 `@slotchange` 监听
+8. **`<aithe-brief-box>` 操作区样式修复** — `brief-actions` 改为 `align-items: stretch`，新增 `::slotted` 样式支持垂直排列
+9. **`<aithe-tag>` 注释增强** — 补充 JSDoc 标签
+10. **Demo 页面增强** — `data.ts` 新增 7 个 tabs 演示示例
+11. **国际化扩展** — 11 种语言新增 `data.tabs.moreTabsAriaLabel` 翻译键
+13. **SonarQube 代码质量修复** — `<aithe-desc>` 提取 `_getItemContent`/`_findNextPosition`/`_markOccupied` 消除 S3358/S3776 告警；`<aithe-desc-item>` 提取 `renderContent` 消除 S3358 告警
+14. **`AitheSelectableType` 类型重构** — 从 `boolean | 'single'` 改为 `'none' | 'multi' | 'single'` 纯字符串枚举，消除混合返回类型告警；`<aithe-table>` 移除自定义 converter；Box 组件族 `selectable` 从 `Boolean` 统一为 `AitheSelectableType`
+
+## 破坏性变更
+
+| 变更项 | 旧值 | 新值 |
+|--------|------|------|
+| `<aithe-desc-item>` `labelWidth` 属性 | 独立 `@property` | 已移除（使用父级 `aithe-desc` 的 `label-width` 统一控制） |
+| `<aithe-desc>` `labelWidth` 默认值 | `''`（空字符串） | `'150px'` |
+| `AitheSelectableType` 类型定义 | `boolean \| 'single'` | `'none' \| 'multi' \| 'single'` — 统一为字符串枚举，默认值 `'none'` |
+| `<aithe-table>` `selectable` 属性默认值 | `false` | `'none'` |
+| `<aithe-mini-box>` / `<aithe-brief-box>` / `<aithe-detail-box>` `selectable` 属性 | `Boolean`（`true`/`false`） | `AitheSelectableType`（`'none'`/`'multi'`/`'single'`） |
+
+## 变更内容
+
+### 新增
+
+#### `<aithe-tabs>` 功能增强
+
+- **`src/components/data/tabs.ts`** — 新增 `maxVisibleTabs` 属性（默认 `0` 不限制），tab 数量超出时自动折叠到溢出下拉菜单；新增 `extra` 具名插槽，使用 `margin-left: auto` 推至右侧；新增 `visiblePanes`/`overflowPanes`/`overflowOptions` 计算属性；溢出菜单使用 `<aithe-select>` 组件；提取 `renderTab` 方法复用渲染逻辑；新增 `handleOverflowChange` 事件处理器；代码注释全面增强（9 个 CSS Parts、10 个 CSS 自定义属性、所有属性多行双语注释）
+
+#### `<aithe-tab-pane>` 注释增强
+
+- **`src/components/data/tab-pane.ts`** — 所有属性扩展为多行双语注释，补充 `@slot`、`@csspart`、`@example` JSDoc 标签
+
+#### `<aithe-desc-item>` 属性扩展
+
+- **`src/components/display/desc-item.ts`** — 新增 `content` 属性（直接传入内容值，优先于 slot 内容）、`filter` 属性（过滤器表达式，通过 `filterFactory.format` 格式化）；移除 `labelWidth` 属性；提取 `renderContent()` 方法消除 S3358 嵌套三元表达式告警
+
+#### `AitheSelectableType` 类型重构
+
+- **`src/core/types.ts`** — `AitheSelectableType` 从 `boolean \| 'single'` 重构为 `'none' \| 'multi' \| 'single'` 纯字符串枚举
+- **`src/components/data/table.ts`** — `selectable` 默认值 `false` → `'none'`；移除自定义 converter；所有 `this.selectable`/`!this.selectable` 改为 `this.selectable !== 'none'`/`this.selectable === 'single'`；`_renderSelectionCell` 中 radio/checkbox 统一使用 `.checked` 属性绑定
+- **`src/components/data/box-table.ts`** — 传递 `selectable` 从 `?selectable=${!!this.selectable}` 改为 `selectable=${this.selectable}`
+- **`src/components/display/mini-box.ts`** — `selectable` 从 `Boolean` 改为 `AitheSelectableType`，统一渲染 checkbox
+
+#### `<aithe-detail-box>` 插槽动态隐藏
+
+- **`src/components/display/detail-box.ts`** — 新增 `_hasContent`/`_hasActions` 状态；`firstUpdated` 初始化检查；`_onSlotChange` 监听 `@slotchange` 动态更新；`content`/`actions` 区域使用 `?hidden` 属性控制显示
+
+#### 国际化
+
+- **`src/styles/i18n/locales/*.ts`** — 11 种语言（zh-CN/zh-TW/zh-HK/en-US/ja-JP/ko-KR/es-ES/pt-BR/fr-FR/de-DE）新增 `data.tabs.moreTabsAriaLabel` 翻译键
+- **`src/apps/demo/i18n/*.ts`** — 11 种语言同步新增 `data.tabs.moreTabsAriaLabel` 翻译键
+
+#### Demo 页面
+
+- **`src/apps/demo/pages/data.ts`** — 新增 7 个 tabs 演示示例（标签类型、带图标、可关闭、可添加、禁用、溢出下拉、额外插槽）
+- **`src/apps/demo/demo-data.ts`** — 更新 tabs 演示代码
+
+### 修改
+
+#### `<aithe-tabs>` 样式修复
+
+- **`src/components/data/tabs.ts`**：
+    - line 模式下 `.nav` 去掉 `border-bottom` 和 `padding-bottom`，`.tabs.line` 去掉 `gap`，修复边框重复问题
+    - button 模式下 `.tab.active.button .tab-icon` 设置 `color: var(--aithe-color-text-on-primary)`，修复 icon 前景色对比度问题
+    - `splitPanes` 逻辑重构：始终显示前 `max - 1` 个 tab，第 `max` 个位置留给溢出 select，激活 tab 切换时可见 tab 数量固定不变
+    - `syncPanes` 方法末尾多余空格修复（`) ;` → `);`）
+    - 导入规范修复：`import type { AitheTabPane }` 从相对路径 `'./tab-pane'` 改为路径别名 `'@components/data/tab-pane'`
+
+#### `<aithe-table>` 列固定优化
+
+- **`src/components/data/table.ts`**：
+    - 新增 `:host([has-fixed]) table { min-width: max-content }` 样式，防止固定列时表格宽度不足
+    - 选择列 `selection-cell` 新增 `position: sticky; left: 0; z-index: 3`，表头选择列 `z-index: 5`
+    - `render` 方法中新增 `this.toggleAttribute('has-fixed', ...)` 逻辑
+    - 新增斑马纹行固定列背景色样式：`tbody tr.striped:nth-child(even) td.fixed-left/fixed-right/selection-cell`
+    - `_getColumnWidth` 方法注释修正
+
+#### `<aithe-desc>` 描述列表重构
+
+- **`src/components/display/desc.ts`**：
+    - 布局算法重构：从 label+content 合并单元格改为独立 grid 列，水平模式下 `grid-template-columns` 为 `repeat(N, labelWidth 1fr)`
+    - `label-width` 默认值从 `''` 改为 `'150px'`
+    - 边框样式重构：`desc-cell-label`/`desc-cell-content` 各自独立控制边框，新增 `is-bordered`/`no-border` CSS 类
+    - 新增 `classMap` 导入和 `labelClasses`/`contentClasses` 动态类计算
+    - `_layoutCells` 方法适配独立 grid 列布局：水平模式 `gridCols = column * 2`；提取 `_findNextPosition` 和 `_markOccupied` 方法消除 S3776 认知复杂度告警
+    - 渲染逻辑拆分：vertical 模式保持合并单元格，horizontal 模式 label 和 content 独立 grid 定位
+    - 支持 `desc-item` 的 `content`/`filter` 属性渲染；提取 `_getItemContent` 方法消除 S3358 嵌套三元表达式告警
+    - 移除 `desc-item` 的 `labelWidth` 引用
+
+#### `<aithe-box-table>` 卡片表格重构
+
+- **`src/components/data/box-table.ts`**：
+    - 移除自建卡片 DOM（`.box-card`/`.box-card-header`/`.box-card-check`/`.box-card-name`/`.box-card-status`/`.box-card-tags`/`.box-card-content`/`.box-card-actions` 等全部 CSS 和 HTML），改用 `<aithe-brief-box>` 组件渲染卡片
+    - 移除 `content` 列插槽处理逻辑
+    - 移除 `toggleBoxSelection`/`_renderRadioInput`/`_renderCheckboxInput`/`_renderBoxSelection` 方法
+    - 新增 `handleBriefBoxSelect` 方法，监听 `<aithe-brief-box>` 的 `selected-change` 事件
+    - `renderBoxCard` 方法改为通过 slot 传递 name/status/tags/actions 到 `<aithe-brief-box>`
+    - `renderBoxGrid` 方法：`boxCols=0` 时改为自适应流式布局（所有行在一个 grid-row 中），移除 `colWidth` 计算变量
+    - 移除 `content` 列在 `boxColumns` 中的 case 处理
+
+#### `<aithe-brief-box>` 操作区样式修复
+
+- **`src/components/display/brief-box.ts`** — `brief-actions` 从 `align-items: center; justify-content: center` 改为 `align-items: stretch`；新增 `::slotted(*)` 样式支持垂直排列
+
+#### `<aithe-tag>` 注释增强
+
+- **`src/components/basic/tag.ts`** — 补充 JSDoc 标签
+
+#### `<aithe-autoform>` 代码规范
+
+- **`src/components/form/autoform.ts`** — 三元表达式格式化调整
+
+#### Demo 页面
+
+- **`src/apps/demo/pages/display.ts`** — 适配 desc/box-table 变更
+
+#### 文档更新
+
+- **`docs/api/data/tabs.md`** — 新增 `extra` 插槽说明、`maxVisibleTabs` 属性说明、CSS 自定义属性表、CSS Parts 表、溢出下拉示例代码
+- **`docs/api/data/table.md`** — 同步更新
+
+### 删除
+
+- **`<aithe-desc-item>` `labelWidth` 属性** — `src/components/display/desc-item.ts` 移除 `@property({ type: String }) labelWidth`
+- **`<aithe-box-table>` 自建卡片 DOM** — `src/components/data/box-table.ts` 移除 `.box-card` 相关全部 CSS 和 HTML 模板
+- **`<aithe-box-table>` 选中相关方法** — 移除 `toggleBoxSelection`/`_renderRadioInput`/`_renderCheckboxInput`/`_renderBoxSelection` 方法
+- **`<aithe-box-table>` `content` 列插槽** — 移除 `content` 列在 `boxColumns` 中的 case 处理和相关变量