@rfkit/charts 1.10.0 → 1.10.2

package/modules/Spectrum/FrequencyDataBoard/hooks/index.d.ts

@@ -1 +1 @@
-export { useStationFinder, useStationInfoAtCursor } from './useStationInfoAtCursor';
+export { useSignalFinder, useSignalInfoAtCursor, useStationFinder, useStationInfoAtCursor } from './useStationInfoAtCursor';

package/modules/Spectrum/FrequencyDataBoard/hooks/useStationInfoAtCursor.d.ts

@@ -1 +1 @@
-export { useStationFinder, useStationInfoAtCursor } from '../../Signal/model';
+export { useSignalFinder, useSignalInfoAtCursor, useStationFinder, useStationInfoAtCursor } from '../../Signal/model';

package/modules/Spectrum/FrequencyDataBoard/index.d.ts

@@ -7,7 +7,7 @@ interface Props {
         frequency: string;
     }) => void;
     updateKey?: number;
-    showStationInfo?: boolean;
+    showSignalInfo?: boolean;
     cursorSample?: CursorSampleSnapshot | null;
 }
 declare const _default: React.NamedExoticComponent<Props>;

package/modules/Spectrum/FrequencyDataBoard/panels/StationInfoPanel/index.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import type { StationInfoType } from '../../../../../types';
+import { type UnifiedSignalItem } from '../../../Signal/model';
 interface Props {
-    stationInfo?: StationInfoType;
+    signalInfo?: UnifiedSignalItem;
 }
 declare const _default: React.NamedExoticComponent<Props>;
 export default _default;

package/modules/Spectrum/FrequencyDataBoard/panels/index.d.ts

@@ -1 +1 @@
-export { default as StationInfoPanel } from './StationInfoPanel';
+export { default as SignalInfoPanel } from './StationInfoPanel';

package/modules/Spectrum/Signal/Switch/index.d.ts

@@ -1,7 +1,8 @@
 import type React from 'react';
 /**
  * Signal 开关组件
- * 控制 signal 的显示状态
+ * 控制 signal 的显示状态，并组合为“总开关 + 树形筛选”：
+ * 台站库/信号库 → 信号类型 → 信号等级。
  */
 declare const Switch: React.FC;
 export default Switch;

package/modules/Spectrum/Signal/index.d.ts

@@ -1,6 +1,6 @@
 import type React from 'react';
 import SignalSwitch from './Switch';
-export { useStationFinder } from './model';
+export { useSignalFinder, useStationFinder } from './model';
 export { useSignalDataManager } from './useSignalDataManager';
 export { SignalSwitch };
 interface Props {

package/modules/Spectrum/Signal/metadata/index.d.ts

@@ -1 +1,2 @@
-export { SIGNAL_TYPE_MAP, SignalType, signalTypeMap } from './signalType';
+export { normalizeSignalLevel, resolveSignalColor, SIGNAL_LEVEL_FIRST, SIGNAL_LEVEL_MAP, SIGNAL_LEVEL_ORDER, SIGNAL_LEVEL_SECOND, SIGNAL_LEVEL_THIRD, SIGNAL_LEVEL_UNASSIGNED, type SignalLevelMeta } from './level.ts';
+export { normalizeSignalType, SIGNAL_TYPE_MAP, SIGNAL_TYPE_ORDER, SignalType, type SignalTypeKey, type SignalTypeMeta, signalTypeMap } from './signalType.ts';

package/modules/Spectrum/Signal/metadata/level.d.ts

@@ -0,0 +1,25 @@
+export declare const SIGNAL_LEVEL_UNASSIGNED = -1;
+export declare const SIGNAL_LEVEL_FIRST = 0;
+export declare const SIGNAL_LEVEL_SECOND = 1;
+export declare const SIGNAL_LEVEL_THIRD = 2;
+export interface SignalLevelMeta {
+    name: string;
+    color: string;
+}
+export declare const SIGNAL_LEVEL_ORDER: readonly [-1, 0, 1, 2];
+export declare const SIGNAL_LEVEL_MAP: Record<number, SignalLevelMeta>;
+/**
+ * 等级规范化：-1/0/1/2 分别对应未分配/一级/二级/三级；
+ * 缺失、非整数或不在集合内的值统一归为 -1（未分配）
+ */
+export declare const normalizeSignalLevel: (value: unknown) => number;
+/**
+ * 颜色解析：外部显式 color 优先；信号库合法类型使用等级色，
+ * 台站库与信号库其他类型均使用类型色。
+ */
+export declare const resolveSignalColor: (item: {
+    source: "station" | "simple";
+    color?: string;
+    level?: number;
+    signalType?: string;
+}) => string;

package/modules/Spectrum/Signal/metadata/signalType.d.ts

@@ -1,16 +1,21 @@
-export declare enum SignalType {
-    LEGITIMATE = "Legitimate",
-    KNOWN = "Know",
-    UNKNOWN = "UnKnown",
-    ILLEGAL = "Illegal"
-}
-export declare const SIGNAL_TYPE_MAP: Record<string, {
+export declare const SignalType: {
+    readonly LEGITIMATE: "Legitimate";
+    readonly UNKNOWN: "UnKnown";
+    readonly KNOWN: "Know";
+    readonly VIOLATION: "Violation";
+    readonly ILLEGAL: "Illegal";
+};
+export type SignalType = (typeof SignalType)[keyof typeof SignalType];
+export interface SignalTypeMeta {
     name: string;
     color: string;
     isLegitimate: boolean;
-}>;
-export declare const signalTypeMap: Record<string, {
-    name: string;
-    color: string;
-    isLegitimate: boolean;
-}>;
+}
+export declare const SIGNAL_TYPE_MAP: Record<string, SignalTypeMeta>;
+export type SignalTypeKey = keyof typeof SIGNAL_TYPE_MAP;
+export declare const SIGNAL_TYPE_ORDER: SignalTypeKey[];
+/**
+ * 类型规范化：缺失或无法识别的类型统一归入 UnKnown
+ */
+export declare const normalizeSignalType: (value: unknown) => SignalTypeKey;
+export declare const signalTypeMap: Record<string, SignalTypeMeta>;

package/modules/Spectrum/Signal/model/index.d.ts

@@ -1,3 +1,4 @@
-export { createStationRangeIndex, findStationAtCursor, findStationInRangeIndex, resolveActiveSignalKey, resolveSignalMatchCandidates, resolveSignalPositions, resolveSignalSegments, resolveStaticSignalSegments, type SignalPosition, type SignalSegmentData } from './resolver';
-export { useStationFinder, useStationInfoAtCursor } from './useStationInfoAtCursor';
+export { createSignalRangeIndex, createStationRangeIndex, findSignalAtCursor, findSignalInRangeIndex, findStationAtCursor, findStationInRangeIndex, resolveActiveSignalKey, resolveSignalMatchCandidates, resolveSignalPositions, resolveSignalPresentation, resolveSignalSegments, resolveStaticSignalSegments, type SignalPosition, type SignalSegmentData } from './resolver';
+export { buildSignalTree, filterSignalItemsByHiddenKeys, getSignalLeafKey, getUnifiedSignalKey, isStationInfo, resolveNodeCheckState, resolveSignalSource, SIGNAL_SOURCE_LABEL, SIGNAL_SOURCE_ORDER, type SignalNodeCheckState, type SignalSource, type SignalTree, type SignalTreeLevelNode, type SignalTreeSourceNode, type SignalTreeTypeNode, toggleNodeHiddenKeys, type UnifiedSignalItem } from './tree';
+export { useSignalFinder, useSignalInfoAtCursor, useStationFinder, useStationInfoAtCursor } from './useStationInfoAtCursor';
 export { useUnifiedSignals } from './useUnifiedSignals';

package/modules/Spectrum/Signal/model/match.d.ts

@@ -0,0 +1,15 @@
+import { type FrequencyRange, type FrequencyRangeInput } from '../../../../utils/frequencyCalculation.ts';
+import { type UnifiedSignalItem } from './tree.ts';
+export interface SignalMatchCandidate {
+    item: UnifiedSignalItem;
+    range: FrequencyRange;
+    startIndex: number;
+    stopIndex: number;
+}
+/** 将统一信号转换为频率范围输入（兼容 string | number）。 */
+export declare function toFrequencyRangeInput(item: UnifiedSignalItem): FrequencyRangeInput;
+export declare function resolveBestSignalMatch<T extends SignalMatchCandidate>(candidates: T[], options: {
+    currentFrequency: number;
+    currentPointIndex: number;
+    indexTolerance?: number;
+}): T | undefined;

package/modules/Spectrum/Signal/model/resolver.d.ts

@@ -1,6 +1,7 @@
 import type { CSSProperties } from 'react';
 import type { SegmentType, StationInfoType } from '../../../../types';
-import { type SignalMatchCandidate, type UnifiedSignalItem } from '../utils';
+import { type SignalMatchCandidate } from './match.ts';
+import { type UnifiedSignalItem } from './tree.ts';
 export interface SignalPosition extends SignalMatchCandidate {
     key: string;
     position: {
@@ -17,6 +18,7 @@ export interface SignalSegmentData {
     activeSignalKey?: string;
     style: CSSProperties;
 }
+export declare const resolveSignalPresentation: (item: UnifiedSignalItem) => Pick<SignalPosition, "color" | "tooltip">;
 export declare const resolveSignalMatchCandidates: (signalItems: UnifiedSignalItem[], segment: SegmentType) => SignalMatchCandidate[];
 export declare const resolveSignalPositions: (signalItems: UnifiedSignalItem[], segment: SegmentType) => SignalPosition[];
 export declare const resolveSignalSegments: ({ segments, signalItems, isCursorActive, currentFrequency, currentPosition }: {
@@ -51,6 +53,19 @@ export declare const findStationAtCursor: ({ frequency, signalItems, segments, c
         pointIndex: number;
     };
 }) => StationInfoType | undefined;
+export declare const findSignalAtCursor: ({ frequency, signalItems, segments, currentPosition }: {
+    frequency: number;
+    signalItems: UnifiedSignalItem[];
+    segments: SegmentType[];
+    currentPosition: {
+        segmentIndex: number;
+        pointIndex: number;
+    };
+}) => UnifiedSignalItem | undefined;
+export declare const createSignalRangeIndex: ({ signalItems, segments }: {
+    signalItems: UnifiedSignalItem[];
+    segments: SegmentType[];
+}) => SignalMatchCandidate[][];
 export declare const createStationRangeIndex: ({ signalItems, segments }: {
     signalItems: UnifiedSignalItem[];
     segments: SegmentType[];
@@ -63,3 +78,11 @@ export declare const findStationInRangeIndex: ({ frequency, stationRangeIndex, c
         pointIndex: number;
     };
 }) => StationInfoType | undefined;
+export declare const findSignalInRangeIndex: ({ frequency, signalRangeIndex, currentPosition }: {
+    frequency: number;
+    signalRangeIndex: SignalMatchCandidate[][];
+    currentPosition: {
+        segmentIndex: number;
+        pointIndex: number;
+    };
+}) => UnifiedSignalItem | undefined;

package/modules/Spectrum/Signal/model/tree.d.ts

@@ -0,0 +1,70 @@
+import type { StationInfoType } from '../../../../types';
+import type { SignalData } from '../../../../types/store';
+/**
+ * 统一的信号数据类型（兼容 StationInfo 和 SignalData）
+ * 与 utils.ts 保持同一类型，此处作为树形筛选的独立纯函数模块载体
+ */
+export type UnifiedSignalItem = StationInfoType | SignalData;
+export type SignalSource = 'station' | 'simple';
+export declare const SIGNAL_SOURCE_ORDER: SignalSource[];
+export declare const SIGNAL_SOURCE_LABEL: Record<SignalSource, string>;
+/**
+ * 判断是否为完整的台站信息
+ */
+export declare function isStationInfo(item: UnifiedSignalItem): item is StationInfoType;
+export declare const resolveSignalSource: (item: UnifiedSignalItem) => SignalSource;
+/**
+ * 叶子键：source:signalType:level（类型与等级均为规范化后的值）
+ */
+export declare const getSignalLeafKey: (item: UnifiedSignalItem) => string;
+/**
+ * 统一渲染键始终带来源前缀：优先使用业务 id；无 id 时回退名称/频率范围，
+ * 避免缺省数据在台站库和信号库之间产生 React 重复键。
+ */
+export declare function getUnifiedSignalKey(item: UnifiedSignalItem): string;
+export interface SignalTreeLevelNode {
+    level: number;
+    label: string;
+    leafKey: string;
+    hasData: boolean;
+}
+export interface SignalTreeTypeNode {
+    signalType: string;
+    label: string;
+    leafKeys: string[];
+    dataLeafKeys: string[];
+    hasData: boolean;
+    levels: SignalTreeLevelNode[];
+}
+export interface SignalTreeSourceNode {
+    source: SignalSource;
+    label: string;
+    leafKeys: string[];
+    dataLeafKeys: string[];
+    hasData: boolean;
+    types: SignalTreeTypeNode[];
+}
+export interface SignalTree {
+    sources: SignalTreeSourceNode[];
+}
+/**
+ * 从未过滤的统一信号数据构建数据驱动的树目录。
+ * 来源与类型按固定顺序排列，但没有实际数据的节点不进入目录；
+ * 台站库是独立来源，不继续展开类型和等级。
+ */
+export declare const buildSignalTree: (signalItems: UnifiedSignalItem[]) => SignalTree;
+export type SignalNodeCheckState = 'checked' | 'indeterminate' | 'unchecked' | 'disabled';
+/**
+ * 父节点依据当前有数据的后代计算：
+ * 全部可见 checked、部分可见 indeterminate、全部隐藏 unchecked、没有可用后代 disabled。
+ */
+export declare const resolveNodeCheckState: (leafKeysWithData: ReadonlySet<string>, hiddenCategoryKeys: ReadonlySet<string>, fixedLeafKeys: string[]) => SignalNodeCheckState;
+/**
+ * 级联选择：取消父节点时记录其完整固定后代，使后续出现的数据仍遵循用户选择。
+ * 全部数据后代可见时取消父节点（隐藏完整固定后代）；否则恢复全部固定后代可见。
+ */
+export declare const toggleNodeHiddenKeys: (hiddenCategoryKeys: string[], fixedLeafKeys: string[], leafKeysWithData: ReadonlySet<string>) => string[];
+/**
+ * 隐藏集合过滤：默认全部显示，命中隐藏叶子键的条目被剔除。
+ */
+export declare const filterSignalItemsByHiddenKeys: (signalItems: UnifiedSignalItem[], hiddenCategoryKeys: string[]) => UnifiedSignalItem[];

package/modules/Spectrum/Signal/model/useStationInfoAtCursor.d.ts

@@ -1,9 +1,12 @@
 import type { CursorSampleSnapshot } from '../../../../runtime/interaction';
-interface UseStationFinderProps {
+import { type UnifiedSignalItem } from './tree';
+interface UseSignalFinderProps {
     frequency: string;
     enabled?: boolean;
     cursorSample?: CursorSampleSnapshot | null;
 }
-export declare function useStationInfoAtCursor({ frequency, enabled, cursorSample }: UseStationFinderProps): import("../../../..").StationInfoType | undefined;
+export declare function useSignalInfoAtCursor(props: UseSignalFinderProps): UnifiedSignalItem | undefined;
+export declare function useStationInfoAtCursor(props: UseSignalFinderProps): import("../../../..").StationInfoType | undefined;
+export declare const useSignalFinder: typeof useSignalInfoAtCursor;
 export declare const useStationFinder: typeof useStationInfoAtCursor;
 export {};

package/modules/Spectrum/Signal/model/useUnifiedSignals.d.ts

@@ -1,6 +1,7 @@
-import type { UnifiedSignalItem } from '../utils';
+import type { UnifiedSignalItem } from './tree';
 interface UseUnifiedSignalsOptions {
     respectVisibility?: boolean;
+    filterHidden?: boolean;
 }
-export declare function useUnifiedSignals({ respectVisibility }?: UseUnifiedSignalsOptions): UnifiedSignalItem[];
+export declare function useUnifiedSignals({ respectVisibility, filterHidden }?: UseUnifiedSignalsOptions): UnifiedSignalItem[];
 export {};

package/modules/Spectrum/Signal/presenters/SignalSegments/index.d.ts

@@ -1,5 +1,5 @@
 import type React from 'react';
-import type { SignalPosition } from '../../model';
+import { type SignalPosition } from '../../model';
 interface SignalSegmentsProps {
     style: React.CSSProperties;
     signalPositions: SignalPosition[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rfkit/charts",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "type": "module",
   "description": "Chart components for wireless monitoring web applications",
   "exports": {

package/store/runtimeCleanup.d.ts

@@ -0,0 +1 @@
+export declare const scheduleRuntimeCleanup: (cleanup: () => void) => (() => void);

package/types/common.d.ts

@@ -67,6 +67,7 @@ export type SegmentsType = SegmentType[] & {
     totalPoints?: number;
 };
 export interface StationInfoType {
+    id?: string;
     signalName: string;
     orgName: string;
     frequency: number;
@@ -74,6 +75,8 @@ export interface StationInfoType {
     modulation: string;
     signalType: string;
     remark: string;
+    level?: number;
+    color?: string;
     startFrequency: number;
     stopFrequency: number;
 }

package/types/store/signal.d.ts

@@ -3,12 +3,14 @@ export declare enum SignalDataType {
     Simple = "simple"
 }
 export interface SignalData {
+    id?: string;
     startFrequency?: number | string;
     stopFrequency?: number | string;
     frequency?: number | string;
     bandwidth?: number | string;
     color?: string;
     signalType?: string;
+    level?: number;
 }
 export type SelectedSignal = {
     segIndex: number;
@@ -18,6 +20,7 @@ export interface SignalProps {
     show: boolean;
     display: boolean;
     data: SignalData[];
+    hiddenCategoryKeys: string[];
     onChange: (e: SelectedSignal) => void;
 }
 export interface SignalAnalysisProps {

package/modules/Spectrum/Signal/utils.d.ts

@@ -1,27 +0,0 @@
-import type { StationInfoType } from '../../../types';
-import type { SignalData } from '../../../types/store';
-import type { FrequencyRange, FrequencyRangeInput } from '../../../utils';
-/**
- * 统一的信号数据类型（兼容 StationInfo 和 SignalData）
- */
-export type UnifiedSignalItem = StationInfoType | SignalData;
-export interface SignalMatchCandidate {
-    item: UnifiedSignalItem;
-    range: FrequencyRange;
-    startIndex: number;
-    stopIndex: number;
-}
-/**
- * 判断是否为完整的台站信息
- */
-export declare function isStationInfo(item: UnifiedSignalItem): item is StationInfoType;
-export declare function getUnifiedSignalKey(item: UnifiedSignalItem): string;
-/**
- * 将统一的信号数据转换为频率范围输入（处理 string | number 类型）
- */
-export declare function toFrequencyRangeInput(item: UnifiedSignalItem): FrequencyRangeInput;
-export declare function resolveBestSignalMatch<T extends SignalMatchCandidate>(candidates: T[], options: {
-    currentFrequency: number;
-    currentPointIndex: number;
-    indexTolerance?: number;
-}): T | undefined;