tt-design-web-vue 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.1.8
+- **`TtAiToolCall` / `TtAiExecutionFeed` 的行名称改用次级文字档（可见变化）**：行标题此前取正文档（与页面正文同色），过程区一列步骤读起来和正文一样重；现改取次级档，与行首图标同色，行内形成「名称 > 摘要」的两档层次（摘要仍为更浅一档）。
+- **`TtAiToolCall` 新增 `streamingSummary`**：为真且行处于进行中时，摘要右侧渐隐，表达「这段文字还在往后写」。只应由**逐字增长**的摘要使用（例如思考内容），参数一类的定稿摘要不要开启。渐隐带宽度可用 `--tt-ai-tool-call-summary-fade` 调整。
+- **`TtAiToolCall` 新增 `disclosureOnly`**：仅需折叠开关的步骤组头，即使没有输入、输出或明细插槽，也能呈现可展开的行；展开时不再插入空明细盒，组头与后续内容之间不会多出一段留白。这类行读屏不会读到指向不存在明细元素的 `aria-controls`（展开状态由 `aria-expanded` 表达）。
+
+## 0.1.7
+- **`TtTable` 打开合计行（`show-summary`）时，页脚不再比数据行高出半截**：Element Plus 只给页脚设了背景与文字色，高度、内边距一概没给，于是合计行落到默认的 8px 上下内边距 —— 比数据行高出一截，也和表头对不齐。现补齐页脚的行高（与数据行同档）、底色（与表头同档）与字重（加粗一档），并新增 `--tt-table-footer-height` / `--tt-table-footer-bg` / `--tt-table-footer-font-weight` 三条变量，宿主可按密度档改写。底色默认值与改动前相同（此前就解析到同一档灰），**未使用合计行的表格零变化**。
+- **卡片与容器的外边界改用更深一档灰色（可见变化）**：信息块与卡片的 1px 外框此前用最浅一档灰，与所在页面底色几乎同色、边框读不出来；现统一改深一档，`TtCard`（含所有用卡片的页面）、`TtQueryForm`、`TtFilePreview`、`TtAttachmentList`、`TtActivityFeed`、`TtImage`、`TtCalendar`、`TtSplitter`（含折叠钮）、`TtAiToolCall` 的输入输出卡、`TtAiResultPanel`、`TtAiInteractionCard` 一并生效。分隔线、表格行线、`TtDivider`、`TtSteps` 连接线、禁用态边框等**非外边界**语义未改。
+  - **连带影响**：`TtCard` 的卡脚分割线与卡片边界同色（原设计如此），随外边界一起变深。
+- **破坏性变更：`TtAiExecutionFeed` 折叠行与过程行对齐（升级前必读）**：折叠行成为过程区的「第 0 行」，与过程行样式逐项一致 —— 行高 32px → 24px、行首固定显示状态标记、标题改用行标签字号、展开箭头移到时长之后；组件不再内置「执行过程」文案。三项需要调用方配合：
+  - CSS 变量 `--tt-ai-execution-feed-row-gap` 已移除，改用 `--tt-ai-execution-feed-leading-gap` / `-sep-gap` / `-leading-size` / `-sep-size` 四条；赋过旧变量需一并替换。
+  - `statusLabel` 由可见的行尾标签改为**视觉隐藏文本**（仍传同一 prop，但不再可见）；需要可见状态文案请改走 `title`。
+  - `title` 不再有默认值；`summary` 改为承载时长（如 `13s`）。
+- **`TtAiInteractionCard` 新增向导形态与动作分列**：新增 `variant: 'card' | 'wizard'`（默认 `card`，默认形态零回归）。`wizard` 是分步问答的一整盒形态 —— 顶行为问题标题与右侧工具位、正文复用既有事由／候选／输入区、底行动作分列；该形态下 `icon`、`status`、`statusLabel`、`summary`、`collapsible`、`expanded` 均不生效。`AiInteractionAction` 新增 `align: 'start' | 'end'`（默认 `'start'`）。
+- **`TtAiInteractionCard` 新增卡面、密度与候选排布控制**：新增 `--tt-ai-interaction-card-surface`（卡面）、`--tt-ai-interaction-card-body-padding` / `-body-gap` / `-row-padding`（密度）、`-option-height`（候选行高）共五条变量，换卡面或收紧密度不必再写覆盖样式（默认值与改动前一致）；新增 `optionsLayout: 'inline' | 'stacked'`（默认 `inline`），`stacked` 纵向单列，便于候选项带描述或文案较长时阅读。
+  - **修复**：带描述的候选项此前被固定行高与不换行挤到溢出、长文案不换行，现按内容自适应；标题区多个动作此前紧贴成一串或被长标题压住，现正常分隔并在窄卡片下换行。
+- **破坏性变更：`element-plus` 最低支持版本提高到 `2.14.1`（升级前必读）**：peer 依赖下限由 `^2.9.10` 改为 `^2.14.1`（`vue` 保持 `^3.5.14`）。宿主 element-plus 低于 `2.14.1` 时需一并升级，否则安装会收到 peer 警告。此前声明的下限低于实际能力——本库的类型声明依赖 `2.14.1` 起才具备的 Element Plus 类型形态（`TableProps` 的默认泛型实参、`SelectProps` 的类型导出），在更低版本宿主上 `TtTable` / `TtSelect` 的类型约束会静默失效（开了 `skipLibCheck` 时不报错，只是不再校验 `stripe`、`multiple` 等 prop）。
+- **修复 `TtCard` metric 指标卡图标背景**：图标容器原本使用品牌渐变、两层径向高光和 20px 圆角，与设计系统的渐变/光晕禁用项及 4/8/12px 圆角阶梯不一致。现收敛为 `--tt-color-primary-1` 浅主色表面、`--tt-color-primary` 图标色与 `--tt-radius-lg`（8px）；指标卡基础承载背景保持原有 `--tt-bg-light`。
+- **测试**：`tests/components/card.spec.ts` 新增图标表面合同，锁定浅主色背景、主色图标与标准圆角，并禁止渐变及高光回归。
+- **修复 `TtAiFoldText` 展开明细的字号与颜色**：展开后的明细此前只固定了字重，字号行高与颜色都随宿主正文（宿主体内为 14/22 + 正文色），同一段明细因此显示得比正文更重更大——「模型思考」展开后与助手回复正文肉眼难分，明细长达数十行时尤其明显。现固定为 12/18 + 次级色（与该组件已有的截断提示同档），所有消费方（思考、重试、上下文压缩）一次性生效，宿主不必再各自写覆盖样式。
+
 ## 0.1.6
 - **组件清单去手工行号（删除 131 处行号字段）**：`docs/component-manifest.json` 里「某某在第几行」这类字段全部删除——`sources.react.componentImportLines` / `componentExportLines` / `runtimeAliasLines`（该子对象随之删除）、`sources.vue.runtimeExportLines` / `typeOnlyExportLines`、`vueOnly.defaultExtensions[].line` × 92、`vueOnly.namedCompositeOrSubcomponentExports[].line` × 25、`mappings.aliasCandidates[].reactLine` / `vueLine`、`mappings.missing[].reactLine`、`mappings.nonEquivalent[].reactLine` / `vueLine`、`reactNonComponentRuntimeExports[].declarationLine` / `exportLine`。删掉的理由是这些字段**没有任何消费者**：全仓唯一下游 `tests/components/ai-message-flow.spec.ts` 只读 `vueOnly.defaultExtensions[].name` 做存在性断言，从不校验行号 / 计数 / 类型行；同时包内 `files` 不含 `src/`，行号对使用方本就不可解析。而它们又能由 `src/index.ts` 完全推导、却长期靠手写转录——实测回溯 8 个历史提交，**同一提交内的 manifest 从未与源码一致过**（`vueOnly` 行号 10/20 错、具名子组件行号 25/25 全错、30 条类型导出行仅 7 条有效且漏登 34 条）。删掉载体后漂移不再可能发生，故**不引入生成器、不新增校验**（不为无人消费的字段维护 CI 机制）。同步去掉 `docs/component-compatibility.md`「基线来源」中的行号区间（`index.js:80-154`、`index.ts:1-109`）。`summary.reactBaselineComponentCount` 含 "Baseline" 但属计数而非行号，已保留。
 - **组件清单计数与条目按口径补正**：`summary.vueRuntimeComponentExportCount` 190 → **193**、`vueNamedRuntimeExports` 26 → **29**。口径统一为「默认再导出 + 具名子组件」：`vueDefaultReexports` **164**（= 92 个直接 `default as Tt*` + 72 个图标桶 `export *`，未变）+ 29 个 `X as TtY` 形态的具名子组件。此前那个 26 是**只随 `vueDefaultReexports` 同步递增、从未重算过**的常量（历次 changelog 中两者差值恒为 26 可证）。`vueOnly.namedCompositeOrSubcomponentExports` 补齐漏登的 4 条并按源码顺序重排（25 → 29）：`TtRow` / `TtMenuPanelItem` / `TtSpaceCompact` / `TtCheckableTag`——`TtCol` 早已登记而配对的 `TtRow` 漏登，是本表不自洽的直接证据。`docs/component-compatibility.md` 统计表同步：Vue 运行时组件/子组件导出 132 → **193**、Vue-only 默认扩展 36 → **92**、Vue-only 命名复合/子组件 24 → **29**，并补齐其命名复合清单块为 29 项。改后 md 与 manifest 的统计行、`exactNameComponents`（70）、`defaultExtensions`（92）、命名复合块（29，顺序一致）逐项复核通过。

package/README.md

@@ -2,7 +2,7 @@
 
 基于 Vue 3 与 Element Plus 的 TT Design 风格组件库。
 
-> 当前版本为 `0.1.6`（下一次发布的版本号，发布即 `npm publish`，不再改版本）。registry 上的最新已发布版本可用 `npm view tt-design-web-vue dist-tags` 查询。本项目从原 workspace 的 `tt-design-vue` 迁出，作为独立项目构建并提供真实的 JavaScript、类型声明和 CSS 产物。
+> 当前版本为 `0.1.8`（下一次发布的版本号，发布即 `npm publish`，不再改版本）。registry 上的最新已发布版本可用 `npm view tt-design-web-vue dist-tags` 查询。本项目从原 workspace 的 `tt-design-vue` 迁出，作为独立项目构建并提供真实的 JavaScript、类型声明和 CSS 产物。
 
 ## 安装
 
@@ -77,11 +77,11 @@ import 'tt-design-web-vue/dist/style.css';
 --tt-color-geek-blue-1 … 7  →  --tt-color-primary-1 … 7  →  --el-color-primary
 ```
 
-换主题色只需覆盖对应色板变量，TT 组件与 Element Plus 桥接变量会一起跟随。全量色板（14 个色系 × 10 阶）、深色主题的推导规则和覆盖示例见 [主题说明](./docs/theme.md)。
+换主题色只需覆盖对应色板变量，TT 组件与 Element Plus 桥接变量会一起跟随。全量色板（14 个色系 × 10 阶）、深色主题的推导规则和覆盖示例见 [主题说明](./docs/guide/theme.md)。
 
 ## 兼容范围
 
-首发版本保留迁出源中全部根入口导出，包括基础组件与既有组合组件，例如 `TtActivityFeed`、`TtQueryForm`、`TtEChartsWrapper` 和 `TtUserDisplay`。所有组件导出均使用 `Tt` 前缀，与 Element Plus 的组件名称区分；与 React 基线的对应状态将记录在 [组件兼容清单](./docs/component-compatibility.md)。
+首发版本保留迁出源中全部根入口导出，包括基础组件与既有组合组件，例如 `TtActivityFeed`、`TtQueryForm`、`TtEChartsWrapper` 和 `TtUserDisplay`。所有组件导出均使用 `Tt` 前缀，与 Element Plus 的组件名称区分；与 React 基线的对应状态将记录在 [组件兼容清单](./docs/guide/component-compatibility.md)。
 
 ## 本地开发
 
@@ -109,7 +109,7 @@ yarn test:package
 /Users/meng/Documents/productcode/platform/apps/frontend/web/packages/tt-design-vue
 ```
 
-本项目不会删除、移动或修改该路径，也不会在本次迁出中切换任何旧 workspace 消费者。详情见 [迁出说明](./docs/migration-from-workspace.md)。
+本项目不会删除、移动或修改该路径，也不会在本次迁出中切换任何旧 workspace 消费者。
 
 ## 发布