waveform-analysis 0.1.47 → 0.1.48

package/dist/index.js

@@ -1135,7 +1135,7 @@ function pn(e) {
 			right: 0
 		}, p = d.map((n) => {
 			let r = yn(t.plotHeight, e.yAxisSplitNumber), i = Math.max(1, r - 1), a = V(n.domain, [t.plotHeight, 0]);
-			a.nice(i);
+			e.yAxisNice !== !1 && a.nice(i);
 			let [o, s] = a.domain(), c = Array.from({ length: r }, (e, t) => o + (s - o) * t / (r - 1)), l = e.displayMode !== "compact" || t.row === 0 ? c : c.slice(0, -1), { tickTextWidth: u } = wn(a.domain(), !1, l, n.seriesList[0]?.unit, r), d = u + 7 + 0 + 12 + 4, p = n.side === "left" ? -f.left : t.width + f.right, m = u + 7 + 0 + 12 / 2, h = p + (n.side === "left" ? -m : m);
 			return f[n.side] += d, {
 				index: n.index,
@@ -1148,14 +1148,16 @@ function pn(e) {
 				tickValues: l,
 				seriesList: n.seriesList
 			};
-		}), m = p[0]?.scale ?? V(a.yDomain, [t.plotHeight, 0]).nice(), h = l.ticks(Math.max(2, Math.floor(t.width / 100))), g = p[0]?.majorTicks ?? [], _ = p[0]?.tickValues ?? [], v = l.domain(), y = {
-			start: ut(v[0], v, e.timeUnit, "start", e.xAxisLabelFormatter),
-			end: ut(v[1], v, e.timeUnit, "end", e.xAxisLabelFormatter)
-		}, b = y.start.length * 7 + 10, x = y.end.length * 7 + 10, S = h.filter((e) => {
+		}), m = V(a.yDomain, [t.plotHeight, 0]);
+		e.yAxisNice !== !1 && m.nice();
+		let h = p[0]?.scale ?? m, g = l.ticks(Math.max(2, Math.floor(t.width / 100))), _ = p[0]?.majorTicks ?? [], v = p[0]?.tickValues ?? [], y = l.domain(), b = {
+			start: ut(y[0], y, e.timeUnit, "start", e.xAxisLabelFormatter),
+			end: ut(y[1], y, e.timeUnit, "end", e.xAxisLabelFormatter)
+		}, x = b.start.length * 7 + 10, S = b.end.length * 7 + 10, C = g.filter((e) => {
 			let n = l(e);
-			return n > b && n < t.width - x;
-		}), C = a.visibleSeries.map((n) => {
-			let r = p.find((e) => e.seriesList.some((e) => e.id === n.id)), a = r?.scale ?? m, o = Qt(n.points, v, t.width, e.rendering, {
+			return n > x && n < t.width - S;
+		}), w = a.visibleSeries.map((n) => {
+			let r = p.find((e) => e.seriesList.some((e) => e.id === n.id)), a = r?.scale ?? h, o = Qt(n.points, y, t.width, e.rendering, {
 				lineVisible: !i && n.lineType !== "none",
 				pointVisible: n.pointType !== "none",
 				errorBarVisible: n.errorBar.visible,
@@ -1186,17 +1188,17 @@ function pn(e) {
 			width: t.width,
 			height: t.plotHeight,
 			xScale: l,
-			yScale: m,
+			yScale: h,
 			yAxes: p,
-			xMajorTicks: h,
-			xMinorTicks: Xe(h, 3, v),
-			yMajorTicks: g,
+			xMajorTicks: g,
+			xMinorTicks: Xe(g, 3, y),
+			yMajorTicks: _,
 			yMinorTicks: p[0]?.minorTicks ?? [],
-			yAxisTickValues: _,
-			xAxisTickValues: S,
-			endpointLabels: y,
-			path: C[0]?.path ?? null,
-			seriesPaths: C,
+			yAxisTickValues: v,
+			xAxisTickValues: C,
+			endpointLabels: b,
+			path: w[0]?.path ?? null,
+			seriesPaths: w,
 			gridLines: e.grid.trackLines[a.id] ?? {
 				horizontal: !0,
 				vertical: !0
@@ -1273,14 +1275,14 @@ function wn(e, t = !0, n, r, i = 10) {
 		unit: r
 	}).length)) * mn };
 }
-function Tn(e, t) {
-	return wn(e.domain, !0, void 0, e.seriesList[0]?.unit, t).tickTextWidth + hn + _n + vn + gn;
+function Tn(e, t, n = !0) {
+	return wn(e.domain, n, void 0, e.seriesList[0]?.unit, t).tickTextWidth + hn + _n + vn + gn;
 }
-function En(e, t) {
-	return wn(e.domain, !0, void 0, e.seriesList[0]?.unit, t).tickTextWidth + hn + gn;
+function En(e, t, n = !0) {
+	return wn(e.domain, n, void 0, e.seriesList[0]?.unit, t).tickTextWidth + hn + gn;
 }
-function Dn(e, t, n, r, i) {
-	return Cn(e, t, n, r).reduce((n, r) => (n[r.side] += t === "multi-axis" || e.visibleSeries.length === 1 ? Tn(r, i) : En(r, i), n), {
+function Dn(e, t, n, r, i, a = !0) {
+	return Cn(e, t, n, r).reduce((n, r) => (n[r.side] += t === "multi-axis" || e.visibleSeries.length === 1 ? Tn(r, i, a) : En(r, i, a), n), {
 		left: 0,
 		right: 0
 	});
@@ -2258,14 +2260,17 @@ function rr(e) {
 			};
 		});
 	}), _ = t(() => Ut(n.rendering)), v = t(() => rn(g.value.length, h.value)), y = t(() => an(g.value, i.value, h.value)), b = t(() => {
-		let e = g.value.filter((e) => e.visibleSeries.length > 0).flatMap((e) => Cn(e, n.overlayMode, n.yDomain, n.yDomains)).map((e) => wn(e.domain, !0, void 0, e.seriesList[0]?.unit, n.axes?.y?.splitNumber).tickTextWidth), t = Math.max(7, ...e), r = t + 7 + 4, i = -(7 + t + 0 + 12 / 2);
+		let e = y.value.filter((e) => e.series.length > 0);
+		return h.value.fillIncompleteLastRow && e.length > 0 ? e : y.value;
+	}), x = t(() => {
+		let e = g.value.filter((e) => e.visibleSeries.length > 0).flatMap((e) => Cn(e, n.overlayMode, n.yDomain, n.yDomains)).map((e) => wn(e.domain, n.axes?.y?.nice !== !1, void 0, e.seriesList[0]?.unit, n.axes?.y?.splitNumber).tickTextWidth), t = Math.max(7, ...e), r = t + 7 + 4, i = -(7 + t + 0 + 12 / 2);
 		return {
 			tickClearance: r,
 			fullClearance: t + 7 + 0 + 12 + 4,
 			labelCenterX: i
 		};
-	}), x = t(() => g.value.some((e) => e.visibleSeries.length === 1 && !!(e.visibleSeries[0]?.name.trim() || n.yLabel))), S = t(() => g.value.some((e) => e.visibleSeries.length > 0)), C = t(() => Math.max(_t.left, x.value ? b.value.fullClearance : S.value ? b.value.tickClearance : 0)), w = t(() => g.value.reduce((e, t) => {
-		let r = Dn(t, n.overlayMode, n.yDomain, n.yDomains, n.axes?.y?.splitNumber);
+	}), S = t(() => g.value.some((e) => e.visibleSeries.length === 1 && !!(e.visibleSeries[0]?.name.trim() || n.yLabel))), C = t(() => g.value.some((e) => e.visibleSeries.length > 0)), w = t(() => Math.max(_t.left, S.value ? x.value.fullClearance : C.value ? x.value.tickClearance : 0)), T = t(() => g.value.reduce((e, t) => {
+		let r = Dn(t, n.overlayMode, n.yDomain, n.yDomains, n.axes?.y?.splitNumber, n.axes?.y?.nice !== !1);
 		return {
 			left: Math.max(e.left, r.left),
 			right: Math.max(e.right, r.right)
@@ -2273,34 +2278,34 @@ function rr(e) {
 	}, {
 		left: 0,
 		right: 0
-	})), T = t(() => n.overlayMode === "multi-axis" ? Math.max(C.value, w.value.left) : C.value), E = t(() => n.overlayMode === "multi-axis" ? Math.max(_t.right, w.value.right) : _t.right), D = t(() => Math.max(0, o.value - T.value - E.value)), O = t(() => {
-		let e = on(n.displayMode), t = h.value.columnCount, r = t > 1, i = Math.max(e, b.value.fullClearance), a = Math.max(e, b.value.tickClearance), o = (D.value - i * Math.max(0, t - 1)) / t >= 120;
+	})), E = t(() => n.overlayMode === "multi-axis" ? Math.max(w.value, T.value.left) : w.value), D = t(() => n.overlayMode === "multi-axis" ? Math.max(_t.right, T.value.right) : _t.right), O = t(() => Math.max(0, o.value - E.value - D.value)), k = t(() => {
+		let e = on(n.displayMode), t = h.value.columnCount, r = t > 1, i = Math.max(e, x.value.fullClearance), a = Math.max(e, x.value.tickClearance), o = (O.value - i * Math.max(0, t - 1)) / t >= 120;
 		return {
-			horizontalGap: n.overlayMode === "multi-axis" && r && S.value ? Math.max(e, w.value.left + w.value.right) : r && S.value ? x.value && o ? i : a : e,
-			hideSecondaryLabels: n.overlayMode !== "multi-axis" && r && x.value && !o
+			horizontalGap: n.overlayMode === "multi-axis" && r && C.value ? Math.max(e, T.value.left + T.value.right) : r && C.value ? S.value && o ? i : a : e,
+			hideSecondaryLabels: n.overlayMode !== "multi-axis" && r && S.value && !o
 		};
-	}), k = t(() => m.value.length > 0), A = t(() => D.value > 0 && s.value > 0), j = t(() => n.xLabel ?? `时间（${n.timeUnit}）`), M = t(() => n.interactionMode), N = t(() => M.value === "zoom" || M.value === void 0), P = t(() => {
+	}), A = t(() => m.value.length > 0), j = t(() => O.value > 0 && s.value > 0), M = t(() => n.xLabel ?? `时间（${n.timeUnit}）`), N = t(() => n.interactionMode), P = t(() => N.value !== "annotation"), F = t(() => {
 		let e = [];
 		return g.value.forEach((t) => {
 			t.visibleSeries.length && e.push(t.xDomain[0], t.xDomain[1]);
 		}), $(e);
-	}), F = t(() => {
+	}), I = t(() => {
 		let e = n.initialXDomain;
-		return e && Number.isFinite(e[0]) && Number.isFinite(e[1]) && e[0] !== e[1] ? dn(e[0] < e[1] ? e : [e[1], e[0]], n.xDomainStrategy, !0) : dn(P.value, n.xDomainStrategy);
-	}), I = (e) => {
+		return e && Number.isFinite(e[0]) && Number.isFinite(e[1]) && e[0] !== e[1] ? dn(e[0] < e[1] ? e : [e[1], e[0]], n.xDomainStrategy, !0) : dn(F.value, n.xDomainStrategy);
+	}), L = (e) => {
 		let t = n.initialXDomains?.[e.series?.trackId ?? e.series?.id ?? e.id] ?? (e.series ? n.initialXDomains?.[e.series.id] : void 0) ?? n.initialXDomain;
 		return t && Number.isFinite(t[0]) && Number.isFinite(t[1]) && t[0] !== t[1] ? dn(t[0] < t[1] ? t : [t[1], t[0]], n.xDomainStrategy, !0) : dn($(e.seriesList.flatMap((e) => e.xDomain)), n.xDomainStrategy);
-	}, L = t(() => l.value.rescaleX(V(F.value, [0, D.value])).domain()), R = t(() => sn(D.value, s.value, h.value, n.displayMode, y.value.map(Boolean), O.value.horizontalGap).map((e, t) => ({
+	}, R = t(() => l.value.rescaleX(V(I.value, [0, O.value])).domain()), z = t(() => sn(O.value, s.value, h.value, n.displayMode, b.value.map(Boolean), k.value.horizontalGap).map((e, t) => ({
 		...e,
-		series: y.value[t]
-	}))), z = t(() => pn({
-		cells: R.value,
+		series: b.value[t]
+	}))), B = t(() => pn({
+		cells: z.value,
 		grid: h.value,
 		displayMode: n.displayMode,
 		overlayMode: n.overlayMode,
 		independentTransforms: u.value,
-		sharedZoomDomain: L.value,
-		initialXDomain: n.initialXDomain ? F.value : void 0,
+		sharedZoomDomain: R.value,
+		initialXDomain: n.initialXDomain ? I.value : void 0,
 		initialXDomains: n.initialXDomains,
 		xDomainStrategy: n.xDomainStrategy,
 		fixedYDomain: n.yDomain,
@@ -2312,38 +2317,39 @@ function rr(e) {
 		timeUnit: n.timeUnit,
 		xAxisLabelFormatter: n.axes?.x?.labelFormatter,
 		yAxisSplitNumber: n.axes?.y?.splitNumber,
+		yAxisNice: n.axes?.y?.nice,
 		rendering: _.value,
-		hideSecondaryLabels: c.value || O.value.hideSecondaryLabels,
-		yAxisLabelX: b.value.labelCenterX,
-		showCompactEmptyTracks: n.displayMode === "compact" && k.value
-	})), B = (e) => e.seriesList.map((t) => ({
+		hideSecondaryLabels: c.value || k.value.hideSecondaryLabels,
+		yAxisLabelX: x.value.labelCenterX,
+		showCompactEmptyTracks: n.displayMode === "compact" && A.value
+	})), H = (e) => e.seriesList.map((t) => ({
 		...e,
 		series: t,
 		yScale: e.seriesPaths.find((e) => e.series.id === t.id)?.yScale ?? e.yScale
-	})), H = (e, t) => e.seriesPaths.find((e) => e.series.id === t)?.yScale ?? e.yScale, U = t(() => z.value.flatMap(B));
+	})), U = (e, t) => e.seriesPaths.find((e) => e.series.id === t)?.yScale ?? e.yScale, ee = t(() => B.value.flatMap(H));
 	return {
 		chartSeries: m,
 		chartTracks: g,
 		gridOptions: h,
 		pageCount: v,
 		pagedTracks: y,
-		resolvedChartLeftMargin: T,
-		innerWidth: D,
-		hasVisibleWaveformData: S,
-		hasWaveformData: k,
-		hasChartArea: A,
-		resolvedXLabel: j,
-		activeInteractionMode: M,
-		isZoomMode: N,
-		initialXDomain: F,
-		sharedZoomDomain: L,
-		resolveInitialTrackDomain: I,
-		gridCells: R,
-		trackLayouts: z,
-		annotationLayoutsForTrack: B,
-		resolveSeriesYScale: H,
-		annotationTrackLayouts: U,
-		renderedAnnotations: t(() => n.annotationsVisible ? ge(n.annotations, U.value, D.value, s.value) : []),
+		resolvedChartLeftMargin: E,
+		innerWidth: O,
+		hasVisibleWaveformData: C,
+		hasWaveformData: A,
+		hasChartArea: j,
+		resolvedXLabel: M,
+		activeInteractionMode: N,
+		isZoomMode: P,
+		initialXDomain: I,
+		sharedZoomDomain: R,
+		resolveInitialTrackDomain: L,
+		gridCells: z,
+		trackLayouts: B,
+		annotationLayoutsForTrack: H,
+		resolveSeriesYScale: U,
+		annotationTrackLayouts: ee,
+		renderedAnnotations: t(() => n.annotationsVisible ? ge(n.annotations, ee.value, O.value, s.value) : []),
 		editorSeries: t(() => {
 			let e = p.editorDraft.value?.annotation.seriesId, t = m.value.find((t) => t.id === e);
 			return t ? {

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/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.47",
+  "version": "0.1.48",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/types/index.d.ts",

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

@@ -55,6 +55,7 @@ export interface BuildTrackLayoutsOptions {
   timeUnit: 's' | 'ms'
   xAxisLabelFormatter?: WaveformXAxisLabelFormatter
   yAxisSplitNumber?: number
+  yAxisNice?: boolean
   rendering: ResolvedWaveformRenderingOptions
   hideSecondaryLabels: boolean
   yAxisLabelX: number
@@ -119,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 },
@@ -158,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/useWaveformLayout.ts

@@ -112,6 +112,12 @@ export function useWaveformLayout(context: LayoutContext) {
   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)
@@ -122,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,
@@ -173,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),
@@ -223,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) => {
@@ -285,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({
@@ -315,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])
+  })
+})