tt-design-web-vue 0.1.9 → 0.1.11

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.1.11
+- **`TtMenuPanelItem` 新增 `danger`：危险项回到菜单行承载（可见变化）**：删除、移除这类命令此前没有任何库能力可用——菜单行没有危险态，宿主只能把危险项换成 `TtButton type="danger" text` 单独成行。而按钮与菜单行不是一套几何：文字按钮按行内文字解析（不承载控件高、无内边距、内容居中），菜单行是 32px 档的行盒、网格左对齐。危险项因此比相邻菜单行矮一截、文字还向右漂，宿主只能各自补 `width` / `justify-content` 才勉强对齐，实际收编不全。现在危险项就是**同一条菜单行**，加 `danger` 后只换语义色：常态危险色文字、悬停与键盘聚焦换浅危险底，行高、内边距、网格列与左对齐一概不变，也不会出现「悬停时底色变成品牌蓝」的语义串味。宿主用法：`<TtMenuPanelItem danger>删除</TtMenuPanelItem>`；原先替换成 `TtButton` 的位置连同其对齐补丁可一并删除。
+  - `danger` 与 `disabled` 可组合，禁用态照常落灰；`danger` 不影响 `selected`、`layout`、`size`、`iconSurface` 等既有属性。
+  - 取值沿用库内既有危险语义来源（`--tt-color-error` / `--tt-color-error-soft`），与 `TtButton type="danger"`、`TtFloatButton` 同源，未新增 token。
+- **`TtAiToolCall` 展开后行首箭头改为朝上（可见变化）**：过程行展开时行首那枚箭头此前仍朝下，与收起态悬停时浮现的预览箭头**指向完全相同** —— 展开后看不出「这一行已经展开了」。现展开态箭头朝上、收起与悬停仍朝下，与库内其它折叠体（`TtAiExecutionFeed`、`TtAiInteractionCard`、`TtAiTodoProgress`）「收起朝下、展开朝上」的语义一致。箭头仍位于行首，行尾没有箭头。
+- **新增 `TtMediaCarousel` 媒体混排轮播（图片 / 视频 / 音频）**：此前一条媒体清单里混着图片、视频与音频时，宿主只能自己在轮播内做类型判断，视频与音频也没有库内载体。现在调用方只提供清单（`src` / `kind` / `alt` / `name`），由组件按类型分派渲染：图片在轮播内**等比完整显示、不裁切**，点击可打开支持缩放、旋转、拖拽与下载的大图覆盖层；视频与音频直接用播放器承载，可左右切换与前后翻看。
+  - **切换项时自动暂停**离场项里的视频与音频，不会再出现「切到下一项，上一项的声音还在响」。
+  - `name` 只写显示名、不带扩展名也能正常打开覆盖层：组件按媒体类型补默认扩展名（`blob:` 地址本身不带扩展名，此前这类地址在覆盖层里只能显示成一张「文件卡片」）。
+  - 清单为空数组时组件整块不渲染；轮播下方可给一句说明文字（次要文字色、12/18）。
+  - 组件**不发任何网络请求**，地址完全由调用方传入。
+
+## 0.1.10
+- **`TtIconArrowUpFill16` 恢复可见（`0.1.9` 引入的缺陷）**：该字形入库时 10 条直线命令被误写成三次贝塞尔 `C`（`C` 需 6 个参数，实际只给 2 个），按 SVG 规范解析器会**丢弃该命令起的全部后续路径**，箭头只画出一小块碎屑 —— 在 16px 尺寸下完全看不见。调用方（如 TongClaw 输入区的发送按钮）表现为按钮图标整体消失。现恢复为 `L`，图形与最初取自 TongClaw 的原始素材逐字一致。
+  - 同批入库的另两个自绘字形（`TtIconSidebarOutline24`、`TtIconCubeFill16`）不受影响；全库 65 个含路径的图标已逐一核验，仅此一处。
+- **AI 执行过程区不再给截断气泡（可见变化）**：`TtAiToolCall`（过程行）与 `TtAiExecutionFeed`（折叠行）的标题位、摘要位**不挂气泡**，也**不用原生 `title`**。这一区的「看全部」由**展开**承担 —— 可展开行展开本行、折叠行展开本区，悬停气泡与展开是同一件事的两条通道；摘要位（模型思考首行预览、工具参数、时长）在流式期间还会逐字增长，气泡内容会持续跳动。故上一版本那份气泡覆盖清单**不含**这两个组件：`TtAiInteractionCard`、`TtAiArtifactRow`、`TtAiStatusCode`、`TtAiSubagentLineage`、`TtAiTodoProgress`、`TtDialog`、`TtMenuPanelItem`、`TtTransfer`、`TtUserDisplay`、`TtUpload`、`TtFilePreview`、`TtColorPicker` 的截断气泡全部保留。该口径是 TongClaw 设计系统登记在案的例外（`standards/ai-message-flow/spec.md` §8 规则 10、`standards/tooltip/spec.md` 第 9 条）。
+  - **已知代价**：附件行这类**不可展开**的过程行，长文件名从此没有查看全名的入口。若日后确有需要，按新增交互另行评审，不要直接恢复气泡。
+- **测试**：`tests/components/tt-icons.spec.ts` 由 14 例扩到 **15 例**，新增「每条路径命令的参数个数都是其元数的整数倍」。此前该族只校验「坐标是否越出画布」，而参数不足的命令会被解析器静默跳过、剩余坐标仍在画布内，故越界检查对这类损坏完全无感（`0.1.9` 的箭头缺陷即由此漏过）。新断言对**生成物与入库源两处**同时生效：生成器 `--check` 并未接入测试，只查生成物则源头损坏无人发现。
+
 ## 0.1.9
 - **`TtMenu` 折叠态的菜单图标回到行中心**：折叠态此前会把图标推离行中心——Element Plus 折叠时只把文字标签压成 `width: 0; height: 0`，标签**仍是 flex 项**，行上那条「图标与文字间距」的 `gap` 照样参与排布，图标因此偏左半个间距（宿主折叠宽度 64px、间距 10px 时实测偏左 5px）；而不渲染标签的消费方没有这个偏移，两边折叠态对不齐。现折叠态把行间距归零，图标居中，展开态间距不变。
 - **字段间距改为组件级变量并收敛到设计登记的 12px（可见变化，升级前必读）**：`TtForm` 给字段的 `margin-bottom` 此前是裸值 `20px`，既违反库内「`--tt-space-*` 是组件内边距、控件间隙和宿主页面节奏的唯一尺子」的约定，也让宿主没有正规手段表达密度 —— 宿主只能在 `TtForm` 容器上写 `gap`，而网格 `gap` 与字段的 `margin-bottom` 会**相加**（20 + 12 = 32px），这是管理页表单间距过大的直接来源。现收敛为 `--tt-form-item-gap`，默认 `var(--tt-space-3)`（= 12px，取设计系统「工作型」表单登记的字段间距）。**未显式覆盖该变量的 `TtForm` 页面，字段间距都会从 20px 收紧到 12px**；需要更松的局部组间距时，在表单元素上赋 `--tt-form-item-gap` 即可（该变量只作用于字段，不影响表单内部的行内布局 `gap`）。