# NumberFlow 更新日志

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

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

### v2.1.0 (2026-09-17)

- 重新对照 `number-flow@0.6.2` 的旧布局测量、节点更新和动画启动顺序，保留 SnowUI 的连续更新与交错能力。
- `chromatic()` 改为单一可见覆盖层：一位、三位或十位数字都覆盖完整彩谱，并直接过渡到最终文字色；不再通过透明 wheel viewport 绘制，也不会让黑色底字在彩色边缘形成黑边。
- 文档补充原始代码仓库、官方文档、MIT 归属、SnowUI 扩展能力和未公开的上游接口边界。

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

- `motionColor` 覆盖所有目标字符，保留字符和格式符号也参加统一的逐字颜色回落序列，并支持 `chromatic()`。颜色主时长固定为与 FlowText 默认值一致的 `550ms`，再以公共 `280ms linear` 回落；数字滚轮仍保留自身 `transition.duration`。完整时序遵循 TextMotionSpec §2.1。
- 字符变化效果保持原有规则；未设置颜色、关闭动画（适用时）或减少动效生效时显示最终原色。连续更新重新编排颜色序列，卸载清理颜色动画。


### v2.0.0

- 使用 Frame 承载公开根，支持格式化、趋势、循环数位、前后附加内容、宽度过渡、Skeleton 和 reduced-motion 退化。