waveform-analysis 0.1.72 → 0.1.74

package/README.md

@@ -10,6 +10,9 @@
 
 线上 Demo：[波形分析组件在线示例](https://lqycustomsite.online/waveform-analysis/)。
 
+综合示例第 11 个图框展示实测电压通道 `SX2_7_01`（炮号 `13300`），保留全部 1,000 个
+原始采样点。默认每页四个图框，在第 3 页查看；原始毫秒时间转换为秒坐标后传入组件。
+
 ## 特性
 
 - Vue 3 Composition API + TypeScript，支持按需导入 `WaveformChart`
@@ -516,9 +519,9 @@ const chartData = {
 多值轴模式的右侧 Y 轴将指数放在数值右侧，例如 `3 E+03`，不追加单位；不使用科学计数法时显示为 `3 (V)`。
 多 Y 轴模式下，每根轴使用该轴首个 series 的单位。
 
-左侧通道名称使用 12px、字重 600 的加粗文字。默认布局按字符宽度估算旋转名称的垂直范围，
-仅对可能与名称相交的刻度文字（含文字高度和安全间距）自动计算间距；不相交的顶部单位
-刻度不会推远名称。同一列中相同轴位使用逐道计算的最大间距，保证多道名称垂直对齐。
+左侧通道名称使用 12px、字重 600 的加粗文字。名称间距按该 Y 轴最长的刻度标签计算，
+包含最值刻度及实际显示的单位，不随名称长度或图框高度变化；科学计数法倍率不参与
+名称间距计算，倍率后的数值仍参与计算；轴外留白按完整刻度标签（含倍率）计算，防止越界。同一列中相同轴位使用逐道计算的最大间距，保证多道名称垂直对齐。
 图框高度不足 80px 时也不会隔道隐藏名称；例如 5×1 布局中，每个符合名称展示规则的图框
 仍显示完整通道名称，允许长名称互相重叠。净图模式及单位展示模式的显隐规则仍然生效。
 
@@ -581,8 +584,11 @@ const series = {
 `separated` 或 `compact` 控制图框布局和 X 轴共享方式；未共享 `trackId` 的单曲线
 图框不会因为切换叠加方式而改变。
 
-`compact` 多道紧密模式会显示每一道 Y 轴的最高刻度；顶部和底部刻度文字与普通
-Y 轴刻度使用相同的对齐方式，不额外向本道内部偏移。
+`compact` 多道紧密模式仅在最高刻度标签与最低刻度标签重叠时隐藏最高标签，
+优先保留最低标签；第一行以及其他没有冲突的最高标签正常显示。刻度线、网格、
+数据范围和文字对齐位置不变，科学计数法倍率与单位随最高的可见标签显示。
+上方留白区域内的原始最大值标记仍保留，并继续按标签碰撞规则处理。
+其他布局模式不应用这项边界标签避碰规则。
 
 ### 绘图区域尺寸
 
@@ -844,8 +850,9 @@ Demo 左侧“网格与轴线”支持直接切换数值或固定时间格式。
 是否显示毫秒。时间戳数据仍按组件的秒坐标契约传入，使用默认毫秒显示单位时 formatter 会收到
 可直接传给 `Date` 的毫秒时间戳。
 
-`interactionMode` 可选 `zoom`、`pan`、`annotation` 或 `none`，默认使用缩放模式。除 `none` 外，右键绘图区可直接打开
-标注编辑器。`zoomable`、`pannable` 和 `showTooltip` 分别控制缩放、平移和 tooltip；平移默认关闭，
+`interactionMode` 可选 `zoom`、`pan`、`annotation` 或 `none`，默认使用缩放模式。在内置工具栏选择标注或设置
+`interactionMode="annotation"` 后，左键单击绘图区可打开标注编辑器，右键不再触发新增标注。
+`zoomable`、`pannable` 和 `showTooltip` 分别控制缩放、平移和 tooltip；平移默认关闭，
 启用后在 `pan` 模式直接拖拽，`zoom` 模式按 Space 临时平移。传入模式 prop 时请接入更新回传，详见工具栏章节。
 
 展示场景可启用 `presentationMode`，统一禁用绘图区的 tooltip、缩放、平移、双击复位和
@@ -974,7 +981,7 @@ const interactionMode = ref<WaveformInteractionMode>('zoom')
 </template>
 ```
 
-标注默认显示。右键绘图区任意位置即可弹出居中编辑器，标注会吸附到当前 X 位置最近的真实采样点，右键已有标注可以编辑或删除。
+标注默认显示。标注模式下左键单击绘图区任意位置即可弹出居中编辑器，标注会吸附到当前 X 位置最近的真实采样点，右键已有标注可以编辑或删除。
 标注框可以直接拖动进行手动避让，拖动只改变标签框位置，不会改变 `x/y` 数据锚点；偏移会以 `labelOffsetX/labelOffsetY` 像素字段保存在标注中。标注文本最多 40 个字符，边框色、文字色和背景色均支持取色与透明度调整。组件只负责内存中的受控数据，
 业务层负责会话或后端持久化。
 
@@ -1266,7 +1273,7 @@ async function exportSvg(chart: WaveformChartHandle): Promise<Blob | undefined>
 配置支持响应式更新，适用于单轴和多轴模式的左右 Y 轴名称，不影响刻度数字、图例或 X 轴文字。
 字号参与名称与刻度之间的间距及图表边距计算；名称背景保持透明。
 
-### Y 轴上下留白与最大值刻度
+### Y 轴上下留白与极值刻度
 
 组件统一计算自动 Y 范围留白，调用方无需修改数据或自行设置扩展后的 `yDomain`：
 
@@ -1292,8 +1299,22 @@ const axes: WaveformAxesOptions = {
 nice 在添加留白后执行，可能进一步扩域，关闭留白不等于关闭 nice。
 常量沿用非零范围回退后计算跨度；误差棒开启时包含其端点；单轴合并范围，多轴分别计算。
 
-上方有效留白开启后，组件显示原始最大值的刻度和标签，常量标记仍为原始值。
-相同值刻度合并；最大值标签优先，隐藏距离不足 4px 的相邻普通标签；过近的普通短刻度及
+`axes.y.maximumTickVisible` 和 `axes.y.minimumTickVisible` 分别控制原始最大值、最小值的
+额外刻度线和标签，默认都为 `true`。两个开关与上下留白独立，设为 `false` 隐藏对应的
+额外最值刻度；关闭留白后仍显示域内已开启的最值。
+普通等距刻度不受开关影响，即使某个普通刻度恰好等于最值，也仍正常显示。
+支持响应式切换，不改变数据、Y 轴范围、缩放视口或 tooltip。
+
+```vue
+<!-- 只显示最大值的额外刻度 -->
+<WaveformChart :axes="{ y: { maximumTickVisible: true, minimumTickVisible: false } }" />
+```
+
+常量标记仍为原始值且最大值、最小值合并为一个刻度，误差棒开启时极值包含其端点。
+相同值刻度合并；极值标签优先，隐藏距离不足 4px 的相邻普通标签；过近的普通短刻度及
 关联水平网格线也会隐藏，图框边框始终保留。不会移动数值位置或为避让扩大范围。
-手动视口中仅显示域内的最大值，固定范围和仅下方留白不生成特殊最大值标记。
-Demo 的“Y 轴留白”配置区默认显式启用上下各 10%，与组件省略配置时的默认值不同。
+最小值与最大值标签重叠时优先保留最小值。手动视口或固定范围中仅显示域内的极值，
+不会为显示最值而扩展范围。同轴取可见系列的共同最值，多轴分别计算，使用完整原始数据。
+Demo 的“Y 轴留白”配置区默认显式启用上下各 10%，与组件省略配置时的默认值不同；
+“显示最大值刻度”和“显示最小值刻度”默认都开启，可分别切换。
+原 `extremaTicksVisible` 总开关已移除，请改用上述两个独立配置项。