waveform-analysis 0.1.71 → 0.1.72

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

@@ -2,7 +2,7 @@ import { type ComponentPublicInstance } from 'vue';
 import { getPageSize } from './grid';
 import type { WaveformHoverState } from './types';
 import type { ResolvedWaveformChartProps, ViewportSelectionState, WaveformChartEmit } from './waveformChartTypes';
-export declare function useWaveformChartController(props: ResolvedWaveformChartProps, emit: WaveformChartEmit): {
+export declare function useWaveformChartController(inputProps: ResolvedWaveformChartProps, emit: WaveformChartEmit): {
     margin: {
         top: number;
         right: number;
@@ -209,6 +209,24 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     setSvgElement: (element: Element | ComponentPublicInstance | null) => void;
     setTitleMeasureElement: (element: Element | ComponentPublicInstance | null) => void;
     setSharedOverlayElement: (element: Element | ComponentPublicInstance | null) => void;
+    exportImage: (options?: import("../..").WaveformImageExportOptions) => Promise<Blob>;
+    controlState: import("../..").WaveformControlState;
+    getControlState: () => import("../..").WaveformControlState;
+    execute: (action: import("../..").WaveformControlAction, target?: import("../..").WaveformControlTarget, domain?: [number, number], source?: "toolbar" | "api") => import("../..").WaveformControlResult;
+    clearBoundaries: (index?: number) => void;
+    restoreInitialBoundaries: () => void;
+    resetViewport: {
+        (index?: number): void;
+        (target: import("../..").WaveformControlTarget): import("../..").WaveformControlResult;
+    };
+    setViewportDomain: {
+        (domain: [number, number], index?: number): void;
+        (domain: [number, number], target: import("../..").WaveformControlTarget): import("../..").WaveformControlResult;
+    };
+    zoomIn: (target?: import("../..").WaveformControlTarget) => import("../..").WaveformControlResult;
+    zoomOut: (target?: import("../..").WaveformControlTarget) => import("../..").WaveformControlResult;
+    fitToData: (target?: import("../..").WaveformControlTarget) => import("../..").WaveformControlResult;
+    setInteractionMode: (value: import("..").WaveformInteractionMode) => import("../..").WaveformControlResult;
     cancelPendingHover: () => void;
     clearHover: () => void;
     handlePointerLeave: () => void;
@@ -227,8 +245,6 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     updateViewportDrag: (event: PointerEvent) => void;
     finishViewportDrag: (event: PointerEvent) => void;
     cancelViewportDrag: (event?: PointerEvent) => void;
-    resetViewport: (trackIndex?: number) => void;
-    setViewportDomain: (domain: [number, number], trackIndex?: number) => void;
     requestViewportReset: (event: MouseEvent) => void;
     toggleSeriesVisibility: (seriesId: string) => void;
     changeDraftSeries: (seriesId: string) => void;
@@ -262,6 +278,8 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     activeInteractionMode: import("..").WaveformInteractionMode | undefined;
     isZoomMode: boolean;
     initialXDomain: [number, number];
+    originalXDomain: [number, number];
+    resolveOriginalTrackDomain: (track: import("./types").TrackLayout) => [number, number];
     sharedZoomDomain: [number, number];
     resolveInitialTrackDomain: (track: import("./types").TrackLayout) => [number, number];
     gridCells: {
@@ -284,7 +302,7 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     annotationTrackLayouts: import("../annotation").AnnotationTrackLayout[];
     renderedAnnotations: import("../annotation").RenderedAnnotation[];
     editorSeries: import("../annotation").AnnotationSeriesInfo | undefined;
-    resolveFrameNumber: (trackId: string) => string | number | undefined;
+    resolveFrameNumber: (trackId: string, slotIndex?: number) => string | number | undefined;
     plotCenterX: number;
     titleAreaStyle: import("vue").CSSProperties;
     paginationVisible: boolean;
@@ -329,10 +347,11 @@ export declare function useWaveformChartController(props: ResolvedWaveformChartP
     innerHeight: number;
     titleVisualStyle: import("vue").CSSProperties;
     titleTextStyle: import("vue").CSSProperties;
+    toolbar?: (boolean | import("../..").WaveformToolbarOptions) | undefined;
     data: import("..").WaveformData;
     displayMode: "independent" | "separated" | "compact";
     overlayMode: "single-axis" | "multi-axis";
-    unitDisplayMode: "axis" | "legend-single-series" | "channel-label-or-legend";
+    unitDisplayMode: "axis" | "legend-single-series" | "channel-label" | "channel-label-or-legend";
     layoutPreset: "default" | "edge-compact";
     width?: number | undefined;
     height?: number | undefined;

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

@@ -4,7 +4,8 @@ import type { AnnotationSeriesCandidate, useWaveformAnnotationInteraction } from
 import type { NormalizedWaveformGridOptions } from './grid';
 import type { DisplaySeries, DisplayTrack, TrackLayout } from './types';
 import type { ResolvedWaveformChartProps, WaveformChartEmit } from './waveformChartTypes';
-interface LifecycleContext {
+export interface LifecycleContext {
+    preserveFullViewport?: () => boolean;
     props: ResolvedWaveformChartProps;
     emit: WaveformChartEmit;
     container: Ref<HTMLDivElement | undefined>;
@@ -53,4 +54,3 @@ export declare function useWaveformChartLifecycle(context: LifecycleContext): {
     handleBeforeDataReferenceChange: () => void;
     handleDataReferenceChange: () => void;
 };
-export {};

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

@@ -13,6 +13,7 @@ export interface PreparedWaveformSeries {
     points: WaveformPoint[];
     source: WaveformPointSource;
     xDomain: [number, number];
+    rawYMaximum?: number;
     yDomain: [number, number];
     hasErrorPoints: boolean;
 }

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

@@ -6,6 +6,7 @@ import type { PreparedWaveformSeries } from './useWaveformData';
 import type { ResolvedWaveformChartProps } from './waveformChartTypes';
 import type { useWaveformAnnotationInteraction } from '../annotation';
 interface LayoutContext {
+    boundaries?: ShallowRef<Record<string, [number, number]>>;
     props: ResolvedWaveformChartProps;
     preparedSeries: ShallowRef<PreparedWaveformSeries[]>;
     currentPage: Ref<number>;
@@ -39,6 +40,8 @@ export declare function useWaveformLayout(context: LayoutContext): {
     activeInteractionMode: ComputedRef<import("..").WaveformInteractionMode | undefined>;
     isZoomMode: ComputedRef<boolean>;
     initialXDomain: ComputedRef<[number, number]>;
+    originalXDomain: ComputedRef<[number, number]>;
+    resolveOriginalTrackDomain: (track: TrackLayout) => [number, number];
     sharedZoomDomain: ComputedRef<[number, number]>;
     resolveInitialTrackDomain: (track: TrackLayout) => [number, number];
     gridCells: ComputedRef<{
@@ -61,6 +64,6 @@ export declare function useWaveformLayout(context: LayoutContext): {
     annotationTrackLayouts: ComputedRef<AnnotationTrackLayout[]>;
     renderedAnnotations: ComputedRef<import("../annotation").RenderedAnnotation[]>;
     editorSeries: ComputedRef<AnnotationSeriesInfo | undefined>;
-    resolveFrameNumber: (trackId: string) => string | number | undefined;
+    resolveFrameNumber: (trackId: string, slotIndex?: number) => string | number | undefined;
 };
 export {};

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

@@ -0,0 +1,2 @@
+import type { LifecycleContext } from './useWaveformChartLifecycle';
+export declare function useWaveformMeasurements(context: Pick<LifecycleContext, 'container' | 'titleMeasureElement' | 'resizeObserver' | 'observedWidth' | 'observedHeight' | 'measuredTitleWidth' | 'measuredTitleHeight' | 'resolvedTitleText' | 'titleAreaReserved' | 'titleMeasureStyle'>): void;

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

@@ -15,5 +15,6 @@ interface SamplingContext {
 }
 export declare function useWaveformRenderSampling(context: SamplingContext): {
     linePointOverrides: ShallowRef<Record<string, WaveformPoint[]>>;
+    ready: () => boolean;
 };
 export {};

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

@@ -0,0 +1,5 @@
+import type { LifecycleContext } from './useWaveformChartLifecycle';
+export declare function useWaveformViewportRestore(context: Pick<LifecycleContext, 'preserveFullViewport' | 'props' | 'trackLayouts' | 'resolveInitialTrackDomain' | 'sharedZoomDomain' | 'initialXDomain' | 'independentTransforms' | 'chartTracks' | 'clearHover' | 'editorSeriesOptions' | 'sharedTransform' | 'innerWidth' | 'configureZoom'>): {
+    handleBeforeDataReferenceChange: () => void;
+    handleDataReferenceChange: () => void;
+};

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

@@ -1,6 +1,8 @@
+import type { WaveformToolbarOptions, WaveformControlState } from '../../types/controls';
 import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformUnitDisplayMode, WaveformLayoutPreset, WaveformFrameStyle, WaveformInteractionMode, WaveformLegendOptions, WaveformOverlayMode, WaveformPlotMargin, WaveformPoint, WaveformRenderingOptions, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformTitleOptions, WaveformXDomainStrategy, WaveformZeroLineOptions, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformPanEndPayload, WaveformZoomResetPayload } from '../data/types';
 import type { WaveformGridOptions } from './grid';
 export interface WaveformChartProps {
+    toolbar?: boolean | WaveformToolbarOptions;
     data: WaveformData;
     displayMode?: WaveformDisplayMode;
     overlayMode?: WaveformOverlayMode;
@@ -51,6 +53,9 @@ export interface WaveformChartProps {
 type DefaultedProp = 'displayMode' | 'overlayMode' | 'unitDisplayMode' | 'layoutPreset' | 'yLabel' | 'lineColor' | 'showTooltip' | 'zoomable' | 'integerZoom' | '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: 'update:interactionMode', mode: WaveformInteractionMode): void;
+    (event: 'interaction-mode-change', mode: WaveformInteractionMode): void;
+    (event: 'control-state-change', state: WaveformControlState): void;
     (event: 'point-hover', point: WaveformPoint | null): void;
     (event: 'zoom-intent', payload: WaveformZoomIntentPayload): void;
     (event: 'zoom-change', domain: [number, number]): void;

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

@@ -0,0 +1,24 @@
+import { type WorkerSamplingClient } from './workerSamplingClient';
+/** Owns resources for one immutable data reference. Invalidation cancels old work before reuse. */
+export declare function createWaveformSamplingSession(): {
+    scheduler: {
+        schedule(run: (generation: number) => Promise<void>): number;
+        isCurrent(candidate: number): boolean;
+        cancelPending(): void;
+        dispose(): void;
+        metrics: import("./latestTaskScheduler").LatestTaskSchedulerMetrics;
+    };
+    revisions: Map<string, number>;
+    backendBySeries: Map<string, import("../..").WaveformSamplingBackend>;
+    selectedModeBySeries: Map<string, "raw" | "sampled">;
+    emittedErrors: Set<string>;
+    pendingDiagnostics: Map<string, import("../..").WaveformSamplingDiagnostics>;
+    client: WorkerSamplingClient | undefined;
+    requestId: number;
+    diagnosticsTimer: ReturnType<typeof setTimeout> | undefined;
+    autoModeSettleTimer: ReturnType<typeof setTimeout> | undefined;
+    hasInitialSamplingRun: boolean;
+    getClient(): WorkerSamplingClient;
+    invalidate(): void;
+    dispose(): void;
+};

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

@@ -0,0 +1,3 @@
+import type { WaveformYAxisLabelTextStyle } from '../../types';
+export declare function resolveYAxisLabelFontSize(style?: WaveformYAxisLabelTextStyle): number;
+export declare function resolveYAxisLabelBandWidth(style?: WaveformYAxisLabelTextStyle): number;

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

@@ -1,10 +1,11 @@
 import type { WaveformOverlayMode } from '../data/types';
 import type { DisplayTrack } from './types';
 import type { WaveformYDomain } from './yDomain';
+import type { YAxisPaddingOptions } from './yAxisPadding';
 export interface YAxisLayoutMetrics {
     tickClearance: number;
     fullClearance: number;
     labelCenterX: number;
 }
 export declare function resolveViewportYDomains(displayMode: 'independent' | 'separated' | 'compact', chartTracks: DisplayTrack[], sharedYDomains: Record<string, [number, number]>, independentYDomains: Record<number, [number, number]>): Record<string, [number, number]>;
-export declare function resolveYAxisLayoutMetrics(chartTracks: DisplayTrack[], overlayMode: WaveformOverlayMode, yDomain: WaveformYDomain | undefined, yDomains: Record<string, WaveformYDomain> | undefined, viewportYDomains: Record<string, [number, number]>, nice: boolean, tickCount: number, compact: boolean, upperPaddingRatio?: number, showUnits?: boolean, measureTextWidth?: (text: string) => number): YAxisLayoutMetrics;
+export declare function resolveYAxisLayoutMetrics(chartTracks: DisplayTrack[], overlayMode: WaveformOverlayMode, yDomain: WaveformYDomain | undefined, yDomains: Record<string, WaveformYDomain> | undefined, viewportYDomains: Record<string, [number, number]>, nice: boolean, tickCount: number, compact: boolean, padding?: YAxisPaddingOptions | number, showUnits?: boolean, measureTextWidth?: (text: string) => number): YAxisLayoutMetrics;

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

@@ -0,0 +1,7 @@
+import type { WaveformAxesOptions } from '../../types';
+import type { YAxisSeriesGroup } from './layout';
+export type YAxisPaddingOptions = WaveformAxesOptions['y'];
+export declare function paddingRatio(enabled?: boolean, ratio?: number): number;
+export declare function applyYAxisPadding(group: YAxisSeriesGroup, viewport: [number, number] | undefined, options: YAxisPaddingOptions | number): YAxisSeriesGroup;
+export declare function withMaximumTick(values: number[], maximum?: number): number[];
+export declare function sameTick(a: number, b: number): boolean;

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

@@ -1,5 +1,7 @@
 import type { TrackLayout } from './types';
+import type { WaveformYAxisLabelTextStyle } from '../../types';
 interface TitleLayoutOptions {
+    labelTextStyle?: WaveformYAxisLabelTextStyle;
     showUnits?: boolean;
     compact?: boolean;
     measureTextWidth?: (text: string) => number;

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

@@ -5,6 +5,7 @@ import type { ResolvedWaveformChartProps, ViewportSelectionState } from '../core
 import type { WaveformChartEmit } from '../core/waveformChartTypes';
 import type { AnnotationSeriesCandidate } from '../annotation';
 export interface ViewportContext {
+    clearBoundaries?: (trackIndex?: number) => void;
     props: ResolvedWaveformChartProps;
     emit: WaveformChartEmit;
     selection: Ref<ViewportSelectionState | null>;

package/dist/types/components/rendering/WaveformLegend.vue.d.ts

@@ -16,9 +16,9 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {},
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     onToggle?: ((seriesId: string) => any) | undefined;
 }>, {
-    interactive: boolean;
-    showUnits: boolean;
     hiddenSeriesIds: string[];
+    showUnits: boolean;
+    interactive: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/components/rendering/WaveformTrack.vue.d.ts

@@ -11,15 +11,14 @@ interface Props {
     interactionMode?: WaveformInteractionMode;
     frameNumber?: string | number;
     frameStyle?: WaveformFrameStyle;
+    framePath?: string;
     axes?: WaveformAxesOptions;
     timeUnit: 's' | 'ms';
     yLabel?: string;
     showAxisUnits?: boolean;
     showLabelUnits?: boolean;
     hideYAxisTitles?: boolean;
-    containYAxisEndpoints?: boolean;
     containFrameStroke?: boolean;
-    omitFrameTop?: boolean;
     cleanView?: boolean;
     zeroLine?: Required<WaveformZeroLineOptions>;
 }
@@ -40,10 +39,10 @@ declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {},
     "onPointer-cancel"?: ((pointerEvent: PointerEvent) => any) | undefined;
     "onPointer-leave"?: (() => any) | undefined;
 }>, {
-    interactive: boolean;
     cleanView: boolean;
     zeroLine: Required<WaveformZeroLineOptions>;
     interactionMode: WaveformInteractionMode;
+    interactive: boolean;
     showAxisUnits: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/types/components/rendering/WaveformTrackAxes.vue.d.ts

@@ -10,7 +10,6 @@ interface Props {
     showUnits?: boolean;
     showLabelUnits?: boolean;
     hideYAxisTitles?: boolean;
-    containYAxisEndpoints?: boolean;
 }
 declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{}>, {
     showUnits: boolean;

package/dist/types/components/rendering/WaveformTrackBackdrop.vue.d.ts

@@ -4,6 +4,7 @@ interface Props {
     clipPathId: string;
     innerWidth: number;
     cleanView: boolean;
+    showEmptyFrame?: boolean;
     frameNumber?: string | number;
     frameStyle: {
         backgroundColor: string;

package/dist/types/components/rendering/compactFrame.d.ts

@@ -0,0 +1,5 @@
+import type { TrackLayout } from '../core/types';
+type Frame = Pick<TrackLayout, 'left' | 'top' | 'width' | 'height' | 'isEmpty'>;
+/** Keep the lower frame's top edge as the single owner of a shared boundary. */
+export declare function compactFramePath(track: Frame, tracks: Frame[], inset?: number): string | undefined;
+export {};

package/dist/types/components/rendering/yAxisTickVisibility.d.ts

@@ -0,0 +1,11 @@
+interface Box {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export declare function labelsOverlap(a: Box, b: Box): boolean;
+export declare function linesOverlap(a: number, b: number, widthA?: number, widthB?: number): boolean;
+/** Apply after axes and grid are in the DOM; never feed the filtered set back into layout. */
+export declare function updateMaximumTickVisibility(svg: SVGSVGElement): void;
+export {};

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

@@ -0,0 +1,4 @@
+import type { WaveformPointRange } from './waveformPointSource';
+/** Outside neighbors join the curve without changing visible-point statistics. */
+export declare function lineBoundaryIndexes(range: WaveformPointRange, length: number): number[];
+export declare function withLineBoundaries<T>(points: T[], range: WaveformPointRange, length: number, pointAt: (index: number) => T): T[];

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

@@ -1,9 +1,11 @@
+import { type WaveformPointSource } from './waveformPointSource';
 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';
 interface PointSeriesSource {
     points: WaveformPoint[];
+    source?: WaveformPointSource;
 }
 interface SeriesRenderSelectionOptions {
     lineVisible: boolean;
@@ -27,4 +29,6 @@ export declare function hasMinimumVisibleXValues(seriesList: readonly PointSerie
 export declare function selectRenderablePoints(points: WaveformPoint[], domain: [number, number], width: number, options: ResolvedWaveformRenderingOptions): WaveformPoint[];
 /** Selects real source points for discrete decorations without using line-extrema sampling. */
 export declare function selectDecorationPoints(points: WaveformPoint[], domain: [number, number], width: number, minSpacing: number, downsample: boolean, predicate?: (point: WaveformPoint) => boolean, priorityPredicate?: (point: WaveformPoint) => boolean): WaveformPoint[];
+export declare function selectSeriesRenderSourcePoints(points: WaveformPointSource, domain: [number, number], width: number, rendering: ResolvedWaveformRenderingOptions, selection: SeriesRenderSelectionOptions): SeriesRenderPointSelection;
+/** Public array adapter; internal layout passes its normalized source directly. */
 export declare function selectSeriesRenderPoints(points: WaveformPoint[], domain: [number, number], width: number, rendering: ResolvedWaveformRenderingOptions, selection: SeriesRenderSelectionOptions): SeriesRenderPointSelection;

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

@@ -1,3 +1,4 @@
+import { type WaveformPointSource } from './waveformPointSource';
 import type { WaveformPoint } from '../types';
 import type { ResolvedWaveformRenderingOptions } from './renderingOptions';
 export interface VisiblePointRange {
@@ -5,6 +6,7 @@ export interface VisiblePointRange {
     end: number;
 }
 export interface RenderablePointSelectionContext {
+    source?: WaveformPointSource;
     points: WaveformPoint[];
     range: VisiblePointRange;
     domain: [number, number];

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

@@ -0,0 +1,4 @@
+import type { WaveformPointRange } from '../waveformPointSource';
+import type { WorkerSamplingOutput } from './protocol';
+import { type StoredDataset } from './repositoryDataset';
+export declare function addOutputBoundaries(output: WorkerSamplingOutput, range: WaveformPointRange, dataset: StoredDataset): WorkerSamplingOutput;

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

@@ -1,2 +1,2 @@
 import type { WaveformData } from '../types';
-export declare function createSimulatedWaveformData(): WaveformData;
+export declare function createSimulatedWaveformData(trackCount?: number): WaveformData;

package/dist/types/demo/DemoYAxisPaddingControls.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

@@ -5,6 +5,7 @@ interface SelectOption<T> {
     value: T;
 }
 export interface DemoControlPanelModel {
+    toolbarVisible: boolean;
     controlsOpen: boolean;
     displayMode: WaveformDisplayMode;
     overlayMode: WaveformOverlayMode;
@@ -32,6 +33,10 @@ export interface DemoControlPanelModel {
     verticalGridColor: string;
     xAxisLineVisible: boolean;
     yAxisLineVisible: boolean;
+    upperPaddingEnabled: boolean;
+    lowerPaddingEnabled: boolean;
+    upperPaddingPercent: number;
+    lowerPaddingPercent: number;
     xAxisLabelFormatterEnabled: boolean;
     xAxisLabelFormat: DemoXAxisLabelFormat;
     xAxisLabelFormatOptions: Array<SelectOption<DemoXAxisLabelFormat>>;
@@ -68,6 +73,7 @@ export interface DemoControlPanelModel {
     resetWaveformViewport: () => void;
 }
 export interface DemoChartModel {
+    toolbarVisible: boolean;
     data: WaveformData;
     initialXDomain?: [number, number];
     displayMode: WaveformDisplayMode;

package/dist/types/index.d.ts

@@ -4,9 +4,10 @@
  */
 export { default as WaveformChart } from './components/WaveformChart.vue';
 export type { WaveformChartProps } from './components/core/waveformChartTypes';
-export type { WaveformPoint, WaveformDisplayMode, WaveformUnitDisplayMode, WaveformLayoutPreset, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformPanEndPayload, 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, WaveformUnitDisplayMode, WaveformLayoutPreset, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformPanEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformSamplingMode, WaveformSamplingStrategy, WaveformSamplingOptions, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformYAxisLabelTextStyle, 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';
 export { calculateWasmRange, findWasmVisibleRange, DEFAULT_WAVEFORM_RENDERING_OPTIONS, resolveWaveformRenderingOptions, selectRenderablePoints, type ResolvedWaveformRenderingOptions, type ResolvedWaveformSamplingOptions, type WasmRangeMetrics, initializeWasmSampling, sampleWaveformWasm, type WasmSamplingRequest, type WasmSamplingResult, type WasmSamplingStrategy, } from './core';
 export { parseWaveformAnnotations, serializeWaveformAnnotations } from './components/annotation';
+export type { WaveformToolbarItem, WaveformToolbarOptions, WaveformControlTarget, WaveformControlAction, WaveformCommandMetadata, WaveformTargetStatus, WaveformViewportSnapshot, WaveformTargetResult, WaveformControlResult, WaveformControlState, WaveformImageExportOptions, WaveformImageExportErrorCode, WaveformImageExportError, WaveformChartHandle, } from './types/controls';

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

@@ -1,3 +1,4 @@
+import type { WaveformCommandMetadata } from './controls';
 /**
  * 波形数据点
  */
@@ -15,6 +16,8 @@ export interface WaveformPoint {
 export type WaveformLayoutPreset = 'default' | 'edge-compact';
 /** Controls unit placement without changing series metadata. */
 export type WaveformUnitDisplayMode = 'axis' | 'legend-single-series'
+/** Append units to Y-axis names while retaining names on multi-series pages. */
+ | 'channel-label'
 /** Label and legend units; hide all channel titles on pages containing a multi-series track. */
  | 'channel-label-or-legend';
 /**
@@ -27,7 +30,7 @@ export type WaveformDisplayMode = 'independent' | 'separated' | 'compact';
 /** Controls whether overlaid series share one Y axis or use up to four value axes. */
 export type WaveformOverlayMode = 'single-axis' | 'multi-axis';
 /** 标注工具模式 */
-export type WaveformInteractionMode = 'zoom' | 'annotation';
+export type WaveformInteractionMode = 'zoom' | 'annotation' | 'pan' | 'none';
 /** Controls how the initial X viewport is derived when no explicit domain is configured. */
 export interface WaveformXDomainStrategy {
     /** integer-ms rounds initial bounds outward to range-appropriate multiples of 10 ms. */
@@ -40,7 +43,7 @@ export interface WaveformXDomainStrategy {
     includeExplicit?: boolean;
 }
 /** Describes the X-axis viewport after a zoom gesture completes. */
-export interface WaveformZoomEndPayload {
+export interface WaveformZoomEndPayload extends WaveformCommandMetadata {
     start: number;
     end: number;
     yStart?: number;
@@ -48,7 +51,7 @@ export interface WaveformZoomEndPayload {
     yRanges?: Record<string, [number, number]>;
     trackIndex?: number;
     seriesIds?: string[];
-    gesture?: 'wheel' | 'box';
+    gesture?: 'wheel' | 'box' | 'command';
 }
 /** Final horizontal viewport after a pan; endpoints are always seconds. */
 export interface WaveformPanEndPayload {
@@ -58,15 +61,15 @@ export interface WaveformPanEndPayload {
     seriesIds?: string[];
 }
 /** Describes the X-axis viewport targeted by a user zoom gesture before rendering settles. */
-export interface WaveformZoomIntentPayload {
+export interface WaveformZoomIntentPayload extends WaveformCommandMetadata {
     start: number;
     end: number;
-    gesture: 'wheel' | 'box';
+    gesture: 'wheel' | 'box' | 'command';
     trackIndex?: number;
     seriesIds?: string[];
 }
 /** Identifies the viewport reset by a double-click gesture. */
-export interface WaveformZoomResetPayload {
+export interface WaveformZoomResetPayload extends WaveformCommandMetadata {
     trackIndex?: number;
     seriesIds?: string[];
 }
@@ -221,7 +224,18 @@ export interface WaveformXAxisLabelFormatterContext {
     displayDomain: [number, number];
 }
 export type WaveformXAxisLabelFormatter = (value: number, context: WaveformXAxisLabelFormatterContext) => string;
-/** Controls axis baseline visibility while preserving tick marks and axis text. */
+/** Styling for Y-axis series names, separate from numeric tick labels. */
+export interface WaveformYAxisLabelTextStyle {
+    /** Positive font size in pixels. Defaults to 12. */
+    fontSize?: number;
+    /** CSS font weight; use 'normal' or 400 to disable bold. Defaults to 600. */
+    fontWeight?: number | string;
+    fontFamily?: string;
+    fontStyle?: 'normal' | 'italic';
+    /** CSS color. Defaults to the corresponding series color. */
+    color?: string;
+}
+/** Controls axis baselines, labels, and Y-axis range calculation. */
 export interface WaveformAxesOptions {
     x?: {
         lineVisible?: boolean;
@@ -230,12 +244,20 @@ export interface WaveformAxesOptions {
     };
     y?: {
         lineVisible?: boolean;
+        /** Styles series names on both left and right Y axes, without changing tick labels. */
+        labelTextStyle?: WaveformYAxisLabelTextStyle;
         /** 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;
-        /** Adds this fraction of the automatic Y span above its maximum. Defaults to 0. */
+        /** Fraction of the automatic Y span added above its maximum. Defaults to 0. */
         upperPaddingRatio?: number;
+        /** Fraction of the automatic Y span added below its minimum. Defaults to 0. */
+        lowerPaddingRatio?: number;
+        /** False disables upper padding; true defaults an omitted ratio to 0.1. */
+        upperPaddingEnabled?: boolean;
+        /** False disables lower padding; true defaults an omitted ratio to 0.1. */
+        lowerPaddingEnabled?: boolean;
     };
 }
 /** Styling and visibility options for the horizontal zero-value reference line. */

package/dist/types/types/controls.d.ts

@@ -0,0 +1,69 @@
+import type { WaveformInteractionMode } from './chart';
+export type WaveformToolbarItem = 'zoom-box' | 'pan' | 'annotate' | 'zoom-in' | 'zoom-out' | 'reset' | 'fit' | 'export';
+export interface WaveformToolbarOptions {
+    visible?: boolean;
+    display?: 'hover' | 'always';
+    position?: 'top-right' | 'top-left';
+    items?: WaveformToolbarItem[];
+}
+export interface WaveformControlTarget {
+    trackId?: string;
+}
+export type WaveformControlAction = 'zoom-in' | 'zoom-out' | 'set-domain' | 'fit' | 'reset';
+export interface WaveformCommandMetadata {
+    commandId?: string;
+    source?: 'toolbar' | 'api';
+    action?: WaveformControlAction;
+}
+export type WaveformTargetStatus = 'applied' | 'unchanged' | 'disabled' | 'empty-data';
+export interface WaveformViewportSnapshot {
+    xDomain: [number, number];
+    yDomains: Record<string, [number, number]>;
+}
+export interface WaveformTargetResult {
+    trackId: string;
+    status: WaveformTargetStatus;
+    before?: WaveformViewportSnapshot;
+    after?: WaveformViewportSnapshot;
+}
+export type WaveformControlResult = {
+    kind: 'viewport';
+    status: WaveformTargetStatus | 'invalid-target' | 'invalid-domain';
+    targets: WaveformTargetResult[];
+} | {
+    kind: 'mode';
+    status: 'applied' | 'requested' | 'unchanged' | 'disabled';
+    targets: [];
+};
+export interface WaveformControlState {
+    mode: WaveformInteractionMode;
+    independent: boolean;
+    targets: Array<{
+        trackId: string;
+        label: string;
+        viewport: WaveformViewportSnapshot;
+        available: Record<WaveformControlAction, boolean>;
+    }>;
+    available: Record<WaveformToolbarItem, boolean>;
+}
+export interface WaveformImageExportOptions {
+    format?: 'png' | 'svg';
+    scale?: number;
+    backgroundColor?: string;
+}
+export type WaveformImageExportErrorCode = 'export-invalid-options' | 'export-unavailable' | 'export-busy' | 'export-cancelled' | 'export-render-failed' | 'export-stale' | 'export-timeout';
+export interface WaveformImageExportError extends Error {
+    code: WaveformImageExportErrorCode;
+}
+export interface WaveformChartHandle {
+    zoomIn(target?: WaveformControlTarget): WaveformControlResult;
+    zoomOut(target?: WaveformControlTarget): WaveformControlResult;
+    fitToData(target?: WaveformControlTarget): WaveformControlResult;
+    resetViewport(trackIndex?: number): void;
+    resetViewport(target: WaveformControlTarget): WaveformControlResult;
+    setViewportDomain(domain: [number, number], trackIndex?: number): void;
+    setViewportDomain(domain: [number, number], target: WaveformControlTarget): WaveformControlResult;
+    setInteractionMode(mode: WaveformInteractionMode): WaveformControlResult;
+    getControlState(): WaveformControlState;
+    exportImage(options?: WaveformImageExportOptions): Promise<Blob>;
+}

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

@@ -1,5 +1,6 @@
 /**
  * 类型定义统一导出
  */
-export type { WaveformPoint, WaveformDisplayMode, WaveformUnitDisplayMode, WaveformLayoutPreset, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformPanEndPayload, 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, WaveformUnitDisplayMode, WaveformLayoutPreset, WaveformOverlayMode, WaveformInteractionMode, WaveformXDomainStrategy, WaveformZoomIntentPayload, WaveformZoomEndPayload, WaveformPanEndPayload, WaveformZoomResetPayload, WaveformAnnotationStyle, WaveformAnnotation, WaveformSamplingMode, WaveformSamplingStrategy, WaveformSamplingOptions, WaveformSamplingBackend, WaveformSamplingDiagnostics, WaveformSamplingError, WaveformRenderingOptions, WaveformPlotMargin, WaveformTitleTextStyle, WaveformTitleOptions, WaveformLegendPosition, WaveformLegendOrientation, WaveformLegendOptions, WaveformFrameStyle, WaveformXAxisLabelKind, WaveformXAxisLabelFormatterContext, WaveformXAxisLabelFormatter, WaveformAxesOptions, WaveformYAxisLabelTextStyle, WaveformZeroLineOptions, } from './chart';
 export type { SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformTypedValues, TypedSampleData, TypedPointData, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from './data';
+export type { WaveformToolbarItem, WaveformToolbarOptions, WaveformControlTarget, WaveformControlAction, WaveformCommandMetadata, WaveformTargetStatus, WaveformViewportSnapshot, WaveformTargetResult, WaveformControlResult, WaveformControlState, WaveformImageExportOptions, WaveformImageExportErrorCode, WaveformImageExportError, WaveformChartHandle, } from './controls';

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

@@ -9,6 +9,7 @@ export interface ScientificAxisLabelOptions {
     axisMin?: number;
     axisMax?: number;
     topTickValue?: number;
+    /** Unit prefix for ordinary top ticks; scientific ticks omit it. */
     unit?: string;
 }
 /** @deprecated Use ScientificAxisLabelOptions. */