@rfkit/spectrum-analyzer 0.4.0 → 0.6.0

package/README.md

@@ -18,6 +18,7 @@ pnpm add @rfkit/spectrum-analyzer
 
 ```typescript
 import {
+  ExtraDataMode,
   SpectrumAnalyzer,
   LevelStreamAnalyzer,
   type SpectrumConfig,
@@ -37,15 +38,32 @@ const analyzer = new SpectrumAnalyzer({
 analyzer.process({ data: Float32Array, timestamp: Date.now() });
 ```
 
+### 分段额外数据
+
+`setExtraData` 默认保持完整数组设置语义。传入第三个参数后，每条额外数据会独立维护全长缓冲区，并按 `segmentOffset + offset` 局部写入；未写入的位置保留为 `NaN`。
+
+```typescript
+analyzer.setExtraData(
+  {
+    traceA: traceAChunk,
+    traceB: traceBChunk,
+  },
+  ExtraDataMode.MERGE,
+  { segmentOffset: 1, offset: 200 },
+);
+```
+
 ### WASM 高性能版本
 
-`SpectrumAnalyzer` 和 `LevelStreamAnalyzer` 的 WASM API 与 JS 版本一致；`WaterfallAnalyzer` 当前仅提供 JS 版本。
+`SpectrumAnalyzer` 和 `LevelStreamAnalyzer` 的 WASM API 与 JS 版本一致；`WaterfallAnalyzer` 和 `SeriesManager` 为纯 JS 实现，同样可从 `/wasm` 入口导入（重导出）。
 
 ```typescript
 import {
   initWasm,
   SpectrumAnalyzer,
   LevelStreamAnalyzer,
+  WaterfallAnalyzer,
+  SeriesManager,
 } from '@rfkit/spectrum-analyzer/wasm';
 
 // 应用启动时初始化（仅需一次）
@@ -64,15 +82,6 @@ const analyzer = new SpectrumAnalyzer({
 analyzer.process({ data: Float32Array, timestamp: Date.now() });
 ```
 
-## 性能对比
-
-| 场景 | JS 版本 | WASM 版本 | 提升 |
-|------|---------|-----------|------|
-| 8192 点数据 | 0.032 ms | 0.020 ms | **35%** |
-| 2000 点 / 300Hz | 0.023 ms | 0.020 ms | **13%** |
-
-两个版本在 300Hz 更新频率下都能轻松满足，CPU 占用 < 1%。
-
 ## 核心组件
 
 ### SpectrumAnalyzer
@@ -85,7 +94,7 @@ analyzer.process({ data: Float32Array, timestamp: Date.now() });
 - 模板超限检测
 - 多段频率扫描
 
-### WaterfallAnalyzer（仅 JS 版本）
+### WaterfallAnalyzer
 
 独立瀑布图数据分析器，支持完整矩阵更新、增量帧，以及 X/Y 二维裁剪与降采样。采样范围使用原始矩阵索引的半开区间 `[start, end)`：
 
@@ -107,11 +116,9 @@ analyzer.updateSamplingRange({
 });
 ```
 
-`setData()` 要求数据为非空等宽矩阵，传入空数组表示清空；它只浅拷贝外层数组，因此调用方必须将输入帧以及 `getSnapshot()` 返回的帧和索引按只读数据处理。`appendFrame()` 会复制单个新增帧，实时增量场景应配置 `maxFrames`，避免缓存无限增长。
-
-小数采样范围会对 `start` 向下取整、对 `end` 向上取整，并夹紧到矩阵边界；夹紧后为空的范围会报错。`columnIndices` 表示每个 X 输出 bin 的代表中心列，不表示该 bin 最大值的真实来源列。
+`setData()` 要求数据为非空等宽矩阵，传入空数组表示清空；`appendFrame()` 用于实时增量场景，应配置 `maxFrames` 避免缓存无限增长。采样范围会夹紧到矩阵边界，夹紧后为空的范围会报错。
 
-`WaterfallAnalyzer` 首期仅从默认 JS 入口导出，暂不从 `/wasm` 入口提供。
+`WaterfallAnalyzer` 为纯 JS 实现，可从默认入口或 `/wasm` 入口导入。
 
 ### LevelStreamAnalyzer
 
@@ -119,21 +126,6 @@ analyzer.updateSamplingRange({
 - 电平概率分布统计
 - 时间/点数缓存模式
 
-## 构建命令
-
-```bash
-pnpm build          # 构建 JS 版本
-pnpm build:wasm     # 构建 WASM 版本
-pnpm build:all      # 构建全部
-```
-
-## 发版约定
-
-- 发布级改动默认需要在 PR 中携带 `.changeset/*.md`
-- `patch` / `minor` / `major` 由 changeset 决定，不要手改 `package.json.version`
-- PR 合并到 `main` 后会自动创建或更新 Release PR；合并 Release PR 后才会正式发布 npm
-- 若 GitHub Actions 在 `npm publish` 阶段报 `E404` 或权限类错误，先检查 npm 包设置里的 Trusted Publisher 是否精确匹配 `Hxgh/rfkit-spectrum-analyzer`、`release.yml`、`npm-release`，并确认 `package.json.repository.url` 仍是当前 GitHub 仓库；修配置后直接重跑当前未发布版本，不要继续 bump 版本
-
 ## License
 
 MIT

package/core/LevelStreamAnalyzer/constants.d.ts

@@ -10,4 +10,3 @@ export declare const DEFAULT_LEVEL_STREAM_CONFIG: {
     maxPoints: undefined;
     onLevelStreamUpdate: (data: Map<number, number>) => void;
 };
-//# sourceMappingURL=constants.d.ts.map

package/core/LevelStreamAnalyzer/index.d.ts

@@ -1,11 +1,4 @@
 import type { LevelStreamConfig } from './types';
-/**
- * [SYNC-WASM] 电平流分析器
- * @sync src-rust/src/level_stream/core.rs:WasmLevelStreamAnalyzer
- *
- * 用于统计电平流数据的分析器。
- * 支持设置缓存时间、颗粒度和统计范围，并提供数据处理和概率计算功能。
- */
 export default class LevelStreamAnalyzer {
     protected config: Required<Omit<LevelStreamConfig, 'maxPoints'>> & {
         maxPoints?: number;
@@ -14,43 +7,12 @@ export default class LevelStreamAnalyzer {
     private probabilityData;
     private count;
     constructor(config: LevelStreamConfig);
-    /**
-     * 重置分析器的状态，清空频谱数据和概率数据，但保留配置信息。
-     */
     reset(): void;
     setConfig(config: Partial<LevelStreamConfig>): void;
-    /**
-     * 处理一个新的电平值，更新频谱数据并重新计算概率。
-     * @param level 新的电平值
-     * @param timestamp 时间戳
-     */
     process(level: number, timestamp: number): void;
-    /**
-     * 更新新数据对应的区间概率
-     * @param level 新的电平值
-     */
     private updateProbability;
-    /**
-     * 查询所有统计的概率数据。
-     * @returns 概率数据的 Map 对象
-     */
     getAll(): Map<number, number>;
-    /**
-     * 移除过期的频谱数据。
-     * 支持两种模式：
-     * 1. 点模式（maxPoints）：保留最新的 N 个点
-     * 2. 时间模式（cacheTime）：保留指定时间范围内的数据
-     */
     private removeExpiredData;
-    /**
-     * 添加新的电平值到频谱数据中。
-     * @param level 新的电平值
-     * @param timestamp 时间戳
-     */
     private addNewData;
-    /**
-     * 输出符合统计范围的概率数据。
-     */
     private outputData;
 }
-//# sourceMappingURL=index.d.ts.map

package/core/LevelStreamAnalyzer/types.d.ts

@@ -10,4 +10,3 @@ export interface LevelStreamOutputData {
     spectrumData: Float32Array;
     timestampData: Float64Array;
 }
-//# sourceMappingURL=types.d.ts.map

package/core/SeriesManager/constants.d.ts

@@ -4,7 +4,6 @@ export declare const DEFAULT_SERIES_CONFIG: {
     readonly orientation: OrientationType.Horizontal;
     readonly display: true;
     readonly type: GraphicType.Line;
-    readonly color: "#00000000";
-    readonly label: "";
+    readonly color: '#00000000';
+    readonly label: '';
 };
-//# sourceMappingURL=constants.d.ts.map

package/core/SeriesManager/index.d.ts

@@ -1,112 +1,24 @@
 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/core/SeriesManager/types.d.ts

@@ -40,4 +40,3 @@ export interface SubscriptionOptions {
     eventTypes?: SeriesEventType[];
     seriesNames?: string[];
 }
-//# sourceMappingURL=types.d.ts.map

package/core/SpectrumAnalyzer/constants.d.ts

@@ -38,15 +38,14 @@ export declare const DEFAULT_SPECTRUM_CONFIG: {
     readonly templateTolerance: 0;
 };
 export declare const ERROR_MESSAGES: {
-    readonly EMPTY_SEGMENTS: "频段配置不能为空";
-    readonly INVALID_CONFIG: "必须且只能配置 segments 或 bandwidthConfig 其中之一";
-    readonly EMPTY_BANDWIDTH: "bandwidthConfig 不能为空";
+    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_ANTENNA_FACTOR: '天线因子数据必须是有效的正数';
+    readonly INVALID_SAMPLING_RANGE: '采样范围无效';
+    readonly INVALID_MAX_POINTS: '点数必须大于0';
     readonly INVALID_LENGTH: (expected: number) => string;
 };
-//# sourceMappingURL=constants.d.ts.map

package/core/SpectrumAnalyzer/errors.d.ts

@@ -1,16 +1,12 @@
 export declare class SpectrumError extends Error {
     readonly code: string;
-    readonly details?: unknown | undefined;
-    constructor(message: string, code: string, details?: unknown | undefined);
+    readonly details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
 }
 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/core/SpectrumAnalyzer/index.d.ts

@@ -1,4 +1,4 @@
-import type { isValidFloat32Array, ProcessInput, ProcessingOptions, ScanSegment, SpectrumConfig, SpectrumOutputData, TemplateOverData, ThresholdDataOptions, TimestampedFloat32Array } from './types';
+import type { ExtraDataOptions, isValidFloat32Array, ProcessInput, ProcessingOptions, ScanSegment, SpectrumConfig, SpectrumOutputData, TemplateOverData, ThresholdDataOptions, TimestampedFloat32Array } from './types';
 import { ExtraDataMode } from './types';
 export default class SpectrumAnalyzer {
     config: Required<Omit<SpectrumConfig, 'segments' | 'bandwidthConfig' | 'onSpectrumUpdate'>>;
@@ -40,227 +40,45 @@ export default class SpectrumAnalyzer {
     private isProcessing;
     private readonly onSpectrumUpdate?;
     constructor(config: Partial<SpectrumConfig>);
-    /**
-     * 处理输入数据，包括验证、拼接、统计、采样等操作。
-     * @param {ProcessInput} input - 输入数据，包含数据、时间戳、分段偏移和偏移量。
-     */
     process({ data, timestamp, segmentOffset, offset, fluorescenceData, fluorescenceMaxCount }: 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 {Partial<ProcessingOptions>} next - 要更新的处理选项
-     *
-     * 语义：
-     * - enableMetrics 从 false→true 后从后续帧开始累计；true→false 立即停止累计
-     * - enableFluorescence 同理
-     * - enablePeakStats 同理，控制峰值检测开关
-     *
-     * 注意：此方法会进行浅比较，只有值真正变化时才会更新配置和通知数据更新。
-     */
     updateProcessing(next: Partial<ProcessingOptions>): void;
-    /**
-     * 清空统计指标数据 (Max/Min/Avg)
-     * 将相关数组重置为初始值，并通知更新。
-     */
     clearMetricsData(): void;
-    /**
-     * 初始化 metrics 缓冲区（max/min/avg 及其输出缓存）。
-     * 仅负责分配内存，不负责填充初始值。
-     */
     private allocateMetricsBuffers;
-    /**
-     * 清空 metrics 缓冲区（max/min/avg 及其输出缓存），并重置 allValid 标记。
-     * 不会调整数组长度。
-     */
     private clearMetricsBuffers;
-    /**
-     * 设置瀑布图数据，用于从外部导入已缓存的瀑布图数据。
-     * @param {TimestampedFloat32Array[]} data - 瀑布图数据数组。
-     */
     setWaterfallData(newWaterfallData: TimestampedFloat32Array[]): void;
-    /**
-     * 设置荧光累积数据，用于传入预先计算好的荧光累积数据。
-     * @param {Uint32Array} fluorescenceData - 荧光累积数据
-     * @param {number} fluorescenceMaxCount - 荧光数据中的最大计数值
-     */
     setFluorescenceData(fluorescenceData: Uint32Array, fluorescenceMaxCount: number): 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;
+    setExtraData(data: Record<string, Float32Array | number[]> | null, mode?: ExtraDataMode, options?: ExtraDataOptions): 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 {Float32Array | number[]} data - 阈值数据
-     * @param {ThresholdDataOptions} options - 可选，使用 segmentOffset/offset 进行局部门限写入
-     */
     setThresholdData(data?: Float32Array | number[], options?: ThresholdDataOptions): void;
-    /**
-     * 统一的超出数据段计算和缓存更新方法
-     * @param forceFullCalculation - 是否强制进行全量计算
-     * @param incrementalRange - 增量计算的范围
-     * @returns 计算得到的超出数据段
-     */
     private updateTemplateOverData;
-    /**
-     * 将分段偏移转换为全局数据索引。
-     */
     private resolveGlobalIndex;
     private clearThresholdDataState;
-    /**
-     * 对数据进行重采样，生成频谱输出数据。
-     * @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, preserveProcessedFlag?: boolean): 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;
-    /**
-     * 获取数据快照：
-     * - 输出数据（重采样后）保持原有语义
-     * - rawData 提供原始全长数据引用（零拷贝）
-     * - 传入 left 时，返回 cursorIndex 便于光标统一索引
-     */
     getAllRawData(left?: number): Readonly<SpectrumOutputData>;
 }
-//# sourceMappingURL=index.d.ts.map

package/core/SpectrumAnalyzer/tools.d.ts

@@ -1,10 +1,3 @@
-/**
- * SpectrumAnalyzer 工具函数
- *
- * [SYNC-WASM] 本文件包含需要与 Rust WASM 版本同步维护的核心算法
- * @see src-rust/src/spectrum_analyzer/resampler.rs
- * @see src-rust/src/spectrum_analyzer/template.rs
- */
 import type { CursorIndexData, TemplateOverData, TimestampedFloat32Array } from './types';
 export declare const arrayKeepAttribute: (source: Float32Array & {
     max?: number;
@@ -17,17 +10,8 @@ export declare const arrayKeepAttribute: (source: Float32Array & {
     timestamp?: number;
     progress?: number;
 }) => void;
-/**
- * 将数值约束到指定范围
- */
 export declare const clamp: (value: number, min: number, max: number) => number;
-/**
- * 将百分比 left 映射为索引
- */
 export declare const leftToIndex: (left: number, length: number) => number;
-/**
- * 计算光标索引信息
- */
 export declare const resolveCursorIndexByLeft: (left: number | undefined, outputLength: number, maxPoints: number) => CursorIndexData | undefined;
 export declare const resample: ({ realData, antennaFactorData, antennaFactorSwitch, outputPoints }: {
     realData: TimestampedFloat32Array;
@@ -38,14 +22,6 @@ export declare const resample: ({ realData, antennaFactorData, antennaFactorSwit
     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/threshold/fluorescence 数据
- * 支持在重采样过程中同时检测峰值（零性能损耗）
- */
 export declare const resampleMultiple: ({ antennaFactorData, antennaFactorSwitch, outputPoints, realData, maxData, minData, avgData, templateData, backgroundNoiseData, thresholdData, fluorescenceData, occupancyData, enablePeakStats, maxPeaks, outputRangeStart }: {
     antennaFactorData: Float32Array;
     antennaFactorSwitch?: boolean;
@@ -74,18 +50,7 @@ export declare const resampleMultiple: ({ antennaFactorData, antennaFactorSwitch
     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;
@@ -104,4 +69,3 @@ export declare const findExceedingDatasIncremental: ({ realData, maxData, minDat
     previousSegments?: TemplateOverData[];
 }) => TemplateOverData[];
 export declare function isAllValid(arr: Float32Array): boolean;
-//# sourceMappingURL=tools.d.ts.map

package/core/SpectrumAnalyzer/types.d.ts

@@ -3,6 +3,10 @@ export declare enum ExtraDataMode {
     MERGE = "merge",
     CLEAR = "clear"
 }
+export interface ExtraDataOptions {
+    segmentOffset?: number;
+    offset?: number;
+}
 export interface ScanSegment {
     startFrequency: number;
     stopFrequency: number;
@@ -26,10 +30,6 @@ export interface ProcessingConfig {
     readonly enablePeakStats: boolean;
     readonly fluorescenceUpdateInterval: number;
 }
-/**
- * ProcessingOptions - 用于动态更新处理选项的类型。
- * 仅包含允许在运行时更新的字段。
- */
 export type ProcessingOptions = Pick<ProcessingConfig, 'enableMetrics' | 'enableFluorescence' | 'enablePeakStats' | 'fluorescenceUpdateInterval'>;
 export interface PeakDetectionConfig {
     maxPeaks?: number;
@@ -123,4 +123,3 @@ export interface ISpectrumAnalyzer {
     readonly antennaFactorSwitch: boolean;
     readonly srcIndexCache: Uint32Array;
 }
-//# sourceMappingURL=types.d.ts.map