waveform-analysis 0.1.73 → 0.1.75

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

@@ -84,8 +84,10 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     minVisiblePoints: number;
     xDomainStrategy: import("..").WaveformXDomainStrategy;
     timeUnit: "s" | "ms";
+    frameNumber: string | number;
     annotations: import("..").WaveformAnnotation[];
     annotationsVisible: boolean;
+    interactionMode: import("..").WaveformInteractionMode;
     grid: import("..").WaveformGridOptions;
     rendering: import("..").WaveformRenderingOptions;
     plotMargin: import("..").WaveformPlotMargin;
@@ -94,8 +96,7 @@ declare const __VLS_export: import("vue").DefineComponent<WaveformChartProps, {
     cleanView: boolean;
     presentationMode: boolean;
     zeroLine: import("..").WaveformZeroLineOptions;
-    frameNumber: string | number;
-    interactionMode: import("..").WaveformInteractionMode;
+    animationEnabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/components/animation/annotationPresentation.d.ts

@@ -0,0 +1,17 @@
+import type { RenderedAnnotation } from '../annotation/types';
+import type { ResolvedAnimationProps } from './config';
+import type { WaveformAnnotation } from '@/types';
+import type { AnnotationAnimationState } from '@/animation/types';
+import { WaveformAnimationController } from '@/animation/WaveformAnimationController';
+export interface PresentedAnnotation extends RenderedAnnotation {
+    animationStyle?: AnnotationAnimationState;
+    leaving?: boolean;
+    seriesOpacity?: number;
+}
+export declare function createAnnotationPresentation(controller: WaveformAnimationController, invalidate: () => void): {
+    reconcile(rendered: RenderedAnnotation[], controlled: WaveformAnnotation[], config: ResolvedAnimationProps["animationAnnotation"], enabled: boolean, waitingSeries: Set<string>): void;
+    release(seriesId?: string): void;
+    finish(rendered: RenderedAnnotation[]): void;
+    project(rendered: RenderedAnnotation[], seriesOpacity: Map<string, number>): PresentedAnnotation[];
+    clear(): void;
+};

package/dist/types/components/animation/chartExportVersion.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedWaveformChartProps } from '../core/waveformChartTypes';
+export declare function chartExportVersion(props: ResolvedWaveformChartProps, state: object): unknown[];

package/dist/types/components/animation/config.d.ts

@@ -0,0 +1,31 @@
+import type { WaveformAnimationProps, AnnotationAnimationType, LineDrawingDirection } from '@/animation/types';
+export declare function resolveAnimationProps(props: WaveformAnimationProps, warn?: (message: string) => void): {
+    animationEnabled: boolean;
+    animationThreshold: number;
+    animation: {
+        delay: number;
+        staggerDelay: number;
+        direction: LineDrawingDirection;
+        enabled: boolean;
+        duration: number;
+        easing: NonNullable<import("../..").EasingType | import("../..").EasingFunction | undefined>;
+        onComplete: (() => void) | undefined;
+        onAbort: (() => void) | undefined;
+    };
+    animationUpdate: {
+        enabled: boolean;
+        duration: number;
+        easing: NonNullable<import("../..").EasingType | import("../..").EasingFunction | undefined>;
+        onComplete: (() => void) | undefined;
+        onAbort: (() => void) | undefined;
+    };
+    animationAnnotation: {
+        type: AnnotationAnimationType;
+        enabled: boolean;
+        duration: number;
+        easing: NonNullable<import("../..").EasingType | import("../..").EasingFunction | undefined>;
+        onComplete: (() => void) | undefined;
+        onAbort: (() => void) | undefined;
+    };
+};
+export type ResolvedAnimationProps = ReturnType<typeof resolveAnimationProps>;

package/dist/types/components/animation/context.d.ts

@@ -0,0 +1,20 @@
+import type { ComputedRef, Ref, ShallowRef } from 'vue';
+import type { TrackLayout } from '../core/types';
+import type { PreparedWaveformSeries } from '../core/useWaveformData';
+import type { ResolvedWaveformChartProps } from '../core/waveformChartTypes';
+export interface AnimationContext {
+    props: ResolvedWaveformChartProps;
+    tracks: ComputedRef<TrackLayout[]>;
+    currentPage: Ref<number>;
+    containerSize: ComputedRef<number[]>;
+    preparedSeries: ShallowRef<PreparedWaveformSeries[]>;
+    layoutReady: ComputedRef<boolean>;
+    innerWidth: ComputedRef<number>;
+    innerHeight: ComputedRef<number>;
+    sampling: {
+        state: ComputedRef<'pending' | 'success' | 'fallback' | 'error'>;
+        requestSignature: ComputedRef<string>;
+    };
+}
+export declare function animationLayoutSignature(context: AnimationContext): string;
+export declare function wrapAnimationCommands<T extends object>(commands: T, stabilize: () => void): T;

package/dist/types/components/animation/geometry.d.ts

@@ -0,0 +1,10 @@
+import type { ScaleLinear } from 'd3';
+import type { WaveformPoint, WaveformLineType } from '@/types';
+import type { TrackSeriesPath } from '../core/types';
+import type { NumericGeometry } from '@/animation/types';
+/** Private presentation buffer; the source/target snapshots and business points stay immutable. */
+export declare function interpolateGeometry(from: NumericGeometry, to: NumericGeometry, p: number): NumericGeometry;
+export declare function generateWaveformPath(points: WaveformPoint[], type: WaveformLineType, x: ScaleLinear<number, number>, y: ScaleLinear<number, number>): string | null;
+export declare function captureGeometry(path: TrackSeriesPath, x: ScaleLinear<number, number>): NumericGeometry;
+export declare function projectGeometry(path: TrackSeriesPath, geometry: NumericGeometry, x: ScaleLinear<number, number>, y: ScaleLinear<number, number>): TrackSeriesPath;
+export declare function compatibleGeometry(a: TrackSeriesPath, b: TrackSeriesPath, from: NumericGeometry, to: NumericGeometry): boolean;

package/dist/types/components/animation/paginationPresentation.d.ts

@@ -0,0 +1,13 @@
+import { type ComputedRef } from 'vue';
+import type { AnimationContext } from './context';
+import type { ResolvedAnimationProps } from './config';
+import type { WaveformAnimationController } from '@/animation/WaveformAnimationController';
+/** A single owner-scoped fade; it holds no old page geometry. */
+export declare function createPaginationPresentation(context: AnimationContext, controller: WaveformAnimationController, config: ComputedRef<ResolvedAnimationProps>, effective: ComputedRef<boolean>, commit: () => void): {
+    opacity: import("vue").ShallowRef<number, number>;
+    reset: () => void;
+    cancel: () => void;
+    reconcile: (dataChanged: boolean) => boolean;
+    wrapPagination: (goToPage: (page: number) => void, count: ComputedRef<number>) => (page: number) => void;
+    active: () => boolean;
+};

package/dist/types/components/animation/pathBuffer.d.ts

@@ -0,0 +1,4 @@
+import type { ScaleLinear } from 'd3';
+import type { WaveformPoint, WaveformLineType } from '@/types';
+/** Stable D3 accessors/context keep their feedback across frames; storage is private to points. */
+export declare function createPathBuffer(x: ScaleLinear<number, number>, y: ScaleLinear<number, number>): (points: WaveformPoint[], nextType: WaveformLineType, x: ScaleLinear<number, number>, y: ScaleLinear<number, number>) => string;

package/dist/types/components/animation/trackPresentation.d.ts

@@ -0,0 +1,35 @@
+import type { TrackLayout, TrackSeriesPath } from '../core/types';
+import type { WaveformAnnotation } from '@/types';
+import type { NumericGeometry } from '@/animation/types';
+interface AnchorValue {
+    seriesId: string;
+    annotationY: number;
+    x: number;
+    y: number;
+}
+interface SeriesGeometry {
+    path: TrackSeriesPath;
+    values: NumericGeometry;
+    old?: {
+        path: TrackSeriesPath;
+        values: NumericGeometry;
+    };
+    opacity: number;
+}
+export interface TrackPresentation {
+    target: TrackLayout;
+    series: Map<string, SeriesGeometry>;
+    xDomain: [number, number];
+    yDomains: [number, number][];
+    anchors: Map<string, AnchorValue>;
+    clips: Map<string, {
+        id: string;
+        x: number;
+        width: number;
+    }>;
+}
+export declare function staticTrack(track: TrackLayout, annotations: WaveformAnnotation[], previous?: TrackPresentation, refreshAnchors?: boolean): TrackPresentation;
+export declare function hasThirdGeometry(from: TrackPresentation): boolean;
+export declare function transitionTrack(from: TrackPresentation, to: TrackPresentation, p: number, terminal: boolean): TrackPresentation;
+export declare function projectTrack(state: TrackPresentation): TrackLayout;
+export {};

package/dist/types/components/animation/useWaveformAnimations.d.ts

@@ -0,0 +1,27 @@
+import { type AnimationContext } from './context';
+export declare function useWaveformAnimations(context: AnimationContext): {
+    presentationTracks: import("vue").ComputedRef<import("../core").TrackLayout[]>;
+    presentationAnnotations: import("vue").ComputedRef<{
+        seriesOpacity: number;
+        animationStyle?: import("../..").AnnotationAnimationState;
+        leaving?: boolean;
+        annotation: import("..").WaveformAnnotation;
+        trackIndex: number;
+        anchorX: number;
+        anchorY: number;
+        placement: import("../annotation").AnnotationPlacement;
+        lines: string[];
+        box: import("../annotation").AnnotationBoxLayout;
+        style: {
+            borderColor: string;
+            textColor: string;
+            backgroundColor: string;
+        };
+    }[]>;
+    paginationOpacity: import("vue").ShallowRef<number, number>;
+    stabilizeAnimations: (event?: Event) => void;
+    wrap: <T extends object>(commands: T) => T;
+    wrapPagination: (goToPage: (page: number) => void, count: import("vue").ComputedRef<number>) => (page: number) => void;
+    prepareExport: () => void;
+    releaseExport: () => void;
+};

package/dist/types/components/annotation/WaveformAnnotationContextMenu.vue.d.ts

@@ -6,12 +6,12 @@ interface Props {
 }
 declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     edit: () => any;
-    delete: () => any;
     close: () => any;
+    delete: () => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
     onEdit?: (() => any) | undefined;
-    onDelete?: (() => any) | undefined;
     onClose?: (() => any) | undefined;
+    onDelete?: (() => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -48,6 +48,13 @@ export interface AnnotationBoxLayout {
 }
 export type AnnotationPlacement = 'top' | 'bottom' | 'right' | 'left' | 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
 export interface RenderedAnnotation {
+    animationStyle?: {
+        opacity: number;
+        scale: number;
+        offsetY: number;
+    };
+    leaving?: boolean;
+    seriesOpacity?: number;
     annotation: WaveformAnnotation;
     trackIndex: number;
     anchorX: number;

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

@@ -10,6 +10,8 @@ interface Context {
     };
     version: () => unknown;
     ready: () => boolean;
+    prepare?: () => void;
+    release?: () => void;
 }
 export declare function useChartImageExport(c: Context): {
     exportImage: (options?: WaveformImageExportOptions) => Promise<Blob>;

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

@@ -10,7 +10,7 @@ export interface ResolvedYAxisTicks {
 }
 export declare function resolveYAxisTicks(domain: [number, number], tickCount?: number, nice?: boolean): ResolvedYAxisTicks;
 export declare function formatYAxisTickLabel(value: number, domain: [number, number], tickValues: readonly number[], unit?: string, side?: 'left' | 'right'): string;
-/** Scientific multipliers retain their rendered position but do not reserve horizontal space. */
+/** Name spacing excludes scientific multipliers; outer clearance measures the full label. */
 export declare function formatYAxisTickLayoutLabel(value: number, domain: [number, number], tickValues: readonly number[], unit?: string): string;
 export interface YAxisSeriesGroup {
     index: number;
@@ -33,6 +33,7 @@ export declare function resolveYAxisSeriesGroups(track: DisplayTrack, overlayMod
 export declare function resolveRenderedYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, viewportYDomains?: Record<string, [number, number]>, padding?: YAxisPaddingOptions | number): YAxisSeriesGroup[];
 export declare function axisTextMetrics(domain: [number, number], nice?: boolean, tickValues?: number[], unit?: string, tickCount?: number, includeWithoutLastTick?: boolean, measureTextWidth?: (text: string) => number, maximumTick?: number, minimumTick?: number): {
     tickTextWidth: number;
+    titleTextWidth: number;
 };
 export declare function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?: number, nice?: boolean): number;
 export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, tickCount?: number, nice?: boolean): {

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

@@ -37,6 +37,14 @@ export interface DisplayTrack {
 export interface TrackSeriesPath {
     series: DisplaySeries;
     path: string | null;
+    lineRenderPoints?: WaveformPoint[];
+    presentationKey?: string;
+    opacity?: number;
+    animationClip?: {
+        id: string;
+        x: number;
+        width: number;
+    };
     pointRenderPoints: WaveformPoint[];
     errorBarRenderPoints: WaveformPoint[];
     yScale: ScaleLinear<number, number>;

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

@@ -210,6 +210,26 @@ export declare function useWaveformChartController(inputProps: ResolvedWaveformC
     setTitleMeasureElement: (element: Element | ComponentPublicInstance | null) => void;
     setSharedOverlayElement: (element: Element | ComponentPublicInstance | null) => void;
     exportImage: (options?: import("../..").WaveformImageExportOptions) => Promise<Blob>;
+    presentationTracks: import("./types").TrackLayout[];
+    presentationAnnotations: {
+        seriesOpacity: number;
+        animationStyle?: import("../..").AnnotationAnimationState;
+        leaving?: boolean;
+        annotation: import("..").WaveformAnnotation;
+        trackIndex: number;
+        anchorX: number;
+        anchorY: number;
+        placement: import("../annotation").AnnotationPlacement;
+        lines: string[];
+        box: import("../annotation").AnnotationBoxLayout;
+        style: {
+            borderColor: string;
+            textColor: string;
+            backgroundColor: string;
+        };
+    }[];
+    paginationOpacity: number;
+    stabilizeAnimations: (event?: Event) => void;
     controlState: import("../..").WaveformControlState;
     getControlState: () => import("../..").WaveformControlState;
     execute: (action: import("../..").WaveformControlAction, target?: import("../..").WaveformControlTarget, domain?: [number, number], source?: "toolbar" | "api") => import("../..").WaveformControlResult;
@@ -387,5 +407,10 @@ export declare function useWaveformChartController(inputProps: ResolvedWaveformC
     cleanView: boolean;
     presentationMode: boolean;
     zeroLine: import("..").WaveformZeroLineOptions;
+    animationEnabled?: boolean | undefined;
+    animation?: import("../..").WaveformEnterAnimationOptions | undefined;
+    animationUpdate?: import("../..").WaveformUpdateAnimationOptions | undefined;
+    animationAnnotation?: import("../..").WaveformAnnotationAnimationOptions | undefined;
+    animationThreshold?: number | undefined;
 };
 export type WaveformChartController = ReturnType<typeof useWaveformChartController>;

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

@@ -14,6 +14,8 @@ interface SamplingContext {
     linePointOverrides: ShallowRef<Record<string, WaveformPoint[]>>;
 }
 export declare function useWaveformRenderSampling(context: SamplingContext): {
+    requestSignature: ComputedRef<string>;
+    state: ComputedRef<"error" | "pending" | "success" | "fallback">;
     linePointOverrides: ShallowRef<Record<string, WaveformPoint[]>>;
     ready: () => boolean;
 };

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

@@ -1,7 +1,8 @@
+import type { WaveformAnimationProps } from '../../animation/types';
 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 {
+export interface WaveformChartProps extends WaveformAnimationProps {
     toolbar?: boolean | WaveformToolbarOptions;
     data: WaveformData;
     displayMode?: WaveformDisplayMode;

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

@@ -7,5 +7,5 @@ interface TitleLayoutOptions {
     measureTextWidth?: (text: string) => number;
 }
 type TitleTrack = Pick<TrackLayout, 'height' | 'column' | 'yAxes'>;
-export declare function alignLeftYAxisTitles(layouts: TitleTrack[], yLabel?: string, options?: TitleLayoutOptions): void;
+export declare function alignLeftYAxisTitles(layouts: TitleTrack[], _yLabel?: string, options?: TitleLayoutOptions): void;
 export {};

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

@@ -2,4 +2,4 @@ import { type ComputedRef, type ShallowRef } from 'vue';
 import type { ZoomTransform } from 'd3';
 import type { TrackLayout } from '../core/types';
 /** Keep X coordinates stable when toggling extrema changes the reserved Y-label width. */
-export declare function useExtremaTickViewport(visible: () => boolean, innerWidth: ComputedRef<number>, tracks: ComputedRef<TrackLayout[]>, sharedTransform: ShallowRef<ZoomTransform>, independentTransforms: ShallowRef<ZoomTransform[]>): void;
+export declare function useExtremaTickViewport(visible: () => number, innerWidth: ComputedRef<number>, tracks: ComputedRef<TrackLayout[]>, sharedTransform: ShallowRef<ZoomTransform>, independentTransforms: ShallowRef<ZoomTransform[]>): void;

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

@@ -1,6 +1,7 @@
 import type { TrackLayout } from '../core/types';
 type __VLS_Props = {
     track: TrackLayout;
+    paginationOpacity?: number;
     clipPathId: string;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -3,6 +3,7 @@ import type { TrackLayout } from '../core/types';
 import type { WaveformDisplayMode, WaveformInteractionMode } from '../data/types';
 interface Props {
     track: TrackLayout;
+    paginationOpacity?: number;
     clipPathId: string;
     innerWidth: number;
     zoomable: boolean;
@@ -23,25 +24,25 @@ interface Props {
     zeroLine?: Required<WaveformZeroLineOptions>;
 }
 declare const __VLS_export: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    contextmenu: (mouseEvent: MouseEvent) => any;
     click: (mouseEvent: MouseEvent) => any;
+    contextmenu: (mouseEvent: MouseEvent) => any;
     "pointer-move": (pointerEvent: PointerEvent) => any;
     "pointer-down": (pointerEvent: PointerEvent) => any;
     "pointer-up": (pointerEvent: PointerEvent) => any;
     "pointer-cancel": (pointerEvent: PointerEvent) => any;
     "pointer-leave": () => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    onContextmenu?: ((mouseEvent: MouseEvent) => any) | undefined;
     onClick?: ((mouseEvent: MouseEvent) => any) | undefined;
+    onContextmenu?: ((mouseEvent: MouseEvent) => any) | undefined;
     "onPointer-move"?: ((pointerEvent: PointerEvent) => any) | undefined;
     "onPointer-down"?: ((pointerEvent: PointerEvent) => any) | undefined;
     "onPointer-up"?: ((pointerEvent: PointerEvent) => any) | undefined;
     "onPointer-cancel"?: ((pointerEvent: PointerEvent) => any) | undefined;
     "onPointer-leave"?: (() => any) | undefined;
 }>, {
+    interactionMode: WaveformInteractionMode;
     cleanView: boolean;
     zeroLine: Required<WaveformZeroLineOptions>;
-    interactionMode: WaveformInteractionMode;
     interactive: boolean;
     showAxisUnits: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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

@@ -0,0 +1,5 @@
+import type { Axis, NumberValue, ScaleLinear } from 'd3';
+/** Avoid invalidating native SVG layout when an attribute already has the required value. */
+export declare function updateSvgAttribute(element: Element, name: string, value: string | number | null): void;
+/** Domain animation moves existing ticks; unchanged labels keep their native text nodes. */
+export declare function updateAxis(element: SVGGElement, axis: Axis<NumberValue>, scale: ScaleLinear<number, number>, ticks: number[], orientation: 'bottom' | 'left' | 'right', format: (value: number) => string): void;

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

@@ -0,0 +1,3 @@
+import type { ScaleLinear } from 'd3';
+/** Keep each grid line independently discoverable by the axis collision pass. */
+export declare function updateGrid(group: SVGGElement, ticks: readonly number[], scale: ScaleLinear<number, number>, direction: 'vertical' | 'horizontal', extent: number, color: string | undefined): void;

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

@@ -6,6 +6,8 @@ interface Box {
 }
 export declare function labelsOverlap(a: Box, b: Box): boolean;
 export declare function linesOverlap(a: number, b: number, widthA?: number, widthB?: number): boolean;
+/** Coalesce sibling axes after Vue's current DOM patch, without adding a late animation frame. */
+export declare function scheduleMaximumTickVisibility(svg: SVGSVGElement): void;
 /** 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/components/utils/assignElement.d.ts

@@ -0,0 +1,2 @@
+import type { ComponentPublicInstance, Ref } from 'vue';
+export declare function assignElement<T extends Element>(target: Ref<T | undefined>, element: Element | ComponentPublicInstance | null): void;

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

@@ -35,7 +35,8 @@ export interface DemoControlPanelModel {
     yAxisLineVisible: boolean;
     upperPaddingEnabled: boolean;
     lowerPaddingEnabled: boolean;
-    extremaTicksVisible: boolean;
+    maximumTickVisible: boolean;
+    minimumTickVisible: boolean;
     upperPaddingPercent: number;
     lowerPaddingPercent: number;
     xAxisLabelFormatterEnabled: boolean;

package/dist/types/index.d.ts

@@ -4,6 +4,15 @@
  */
 export { default as WaveformChart } from './components/WaveformChart.vue';
 export type { WaveformChartProps } from './components/core/waveformChartTypes';
+export { getEasingFunction } from './animation/core/easing';
+export { WaveformAnimationController } from './animation/WaveformAnimationController';
+export { createLineDrawingAnimation, createStaggeredLineDrawingAnimations, } from './animation/presets/lineDrawing';
+export { createPathTransitionAnimation, createYAxisScaleAnimation, } from './animation/presets/transitions';
+export { createAnnotationAppearAnimation, createAnnotationDisappearAnimation, } from './animation/presets/annotation';
+export { Animation } from './animation/core/Animation';
+export { Animator, globalAnimator } from './animation/core/Animator';
+export type { AnimationValue, AnimationDirection, AnimationState, AnimationFrame, AnimationTrack, AnimationConfig, AnimationHandle, AnimationScheduler, EasingFunction, EasingFamily, EasingType, } from './animation/core/types';
+export type { LineDrawingDirection, AnnotationAnimationType, LineDrawingOptions, StaggeredLineDrawingOptions, DataUpdateOptions, AnnotationAnimationOptions, WaveformEnterAnimationOptions, WaveformUpdateAnimationOptions, WaveformAnnotationAnimationOptions, WaveformAnimationProps, ClipAnimationState, AnimationBinding, NumericGeometry, GeometryTransitionInput, GeometryTransitionFrame, AnnotationAnimationState, AnimationScope, AnimationObjectKey, WaveformAnimationControllerOptions, } from './animation/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';

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

@@ -250,8 +250,10 @@ export interface WaveformAxesOptions {
         splitNumber?: number;
         /** Expands Y-axis domains to equal, human-friendly intervals. Defaults to true. */
         nice?: boolean;
-        /** Shows extra ticks for the full data extrema, independently of padding. Defaults to true. */
-        extremaTicksVisible?: boolean;
+        /** Shows the full data maximum's extra tick and label. Defaults to true. */
+        maximumTickVisible?: boolean;
+        /** Shows the full data minimum's extra tick and label. Defaults to true. */
+        minimumTickVisible?: boolean;
         /** 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. */

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waveform-analysis",
-  "version": "0.1.73",
+  "version": "0.1.75",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/types/index.d.ts",
@@ -44,7 +44,9 @@
     "globals": "17.7.0",
     "jsdom": "29.1.1",
     "oxlint": "1.77.0",
+    "playwright": "1.56.1",
     "prettier": "3.9.5",
+    "terser": "5.51.2",
     "typescript": "~6.0.0",
     "typescript-eslint": "8.64.0",
     "vite": "8.1.5",
@@ -70,6 +72,7 @@
     "test": "pnpm prepare:wasm && vitest run",
     "test:coverage": "pnpm prepare:wasm && vitest run --coverage",
     "test:package": "node scripts/test-package.mjs",
-    "prepare:wasm": "node scripts/prepare-wasm.mjs"
+    "prepare:wasm": "node scripts/prepare-wasm.mjs",
+    "test:animation:browser": "node scripts/test-animation-browser.mjs"
   }
 }

package/src/App.vue

@@ -56,7 +56,8 @@ const xAxisLineVisible = ref(false)
 const yAxisLineVisible = ref(false)
 const upperPaddingEnabled = ref(true)
 const lowerPaddingEnabled = ref(true)
-const extremaTicksVisible = ref(true)
+const maximumTickVisible = ref(true)
+const minimumTickVisible = ref(true)
 const upperPaddingPercent = ref(10)
 const lowerPaddingPercent = ref(10)
 const { controlModel: xAxisLabelControlModel, xAxisLabelFormatter } = useDemoXAxisLabelControls()
@@ -145,7 +146,8 @@ const axes = computed<WaveformAxesOptions>(() => ({
     lineVisible: yAxisLineVisible.value,
     upperPaddingEnabled: upperPaddingEnabled.value,
     lowerPaddingEnabled: lowerPaddingEnabled.value,
-    extremaTicksVisible: extremaTicksVisible.value,
+    maximumTickVisible: maximumTickVisible.value,
+    minimumTickVisible: minimumTickVisible.value,
     upperPaddingRatio: upperPaddingPercent.value / 100,
     lowerPaddingRatio: lowerPaddingPercent.value / 100,
   },
@@ -367,7 +369,8 @@ const controlPanelModel = reactive({
   yAxisLineVisible,
   upperPaddingEnabled,
   lowerPaddingEnabled,
-  extremaTicksVisible,
+  maximumTickVisible,
+  minimumTickVisible,
   upperPaddingPercent,
   lowerPaddingPercent,
   ...xAxisLabelControlModel,

package/src/DemoRouterApp.vue

@@ -5,6 +5,7 @@
       <nav class="demo-shell__nav" aria-label="示例导航">
         <RouterLink to="/">综合示例</RouterLink>
         <RouterLink to="/fixed-y-domain">固定振幅范围</RouterLink>
+        <RouterLink to="/animation">动画</RouterLink>
         <RouterLink to="/wasm-sampling">WASM 采样</RouterLink>
       </nav>
     </header>