@rfkit/charts 1.10.12 → 1.11.0

package/utils/frequencyCalculation.d.ts

@@ -1,174 +1,35 @@
-/**
- * 频率计算工具包
- *
- * 提供统一的频率范围、索引计算、位置计算等功能
- * 用于 StationAllocation、FrequencyAllocation、Signal 等组件的核心计算逻辑
- */
 import type { SegmentType } from '../types';
-/**
- * 频率范围（起止频率）
- */
 export interface FrequencyRange {
-    /** 起始频率 (MHz) */
     startFreq: number;
-    /** 结束频率 (MHz) */
     stopFreq: number;
 }
-/**
- * 频率范围输入（支持两种格式）
- */
 export interface FrequencyRangeInput {
-    /** 格式1: 中心频率 (MHz) */
     frequency?: number;
-    /** 格式1: 带宽 (kHz) */
     bandwidth?: number;
-    /** 格式2: 起始频率 (MHz) */
     startFrequency?: number;
-    /** 格式2: 结束频率 (MHz) */
     stopFrequency?: number;
 }
-/**
- * 索引范围
- */
 export interface IndexRange {
-    /** 起始索引 */
     startIndex: number;
-    /** 结束索引 */
     stopIndex: number;
 }
-/**
- * 位置信息（百分比）
- */
 export interface Position {
-    /** 左侧位置 (%) */
     left: number;
-    /** 宽度 (%) */
     width: number;
 }
-/**
- * 当前光标位置信息
- */
 export interface CursorPosition {
-    /** 所在段索引 */
     segmentIndex: number;
-    /** 段内点索引 */
     pointIndex: number;
 }
-/**
- * 精确搜索范围（前后各 5 个点）
- * 用于在 frequencyCache 中精确查找最接近的索引
- */
 export declare const SEARCH_RANGE = 5;
-/**
- * Active 判断容差（前后各 2 个点）
- * 用于处理 left 步进跳跃时的窄带检测
- */
 export declare const ACTIVE_TOLERANCE = 2;
-/**
- * 计算频率范围
- *
- * 支持两种输入格式：
- * 1. frequency + bandwidth (中心频率 + 带宽)
- * 2. startFrequency + stopFrequency (起止频率)
- *
- * @param input 频率范围输入
- * @returns 频率范围（起止频率，单位 MHz）
- *
- * @example
- * // 格式1: 中心频率 + 带宽
- * calculateFrequencyRange({ frequency: 100, bandwidth: 20 })
- * // => { startFreq: 99.99, stopFreq: 100.01 }
- *
- * // 格式2: 起止频率
- * calculateFrequencyRange({ startFrequency: 99.99, stopFrequency: 100.01 })
- * // => { startFreq: 99.99, stopFreq: 100.01 }
- */
 export declare function calculateFrequencyRange(input: FrequencyRangeInput): FrequencyRange | null;
-/**
- * 计算初步索引范围（粗略计算）
- *
- * 基于频率范围和 segment 信息，计算初步的索引范围
- *
- * @param range 频率范围
- * @param segment 段信息
- * @returns 初步索引范围
- */
 export declare function calculateRoughIndexRange(range: FrequencyRange, segment: SegmentType): IndexRange;
-/**
- * 精确查找索引范围
- *
- * 使用 frequencyCache 在粗略索引附近精确搜索，找到最接近的索引
- *
- * @param range 频率范围
- * @param segment 段信息
- * @param searchRange 搜索范围（默认 5）
- * @returns 精确索引范围
- */
 export declare function findPreciseIndexRange(range: FrequencyRange, segment: SegmentType, searchRange?: number): IndexRange;
-/**
- * 从索引范围计算位置信息
- *
- * 将索引范围转换为百分比位置和宽度
- *
- * @param indexRange 索引范围
- * @param segment 段信息
- * @returns 位置信息（百分比）
- */
 export declare function calculatePositionFromIndex(indexRange: IndexRange, segment: SegmentType): Position;
-/**
- * 从频率范围直接计算位置（一步到位）
- *
- * 组合上述函数，从频率范围直接计算出精确的位置和索引
- *
- * @param range 频率范围
- * @param segment 段信息
- * @returns 位置信息和索引范围
- */
 export declare function calculatePositionFromFrequencyRange(range: FrequencyRange, segment: SegmentType): Position & IndexRange;
-/**
- * 计算当前光标位置
- *
- * 从 left（百分比）计算当前所在的 segment 和 segment 内的 point 索引
- *
- * @param left 光标位置（百分比 0-100）
- * @param segments 所有段信息
- * @returns 光标位置信息
- */
 export declare function calculateCursorPosition(left: number, segments: SegmentType[]): CursorPosition;
-/**
- * 根据当前光标段位和点索引，获取内部命中使用的精确频率。
- *
- * 注意：
- * - 这里返回的是基于 frequencyCache 的采样频率，不是展示层格式化后的字符串
- * - 用于 hover / active 命中，可以避免展示格式化或索引换算差异带来的误判
- */
 export declare function getCursorFrequencyAtPosition(segments: SegmentType[], position: CursorPosition): number;
-/**
- * 判断光标是否在频率范围内（使用索引 + 容差）
- *
- * 使用索引范围判断，支持容差（用于处理 left 步进跳跃）
- *
- * @param cursorPointIndex 光标在段内的点索引
- * @param indexRange 目标频率范围的索引
- * @param tolerance 容差（默认 2）
- * @returns 是否在范围内
- */
 export declare function isInRangeByIndex(cursorPointIndex: number, indexRange: IndexRange, tolerance?: number): boolean;
-/**
- * 判断光标是否在频率范围内（使用频率）
- *
- * 直接使用频率值判断（兜底方案）
- *
- * @param currentFrequency 当前频率
- * @param range 目标频率范围
- * @returns 是否在范围内
- */
 export declare function isInRangeByFrequency(currentFrequency: number, range: FrequencyRange): boolean;
-/**
- * 判断频率范围是否与 segment 有交集
- *
- * @param range 频率范围
- * @param segment 段信息
- * @returns 是否有交集
- */
 export declare function isRangeIntersectSegment(range: FrequencyRange, segment: SegmentType): boolean;

package/utils/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * 工具函数统一导出
- */
 import type { TimestampedFloat32Array } from '@rfkit/spectrum-analyzer';
 export * from './array';
 export * from './cursor';
@@ -9,11 +6,5 @@ export * from './frequencyCalculation';
 export * from './object';
 export * from './throttle';
 export * from './time';
-/**
- * GUID 生成
- */
 export declare const createGUID: () => string;
-/**
- * 将原始数据转换为带时间戳的 Float32Array 数组
- */
 export declare const convertToTimestampedArrays: (data: number[][], timestamps?: Array<string>) => TimestampedFloat32Array[];

package/utils/object.d.ts

@@ -1,11 +1,2 @@
-/**
- * 对象操作工具函数
- */
 import type { RecursiveObject } from '../types';
-/**
- * 混合对象 - 将参数对象合并到源对象副本中
- * @param source 源对象
- * @param params 要混合的参数
- * @returns 混合后的对象
- */
 export declare const mergeObjects: <T extends RecursiveObject>(source: T, params: RecursiveObject) => T;

package/utils/series/events.d.ts

@@ -1,25 +1,15 @@
-/**
- * Series 事件系统
- * 提供通用的发布-订阅机制，支持 React 组件和普通 JS 模块
- */
 import type { GraphicType } from '@rfkit/renderer';
 import type { SeriesConfig } from './index';
 import type { ModeConfig, SeriesMode } from './modes';
-/**
- * Series 事件名称常量
- */
 export declare const SeriesEventName: {
-    readonly UPDATED: "series:updated";
-    readonly ADDED: "series:added";
-    readonly REMOVED: "series:removed";
-    readonly MODE_CHANGED: "series:mode-changed";
-    readonly TYPE_OVERRIDE_CHANGED: "series:type-override-changed";
-    readonly BATCH_UPDATED: "series:batch-updated";
-    readonly RESET: "series:reset";
+    readonly UPDATED: 'series:updated';
+    readonly ADDED: 'series:added';
+    readonly REMOVED: 'series:removed';
+    readonly MODE_CHANGED: 'series:mode-changed';
+    readonly TYPE_OVERRIDE_CHANGED: 'series:type-override-changed';
+    readonly BATCH_UPDATED: 'series:batch-updated';
+    readonly RESET: 'series:reset';
 };
-/**
- * Series 事件名称类型
- */
 export type SeriesEventNameType = (typeof SeriesEventName)[keyof typeof SeriesEventName];
 export interface SeriesEvents {
     [SeriesEventName.UPDATED]: {
@@ -56,21 +46,9 @@ export interface SeriesEvents {
 }
 export type EventListener<T = unknown> = (data: T) => void;
 export declare const seriesEvents: {
-    /**
-     * 订阅事件
-     */
     on: <K extends keyof SeriesEvents>(event: K, listener: EventListener<SeriesEvents[K]>) => () => void;
-    /**
-     * 发布事件
-     */
     emit: <K extends keyof SeriesEvents>(event: K, data: SeriesEvents[K]) => void;
-    /**
-     * 移除监听器
-     */
     removeAllListeners: (event?: keyof SeriesEvents) => void;
-    /**
-     * 获取监听器数量
-     */
     getListenerCount: (event: keyof SeriesEvents) => number;
 };
 export declare function subscribeToSeries<K extends keyof SeriesEvents>(globalID: string, event: K, listener: EventListener<SeriesEvents[K]>): () => void;

package/utils/series/index.d.ts

@@ -1,8 +1,5 @@
 import { GraphicType } from '@rfkit/renderer';
 import { type SeriesConfig as ExternalSeriesConfig, SeriesManager } from '@rfkit/spectrum-analyzer';
-/**
- * 本地 SeriesConfig 类型定义
- */
 export interface SeriesConfig {
     name: string;
     label: string;
@@ -11,73 +8,23 @@ export interface SeriesConfig {
     display: boolean;
     type: GraphicType;
 }
-/**
- * 部分更新 SeriesConfig 类型定义
- * 只有 name 是必需的，其他字段都是可选的
- */
 export type PartialSeriesConfig = Partial<SeriesConfig> & {
     name: string;
 };
-/**
- * 设置 ChartType 特定的 series 类型覆盖
- * @param globalID
- * @param seriesName series 名称
- * @param type 要覆盖的类型
- */
 export declare function setChartTypeSeriesOverride(globalID: string, seriesName: string, type: GraphicType): void;
-/**
- * 清除 ChartType 特定的类型覆盖
- */
 export declare function clearChartTypeSeriesOverrides(globalID: string): void;
-/**
- * 获取 ChartType 特定的 series 类型覆盖
- * @param globalID
- * @param seriesName series 名称
- * @returns 覆盖的类型，如果没有则返回 undefined
- */
 export declare function getChartTypeSeriesOverride(globalID: string, seriesName: string): GraphicType | undefined;
-/**
- * 获取正确的 series 类型（统一的类型优先级计算）
- * 优先级：ChartType 覆盖 > 特殊类型(templateData) > SeriesMode 配置 > 默认 Line
- *
- * @param globalID 全局 ID
- * @param seriesName series 名称
- * @returns 正确的 GraphicType
- */
 export declare function getCorrectSeriesType(globalID: string, seriesName: string): GraphicType;
 export { type ModeConfig, SeriesMode, type SeriesModesConfig } from './modes';
 export type { ExternalSeriesConfig };
-/**
- * 获取 SeriesManager 实例
- */
 export declare function getSeriesManager(globalID: string): SeriesManager;
-/**
- * 销毁 SeriesManager
- */
 export declare function destroySeriesManager(globalID: string): void;
-/**
- * 检查是否存在 SeriesManager
- */
 export declare function hasSeriesManager(globalID: string): boolean;
-/**
- * 获取 series 数据映射
- */
 export declare function getSeriesMap(globalID: string): Map<string, SeriesConfig>;
 export declare function updateSeries(globalID: string, config: PartialSeriesConfig): void;
-/**
- * 重置 series
- */
 export declare function resetSeries(globalID: string): void;
-/**
- * 批量更新 series
- * 注意：只发布一次 BATCH_UPDATED 事件，避免重复触发
- */
 export declare function batchUpdateSeries(globalID: string, configs: PartialSeriesConfig[]): void;
 export * from './events';
 export * from './modes';
 export * from './subscription';
-/**
- * 获取带有正确 GraphicType 的 series 配置
- * 使用统一的类型优先级计算
- */
 export declare function getSeriesWithGraphicType(globalID: string): Map<string, SeriesConfig>;

package/utils/series/modes.d.ts

@@ -1,20 +1,10 @@
-/**
- * Series 模式管理
- * 集成新的事件系统，支持通用的订阅机制
- */
 import { GraphicType } from '@rfkit/renderer';
-/**
- * 显示模式类型
- */
 export declare enum SeriesMode {
     Line = "line",
     StepLine = "stepline",
     Bar = "bar",
     Area = "area"
 }
-/**
- * 模式配置接口
- */
 export interface ModeConfig {
     name: string;
     label: string;
@@ -24,25 +14,10 @@ export interface ModeConfig {
     maxData: GraphicType;
     avgData: GraphicType;
 }
-/**
- * Series 模式配置类型
- */
 export type SeriesModesConfig = Record<SeriesMode, ModeConfig>;
 export declare const SERIES_MODES: SeriesModesConfig;
-/**
- * 获取 Series 模式
- */
 export declare function getSeriesMode(globalID: string): SeriesMode;
 export declare function getNextMode(currentMode: SeriesMode): SeriesMode;
-/**
- * 设置 Series 模式
- */
 export declare function setSeriesMode(globalID: string, mode: SeriesMode): void;
-/**
- * 切换到下一个 Series 模式
- */
 export declare function toggleSeriesMode(globalID: string, currentMode?: SeriesMode): void;
-/**
- * 清除指定 globalID 的模式
- */
 export declare function clearSeriesMode(globalID: string): void;

package/utils/series/subscription.d.ts

@@ -1,12 +1,4 @@
-/**
- * Series 订阅工具
- * 提供可复用的 series 事件订阅函数
- */
 import { type SeriesConfig } from './index';
-/**
- * Series 渲染器接口
- * 定义渲染器必须实现的方法
- */
 export interface SeriesRenderer {
     state: {
         globalID?: string;
@@ -18,26 +10,4 @@ export interface SeriesRenderer {
     setSeries: (config: SeriesConfig, skipEvent?: boolean) => void;
     initSeries: () => void;
 }
-/**
- * 初始化 Series 事件订阅
- *
- * @param renderer 渲染器实例（必须实现 SeriesRenderer 接口）
- * @returns 取消订阅函数
- *
- * @example
- * ```typescript
- * class MyRender implements SeriesRenderer {
- *   private seriesUnsubscribe: (() => void) | null = null;
- *
- *   constructor(props: any) {
- *     this.state = { chart: null, globalID: props.globalID };
- *     this.seriesUnsubscribe = initSeriesSubscription(this);
- *   }
- *
- *   destroy() {
- *     this.seriesUnsubscribe?.();
- *   }
- * }
- * ```
- */
 export declare function initSeriesSubscription(renderer: SeriesRenderer): (() => void) | null;

package/utils/subscription.d.ts

@@ -18,11 +18,6 @@ interface RuntimeOwners {
     [owner: string]: RuntimeOwnerRecord;
 }
 export declare function openData<T = unknown>(key: string, data: T | undefined, defaultData: T, owner?: string): T;
-/**
- * 共享订阅
- * Note: Using any[] for callback args since this is a generic pub/sub system
- * that can be called with various argument types across the codebase.
- */
 export type CSMCallback<Return = void> = (...args: any[]) => Return;
 interface Subscription {
     [key: string]: CSMCallback;

package/utils/throttle.d.ts

@@ -1,11 +1,3 @@
-/**
- * 节流与防抖工具函数
- */
-/**
- * 节流函数
- * @param func 需要节流的函数
- * @param wait 等待时间（毫秒），默认 1000/30
- */
 export declare function throttle<T extends unknown[]>(func?: (...arg: T) => void, wait?: number): (...arg: T) => void;
 interface EventSnapshot {
     currentTarget: EventTarget | null;
@@ -25,28 +17,10 @@ interface ReactLikeEvent {
     clientY?: number;
     buttons?: number;
 }
-/**
- * 基于 requestAnimationFrame 的节流函数
- * @param func 需要节流的函数
- */
 export declare function throttleRequestAnimationFrame<T = unknown>(func?: (e?: T | EventSnapshot) => void): (e?: T | ReactLikeEvent) => void;
-/**
- * 基于定时器的节流函数
- * @param func 需要节流的函数
- * @param wait 等待时间（毫秒）
- */
 export declare function throttleTimer<T = unknown>(func?: (e?: T) => void, wait?: number): (e?: T) => void;
-/**
- * 防抖函数
- * @param fn 需要防抖的函数
- * @param delay 延迟时间（毫秒）
- * @returns 带有 cancel 方法的防抖函数
- */
 export declare const debounce: <T extends (...args: unknown[]) => unknown>(fn: T, delay?: number) => ((...args: Parameters<T>) => void) & {
     cancel: () => void;
 };
-/**
- * 基于 requestAnimationFrame 的防抖函数，适合视觉更新相关操作
- */
 export declare function debounceRequestAnimationFrame<T extends unknown[]>(func?: (...args: T) => void): (...args: T) => void;
 export {};

package/utils/time.d.ts

@@ -1,27 +1,7 @@
-/**
- * 时间处理工具函数
- */
-/**
- * 时间戳格式化选项
- */
 export interface TimestampFormatOptions {
     dateSeparator?: string;
     timeSeparator?: string;
     timeOnly?: boolean;
 }
-/**
- * 格式化时间戳为字符串
- * @param input 时间戳或 Date 对象
- * @param options 格式化选项
- * @returns 格式化后的时间字符串
- */
 export declare const formatTimestamp: (input?: number | Date, options?: TimestampFormatOptions) => string;
-/**
- * 将日期时间字符串转换为时间戳
- * @param dateTimeStr 日期时间字符串
- * @param sep1 日期分隔符
- * @param sep2 时间分隔符
- * @param isTimeOnly 是否仅为时间字符串
- * @returns 时间戳（毫秒）
- */
 export declare const dateTimeToTimestamp: (dateTimeStr: unknown, sep1?: string, sep2?: string, isTimeOnly?: boolean) => number;