@aithe/aithe-ui 26.2.3 → 26.3.1

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 处理和相关变量

package/docs/issue/issue_26.3.1.6.md

@@ -0,0 +1,100 @@
+# Issue 26.3.1.6
+
+## 版本信息
+
+- **版本号**: 26.3.1.6
+- **基线版本**: 26.3.1
+- **类型**: Quality / Bug Fix
+- **日期**: 2026-07-02
+
+## 变更概述
+
+1. **CSS 自定义属性统一** — 将组件中使用的 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`）
+2. **CSS 变量新增** — `global.css.ts` 新增 `--aithe-font-size-base`/`--aithe-font-size-3xl`/`--aithe-font-size-4xl`/`--aithe-font-size-5xl` 字体尺寸变量
+3. **主题系统增强** — 所有 24 个主题统一新增 `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb` 8 个 CSS 变量
+4. **`<aithe-desc>` 样式重构** — 移除 `desc-cell-label` 的 `padding`，改用 flex 居中；移除 `desc-item` 的 `padding`；`desc-cell-content` 的 `background` 移除回退值
+5. **`<aithe-mini-box>` 样式修复** — hover 背景色移除嵌套的 `--aithe-color-bg-hover` 回退
+6. **`<aithe-autoform-item>` 颜色修正** — `box-shadow` 中的 `--aithe-primary-6-rgb` 回退值从 `59, 130, 246` 改为 `77, 141, 255`
+7. **`<aithe-sidebar>` 导入增强** — 新增 `browserEnv` 导入
+8. **`<aithe-element>` JSDoc 更新** — 类注释补充浏览器环境检测说明
+9. **`AitheUI` 类增强** — 新增 `_ua` 私有字段和 10 个浏览器环境检测 getter（`isMobile`/`isAndroid`/`isIOS`/`isChrome`/`isEdge`/`isWechat`/`isWindows`/`isMacOS`/`isRealMobile`/`isChromeEmulator`/`supportsTouch`）
+
+## 破坏性变更
+
+无。
+
+## 变更内容
+
+### 新增
+
+#### 字体尺寸变量
+
+- **`src/styles/global.css.ts`** — 新增 `--aithe-font-size-base: 14px`、`--aithe-font-size-3xl: 32px`、`--aithe-font-size-4xl: 48px`、`--aithe-font-size-5xl: 64px` CSS 自定义属性
+
+#### 主题 CSS 变量统一
+
+- **`src/styles/theme/*.ts`（24 个主题）** — 每个主题统一新增 8 个 CSS 变量：
+  - `--aithe-fill-1` / `--aithe-fill-2`：填充色（浅色主题 `#f7f8fa`/`#f0f1f3`，深色主题 `#1a2133`/`#1e263a`）
+  - `--aithe-color-surface-hover`：表面悬停色（浅色 `rgba(0,0,0,0.04)`，深色 `rgba(255,255,255,0.04)`）
+  - `--aithe-color-text-secondary`：次要文本色（浅色 `#3d4a66`，深色 `#8894ab`）
+  - `--aithe-color-bg-muted`：背景静默色（浅色 `#e8ecf4`，深色 `#151c2b`）
+  - `--aithe-color-bg-hover`：背景悬停色（浅色 `rgba(0,0,0,0.04)`，深色 `rgba(255,255,255,0.04)`）
+  - `--aithe-color-border-subtle`：边框弱色（浅色 `rgba(76,94,132,0.10)`，深色 `rgba(172,188,217,0.08)`）
+  - `--aithe-primary-6-rgb`：主色 RGB 值（浅色 `77,141,255`，深色 `74,125,255`）
+
+#### `AitheUI` 浏览器环境检测
+
+- **`src/styles/aithe-ui.ts`** — 新增 `_ua` 私有字段（构造时缓存 `navigator.userAgent`）；新增 10 个 getter：
+  - `isMobile` — Android/iOS/WebOS/Blackberry
+  - `isAndroid` — Android
+  - `isIOS` — iPhone/iPad/iPod
+  - `isChrome` — Chrome（非 Edge）
+  - `isEdge` — Edge
+  - `isWechat` — 微信内置浏览器
+  - `isWindows` — Windows
+  - `isMacOS` — macOS
+  - `isRealMobile` — 真实移动设备（UA + 触摸 + 小屏幕 + 非桌面 OS）
+  - `isChromeEmulator` — Chrome DevTools 设备模拟
+  - `supportsTouch` — 触摸事件支持
+
+#### `<aithe-sidebar>` 导入
+
+- **`src/components/framework/sidebar.ts`** — 新增 `import { browserEnv } from '@utils'`
+
+### 修改
+
+#### CSS 自定义属性重命名
+
+- **`src/components/data/tree-menu.ts`** — `--aithe-duration-normal` → `--aithe-duration-base`
+- **`src/components/display/code-editor.ts`** — `--aithe-container-radius` → `--aithe-container-radius-md`
+- **`src/components/display/desc.ts`** — `--aithe-border-radius-md` → `--aithe-radius-md`（2 处）
+- **`src/components/display/markdown-editor.ts`** — `--aithe-container-radius` → `--aithe-container-radius-md`
+- **`src/components/display/markdown.ts`** — `--aithe-container-radius` → `--aithe-container-radius-md`
+- **`src/components/framework/dashboard-panel.ts`** — `--aithe-duration-normal` → `--aithe-duration-base`
+- **`src/components/framework/dashboard.ts`** — `--aithe-duration-normal` → `--aithe-duration-slow`（4 处面板过渡）、`--aithe-duration-normal` → `--aithe-duration-base`（4 处面板定位过渡）
+- **`src/components/framework/log-panel.ts`** — `--aithe-font-mono` → `--aithe-font-family-mono`
+- **`src/components/framework/sidebar.ts`** — `--aithe-duration-normal` → `--aithe-duration-base`
+
+#### `<aithe-desc>` 样式重构
+
+- **`src/components/display/desc.ts`** — `.desc-cell-label` 移除 `padding`，新增 `display: flex; align-items: center` 实现居中；`.desc-cell-content.is-bordered:hover` 的 `background` 移除 `#e8e9ed` 回退值
+
+#### `<aithe-desc-item>` 样式清理
+
+- **`src/components/display/desc-item.ts`** — `.item-label` 移除 `padding: var(--aithe-space-2, 8px) var(--aithe-space-3, 12px)`
+
+#### `<aithe-mini-box>` 样式修复
+
+- **`src/components/display/mini-box.ts`** — hover 背景色从 `var(--aithe-color-surface-hover, var(--aithe-color-bg-hover, rgba(0,0,0,0.02)))` 简化为 `var(--aithe-color-surface-hover, rgba(0,0,0,0.02))`
+
+#### `<aithe-autoform-item>` 颜色修正
+
+- **`src/components/form/autoform-item.ts`** — `box-shadow` 中 `--aithe-primary-6-rgb` 回退值从 `59, 130, 246` 修正为 `77, 141, 255`
+
+#### `<aithe-element>` JSDoc 更新
+
+- **`src/core/aithe-element.ts`** — 类注释补充"浏览器环境检测"说明
+
+### 删除
+
+无。

package/docs/issue/issue_26.3.1.7.md

@@ -0,0 +1,78 @@
+# Issue 26.3.1.7
+
+## 版本信息
+
+- **版本号**: 26.3.1.7
+- **基线版本**: 26.3.1
+- **类型**: Quality / Bug Fix
+- **日期**: 2026-08-06
+
+## 变更概述
+
+1. **DataHub 错误处理增强** — HTTP 非 2xx 错误响应优先用 APIStyle 解析响应体，提取业务错误信息（code/message），避免丢失后端返回的友好错误描述；`DataHubError` 新增 `data` 字段携带原始响应体
+2. **K8s APIStyle 错误响应支持** — `k8sStyle.onResponse` 新增对 K8s `Status` 对象（`{kind:"Status", status:"Failure", message, reason, code}`）的识别，正确解析非 2xx 错误响应的 `reason`/`message`
+3. **DataHub 导入路径规范化** — datahub 模块内 5 个文件的 `../` 跨目录相对路径导入统一改为 `@core/datahub/*` 别名导入，符合 `src/core/AGENTS.md` 规范
+4. **Filter 测试导入路径规范化** — `filter/__tests__/index.test.ts` 的相对路径导入改为 `@core/filter/*` 别名导入
+5. **SSR 环境适配** — `<aithe-log-panel>`、`<aithe-affix>`、`<aithe-back-top>`、`<aithe-theme-switch>` 4 个组件的 `window` 引用改为 `globalThis`，兼容非浏览器环境
+6. **API 文档补充** — 新增 `<aithe-log-panel>`、`<aithe-desc-item>`、`<aithe-autoform-item>` 3 个组件的 API 文档；更新 `summary.md` 索引
+
+## 破坏性变更
+
+无。
+
+## 变更内容
+
+### 新增
+
+#### API 文档
+
+- **`docs/api/framework/log-panel.md`** — 新增 `<aithe-log-panel>` 组件 API 文档
+- **`docs/api/display/desc-item.md`** — 新增 `<aithe-desc-item>` 组件 API 文档
+- **`docs/api/form/autoform-item.md`** — 新增 `<aithe-autoform-item>` 组件 API 文档
+
+#### DataHub 类型字段
+
+- **`src/core/datahub/types.ts`** — `DataHubErrorDetail` 接口新增 `data?: unknown` 字段（原始响应体）；`DataHubError` 类新增 `data?: unknown` 只读属性，构造函数同步赋值
+
+### 修改
+
+#### DataHub 错误处理增强
+
+- **`src/core/datahub/core/datahub-core.ts`** — HTTP 非 2xx 错误处理逻辑优化：`!res.ok` 时优先调用 `requestStyle.onResponse` 解析响应体，提取业务 `code`/`message` 后抛出 `DataHubError`；无 APIStyle 时回退到 `createTransportError`。复用 `:217` 已计算的 `requestStyle`，消除 `resolveRequestStyle` 重复调用
+- **`src/core/datahub/core/datahub-core.ts`** — `createTransportError` 方法补充 `data: res.data`，与错误路径保持一致
+- **`src/core/datahub/core/api-styles.ts`** — `k8sStyle.onResponse` 新增 K8s `Status` 错误对象识别：当 `!res.ok && typeof obj.status === 'string'` 时，返回 `{code: obj.reason ?? obj.status, message: obj.message, data: rawData}`，精确区分错误响应（顶层 `status` 为字符串）与正常响应（`status` 为对象）
+
+#### DataHub 导入路径规范化
+
+- **`src/core/datahub/core/adapter/fetch-adapter.ts`** — `../../types` → `@core/datahub/types`
+- **`src/core/datahub/core/adapter/mock-adapter.ts`** — `../../types` → `@core/datahub/types`
+- **`src/core/datahub/core/api-styles.ts`** — `../types` → `@core/datahub/types`
+- **`src/core/datahub/core/datahub-core.ts`** — `../types`、`../config/strategy`、`../utils/*` → `@core/datahub/types`、`@core/datahub/config/strategy`、`@core/datahub/utils/*`（同目录的 `./api-styles`、`./adapter/*` 保持不变）
+- **`src/core/datahub/config/strategy.ts`** — `../types`、`../utils/is-query` → `@core/datahub/types`、`@core/datahub/utils/is-query`
+- **`src/core/datahub/utils/idempotent.ts`** — `../types` → `@core/datahub/types`（同目录的 `./common` 保持不变）
+
+#### Filter 测试导入路径规范化
+
+- **`src/core/filter/__tests__/index.test.ts`** — `../types`、`../builtins`、`../factory`、`../index` → `@core/filter/types`、`@core/filter/builtins`、`@core/filter/factory`、`@core/filter/index`
+
+#### SSR 环境适配
+
+- **`src/components/framework/log-panel.ts`** — `window.innerHeight` → `globalThis.innerHeight`
+- **`src/components/layout/affix.ts`** — `window.addEventListener/removeEventListener('resize'/'scroll')` → `globalThis.addEventListener/removeEventListener`
+- **`src/components/navigation/back-top.ts`** — `window.scrollY`、`window.scrollTo` → `globalThis.scrollY`、`globalThis.scrollTo`
+- **`src/components/theme/theme-switch.ts`** — `window.addEventListener/removeEventListener('resize'/'scroll')` → `globalThis.addEventListener/removeEventListener`
+
+#### API 文档更新
+
+- **`docs/api/summary.md`** — 索引表新增 `<aithe-log-panel>` 行；表格列宽对齐调整
+- **`docs/api/basic/tag.md`** — 文档内容更新
+- **`docs/api/data/table.md`** — 文档内容更新
+- **`docs/api/data/table-column.md`** — 文档内容更新
+- **`docs/api/feedback/popover.md`** — 文档内容更新
+- **`docs/api/feedback/tooltip.md`** — 文档内容更新
+- **`docs/api/form/select.md`** — 文档内容更新
+- **`docs/quickstart.md`** — 文档内容更新
+
+### 删除
+
+无。

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 组件库，提供 100+ 个可复用 UI 组件、25 种内置主题、8 种形状风格、9 种阴影风格、4 种排版风格和完整的国际化支持。
 
 ## 安装
 
@@ -19,8 +19,8 @@ import '@aithe/aithe-ui';
 
 仅此一行即可使用所有组件——`import '@aithe/aithe-ui'` 会自动完成：
 
-- 注册全部 83 个 Custom Elements
-- 注入 22 种主题的 CSS 变量
+- 注册全部 100 个 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) — 全部 100 个组件的详细 API 文档