waveform-analysis 0.1.24 → 0.1.26

package/dist/types/App.vue.d.ts

@@ -0,0 +1,4 @@
+import 'vue3-colorpicker/style.css';
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/DemoRouterApp.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -1,20 +1,23 @@
 import type { WaveformOverlayMode } from '../../types';
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types';
+import { type WaveformYDomain } from './yDomain';
 export { MAX_MULTI_Y_AXIS_COUNT, Y_AXIS_EXPONENT_GAP } from './constants';
-interface YAxisSeriesGroup {
+export interface YAxisSeriesGroup {
     index: number;
     side: 'left' | 'right';
     seriesList: DisplaySeries[];
     domain: [number, number];
+    fixed: boolean;
 }
 export declare function buildYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode): YAxisSeriesGroup[];
-export declare function axisTextMetrics(domain: [number, number]): {
+export declare function resolveYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>): YAxisSeriesGroup[];
+export declare function axisTextMetrics(domain: [number, number], nice?: boolean): {
     exponentLabel: string | null;
     exponentWidth: number;
     tickTextWidth: number;
 };
 export declare function measureYAxisGroupClearance(group: YAxisSeriesGroup): number;
-export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayMode: WaveformOverlayMode): {
+export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>): {
     left: number;
     right: number;
 };

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

@@ -15,6 +15,8 @@ export interface BuildTrackLayoutsOptions {
     sharedZoomDomain: [number, number];
     initialXDomain?: [number, number];
     initialXDomains?: Record<string, [number, number]>;
+    fixedYDomain?: [number, number];
+    fixedYDomains?: Record<string, [number, number]>;
     yDomains?: Record<string, [number, number]>;
     timeUnit: 's' | 'ms';
     rendering: ResolvedWaveformRenderingOptions;

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

@@ -338,6 +338,8 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     minZoomSpan?: number | undefined;
     minVisiblePoints: number;
     initialXDomains?: Record<string, [number, number]> | undefined;
+    yDomain?: [number, number] | undefined;
+    yDomains?: Record<string, [number, number]> | undefined;
     timeUnit: "s" | "ms";
     frameNumber?: string | number | undefined;
     frameStyle?: import("..").WaveformFrameStyle | undefined;

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

@@ -16,6 +16,8 @@ export interface WaveformChartProps {
     minVisiblePoints?: number;
     initialXDomain?: [number, number];
     initialXDomains?: Record<string, [number, number]>;
+    yDomain?: [number, number];
+    yDomains?: Record<string, [number, number]>;
     timeUnit?: 's' | 'ms';
     frameNumber?: string | number;
     frameStyle?: WaveformFrameStyle;

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

@@ -0,0 +1,7 @@
+import type { DisplaySeries, DisplayTrack } from './types';
+export type WaveformYDomain = [number, number];
+export declare function normalizeYDomain(domain: readonly [number, number] | undefined): WaveformYDomain | undefined;
+export declare function resolveTrackFixedYDomain(track: Pick<DisplayTrack, 'id'>, yDomains?: Record<string, WaveformYDomain>): WaveformYDomain | undefined;
+export declare function resolveSeriesFixedYDomain(series: Pick<DisplaySeries, 'id'>, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>): WaveformYDomain | undefined;
+export declare function hasFixedYDomainForTrack(track: Pick<DisplayTrack, 'id' | 'visibleSeries'>, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>): boolean;
+export declare function mergeYDomains(domains: readonly WaveformYDomain[]): WaveformYDomain;

package/dist/types/demo/DemoChartHost.vue.d.ts

@@ -0,0 +1,14 @@
+import type { DemoChartModel } from './types';
+declare function resetViewport(): void;
+type __VLS_ModelProps = {
+    'model': DemoChartModel;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {
+    resetViewport: typeof resetViewport;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:model": (value: DemoChartModel) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:model"?: ((value: DemoChartModel) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/demo/DemoControlPanel.vue.d.ts

@@ -0,0 +1,11 @@
+import type { DemoControlPanelModel } from './types';
+type __VLS_ModelProps = {
+    'model': DemoControlPanelModel;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:model": (value: DemoControlPanelModel) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:model"?: ((value: DemoControlPanelModel) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/demo/DemoGridFrameControls.vue.d.ts

@@ -0,0 +1,11 @@
+import type { DemoControlPanelModel } from './types';
+type __VLS_ModelProps = {
+    'model': DemoControlPanelModel;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:model": (value: DemoControlPanelModel) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:model"?: ((value: DemoControlPanelModel) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/demo/DemoTitleLegendControls.vue.d.ts

@@ -0,0 +1,11 @@
+import type { DemoControlPanelModel } from './types';
+type __VLS_ModelProps = {
+    'model': DemoControlPanelModel;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:model": (value: DemoControlPanelModel) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:model"?: ((value: DemoControlPanelModel) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/demo/DemoViewControls.vue.d.ts

@@ -0,0 +1,11 @@
+import type { DemoControlPanelModel } from './types';
+type __VLS_ModelProps = {
+    'model': DemoControlPanelModel;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:model": (value: DemoControlPanelModel) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:model"?: ((value: DemoControlPanelModel) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/demo/types.d.ts

@@ -0,0 +1,84 @@
+import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformFrameStyle, WaveformGridTrackLines, WaveformInteractionMode, WaveformLegendOrientation, WaveformLegendPosition, WaveformLineStyle, WaveformOverlayMode, WaveformTitleOptions, WaveformZeroLineOptions, WaveformZoomEndPayload } from '../components';
+interface SelectOption<T> {
+    label: string;
+    value: T;
+}
+export interface DemoControlPanelModel {
+    controlsOpen: boolean;
+    displayMode: WaveformDisplayMode;
+    overlayMode: WaveformOverlayMode;
+    showTooltip: boolean;
+    cleanView: boolean;
+    presentationMode: boolean;
+    selectedSeriesId: string;
+    selectedLineStyle: WaveformLineStyle;
+    lineStyleOptions: Array<SelectOption<WaveformLineStyle>>;
+    seriesStyleOptions: Array<SelectOption<string>>;
+    zeroLineVisible: boolean;
+    zeroLineColor: string;
+    zeroLineWidth: number;
+    zeroLineDash: string;
+    zeroLineDashOptions: Array<SelectOption<string>>;
+    rowCount: number;
+    columnCount: number;
+    horizontalGridVisible: boolean;
+    horizontalGridColor: string;
+    verticalGridVisible: boolean;
+    verticalGridColor: string;
+    xAxisLineVisible: boolean;
+    yAxisLineVisible: boolean;
+    frameBorderColor: string;
+    frameBackgroundColor: string;
+    frameBorderWidth: number;
+    frameBorderStyle: NonNullable<WaveformFrameStyle['borderStyle']>;
+    frameBorderStyleOptions: Array<SelectOption<string>>;
+    frameWatermarkVisible: boolean;
+    titleVisible: boolean;
+    titleText: string;
+    titleAlign: NonNullable<WaveformTitleOptions['align']>;
+    titleAlignOptions: Array<SelectOption<NonNullable<WaveformTitleOptions['align']>>>;
+    titleFontFamily: string;
+    titleFontFamilyOptions: Array<SelectOption<string>>;
+    titleFontSize: number;
+    titleBold: boolean;
+    titleItalic: boolean;
+    titleUnderline: boolean;
+    titleRotation: number;
+    titleColor: string;
+    legendPosition: WaveformLegendPosition;
+    legendPositionOptions: Array<SelectOption<WaveformLegendPosition>>;
+    legendOrientation: WaveformLegendOrientation;
+    legendOrientationOptions: Array<SelectOption<WaveformLegendOrientation>>;
+    legendBackgroundColor: string;
+    closeControls: () => void;
+    resetTitleTextStyle: () => void;
+    resetWaveformViewport: () => void;
+}
+export interface DemoChartModel {
+    data: WaveformData;
+    minZoomSpan?: number;
+    initialXDomain?: [number, number];
+    displayMode: WaveformDisplayMode;
+    overlayMode: WaveformOverlayMode;
+    rowCount: number;
+    columnCount: number;
+    gridTrackLines: WaveformGridTrackLines;
+    title: WaveformTitleOptions;
+    legendPosition: WaveformLegendPosition;
+    legendOrientation: WaveformLegendOrientation;
+    legendBackgroundColor: string;
+    frameStyle: WaveformFrameStyle;
+    axes: WaveformAxesOptions;
+    cleanView: boolean;
+    presentationMode: boolean;
+    showTooltip: boolean;
+    zeroLine: WaveformZeroLineOptions;
+    frameWatermarkVisible: boolean;
+    annotations: WaveformAnnotation[];
+    annotationsVisible: boolean;
+    interactionMode: WaveformInteractionMode;
+    hiddenSeriesIds: string[];
+    handleZoomEnd: (payload: WaveformZoomEndPayload) => void | Promise<void>;
+    resetWaveformViewport: () => void;
+}
+export {};

package/dist/types/router.d.ts

@@ -0,0 +1,3 @@
+import { type RouteRecordRaw } from 'vue-router';
+export declare const routes: RouteRecordRaw[];
+export declare const router: import("vue-router").Router;

package/dist/types/views/FixedYDomainDemo.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waveform-analysis",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/types/index.d.ts",
@@ -24,6 +24,7 @@
   "dependencies": {
     "ant-design-vue": "3.2.20",
     "d3": "^7.9.0",
+    "vue-router": "^4.6.4",
     "vue3-colorpicker": "^2.3.0"
   },
   "peerDependencies": {

package/src/DemoRouterApp.vue

@@ -0,0 +1,14 @@
+<template>
+  <div class="demo-shell">
+    <header class="demo-shell__header">
+      <RouterLink class="demo-shell__brand" to="/">Waveform Analysis</RouterLink>
+      <nav class="demo-shell__nav" aria-label="示例导航">
+        <RouterLink to="/">综合示例</RouterLink>
+        <RouterLink to="/fixed-y-domain">固定振幅范围</RouterLink>
+      </nav>
+    </header>
+    <div class="demo-shell__content">
+      <RouterView />
+    </div>
+  </div>
+</template>

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

@@ -0,0 +1,116 @@
+import { zoomIdentity } from 'd3'
+import { describe, expect, it } from 'vitest'
+
+import { DEFAULT_WAVEFORM_RENDERING_OPTIONS } from '../../core'
+import type { DisplaySeries, DisplayTrack } from './types'
+import { buildTrackLayouts, resolveYAxisSeriesGroups } from './layout'
+
+function series(id: string, minimum: number, maximum: 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: minimum },
+      { x: 1, y: maximum },
+    ],
+    xDomain: [0, 1],
+    yDomain: [minimum, maximum],
+    hasErrorPoints: false,
+  }
+}
+
+function track(seriesList: DisplaySeries[]): DisplayTrack {
+  return {
+    id: 'track',
+    series: seriesList,
+    visibleSeries: seriesList,
+    xDomain: [0, 1],
+    yDomain: [0, 100],
+  }
+}
+
+describe('fixed Y-domain layout', () => {
+  it('uses an exact global fixed domain without applying nice bounds', () => {
+    const sourceTrack = track([series('a', 0, 100)])
+    const result = buildTrackLayouts({
+      cells: [
+        {
+          slotIndex: 0,
+          row: 0,
+          column: 0,
+          left: 0,
+          top: 0,
+          width: 120,
+          height: 100,
+          plotHeight: 100,
+          cellHeight: 130,
+          xAxisBand: 30,
+          series: sourceTrack,
+        },
+      ],
+      grid: { rowCount: 1, columnCount: 1, showPagination: false, trackLines: {} },
+      displayMode: 'independent',
+      overlayMode: 'single-axis',
+      independentTransforms: [zoomIdentity],
+      sharedZoomDomain: [0, 1],
+      fixedYDomain: [3, 97],
+      timeUnit: 'ms',
+      rendering: DEFAULT_WAVEFORM_RENDERING_OPTIONS,
+      hideSecondaryLabels: false,
+      yAxisLabelX: -50,
+      showCompactEmptyTracks: false,
+    })[0]
+
+    expect(result?.yScale.domain()).toEqual([3, 97])
+    expect(result?.yAxes[0]?.tickValues).toContain(3)
+    expect(result?.yAxes[0]?.tickValues).toContain(97)
+    expect(result?.seriesPaths[0]?.yScale.domain()).toEqual([3, 97])
+  })
+
+  it('resolves track, series, and global fixed-domain precedence', () => {
+    const sourceTrack = track([series('a', 0, 10), series('b', 20, 30)])
+
+    expect(
+      resolveYAxisSeriesGroups(sourceTrack, 'single-axis', [-5, 5], {
+        a: [-10, 10],
+        track: [300, 100],
+      })[0]?.domain,
+    ).toEqual([100, 300])
+
+    expect(
+      resolveYAxisSeriesGroups(sourceTrack, 'single-axis', [-5, 5], {
+        a: [-10, 10],
+      })[0]?.domain,
+    ).toEqual([-10, 10])
+  })
+
+  it('keeps per-series fixed domains on separate axes and merges axis overflow', () => {
+    const sourceTrack = track([
+      series('a', 0, 1),
+      series('b', 10, 11),
+      series('c', 20, 21),
+      series('d', 30, 31),
+      series('e', 40, 41),
+    ])
+    const groups = resolveYAxisSeriesGroups(sourceTrack, 'multi-axis', undefined, {
+      a: [-1, 1],
+      b: [-2, 2],
+      c: [-3, 3],
+      d: [-4, 4],
+      e: [-5, 5],
+    })
+
+    expect(groups.map((group) => group.domain)).toEqual([
+      [-1, 1],
+      [-2, 2],
+      [-3, 3],
+      [-5, 5],
+    ])
+    expect(groups.every((group) => group.fixed)).toBe(true)
+  })
+})

package/src/components/core/layout.ts

@@ -4,6 +4,12 @@ import type { WaveformOverlayMode } from '../../types'
 import { formatScientificAxisExponent, formatScientificAxisLabel, paddedDomain } from '../../utils'
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types'
 import { MAX_MULTI_Y_AXIS_COUNT, Y_AXIS_EXPONENT_GAP } from './constants'
+import {
+  mergeYDomains,
+  resolveSeriesFixedYDomain,
+  resolveTrackFixedYDomain,
+  type WaveformYDomain,
+} from './yDomain'
 
 // 导出常量供外部使用
 export { MAX_MULTI_Y_AXIS_COUNT, Y_AXIS_EXPONENT_GAP } from './constants'
@@ -14,11 +20,12 @@ const Y_AXIS_OUTER_PADDING = 4
 const Y_AXIS_LABEL_GAP = 6
 const Y_AXIS_LABEL_BAND_WIDTH = 24
 
-interface YAxisSeriesGroup {
+export interface YAxisSeriesGroup {
   index: number
   side: 'left' | 'right'
   seriesList: DisplaySeries[]
   domain: [number, number]
+  fixed: boolean
 }
 
 function resolveAxisSides(axisCount: number): Array<'left' | 'right'> {
@@ -53,6 +60,7 @@ export function buildYAxisSeriesGroups(
     side: sides[index],
     seriesList: [] as DisplaySeries[],
     domain: [0, 1] as [number, number],
+    fixed: false,
   }))
 
   track.visibleSeries.forEach((series, index) => {
@@ -72,12 +80,35 @@ export function buildYAxisSeriesGroups(
   return grouped
 }
 
-export function axisTextMetrics(domain: [number, number]): {
+export function resolveYAxisSeriesGroups(
+  track: DisplayTrack,
+  overlayMode: WaveformOverlayMode,
+  yDomain?: WaveformYDomain,
+  yDomains?: Record<string, WaveformYDomain>,
+): YAxisSeriesGroup[] {
+  const trackDomain = resolveTrackFixedYDomain(track, yDomains)
+  return buildYAxisSeriesGroups(track, overlayMode).map((group) => {
+    if (trackDomain) return { ...group, domain: trackDomain, fixed: true }
+    const seriesDomains = group.seriesList.map(
+      (series) => resolveSeriesFixedYDomain(series, yDomain, yDomains) ?? series.yDomain,
+    )
+    const fixed = group.seriesList.some((series) =>
+      resolveSeriesFixedYDomain(series, yDomain, yDomains),
+    )
+    return fixed ? { ...group, domain: mergeYDomains(seriesDomains), fixed } : group
+  })
+}
+
+export function axisTextMetrics(
+  domain: [number, number],
+  nice = true,
+): {
   exponentLabel: string | null
   exponentWidth: number
   tickTextWidth: number
 } {
-  const scale = scaleLinear(domain, [1, 0]).nice()
+  const scale = scaleLinear(domain, [1, 0])
+  if (nice) scale.nice()
   const [axisMin, axisMax] = scale.domain()
   const values = scale.ticks(10)
   const maximumTickCharacters = Math.max(
@@ -92,15 +123,15 @@ export function axisTextMetrics(domain: [number, number]): {
   }
 }
 
-function axisExponentClearance(domain: [number, number]): number {
-  const { exponentLabel, exponentWidth } = axisTextMetrics(domain)
+function axisExponentClearance(domain: [number, number], nice: boolean): number {
+  const { exponentLabel, exponentWidth } = axisTextMetrics(domain, nice)
   return exponentLabel ? exponentWidth + Y_AXIS_EXPONENT_GAP : 0
 }
 
 export function measureYAxisGroupClearance(group: YAxisSeriesGroup): number {
   return (
-    axisTextMetrics(group.domain).tickTextWidth +
-    axisExponentClearance(group.domain) +
+    axisTextMetrics(group.domain, !group.fixed).tickTextWidth +
+    axisExponentClearance(group.domain, !group.fixed) +
     Y_AXIS_TICK_PADDING +
     Y_AXIS_LABEL_GAP +
     Y_AXIS_LABEL_BAND_WIDTH +
@@ -110,8 +141,8 @@ export function measureYAxisGroupClearance(group: YAxisSeriesGroup): number {
 
 function measureYAxisGroupTickClearance(group: YAxisSeriesGroup): number {
   return (
-    axisTextMetrics(group.domain).tickTextWidth +
-    axisExponentClearance(group.domain) +
+    axisTextMetrics(group.domain, !group.fixed).tickTextWidth +
+    axisExponentClearance(group.domain, !group.fixed) +
     Y_AXIS_TICK_PADDING +
     Y_AXIS_OUTER_PADDING
   )
@@ -120,8 +151,10 @@ function measureYAxisGroupTickClearance(group: YAxisSeriesGroup): number {
 export function measureTrackYAxisClearance(
   track: DisplayTrack,
   overlayMode: WaveformOverlayMode,
+  yDomain?: WaveformYDomain,
+  yDomains?: Record<string, WaveformYDomain>,
 ): { left: number; right: number } {
-  return buildYAxisSeriesGroups(track, overlayMode).reduce(
+  return resolveYAxisSeriesGroups(track, overlayMode, yDomain, yDomains).reduce(
     (clearance, group) => {
       clearance[group.side] +=
         overlayMode === 'multi-axis' || track.visibleSeries.length === 1

package/src/components/core/trackLayoutBuilder.ts

@@ -19,7 +19,7 @@ import {
   type GridCellGeometry,
   type NormalizedWaveformGridOptions,
 } from './grid'
-import { axisTextMetrics, buildYAxisSeriesGroups } from './layout'
+import { axisTextMetrics, resolveYAxisSeriesGroups } from './layout'
 import type { DisplaySeries, DisplayTrack, TrackLayout, WaveformYAxisLayout } from './types'
 import { Y_AXIS_EXPONENT_GAP } from './constants'
 import {
@@ -42,6 +42,8 @@ export interface BuildTrackLayoutsOptions {
   sharedZoomDomain: [number, number]
   initialXDomain?: [number, number]
   initialXDomains?: Record<string, [number, number]>
+  fixedYDomain?: [number, number]
+  fixedYDomains?: Record<string, [number, number]>
   yDomains?: Record<string, [number, number]>
   timeUnit: 's' | 'ms'
   rendering: ResolvedWaveformRenderingOptions
@@ -94,13 +96,18 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
         : zoomIdentity
     const xScale = transform.rescaleX(baseXScale)
     const configuredYDomain = options.yDomains?.[displayTrack.id]
-    const yAxisGroups = buildYAxisSeriesGroups(displayTrack, options.overlayMode).map((group) => ({
-      ...group,
-      domain: configuredYDomain ?? group.domain,
-    }))
+    const yAxisGroups = resolveYAxisSeriesGroups(
+      displayTrack,
+      options.overlayMode,
+      options.fixedYDomain,
+      options.fixedYDomains,
+    ).map((group) =>
+      !group.fixed && configuredYDomain ? { ...group, domain: configuredYDomain } : group,
+    )
     const sideOffsets = { left: 0, right: 0 }
     const yAxes: WaveformYAxisLayout[] = yAxisGroups.map((group) => {
-      const scale = scaleLinear(group.domain, [cell.plotHeight, 0]).nice()
+      const scale = scaleLinear(group.domain, [cell.plotHeight, 0])
+      if (!group.fixed) scale.nice()
       const majorTicks = scale.ticks(Math.max(2, Math.floor(cell.plotHeight / 55)))
       const [axisStart, axisEnd] = scale.domain()
       const showAxisEnd = options.displayMode !== 'compact' || cell.row === 0
@@ -110,7 +117,10 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
       const tickValues = Array.from(
         new Set([axisStart, ...visibleMajorTicks, ...(showAxisEnd ? [axisEnd] : [])]),
       )
-      const { exponentLabel, exponentWidth, tickTextWidth } = axisTextMetrics(group.domain)
+      const { exponentLabel, exponentWidth, tickTextWidth } = axisTextMetrics(
+        group.domain,
+        !group.fixed,
+      )
       const exponentClearance = exponentLabel ? exponentWidth + Y_AXIS_EXPONENT_GAP : 0
       const clearance =
         tickTextWidth +

package/src/components/core/useWaveformChartController.ts

@@ -6,6 +6,7 @@ import {
   shallowReactive,
   shallowRef,
   toRefs,
+  watch,
   watchEffect,
   type ComponentPublicInstance,
   type Ref,
@@ -68,6 +69,15 @@ export function useWaveformChartController(
   const annotationInteraction = useWaveformAnnotationInteraction()
   const editorSeriesOptions = ref<AnnotationSeriesCandidate[]>([])
   const hoverThrottle = useAnimationFrameThrottle()
+
+  watch(
+    [() => props.yDomain, () => props.yDomains],
+    () => {
+      sharedYDomains.value = {}
+      independentYDomains.value = {}
+    },
+    { deep: true },
+  )
   const selection = ref<ViewportSelectionState | null>(null)
   const spacePressed = ref(false)
   const pointerInsideChart = ref(false)

package/src/components/core/useWaveformLayout.ts

@@ -26,7 +26,12 @@ import {
   resolveGridCellGeometry,
   X_AXIS_BAND,
 } from './grid'
-import { buildTrackLayouts, measureTrackYAxisClearance, Y_AXIS_EXPONENT_GAP } from './layout'
+import {
+  buildTrackLayouts,
+  measureTrackYAxisClearance,
+  resolveYAxisSeriesGroups,
+  Y_AXIS_EXPONENT_GAP,
+} from './layout'
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types'
 import type { PreparedWaveformSeries } from './useWaveformData'
 import type { ResolvedWaveformChartProps } from './waveformChartTypes'
@@ -104,8 +109,12 @@ export function useWaveformLayout(context: LayoutContext) {
   const yAxisMetrics = computed(() => {
     const axisText = chartTracks.value
       .filter((track) => track.visibleSeries.length > 0)
-      .map((track) => {
-        const scale = scaleLinear(track.yDomain, [1, 0]).nice()
+      .flatMap((track) =>
+        resolveYAxisSeriesGroups(track, props.overlayMode, props.yDomain, props.yDomains),
+      )
+      .map((group) => {
+        const scale = scaleLinear(group.domain, [1, 0])
+        if (!group.fixed) scale.nice()
         const [axisMin, axisMax] = scale.domain()
         return {
           exponentLabel: formatScientificAxisExponent(axisMin, axisMax),
@@ -165,7 +174,12 @@ export function useWaveformLayout(context: LayoutContext) {
   const multiAxisClearance = computed(() =>
     chartTracks.value.reduce(
       (maximum, track) => {
-        const clearance = measureTrackYAxisClearance(track, props.overlayMode)
+        const clearance = measureTrackYAxisClearance(
+          track,
+          props.overlayMode,
+          props.yDomain,
+          props.yDomains,
+        )
         return {
           left: Math.max(maximum.left, clearance.left),
           right: Math.max(maximum.right, clearance.right),
@@ -281,6 +295,8 @@ export function useWaveformLayout(context: LayoutContext) {
       sharedZoomDomain: sharedZoomDomain.value,
       initialXDomain: props.initialXDomain ? initialXDomain.value : undefined,
       initialXDomains: props.initialXDomains,
+      fixedYDomain: props.yDomain,
+      fixedYDomains: props.yDomains,
       yDomains:
         props.displayMode === 'independent'
           ? Object.fromEntries(

package/src/components/core/waveformChartTypes.ts

@@ -31,6 +31,8 @@ export interface WaveformChartProps {
   minVisiblePoints?: number
   initialXDomain?: [number, number]
   initialXDomains?: Record<string, [number, number]>
+  yDomain?: [number, number]
+  yDomains?: Record<string, [number, number]>
   timeUnit?: 's' | 'ms'
   frameNumber?: string | number
   frameStyle?: WaveformFrameStyle