# FlowText 更新日志

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

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

### v2.0.5 (2026-09-12)

- 临时字符遮罩的尺寸监听改接共享管理器，避免组件单独创建原生 Observer；保持字符动效和遮罩几何规则。

### v2.0.4 (2026-09-09)

- 内容变化时保留字符也播放颜色动效；逐字符颜色与回落时序均按目标全文分布，保留前后缀不再提前一起褪色，不改变字符位移规则。

### v2.0.3 (2026-09-09)

- 修复滚轮首次初始化遗漏定位导致数字横向排开、被裁切后消失的问题；仅当前数字参与单字占位，其余数字绝对定位在同一滚轮内。
- 增加真实 Demo 录屏操作回归，同时验证数位可见范围和单字占位宽度。

### v2.0.2 (2026-09-08)

- 默认主动画缩短至 550ms，逐位时序与 NumericText 一致；演示页正常速度直接使用组件默认值。
- 修复从零进入负数、静止后切换方向时沿用旧数字轴的问题；加减一不再绕行九格。
- 同步 TextMotion-Demo 输入值处理，手动输入后加减按钮继续执行数值计算。

### v2.0.1 (2026-09-08)

- 数字滚轮和文字进退场支持连续重定向；保留当前轨迹与方向，批量测量遮罩并取消逐位轮询。

### v2.0.0 (2026-06-16)

- 删除数字和普通字符两套运行时，所有内容统一接入公共字符重组能力。
- 字符出现 / 消失统一复刻 `number-flow-main` 的纵向数位流与 AnimatePresence opacity 视觉。
- `scaleY` 变形从位移开始时立即触发，并新增 `transition.deformDuration` / `transition.deformEasing` 独立控制变形速度与缓动。
- 字符遮罩改为每个动效字符一个临时静止窗口，复用 NumberFlow 的 mask 渐变、宽度与位置；窗口绝对定位，不改变字符占位宽度，静态字符不常驻 mask。
- 滚动距离改为 `100% - 0.22em overlap` 负间距试验方案；遮罩使用不参与布局的扩展 viewport，glyph offset 回真实字符原点，避免窄字符直接承载 NumberFlow mask 时被横向/纵向渐变吃掉。
- 数字、计时器和倒计时保留公共趋势、顺序和 modulo 语义；变化数字由 FlowText animator 临时渲染连续 wheel，复刻 NumberFlow 的 `--wheel-v` 轨道，并使用更强的先快后慢 ease-out 推进。
- TextMotion-Demo Slow Mode 可通过 `transition` 等比放慢 FlowText 的纵向 flow、opacity 与 stagger。