waveform-analysis 0.1.46 → 0.1.48

package/dist/types/components/core/grid.d.ts

@@ -7,6 +7,8 @@ export interface WaveformGridOptions {
     columnCount?: number;
     showPagination?: boolean;
     fillIncompleteLastRow?: boolean;
+    /** Stable grid slots. Empty IDs remain as empty chart frames and keep their page position. */
+    trackOrder?: string[];
     trackLines?: WaveformGridTrackLines;
 }
 export interface WaveformGridLineOptions {
@@ -29,6 +31,7 @@ export interface NormalizedWaveformGridOptions {
     columnCount: number;
     showPagination: boolean;
     fillIncompleteLastRow: boolean;
+    trackOrder?: string[];
     trackLines: Record<string, NormalizedWaveformGridLineOptions>;
 }
 export interface GridCellGeometry {

package/dist/types/components/core/layout.d.ts

@@ -15,8 +15,8 @@ export declare function resolveYAxisSeriesGroups(track: DisplayTrack, overlayMod
 export declare function axisTextMetrics(domain: [number, number], nice?: boolean, tickValues?: number[], unit?: string, tickCount?: number): {
     tickTextWidth: number;
 };
-export declare function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?: number): number;
-export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, tickCount?: number): {
+export declare function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?: number, nice?: boolean): number;
+export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, tickCount?: number, nice?: boolean): {
     left: number;
     right: number;
 };

package/dist/types/components/core/trackLayoutBuilder.d.ts

@@ -22,6 +22,7 @@ export interface BuildTrackLayoutsOptions {
     timeUnit: 's' | 'ms';
     xAxisLabelFormatter?: WaveformXAxisLabelFormatter;
     yAxisSplitNumber?: number;
+    yAxisNice?: boolean;
     rendering: ResolvedWaveformRenderingOptions;
     hideSecondaryLabels: boolean;
     yAxisLabelX: number;

package/dist/types/components/core/types.d.ts

@@ -76,7 +76,8 @@ export interface TrackLayout {
     /** Stable track key derived from trackId, or from the series id when trackId is omitted. */
     id: string;
     index: number;
-    series: DisplaySeries;
+    /** Primary visible series, if this grid slot has waveform data. */
+    series: DisplaySeries | null;
     /** Visible series used by rendering and interaction code. */
     seriesList: DisplaySeries[];
     /** Complete series list used by the legend. */

package/dist/types/components/interaction/useWaveformViewport.d.ts

@@ -1,7 +1,8 @@
 import { type ZoomTransform } from 'd3';
 import { type ComputedRef, type Ref, type ShallowRef } from 'vue';
 import type { DisplayTrack, TrackLayout } from '../core/types';
-import type { ResolvedWaveformChartProps, ViewportSelectionState, WaveformChartEmit } from '../core/waveformChartTypes';
+import type { ResolvedWaveformChartProps, ViewportSelectionState } from '../core/waveformChartTypes';
+import type { WaveformChartEmit } from '../core/waveformChartTypes';
 import type { AnnotationSeriesCandidate } from '../annotation';
 interface ViewportContext {
     props: ResolvedWaveformChartProps;

package/dist/types/types/chart.d.ts

@@ -152,6 +152,8 @@ export interface WaveformAxesOptions {
         lineVisible?: boolean;
         /** Target total number of equal Y-axis ticks, including endpoints. Defaults to 5. */
         splitNumber?: number;
+        /** Expands Y-axis domains to equal, human-friendly intervals. Defaults to true. */
+        nice?: boolean;
     };
 }
 /** Styling and visibility options for the horizontal zero-value reference line. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waveform-analysis",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/types/index.d.ts",

package/src/components/WaveformChartView.vue

@@ -222,7 +222,7 @@ function handleChartPointerLeave() {
         <!-- 轨道渲染 -->
         <WaveformTrack
           v-for="track in trackLayouts"
-          :key="`${track.index}-${track.series.name}`"
+          :key="`${track.index}-${track.id}`"
           :track="track"
           :clip-path-id="clipPathId"
           :inner-width="innerWidth"
@@ -277,7 +277,7 @@ function handleChartPointerLeave() {
         <g v-if="!isCleanView" class="waveform-chart__legend-layer">
           <g
             v-for="track in trackLayouts"
-            :key="`legend-${track.index}-${track.series.name}`"
+            :key="`legend-${track.index}-${track.id}`"
             class="waveform-chart__legend-track"
             :data-legend-track-index="track.index"
             :data-legend-track-id="track.id"

package/src/components/core/grid.test.ts

@@ -16,6 +16,7 @@ describe('waveform grid helpers', () => {
       columnCount: 1,
       showPagination: true,
       fillIncompleteLastRow: false,
+      trackOrder: [],
       trackLines: {},
     })
     expect(normalizeGridOptions({ rowCount: 0, columnCount: 99 })).toEqual({
@@ -23,10 +24,17 @@ describe('waveform grid helpers', () => {
       columnCount: 10,
       showPagination: true,
       fillIncompleteLastRow: false,
+      trackOrder: [],
       trackLines: {},
     })
   })
 
+  it('normalizes track order by trimming, dropping blanks, and removing duplicates', () => {
+    expect(
+      normalizeGridOptions({ trackOrder: [' voltage ', '', 'current', 'voltage', '  '] }),
+    ).toMatchObject({ trackOrder: ['voltage', 'current'] })
+  })
+
   it('normalizes per-track grid line visibility with visible defaults', () => {
     expect(
       normalizeGridOptions({
@@ -170,7 +178,11 @@ describe('waveform grid helpers', () => {
 
   it('keeps full pages and the disabled option byte-for-byte compatible', () => {
     const base = normalizeGridOptions({ rowCount: 2, columnCount: 2 })
-    const filled = normalizeGridOptions({ rowCount: 2, columnCount: 2, fillIncompleteLastRow: true })
+    const filled = normalizeGridOptions({
+      rowCount: 2,
+      columnCount: 2,
+      fillIncompleteLastRow: true,
+    })
     const fullSlots = [true, true, true, true]
     expect(resolveGridCellGeometry(400, 300, filled, 'independent', fullSlots)).toEqual(
       resolveGridCellGeometry(400, 300, base, 'independent', fullSlots),

package/src/components/core/grid.ts

@@ -9,6 +9,8 @@ export interface WaveformGridOptions {
   columnCount?: number
   showPagination?: boolean
   fillIncompleteLastRow?: boolean
+  /** Stable grid slots. Empty IDs remain as empty chart frames and keep their page position. */
+  trackOrder?: string[]
   trackLines?: WaveformGridTrackLines
 }
 
@@ -35,6 +37,7 @@ export interface NormalizedWaveformGridOptions {
   columnCount: number
   showPagination: boolean
   fillIncompleteLastRow: boolean
+  trackOrder?: string[]
   trackLines: Record<string, NormalizedWaveformGridLineOptions>
 }
 
@@ -59,6 +62,15 @@ const normalizeCount = (value: unknown, fallback: number) => {
   return Math.min(GRID_MAX_COUNT, Math.max(GRID_MIN_COUNT, Math.floor(numeric)))
 }
 
+const normalizeTrackOrder = (trackOrder: unknown): string[] => {
+  if (!Array.isArray(trackOrder)) return []
+  const normalized = trackOrder
+    .filter((trackId): trackId is string => typeof trackId === 'string')
+    .map((trackId) => trackId.trim())
+    .filter(Boolean)
+  return Array.from(new Set(normalized))
+}
+
 export function normalizeGridOptions(options?: WaveformGridOptions): NormalizedWaveformGridOptions {
   const trackLines = Object.fromEntries(
     Object.entries(options?.trackLines ?? {}).map(([trackId, lines]) => [
@@ -82,6 +94,7 @@ export function normalizeGridOptions(options?: WaveformGridOptions): NormalizedW
     columnCount: normalizeCount(options?.columnCount, 1),
     showPagination: options?.showPagination ?? true,
     fillIncompleteLastRow: options?.fillIncompleteLastRow ?? false,
+    trackOrder: normalizeTrackOrder(options?.trackOrder),
     trackLines,
   }
 }
@@ -148,10 +161,7 @@ export function resolveGridCellGeometry(
   }
   const totalVerticalGap = Math.max(0, rowCount - 1) * defaultGap
   const totalAxisBand = axisRows.size * X_AXIS_BAND
-  const plotHeight = Math.max(
-    1,
-    (innerHeight - totalVerticalGap - totalAxisBand) / rowCount,
-  )
+  const plotHeight = Math.max(1, (innerHeight - totalVerticalGap - totalAxisBand) / rowCount)
 
   return Array.from({ length: filledLastRow ? seriesCount : pageSize }, (_, slotIndex) => {
     const row = Math.floor(slotIndex / options.columnCount)

package/src/components/core/layout.ts

@@ -133,9 +133,13 @@ export function axisTextMetrics(
   }
 }
 
-export function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?: number): number {
+export function measureYAxisGroupClearance(
+  group: YAxisSeriesGroup,
+  tickCount?: number,
+  nice = true,
+): number {
   return (
-    axisTextMetrics(group.domain, true, undefined, group.seriesList[0]?.unit, tickCount)
+    axisTextMetrics(group.domain, nice, undefined, group.seriesList[0]?.unit, tickCount)
       .tickTextWidth +
     Y_AXIS_TICK_PADDING +
     Y_AXIS_LABEL_GAP +
@@ -144,9 +148,13 @@ export function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?:
   )
 }
 
-function measureYAxisGroupTickClearance(group: YAxisSeriesGroup, tickCount?: number): number {
+function measureYAxisGroupTickClearance(
+  group: YAxisSeriesGroup,
+  tickCount?: number,
+  nice = true,
+): number {
   return (
-    axisTextMetrics(group.domain, true, undefined, group.seriesList[0]?.unit, tickCount)
+    axisTextMetrics(group.domain, nice, undefined, group.seriesList[0]?.unit, tickCount)
       .tickTextWidth +
     Y_AXIS_TICK_PADDING +
     Y_AXIS_OUTER_PADDING
@@ -159,13 +167,14 @@ export function measureTrackYAxisClearance(
   yDomain?: WaveformYDomain,
   yDomains?: Record<string, WaveformYDomain>,
   tickCount?: number,
+  nice = true,
 ): { left: number; right: number } {
   return resolveYAxisSeriesGroups(track, overlayMode, yDomain, yDomains).reduce(
     (clearance, group) => {
       clearance[group.side] +=
         overlayMode === 'multi-axis' || track.visibleSeries.length === 1
-          ? measureYAxisGroupClearance(group, tickCount)
-          : measureYAxisGroupTickClearance(group, tickCount)
+          ? measureYAxisGroupClearance(group, tickCount, nice)
+          : measureYAxisGroupTickClearance(group, tickCount, nice)
       return clearance
     },
     { left: 0, right: 0 },

package/src/components/core/trackLayoutBuilder.ts

@@ -26,7 +26,7 @@ import {
   type NormalizedWaveformGridOptions,
 } from './grid'
 import { axisTextMetrics, resolveYAxisSeriesGroups, resolveYAxisTickCount } from './layout'
-import type { DisplaySeries, DisplayTrack, TrackLayout, WaveformYAxisLayout } from './types'
+import type { DisplayTrack, TrackLayout, WaveformYAxisLayout } from './types'
 import { applyXDomainStrategy } from './xDomain'
 import {
   Y_AXIS_LABEL_BAND_WIDTH,
@@ -55,6 +55,7 @@ export interface BuildTrackLayoutsOptions {
   timeUnit: 's' | 'ms'
   xAxisLabelFormatter?: WaveformXAxisLabelFormatter
   yAxisSplitNumber?: number
+  yAxisNice?: boolean
   rendering: ResolvedWaveformRenderingOptions
   hideSecondaryLabels: boolean
   yAxisLabelX: number
@@ -81,33 +82,24 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
   const bottomCells = getBottomRowCellIndexes(visibleCells, options.grid.columnCount)
 
   return visibleCells.flatMap((cell, index) => {
-    const isEmpty = !cell.series
-    if (isEmpty && (options.displayMode !== 'compact' || !options.showCompactEmptyTracks)) return []
-    const emptySeries: DisplaySeries = {
+    const isEmpty = !cell.series || cell.series.series.length === 0
+    if (!cell.series && (options.displayMode !== 'compact' || !options.showCompactEmptyTracks))
+      return []
+    const displayTrack: DisplayTrack = cell.series ?? {
       id: `empty-grid-slot-${cell.slotIndex}`,
-      name: '',
-      color: 'transparent',
-      lineType: 'linear',
-      lineStyle: 'solid',
-      pointType: 'none',
-      errorBar: { visible: false, width: 1.5, capWidth: 8 },
-      points: [],
+      series: [],
+      visibleSeries: [],
       xDomain: [0, 1],
       yDomain: [0, 1],
-      hasErrorPoints: false,
-    }
-    const displayTrack: DisplayTrack = cell.series ?? {
-      id: emptySeries.id,
-      series: [emptySeries],
-      visibleSeries: [emptySeries],
-      xDomain: emptySeries.xDomain,
-      yDomain: emptySeries.yDomain,
     }
     const hasVisibleSeries = !isEmpty && displayTrack.visibleSeries.length > 0
-    const series = displayTrack.visibleSeries[0] ?? displayTrack.series[0] ?? emptySeries
+    const series = displayTrack.visibleSeries[0] ?? displayTrack.series[0] ?? null
     const baseXScale =
       options.displayMode === 'independent'
-        ? scaleLinear(resolveIndependentXDomain(displayTrack, series.id, options), [0, cell.width])
+        ? scaleLinear(
+            resolveIndependentXDomain(displayTrack, series?.id ?? displayTrack.id, options),
+            [0, cell.width],
+          )
         : scaleLinear(options.sharedZoomDomain, [0, cell.width])
     const transform =
       options.displayMode === 'independent'
@@ -128,7 +120,7 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
       const tickCount = resolveYAxisTickCount(cell.plotHeight, options.yAxisSplitNumber)
       const niceCount = Math.max(1, tickCount - 1)
       const scale = scaleLinear(group.domain, [cell.plotHeight, 0])
-      scale.nice(niceCount)
+      if (options.yAxisNice !== false) scale.nice(niceCount)
       const [axisStart, axisEnd] = scale.domain()
       const majorTicks = Array.from(
         { length: tickCount },
@@ -167,7 +159,9 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
         seriesList: group.seriesList,
       }
     })
-    const yScale = yAxes[0]?.scale ?? scaleLinear(displayTrack.yDomain, [cell.plotHeight, 0]).nice()
+    const fallbackYScale = scaleLinear(displayTrack.yDomain, [cell.plotHeight, 0])
+    if (options.yAxisNice !== false) fallbackYScale.nice()
+    const yScale = yAxes[0]?.scale ?? fallbackYScale
     const xMajorTicks = xScale.ticks(Math.max(2, Math.floor(cell.width / 100)))
     const yMajorTicks = yAxes[0]?.majorTicks ?? []
     const yAxisTickValues = yAxes[0]?.tickValues ?? []

package/src/components/core/types.ts

@@ -86,7 +86,8 @@ export interface TrackLayout {
   /** Stable track key derived from trackId, or from the series id when trackId is omitted. */
   id: string
   index: number
-  series: DisplaySeries
+  /** Primary visible series, if this grid slot has waveform data. */
+  series: DisplaySeries | null
   /** Visible series used by rendering and interaction code. */
   seriesList: DisplaySeries[]
   /** Complete series list used by the legend. */

package/src/components/core/useWaveformLayout.ts

@@ -75,6 +75,7 @@ export function useWaveformLayout(context: LayoutContext) {
         (index === 0 ? props.lineColor : channelColors[index % channelColors.length]),
     })),
   )
+  const gridOptions = computed(() => normalizeGridOptions(props.grid))
   const chartTracks = computed<DisplayTrack[]>(() => {
     const groupedSeries = new Map<string, DisplaySeries[]>()
     chartSeries.value.forEach((series) => {
@@ -83,7 +84,13 @@ export function useWaveformLayout(context: LayoutContext) {
       if (trackSeries) trackSeries.push(series)
       else groupedSeries.set(trackId, [series])
     })
-    return Array.from(groupedSeries, ([id, series]) => {
+    const trackOrder = gridOptions.value.trackOrder ?? []
+    const orderedTrackIds = [
+      ...trackOrder,
+      ...Array.from(groupedSeries.keys()).filter((trackId) => !trackOrder.includes(trackId)),
+    ]
+    return orderedTrackIds.map((id) => {
+      const series = groupedSeries.get(id) ?? []
       const visibleSeries = series.filter((item) => !hiddenSeriesIdSet.value.has(item.id))
       const xDomainValues: number[] = []
       const yDomainValues: number[] = []
@@ -95,17 +102,22 @@ export function useWaveformLayout(context: LayoutContext) {
         id,
         series,
         visibleSeries,
-        xDomain: paddedDomain(xDomainValues),
-        yDomain: paddedDomain(yDomainValues),
+        xDomain: xDomainValues.length ? paddedDomain(xDomainValues) : [0, 1],
+        yDomain: yDomainValues.length ? paddedDomain(yDomainValues) : [0, 1],
       }
     })
   })
-  const gridOptions = computed(() => normalizeGridOptions(props.grid))
   const renderingOptions = computed(() => resolveWaveformRenderingOptions(props.rendering))
   const pageCount = computed(() => getPageCount(chartTracks.value.length, gridOptions.value))
   const pagedTracks = computed(() =>
     paginateSeries(chartTracks.value, currentPage.value, gridOptions.value),
   )
+  const layoutTracks = computed(() => {
+    const tracksWithSeries = pagedTracks.value.filter((track) => track.series.length > 0)
+    return gridOptions.value.fillIncompleteLastRow && tracksWithSeries.length > 0
+      ? tracksWithSeries
+      : pagedTracks.value
+  })
   const yAxisMetrics = computed(() => {
     const axisText = chartTracks.value
       .filter((track) => track.visibleSeries.length > 0)
@@ -116,7 +128,7 @@ export function useWaveformLayout(context: LayoutContext) {
         (group) =>
           axisTextMetrics(
             group.domain,
-            true,
+            props.axes?.y?.nice !== false,
             undefined,
             group.seriesList[0]?.unit,
             props.axes?.y?.splitNumber,
@@ -167,6 +179,7 @@ export function useWaveformLayout(context: LayoutContext) {
           props.yDomain,
           props.yDomains,
           props.axes?.y?.splitNumber,
+          props.axes?.y?.nice !== false,
         )
         return {
           left: Math.max(maximum.left, clearance.left),
@@ -217,9 +230,7 @@ export function useWaveformLayout(context: LayoutContext) {
   const hasChartArea = computed(() => innerWidth.value > 0 && innerHeight.value > 0)
   const resolvedXLabel = computed(() => props.xLabel ?? `时间（${props.timeUnit}）`)
   const activeInteractionMode = computed(() => props.interactionMode)
-  const isZoomMode = computed(
-    () => activeInteractionMode.value === 'zoom' || activeInteractionMode.value === undefined,
-  )
+  const isZoomMode = computed(() => activeInteractionMode.value !== 'annotation')
   const sharedXDomain = computed(() => {
     const values: number[] = []
     chartTracks.value.forEach((track) => {
@@ -245,8 +256,8 @@ export function useWaveformLayout(context: LayoutContext) {
   })
   const resolveInitialTrackDomain = (track: TrackLayout): [number, number] => {
     const configuredDomain =
-      props.initialXDomains?.[track.series.trackId ?? track.series.id] ??
-      props.initialXDomains?.[track.series.id] ??
+      props.initialXDomains?.[track.series?.trackId ?? track.series?.id ?? track.id] ??
+      (track.series ? props.initialXDomains?.[track.series.id] : undefined) ??
       props.initialXDomain
     if (
       configuredDomain &&
@@ -279,10 +290,10 @@ export function useWaveformLayout(context: LayoutContext) {
       innerHeight.value,
       gridOptions.value,
       props.displayMode,
-      pagedTracks.value.map(Boolean),
+      layoutTracks.value.map(Boolean),
       yAxisLayout.value.horizontalGap,
     )
-    return cells.map((cell, index) => ({ ...cell, series: pagedTracks.value[index] }))
+    return cells.map((cell, index) => ({ ...cell, series: layoutTracks.value[index] }))
   })
   const trackLayouts = computed<TrackLayout[]>(() =>
     buildTrackLayouts({
@@ -309,6 +320,7 @@ export function useWaveformLayout(context: LayoutContext) {
       timeUnit: props.timeUnit,
       xAxisLabelFormatter: props.axes?.x?.labelFormatter,
       yAxisSplitNumber: props.axes?.y?.splitNumber,
+      yAxisNice: props.axes?.y?.nice,
       rendering: renderingOptions.value,
       hideSecondaryLabels: isCleanView.value || yAxisLayout.value.hideSecondaryLabels,
       yAxisLabelX: yAxisMetrics.value.labelCenterX,

package/src/components/core/yAxisNice.test.ts

@@ -0,0 +1,174 @@
+import { zoomIdentity } from 'd3'
+import { describe, expect, it } from 'vitest'
+
+import { DEFAULT_WAVEFORM_RENDERING_OPTIONS } from '../../core'
+import type { WaveformData } from '../../types'
+import { buildTrackLayouts } from './trackLayoutBuilder'
+import type { DisplaySeries, DisplayTrack } from './types'
+import { prepareWaveformSeries } from './useWaveformData'
+
+function displaySeries(id: string, domain: [number, number]): DisplaySeries {
+  return {
+    id,
+    name: id,
+    color: '#1677ff',
+    lineType: 'linear',
+    lineStyle: 'solid',
+    pointType: 'none',
+    errorBar: { visible: false, width: 1.5, capWidth: 8 },
+    points: [
+      { x: 0, y: domain[0] },
+      { x: 1, y: domain[1] },
+    ],
+    xDomain: [0, 1],
+    yDomain: domain,
+    hasErrorPoints: false,
+  }
+}
+
+function layout(
+  series: DisplaySeries[],
+  options: { overlayMode?: 'single-axis' | 'multi-axis'; fixedYDomain?: [number, number] } = {},
+) {
+  const track: DisplayTrack = {
+    id: 'track',
+    series,
+    visibleSeries: series,
+    xDomain: [0, 1],
+    yDomain: [
+      Math.min(...series.map((item) => item.yDomain[0])),
+      Math.max(...series.map((item) => item.yDomain[1])),
+    ],
+  }
+  return buildTrackLayouts({
+    cells: [
+      {
+        slotIndex: 0,
+        row: 0,
+        column: 0,
+        left: 0,
+        top: 0,
+        width: 120,
+        height: 100,
+        plotHeight: 100,
+        cellHeight: 130,
+        xAxisBand: 30,
+        series: track,
+      },
+    ],
+    grid: {
+      rowCount: 1,
+      columnCount: 1,
+      showPagination: false,
+      fillIncompleteLastRow: false,
+      trackLines: {},
+    },
+    displayMode: 'independent',
+    overlayMode: options.overlayMode ?? 'single-axis',
+    independentTransforms: [zoomIdentity],
+    sharedZoomDomain: [0, 1],
+    fixedYDomain: options.fixedYDomain,
+    timeUnit: 'ms',
+    rendering: DEFAULT_WAVEFORM_RENDERING_OPTIONS,
+    hideSecondaryLabels: false,
+    yAxisLabelX: -50,
+    yAxisNice: false,
+    showCompactEmptyTracks: false,
+  })[0]!
+}
+
+describe('Y-axis nice domains', () => {
+  it('defaults to a nice domain and can preserve the actual data endpoints', () => {
+    const source = displaySeries('source', [3, 97])
+    const track: DisplayTrack = {
+      id: 'track',
+      series: [source],
+      visibleSeries: [source],
+      xDomain: [0, 1],
+      yDomain: [3, 97],
+    }
+    const defaults = buildTrackLayouts({
+      cells: [
+        {
+          slotIndex: 0,
+          row: 0,
+          column: 0,
+          left: 0,
+          top: 0,
+          width: 120,
+          height: 100,
+          plotHeight: 100,
+          cellHeight: 130,
+          xAxisBand: 30,
+          series: track,
+        },
+      ],
+      grid: {
+        rowCount: 1,
+        columnCount: 1,
+        showPagination: false,
+        fillIncompleteLastRow: false,
+        trackLines: {},
+      },
+      displayMode: 'independent',
+      overlayMode: 'single-axis',
+      independentTransforms: [zoomIdentity],
+      sharedZoomDomain: [0, 1],
+      timeUnit: 'ms',
+      rendering: DEFAULT_WAVEFORM_RENDERING_OPTIONS,
+      hideSecondaryLabels: false,
+      yAxisLabelX: -50,
+      showCompactEmptyTracks: false,
+    })[0]!
+
+    expect(defaults.yScale.domain()).toEqual([0, 100])
+    expect(layout([source]).yScale.domain()).toEqual([3, 97])
+  })
+
+  it('merges visible single-axis series but keeps multi-axis series independent', () => {
+    const first = displaySeries('first', [3, 40])
+    const second = displaySeries('second', [10, 97])
+
+    expect(layout([first, second]).yScale.domain()).toEqual([3, 97])
+    expect(
+      layout([first, second], { overlayMode: 'multi-axis' }).yAxes.map((axis) =>
+        axis.scale.domain(),
+      ),
+    ).toEqual([
+      [3, 40],
+      [10, 97],
+    ])
+  })
+
+  it('keeps explicit domains and constant-data safety ranges unchanged', () => {
+    expect(
+      layout([displaySeries('source', [3, 97])], { fixedYDomain: [3, 97] }).yScale.domain(),
+    ).toEqual([3, 97])
+    expect(layout([displaySeries('constant', [9.5, 10.5])]).yScale.domain()).toEqual([9.5, 10.5])
+  })
+
+  it('continues to include visible error-bar bounds in the preserved domain', () => {
+    const input: WaveformData = {
+      kind: 'series',
+      series: [
+        {
+          id: 'error-series',
+          name: 'error series',
+          errorBar: { visible: true },
+          data: {
+            kind: 'points',
+            points: [
+              { x: 0, y: 3, lowerError: 2 },
+              { x: 1, y: 7, upperError: 4 },
+            ],
+          },
+        },
+      ],
+    }
+    const [prepared] = prepareWaveformSeries(input)
+    const errorSeries: DisplaySeries = { ...prepared!, color: prepared!.color ?? '#1677ff' }
+
+    expect(prepared?.yDomain).toEqual([1, 11])
+    expect(layout([errorSeries]).yScale.domain()).toEqual([1, 11])
+  })
+})

package/src/components/interaction/useWaveformHover.ts

@@ -153,7 +153,8 @@ export function useWaveformHover(context: HoverContext) {
     scheduleHover(() => {
       const resolvedTrack = resolveTrackAtPointer(pointerX, pointerY)
       const referenceTrack =
-        resolvedTrack ?? trackLayouts.value.find((track) => track.hasVisibleSeries)
+        (resolvedTrack?.hasVisibleSeries ? resolvedTrack : undefined) ??
+        trackLayouts.value.find((track) => track.hasVisibleSeries)
       if (!referenceTrack) return
       const localPointerX = Math.max(
         0,