@rfkit/charts 1.2.29 → 1.3.1

package/lib/Spectrum/Chart.d.ts

@@ -1,4 +1,4 @@
-import { type Props as SpectrumChartTypeProps } from '../../hooks/useSpectrumChartType';
+import { type UseSpectrumChartTypeProps as SpectrumChartTypeProps } from '../../hooks/spectrum';
 import { type OccupancyPortalProps } from '../../modules/OccupancyPortal';
 import type { ParamsProps } from '../../types';
 export interface Props extends SpectrumChartTypeProps, ParamsProps, OccupancyPortalProps {

package/modules/Dial/render.d.ts

@@ -1,9 +1,14 @@
-export default class IQStream {
-    private state;
-    constructor(props: any);
-    private init;
-    updateSeries(d: any): void;
-    reset(): void;
-    resize(): void;
-    clear(): void;
+/**
+ * Dial 渲染器
+ */
+import { Dial } from '@rfkit/renderer';
+import { CircularRenderer, type CircularRenderState } from '../base';
+type DialRenderState = CircularRenderState<Dial>;
+interface DialRenderProps {
+    id: string;
 }
+export default class DialRender extends CircularRenderer<Dial, DialRenderState> {
+    constructor(props: DialRenderProps);
+    protected init(): void;
+}
+export {};

package/modules/Fluorescence/render.d.ts

@@ -1,41 +1,21 @@
-import { Fluorescence as Chart } from '../../engine';
+/**
+ * Fluorescence 渲染器
+ */
+import { Fluorescence as Chart } from '@rfkit/renderer';
+import { GradientRenderer, type GradientRenderState } from '../base';
+interface FluorescenceData {
+    fluorescenceData: Map<number, number>[];
+    fluorescenceMaxCount: number;
+}
 interface FluorescenceRenderProps {
     id: string;
     globalID: string;
 }
-interface FluorescenceRenderState extends FluorescenceRenderProps {
-    chart: Chart | null;
-}
-export default class FluorescenceRender {
-    state: FluorescenceRenderState;
+type FluorescenceRenderState = GradientRenderState<Chart>;
+export default class FluorescenceRender extends GradientRenderer<Chart, FluorescenceRenderState, FluorescenceData> {
     constructor(props: FluorescenceRenderProps);
-    init(): void;
-    /**
-     * 参数发生改变
-     *
-     * @param params 更新的参数
-     * @memberof WaterfallRender
-     */
-    updateParams(params: Partial<FluorescenceRenderProps>): void;
-    /**
-     * 更新属性
-     *
-     * @param props
-     * @memberof FluorescenceRender
-     */
+    protected init(): void;
     updateProps(props: Record<string, unknown>): void;
-    /**
-     * 更新数据
-     *
-     * @param {*} fluorescenceData
-     * @memberof FluorescenceRender
-     */
-    updateSeries(data: {
-        fluorescenceData: Map<number, number>[];
-        fluorescenceMaxCount: number;
-    }): void;
-    reset(): void;
-    resize(): void;
-    clear(): void;
+    updateSeries(data: FluorescenceData): void;
 }
 export {};

package/modules/Gauge/render.d.ts

@@ -1,10 +1,31 @@
-export default class IQStream {
-    private state;
-    constructor(props: any);
-    private init;
-    updateProps(p: any): void;
-    updateSeries(d: any): void;
-    reset(): void;
-    resize(): void;
-    clear(): void;
+/**
+ * Gauge 渲染器
+ */
+import { Gauge } from '@rfkit/renderer';
+import { BaseRenderer, type BaseRenderState } from '../base';
+interface GaugeData {
+    value: number;
+    range?: [number, number];
 }
+interface GaugeRenderProps {
+    id: string;
+    [key: string]: unknown;
+}
+interface GaugeRenderState extends BaseRenderState<Gauge> {
+    props: GaugeRenderProps;
+}
+/**
+ * Gauge 渲染器
+ *
+ * 由于 Gauge 有额外的 props 透传和 updateProps 方法，
+ * 不完全继承 CircularRenderer，而是直接继承 BaseRenderer
+ */
+export default class GaugeRender extends BaseRenderer<Gauge, GaugeRenderState, GaugeData> {
+    private themeUnsubscribe;
+    constructor(props: GaugeRenderProps);
+    protected init(): void;
+    updateProps(p: Record<string, unknown>): void;
+    updateSeries(data: GaugeData): void;
+    destroy(): void;
+}
+export {};

package/modules/Heatmap/render.d.ts

@@ -1,24 +1,24 @@
-export default class Heatmap {
-    [x: string]: any;
-    constructor(props: any);
-    init(): void;
-    /**
-     * 参数发生改变
-     *
-     * @param {*} params
-     * @memberof Heatmap
-     */
-    updateParams(params: any): void;
-    /**
-     * 更新数据
-     *
-     * @param {*} d
-     * @param {*} updateSeries
-     * @memberof Heatmap
-     */
-    updateSeries(d: any): void;
-    setRange(realRange?: any): void;
+/**
+ * Heatmap 渲染器
+ */
+import { type IHeatmap } from '@rfkit/renderer';
+import { GradientRenderer, type GradientRenderState } from '../base';
+interface HeatmapRenderProps {
+    id: string;
+    globalID: string;
+    realRange?: [number, number];
+    heatmapDefaultData?: number[][];
+}
+interface HeatmapRenderState extends GradientRenderState<IHeatmap> {
+    realRange: [number, number];
+    heatmapDefaultData: number[][];
+}
+export default class Heatmap extends GradientRenderer<IHeatmap, HeatmapRenderState, number[][]> {
+    constructor(props: HeatmapRenderProps);
+    protected init(): void;
+    updateSeries(data: number[][]): void;
+    setRange(realRange?: [number, number]): void;
     reset(): void;
     resize(): void;
-    clear(): void;
 }
+export {};

package/modules/IQEye/index.d.ts

@@ -1 +1,6 @@
-export default function IQPlanisphere(): import("react/jsx-runtime").JSX.Element;
+import { type IQChartType } from '../base';
+interface IQEyeProps {
+    type?: IQChartType;
+}
+export default function IQEye({ type }: IQEyeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/modules/IQPlanisphere/index.d.ts

@@ -1 +1,6 @@
-export default function IQPlanisphere(): import("react/jsx-runtime").JSX.Element;
+import { type IQChartType } from '../base';
+interface IQPlanisphereProps {
+    type?: IQChartType;
+}
+export default function IQPlanisphere({ type }: IQPlanisphereProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/modules/IQStream/index.d.ts

@@ -1,2 +1,6 @@
-declare const IQStream: React.FC;
+import { type IQChartType } from '../base';
+interface IQStreamProps {
+    type?: IQChartType;
+}
+declare const IQStream: React.FC<IQStreamProps>;
 export default IQStream;

package/modules/Occupancy/render.d.ts

@@ -1,9 +1,15 @@
-export default class Occupancy {
-    state: any;
-    constructor(props: any);
-    init(): void;
-    updateSeries(data: any): void;
-    reset(): void;
-    resize(): void;
-    clear(): void;
+import { type ISeries, OrientationType } from '@rfkit/renderer';
+import { BaseRenderer, type BaseRenderState } from '../base/BaseRenderer';
+interface OccupancyRenderProps {
+    id: string;
+    orientation?: OrientationType;
 }
+interface OccupancyRenderState extends BaseRenderState<ISeries> {
+    orientation: OrientationType;
+}
+export default class Occupancy extends BaseRenderer<ISeries, OccupancyRenderState, Float32Array> {
+    constructor(props: OccupancyRenderProps);
+    protected init(): void;
+    updateSeries(data: Float32Array): void;
+}
+export {};

package/modules/SpatialSpectrum/render.d.ts

@@ -1,9 +1,14 @@
-export default class IQStream {
-    private state;
-    constructor(props: any);
-    private init;
-    updateSeries(d: any): void;
-    reset(): void;
-    resize(): void;
-    clear(): void;
+/**
+ * SpatialSpectrum (Radar) 渲染器
+ */
+import { Radar } from '@rfkit/renderer';
+import { CircularRenderer, type CircularRenderState } from '../base';
+type SpatialSpectrumRenderState = CircularRenderState<Radar>;
+interface SpatialSpectrumRenderProps {
+    id: string;
 }
+export default class SpatialSpectrumRender extends CircularRenderer<Radar, SpatialSpectrumRenderState> {
+    constructor(props: SpatialSpectrumRenderProps);
+    protected init(): void;
+}
+export {};

package/modules/Spectrum/render.d.ts

@@ -1,7 +1,7 @@
-import { Series } from '../../engine';
+import { type ISeries } from '@rfkit/renderer';
 import type { SeriesConfig } from '../../types';
 interface SpectrumState {
-    chart: Series | null;
+    chart: ISeries | null;
     autoranging: boolean;
     prevAutoRangeTime: number;
     id: string;
@@ -9,6 +9,7 @@ interface SpectrumState {
     interval: number;
     series: Record<string, SeriesConfig>;
     globalID: string;
+    [key: string]: unknown;
 }
 export default class Spectrum {
     state: SpectrumState;

package/modules/base/BaseRenderer.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 渲染器抽象基类
+ *
+ * 提供统一的生命周期管理和资源清理机制
+ */
+/**
+ * 渲染器接口
+ */
+export interface IRenderer<TData = unknown> {
+    updateSeries(data: TData): void;
+    reset(): void;
+    resize(): void;
+    clear(): void;
+    destroy(): void;
+}
+/**
+ * 基础渲染状态
+ * 添加索引签名以兼容 RenderChartType.state
+ */
+export interface BaseRenderState<TChart = unknown> {
+    id: string;
+    chart: TChart | null;
+    [key: string]: unknown;
+}
+/**
+ * 具有 resize/clear/draw 方法的图表接口
+ */
+interface ChartLike {
+    resize?: () => void;
+    clear?: () => void;
+    draw?: () => void;
+    updateProps?: (props: Record<string, unknown>) => void;
+}
+/**
+ * 渲染器抽象基类
+ *
+ * @template TChart - 内部图表引擎类型
+ * @template TState - 渲染器状态类型
+ * @template TData - 数据类型
+ */
+export declare abstract class BaseRenderer<TChart extends ChartLike, TState extends BaseRenderState<TChart> = BaseRenderState<TChart>, TData = unknown> implements IRenderer<TData> {
+    /** 公开 state 以兼容 RenderChartType 接口 */
+    state: TState;
+    protected resizeTimer: ReturnType<typeof setTimeout> | null;
+    constructor(initialState: TState);
+    /**
+     * 初始化图表引擎（子类必须实现）
+     */
+    protected abstract init(): void;
+    /**
+     * 更新数据（子类必须实现）
+     */
+    abstract updateSeries(data: TData): void;
+    /**
+     * 重置（清空 + 调整大小）
+     */
+    reset(): void;
+    /**
+     * 调整大小
+     */
+    resize(): void;
+    /**
+     * 清空图表
+     */
+    clear(): void;
+    /**
+     * 销毁资源
+     */
+    destroy(): void;
+    /**
+     * dispose 别名，兼容 RenderChartType 接口
+     */
+    dispose(): (() => void) | undefined;
+    /**
+     * 延迟调整大小（用于初始化后的首次 resize）
+     */
+    protected scheduleResize(delay?: number): void;
+    /**
+     * 清理 resize 定时器
+     */
+    protected clearResizeTimer(): void;
+}
+export {};

package/modules/base/CircularRenderer.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 圆形图表渲染器基类
+ *
+ * 提供主题订阅功能，适用于 Dial、Radar（SpatialSpectrum）、Gauge 等圆形图表
+ */
+import { BaseRenderer, type BaseRenderState } from './BaseRenderer';
+/**
+ * 圆形图表数据项
+ */
+export interface CircularSeriesItem {
+    value: number;
+    color: string;
+    lineWidth?: number;
+    radio?: number;
+}
+/**
+ * 圆形图表数据
+ */
+export interface CircularData {
+    series?: CircularSeriesItem[];
+    range?: number[];
+    yawAngle?: number;
+    isNorthFacing?: boolean;
+}
+/**
+ * 具有 render/updateProps/draw 方法的圆形图表接口
+ */
+interface CircularChartLike {
+    resize?: () => void;
+    clear?: () => void;
+    draw?: () => void;
+    updateProps?: (props: Record<string, unknown>) => void;
+    render?: (data: CircularData) => void;
+}
+/**
+ * 圆形渲染状态
+ */
+export interface CircularRenderState<TChart extends CircularChartLike> extends BaseRenderState<TChart> {
+    id: string;
+}
+/**
+ * 圆形图表渲染器基类
+ */
+export declare abstract class CircularRenderer<TChart extends CircularChartLike, TState extends CircularRenderState<TChart> = CircularRenderState<TChart>> extends BaseRenderer<TChart, TState, CircularData> {
+    protected themeUnsubscribe: (() => void) | null;
+    /**
+     * 订阅主题变化
+     */
+    protected subscribeToTheme(): void;
+    /**
+     * 更新数据
+     */
+    updateSeries(data: CircularData): void;
+    /**
+     * 销毁资源
+     */
+    destroy(): void;
+}
+export {};

package/modules/base/GradientRenderer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 颜色梯度渲染器基类
+ *
+ * 提供颜色梯度管理功能，适用于 Heatmap、Fluorescence 等热力图类图表
+ */
+import { hexToRGBA } from '@rfkit/renderer';
+import { BaseRenderer, type BaseRenderState } from './BaseRenderer';
+/**
+ * 具有 updateProps/render 方法的梯度图表接口
+ */
+interface GradientChartLike {
+    resize?: () => void;
+    clear?: () => void;
+    updateProps?: (props: Record<string, unknown>) => void;
+    render?: (data: unknown) => void;
+}
+/**
+ * 梯度渲染状态
+ */
+export interface GradientRenderState<TChart extends GradientChartLike> extends BaseRenderState<TChart> {
+    globalID: string;
+}
+/**
+ * 颜色梯度渲染器基类
+ */
+export declare abstract class GradientRenderer<TChart extends GradientChartLike, TState extends GradientRenderState<TChart> = GradientRenderState<TChart>, TData = unknown> extends BaseRenderer<TChart, TState, TData> {
+    /**
+     * 获取初始颜色配置
+     */
+    protected getInitialColors(): ReturnType<typeof hexToRGBA>[];
+    /**
+     * 订阅颜色变化
+     *
+     * @param key - 订阅标识符
+     */
+    protected subscribeToColor(key: string): void;
+    /**
+     * 参数发生改变时调用
+     */
+    updateParams(params: Partial<TState>): void;
+}
+export {};

package/modules/base/IQRenderer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * IQ 渲染器
+ *
+ * 合并 IQEye、IQStream、IQPlanisphere 三个渲染器
+ * 通过 type 参数区分不同的渲染模式
+ */
+import { IQ, IQEye } from '@rfkit/renderer';
+import { BaseRenderer, type BaseRenderState } from './BaseRenderer';
+/**
+ * IQ 图表类型
+ */
+export type IQChartType = 'iqEye' | 'iqLine' | 'iqPlanisphere' | 'iqStream';
+/**
+ * IQ 渲染状态
+ */
+interface IQRenderState extends BaseRenderState<IQ | IQEye> {
+    type: IQChartType;
+}
+/**
+ * IQ 渲染器属性
+ */
+interface IQRenderProps {
+    id: string;
+    type: IQChartType;
+}
+/**
+ * IQ 渲染器
+ */
+export default class IQRenderer extends BaseRenderer<IQ | IQEye, IQRenderState, IQData> {
+    constructor(props: IQRenderProps);
+    protected init(): void;
+    updateSeries(data: IQData): void;
+}
+/**
+ * IQ 数据类型
+ */
+export interface IQData {
+    IData: number[];
+    QData: number[];
+}
+export {};

package/modules/base/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 渲染器基类导出
+ */
+export { BaseRenderer, type BaseRenderState, type IRenderer } from './BaseRenderer';
+export { type CircularData, CircularRenderer, type CircularRenderState, type CircularSeriesItem } from './CircularRenderer';
+export { GradientRenderer, type GradientRenderState } from './GradientRenderer';
+export { default as IQRenderer, type IQChartType, type IQData } from './IQRenderer';

package/modules/tools.d.ts

@@ -1,2 +1,3 @@
-declare const _default: (globalID: string, name: string, func?: any) => (...args: any[]) => void;
+import { type CSMCallback } from '../utils/subscription';
+declare const _default: (globalID: string, name: string, func?: CSMCallback) => (...args: any[]) => void;
 export default _default;

package/package.json

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

package/store/reducer.d.ts

@@ -30,6 +30,7 @@ export declare const defaultState: () => {
     levelStream?: import("../types").LevelStreamProps;
     timeRange?: number;
     fluorescence: import("../types").FluorescenceProps;
+    deltaMeasurement: import("../types").DeltaMeasurementProps;
     publish?: import("..").Publish;
 };
 export declare const reducer: (state: StoreState, action: DispatchAction) => {
@@ -62,5 +63,6 @@ export declare const reducer: (state: StoreState, action: DispatchAction) => {
     levelStream?: import("../types").LevelStreamProps;
     timeRange?: number;
     fluorescence: import("../types").FluorescenceProps;
+    deltaMeasurement: import("../types").DeltaMeasurementProps;
     publish?: import("..").Publish;
 };

package/types/common.d.ts

@@ -1,4 +1,4 @@
-import type { GraphicType, OrientationType } from '../engine';
+import type { GraphicType, OrientationType } from '@rfkit/renderer';
 import type { Publish, RecursiveObject, SetSeries } from './';
 export type AxisYRange = [number, number];
 export interface AxisXRange {
@@ -11,21 +11,23 @@ export interface TopRightBottomLeft {
     right?: number;
     bottom?: number;
 }
-export type RenderChartType = {
-    resize(): unknown;
+export interface RenderChartType {
     state: {
+        id: string;
+        chart: unknown;
         [key: string]: unknown;
     };
-    updateProps(...arg: unknown[]): unknown;
-    updateSeries(...arg: unknown[]): unknown;
-    setDisabledClearRect(disabledClearRect: boolean): unknown;
     reset(): unknown;
-    useRangeAutoFocus(): unknown;
-    dispose(): () => void;
-    setSeries(s: SetSeries): unknown;
-    setRange: (range: AxisYRange) => void;
-    updateParams: (params: RecursiveObject) => void;
-};
+    resize(): unknown;
+    dispose(): (() => void) | undefined;
+    updateProps?(...arg: unknown[]): unknown;
+    updateSeries?(...arg: unknown[]): unknown;
+    setDisabledClearRect?(disabledClearRect: boolean): unknown;
+    useRangeAutoFocus?(): unknown;
+    setSeries?(s: SetSeries): unknown;
+    setRange?(range: AxisYRange): void;
+    updateParams?(params: RecursiveObject): void;
+}
 export interface SeriesConfig {
     readonly name: string;
     label?: string;

package/types/publish.d.ts

@@ -68,7 +68,10 @@ export interface PublishHeatmap {
 }
 export interface PublishFluorescence {
     pstype: PSType.Fluorescence;
-    data: Uint32Array[];
+    data: {
+        fluorescenceData: Map<number, number>[];
+        fluorescenceMaxCount: number;
+    };
 }
 export interface PublishOccupancy {
     pstype: PSType.Occupancy;

package/types/store/axis.d.ts

@@ -0,0 +1,29 @@
+import type { AxisYRange, RecursiveObject } from '..';
+export interface AxisYProps {
+    show?: boolean;
+    disabled?: boolean;
+    gradientRibbon?: boolean;
+    realRange?: number[];
+    range?: AxisYRange;
+    renderRange?: AxisYRange;
+    restrict?: number[];
+    autoranging?: boolean;
+    step?: number;
+    unit?: string;
+    unitList?: string[];
+    unitDisabled?: boolean;
+    type?: string;
+    hidden?: string[];
+    linkage?: boolean;
+    onChange?: (e: RecursiveObject) => void;
+}
+export interface AxisXProps {
+    show?: boolean;
+    range?: number[];
+    unit?: string;
+    unitKHz?: string;
+    ticks?: boolean;
+    children?: React.ReactNode;
+    onChange?: () => void;
+    frequencyFormat?: (x: number) => string;
+}

package/types/store/frequency.d.ts

@@ -0,0 +1,19 @@
+export interface FrequencyAllocationItem {
+    startFrequency?: number | string;
+    stopFrequency?: number | string;
+    centerFrequency?: number | string;
+    stepFrequency: number | string;
+    bandwidth?: number | string;
+    modulation: string;
+    title: string;
+    description: string;
+    demodulation?: string;
+    status?: string;
+    color?: string;
+    gradientColors?: [string, string];
+}
+export interface FrequencyAllocationProps {
+    show: boolean;
+    display: boolean;
+    data: FrequencyAllocationItem[];
+}