@rfkit/charts 1.2.28 → 1.3.1

package/components/AxisY/occupancy/index.d.ts

@@ -1,6 +1,7 @@
 import type React from 'react';
 interface Props {
     disabled?: boolean;
+    inside?: boolean;
 }
 declare const AxisYOccupancy: React.FC<Props>;
 export default AxisYOccupancy;

package/components/AxisY/occupancy/type/Default/index.d.ts

@@ -1,3 +1,6 @@
 import React from 'react';
-declare const _default: React.NamedExoticComponent<{}>;
+interface Props {
+    inside?: boolean;
+}
+declare const _default: React.NamedExoticComponent<Props>;
 export default _default;

package/components/AxisY/spectrum/useRanging/tools.d.ts

@@ -1,24 +1,40 @@
+/**
+ * 虚拟范围数据结构
+ */
+interface VirtualRangeData {
+    flaw: number;
+    offset: number;
+    range: [number, number];
+    renderRange: [number, number];
+}
 /**
  * 全局共享的虚拟范围值
  */
-export declare const VIRTUAL_RANGE: (globalID: string, virtual?: any) => any;
+export declare const VIRTUAL_RANGE: (globalID: string, virtual?: VirtualRangeData) => VirtualRangeData;
+interface VirtualRangeParams {
+    unit?: string;
+    realRange?: number[];
+    step?: number;
+    globalID: string;
+}
 /**
  * 虚拟范围管理器
  */
-export declare function useVirtualRange({ unit, realRange, step, globalID }: any): {
-    offset: number;
-    range: any;
-    renderRange: any;
-    flaw: number;
-};
+export declare function useVirtualRange({ unit, realRange, step, globalID }: VirtualRangeParams): VirtualRangeData;
+interface Range2RealRangeParams {
+    range: [number, number];
+    unit?: string;
+    globalID: string;
+}
 /**
  * 虚拟范围转真实范围
  */
-export declare function range2realRange({ range, unit, globalID }: any): {
-    realRange: any;
-    renderRange: any;
+export declare function range2realRange({ range, unit, globalID }: Range2RealRangeParams): {
+    realRange: [number, number];
+    renderRange: [number, number];
 };
 /**
  * 获取虚拟电频值
  */
-export declare function getVirtualLevel(unit: string, v: number | any): any;
+export declare function getVirtualLevel(unit: string, v: number): number;
+export {};

package/components/AxisY/tools.d.ts

@@ -0,0 +1,2 @@
+import type { AxisYRange } from '../../types';
+export declare function getAxisYDoubleClickResetRange(restrict: number[] | undefined): AxisYRange;

package/components/Blaze/tools.d.ts

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

package/components/Cursor/tools.d.ts

@@ -1,5 +1,5 @@
 import type { RecursiveFunction } from '../../types';
-export declare const CURSOR_TIMEOUT: (globalID: string, timer?: number | NodeJS.Timeout) => any;
+export declare const CURSOR_TIMEOUT: (globalID: string, timer?: number | NodeJS.Timeout) => number | NodeJS.Timeout;
 export declare const CURSOR_SETACTIVE: (globalID: string, func?: RecursiveFunction) => (...args: any[]) => void;
 /**
  * 将位置信息转换为视觉left

package/components/Dashed/index.d.ts

@@ -5,6 +5,7 @@ interface Props {
     color?: string;
     x?: boolean;
     y?: boolean;
+    lineWidth?: number;
 }
 declare const Dashed: React.FC<Props>;
 export default Dashed;

package/components/DeltaMeasurement/Switch.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+declare const DeltaMeasurementSwitch: React.FC;
+export default DeltaMeasurementSwitch;

package/components/DeltaMeasurement/index.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+declare const DeltaMeasurement: React.FC;
+export default DeltaMeasurement;

package/components/DragSelectBox/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 通用拖拽框选组件
+ * 用于创建可拖拽、可调整大小的矩形框
+ */
+import type React from 'react';
+import type { ReactNode } from 'react';
+import { type RectPosition } from '../../hooks/useDragSelect';
+export interface DragSelectBoxProps {
+    enabled: boolean;
+    defaultRect?: Partial<RectPosition>;
+    minSize?: number;
+    maxSize?: number;
+    snapThreshold?: number;
+    onChange?: (rect: RectPosition) => void;
+    onDragEnd?: (rect: RectPosition) => void;
+    children?: ReactNode;
+    labels?: {
+        top?: ReactNode;
+        bottom?: ReactNode;
+        left?: ReactNode;
+        right?: ReactNode;
+    };
+    className?: string;
+    zIndex?: number;
+    showBoundaryLines?: boolean;
+}
+declare const DragSelectBox: React.FC<DragSelectBoxProps>;
+export default DragSelectBox;

package/components/Dropdown/index.d.ts

@@ -4,6 +4,7 @@ export interface DropdownOption {
     label: string;
     style?: React.CSSProperties;
     render?: () => React.ReactNode;
+    disabled?: boolean;
 }
 interface DropdownProps {
     value: string | number | null;

package/components/EventBus/tools.d.ts

@@ -45,8 +45,8 @@ export declare const CURSOR_STYLE_MAP: {
     zoom: string;
     area: string;
 };
-export declare const getEventLevel: (id: string, level?: string) => any;
-export declare const getEventType: (id: string, type?: string) => any;
+export declare const getEventLevel: (id: string, level?: string) => string;
+export declare const getEventType: (id: string, type?: string) => string;
 /**
  * 比较事件优先级
  * @param id 事件ID

package/components/Markers/hooks/useMarkerEvents.d.ts

@@ -9,6 +9,7 @@ interface UseMarkerEventsProps {
     }) => void;
     onDeleteMarker: (id: string) => void;
     onUpdateMarker: (id: string, position: TopRightBottomLeft) => void;
+    onToggleSelect: (id: string) => void;
     onHover: (e: {
         left: number;
     }) => void;

package/components/Markers/hooks/useMarkers.d.ts

@@ -40,6 +40,8 @@ export declare const useMarkers: (props: UseMarkersProps) => {
         left: number;
     }) => string;
     resetHover: () => void;
+    toggleMainSecondaryPeaks: () => void;
+    moveToAdjacentPeak: (direction: "left" | "right", markerId: string) => void;
     setState: import("react").Dispatch<import("react").SetStateAction<MarkerState>>;
 };
 export {};

package/components/Markers/tools.d.ts

@@ -7,6 +7,19 @@ export declare const MARKER_UPDATE_RESET: (id: string, func?: RecursiveFunction)
 export declare const MARKER_COUNT_CHANGE: (id: string, func?: RecursiveFunction<[{
     count: number;
 }]>) => (...args: any[]) => void;
+export declare const MARKER_SELECTION_CHANGE: (id: string, func?: RecursiveFunction<[{
+    selectedId: string | null;
+}]>) => (...args: any[]) => void;
+export type MarkerCommand = {
+    type: 'main-secondary-peaks';
+} | {
+    type: 'left-peak';
+    selectedId: string;
+} | {
+    type: 'right-peak';
+    selectedId: string;
+};
+export declare const MARKER_COMMAND: (id: string, func?: RecursiveFunction) => (...args: any[]) => void;
 export declare const leftDataSelectMax: (left: number, data: Float32Array) => number;
 export declare function fixLocation(location: number, len: number): number;
 interface ZoomLeftParams {
@@ -23,7 +36,9 @@ export interface PeakPoint {
     value: number;
     index: number;
 }
+export declare function findMaxPeak(data: Float32Array): PeakPoint | null;
 export declare function findPeaks(data: Float32Array): PeakPoint[] | null;
+export declare function findTopPeaks(data: Float32Array, count?: number, threshold?: number, minDistance?: number): PeakPoint[];
 export declare function findMultiplePeaks(data: Float32Array, threshold?: number, minDistance?: number): PeakPoint[];
 export declare function findNearbyPeak(data: Float32Array, targetIndex: number, searchRadius?: number): PeakPoint | null;
 export declare const setMarkerMove: (marker: MarkerType, segments: SegmentsType, callback: RecursiveFunction) => void;

package/components/Zoom/ZoomOffsetContainer/index.d.ts

@@ -1,6 +1,7 @@
 interface Props {
     children: React.ReactNode;
     className?: string;
+    style?: React.CSSProperties;
 }
 declare const ZoomOffsetContainer: import("react").ForwardRefExoticComponent<Props & import("react").RefAttributes<HTMLDivElement>>;
 export default ZoomOffsetContainer;

package/config/constants.d.ts

@@ -9,8 +9,16 @@ export declare const SERIES: {
 };
 export declare const SERIES_NAMES: string[];
 export declare const REAL_DATA_NAME: string;
-export declare const ZOOM_MIN_RANGE = 10;
-export declare const POPOVER_MARGIN = 16;
+/** @deprecated 使用 UI_CONFIG.ZOOM_MIN_RANGE */
+export declare const ZOOM_MIN_RANGE: 10;
+/** @deprecated 使用 UI_CONFIG.POPOVER_MARGIN */
+export declare const POPOVER_MARGIN: 16;
+export declare enum FrequencyUnit {
+    Hz = "Hz",
+    kHz = "kHz",
+    MHz = "MHz",
+    GHz = "GHz"
+}
 export declare enum ChartType {
     SingleFrequency = "singleFrequency",
     Scan = "scan",
@@ -39,7 +47,6 @@ export declare enum ModuleType {
     IQPlanisphere = "iqPlanisphere",
     IQEye = "iqEye",
     IQLine = "iqLine",
-    Factor = "factor",
     SpatialSpectrum = "spatialSpectrum"
 }
 export declare enum PSType {
@@ -128,7 +135,8 @@ export declare enum ToolsBarItemType {
     SignalSwitch = "SignalSwitch",
     SegmentsDisplayControl = "SegmentsDisplayControl",
     SeriesDisplayControl = "SeriesDisplayControl",
-    FluorescenceSwitch = "FluorescenceSwitch"
+    FluorescenceSwitch = "FluorescenceSwitch",
+    DeltaMeasurementSwitch = "DeltaMeasurementSwitch"
 }
 export declare enum SeriesType {
     RealData = "realData",

package/config/setting.d.ts

@@ -1,3 +1,12 @@
+/**
+ * UI 配置常量
+ */
+export declare const UI_CONFIG: {
+    /** 缩放最小范围 */
+    readonly ZOOM_MIN_RANGE: 10;
+    /** Popover 边距 */
+    readonly POPOVER_MARGIN: 16;
+};
 export interface LineConfig {
     name: string;
     color: string;

package/hooks/data/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 数据处理相关 hooks
+ */
+export { default as useChannel } from './useChannel';
+export { default as usePoints } from './usePoints';
+export { default as useSegments } from './useSegments';

package/hooks/{useSegments.d.ts → data/useSegments.d.ts}

@@ -1,2 +1,2 @@
-import type { SegmentsType } from '../types';
+import type { SegmentsType } from '../../types';
 export default function useSegments(): [SegmentsType, (s: SegmentsType) => void];

package/hooks/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hooks 统一导出
+ */
+export { useChannel, usePoints, useSegments } from './data';
+export { PUB_SUB, useMarkerPublish, usePublish, useSafePublish } from './publish';
+export { SET_SEGMENTS_DISPLAY, type UseSpectrumChartTypeProps, useSpectrumChartType, useSpectrumRule } from './spectrum';
+export { default as useChart } from './useChart';
+export { type EnhancedPublish, withChartPublisher } from './useChartComponent';
+export { default as useLevelStreamAnalyzer } from './useLevelStreamAnalyzer';
+export { useModuleSubscription } from './useModuleSubscription';
+export { useFilteredSeries, useSeriesForComponent, useSeriesManager } from './useSeriesManager';
+export { default as useSpectrumAnalyzer } from './useSpectrumAnalyzer';

package/hooks/publish/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 发布相关 hooks
+ */
+export { default as useMarkerPublish } from './useMarkerPublish';
+export { default as usePublish, PUB_SUB } from './usePublish';
+export { default as useSafePublish } from './useSafePublish';

package/hooks/{useMarkerPublish.d.ts → publish/useMarkerPublish.d.ts}

@@ -1,4 +1,4 @@
-import type { PublishData } from '../types';
+import type { PublishData } from '../../types';
 interface UseMarkerPublishProps {
     globalID: string;
 }

package/hooks/{usePublish.d.ts → publish/usePublish.d.ts}

@@ -1,5 +1,5 @@
-import type { Publish } from '../types';
-import { type CSMCallback } from '../utils/subscription';
+import type { Publish } from '../../types';
+import { type CSMCallback } from '../../utils/subscription';
 export declare const PUB_SUB: (globalID: string, func?: CSMCallback) => (...args: any[]) => void;
 interface Props {
     subscribe?: CSMCallback;

package/hooks/{useSafePublish.d.ts → publish/useSafePublish.d.ts}

@@ -1,8 +1,8 @@
-import type { Publish, PublishData } from '../index';
-import type { rawData } from '../utils/subscription';
+import type { Publish, PublishData } from '../../index';
+import type { rawData } from '../../utils/subscription';
 interface EnhancedPublish extends Publish {
     isReady: () => boolean;
-    onReady: (callback: () => void | (() => void)) => void | (() => void);
+    onReady: (callback: () => undefined | (() => void)) => undefined | (() => void);
     getSourceData: () => rawData;
 }
 export interface UseSafePublishReturn {

package/hooks/spectrum/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 频谱相关 hooks
+ */
+export type { Props as UseSpectrumChartTypeProps } from './useSpectrumChartType';
+export { default as useSpectrumChartType } from './useSpectrumChartType';
+export { default as useSpectrumRule, SET_SEGMENTS_DISPLAY } from './useSpectrumRule';

package/hooks/{useSpectrumChartType.d.ts → spectrum/useSpectrumChartType.d.ts}

@@ -1,4 +1,4 @@
-import { ChartType } from '../config';
+import { ChartType } from '../../config';
 export interface Props {
     type: ChartType;
     heatmapElementID?: string;

package/hooks/{useSpectrumRule.d.ts → spectrum/useSpectrumRule.d.ts}

@@ -1,4 +1,4 @@
-import { ChartType } from '../config';
-import type { PublishData, RecursiveFunction } from '../types';
+import { ChartType } from '../../config';
+import type { PublishData, RecursiveFunction } from '../../types';
 export declare const SET_SEGMENTS_DISPLAY: (globalID: string, func?: RecursiveFunction) => (...args: any[]) => void;
 export default function useSpectrumRule(type: ChartType): (e: PublishData) => void;

package/hooks/useChart/index.d.ts

@@ -1,12 +1,21 @@
+import type React from 'react';
 import type { RecursiveObject, RenderChartType } from '../../types';
-interface Props {
-    Render: any;
+/**
+ * Render 类构造函数类型
+ * 所有 render 类必须接受 id 和 globalID 参数，并实现 RenderChartType 接口
+ */
+type RenderConstructor<T extends RenderChartType = RenderChartType> = new (props: {
+    id: string;
+    globalID: string;
+} & RecursiveObject) => T;
+interface Props<T extends RenderChartType = RenderChartType> {
+    Render: RenderConstructor<T>;
     params?: RecursiveObject;
     onIDChange?: (id: string) => void;
 }
-declare const useChart: (props: Props) => {
+declare const useChart: <T extends RenderChartType = RenderChartType>(props: Props<T>) => {
     id: string;
-    chart: RenderChartType;
-    Chart: (e: any) => import("react/jsx-runtime").JSX.Element;
+    chart: T;
+    Chart: (e: React.HTMLAttributes<HTMLDivElement>) => import("react/jsx-runtime").JSX.Element;
 };
 export default useChart;

package/hooks/useDragSelect.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 通用拖拽框选 Hook
+ * 提炼自 HeatmapCapture/Slider 的框选能力
+ */
+export type DragType = 'top' | 'bottom' | 'left' | 'right' | 'middle' | null;
+export interface RectPosition {
+    position: number;
+    height: number;
+    leftPosition: number;
+    width: number;
+}
+export interface UseDragSelectConfig {
+    enabled?: boolean;
+    defaultRect?: Partial<RectPosition>;
+    minSize?: number;
+    maxSize?: number;
+    snapThreshold?: number;
+    onChange?: (rect: RectPosition) => void;
+    onDragEnd?: (rect: RectPosition) => void;
+}
+/**
+ * 通用拖拽框选 Hook
+ */
+export declare const useDragSelect: (config?: UseDragSelectConfig) => {
+    rect: RectPosition;
+    isDragging: boolean;
+    dragType: DragType;
+    containerRef: import("react").RefObject<HTMLDivElement>;
+    handleMouseDown: (e: React.MouseEvent<HTMLDivElement>, type: DragType) => void;
+    resetRect: (newRect: Partial<RectPosition>) => void;
+    setRect: (newRect: RectPosition) => void;
+};

package/hooks/useModuleSubscription.d.ts

@@ -0,0 +1,66 @@
+import type { ModuleType } from '../config';
+import type { PublishData } from '../types';
+/**
+ * 模块订阅所需的图表接口（最小化）
+ */
+interface ChartSubscriptionInterface<TData = unknown> {
+    updateSeries?(data: TData): void;
+    reset(): void;
+    resize(): void;
+}
+type DataExtractor<TData> = (d: PublishData) => TData;
+type CustomHandler = (d: PublishData) => boolean | undefined;
+interface UseModuleSubscriptionOptions<TData = unknown> {
+    /**
+     * 模块类型
+     */
+    moduleType: ModuleType;
+    /**
+     * 图表实例
+     */
+    chart: ChartSubscriptionInterface<TData> | null | undefined;
+    /**
+     * 从 PublishData 中提取数据（默认直接传递整个 d）
+     */
+    extractData?: DataExtractor<TData>;
+    /**
+     * 自定义处理器（返回 true 表示已处理，跳过默认逻辑）
+     */
+    customHandler?: CustomHandler;
+}
+/**
+ * 模块订阅 Hook
+ *
+ * 提供统一的数据订阅模式，处理 Render/Reset/Resize 事件
+ *
+ * @example
+ * // 基础用法
+ * useModuleSubscription({
+ *   moduleType: ModuleType.Dial,
+ *   chart
+ * });
+ *
+ * @example
+ * // 提取特定数据字段
+ * useModuleSubscription({
+ *   moduleType: ModuleType.Occupancy,
+ *   chart,
+ *   extractData: (d) => d.data
+ * });
+ *
+ * @example
+ * // 自定义处理
+ * useModuleSubscription({
+ *   moduleType: ModuleType.Heatmap,
+ *   chart,
+ *   customHandler: (d) => {
+ *     if (d.pstype === PSType.Option) {
+ *       // 自定义处理
+ *       return true; // 已处理
+ *     }
+ *     return false; // 继续默认处理
+ *   }
+ * });
+ */
+export declare function useModuleSubscription<TData = unknown>({ moduleType, chart, extractData, customHandler }: UseModuleSubscriptionOptions<TData>): void;
+export default useModuleSubscription;

package/hooks/useSeriesManager/index.d.ts

@@ -3,4 +3,4 @@
  * 提供所有 series 相关的 hooks
  */
 export { useFilteredSeries } from './useFilteredSeries';
-export { useSeriesData, useSeriesForComponent, useSeriesManager } from './useSeriesManager';
+export { useSeriesForComponent, useSeriesManager } from './useSeriesManager';

package/hooks/useSeriesManager/useFilteredSeries.d.ts

@@ -14,6 +14,6 @@ export declare function useFilteredSeries(globalID: string | undefined, filter?:
     color: string;
     thickness: number;
     display: boolean;
-    type: import("../../engine").GraphicType;
+    type: import("@rfkit/renderer").GraphicType;
 }[];
 export default useFilteredSeries;

package/hooks/useSeriesManager/useSeriesManager.d.ts

@@ -28,14 +28,6 @@ export interface UseSeriesManagerResult {
  * 统一的 Series 管理 Hook
  */
 export declare function useSeriesManager(globalID: string | undefined, options?: UseSeriesManagerOptions): UseSeriesManagerResult;
-/**
- * 轻量级版本 - 只获取数据，不订阅变化
- */
-export declare function useSeriesData(globalID: string | undefined): {
-    series: Map<string, SeriesConfig>;
-    mode: SeriesMode;
-    getSeries: (name: string) => SeriesConfig | undefined;
-};
 /**
  * 专门用于组件的版本 - 自动订阅所有变化
  */

package/index.d.ts

@@ -1,9 +1,11 @@
 export { setFrequencyAllocationToCache } from './components/FrequencyAllocation/tools';
-export { ChartType, MarkerEventType, OptionKey, PSType, SegmentsEvent, SeriesType, ToolsBarItemType } from './config';
-export { default as useSafePublish } from './hooks/useSafePublish';
+export { ChartType, FrequencyUnit, MarkerEventType, ModuleType, OptionKey, PSType, SegmentsEvent, SeriesType, ToolsBarItemType, ToolType } from './config';
+export { type EnhancedPublish, useSafePublish, withChartPublisher } from './hooks';
 export { Dial, Gauge, Heatmap, IQ, LevelStream, Occupancy, Spectrum } from './lib';
 export type { AxisXProps, AxisYRange, ChartRef, FrequencyAllocationItem, MarkerProps, MarkerType, Publish, PublishData, PublishDial, PublishGauge, PublishHeatmap, PublishIQ, PublishLevelStream, PublishOccupancy, PublishSpectrum, RecursiveFunction, // 递归方法 后期会删除
 RecursiveObject, // 递归对象 后期会删除
 Render, Reset, SegmentsOriginal, SeriesConfig, SetAntennaFactor, SetChannels, SetMarker, SetSegments, SetSeries, SetSpectrumBandwidth, SpectrumBandwidth, SpectrumExtraData, StationInfoType } from './types';
 export { HeatmapCaptureType, MarkerMode } from './types';
 export { SignalDataType } from './types/store';
+export { formatFrequencyUnit, formatFrequencyUnitFromHz, formatFrequencyUnitFromMHz } from './utils';
+export type { FrequencyUnitResult } from './utils';