waveform-analysis 0.1.76 → 0.1.77

package/README.md

@@ -6,25 +6,6 @@
 组件使用不可变数据模型：替换 `data` 引用后会重新计算数据域和视口；大数据会按当前可见范围
 和屏幕像素自动保峰降采样，而 tooltip、最近点查询和标注仍使用完整原始数据。
 
-## 0.1.76：移除实测通道示例
-
-综合示例移除原第11个图框及其真实采样数据，默认保留10个图框；末页只显示实际图框，
-不再补出编号11、12的空图框。README不再介绍该实测通道。
-动画系统和分页淡入继续可用。
-
-## 0.1.75：加入动画系统
-
-本版本新增系列入场、数据更新、标注动画和分页淡入，动画默认开启。首次入场默认
-1000ms，多系列交错100ms；数据更新、标注和分页淡入默认300ms，采用`cubicInOut`缓动。
-切页仅淡入新页的波形、点、误差棒和标注，轴与网格立即更新；连续翻页只展示最新页。
-
-通过`animation`、`animationUpdate`、`animationAnnotation`分别配置效果、时长、缓动和回调，
-或设置`:animation-enabled="false"`恢复静态展示。支持31种D3缓动及公开动画引擎/预设接口。
-总点数达到默认50,000阈值、系统启用减少动态效果或环境缺少RAF时自动静态展示。
-动画不修改原始数据、秒坐标或受控标注；交互和图片导出先提交最终态。
-
-详细用法见下文[动画](#动画)，本次变更见[最新发布说明](RELEASE_NOTES.md)。
-
 ## 在线示例
 
 线上 Demo：[波形分析组件在线示例](https://lqycustomsite.online/waveform-analysis/)。
@@ -41,7 +22,7 @@
 - 多系列图例、受控显隐、网格分页和最多四根 Y 轴
 - 自动 Y 轴范围，以及全局、按轨道或按系列配置的固定振幅范围
 - 按轨道控制水平/垂直网格线的显隐与颜色
-- 系列入场、数据更新、标注动画和分页淡入，支持独立配置与静态降级
+- 系列入场、数据更新、标注动画及分页/网格入场重播，支持独立配置与静态降级
 - 受控标注、右键编辑、拖拽避让和自定义颜色
 - 标题、图框、坐标轴、零值参考线、净图和渲染参数可配置
 
@@ -127,7 +108,7 @@ const data = ref<WaveformData>({
   }"
   :animation-update="{ enabled: true, duration: 300, easing: 'cubicInOut' }"
   :animation-annotation="{ enabled: true, type: 'bounce' }"
-  :animation-threshold="50000"
+  :animation-threshold="200000"
 />
 ```
 
@@ -136,7 +117,7 @@ const data = ref<WaveformData>({
 可显式覆盖。分类 `enabled: false` 只结束该类，恢复不重播；运行中修改时长/效果只影响
 下次任务。`duration: 0` 同步到终态并忽略该阶段的延迟/交错。
 
-总有效规范化点数 **>= threshold** 时静态，默认 threshold=50000，0 始终静态。
+总有效规范化点数 **>= threshold** 时静态，默认 threshold=200000，0 始终静态。
 计数包括隐藏及非当前页系列，通过 source.length 读取，不按采样点数计算。
 系统减少动态效果、缺少 RAF 或导出期间同样静态。页面后台暂停，返回扣除后台时间。
 
@@ -146,10 +127,15 @@ const data = ref<WaveformData>({
 交互、视口命令、布局变化及 PNG/SVG 导出先提交最新最终态；导出不等待无限动画，仍遵守
 原有 busy/stale/cancelled/timeout 错误契约和 5 秒上限。Demo `#/animation` 提供分类和效果控制。
 
-切换分页时，新页波形、散点、误差棒和标注同步淡入，坐标轴与网格立即更新。分页复用
-`animationUpdate`（默认 300ms、cubicInOut），关闭该类别或设置 `duration: 0` 会直接显示新页；
-全局关闭、减少动态效果和点数阈值同样生效。连续翻页只保留最新页，不做跨页形变或重播
-长入场动画。自动页码重置与其他布局变更仍静态处理。
+切换到不同分页或修改网格行列数（包括 1×2）时，目标页重播首次加载的波形绘制动画，
+曲线、散点和误差棒一起逐步出现，标注等待对应系列绘制完成，坐标轴与网格立即更新。
+这些操作复用 `animation` 的开关、方向、缓动、延迟及多系列交错配置
+（默认从左向右、cubicInOut，系列间隔100ms）。分页的单系列绘制时长固定为500ms；
+首次加载与网格调整仍使用 `animation.duration`（默认1000ms）。`animationUpdate` 只控制数据更新。
+关闭入场类别或设置 `duration: 0` 直接显示完整新页；全局静态降级同样生效。
+连续翻页或调整网格只播放最终目标，不重新请求数据、不做跨页形变；返回已访问页也重播，
+同页点击和相同网格尺寸不触发。网格调整引起的页码重置合并为一次重播，其他自动页码重置、
+resize及其他展示设置变化仍静态处理。
 
 ### 高级数值引擎