waveform-analysis 0.1.31 → 0.1.35

package/dist/types/components/WaveformChart.vue.d.ts

@@ -5,7 +5,7 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     "point-hover": (point: import("..").WaveformPoint | null) => any;
     "zoom-change": (domain: [number, number]) => any;
     "zoom-end": (payload: import("..").WaveformZoomEndPayload) => any;
-    "zoom-reset": () => any;
+    "zoom-reset": (payload: import("..").WaveformZoomResetPayload) => any;
     "update:annotations": (annotations: import("..").WaveformAnnotation[]) => any;
     "update:hidden-series-ids": (ids: string[]) => any;
     "series-visibility-change": (payload: {
@@ -21,7 +21,7 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     "onPoint-hover"?: ((point: import("..").WaveformPoint | null) => any) | undefined;
     "onZoom-change"?: ((domain: [number, number]) => any) | undefined;
     "onZoom-end"?: ((payload: import("..").WaveformZoomEndPayload) => any) | undefined;
-    "onZoom-reset"?: (() => any) | undefined;
+    "onZoom-reset"?: ((payload: import("..").WaveformZoomResetPayload) => any) | undefined;
     "onUpdate:annotations"?: ((annotations: import("..").WaveformAnnotation[]) => any) | undefined;
     "onUpdate:hidden-series-ids"?: ((ids: string[]) => any) | undefined;
     "onSeries-visibility-change"?: ((payload: {
@@ -44,6 +44,7 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     zoomable: boolean;
     pannable: boolean;
     minVisiblePoints: number;
+    xDomainStrategy: import("..").WaveformXDomainStrategy;
     timeUnit: "s" | "ms";
     annotationsVisible: boolean;
     grid: import("..").WaveformGridOptions;

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

@@ -1,6 +1,6 @@
 import { type ZoomTransform } from 'd3';
 import { type ResolvedWaveformRenderingOptions } from '../../core/rendering';
-import type { WaveformDisplayMode, WaveformOverlayMode, WaveformXAxisLabelFormatter } from '../../types';
+import type { WaveformDisplayMode, WaveformOverlayMode, WaveformXDomainStrategy, WaveformXAxisLabelFormatter } from '../../types';
 import { type GridCellGeometry, type NormalizedWaveformGridOptions } from './grid';
 import type { DisplayTrack, TrackLayout } from './types';
 interface SeriesGridCell extends GridCellGeometry {
@@ -15,6 +15,7 @@ export interface BuildTrackLayoutsOptions {
     sharedZoomDomain: [number, number];
     initialXDomain?: [number, number];
     initialXDomains?: Record<string, [number, number]>;
+    xDomainStrategy?: WaveformXDomainStrategy;
     fixedYDomain?: [number, number];
     fixedYDomains?: Record<string, [number, number]>;
     yDomains?: Record<string, [number, number]>;

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

@@ -330,6 +330,7 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     minZoomSpan?: number | undefined;
     minVisiblePoints: number;
     initialXDomains?: Record<string, [number, number]> | undefined;
+    xDomainStrategy: import("../..").WaveformXDomainStrategy;
     yDomain?: [number, number] | undefined;
     yDomains?: Record<string, [number, number]> | undefined;
     timeUnit: "s" | "ms";

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

@@ -1,4 +1,4 @@
-import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformFrameStyle, WaveformInteractionMode, WaveformLegendOptions, WaveformOverlayMode, WaveformPlotMargin, WaveformPoint, WaveformRenderingOptions, WaveformTitleOptions, WaveformZeroLineOptions, WaveformZoomEndPayload } from '../data/types';
+import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformFrameStyle, WaveformInteractionMode, WaveformLegendOptions, WaveformOverlayMode, WaveformPlotMargin, WaveformPoint, WaveformRenderingOptions, WaveformTitleOptions, WaveformXDomainStrategy, WaveformZeroLineOptions, WaveformZoomEndPayload, WaveformZoomResetPayload } from '../data/types';
 import type { WaveformGridOptions } from './grid';
 export interface WaveformChartProps {
     data: WaveformData;
@@ -16,6 +16,7 @@ export interface WaveformChartProps {
     minVisiblePoints?: number;
     initialXDomain?: [number, number];
     initialXDomains?: Record<string, [number, number]>;
+    xDomainStrategy?: WaveformXDomainStrategy;
     yDomain?: [number, number];
     yDomains?: Record<string, [number, number]>;
     timeUnit?: 's' | 'ms';
@@ -36,13 +37,13 @@ export interface WaveformChartProps {
     presentationMode?: boolean;
     zeroLine?: WaveformZeroLineOptions;
 }
-type DefaultedProp = 'displayMode' | 'overlayMode' | 'yLabel' | 'lineColor' | 'showTooltip' | 'zoomable' | 'pannable' | 'minVisiblePoints' | 'timeUnit' | 'annotations' | 'annotationsVisible' | 'grid' | 'rendering' | 'plotMargin' | 'legend' | 'defaultHiddenSeriesIds' | 'cleanView' | 'presentationMode' | 'zeroLine';
+type DefaultedProp = 'displayMode' | 'overlayMode' | 'yLabel' | 'lineColor' | 'showTooltip' | 'zoomable' | 'pannable' | 'minVisiblePoints' | 'xDomainStrategy' | 'timeUnit' | 'annotations' | 'annotationsVisible' | 'grid' | 'rendering' | 'plotMargin' | 'legend' | 'defaultHiddenSeriesIds' | 'cleanView' | 'presentationMode' | 'zeroLine';
 export type ResolvedWaveformChartProps = Readonly<WaveformChartProps & Required<Pick<WaveformChartProps, DefaultedProp>>>;
 export interface WaveformChartEmit {
     (event: 'point-hover', point: WaveformPoint | null): void;
     (event: 'zoom-change', domain: [number, number]): void;
     (event: 'zoom-end', payload: WaveformZoomEndPayload): void;
-    (event: 'zoom-reset'): void;
+    (event: 'zoom-reset', payload: WaveformZoomResetPayload): void;
     (event: 'update:annotations', annotations: WaveformAnnotation[]): void;
     (event: 'update:hidden-series-ids', ids: string[]): void;
     (event: 'series-visibility-change', payload: {

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

@@ -0,0 +1,3 @@
+import type { WaveformXDomainStrategy } from '../../types';
+/** Derives a viewport domain without changing any source coordinates. */
+export declare function applyXDomainStrategy(domain: [number, number], strategy: WaveformXDomainStrategy, explicit?: boolean): [number, number];

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

@@ -2,6 +2,6 @@
  * 数据系统类型定义
  * 重新导出 src/types 中的类型，方便组件内部使用
  */
-export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformZoomEndPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformAxesOptions, WaveformZeroLineOptions, SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from '../../types';
+export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformAxesOptions, WaveformZeroLineOptions, SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from '../../types';
 export type { WaveformGridOptions, WaveformGridLineOptions, WaveformGridTrackLines, } from '../core/grid';
 export { normalizeWaveformData, normalizeWaveformSeries } from '../../core';

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

@@ -2,5 +2,5 @@
  * 向后兼容的导出文件
  * 保留原有导入路径，内部从新的模块结构导出
  */
-export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformFrameStyle, SingleWaveformData, WaveformSeries, WaveformLineStyle, WaveformData, NormalizedWaveformSeries, } from '../types';
+export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformFrameStyle, SingleWaveformData, WaveformSeries, WaveformLineStyle, WaveformData, NormalizedWaveformSeries, } from '../types';
 export { normalizeWaveformData, normalizeWaveformSeries } from '../core';

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@
  * @packageDocumentation
  */
 export { default as WaveformChart } from './components/WaveformChart.vue';
-export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformZoomEndPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformZeroLineOptions, SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from './types';
+export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformZeroLineOptions, SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from './types';
 export type { WaveformGridOptions, WaveformGridLineOptions, WaveformGridTrackLines, } from './components/core/grid';
 export { normalizeWaveformData, normalizeWaveformSeries } from './core';
 export { paddedDomain, buildMinorTicks, displayTime, formatEndpointTime, formatAxisTime, formatTooltipTime, resolveTrackGeometry, clamp, type TimeUnit, type TrackGeometry, } from './utils';

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

@@ -22,6 +22,16 @@ export type WaveformDisplayMode = 'independent' | 'separated' | 'compact';
 export type WaveformOverlayMode = 'single-axis' | 'multi-axis';
 /** 标注工具模式 */
 export type WaveformInteractionMode = 'zoom' | 'annotation';
+/** Controls how the initial X viewport is derived when no explicit domain is configured. */
+export interface WaveformXDomainStrategy {
+    type: 'data' | 'nice';
+    /** Selects which bounds are expanded when type is `nice`. Defaults to `both`. */
+    bounds?: 'both' | 'end';
+    /** Stable tick count used to calculate nice bounds. Defaults to 10. */
+    tickCount?: number;
+    /** Applies the strategy to explicit initial domains. Defaults to false. */
+    includeExplicit?: boolean;
+}
 /** Describes the X-axis viewport after a zoom gesture completes. */
 export interface WaveformZoomEndPayload {
     start: number;
@@ -33,6 +43,11 @@ export interface WaveformZoomEndPayload {
     seriesIds?: string[];
     gesture?: 'wheel' | 'box';
 }
+/** Identifies the viewport reset by a double-click gesture. */
+export interface WaveformZoomResetPayload {
+    trackIndex?: number;
+    seriesIds?: string[];
+}
 /** 标注颜色样式 */
 export interface WaveformAnnotationStyle {
     borderColor?: string;

package/dist/types/types/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * 类型定义统一导出
  */
-export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformZoomEndPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformZeroLineOptions, } from './chart';
+export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformZeroLineOptions, } from './chart';
 export type { SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from './data';

package/package.json

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

package/src/components/WaveformChart.vue

@@ -16,6 +16,7 @@ const props = withDefaults(defineProps<WaveformChartProps>(), {
   zoomable: true,
   pannable: false,
   minVisiblePoints: 0,
+  xDomainStrategy: () => ({ type: 'data' }),
   timeUnit: 'ms',
   frameNumber: undefined,
   annotations: () => [],

package/src/components/core/trackLayoutBuilder.ts

@@ -16,6 +16,7 @@ import type {
   WaveformDisplayMode,
   WaveformOverlayMode,
   WaveformPoint,
+  WaveformXDomainStrategy,
   WaveformXAxisLabelFormatter,
 } from '../../types'
 import { buildMinorTicks, formatXAxisLabel } from '../../utils'
@@ -26,6 +27,7 @@ import {
 } from './grid'
 import { axisTextMetrics, resolveYAxisSeriesGroups } from './layout'
 import type { DisplaySeries, DisplayTrack, TrackLayout, WaveformYAxisLayout } from './types'
+import { applyXDomainStrategy } from './xDomain'
 import {
   Y_AXIS_LABEL_BAND_WIDTH,
   Y_AXIS_LABEL_GAP,
@@ -46,6 +48,7 @@ export interface BuildTrackLayoutsOptions {
   sharedZoomDomain: [number, number]
   initialXDomain?: [number, number]
   initialXDomains?: Record<string, [number, number]>
+  xDomainStrategy?: WaveformXDomainStrategy
   fixedYDomain?: [number, number]
   fixedYDomains?: Record<string, [number, number]>
   yDomains?: Record<string, [number, number]>
@@ -57,6 +60,21 @@ export interface BuildTrackLayoutsOptions {
   showCompactEmptyTracks: boolean
 }
 
+function resolveIndependentXDomain(
+  track: DisplayTrack,
+  seriesId: string,
+  options: BuildTrackLayoutsOptions,
+): [number, number] {
+  const strategy = options.xDomainStrategy ?? { type: 'data' }
+  const explicitDomain =
+    options.initialXDomains?.[track.id] ??
+    options.initialXDomains?.[seriesId] ??
+    options.initialXDomain
+  return explicitDomain
+    ? applyXDomainStrategy(explicitDomain, strategy, true)
+    : applyXDomainStrategy(track.xDomain, strategy)
+}
+
 export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayout[] {
   const visibleCells = options.cells.map((cell) => ({ ...cell, hasSeries: Boolean(cell.series) }))
   const bottomCells = getBottomRowCellIndexes(visibleCells, options.grid.columnCount)
@@ -88,13 +106,7 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
     const series = displayTrack.visibleSeries[0] ?? displayTrack.series[0] ?? emptySeries
     const baseXScale =
       options.displayMode === 'independent'
-        ? scaleLinear(
-            options.initialXDomains?.[displayTrack.id] ??
-              options.initialXDomains?.[series.id] ??
-              options.initialXDomain ??
-              displayTrack.xDomain,
-            [0, cell.width],
-          )
+        ? scaleLinear(resolveIndependentXDomain(displayTrack, series.id, options), [0, cell.width])
         : scaleLinear(options.sharedZoomDomain, [0, cell.width])
     const transform =
       options.displayMode === 'independent'

package/src/components/core/useWaveformChartLifecycle.ts

@@ -204,6 +204,7 @@ export function useWaveformChartLifecycle(context: LifecycleContext) {
       () => props.minVisiblePoints,
       () => props.initialXDomain,
       () => props.initialXDomains,
+      () => props.xDomainStrategy,
       () => props.displayMode,
       () => chartTracks.value.length,
       currentPage,

package/src/components/core/useWaveformLayout.ts

@@ -34,6 +34,7 @@ import {
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types'
 import type { PreparedWaveformSeries } from './useWaveformData'
 import type { ResolvedWaveformChartProps } from './waveformChartTypes'
+import { applyXDomainStrategy } from './xDomain'
 import type { useWaveformAnnotationInteraction } from '../annotation'
 
 interface LayoutContext {
@@ -224,9 +225,13 @@ export function useWaveformLayout(context: LayoutContext) {
       Number.isFinite(domain[1]) &&
       domain[0] !== domain[1]
     ) {
-      return domain[0] < domain[1] ? domain : [domain[1], domain[0]]
+      return applyXDomainStrategy(
+        domain[0] < domain[1] ? domain : [domain[1], domain[0]],
+        props.xDomainStrategy,
+        true,
+      )
     }
-    return sharedXDomain.value
+    return applyXDomainStrategy(sharedXDomain.value, props.xDomainStrategy)
   })
   const resolveInitialTrackDomain = (track: TrackLayout): [number, number] => {
     const configuredDomain =
@@ -239,11 +244,18 @@ export function useWaveformLayout(context: LayoutContext) {
       Number.isFinite(configuredDomain[1]) &&
       configuredDomain[0] !== configuredDomain[1]
     ) {
-      return configuredDomain[0] < configuredDomain[1]
-        ? configuredDomain
-        : [configuredDomain[1], configuredDomain[0]]
+      return applyXDomainStrategy(
+        configuredDomain[0] < configuredDomain[1]
+          ? configuredDomain
+          : [configuredDomain[1], configuredDomain[0]],
+        props.xDomainStrategy,
+        true,
+      )
     }
-    return paddedDomain(track.seriesList.flatMap((series) => series.xDomain))
+    return applyXDomainStrategy(
+      paddedDomain(track.seriesList.flatMap((series) => series.xDomain)),
+      props.xDomainStrategy,
+    )
   }
   const sharedZoomDomain = computed(
     () =>
@@ -272,6 +284,7 @@ export function useWaveformLayout(context: LayoutContext) {
       sharedZoomDomain: sharedZoomDomain.value,
       initialXDomain: props.initialXDomain ? initialXDomain.value : undefined,
       initialXDomains: props.initialXDomains,
+      xDomainStrategy: props.xDomainStrategy,
       fixedYDomain: props.yDomain,
       fixedYDomains: props.yDomains,
       yDomains:

package/src/components/core/waveformChartTypes.ts

@@ -11,8 +11,10 @@ import type {
   WaveformPoint,
   WaveformRenderingOptions,
   WaveformTitleOptions,
+  WaveformXDomainStrategy,
   WaveformZeroLineOptions,
   WaveformZoomEndPayload,
+  WaveformZoomResetPayload,
 } from '../data/types'
 import type { WaveformGridOptions } from './grid'
 
@@ -32,6 +34,7 @@ export interface WaveformChartProps {
   minVisiblePoints?: number
   initialXDomain?: [number, number]
   initialXDomains?: Record<string, [number, number]>
+  xDomainStrategy?: WaveformXDomainStrategy
   yDomain?: [number, number]
   yDomains?: Record<string, [number, number]>
   timeUnit?: 's' | 'ms'
@@ -62,6 +65,7 @@ type DefaultedProp =
   | 'zoomable'
   | 'pannable'
   | 'minVisiblePoints'
+  | 'xDomainStrategy'
   | 'timeUnit'
   | 'annotations'
   | 'annotationsVisible'
@@ -82,7 +86,7 @@ export interface WaveformChartEmit {
   (event: 'point-hover', point: WaveformPoint | null): void
   (event: 'zoom-change', domain: [number, number]): void
   (event: 'zoom-end', payload: WaveformZoomEndPayload): void
-  (event: 'zoom-reset'): void
+  (event: 'zoom-reset', payload: WaveformZoomResetPayload): void
   (event: 'update:annotations', annotations: WaveformAnnotation[]): void
   (event: 'update:hidden-series-ids', ids: string[]): void
   (

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

@@ -0,0 +1,28 @@
+import { describe, expect, it } from 'vitest'
+
+import { applyXDomainStrategy } from './xDomain'
+
+describe('applyXDomainStrategy', () => {
+  it('keeps the exact data domain by default', () => {
+    expect(applyXDomainStrategy([0, 4999.999], { type: 'data' })).toEqual([0, 4999.999])
+  })
+
+  it('expands both bounds to stable nice values', () => {
+    expect(applyXDomainStrategy([123, 456], { type: 'nice' })).toEqual([100, 500])
+  })
+
+  it('can expand only the end bound', () => {
+    expect(applyXDomainStrategy([123, 456], { type: 'nice', bounds: 'end' })).toEqual([123, 500])
+  })
+
+  it('keeps explicit domains exact unless they are included', () => {
+    expect(applyXDomainStrategy([123, 456], { type: 'nice' }, true)).toEqual([123, 456])
+    expect(applyXDomainStrategy([123, 456], { type: 'nice', includeExplicit: true }, true)).toEqual(
+      [100, 500],
+    )
+  })
+
+  it('falls back to the default tick count for invalid values', () => {
+    expect(applyXDomainStrategy([0, 4999.999], { type: 'nice', tickCount: 0 })).toEqual([0, 5000])
+  })
+})

package/src/components/core/xDomain.ts

@@ -0,0 +1,25 @@
+import { scaleLinear } from 'd3'
+
+import type { WaveformXDomainStrategy } from '../../types'
+
+const DEFAULT_NICE_TICK_COUNT = 10
+
+function resolveTickCount(value: number | undefined): number {
+  if (!Number.isFinite(value) || (value ?? 0) < 1) return DEFAULT_NICE_TICK_COUNT
+  return Math.max(1, Math.trunc(value as number))
+}
+
+/** Derives a viewport domain without changing any source coordinates. */
+export function applyXDomainStrategy(
+  domain: [number, number],
+  strategy: WaveformXDomainStrategy,
+  explicit = false,
+): [number, number] {
+  if (strategy.type !== 'nice' || (explicit && !strategy.includeExplicit)) return [...domain]
+
+  const niceDomain = scaleLinear()
+    .domain(domain)
+    .nice(resolveTickCount(strategy.tickCount))
+    .domain() as [number, number]
+  return strategy.bounds === 'end' ? [domain[0], niceDomain[1]] : niceDomain
+}

package/src/components/data/types.ts

@@ -9,7 +9,9 @@ export type {
   WaveformDisplayMode,
   WaveformOverlayMode,
   WaveformInteractionMode,
+  WaveformXDomainStrategy,
   WaveformZoomEndPayload,
+  WaveformZoomResetPayload,
   WaveformAnnotationStyle,
   WaveformAnnotation,
   WaveformRenderingOptions,

package/src/components/interaction/useWaveformViewport.ts

@@ -346,9 +346,23 @@ export function useWaveformViewport(context: ViewportContext) {
   }
   const requestViewportReset = (event: MouseEvent) => {
     if (isPresentationMode.value || !props.zoomable || !isZoomMode.value) return
+    if (props.displayMode === 'independent') {
+      const target = event.target instanceof Element ? event.target : null
+      const overlay = target?.closest('[data-independent-overlay-index]')
+      const trackIndex = Number(overlay?.getAttribute('data-independent-overlay-index'))
+      const track = trackLayouts.value.find((item) => item.index === trackIndex)
+      if (!track) return
+      event.preventDefault()
+      resetViewport(trackIndex)
+      emit('zoom-reset', {
+        trackIndex,
+        seriesIds: track.legendSeries.map((series) => series.id),
+      })
+      return
+    }
     event.preventDefault()
     resetViewport()
-    emit('zoom-reset')
+    emit('zoom-reset', {})
   }
   return {
     selectionBox,

package/src/components/waveform.ts

@@ -9,6 +9,7 @@ export type {
   WaveformDisplayMode,
   WaveformOverlayMode,
   WaveformInteractionMode,
+  WaveformXDomainStrategy,
   WaveformAnnotationStyle,
   WaveformAnnotation,
   WaveformRenderingOptions,

package/src/components/waveformChartCases/viewportConstraintsAndReset.test.ts

@@ -308,69 +308,4 @@ describe('WaveformChart', () => {
     expect(wrapper.emitted('zoom-change')?.length ?? 0).toBe(eventCount + 1)
     expect(zoomedOutDomain).toEqual([0, 2])
   })
-
-  it('resets a shared viewport on double-click and emits zoom-reset', async () => {
-    const wrapper = await mountSizedChart({
-      kind: 'points',
-      points: [
-        { x: 0, y: 0 },
-        { x: 2, y: 1 },
-      ],
-    })
-    const overlay = wrapper.get('.waveform-chart__overlay')
-    const width = Number(overlay.attributes('width'))
-    Object.defineProperty(overlay.element, 'getBoundingClientRect', {
-      value: () => ({ left: 0, top: 0, width, height: 290 }),
-    })
-    overlay.element.dispatchEvent(
-      new WheelEvent('wheel', {
-        deltaY: -4000,
-        clientX: width / 2,
-        clientY: 145,
-        bubbles: true,
-        cancelable: true,
-      }),
-    )
-    flushAnimationFrames()
-    await flushPromises()
-    expect(wrapper.get('.waveform-chart__axis-endpoint--start').text()).not.toBe('0')
-
-    overlay.element.dispatchEvent(new MouseEvent('dblclick', { bubbles: true, cancelable: true }))
-    await flushPromises()
-
-    expect(wrapper.emitted('zoom-reset')).toHaveLength(1)
-    expect(wrapper.get('.waveform-chart__axis-endpoint--start').text()).toBe('0')
-    expect(wrapper.get('.waveform-chart__axis-endpoint--end').text()).toBe('2000')
-  })
-
-  it('exposes resetViewport for independent tracks', async () => {
-    const wrapper = await mountSizedChart(gridSeries(2), {
-      displayMode: 'independent',
-      grid: { rowCount: 1, columnCount: 2 },
-    })
-    const overlay = wrapper.findAll('.waveform-chart__overlay--independent')[0]
-    const width = Number(overlay.attributes('width'))
-    Object.defineProperty(overlay.element, 'getBoundingClientRect', {
-      value: () => ({ left: 0, top: 0, width, height: 260 }),
-    })
-    overlay.element.dispatchEvent(
-      new WheelEvent('wheel', {
-        deltaY: -4000,
-        clientX: width / 2,
-        clientY: 130,
-        bubbles: true,
-        cancelable: true,
-      }),
-    )
-    flushAnimationFrames()
-    await flushPromises()
-    expect(wrapper.findAll('.waveform-chart__axis-endpoint--start')[0].text()).not.toBe('0')
-
-    const chart = wrapper.vm as unknown as { resetViewport: () => void }
-    chart.resetViewport()
-    await flushPromises()
-
-    expect(wrapper.findAll('.waveform-chart__axis-endpoint--start')[0].text()).toBe('0')
-    expect(wrapper.findAll('.waveform-chart__axis-endpoint--end')[0].text()).toBe('1000')
-  })
 })