waveform-analysis 0.1.65 → 0.1.66

package/README.md

@@ -98,6 +98,7 @@ const data = ref<WaveformData>({
 | `zoomable` / `showTooltip` | `boolean`                                   | `true` / `true`                                                                       | 缩放和数值 tooltip 开关                       |
 | `pannable`                 | `boolean`                                   | `false`                                                                               | 空格拖拽平移开关                              |
 | `minZoomSpan`              | `number`                                    | 未设置                                                                                | 最小缩放跨度，使用原始 X 数据单位             |
+| `integerZoom`              | `boolean`                                   | `false`                                                                               | 缩放范围按 X 轴显示单位对齐整数               |
 | `minVisiblePoints`         | `number`                                    | `0`                                                                                   | 缩放后至少保留的不同 X 坐标数                 |
 | `maxZoomScale`             | `number \| null`                            | 未设置                                                                                | 最大缩放倍数；`null` 表示不限制               |
 | `initialXDomain`           | `[number, number]`                          | 未设置                                                                                | 所有图框的初始 X 范围（可超出数据，空白显示） |
@@ -303,6 +304,15 @@ X 轴且包含多个轨道时使用按稳定 track ID 索引的 `yRanges`。平
 `initialXDomains` 按 track ID 或 series ID 分别配置。`minZoomSpan` 使用原始 X 数据单位，
 可防止每次区间数据回填后重新累计放大。未配置任何缩放约束时保留既有的 40 倍兜底；设置
 `minVisiblePoints: 2` 可缩放到两个真实采样点，`maxZoomScale: null` 可显式关闭倍率上限。
+
+设置 `:integer-zoom="true"` 可开启整数缩放，默认关闭。开启后滚轮、框选和
+`setViewportDomain` 的开始时间向下取整、结束时间向上取整；`timeUnit='ms'` 时对齐整毫秒，
+`timeUnit='s'` 时对齐整秒，最小跨度为一个显示单位。初始范围和重置范围也向外对齐，
+不会裁掉边缘数据，最小跨度、最大倍率和最少可见点数限制仍然生效。
+默认 X 轴标签和主刻度也使用整数显示单位，平移时保持整数端点及当前跨度。
+动态切换此开关或在开启时切换时间单位会重置视口。
+原始采样坐标不会被修改，缩放事件仍以秒返回实际对齐后的范围；自定义 formatter 不影响对齐粒度。
+关闭时 `timeUnit` 仍只影响展示，不改变缩放范围。
 显式设置多种限制时采用最严格的一项。双击图框会
 重置组件内部缩放并触发 `zoom-reset`；调用方应在事件中取消区间请求并恢复首次完整数据。
 外部重置按钮也可以通过模板引用调用组件公开的 `resetViewport()` 方法，然后执行相同的数据恢复逻辑。
@@ -387,7 +397,7 @@ const chartData = {
 `(V) 3`。单位为空、全为空白或未配置时，不显示 `(单位)`，例如仍显示为 `E+03 3` 或 `3`。
 多 Y 轴模式下，每根轴使用该轴首个 series 的单位。
 
-左侧通道名称使用 14px、字重 600 的加粗文字，按各道附近刻度文字自动计算间距，并使用同一列中相同轴位的最大间距，保证多道名称垂直对齐；左侧留白随刻度宽度调整，避免名称与刻度重叠。
+左侧通道名称使用 14px、字重 600 的加粗文字，按字符宽度估算旋转名称的垂直范围，仅对可能与名称相交的刻度文字（含文字高度和安全间距）自动计算间距；不相交的顶部单位刻度不会推远名称。同一列中相同轴位使用逐道计算的最大间距，保证多道名称垂直对齐；左侧留白随刻度宽度调整，避免名称与刻度重叠。
 
 ### 线型、点型与误差棒
 
@@ -564,8 +574,10 @@ const hiddenSeriesIds = ref<string[]>([])
 ### 零值参考线与净图
 
 `zeroLine` 用于绘制 `y = 0` 的水平参考线，默认显示红色（`#ff0000`）、1px 宽的虚线
-（`dash: '6 4'`）。参考线只在对应 Y 轴的当前 domain
-包含 0 时渲染，不会为了显示参考线而扩展数据范围。多值轴模式下，每根可见 Y 轴分别按自身
+（`dash: '6 4'`），透明度默认为 `0.5`。参考线只在对应 Y 轴的当前 domain
+严格跨过 0，且距两端均不小于一个主刻度间距的 2% 时渲染；零线位于边界时隐藏。
+不会为了显示参考线而扩展数据范围。零线绘制在曲线、点标记及误差棒上方。
+多值轴模式下，每根可见 Y 轴分别按自身
 scale 定位零线：
 
 ```vue
@@ -576,6 +588,8 @@ scale 定位零线：
     color: '#ff0000',
     width: 1,
     dash: '6 4',
+    opacity: 0.5,
+    boundaryThreshold: 0.02,
   }"
 />
 ```
@@ -586,6 +600,12 @@ scale 定位零线：
 只传入颜色或线型时仍默认显示，例如 `:zero-line="{ color: '#0960bd', dash: '' }"`
 显示蓝色实线。使用 `:zero-line="{ visible: false }"` 可关闭零线。颜色和线型配置可动态修改。
 
+`boundaryThreshold` 可动态调整边界隐藏比例，例如 `0.05` 表示一个主刻度间距的 5%，
+`0` 表示仅在恰好位于边界时隐藏；负数或非有限值回退到 `0.02`。
+`opacity` 支持 `0` 到 `1`，越界或非有限值回退到 `0.5`。颜色本身的 Alpha 与该透明度相乘；
+若使用 `rgba()` 或八位十六进制颜色的透明度，可设置 `opacity: 1`。
+主演示页的“零值参考线”区域可直接调整透明度，修改后立即应用于波形图。
+
 设置 `cleanView` 后，组件保留波形、图框边框、X/Y 轴刻度及刻度值，并隐藏标题内容、图例、
 网格、轴标签、图框背景、帧水印、零值参考线、标注和分页器。原图的标题区域、边距和波形
 尺寸保持不变；缩放、悬浮、十字线和 tooltip 仍然可用，切换回普通模式后原有配置和标注