waveform-analysis 0.1.57 → 0.1.59

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

@@ -4,6 +4,7 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     setViewportDomain: (domain: [number, number], trackIndex?: number) => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     "point-hover": (point: import("..").WaveformPoint | null) => any;
+    "zoom-intent": (payload: import("..").WaveformZoomIntentPayload) => any;
     "zoom-change": (domain: [number, number]) => any;
     "zoom-end": (payload: import("..").WaveformZoomEndPayload) => any;
     "zoom-reset": (payload: import("..").WaveformZoomResetPayload) => any;
@@ -27,6 +28,7 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     "sampling-error": (error: import("..").WaveformSamplingError) => any;
 }, string, import("vue").PublicProps, Readonly<WaveformChartProps> & Readonly<{
     "onPoint-hover"?: ((point: import("..").WaveformPoint | null) => any) | undefined;
+    "onZoom-intent"?: ((payload: import("..").WaveformZoomIntentPayload) => any) | undefined;
     "onZoom-change"?: ((domain: [number, number]) => any) | undefined;
     "onZoom-end"?: ((payload: import("..").WaveformZoomEndPayload) => any) | undefined;
     "onZoom-reset"?: ((payload: import("..").WaveformZoomResetPayload) => any) | undefined;

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

@@ -9,6 +9,8 @@ export interface WaveformGridOptions {
     fillIncompleteLastRow?: boolean;
     /** Stable grid slots. Empty IDs remain as empty chart frames and keep their page position. */
     trackOrder?: string[];
+    /** Omits ordered tracks without waveform series from layout and pagination. */
+    hideEmptyTracks?: boolean;
     trackLines?: WaveformGridTrackLines;
 }
 export interface WaveformGridLineOptions {
@@ -32,6 +34,7 @@ export interface NormalizedWaveformGridOptions {
     showPagination: boolean;
     fillIncompleteLastRow: boolean;
     trackOrder?: string[];
+    hideEmptyTracks?: boolean;
     trackLines: Record<string, NormalizedWaveformGridLineOptions>;
 }
 export interface GridCellGeometry {

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

@@ -0,0 +1,4 @@
+import type { DisplayTrack } from './types';
+export declare const resolvePageableTracks: (tracks: DisplayTrack[], hideEmptyTracks?: boolean) => DisplayTrack[];
+export declare const resolveTrackFrameNumber: (frameNumber: string | number | undefined, frameNumbers: Record<string, string | number> | undefined, trackCount: number, trackIndex: number, trackId: string) => string | number | undefined;
+export declare const createFrameNumberResolver: (getFrameNumber: () => string | number | undefined, getFrameNumbers: () => Record<string, string | number> | undefined, getTracks: () => DisplayTrack[]) => (trackId: string) => string | number | undefined;

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

@@ -246,6 +246,7 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     confirmAnnotation: (annotation: import("..").WaveformAnnotation) => void;
     chartSeries: import("./types").DisplaySeries[];
     chartTracks: import("./types").DisplayTrack[];
+    pageableTracks: import("./types").DisplayTrack[];
     renderingOptions: import("../..").ResolvedWaveformRenderingOptions;
     gridOptions: import("./grid").NormalizedWaveformGridOptions;
     pageCount: number;
@@ -281,7 +282,7 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     annotationTrackLayouts: import("../annotation").AnnotationTrackLayout[];
     renderedAnnotations: import("../annotation").RenderedAnnotation[];
     editorSeries: import("../annotation").AnnotationSeriesInfo | undefined;
-    resolveFrameNumber: (trackIndex: number) => string | number | undefined;
+    resolveFrameNumber: (trackId: string) => string | number | undefined;
     fixedWidth: number | undefined;
     fixedHeight: number | undefined;
     chartWidth: number;
@@ -341,6 +342,7 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     yDomains?: Record<string, [number, number]> | undefined;
     timeUnit: "s" | "ms";
     frameNumber?: string | number | undefined;
+    frameNumbers?: Record<string, string | number> | undefined;
     frameStyle?: import("..").WaveformFrameStyle | undefined;
     axes?: import("..").WaveformAxesOptions | undefined;
     annotations: import("..").WaveformAnnotation[];

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

@@ -1,7 +1,6 @@
 import { type ZoomTransform } from 'd3';
 import { type ComputedRef, type Ref, type ShallowRef } from 'vue';
-import type { AnnotationSeriesCandidate } from '../annotation';
-import type { useWaveformAnnotationInteraction } from '../annotation';
+import type { AnnotationSeriesCandidate, useWaveformAnnotationInteraction } from '../annotation';
 import type { NormalizedWaveformGridOptions } from './grid';
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types';
 import type { ResolvedWaveformChartProps, WaveformChartEmit } from './waveformChartTypes';

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

@@ -23,6 +23,7 @@ interface LayoutContext {
 export declare function useWaveformLayout(context: LayoutContext): {
     chartSeries: ComputedRef<DisplaySeries[]>;
     chartTracks: ComputedRef<DisplayTrack[]>;
+    pageableTracks: ComputedRef<DisplayTrack[]>;
     renderingOptions: ComputedRef<import("../..").ResolvedWaveformRenderingOptions>;
     gridOptions: ComputedRef<import("./grid").NormalizedWaveformGridOptions>;
     pageCount: ComputedRef<number>;
@@ -58,6 +59,6 @@ export declare function useWaveformLayout(context: LayoutContext): {
     annotationTrackLayouts: ComputedRef<AnnotationTrackLayout[]>;
     renderedAnnotations: ComputedRef<import("../annotation").RenderedAnnotation[]>;
     editorSeries: ComputedRef<AnnotationSeriesInfo | undefined>;
-    resolveFrameNumber: (trackIndex: number) => string | number | undefined;
+    resolveFrameNumber: (trackId: string) => string | number | undefined;
 };
 export {};

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, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformTitleOptions, WaveformXDomainStrategy, WaveformZeroLineOptions, WaveformZoomEndPayload, WaveformZoomResetPayload } from '../data/types';
+import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformFrameStyle, WaveformInteractionMode, WaveformLegendOptions, WaveformOverlayMode, WaveformPlotMargin, WaveformPoint, WaveformRenderingOptions, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformTitleOptions, WaveformXDomainStrategy, WaveformZeroLineOptions, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformZoomResetPayload } from '../data/types';
 import type { WaveformGridOptions } from './grid';
 export interface WaveformChartProps {
     data: WaveformData;
@@ -22,6 +22,8 @@ export interface WaveformChartProps {
     yDomains?: Record<string, [number, number]>;
     timeUnit?: 's' | 'ms';
     frameNumber?: string | number;
+    /** Per-track frame watermark overrides, keyed by stable trackId. */
+    frameNumbers?: Record<string, string | number>;
     frameStyle?: WaveformFrameStyle;
     axes?: WaveformAxesOptions;
     annotations?: WaveformAnnotation[];
@@ -42,6 +44,7 @@ type DefaultedProp = 'displayMode' | 'overlayMode' | 'yLabel' | 'lineColor' | 's
 export type ResolvedWaveformChartProps = Readonly<WaveformChartProps & Required<Pick<WaveformChartProps, DefaultedProp>>>;
 export interface WaveformChartEmit {
     (event: 'point-hover', point: WaveformPoint | null): void;
+    (event: 'zoom-intent', payload: WaveformZoomIntentPayload): void;
     (event: 'zoom-change', domain: [number, number]): void;
     (event: 'zoom-end', payload: WaveformZoomEndPayload): void;
     (event: 'zoom-reset', payload: WaveformZoomResetPayload): void;

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

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

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

@@ -1,5 +1,5 @@
 export { default as WaveformChart } from './WaveformChart.vue';
-export type { SingleWaveformData, WaveformData, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformZoomEndPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformAxesOptions, WaveformZeroLineOptions, WaveformPoint, WaveformSeries, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, WaveformGridOptions, WaveformGridLineOptions, WaveformGridTrackLines, } from './data/types';
+export type { SingleWaveformData, WaveformData, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformAxesOptions, WaveformZeroLineOptions, WaveformPoint, WaveformSeries, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, WaveformGridOptions, WaveformGridLineOptions, WaveformGridTrackLines, } from './data/types';
 export type { WaveformGridOptions as WaveformGridConfig } from './core/grid';
 export { WaveformTooltip } from './interaction';
 export { WaveformTrack } from './rendering';

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

@@ -22,9 +22,10 @@ interface ZoomContext {
 }
 export declare function useWaveformZoom(context: ZoomContext): {
     cancelPendingZoom: () => void;
-    clearZoomBindings: () => void;
+    clearZoomBindings: (preservePendingWheel?: boolean) => void;
     canZoomTrack: (track: TrackLayout) => boolean;
     canZoomSharedTracks: () => boolean;
     configureZoom: () => void;
+    prepareForDataChange: () => void;
 };
 export {};

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

@@ -0,0 +1,7 @@
+import type { TrackLayout } from '../core/types';
+import type { WaveformChartEmit } from '../core/waveformChartTypes';
+export declare function seriesIdentity(seriesIds: readonly string[]): string;
+export declare function findTrackBySeriesIds(trackLayouts: readonly TrackLayout[], seriesIds: readonly string[]): TrackLayout | undefined;
+export declare function emitBoxZoomIntent(emit: WaveformChartEmit, domain: [number, number], track: TrackLayout, independent: boolean): void;
+export declare function emitIndependentWheelZoomEnds(emit: WaveformChartEmit, trackLayouts: readonly TrackLayout[], pendingSeriesIds: Iterable<readonly string[]>): void;
+export declare function emitSharedWheelZoomEnd(emit: WaveformChartEmit, domain: [number, number], trackLayouts: readonly TrackLayout[]): void;

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

@@ -1,4 +1,4 @@
-import type { WaveformPoint } from '@/types';
+import type { WaveformPoint } from '../types';
 import type { ResolvedWaveformRenderingOptions } from './renderingOptions';
 import { type VisiblePointRange } from './renderingStrategies';
 export { DEFAULT_WAVEFORM_RENDERING_OPTIONS, resolveWaveformRenderingOptions, type ResolvedWaveformRenderingOptions, type ResolvedWaveformSamplingOptions, } from './renderingOptions';

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

@@ -1,4 +1,4 @@
-import type { WaveformRenderingOptions, WaveformSamplingMode, WaveformSamplingStrategy } from '@/types';
+import type { WaveformRenderingOptions, WaveformSamplingMode, WaveformSamplingStrategy } from '../types';
 export interface ResolvedWaveformSamplingOptions {
     mode: WaveformSamplingMode;
     autoThreshold: number;

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

@@ -1,4 +1,4 @@
-import type { InitInput } from '../../wasm/pkg/waveform_sampling_wasm';
+import type { InitInput } from '../wasm/waveform_sampling_wasm';
 import type { ReferenceSamplingStrategy } from './samplingReference';
 import type { WorkerSamplingBackend, WorkerSamplingOutput } from './workerSampling/protocol';
 export type WasmSamplingStrategy = ReferenceSamplingStrategy;

package/dist/types/core/workerSampling/multiresolution.d.ts

@@ -1,4 +1,4 @@
-import type { WaveformPoint } from '@/types';
+import type { WaveformPoint } from '../../types';
 import type { WorkerSamplingOutput } from './protocol';
 export type IndexedSamplingStrategy = 'none' | 'peak' | 'lttb' | 'average' | 'min' | 'max' | 'minmax' | 'sum';
 export interface MultiResolutionSamplingIndexOptions {

package/dist/types/core/workerSampling/protocol.d.ts

@@ -1,4 +1,4 @@
-import type { WaveformPoint, WaveformLineType, WaveformPointType, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingMode, WaveformSamplingStrategy } from '@/types';
+import type { WaveformPoint, WaveformLineType, WaveformPointType, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingMode, WaveformSamplingStrategy } from '../../types';
 import type { WorkerSamplingDataset } from '../waveformPointSource';
 export declare const DEFAULT_WORKER_SAMPLING_AUTO_THRESHOLD = 1000;
 export declare const DEFAULT_WORKER_SAMPLING_MAX_POINTS_PER_PIXEL = 4;

package/dist/types/core/workerSampling/repositoryDataset.d.ts

@@ -1,4 +1,4 @@
-import type { WaveformPoint } from '@/types';
+import type { WaveformPoint } from '../../types';
 import type { WorkerSamplingDataset } from '../waveformPointSource';
 import type { WasmDatasetSamplingBackend } from '../wasmSampling';
 import { MultiResolutionSamplingIndex } from './multiresolution';

package/dist/types/core/workerSampling/repositorySupport.d.ts

@@ -1,4 +1,4 @@
-import type { WaveformPoint } from '@/types';
+import type { WaveformPoint } from '../../types';
 import { type WorkerSamplingBackendKind, type WorkerSamplingDatasetMetrics, type WorkerSamplingDiagnostics, type WorkerSamplingOutput, type WorkerSamplingSeriesRequest, type WorkerSamplingStatus } from './protocol';
 export declare function copyFinitePoints(points: readonly WaveformPoint[]): WaveformPoint[];
 export declare function metricsFor(points: readonly WaveformPoint[], inputPointCount: number): WorkerSamplingDatasetMetrics;

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, WaveformXDomainStrategy, WaveformZoomEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformSamplingMode, WaveformSamplingStrategy, WaveformSamplingOptions, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformZeroLineOptions, SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformTypedValues, TypedSampleData, TypedPointData, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from './types';
+export type { WaveformPoint, WaveformDisplayMode, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformSamplingMode, WaveformSamplingStrategy, WaveformSamplingOptions, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformZeroLineOptions, SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformTypedValues, TypedSampleData, TypedPointData, 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

@@ -43,6 +43,14 @@ export interface WaveformZoomEndPayload {
     seriesIds?: string[];
     gesture?: 'wheel' | 'box';
 }
+/** Describes the X-axis viewport targeted by a user zoom gesture before rendering settles. */
+export interface WaveformZoomIntentPayload {
+    start: number;
+    end: number;
+    gesture: 'wheel' | 'box';
+    trackIndex?: number;
+    seriesIds?: string[];
+}
 /** Identifies the viewport reset by a double-click gesture. */
 export interface WaveformZoomResetPayload {
     trackIndex?: number;

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

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

package/dist/types/utils/geometry.d.ts

@@ -1,4 +1,4 @@
-import type { WaveformDisplayMode } from '@/types';
+import type { WaveformDisplayMode } from '../types';
 /**
  * 轨道几何信息
  */

package/dist/types/wasm/waveform_sampling_wasm.d.ts

@@ -0,0 +1,74 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * Returns [minimum X, maximum X, minimum Y, maximum Y], or an empty array for no valid points.
+ */
+export function calculate_range(x: Float64Array, y: Float64Array): Float64Array;
+
+export function dataset_index_bytes(handle: number): number;
+
+export function dispose_all_datasets(): void;
+
+export function dispose_dataset(handle: number): boolean;
+
+/**
+ * Returns the half-open [start, end) range in the normalized ascending-X point sequence.
+ */
+export function find_visible_range(x: Float64Array, y: Float64Array, domain_start: number, domain_end: number): Uint32Array;
+
+export function register_dataset(x: Float64Array, y: Float64Array, index_max_bytes: number): number;
+
+export function register_sample_dataset(y: Float64Array, source_indexes: Uint32Array, start_time: number, sample_rate: number, index_max_bytes: number): number;
+
+export function sample_aggregates(x: Float64Array, y: Float64Array, strategy: number, target: number): Float64Array;
+
+export function sample_dataset_aggregates(handle: number, start: number, end: number, strategy: number, target: number): Float64Array;
+
+export function sample_dataset_indexes(handle: number, start: number, end: number, strategy: number, target: number): Uint32Array;
+
+export function sample_indexes(x: Float64Array, y: Float64Array, strategy: number, target: number): Uint32Array;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly calculate_range: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+    readonly dispose_dataset: (a: number) => number;
+    readonly find_visible_range: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly register_dataset: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+    readonly register_sample_dataset: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
+    readonly sample_aggregates: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly sample_dataset_aggregates: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly sample_dataset_indexes: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly sample_indexes: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+    readonly dispose_all_datasets: () => void;
+    readonly dataset_index_bytes: (a: number) => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __wbindgen_malloc: (a: number, b: number) => number;
+    readonly __externref_table_dealloc: (a: number) => void;
+    readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;

package/dist/types/wasm/waveform_sampling_wasm_bg.wasm.d.ts

@@ -0,0 +1,19 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const calculate_range: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+export const dispose_dataset: (a: number) => number;
+export const find_visible_range: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+export const register_dataset: (a: number, b: number, c: number, d: number, e: number) => [number, number, number];
+export const register_sample_dataset: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number];
+export const sample_aggregates: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+export const sample_dataset_aggregates: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+export const sample_dataset_indexes: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+export const sample_indexes: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
+export const dispose_all_datasets: () => void;
+export const dataset_index_bytes: (a: number) => number;
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_start: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waveform-analysis",
-  "version": "0.1.57",
+  "version": "0.1.59",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/types/index.d.ts",
@@ -22,6 +22,7 @@
   ],
   "type": "module",
   "dependencies": {
+    "@types/d3": "7.4.3",
     "ant-design-vue": "3.2.20",
     "d3": "^7.9.0",
     "vue-router": "^4.6.4",
@@ -33,7 +34,6 @@
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
-    "@types/d3": "7.4.3",
     "@types/node": "26.1.1",
     "@vitejs/plugin-vue": "6.0.8",
     "@vitest/coverage-v8": "4.1.10",
@@ -57,7 +57,7 @@
     "build": "pnpm typecheck && pnpm build:lib && pnpm build:types && pnpm build:demo",
     "build:wasm": "wasm-pack build wasm --target web --release --out-dir pkg --locked",
     "build:lib": "vite build --config vite.lib.config.ts",
-    "build:types": "node scripts/clean-types.mjs && vue-tsc -p tsconfig.lib.json",
+    "build:types": "node scripts/clean-types.mjs && vue-tsc -p tsconfig.lib.json && node scripts/prepare-package-types.mjs",
     "build:demo": "vite build",
     "preview": "vite preview --outDir dist-demo",
     "typecheck": "pnpm build:wasm && vue-tsc -b",
@@ -68,6 +68,7 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "pnpm build:wasm && vitest run",
-    "test:coverage": "pnpm build:wasm && vitest run --coverage"
+    "test:coverage": "pnpm build:wasm && vitest run --coverage",
+    "test:package": "node scripts/test-package.mjs"
   }
 }

package/src/components/WaveformChartView.vue

@@ -80,7 +80,7 @@ const {
   pageCount,
   currentPage,
   getPageSize,
-  chartTracks,
+  pageableTracks,
   goToPage,
   annotationInteraction,
   editorDraft,
@@ -230,7 +230,7 @@ function handleChartPointerLeave() {
           :interactive="!isPresentationMode"
           :display-mode="displayMode"
           :interaction-mode="activeInteractionMode"
-          :frame-number="resolveFrameNumber(track.index)"
+          :frame-number="resolveFrameNumber(track.id)"
           :frame-style="frameStyle"
           :axes="axes"
           :clean-view="isCleanView"
@@ -326,7 +326,7 @@ function handleChartPointerLeave() {
       aria-label="波形分页"
       :current="currentPage"
       :page-size="getPageSize(gridOptions)"
-      :total="chartTracks.length"
+      :total="pageableTracks.length"
       :show-size-changer="false"
       :show-quick-jumper="false"
       @change="goToPage"

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

@@ -17,6 +17,7 @@ describe('waveform grid helpers', () => {
       showPagination: true,
       fillIncompleteLastRow: false,
       trackOrder: [],
+      hideEmptyTracks: false,
       trackLines: {},
     })
     expect(normalizeGridOptions({ rowCount: 0, columnCount: 99 })).toEqual({
@@ -25,8 +26,10 @@ describe('waveform grid helpers', () => {
       showPagination: true,
       fillIncompleteLastRow: false,
       trackOrder: [],
+      hideEmptyTracks: false,
       trackLines: {},
     })
+    expect(normalizeGridOptions({ hideEmptyTracks: true }).hideEmptyTracks).toBe(true)
   })
 
   it('normalizes track order by trimming, dropping blanks, and removing duplicates', () => {

package/src/components/core/grid.ts

@@ -11,6 +11,8 @@ export interface WaveformGridOptions {
   fillIncompleteLastRow?: boolean
   /** Stable grid slots. Empty IDs remain as empty chart frames and keep their page position. */
   trackOrder?: string[]
+  /** Omits ordered tracks without waveform series from layout and pagination. */
+  hideEmptyTracks?: boolean
   trackLines?: WaveformGridTrackLines
 }
 
@@ -38,6 +40,7 @@ export interface NormalizedWaveformGridOptions {
   showPagination: boolean
   fillIncompleteLastRow: boolean
   trackOrder?: string[]
+  hideEmptyTracks?: boolean
   trackLines: Record<string, NormalizedWaveformGridLineOptions>
 }
 
@@ -95,6 +98,7 @@ export function normalizeGridOptions(options?: WaveformGridOptions): NormalizedW
     showPagination: options?.showPagination ?? true,
     fillIncompleteLastRow: options?.fillIncompleteLastRow ?? false,
     trackOrder: normalizeTrackOrder(options?.trackOrder),
+    hideEmptyTracks: options?.hideEmptyTracks ?? false,
     trackLines,
   }
 }

package/src/components/core/trackPagination.ts

@@ -0,0 +1,40 @@
+import type { DisplayTrack } from './types'
+
+export const resolvePageableTracks = (
+  tracks: DisplayTrack[],
+  hideEmptyTracks?: boolean,
+): DisplayTrack[] => (hideEmptyTracks ? tracks.filter((track) => track.series.length > 0) : tracks)
+
+export const resolveTrackFrameNumber = (
+  frameNumber: string | number | undefined,
+  frameNumbers: Record<string, string | number> | undefined,
+  trackCount: number,
+  trackIndex: number,
+  trackId: string,
+): string | number | undefined => {
+  const mappedFrameNumber = frameNumbers?.[trackId]
+  if (mappedFrameNumber !== undefined) return mappedFrameNumber
+  if (frameNumber === undefined) return undefined
+  if (trackCount === 1) return frameNumber
+  return typeof frameNumber === 'number'
+    ? frameNumber + trackIndex
+    : `${frameNumber}-${trackIndex + 1}`
+}
+
+export const createFrameNumberResolver =
+  (
+    getFrameNumber: () => string | number | undefined,
+    getFrameNumbers: () => Record<string, string | number> | undefined,
+    getTracks: () => DisplayTrack[],
+  ) =>
+  (trackId: string): string | number | undefined => {
+    const tracks = getTracks()
+    const trackIndex = tracks.findIndex((track) => track.id === trackId)
+    return resolveTrackFrameNumber(
+      getFrameNumber(),
+      getFrameNumbers(),
+      tracks.length,
+      trackIndex >= 0 ? trackIndex : 0,
+      trackId,
+    )
+  }

package/src/components/core/useWaveformChartController.ts

@@ -87,9 +87,13 @@ export function useWaveformChartController(
   const pointerInsideChart = ref(false)
   let handleBeforeDataReferenceChange: () => void = () => undefined
   let handleDataReferenceChange: () => void = () => undefined
+  let prepareForDataChange: () => void = () => undefined
   const preparedSeries = usePreparedWaveformSeries(
     () => props.data,
-    () => handleBeforeDataReferenceChange(),
+    () => {
+      prepareForDataChange()
+      handleBeforeDataReferenceChange()
+    },
     () => handleDataReferenceChange(),
   )
 
@@ -184,6 +188,7 @@ export function useWaveformChartController(
     resolveInitialTrackDomain,
     cancelPendingHover: () => hover.cancelPendingHover(),
   })
+  prepareForDataChange = zoom.prepareForDataChange
 
   const annotations = useWaveformChartAnnotations({
     props,

package/src/components/core/useWaveformChartLifecycle.ts

@@ -9,12 +9,12 @@ import {
   type ShallowRef,
 } from 'vue'
 
-import type { AnnotationSeriesCandidate } from '../annotation'
-import type { useWaveformAnnotationInteraction } from '../annotation'
+import type { AnnotationSeriesCandidate, useWaveformAnnotationInteraction } from '../annotation'
 import type { NormalizedWaveformGridOptions } from './grid'
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types'
 import type { ResolvedWaveformChartProps, WaveformChartEmit } from './waveformChartTypes'
 import { constrainZoomDomain, transformForDomain } from '../interaction/zoomConstraints'
+import { seriesIdentity } from '../interaction/zoomEventPayload'
 
 interface LifecycleContext {
   props: ResolvedWaveformChartProps
@@ -152,16 +152,20 @@ export function useWaveformChartLifecycle(context: LifecycleContext) {
   }
 
   let pendingSharedXDomain: [number, number] | undefined
-  let pendingIndependentXDomains: Array<[number, number] | undefined> | undefined
+  let pendingIndependentXDomains: Map<string, [number, number]> | undefined
 
   function handleBeforeDataReferenceChange() {
     if (props.displayMode === 'independent') {
       pendingSharedXDomain = undefined
-      pendingIndependentXDomains = trackLayouts.value.map((track) => {
-        const current = track.xScale.domain() as [number, number]
-        const boundary = resolveInitialTrackDomain(track)
-        return current[1] - current[0] < boundary[1] - boundary[0] - 1e-12 ? current : undefined
-      })
+      pendingIndependentXDomains = new Map(
+        trackLayouts.value.flatMap((track) => {
+          const current = track.xScale.domain() as [number, number]
+          const boundary = resolveInitialTrackDomain(track)
+          return current[1] - current[0] < boundary[1] - boundary[0] - 1e-12
+            ? [[seriesIdentity(track.seriesList.map((series) => series.id)), current]]
+            : []
+        }),
+      )
       return
     }
     pendingIndependentXDomains = undefined
@@ -184,7 +188,9 @@ export function useWaveformChartLifecycle(context: LifecycleContext) {
       if (props.displayMode === 'independent' && pendingIndependentXDomains) {
         const nextTransforms = chartTracks.value.map(() => zoomIdentity)
         trackLayouts.value.forEach((track) => {
-          const previousDomain = pendingIndependentXDomains?.[track.index]
+          const previousDomain = pendingIndependentXDomains?.get(
+            seriesIdentity(track.seriesList.map((series) => series.id)),
+          )
           if (!previousDomain) return
           const boundary = resolveInitialTrackDomain(track)
           const domain = constrainZoomDomain(previousDomain, boundary, [track.seriesList], props)