@rfkit/charts 1.1.40 → 1.2.0

package/modules/Spectrum/render.d.ts

@@ -1,6 +1,5 @@
 import { Series } from '../../engine';
 import type { SeriesConfig } from '../../types';
-export declare const passThroughSeries: (globalID: string, series?: Record<string, SeriesConfig>) => any;
 interface SpectrumState {
     chart: Series | null;
     autoranging: boolean;
@@ -16,7 +15,12 @@ export default class Spectrum {
     useRangeAutoFocus: () => void;
     useRangeSet: () => void;
     firstRenderAutoFocus: boolean;
+    seriesUnsubscribe?: () => void;
     constructor(props: Record<string, unknown>);
+    /**
+     * 初始化 series 订阅机制
+     */
+    initSeriesSubscription(): void;
     init(): void;
     initSeries(): void;
     /**
@@ -38,7 +42,7 @@ export default class Spectrum {
     /**
      * 设置线信息
      */
-    setSeries(config: SeriesConfig): void;
+    setSeries(config: SeriesConfig, skipEventEmit?: boolean): void;
     setDisabledClearRect(disabledClearRect: boolean): void;
     setRange(renderRange?: [number, number]): void;
     zoom(): void;

package/package.json

@@ -5,6 +5,6 @@
   "types": "index.d.ts",
   "author": "Hxgh",
   "license": "MIT",
-  "version": "1.1.40",
+  "version": "1.2.0",
   "private": false
 }

package/types/store.d.ts

@@ -1,6 +1,6 @@
 import type { TimestampedFloat32Array } from '@rfkit/spectrum-analyzer';
 import type { MarkerEventType, ModuleType, SeriesType } from '../config';
-import type { AxisXRange, AxisYRange, Publish, RecursiveObject, SegmentsType, SeriesConfig, StationInfoType, TopRightBottomLeft } from './';
+import type { AxisXRange, AxisYRange, Publish, RecursiveObject, SegmentsType, StationInfoType, TopRightBottomLeft } from './';
 export interface SystemConfig {
     width: number;
     height: number;
@@ -47,7 +47,6 @@ export interface SeriesProps {
     zoomMinSimulateWave: boolean;
     dataRate: number;
     forceDisplay: boolean;
-    data: Map<string, SeriesConfig>;
     legendExternal: SeriesType[];
     enableMetrics?: boolean;
     enableWaterfall?: boolean;

package/utils/series/events.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Series 事件系统
+ * 提供通用的发布-订阅机制，支持 React 组件和普通 JS 模块
+ */
+import type { GraphicType } from '../../engine';
+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";
+};
+/**
+ * Series 事件名称类型
+ */
+export type SeriesEventNameType = (typeof SeriesEventName)[keyof typeof SeriesEventName];
+export interface SeriesEvents {
+    [SeriesEventName.UPDATED]: {
+        globalID: string;
+        seriesName: string;
+        config: SeriesConfig;
+    };
+    [SeriesEventName.ADDED]: {
+        globalID: string;
+        seriesName: string;
+        config: SeriesConfig;
+    };
+    [SeriesEventName.REMOVED]: {
+        globalID: string;
+        seriesName: string;
+    };
+    [SeriesEventName.MODE_CHANGED]: {
+        globalID: string;
+        mode: SeriesMode;
+        config: ModeConfig;
+    };
+    [SeriesEventName.TYPE_OVERRIDE_CHANGED]: {
+        globalID: string;
+        seriesName?: string;
+        type?: GraphicType;
+    };
+    [SeriesEventName.BATCH_UPDATED]: {
+        globalID: string;
+        configs: SeriesConfig[];
+    };
+    [SeriesEventName.RESET]: {
+        globalID: string;
+    };
+}
+export type EventListener<T = unknown> = (data: T) => void;
+export declare const seriesEvents: {
+    /**
+     * 订阅事件
+     */
+    on: any;
+    /**
+     * 发布事件
+     */
+    emit: any;
+    /**
+     * 移除监听器
+     */
+    removeAllListeners: any;
+    /**
+     * 获取监听器数量
+     */
+    getListenerCount: any;
+};
+export declare function subscribeToSeries<K extends keyof SeriesEvents>(globalID: string, event: K, listener: EventListener<SeriesEvents[K]>): () => void;
+export declare function emitSeriesEvent<K extends keyof SeriesEvents>(event: K, data: SeriesEvents[K]): void;

package/utils/series/index.d.ts

@@ -0,0 +1,65 @@
+import { type SeriesConfig as ExternalSeriesConfig, SeriesManager } from '@rfkit/spectrum-analyzer';
+import { GraphicType } from '../../engine';
+/**
+ * 本地 SeriesConfig 类型定义
+ */
+export interface SeriesConfig {
+    name: string;
+    label: string;
+    color: string;
+    thickness: number;
+    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;
+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
+ */
+export declare function batchUpdateSeries(globalID: string, configs: PartialSeriesConfig[]): void;
+export * from './events';
+export * from './modes';
+/**
+ * 获取带有正确 GraphicType 的 series 配置
+ * 优先级：ChartType 覆盖 > SeriesMode 配置 > 默认类型
+ */
+export declare function getSeriesWithGraphicType(globalID: string): Map<string, SeriesConfig>;

package/utils/series/modes.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Series 模式管理
+ * 集成新的事件系统，支持通用的订阅机制
+ */
+import { GraphicType } from '../../engine';
+/**
+ * 显示模式类型
+ */
+export declare enum SeriesMode {
+    Line = "line",
+    StepLine = "stepline",
+    Bar = "bar",
+    Area = "area"
+}
+/**
+ * 模式配置接口
+ */
+export interface ModeConfig {
+    name: string;
+    label: string;
+    icon: string;
+    realData: GraphicType;
+    minData: GraphicType;
+    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/subscription.d.ts

@@ -1,20 +1,12 @@
 import type { SpectrumAnalyzer, SpectrumData } from '@rfkit/spectrum-analyzer';
 import type { RecursiveFunction } from '../types';
-export declare function openData(globalID: string, data: any, defaultData: any): any;
+export declare function openData(globalID: string, data: unknown, defaultData: unknown): any;
 /**
  * 共享订阅
  */
 export type CSMCallback = (...args: any[]) => void;
 export declare function createSubscriptionManager(id: string, name?: string, func?: CSMCallback): (...args: any[]) => void;
 export interface rawData {
-    spectrumExtra: Map<string, {
-        outputData: Float32Array;
-        originalData: Float32Array;
-    }>;
-    occupancy: {
-        data: Float32Array;
-        totalOccupancy: number;
-    };
     getAllRawData: () => SpectrumData;
 }
 export declare const getDefaultData: () => rawData;

package/hooks/useSeries.d.ts

@@ -1,8 +0,0 @@
-import type { RecursiveFunction, SeriesConfig } from '../types';
-export declare const SET_SERIES: (globalID: string, func?: RecursiveFunction) => (...args: any[]) => void;
-export interface UseSeriesResult {
-    series: Map<string, SeriesConfig>;
-    updateSeries: (config: SeriesConfig) => void;
-    resetSeries: () => void;
-}
-export default function useSeries(): UseSeriesResult;