# Link 更新日志

先阅读 [完整 LICENSE](https://snowui.dev/LICENSE)；同任务、同版本、同范围去重。

### v1.5.0 (2026-10-22)
- 内外置附件与文字间距保持至少4 CSS px；图文／单行截断复用Frame singleLine，纯文字流保持原合同，截断仍由Link拥有。

### v1.4.0 (2026-10-14)

- **LINK-Underline.2** 新增 `underline="until-hover"`：常态显示文字下划线，非禁用 hover 时隐藏；Link 根继续显式拥有链接装饰，不受可选 `snowui-base.css` 的原生链接规则覆盖。

- 2026-09-21：统一使用文档、源码属性表与 Site / AI 阅读入口；仅文档修订，不改变组件行为。

### v1.3.0 (2026-09-16)

- 新增 color；所有变体默认 Black40 → Black100，Black100 → Black40，其余常态颜色 → Black100。保留 hoverColor 的显式覆盖与 false，以及其他现有 Props。
- hoverColor=false 保留通过颜色 override 设置的常态颜色。

### v1.2.3 (2026-08-15)

- Link 根节点显式声明 `text-decoration: none`，默认视觉不再依赖可选 `snowui-base.css` 的裸 `a` 初始化；公开 `underline` Prop 继续拥有下划线状态。

### v1.2.2 (2026-07-02)

- Link 默认内部 gap 恢复为 2px；修复 leading / trailing 投影残留格式空白；Link 根默认 `width: fit-content`，避免 column 父级 stretch 后 Grid 中间列扩张并把 trailing 推到最右侧。外置 Icon 继续保留自身默认尺寸。

### v1.2.1 (2026-07-02)

- Link 默认内部 gap 从 2px 调整为 4px；内置与外置 leading / trailing 统一生效。

### v1.2.0 (2026-06-23)

#### 优化
- **LINK-Truncation.4** 接入通用 `fitTextToElement()`：英文等字母文字只在完整单词边界截断，单词整体放不下时只显示省略符；中日韩文字按 Unicode 字素边界降级，避免显示半个字符。
- **LINK-Truncation.5** 使用 `measureTextForElement()` 将截断 Content 收缩到可见文字 + `…` 的真实宽度，使 trailing Icon 与省略符之间严格保持 Link 组件 gap，不残留 Content 轨道空白。

### v1.1.1 (2026-06-23)

#### 修复
- **LINK-Truncation.3** 将文字测量层、显式 `…` 尾列与 Tooltip 触发宿主拆分，避免依赖浏览器对可聚焦链接的原生 ellipsis 绘制；Link 获得焦点、鼠标按下或 Tooltip 激活时省略符保持稳定，通用 `TruncationController` 状态与检测逻辑保持不变。

### v1.1.0 (2026-06-23)

#### 新功能
- **LINK-Truncation.1** 新增 `lines={1}` 单行截断，文字真实溢出时默认通过 Tooltip 显示完整内容。
- **LINK-Truncation.2** 新增 `tooltip` 与 `onTruncate`，截断检测复用 Text / TableCell 共用的 `TruncationController`。

### v1.0.3 (2026-06-01)

#### 修复
- **LINK-Layout.4** 移除 Link 对外置 leading / trailing Icon 的尺寸覆写。内置 `ArrowUpRight` / `ArrowSquareOut` 保持 12px；外置 Icon 保留自身尺寸，未传 `size` 时使用 Icon 默认的 16px。

### v1.0.2 (2026-06-01)

#### 修复
- **LINK-Layout.1** 外置 leading / trailing 槽位投影回 Link 根层，恢复 Frame 三槽位协议的直系槽位识别、水平居中与统一 gap。
- **LINK-Layout.2** Link 的 `[data-auto-layout]` 根显式覆盖公共槽位 gap，保证内置 / 外置 Icon 与箭头统一使用 Link gap 变量。
- **LINK-Layout.3** `arrow` 改用内置 `ArrowUpRight` Icon，消除字符箭头的字体侧边留白差异。

### v1.0.1 (2026-06-01)

#### 修复
- **LINK-Hover.2** trailing 箭头、默认 Icon 与外置 trailing Icon 改为继承文字颜色，并按轻量 Icon 规范使用 `opacity: 0.4 -> 1` 表达 hover。

### v1.0.0 (2026-06-01)

#### 新功能
- **LINK-Init.1** 新增独立 Link 组件，迁移原 Button Link 默认样式。
- **LINK-Variant.1** 新增 `arrow` 与 `external` 变体，对齐 Workshop Link 样式 2 / 样式 3。
- **LINK-Hover.1** 新增 `hoverColor`，支持自定义 hover 颜色与 hover 不变色。
- **LINK-Underline.1** 新增 `underline`，支持 `none` / `always` / `hover`。
- **LINK-Icon.1** `external` 内置 `ArrowSquareOut` trailing Icon，支持外置直系 trailing 替换。