waveform-analysis 0.1.64 → 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 范围（可超出数据，空白显示） |
@@ -113,7 +114,7 @@ const data = ref<WaveformData>({
 | `legend`                   | `WaveformLegendOptions`                     | `{ position: 'top-right', orientation: 'auto' }`                                      | 图例位置、排列、背景和交互                    |
 | `frameNumber`              | `string \| number`                          | 未设置                                                                                | 图框水印内容                                  |
 | `frameNumbers`             | `Record<string, string \| number>`          | 未设置                                                                                | 按 `trackId` 覆盖图框水印内容                 |
-| `zeroLine`                 | `WaveformZeroLineOptions`                   | `{ visible: false }`                                                                  | 零值参考线显隐与样式                          |
+| `zeroLine`                 | `WaveformZeroLineOptions`                   | `{ visible: true }`                                                                   | 零值参考线显隐与样式                          |
 | `cleanView`                | `boolean`                                   | `false`                                                                               | 保留波形、图框和刻度的净图模式                |
 | `presentationMode`         | `boolean`                                   | `false`                                                                               | 禁用绘图区交互的展示模式                      |
 | `annotations`              | `WaveformAnnotation[]`                      | `[]`                                                                                  | 受控标注数据                                  |
@@ -256,6 +257,9 @@ Y 轴会独立计算：
 <WaveformChart :data="chartData" :axes="{ y: { splitNumber: 5 } }" />
 ```
 
+最下方的刻度标签不做额外偏移，文字底部基线直接与 Y 轴最小值刻度线齐平。
+原刻度数值、刻度线、网格和波形坐标保持不变；尺寸或坐标范围变化后，每根 Y 轴仍保持该对齐方式。
+
 默认会将 Y 轴范围扩展为便于读取的等距刻度。传入 `nice: false` 可保持数据自动范围或
 `yDomain` / `yDomains` 的原始端点：
 
@@ -300,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()` 方法，然后执行相同的数据恢复逻辑。
@@ -384,6 +397,8 @@ const chartData = {
 `(V) 3`。单位为空、全为空白或未配置时，不显示 `(单位)`，例如仍显示为 `E+03 3` 或 `3`。
 多 Y 轴模式下，每根轴使用该轴首个 series 的单位。
 
+左侧通道名称使用 14px、字重 600 的加粗文字，按字符宽度估算旋转名称的垂直范围，仅对可能与名称相交的刻度文字（含文字高度和安全间距）自动计算间距；不相交的顶部单位刻度不会推远名称。同一列中相同轴位使用逐道计算的最大间距，保证多道名称垂直对齐；左侧留白随刻度宽度调整，避免名称与刻度重叠。
+
 ### 线型、点型与误差棒
 
 每条序列可以独立设置连线方式、数据点符号和误差棒：
@@ -558,8 +573,11 @@ const hiddenSeriesIds = ref<string[]>([])
 
 ### 零值参考线与净图
 
-`zeroLine` 用于绘制 `y = 0` 的水平参考线，默认隐藏。参考线只在对应 Y 轴的当前 domain
-包含 0 时渲染，不会为了显示参考线而扩展数据范围。多值轴模式下，每根可见 Y 轴分别按自身
+`zeroLine` 用于绘制 `y = 0` 的水平参考线，默认显示红色（`#ff0000`）、1px 宽的虚线
+（`dash: '6 4'`），透明度默认为 `0.5`。参考线只在对应 Y 轴的当前 domain
+严格跨过 0，且距两端均不小于一个主刻度间距的 2% 时渲染；零线位于边界时隐藏。
+不会为了显示参考线而扩展数据范围。零线绘制在曲线、点标记及误差棒上方。
+多值轴模式下，每根可见 Y 轴分别按自身
 scale 定位零线：
 
 ```vue
@@ -567,9 +585,11 @@ scale 定位零线：
   :data="chartData"
   :zero-line="{
     visible: true,
-    color: '#98a2b3',
+    color: '#ff0000',
     width: 1,
     dash: '6 4',
+    opacity: 0.5,
+    boundaryThreshold: 0.02,
   }"
 />
 ```
@@ -577,6 +597,15 @@ scale 定位零线：
 `dash` 直接对应 SVG 的 `stroke-dasharray`；传入空字符串可显示实线。无效或非正数的
 `width` 会回退到 `1`。
 
+只传入颜色或线型时仍默认显示，例如 `: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 仍然可用，切换回普通模式后原有配置和标注