waveform-analysis 0.1.58 → 0.1.60

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/layout.d.ts

@@ -3,6 +3,12 @@ import type { DisplaySeries, DisplayTrack, TrackLayout } from './types';
 import { type WaveformYDomain } from './yDomain';
 export { MAX_MULTI_Y_AXIS_COUNT } from './constants';
 export declare function resolveYAxisTickCount(_plotHeight: number, splitNumber?: number): number;
+export interface ResolvedYAxisTicks {
+    domain: [number, number];
+    values: number[];
+}
+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): string;
 export interface YAxisSeriesGroup {
     index: number;
     side: 'left' | 'right';
@@ -19,7 +25,8 @@ export interface YAxisSlot {
 }
 export declare function buildYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode): YAxisSeriesGroup[];
 export declare function resolveYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>): YAxisSeriesGroup[];
-export declare function axisTextMetrics(domain: [number, number], nice?: boolean, tickValues?: number[], unit?: string, tickCount?: number): {
+export declare function resolveRenderedYAxisSeriesGroups(track: DisplayTrack, overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, viewportYDomains?: Record<string, [number, number]>): YAxisSeriesGroup[];
+export declare function axisTextMetrics(domain: [number, number], nice?: boolean, tickValues?: number[], unit?: string, tickCount?: number, includeWithoutLastTick?: boolean): {
     tickTextWidth: number;
 };
 export declare function measureYAxisGroupClearance(group: YAxisSeriesGroup, tickCount?: number, nice?: boolean): number;
@@ -31,7 +38,7 @@ export declare function measureTrackYAxisClearance(track: DisplayTrack, overlayM
  * Reserves stable Y-axis positions for every visible track on the current page.
  * Slots are ordered from the plot edge outward for each side.
  */
-export declare function buildYAxisSlots(tracks: readonly DisplayTrack[], overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, tickCount?: number, nice?: boolean): {
+export declare function buildYAxisSlots(tracks: readonly DisplayTrack[], overlayMode: WaveformOverlayMode, yDomain?: WaveformYDomain, yDomains?: Record<string, WaveformYDomain>, tickCount?: number, nice?: boolean, includeWithoutLastTick?: boolean, viewportYDomains?: Record<string, [number, number]>): {
     slots: YAxisSlot[];
     clearance: {
         left: number;

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/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;
@@ -44,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/core/yAxisLayoutMetrics.d.ts

@@ -0,0 +1,10 @@
+import type { WaveformOverlayMode } from '../data/types';
+import type { DisplayTrack } from './types';
+import type { WaveformYDomain } from './yDomain';
+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): YAxisLayoutMetrics;

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.58",
+  "version": "0.1.60",
   "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/core/layout.test.ts

@@ -4,11 +4,14 @@ import { describe, expect, it } from 'vitest'
 import { DEFAULT_WAVEFORM_RENDERING_OPTIONS } from '../../core'
 import type { DisplaySeries, DisplayTrack } from './types'
 import {
+  axisTextMetrics,
   buildTrackLayouts,
   buildYAxisSeriesGroups,
+  formatYAxisTickLabel,
   findClosestTrackAtPointer,
   MAX_MULTI_Y_AXIS_COUNT,
   measureYAxisGroupClearance,
+  resolveYAxisTicks,
   resolveYAxisTickCount,
 } from './layout'
 
@@ -143,6 +146,27 @@ describe('multi-value Y-axis grouping', () => {
     expect(resolveYAxisTickCount(220)).toBe(5)
   })
 
+  it('measures the same final endpoint label that Y-axis rendering uses', () => {
+    const ticks = resolveYAxisTicks([-0.7434, -0.3434], 5, false)
+    const labels = ticks.values.map((value) =>
+      formatYAxisTickLabel(value, ticks.domain, ticks.values, 'V'),
+    )
+
+    expect(labels).toEqual(['-0.7434', '-0.6434', '-0.5434', '-0.4434', '(V) -0.3434'])
+    expect(axisTextMetrics(ticks.domain, false, undefined, 'V', 5).tickTextWidth).toBe(77)
+  })
+
+  it('includes the compact-axis unit label after its top tick is hidden', () => {
+    const ticks = resolveYAxisTicks([0.12345, 100], 5, false)
+    const compactTicks = ticks.values.slice(0, -1)
+
+    expect(formatYAxisTickLabel(compactTicks.at(-1)!, ticks.domain, compactTicks, 'V')).toBe(
+      '(V) 75.031',
+    )
+    expect(axisTextMetrics(ticks.domain, false, undefined, 'V', 5).tickTextWidth).toBe(49)
+    expect(axisTextMetrics(ticks.domain, false, undefined, 'V', 5, true).tickTextWidth).toBe(70)
+  })
+
   it('keeps every overlaid series on one axis in single-axis mode', () => {
     const groups = buildYAxisSeriesGroups(
       track([series('a', 0, 1), series('b', 10, 20)]),

package/src/components/core/layout.ts

@@ -27,6 +27,47 @@ export function resolveYAxisTickCount(_plotHeight: number, splitNumber?: number)
   return 5
 }
 
+export interface ResolvedYAxisTicks {
+  domain: [number, number]
+  values: number[]
+}
+
+export function resolveYAxisTicks(
+  domain: [number, number],
+  tickCount = 5,
+  nice = true,
+): ResolvedYAxisTicks {
+  const effectiveTickCount =
+    typeof tickCount === 'number' && Number.isFinite(tickCount)
+      ? Math.max(2, Math.floor(tickCount))
+      : 5
+  const scale = scaleLinear(domain, [1, 0])
+  if (nice) scale.nice(Math.max(1, effectiveTickCount - 1))
+  const resolvedDomain = scale.domain() as [number, number]
+  const [axisStart, axisEnd] = resolvedDomain
+  return {
+    domain: resolvedDomain,
+    values: Array.from(
+      { length: effectiveTickCount },
+      (_, index) => axisStart + ((axisEnd - axisStart) * index) / (effectiveTickCount - 1),
+    ),
+  }
+}
+
+export function formatYAxisTickLabel(
+  value: number,
+  domain: [number, number],
+  tickValues: readonly number[],
+  unit?: string,
+): string {
+  return formatScientificAxisLabel(value, {
+    axisMin: domain[0],
+    axisMax: domain[1],
+    topTickValue: Math.max(...tickValues),
+    unit,
+  })
+}
+
 export interface YAxisSeriesGroup {
   index: number
   side: 'left' | 'right'
@@ -114,26 +155,38 @@ export function resolveYAxisSeriesGroups(
   })
 }
 
+export function resolveRenderedYAxisSeriesGroups(
+  track: DisplayTrack,
+  overlayMode: WaveformOverlayMode,
+  yDomain?: WaveformYDomain,
+  yDomains?: Record<string, WaveformYDomain>,
+  viewportYDomains?: Record<string, [number, number]>,
+): YAxisSeriesGroup[] {
+  const viewportYDomain = viewportYDomains?.[track.id]
+  return resolveYAxisSeriesGroups(track, overlayMode, yDomain, yDomains).map((group) =>
+    !group.fixed && viewportYDomain ? { ...group, domain: viewportYDomain } : group,
+  )
+}
+
 export function axisTextMetrics(
   domain: [number, number],
   nice = true,
   tickValues?: number[],
   unit?: string,
-  tickCount = 10,
+  tickCount = 5,
+  includeWithoutLastTick = false,
 ): { tickTextWidth: number } {
-  const effectiveTickCount =
-    typeof tickCount === 'number' && Number.isFinite(tickCount)
-      ? Math.max(2, Math.floor(tickCount))
-      : 10
-  const scale = scaleLinear(domain, [1, 0])
-  if (nice) scale.nice(effectiveTickCount)
-  const [axisMin, axisMax] = scale.domain()
-  const values = tickValues ?? scale.ticks(effectiveTickCount)
-  const topTickValue = Math.max(...values)
+  const resolvedTicks = tickValues
+    ? { domain, values: tickValues }
+    : resolveYAxisTicks(domain, tickCount, nice)
+  const tickValueSets = [resolvedTicks.values]
+  if (includeWithoutLastTick && resolvedTicks.values.length > 1) {
+    tickValueSets.push(resolvedTicks.values.slice(0, -1))
+  }
   const maximumTickCharacters = Math.max(
     1,
-    ...values.map(
-      (value) => formatScientificAxisLabel(value, { axisMin, axisMax, topTickValue, unit }).length,
+    ...tickValueSets.flatMap((values) =>
+      values.map((value) => formatYAxisTickLabel(value, resolvedTicks.domain, values, unit).length),
     ),
   )
   return {
@@ -200,11 +253,19 @@ export function buildYAxisSlots(
   yDomains?: Record<string, WaveformYDomain>,
   tickCount?: number,
   nice = true,
+  includeWithoutLastTick = false,
+  viewportYDomains?: Record<string, [number, number]>,
 ): { slots: YAxisSlot[]; clearance: { left: number; right: number } } {
   const widths = new Map<string, number>()
   tracks.forEach((track) => {
     const sideIndexes = { left: 0, right: 0 }
-    resolveYAxisSeriesGroups(track, overlayMode, yDomain, yDomains).forEach((group) => {
+    resolveRenderedYAxisSeriesGroups(
+      track,
+      overlayMode,
+      yDomain,
+      yDomains,
+      viewportYDomains,
+    ).forEach((group) => {
       const sideIndex = sideIndexes[group.side]++
       const key = `${group.side}:${sideIndex}`
       const width = axisTextMetrics(
@@ -213,6 +274,7 @@ export function buildYAxisSlots(
         undefined,
         group.seriesList[0]?.unit,
         tickCount,
+        includeWithoutLastTick,
       ).tickTextWidth
       widths.set(key, Math.max(widths.get(key) ?? Y_AXIS_CHARACTER_WIDTH, width))
     })

package/src/components/core/trackLayoutBuilder.ts

@@ -27,7 +27,8 @@ import {
 } from './grid'
 import {
   axisTextMetrics,
-  resolveYAxisSeriesGroups,
+  resolveRenderedYAxisSeriesGroups,
+  resolveYAxisTicks,
   resolveYAxisTickCount,
   type YAxisSlot,
 } from './layout'
@@ -115,28 +116,21 @@ export function buildTrackLayouts(options: BuildTrackLayoutsOptions): TrackLayou
         ? (options.independentTransforms[index] ?? zoomIdentity)
         : zoomIdentity
     const xScale = transform.rescaleX(baseXScale)
-    const configuredYDomain = options.yDomains?.[displayTrack.id]
-    const yAxisGroups = resolveYAxisSeriesGroups(
+    const yAxisGroups = resolveRenderedYAxisSeriesGroups(
       displayTrack,
       options.overlayMode,
       options.fixedYDomain,
       options.fixedYDomains,
-    ).map((group) =>
-      !group.fixed && configuredYDomain ? { ...group, domain: configuredYDomain } : group,
+      options.yDomains,
     )
     const sideIndexes = { left: 0, right: 0 }
     const sideOffsets = { left: 0, right: 0 }
     const yAxes: WaveformYAxisLayout[] = yAxisGroups.map((group) => {
       const sideIndex = sideIndexes[group.side]++
       const tickCount = resolveYAxisTickCount(cell.plotHeight, options.yAxisSplitNumber)
-      const niceCount = Math.max(1, tickCount - 1)
-      const scale = scaleLinear(group.domain, [cell.plotHeight, 0])
-      if (options.yAxisNice !== false) scale.nice(niceCount)
-      const [axisStart, axisEnd] = scale.domain()
-      const majorTicks = Array.from(
-        { length: tickCount },
-        (_, index) => axisStart + ((axisEnd - axisStart) * index) / (tickCount - 1),
-      )
+      const resolvedTicks = resolveYAxisTicks(group.domain, tickCount, options.yAxisNice !== false)
+      const scale = scaleLinear(resolvedTicks.domain, [cell.plotHeight, 0])
+      const majorTicks = resolvedTicks.values
       const showAxisEnd = options.displayMode !== 'compact' || cell.row === 0
       const visibleMajorTicks = showAxisEnd ? majorTicks : majorTicks.slice(0, -1)
       const tickValues = visibleMajorTicks

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,