@rfkit/spectrum-analyzer 0.1.42 → 0.1.44

package/wasm/core/LevelStreamAnalyzer/types.d.ts

@@ -0,0 +1,13 @@
+export interface LevelStreamConfig {
+    cacheTime: number;
+    granularity: number;
+    range: [number, number];
+    maxPoints?: number;
+    onLevelStreamUpdate: (data: LevelStreamOutputData) => void;
+}
+export interface LevelStreamOutputData {
+    probabilityRangeData: Float32Array;
+    spectrumData: Float32Array;
+    timestampData: Float64Array;
+}
+//# sourceMappingURL=types.d.ts.map

package/wasm/core/LevelStreamAnalyzer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/LevelStreamAnalyzer/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,EAAE,YAAY,CAAC;IACnC,YAAY,EAAE,YAAY,CAAC;IAE3B,aAAa,EAAE,YAAY,CAAC;CAC7B"}

package/wasm/core/SeriesManager/constants.d.ts

@@ -0,0 +1,10 @@
+import { GraphicType, OrientationType } from './types';
+export declare const DEFAULT_SERIES_CONFIG: {
+    readonly thickness: 1;
+    readonly orientation: OrientationType.Horizontal;
+    readonly display: true;
+    readonly type: GraphicType.Line;
+    readonly color: "#00000000";
+    readonly label: "";
+};
+//# sourceMappingURL=constants.d.ts.map

package/wasm/core/SeriesManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/core/SeriesManager/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC"}

package/wasm/core/SeriesManager/index.d.ts

@@ -0,0 +1,112 @@
+import type { SeriesChangeCallback, SeriesConfig, SeriesSubscriber, SubscriptionOptions } from './types';
+/**
+ * Series 处理工具，用于管理图形系列的配置
+ * 支持初始化、属性设置、变更回调和订阅功能
+ */
+export default class SeriesManager {
+    private seriesMap;
+    private changeCallbacks;
+    private subscribers;
+    /**
+     * 构造函数，支持初始化系列配置
+     * @param initialSeries 初始系列配置数组
+     */
+    constructor(initialSeries?: SeriesConfig[]);
+    /**
+     * 初始化系列配置
+     * @param seriesConfigs 系列配置数组
+     */
+    private initializeSeries;
+    /**
+     * 添加新的系列配置
+     * @param config 系列配置
+     */
+    addSeries(config: SeriesConfig): void;
+    /**
+     * 获取指定名称的系列配置
+     * @param name 系列名称
+     * @returns 系列配置或 undefined
+     */
+    getSeries(name: string): SeriesConfig | undefined;
+    /**
+     * 获取所有系列配置
+     * @returns 所有系列配置的数组
+     */
+    getAllSeries(): SeriesConfig[];
+    /**
+     * 获取当前所有配置
+     * @returns 包含所有系列配置的对象，以系列名为键
+     */
+    getAllConfigs(): Record<string, SeriesConfig>;
+    /**
+     * 设置指定系列的某个属性
+     * @param name 系列名称
+     * @param property 属性名
+     * @param value 属性值
+     * @returns 是否设置成功
+     */
+    setSeriesProperty<K extends keyof SeriesConfig>(name: string, property: K, value: SeriesConfig[K]): boolean;
+    /**
+     * 删除指定名称的系列
+     * @param name 系列名称
+     * @returns 是否删除成功
+     */
+    removeSeries(name: string): boolean;
+    /**
+     * 检查系列是否存在
+     * @param name 系列名称
+     * @returns 是否存在
+     */
+    hasSeries(name: string): boolean;
+    /**
+     * 添加变更回调函数
+     * @param callback 回调函数
+     */
+    onChange(callback: SeriesChangeCallback): void;
+    /**
+     * 移除变更回调函数
+     * @param callback 要移除的回调函数
+     */
+    offChange(callback: SeriesChangeCallback): void;
+    /**
+     * 通知所有回调函数属性变更
+     * @param name 系列名称
+     * @param property 属性名
+     * @param value 新值
+     */
+    private notifyChange;
+    /**
+     * 清空所有系列配置
+     */
+    clear(): void;
+    /**
+     * 获取系列数量
+     * @returns 系列数量
+     */
+    size(): number;
+    /**
+     * 订阅系列变更事件
+     * @param subscriber 订阅回调函数
+     * @param options 订阅选项
+     * @returns 取消订阅的函数
+     */
+    subscribe(subscriber: SeriesSubscriber, options?: SubscriptionOptions): () => void;
+    /**
+     * 取消订阅
+     * @param subscriber 要取消的订阅回调函数
+     */
+    unsubscribe(subscriber: SeriesSubscriber): void;
+    /**
+     * 发送事件给所有订阅者
+     * @param event 事件数据
+     */
+    private emitEvent;
+    /**
+     * 判断是否应该通知订阅者
+     * @param subscriber 订阅者
+     * @param event 事件数据
+     * @returns 是否应该通知
+     */
+    private shouldNotifySubscriber;
+}
+//# sourceMappingURL=index.d.ts.map

package/wasm/core/SeriesManager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/SeriesManager/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAGjB;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAEhC,OAAO,CAAC,SAAS,CAAwC;IAEzD,OAAO,CAAC,eAAe,CAA8B;IAErD,OAAO,CAAC,WAAW,CAAyD;IAE5E;;;OAGG;gBACS,aAAa,GAAE,YAAY,EAAO;IAI9C;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAgB5C;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxD;;;OAGG;IACI,YAAY,IAAI,YAAY,EAAE;IAIrC;;;OAGG;IACI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAQpD;;;;;;OAMG;IACI,iBAAiB,CAAC,CAAC,SAAS,MAAM,YAAY,EACnD,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GACrB,OAAO;IAiCV;;;;OAIG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAoB1C;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIvC;;;OAGG;IACI,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIrD;;;OAGG;IACI,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAOtD;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACI,KAAK,IAAI,IAAI;IASpB;;;OAGG;IACI,IAAI,IAAI,MAAM;IAIrB;;;;;OAKG;IACI,SAAS,CACd,UAAU,EAAE,gBAAgB,EAC5B,OAAO,GAAE,mBAAwB,GAChC,MAAM,IAAI;IA4Bb;;;OAGG;IACI,WAAW,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAItD;;;OAGG;IACH,OAAO,CAAC,SAAS;IASjB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;CAuB/B"}

package/wasm/core/SeriesManager/types.d.ts

@@ -0,0 +1,43 @@
+export interface SeriesConfig {
+    readonly name: string;
+    label: string;
+    color: string;
+    display: boolean;
+    type: GraphicType;
+    thickness?: number;
+    orientation?: OrientationType;
+}
+export declare enum OrientationType {
+    Horizontal = "horizontal",
+    Vertical = "vertical"
+}
+export declare enum GraphicType {
+    Circle = "circle",
+    Rect = "rect",
+    Line = "line",
+    Stepline = "stepline",
+    Bar = "bar",
+    Area = "area"
+}
+export type SeriesChangeCallback = (name: string, property: keyof SeriesConfig, value: SeriesConfig[keyof SeriesConfig]) => void;
+export declare enum SeriesEventType {
+    PropertyChanged = "propertyChanged",
+    SeriesAdded = "seriesAdded",
+    SeriesRemoved = "seriesRemoved",
+    SeriesCleared = "seriesCleared"
+}
+export interface SeriesEventData {
+    type: SeriesEventType;
+    name?: string;
+    property?: keyof SeriesConfig;
+    value?: SeriesConfig[keyof SeriesConfig];
+    oldValue?: SeriesConfig[keyof SeriesConfig];
+    series?: SeriesConfig;
+}
+export type SeriesSubscriber = (event: SeriesEventData) => void;
+export interface SubscriptionOptions {
+    immediate?: boolean;
+    eventTypes?: SeriesEventType[];
+    seriesNames?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/wasm/core/SeriesManager/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/SeriesManager/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,oBAAY,eAAe;IACzB,UAAU,eAAe;IACzB,QAAQ,aAAa;CACtB;AAED,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,YAAY,EAC5B,KAAK,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,KACpC,IAAI,CAAC;AAGV,oBAAY,eAAe;IACzB,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;CAChC;AAGD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,YAAY,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAGD,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAGhE,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/wasm/core/SpectrumAnalyzer/constants.d.ts

@@ -0,0 +1,41 @@
+export declare const SPECTRUM: {
+    readonly INITIAL_VALUE: number;
+    readonly WATERFALL_MAX_FRAMES: 100;
+    readonly OUTPUT_POINTS: 1001;
+};
+export declare const PEAK_DETECTION: {
+    readonly MAX_PEAKS: 2;
+};
+export declare const DEFAULT_SPECTRUM_CONFIG: {
+    readonly maxPoints: 1001;
+    readonly waterfallMaxFrames: 100;
+    readonly initialValue: number;
+    readonly processing: {
+        readonly enableWaterfall: false;
+        readonly enableMetrics: false;
+        readonly enableFluorescence: false;
+        readonly enablePeakStats: false;
+    };
+    readonly peakDetection: {
+        readonly maxPeaks: 2;
+    };
+    readonly outputPoints: 1001;
+    readonly outputRange: {
+        readonly start: 0;
+        readonly end: 1001;
+    };
+    readonly templateTolerance: 0;
+};
+export declare const ERROR_MESSAGES: {
+    readonly EMPTY_SEGMENTS: "频段配置不能为空";
+    readonly INVALID_CONFIG: "必须且只能配置 segments 或 bandwidthConfig 其中之一";
+    readonly EMPTY_BANDWIDTH: "bandwidthConfig 不能为空";
+    readonly INVALID_SEGMENT: (index: number) => string;
+    readonly INDEX_OUT_OF_BOUNDS: (index: number) => string;
+    readonly INVALID_ANTENNA_FACTOR_LENGTH: (points: number) => string;
+    readonly INVALID_ANTENNA_FACTOR: "天线因子数据必须是有效的正数";
+    readonly INVALID_SAMPLING_RANGE: "采样范围无效";
+    readonly INVALID_MAX_POINTS: "点数必须大于0";
+    readonly INVALID_LENGTH: (expected: number) => string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/wasm/core/SpectrumAnalyzer/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/core/SpectrumAnalyzer/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;CAmB1B,CAAC;AAEX,eAAO,MAAM,cAAc;;;;sCAIA,MAAM;0CACF,MAAM;qDACK,MAAM;;;;wCAKnB,MAAM;CAEzB,CAAC"}

package/wasm/core/SpectrumAnalyzer/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class SpectrumError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+export declare class DataValidationError extends SpectrumError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * 索引越界错误
+ */
+export declare class IndexOutOfBoundsError extends SpectrumError {
+    readonly index: number;
+    constructor(message: string, index: number, details?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/wasm/core/SpectrumAnalyzer/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/core/SpectrumAnalyzer/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;aAGpC,KAAK,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,OAAO;CAOpB"}

package/wasm/core/SpectrumAnalyzer/index.d.ts

@@ -0,0 +1,219 @@
+import type { isValidFloat32Array, ProcessInput, ScanSegment, SpectrumConfig, SpectrumOutputData, TemplateOverData, TimestampedFloat32Array } from './types';
+import { ExtraDataMode } from './types';
+export default class SpectrumAnalyzer {
+    config: Required<Omit<SpectrumConfig, 'segments' | 'bandwidthConfig' | 'onSpectrumUpdate'>>;
+    private segments;
+    antennaFactorData: Float32Array;
+    antennaFactorSwitch: boolean;
+    protected realData: TimestampedFloat32Array;
+    protected maxData: isValidFloat32Array;
+    protected minData: isValidFloat32Array;
+    protected avgData: isValidFloat32Array;
+    protected templateData: Float32Array;
+    protected occupancyData: Float32Array;
+    protected backgroundNoiseData: Float32Array;
+    protected waterfallData: TimestampedFloat32Array[];
+    srcIndexCache: Uint32Array;
+    protected realOutputData: Float32Array;
+    protected maxOutputData: Float32Array;
+    protected minOutputData: Float32Array;
+    protected avgOutputData: Float32Array;
+    protected templateOutputData: Float32Array;
+    protected occupancyOutputData: Float32Array;
+    protected backgroundNoiseOutputData: Float32Array;
+    protected waterfallOutputData: TimestampedFloat32Array[];
+    protected scanProgress: number;
+    protected lastIndex: number;
+    protected processTimes: number;
+    protected lastProcessTime: number;
+    protected cachedExceedingDatas: TemplateOverData[];
+    protected fluorescenceData?: Map<number, number>[];
+    protected fluorescenceMaxCount: number;
+    extraData: Record<string, Float32Array>;
+    protected extraOutputData: Record<string, Float32Array>;
+    private pendingDataFlags;
+    private hasPendingData;
+    private hasProcessedData;
+    private isProcessing;
+    private readonly onSpectrumUpdate?;
+    constructor(config: Partial<SpectrumConfig>);
+    /**
+     * 处理输入数据，包括验证、拼接、统计、采样等操作。
+     * @param {ProcessInput} input - 输入数据，包含数据、时间戳、分段偏移和偏移量。
+     */
+    process({ data, timestamp, segmentOffset, offset }: ProcessInput): void;
+    /**
+     * 初始化扫描分段信息，并更新最大点数。
+     * @param {ScanSegment[]} segments - 扫描分段信息数组。
+     */
+    initializeSegments(segments: ScanSegment[]): void;
+    /**
+     * 设置天线因子数据，并根据开关状态重新输出数据。
+     * @param {Float32Array} data - 天线因子数据，默认为根据最大点数创建的数组。
+     */
+    setAntennaFactor(d: Float32Array | number[]): void;
+    /**
+     * 设置天线因子开关，并根据开关状态重新输出数据。
+     * @param {boolean} newAntennaFactorSwitch - 新的天线因子开关状态。
+     */
+    setAntennaFactorSwitch(newAntennaFactorSwitch: boolean): void;
+    /**
+     * 设置瀑布图数据，用于从外部导入已缓存的瀑布图数据。
+     * @param {TimestampedFloat32Array[]} data - 瀑布图数据数组。
+     */
+    setWaterfallData(newWaterfallData: TimestampedFloat32Array[]): void;
+    /**
+     * 设置实时值数据，用于从外部导入已缓存的实时值数据。
+     * @param {TimestampedFloat32Array} data - 实时值数据。
+     */
+    setRealData(data: TimestampedFloat32Array): void;
+    /**
+     * 设置最大值数据，用于从外部导入已缓存的最大值数据。
+     * @param {Float32Array} data - 最大值数据。
+     */
+    setMaxData(data: Float32Array): void;
+    /**
+     * 设置最小值数据，用于从外部导入已缓存的最小值数据。
+     * @param {Float32Array} data - 最小值数据。
+     */
+    setMinData(data: Float32Array): void;
+    /**
+     * 设置平均值数据，用于从外部导入已缓存的平均值数据。
+     * @param {Float32Array} data - 平均值数据。
+     */
+    setAvgData(data: Float32Array): void;
+    /**
+     * 设置占用度数据
+     * @param {Float32Array | number[]} data - 占用度数据
+     */
+    setOccupancyData(data?: Float32Array | number[]): void;
+    /**
+     * 重置频谱分析器的状态，包括数据和进度。
+     */
+    /**
+     * 设置额外数据
+     * @param data 数据对象
+     * @param mode 操作模式：ExtraDataMode.REPLACE(替换全部), ExtraDataMode.MERGE(合并), ExtraDataMode.UPDATE(更新已存在的键)
+     */
+    setExtraData(data: Record<string, Float32Array | number[]> | null, mode?: ExtraDataMode): void;
+    reset(preserveProcessedFlag?: boolean): void;
+    /**
+     * 获取频谱分析器的性能指标，包括处理时间、数据点数、瀑布图帧数、初始化状态和内存使用情况。
+     * @returns {Readonly<Record<string, number | boolean>>} - 包含性能指标的对象。
+     */
+    getPerformanceMetrics(): Readonly<Record<string, number | boolean>>;
+    /**
+     * 获取当前实时数据的峰值统计信息
+     * @returns {PeakStats | undefined} - 峰值统计信息，如果未启用峰值检测则返回 undefined
+     */
+    getPeakStats(): import('./types').PeakStats | undefined;
+    /**
+     * 更新采样范围，并重新输出数据。
+     * @param {number} start - 采样范围的起始位置。
+     * @param {number} end - 采样范围的结束位置。
+     * @returns {Uint32Array} - 输出值对应的原始数据索引数组。
+     */
+    updateSamplingRange(start: number, end: number): Uint32Array;
+    /**
+     * 设置模板数据
+     * @param {Float32Array | number[]} data - 模板数据
+     * @param {number} templateTolerance - 可选，模板超出计算的容差值
+     */
+    setTemplateData(data?: Float32Array | number[], templateTolerance?: number): void;
+    /**
+     * 设置背景噪声数据
+     * @param {Float32Array | number[]} data - 背景噪声数据
+     */
+    setBackgroundNoiseData(data?: Float32Array | number[]): void;
+    /**
+     * 统一的超出数据段计算和缓存更新方法
+     * @param forceFullCalculation - 是否强制进行全量计算
+     * @param incrementalRange - 增量计算的范围
+     * @returns 计算得到的超出数据段
+     */
+    private updateTemplateOverData;
+    /**
+     * 对数据进行重采样，生成频谱输出数据。
+     * @returns {Partial<SpectrumOutputData>} - 包含重采样后的实时数据、最大值、最小值和平均值的对象。
+     */
+    protected resampleDataSeries(): Partial<SpectrumOutputData>;
+    /**
+     * 处理 extraData 的重采样，生成 extraOutputData
+     * 利用现有的 srcIndexCache 进行高效重采样
+     */
+    /**
+     * 对瀑布图输出数据进行重采样。
+     */
+    protected resampleWaterfallOutputData(): void;
+    /**
+     * 更新瀑布图数据，包括添加新数据和移除旧数据。
+     * @param {TimestampedFloat32Array} data - 输入的实时数据。
+     * @param {TimestampedFloat32Array} outputData - 输出的实时数据。
+     */
+    protected updateWaterfallData(data: TimestampedFloat32Array, outputData: TimestampedFloat32Array): void;
+    /**
+     * 更新最大点数，并重置。
+     * @param {number} maxPoints - 新的最大点数。
+     */
+    protected updateMaxPoints(maxPoints: number): void;
+    /**
+     * 验证输入数据的索引是否在有效范围内。
+     * @param {Float32Array} data - 输入数据。
+     * @param {number} index - 数据的起始索引。
+     */
+    protected validateInput(data: Float32Array, index: number): void;
+    /**
+     * 统计计算，处理数据点，更新统计值（最大值、最小值、平均值）。
+     * @param {Float32Array} data - 输入数据。
+     * @param {number} index - 数据的起始索引。
+     * @param {boolean} isOver - 数据是否处理完成。
+     */
+    private processDataPoints;
+    /**
+     * 在原始数据上更新荧光谱统计数据，确保使用正确的索引系统
+     * 优化版本：减少不必要的计算和内存访问
+     */
+    private updateFluorescenceStats;
+    /**
+     * 设置待处理标记并更新快速检查标记
+     */
+    private setPendingFlag;
+    /**
+     * 重采样单个数据数组（统一的重采样逻辑，避免代码重复）
+     */
+    private resampleSingleData;
+    /**
+     * 处理待处理的数据（在 srcIndexCache 生成后）
+     * 用于解决数据设置和实时数据处理的时序问题
+     */
+    private processPendingData;
+    /**
+     * 通知频谱数据更新，调用回调函数。
+     * @param {SpectrumOutputData} processedData - 处理后的频谱数据。
+     */
+    private notifySpectrumUpdate;
+    /**
+     * 计算当前频谱分析器的内存使用情况。
+     * @returns {number} - 内存使用量（字节）。
+     */
+    private calculateMemoryUsage;
+    /**
+     * 获取输出数据，根据配置的输出范围截取数据。
+     * @param {TimestampedFloat32Array} [data] - 可选的输入数据，默认为实时数据。
+     * @returns {Readonly<TimestampedFloat32Array>} - 输出数据。
+     */
+    private getOutputData;
+    /**
+     * 获取指定范围的荧光谱数据。
+     * @param {Map<number, number>[] | undefined} data - 荧光谱数据，如果未提供则使用实例的荧光谱数据。
+     * @returns {Map<number, number>[] | undefined} - 输出范围内的荧光谱数据。
+     */
+    private getFluorescenceOutputData;
+    /**
+     * 获取所有原始数据，包括实时数据、最大值、最小值、平均值、模板数据、背景噪声数据和瀑布图数据。
+     * 注意：返回的是输出数据（重采样后），而不是输入数据。
+     * 返回的 realData 长度为 outputPoints，与 peaks 的 index 范围一致。
+     */
+    getAllRawData(): Readonly<SpectrumOutputData>;
+}
+//# sourceMappingURL=index.d.ts.map

package/wasm/core/SpectrumAnalyzer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/SpectrumAnalyzer/index.ts"],"names":[],"mappings":"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"}

package/wasm/core/SpectrumAnalyzer/tools.d.ts

@@ -0,0 +1,93 @@
+/**
+ * SpectrumAnalyzer 工具函数
+ *
+ * [SYNC-WASM] 本文件包含需要与 Rust WASM 版本同步维护的核心算法
+ * @see src-rust/src/spectrum_analyzer/resampler.rs
+ * @see src-rust/src/spectrum_analyzer/template.rs
+ */
+import type { TemplateOverData, TimestampedFloat32Array } from './types';
+export declare const arrayKeepAttribute: (source: Float32Array & {
+    max?: number;
+    maxIndex?: number;
+    timestamp?: number;
+    progress?: number;
+}, target: Float32Array & {
+    max?: number;
+    maxIndex?: number;
+    timestamp?: number;
+    progress?: number;
+}) => void;
+export declare const resample: ({ realData, antennaFactorData, antennaFactorSwitch, outputPoints }: {
+    realData: TimestampedFloat32Array;
+    antennaFactorData: Float32Array;
+    antennaFactorSwitch?: boolean;
+    outputPoints: number;
+}) => {
+    realOutputData: TimestampedFloat32Array;
+    srcIndexCache: Uint32Array;
+};
+/**
+ * [SYNC-WASM] 多数据系列重采样
+ * @sync src-rust/src/spectrum_analyzer/resampler.rs:resample_multiple
+ *
+ * 从 maxPoints 重采样到 outputPoints，对每个区间取最大值
+ * 支持同时处理 real/max/min/avg/template/occupancy/backgroundNoise/fluorescence 数据
+ * 支持在重采样过程中同时检测峰值（零性能损耗）
+ */
+export declare const resampleMultiple: ({ antennaFactorData, antennaFactorSwitch, outputPoints, realData, maxData, minData, avgData, templateData, backgroundNoiseData, fluorescenceData, occupancyData, enablePeakStats, maxPeaks, outputRangeStart }: {
+    antennaFactorData: Float32Array;
+    antennaFactorSwitch?: boolean;
+    outputPoints: number;
+    realData: TimestampedFloat32Array;
+    maxData?: Float32Array;
+    minData?: Float32Array;
+    avgData?: Float32Array;
+    templateData?: Float32Array;
+    occupancyData?: Float32Array;
+    backgroundNoiseData?: Float32Array;
+    fluorescenceData?: Map<number, number>[];
+    enablePeakStats?: boolean;
+    maxPeaks?: number;
+    outputRangeStart?: number;
+}) => {
+    realOutputData: TimestampedFloat32Array;
+    maxOutputData: Float32Array;
+    minOutputData: Float32Array;
+    avgOutputData: Float32Array;
+    templateOutputData: Float32Array;
+    occupancyOutputData: Float32Array;
+    backgroundNoiseOutputData: Float32Array;
+    srcIndexCache: Uint32Array;
+    fluorescenceOutputData: Map<number, number>[];
+};
+/**
+ * [SYNC-WASM] 额外数据重采样
+ * @sync src-rust/src/spectrum_analyzer/resampler.rs:resample_extra_data
+ *
+ * 专门用于处理 extraData 的重采样，支持天线因子应用
+ * 高性能优化版本：预分配内存，消除重复代码，集成 getOutputData 处理
+ */
+export declare const resampleExtraData: (extraData: Record<string, Float32Array>, antennaFactorData: Float32Array, antennaFactorSwitch: boolean, srcIndexCache: Uint32Array, getOutputData: (data: Float32Array) => Float32Array) => Record<string, Float32Array>;
+/**
+ * [SYNC-WASM] 全量版本：使用预分配优化的完整数据扫描
+ * @sync src-rust/src/spectrum_analyzer/template.rs:find_exceeding_datas
+ */
+export declare const findExceedingDatas: ({ realData, maxData, minData, templateData, tolerance }: {
+    realData: TimestampedFloat32Array;
+    maxData: Float32Array;
+    minData: Float32Array;
+    templateData: Float32Array;
+    tolerance?: number;
+}) => TemplateOverData[];
+export declare const findExceedingDatasIncremental: ({ realData, maxData, minData, templateData, tolerance, startIndex, endIndex, previousSegments }: {
+    realData: TimestampedFloat32Array;
+    maxData: Float32Array;
+    minData: Float32Array;
+    templateData: Float32Array;
+    tolerance?: number;
+    startIndex: number;
+    endIndex: number;
+    previousSegments?: TemplateOverData[];
+}) => TemplateOverData[];
+export declare function isAllValid(arr: Float32Array): boolean;
+//# sourceMappingURL=tools.d.ts.map

package/wasm/core/SpectrumAnalyzer/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/core/SpectrumAnalyzer/tools.ts"],"names":[],"mappings":"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"}