waveform-analysis 0.1.63 → 0.1.65

package/README.md

@@ -102,7 +102,7 @@ const data = ref<WaveformData>({
 | `maxZoomScale`             | `number \| null`                            | 未设置                                                                                | 最大缩放倍数；`null` 表示不限制               |
 | `initialXDomain`           | `[number, number]`                          | 未设置                                                                                | 所有图框的初始 X 范围（可超出数据，空白显示） |
 | `initialXDomains`          | `Record<string, [number, number]>`          | 未设置                                                                                | 按 track/series ID 配置初始范围（可超出数据） |
-| `xDomainStrategy`          | `WaveformXDomainStrategy`                   | `{ type: 'data' }`                                                                    | 自动 X 轴视口范围策略                         |
+| `xDomainStrategy`          | `WaveformXDomainStrategy`                   | `{ type: 'integer-ms' }`                                                              | 自动 X 轴视口范围策略                         |
 | `yDomain`                  | `[number, number]`                          | 未设置                                                                                | 所有波形的固定 Y 轴范围                       |
 | `yDomains`                 | `Record<string, [number, number]>`          | 未设置                                                                                | 按 track/series ID 配置固定范围               |
 | `grid`                     | `WaveformGridOptions`                       | `{ rowCount: 2, columnCount: 1, showPagination: true, fillIncompleteLastRow: false }` | 网格和分页                                    |
@@ -113,7 +113,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 +256,9 @@ Y 轴会独立计算：
 <WaveformChart :data="chartData" :axes="{ y: { splitNumber: 5 } }" />
 ```
 
+最下方的刻度标签不做额外偏移，文字底部基线直接与 Y 轴最小值刻度线齐平。
+原刻度数值、刻度线、网格和波形坐标保持不变；尺寸或坐标范围变化后，每根 Y 轴仍保持该对齐方式。
+
 默认会将 Y 轴范围扩展为便于读取的等距刻度。传入 `nice: false` 可保持数据自动范围或
 `yDomain` / `yDomains` 的原始端点：
 
@@ -319,7 +322,8 @@ chartRef.value?.setViewportDomain(trackDomain, trackIndex)
 数据边界使旧 transform 失效；`resetViewport(trackIndex?)` 的既有行为保持不变。
 
 没有显式配置初始范围时，可以通过 `xDomainStrategy` 将数据范围扩展为便于阅读的视口端点。
-默认的 `{ type: 'data' }` 保持数据最小值和最大值不变；`type: 'nice'` 使用固定刻度数量计算
+默认的 `{ type: 'integer-ms' }` 将数据范围向外贴近合适的整十毫秒边界；`type: 'data'` 保持数据
+最小值和最大值不变；`type: 'nice'` 使用固定刻度数量计算
 易读边界，且只扩展视口，不修改原始点位、tooltip、标注或缩放事件值：
 
 ```vue
@@ -338,6 +342,12 @@ chartRef.value?.setViewportDomain(trackDomain, trackIndex)
 按图框分别计算，共享 X 轴模式则合并所有可见图框后计算。所有范围仍使用原始秒坐标，
 `timeUnit` 只影响显示。
 
+若显式配置初始范围也需要贴近整十毫秒边界（例如 `-62881.52` 到 `14999.999`
+显示为 `-63000` 到 `15000`），可设置 `xDomainStrategy` 为
+`{ type: 'integer-ms', includeExplicit: true }`。该策略依据范围选择主刻度十分之一作为端点
+取整步长，不采用可能将末端扩大至 `20000` 的主刻度；短范围保留毫秒精度。
+显式初始范围仍须通过 `includeExplicit` 开启，原始数据坐标不变。
+
 独立坐标模式下，回填响应应只替换 `seriesIds` 对应的系列，并调用
 `resetViewport(trackIndex)`；其他图框的数据和缩放状态应保持不变。独立模式下双击图框触发的
 `zoom-reset` payload 会包含该图框的 `trackIndex` 和 `seriesIds`；共享 X 范围模式的 payload
@@ -377,6 +387,8 @@ const chartData = {
 `(V) 3`。单位为空、全为空白或未配置时，不显示 `(单位)`，例如仍显示为 `E+03 3` 或 `3`。
 多 Y 轴模式下，每根轴使用该轴首个 series 的单位。
 
+左侧通道名称使用 14px、字重 600 的加粗文字，按各道附近刻度文字自动计算间距，并使用同一列中相同轴位的最大间距，保证多道名称垂直对齐；左侧留白随刻度宽度调整，避免名称与刻度重叠。
+
 ### 线型、点型与误差棒
 
 每条序列可以独立设置连线方式、数据点符号和误差棒：
@@ -551,7 +563,8 @@ const hiddenSeriesIds = ref<string[]>([])
 
 ### 零值参考线与净图
 
-`zeroLine` 用于绘制 `y = 0` 的水平参考线，默认隐藏。参考线只在对应 Y 轴的当前 domain
+`zeroLine` 用于绘制 `y = 0` 的水平参考线，默认显示红色（`#ff0000`）、1px 宽的虚线
+（`dash: '6 4'`）。参考线只在对应 Y 轴的当前 domain
 包含 0 时渲染，不会为了显示参考线而扩展数据范围。多值轴模式下，每根可见 Y 轴分别按自身
 scale 定位零线：
 
@@ -560,7 +573,7 @@ scale 定位零线：
   :data="chartData"
   :zero-line="{
     visible: true,
-    color: '#98a2b3',
+    color: '#ff0000',
     width: 1,
     dash: '6 4',
   }"
@@ -570,6 +583,9 @@ scale 定位零线：
 `dash` 直接对应 SVG 的 `stroke-dasharray`；传入空字符串可显示实线。无效或非正数的
 `width` 会回退到 `1`。
 
+只传入颜色或线型时仍默认显示，例如 `:zero-line="{ color: '#0960bd', dash: '' }"`
+显示蓝色实线。使用 `:zero-line="{ visible: false }"` 可关闭零线。颜色和线型配置可动态修改。
+
 设置 `cleanView` 后，组件保留波形、图框边框、X/Y 轴刻度及刻度值，并隐藏标题内容、图例、
 网格、轴标签、图框背景、帧水印、零值参考线、标注和分页器。原图的标题区域、边距和波形
 尺寸保持不变；缩放、悬浮、十字线和 tooltip 仍然可用，切换回普通模式后原有配置和标注