waveform-analysis 0.1.74 → 0.1.76

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (150) hide show
  1. package/README.md +422 -60
  2. package/dist/assets/workerRuntime-BJiRmIZD.js +2446 -0
  3. package/dist/index.cjs +1 -2
  4. package/dist/index.js +1 -7119
  5. package/dist/style.css +1 -1
  6. package/dist/types/animation/WaveformAnimationController.d.ts +30 -0
  7. package/dist/types/animation/core/Animation.d.ts +13 -0
  8. package/dist/types/animation/core/Animator.d.ts +23 -0
  9. package/dist/types/animation/core/easing.d.ts +3 -0
  10. package/dist/types/animation/core/errors.d.ts +4 -0
  11. package/dist/types/animation/core/handle.d.ts +7 -0
  12. package/dist/types/animation/core/owner.d.ts +3 -0
  13. package/dist/types/animation/core/propertyGroups.d.ts +17 -0
  14. package/dist/types/animation/core/task.d.ts +29 -0
  15. package/dist/types/animation/core/types.d.ts +74 -0
  16. package/dist/types/animation/core/validation.d.ts +30 -0
  17. package/dist/types/animation/core/values.d.ts +8 -0
  18. package/dist/types/animation/presets/annotation.d.ts +4 -0
  19. package/dist/types/animation/presets/lineDrawing.d.ts +7 -0
  20. package/dist/types/animation/presets/shared.d.ts +14 -0
  21. package/dist/types/animation/presets/transitions.d.ts +4 -0
  22. package/dist/types/animation/types.d.ts +84 -0
  23. package/dist/types/components/WaveformChart.vue.d.ts +3 -2
  24. package/dist/types/components/animation/annotationPresentation.d.ts +17 -0
  25. package/dist/types/components/animation/chartExportVersion.d.ts +2 -0
  26. package/dist/types/components/animation/config.d.ts +31 -0
  27. package/dist/types/components/animation/context.d.ts +20 -0
  28. package/dist/types/components/animation/geometry.d.ts +10 -0
  29. package/dist/types/components/animation/paginationPresentation.d.ts +13 -0
  30. package/dist/types/components/animation/pathBuffer.d.ts +4 -0
  31. package/dist/types/components/animation/trackPresentation.d.ts +35 -0
  32. package/dist/types/components/animation/useWaveformAnimations.d.ts +27 -0
  33. package/dist/types/components/annotation/WaveformAnnotationContextMenu.vue.d.ts +2 -2
  34. package/dist/types/components/annotation/types.d.ts +7 -0
  35. package/dist/types/components/controls/useChartImageExport.d.ts +2 -0
  36. package/dist/types/components/core/amplitudeLimits.d.ts +6 -0
  37. package/dist/types/components/core/layout.d.ts +6 -9
  38. package/dist/types/components/core/trackLayoutBuilder.d.ts +3 -1
  39. package/dist/types/components/core/types.d.ts +8 -0
  40. package/dist/types/components/core/useWaveformChartController.d.ts +26 -1
  41. package/dist/types/components/core/useWaveformData.d.ts +2 -2
  42. package/dist/types/components/core/useWaveformMeasurements.d.ts +4 -1
  43. package/dist/types/components/core/useWaveformRenderSampling.d.ts +2 -0
  44. package/dist/types/components/core/waveformChartTypes.d.ts +6 -3
  45. package/dist/types/components/core/xAxisTicks.d.ts +2 -0
  46. package/dist/types/components/core/yAxisLayoutMetrics.d.ts +2 -1
  47. package/dist/types/components/core/yAxisTicks.d.ts +6 -0
  48. package/dist/types/components/data/types.d.ts +1 -1
  49. package/dist/types/components/interaction/integerZoom.d.ts +3 -3
  50. package/dist/types/components/interaction/stepZoom.d.ts +5 -0
  51. package/dist/types/components/interaction/useWaveformViewport.d.ts +0 -3
  52. package/dist/types/components/interaction/useWaveformZoom.d.ts +0 -2
  53. package/dist/types/components/rendering/WaveformSeriesLayer.vue.d.ts +1 -0
  54. package/dist/types/components/rendering/WaveformTrack.vue.d.ts +4 -3
  55. package/dist/types/components/rendering/updateAxis.d.ts +5 -0
  56. package/dist/types/components/rendering/updateGrid.d.ts +3 -0
  57. package/dist/types/components/rendering/yAxisTickVisibility.d.ts +2 -0
  58. package/dist/types/components/utils/assignElement.d.ts +2 -0
  59. package/dist/types/core/data.d.ts +1 -1
  60. package/dist/types/demo/DemoChartHost.vue.d.ts +1 -1
  61. package/dist/types/demo/remoteWaveformLoader.d.ts +23 -0
  62. package/dist/types/demo/types.d.ts +11 -2
  63. package/dist/types/demo/useRemoteWaveformWindow.d.ts +22 -0
  64. package/dist/types/index.d.ts +10 -1
  65. package/dist/types/types/chart.d.ts +8 -1
  66. package/dist/types/types/index.d.ts +1 -1
  67. package/dist/types/utils/formatters.d.ts +4 -4
  68. package/dist/types/utils/xAxisNumber.d.ts +2 -0
  69. package/dist/types/views/AnimationDemo.vue.d.ts +3 -0
  70. package/package.json +5 -2
  71. package/src/App.vue +34 -100
  72. package/src/DemoRouterApp.vue +1 -0
  73. package/src/animation/WaveformAnimationController.ts +328 -0
  74. package/src/animation/core/Animation.ts +37 -0
  75. package/src/animation/core/Animator.ts +200 -0
  76. package/src/animation/core/easing.ts +74 -0
  77. package/src/animation/core/errors.ts +24 -0
  78. package/src/animation/core/handle.ts +34 -0
  79. package/src/animation/core/owner.ts +9 -0
  80. package/src/animation/core/propertyGroups.ts +143 -0
  81. package/src/animation/core/task.ts +153 -0
  82. package/src/animation/core/types.ts +81 -0
  83. package/src/animation/core/validation.ts +173 -0
  84. package/src/animation/core/values.ts +38 -0
  85. package/src/animation/presets/annotation.ts +66 -0
  86. package/src/animation/presets/lineDrawing.ts +51 -0
  87. package/src/animation/presets/shared.ts +58 -0
  88. package/src/animation/presets/transitions.ts +77 -0
  89. package/src/animation/types.ts +81 -0
  90. package/src/components/WaveformChart.vue +1 -0
  91. package/src/components/WaveformChartView.vue +13 -6
  92. package/src/components/animation/annotationPresentation.ts +145 -0
  93. package/src/components/animation/chartExportVersion.ts +5 -0
  94. package/src/components/animation/config.ts +87 -0
  95. package/src/components/animation/context.ts +56 -0
  96. package/src/components/animation/geometry.ts +148 -0
  97. package/src/components/animation/paginationPresentation.ts +114 -0
  98. package/src/components/animation/pathBuffer.ts +61 -0
  99. package/src/components/animation/trackPresentation.ts +172 -0
  100. package/src/components/animation/useWaveformAnimations.ts +420 -0
  101. package/src/components/annotation/WaveformAnnotationLayer.vue +43 -30
  102. package/src/components/annotation/types.ts +3 -0
  103. package/src/components/controls/useChartCommands.ts +12 -13
  104. package/src/components/controls/useChartImageExport.ts +4 -0
  105. package/src/components/core/amplitudeLimits.ts +44 -0
  106. package/src/components/core/layout.ts +22 -34
  107. package/src/components/core/trackLayoutBuilder.ts +21 -23
  108. package/src/components/core/types.ts +4 -0
  109. package/src/components/core/useWaveformChartController.ts +27 -23
  110. package/src/components/core/useWaveformChartLifecycle.ts +11 -2
  111. package/src/components/core/useWaveformData.ts +11 -5
  112. package/src/components/core/useWaveformLayout.ts +9 -4
  113. package/src/components/core/useWaveformMeasurements.ts +3 -0
  114. package/src/components/core/useWaveformRenderSampling.ts +23 -1
  115. package/src/components/core/useWaveformYAxisLayout.ts +2 -0
  116. package/src/components/core/waveformChartTypes.ts +6 -2
  117. package/src/components/core/xAxisTicks.ts +69 -0
  118. package/src/components/core/yAxisLayoutMetrics.ts +4 -0
  119. package/src/components/core/yAxisTicks.ts +39 -0
  120. package/src/components/data/types.ts +2 -0
  121. package/src/components/interaction/integerZoom.ts +31 -12
  122. package/src/components/interaction/remoteViewport.ts +26 -4
  123. package/src/components/interaction/stepZoom.ts +33 -0
  124. package/src/components/interaction/useWaveformViewport.ts +3 -26
  125. package/src/components/interaction/useWaveformZoom.ts +50 -157
  126. package/src/components/interaction/zoomConstraints.ts +5 -5
  127. package/src/components/rendering/WaveformSeriesLayer.vue +13 -1
  128. package/src/components/rendering/WaveformTrack.vue +6 -1
  129. package/src/components/rendering/WaveformTrackAxes.vue +64 -51
  130. package/src/components/rendering/WaveformTrackBackdrop.vue +35 -49
  131. package/src/components/rendering/updateAxis.ts +57 -0
  132. package/src/components/rendering/updateGrid.ts +42 -0
  133. package/src/components/rendering/yAxisTickVisibility.ts +45 -18
  134. package/src/components/utils/assignElement.ts +7 -0
  135. package/src/core/data.ts +5 -2
  136. package/src/data/simulatedWaveforms.ts +0 -10
  137. package/src/demo/DemoChartHost.vue +49 -4
  138. package/src/demo/remoteWaveformLoader.ts +114 -0
  139. package/src/demo/types.ts +11 -1
  140. package/src/demo/useRemoteWaveformWindow.ts +229 -0
  141. package/src/index.ts +54 -0
  142. package/src/router.ts +1 -0
  143. package/src/types/chart.ts +10 -1
  144. package/src/types/index.ts +2 -0
  145. package/src/utils/formatters.ts +10 -5
  146. package/src/utils/xAxisNumber.ts +36 -0
  147. package/src/views/AnimationDemo.vue +129 -0
  148. package/dist/assets/workerRuntime-5p-EI-GL.js +0 -1
  149. package/dist/types/data/sx2Channel.d.ts +0 -10
  150. package/src/data/sx2Channel.ts +0 -315
@@ -1,5 +1,5 @@
1
1
  import type { DemoChartModel } from './types';
2
- declare function resetViewport(): void;
2
+ declare function resetViewport(trackIndex?: number): void;
3
3
  type __VLS_ModelProps = {
4
4
  'model': DemoChartModel;
5
5
  };
@@ -0,0 +1,23 @@
1
+ import type { InjectionKey } from 'vue';
2
+ import type { WaveformData } from '../types';
3
+ export interface RemoteWindowRequest {
4
+ start: number;
5
+ end: number;
6
+ seriesIds?: string[];
7
+ }
8
+ export type RemoteWindowLoader = (request: RemoteWindowRequest, signal: AbortSignal) => Promise<WaveformData>;
9
+ export declare const remoteWindowLoaderKey: InjectionKey<RemoteWindowLoader>;
10
+ export interface MockWindowOptions {
11
+ delayMs?: number | ((request: RemoteWindowRequest) => number);
12
+ empty?: boolean | ((request: RemoteWindowRequest) => boolean);
13
+ fail?: boolean | ((request: RemoteWindowRequest) => boolean);
14
+ }
15
+ /** Preserve series identities even when a window has no samples. */
16
+ export declare function selectWaveformWindow(data: WaveformData, request: RemoteWindowRequest, empty?: boolean): WaveformData;
17
+ export declare function mergeWaveformWindow(current: WaveformData, response: WaveformData, seriesIds?: string[]): WaveformData;
18
+ /** Metadata is derived from the complete record, never from a loaded window. */
19
+ export declare function waveformRecordMetadata(data: WaveformData): {
20
+ domain: [number, number];
21
+ minZoomSpan: number | undefined;
22
+ };
23
+ export declare function createMockWindowLoader(source: () => WaveformData, options?: MockWindowOptions): RemoteWindowLoader;
@@ -1,4 +1,5 @@
1
- import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformFrameStyle, WaveformGridTrackLines, WaveformInteractionMode, WaveformLegendOrientation, WaveformLegendPosition, WaveformLineStyle, WaveformOverlayMode, WaveformPlotMargin, WaveformTitleOptions, WaveformZeroLineOptions, WaveformZoomEndPayload } from '../components';
1
+ import type { WaveformAnnotation, WaveformAxesOptions, WaveformData, WaveformDisplayMode, WaveformFrameStyle, WaveformGridTrackLines, WaveformInteractionMode, WaveformLegendOrientation, WaveformLegendPosition, WaveformLineStyle, WaveformOverlayMode, WaveformPlotMargin, WaveformTitleOptions, WaveformZeroLineOptions, WaveformZoomEndPayload, WaveformZoomIntentPayload } from '../components';
2
+ import type { WaveformZoomResetPayload, WaveformPanEndPayload } from '../types';
2
3
  import type { DemoXAxisLabelFormat, DemoXAxisLabelTimeZone } from './useDemoXAxisLabelControls';
3
4
  interface SelectOption<T> {
4
5
  label: string;
@@ -78,6 +79,11 @@ export interface DemoChartModel {
78
79
  toolbarVisible: boolean;
79
80
  data: WaveformData;
80
81
  initialXDomain?: [number, number];
82
+ recordDomain: [number, number];
83
+ minZoomSpan?: number;
84
+ loading: boolean;
85
+ errors: string[];
86
+ retry: () => Promise<void[]>;
81
87
  displayMode: WaveformDisplayMode;
82
88
  overlayMode: WaveformOverlayMode;
83
89
  rowCount: number;
@@ -101,6 +107,9 @@ export interface DemoChartModel {
101
107
  interactionMode: WaveformInteractionMode;
102
108
  hiddenSeriesIds: string[];
103
109
  handleZoomEnd: (payload: WaveformZoomEndPayload) => void | Promise<void>;
104
- resetWaveformViewport: () => void;
110
+ handleZoomIntent: (payload: WaveformZoomIntentPayload) => void;
111
+ handleZoomChange: (domain: [number, number]) => void;
112
+ handlePanEnd: (payload: WaveformPanEndPayload) => void | Promise<void>;
113
+ resetWaveformViewport: (payload?: WaveformZoomResetPayload) => void | Promise<void>;
105
114
  }
106
115
  export {};
@@ -0,0 +1,22 @@
1
+ import { type Ref } from 'vue';
2
+ import type { WaveformData, WaveformPanEndPayload, WaveformZoomEndPayload, WaveformZoomIntentPayload, WaveformZoomResetPayload } from '../types';
3
+ import { type RemoteWindowLoader } from './remoteWaveformLoader';
4
+ interface RemoteWindowOptions {
5
+ loadWindow?: RemoteWindowLoader;
6
+ resetViewport?: (trackIndex?: number) => void;
7
+ }
8
+ export declare function useRemoteWaveformWindow(source: Ref<WaveformData>, options?: RemoteWindowOptions): {
9
+ chartData: import("vue").ShallowRef<WaveformData, WaveformData>;
10
+ recordDomain: import("vue").ComputedRef<[number, number]>;
11
+ initialXDomain: import("vue").ComputedRef<[number, number]>;
12
+ minZoomSpan: import("vue").ComputedRef<number | undefined>;
13
+ loading: import("vue").ComputedRef<boolean>;
14
+ errors: import("vue").ComputedRef<string[]>;
15
+ handleZoomIntent: (payload: WaveformZoomIntentPayload) => void;
16
+ handleZoomChange: (domain: [number, number]) => void;
17
+ handleZoomEnd: (payload: WaveformZoomEndPayload) => Promise<void>;
18
+ handlePanEnd: (payload: WaveformPanEndPayload) => Promise<void>;
19
+ resetWaveformViewport: (payload?: WaveformZoomResetPayload) => Promise<void>;
20
+ retry: () => Promise<void[]>;
21
+ };
22
+ export {};
@@ -4,7 +4,16 @@
4
4
  */
5
5
  export { default as WaveformChart } from './components/WaveformChart.vue';
6
6
  export type { WaveformChartProps } from './components/core/waveformChartTypes';
7
- 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';
7
+ export { getEasingFunction } from './animation/core/easing';
8
+ export { WaveformAnimationController } from './animation/WaveformAnimationController';
9
+ export { createLineDrawingAnimation, createStaggeredLineDrawingAnimations, } from './animation/presets/lineDrawing';
10
+ export { createPathTransitionAnimation, createYAxisScaleAnimation, } from './animation/presets/transitions';
11
+ export { createAnnotationAppearAnimation, createAnnotationDisappearAnimation, } from './animation/presets/annotation';
12
+ export { Animation } from './animation/core/Animation';
13
+ export { Animator, globalAnimator } from './animation/core/Animator';
14
+ export type { AnimationValue, AnimationDirection, AnimationState, AnimationFrame, AnimationTrack, AnimationConfig, AnimationHandle, AnimationScheduler, EasingFunction, EasingFamily, EasingType, } from './animation/core/types';
15
+ export type { LineDrawingDirection, AnnotationAnimationType, LineDrawingOptions, StaggeredLineDrawingOptions, DataUpdateOptions, AnnotationAnimationOptions, WaveformEnterAnimationOptions, WaveformUpdateAnimationOptions, WaveformAnnotationAnimationOptions, WaveformAnimationProps, ClipAnimationState, AnimationBinding, NumericGeometry, GeometryTransitionInput, GeometryTransitionFrame, AnnotationAnimationState, AnimationScope, AnimationObjectKey, WaveformAnimationControllerOptions, } from './animation/types';
16
+ export type { WaveformAmplitudeLimit, WaveformAmplitudeLimits, 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';
8
17
  export type { WaveformGridOptions, WaveformGridLineOptions, WaveformGridTrackLines, } from './components/core/grid';
9
18
  export { normalizeWaveformData, normalizeWaveformSeries } from './core';
10
19
  export { paddedDomain, buildMinorTicks, displayTime, formatEndpointTime, formatAxisTime, formatTooltipTime, resolveTrackGeometry, clamp, type TimeUnit, type TrackGeometry, } from './utils';
@@ -68,7 +68,7 @@ export interface WaveformZoomIntentPayload extends WaveformCommandMetadata {
68
68
  trackIndex?: number;
69
69
  seriesIds?: string[];
70
70
  }
71
- /** Identifies the viewport reset by a double-click gesture. */
71
+ /** Identifies the viewport reset by a toolbar or API command. */
72
72
  export interface WaveformZoomResetPayload extends WaveformCommandMetadata {
73
73
  trackIndex?: number;
74
74
  seriesIds?: string[];
@@ -279,3 +279,10 @@ export interface WaveformZeroLineOptions {
279
279
  /** Hide within this fraction of a Y-axis tick interval from either boundary. Defaults to 0.02. */
280
280
  boundaryThreshold?: number;
281
281
  }
282
+ /** Strict amplitude display bounds, in the series' original Y units. */
283
+ export interface WaveformAmplitudeLimit {
284
+ lower?: number;
285
+ upper?: number;
286
+ }
287
+ /** Keyed by stable normalized series IDs (not track IDs). */
288
+ export type WaveformAmplitudeLimits = Record<string, WaveformAmplitudeLimit>;
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * 类型定义统一导出
3
3
  */
4
- 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';
4
+ export type { WaveformAmplitudeLimit, WaveformAmplitudeLimits, 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';
5
5
  export type { SingleWaveformData, WaveformLineType, WaveformLineStyle, WaveformPointType, WaveformErrorBarOptions, ResolvedWaveformErrorBarOptions, WaveformTypedValues, TypedSampleData, TypedPointData, WaveformSeries, WaveformData, NormalizedWaveformSeries, } from './data';
6
6
  export type { WaveformToolbarItem, WaveformToolbarOptions, WaveformControlTarget, WaveformControlAction, WaveformCommandMetadata, WaveformTargetStatus, WaveformViewportSnapshot, WaveformTargetResult, WaveformControlResult, WaveformControlState, WaveformImageExportOptions, WaveformImageExportErrorCode, WaveformImageExportError, WaveformChartHandle, } from './controls';
@@ -46,18 +46,18 @@ export declare function formatXAxisLabel(rawValue: number, domain: [number, numb
46
46
  */
47
47
  export declare function endpointFractionDigits(domain: [number, number], timeUnit: TimeUnit): number;
48
48
  /**
49
- * 将 X 轴端点时间格式化为当前显示单位下的普通十进制文本
49
+ * 将 X 轴端点时间格式化为当前显示单位下的自适应精度文本
50
50
  * @param value 时间值(秒)
51
- * @param _domain 数据域(为保持现有调用签名而保留)
51
+ * @param _domain 用于计算显示精度的可视域
52
52
  * @param timeUnit 时间单位
53
53
  * @returns 格式化的时间字符串
54
54
  */
55
55
  export declare function formatEndpointTime(value: number, _domain: [number, number], timeUnit: TimeUnit): string;
56
56
  /**
57
- * 将 X 轴时间刻度格式化为当前显示单位下的普通十进制文本
57
+ * 将 X 轴时间刻度格式化为当前显示单位下的自适应精度文本
58
58
  * @param value 时间值(秒)
59
59
  * @param timeUnit 时间单位
60
- * @param _domain 数据域(为保持现有调用签名而保留)
60
+ * @param _domain 用于计算显示精度的可视域
61
61
  * @returns 格式化的时间字符串
62
62
  */
63
63
  export declare function formatAxisTime(value: number, timeUnit: TimeUnit, _domain?: [number, number]): string;
@@ -0,0 +1,2 @@
1
+ /** Compact labels share precision so even extremely close endpoints stay distinct. */
2
+ export declare function formatXAxisNumber(value: number, domain: [number, number]): string;
@@ -0,0 +1,3 @@
1
+ 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>;
2
+ declare const _default: typeof __VLS_export;
3
+ export default _default;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "waveform-analysis",
3
- "version": "0.1.74",
3
+ "version": "0.1.76",
4
4
  "main": "./dist/index.cjs",
5
5
  "module": "./dist/index.js",
6
6
  "types": "./dist/types/index.d.ts",
@@ -44,7 +44,9 @@
44
44
  "globals": "17.7.0",
45
45
  "jsdom": "29.1.1",
46
46
  "oxlint": "1.77.0",
47
+ "playwright": "1.56.1",
47
48
  "prettier": "3.9.5",
49
+ "terser": "5.51.2",
48
50
  "typescript": "~6.0.0",
49
51
  "typescript-eslint": "8.64.0",
50
52
  "vite": "8.1.5",
@@ -70,6 +72,7 @@
70
72
  "test": "pnpm prepare:wasm && vitest run",
71
73
  "test:coverage": "pnpm prepare:wasm && vitest run --coverage",
72
74
  "test:package": "node scripts/test-package.mjs",
73
- "prepare:wasm": "node scripts/prepare-wasm.mjs"
75
+ "prepare:wasm": "node scripts/prepare-wasm.mjs",
76
+ "test:animation:browser": "node scripts/test-animation-browser.mjs"
74
77
  }
75
78
  }
package/src/App.vue CHANGED
@@ -1,5 +1,5 @@
1
1
  <script setup lang="ts">
2
- import { computed, onBeforeUnmount, onMounted, reactive, ref } from 'vue'
2
+ import { computed, inject, onBeforeUnmount, onMounted, reactive, ref, shallowRef } from 'vue'
3
3
  import 'vue3-colorpicker/style.css'
4
4
 
5
5
  import {
@@ -16,7 +16,6 @@ import {
16
16
  type WaveformOverlayMode,
17
17
  type WaveformPlotMargin,
18
18
  type WaveformTitleOptions,
19
- type WaveformZoomEndPayload,
20
19
  type WaveformZeroLineOptions,
21
20
  } from './components'
22
21
  import { normalizeWaveformSeries } from './core'
@@ -25,6 +24,8 @@ import DemoChartHost from './demo/DemoChartHost.vue'
25
24
  import DemoControlPanel from './demo/DemoControlPanel.vue'
26
25
  import type { DemoChartModel, DemoControlPanelModel } from './demo/types'
27
26
  import { useDemoXAxisLabelControls } from './demo/useDemoXAxisLabelControls'
27
+ import { remoteWindowLoaderKey } from './demo/remoteWaveformLoader'
28
+ import { useRemoteWaveformWindow } from './demo/useRemoteWaveformWindow'
28
29
 
29
30
  const demoPreset = new URLSearchParams(window.location.search).get('demo')
30
31
  const compactNineDemo = demoPreset === 'compact-nine'
@@ -164,20 +165,27 @@ const plotMargin = computed<WaveformPlotMargin>(() => ({
164
165
  bottom: plotMarginBottom.value,
165
166
  }))
166
167
 
167
- const initialXValues = normalizeWaveformSeries(fullChartData).flatMap((series) =>
168
- series.points.map((point) => point.x),
169
- )
170
- const [initialXMinimum, initialXMaximum] = initialXValues.reduce<[number, number]>(
171
- ([minimum, maximum], value) => [Math.min(minimum, value), Math.max(maximum, value)],
172
- [Number.POSITIVE_INFINITY, Number.NEGATIVE_INFINITY],
173
- )
174
- const initialXDomainValue: [number, number] | undefined =
175
- Number.isFinite(initialXMinimum) && Number.isFinite(initialXMaximum)
176
- ? [initialXMinimum, initialXMaximum]
177
- : undefined
178
- // Keep the full source domain stable while viewport data windows are replaced.
179
- const initialXDomain = ref<[number, number] | undefined>(initialXDomainValue)
180
- const chartData = ref<WaveformData>(fullChartData)
168
+ const demoChartHostRef = ref<{ resetViewport: (trackIndex?: number) => void }>()
169
+ const sourceData = shallowRef<WaveformData>(fullChartData)
170
+ const remoteWindow = useRemoteWaveformWindow(sourceData, {
171
+ loadWindow: inject(remoteWindowLoaderKey, undefined),
172
+ resetViewport: (trackIndex) => demoChartHostRef.value?.resetViewport(trackIndex),
173
+ })
174
+ const {
175
+ chartData,
176
+ initialXDomain,
177
+ recordDomain,
178
+ minZoomSpan,
179
+ loading,
180
+ errors,
181
+ handleZoomIntent,
182
+ handleZoomChange,
183
+ handleZoomEnd,
184
+ handlePanEnd,
185
+ resetWaveformViewport,
186
+ retry,
187
+ } = remoteWindow
188
+ onMounted(() => void resetWaveformViewport())
181
189
  const lineStyleOverrides = ref<Record<string, WaveformLineStyle>>({})
182
190
  const selectedSeriesId = ref(
183
191
  fullChartData.kind === 'series' ? (fullChartData.series[0]?.id ?? '') : '',
@@ -188,7 +196,7 @@ const lineStyleOptions: Array<{ label: string; value: WaveformLineStyle }> = [
188
196
  { label: '点划线', value: 'dash-dot' },
189
197
  ]
190
198
  const seriesStyleOptions = computed(() =>
191
- normalizeWaveformSeries(chartData.value).map((series) => ({
199
+ normalizeWaveformSeries(sourceData.value).map((series) => ({
192
200
  label: series.name || series.id,
193
201
  value: series.id,
194
202
  })),
@@ -214,7 +222,7 @@ const displayChartData = computed<WaveformData>(() => {
214
222
  })
215
223
  const gridTrackLines = computed<WaveformGridTrackLines>(() =>
216
224
  Object.fromEntries(
217
- normalizeWaveformSeries(displayChartData.value).map((series) => [
225
+ normalizeWaveformSeries(sourceData.value).map((series) => [
218
226
  series.trackId ?? series.id,
219
227
  {
220
228
  horizontal: horizontalGridVisible.value,
@@ -225,88 +233,6 @@ const gridTrackLines = computed<WaveformGridTrackLines>(() =>
225
233
  ]),
226
234
  ),
227
235
  )
228
- const demoChartHostRef = ref<{ resetViewport: (trackIndex?: number) => void }>()
229
-
230
- let zoomRequestSequence = 0
231
-
232
- function filterWaveformData(data: WaveformData, start: number, end: number): WaveformData {
233
- const lower = Math.min(start, end)
234
- const upper = Math.max(start, end)
235
- if (data.kind !== 'series') {
236
- if (data.kind !== 'points') return data
237
- return {
238
- kind: 'points',
239
- points: data.points.filter((point) => point.x >= lower && point.x <= upper),
240
- }
241
- }
242
- return {
243
- kind: 'series',
244
- series: data.series.map((series) => ({
245
- ...series,
246
- data:
247
- series.data.kind === 'points'
248
- ? {
249
- kind: 'points',
250
- points: series.data.points.filter((point) => point.x >= lower && point.x <= upper),
251
- }
252
- : series.data,
253
- })),
254
- }
255
- }
256
-
257
- function mergeIndependentWindow(
258
- currentData: WaveformData,
259
- responseData: WaveformData,
260
- seriesIds: string[],
261
- ): WaveformData {
262
- if (currentData.kind !== 'series' || responseData.kind !== 'series') return responseData
263
- const responseById = new Map(responseData.series.map((series) => [series.id, series]))
264
- const changedIds = new Set(seriesIds)
265
- return {
266
- kind: 'series',
267
- series: currentData.series.map((series) =>
268
- series.id && changedIds.has(series.id) ? (responseById.get(series.id) ?? series) : series,
269
- ),
270
- }
271
- }
272
-
273
- let pendingCommandId: string | undefined
274
- let pendingPayloads: WaveformZoomEndPayload[] = []
275
- async function handleZoomEnd(payload: WaveformZoomEndPayload) {
276
- if (payload.action === 'fit') return
277
- if (payload.commandId && payload.commandId === pendingCommandId) {
278
- pendingPayloads.push(payload)
279
- return
280
- }
281
- pendingCommandId = payload.commandId
282
- const batch = [payload]
283
- pendingPayloads = batch
284
- // Demo-only sequence number cancellation. Production code should use AbortController
285
- // to cancel in-flight requests when a newer zoom gesture arrives.
286
- const requestSequence = ++zoomRequestSequence
287
- await new Promise((resolve) => window.setTimeout(resolve, 80))
288
- if (requestSequence !== zoomRequestSequence) return
289
-
290
- // Demo-only stand-in for the backend response. Production code should replace this
291
- // with a request using payload.start/payload.end and the optional channel metadata.
292
- let nextData = chartData.value
293
- batch.forEach((item) => {
294
- const responseData = filterWaveformData(fullChartData, item.start, item.end)
295
- nextData =
296
- item.trackIndex !== undefined && item.seriesIds?.length
297
- ? mergeIndependentWindow(nextData, responseData, item.seriesIds)
298
- : responseData
299
- })
300
- chartData.value = nextData
301
- pendingCommandId = undefined
302
- }
303
-
304
- function resetWaveformViewport() {
305
- zoomRequestSequence += 1
306
- chartData.value = fullChartData
307
- initialXDomain.value = initialXDomainValue
308
- demoChartHostRef.value?.resetViewport()
309
- }
310
236
  const titleOptions = computed<WaveformTitleOptions>(() => ({
311
237
  visible: titleVisible.value,
312
238
  text: titleText.value,
@@ -406,6 +332,11 @@ const chartModel = reactive({
406
332
  toolbarVisible,
407
333
  data: displayChartData,
408
334
  initialXDomain,
335
+ recordDomain,
336
+ minZoomSpan,
337
+ loading,
338
+ errors,
339
+ retry,
409
340
  displayMode,
410
341
  overlayMode,
411
342
  rowCount,
@@ -428,7 +359,10 @@ const chartModel = reactive({
428
359
  annotationsVisible,
429
360
  interactionMode,
430
361
  hiddenSeriesIds,
362
+ handleZoomIntent,
363
+ handleZoomChange,
431
364
  handleZoomEnd,
365
+ handlePanEnd,
432
366
  resetWaveformViewport,
433
367
  }) satisfies DemoChartModel
434
368
  </script>
@@ -5,6 +5,7 @@
5
5
  <nav class="demo-shell__nav" aria-label="示例导航">
6
6
  <RouterLink to="/">综合示例</RouterLink>
7
7
  <RouterLink to="/fixed-y-domain">固定振幅范围</RouterLink>
8
+ <RouterLink to="/animation">动画</RouterLink>
8
9
  <RouterLink to="/wasm-sampling">WASM 采样</RouterLink>
9
10
  </nav>
10
11
  </header>