tt-design-web-vue 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 All notable changes to this project will be documented in this file.
 
+## 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`）。
+  - `size` 档同步走同一变量，保持「small 更紧、large 更松」的单调关系：`--small` 取 `--tt-space-2`（8px），`--large` 取 `--tt-space-6`（24px，32px 属页面大留白语义、不进库内 4px 阶梯）。改动前 small 为 16px（比当时的默认 20px 紧），默认改为 12px 后若两档不动，small 会反而比默认更松。
+- **测试**：`tests/components/form.spec.ts` 由 9 例扩到 **11 例**（字段间距由变量驱动且默认 12px、size 档走同一变量、不回落裸值 20px）。
+- **被截断的文本改用组件库自己的气泡提示（可见变化）**：库内 14 个组件里「放不下就显示省略号」的文本位，此前有的是浏览器原生 `title`（悬停约一秒才弹、灰底方框、观感与库内提示完全两套），有的则**连提示都没有** —— 文字被截断了也读不到完整内容。现统一改为库内气泡，外观与出现时机同库内其它提示，覆盖 `TtAiInteractionCard`、`TtAiToolCall`、`TtAiArtifactRow`、`TtAiExecutionFeed`、`TtAiStatusCode`、`TtAiSubagentLineage`、`TtAiTodoProgress`、`TtDialog`、`TtMenuPanelItem`、`TtTransfer`、`TtUserDisplay`、`TtUpload`、`TtFilePreview`、`TtColorPicker`。
+  - **只在真的被截断时才弹**：此前原生 `title` 是无条件挂着的，文字明明放得下也会弹一个重复内容的方框；现在按元素实际宽度判定，放得下就不打扰。
+  - **`TtMenuPanel` 返回按钮的原生提示已移除**：该按钮是纯图标、不存在截断，悬停不再弹一个只有重复文字的空方框。
+  - **升级注意**：若宿主在上述位置自行叠了 `title`，会与库内气泡同时出现两个提示，升级时请一并去掉。
+  - **已知限制**：`TtDialog` 的标题与 `TtTransfer` 的面板头，其元素由 Element Plus 内部渲染，鼠标悬停正常弹提示，但读屏不会把提示内容作为附加说明读出来（`aria-describedby` 挂不到这两类元素上）；`TtTransfer` 的候选项与其余位置不受影响。
+- **图标族新增 3 个公共字形（`ttIcons`，72 → 75）**：补入 `TtIconSidebarOutline24`（侧栏展开 / 收起）、`TtIconCubeFill16`（工作空间）、`TtIconArrowUpFill16`（输入区发送）。三者上游（Element Plus / DeepSeek Harness / Feather）均无等价图形，按族规登记为 `source: 'self-drawn'`（`provenance: 'original'`），`origin` 如实记录最初取自 TongClaw 源码的位置；一律以 `currentColor` 着色，满足族内设计规则（由 `tt-icons.spec.ts` 强制）。`TtIconCubeFill16` 与 `TtIconArrowUpFill16` 为实心字形，`TtIconSidebarOutline24` 为线框字形。
+  - **`TtIconSidebarOutline24` 的描边统一为 1.4**：源图形在同一枚图标内混用了 1.8（外框与箭头）与 1.4（分隔线）两种笔画宽度，外框明显偏重；现将三者统一到 1.4，图形与画布不变。
+  - **`TtIconBriefcaseOutline24` 的用途标注由「工作空间」改为「工作箱」**：宿主真实的「空间」图形是实心立方体，已由新增的 `TtIconCubeFill16` 承载；该条目本身不删（删除公开导出属破坏性变更），仅修正用途描述。
+- **命名规则新增 `Fill` 风格后缀**：`Outline` = 线框字形（`stroke` 着色）、`Fill` = 实心字形（`fill` 着色）。该约定**只对新增图标生效，存量图标名不改**——族内仍有 18 条实心字形沿用 `Outline` 后缀，`TtIconSparkle16` 不带风格后缀；判断实际渲染方式一律以 `manifest.json` 的 `style` 字段为准。同时修正 `14` / `16` / `24` 的表述：它是**尺寸档**（默认渲染尺寸），多数与画布尺寸一致，既有 3 条与画布不一致（`TtIconHouseOutline16` 画布 20、`TtIconPulseOutline16` 画布 24、`TtIconWarningOutline16` 画布 14），按「已有名称不改」保留原名。两处规则在 `ttIcons/README.md` 与 `docs/components/icon.md` 同步登记。
+- **修复 8 个既有图标文件头失效的「源路径」**：`TtIconCheckSquareOutline16` 等 8 个图标的来源素材已被删除（`24bde2d5`），SFC 文件头与 `dist` 内却仍印着不存在的路径；现将这 8 条改为指向承载其语义的存活源码文件，并按 0.1.6 的既定做法**去掉全部手工行号**（这些字段没有任何消费者，行号只会腐坏）。
+- **配套文档同步**：`docs/guide/component-manifest.json`（Vue 运行时导出 193 → 196、Vue-only 默认扩展 92 → 95）、`docs/guide/component-compatibility.md` 一并补入这 3 个字形；`docs/components/icon.md` 另补一句消费方边界——壳层工具按钮的图标已由公共族提供，不要再为同类按钮新增独立 SVG 或 `<img>`。
+
 ## 0.1.8
 - **`TtAiToolCall` / `TtAiExecutionFeed` 的行名称改用次级文字档（可见变化）**：行标题此前取正文档（与页面正文同色），过程区一列步骤读起来和正文一样重；现改取次级档，与行首图标同色，行内形成「名称 > 摘要」的两档层次（摘要仍为更浅一档）。
 - **`TtAiToolCall` 新增 `streamingSummary`**：为真且行处于进行中时，摘要右侧渐隐，表达「这段文字还在往后写」。只应由**逐字增长**的摘要使用（例如思考内容），参数一类的定稿摘要不要开启。渐隐带宽度可用 `--tt-ai-tool-call-summary-fade` 调整。