@rfkit/charts 1.10.12 → 1.11.0

package/README.md

@@ -11,8 +11,6 @@
 pnpm add @rfkit/charts
 ```
 
-正式版本由源码仓库内的 Release PR 自动发布到 npm；仓库里的本地 `publish:*` 脚本只作为维护调试或应急入口，不属于常规发布流程。
-
 ## 发布入口
 
 当前对外正式入口只有两个：
@@ -94,7 +92,7 @@ export function GaugeDemo() {
 - `SetSegments`
 - `SetMarker`
 
-`PublishDial` 支持推送 `series`、`range`、`yawAngle`、`isNorthFacing`，以及可选 `polygon: DialPolygon[]` 绘制雷达多边形：每个多边形提供 `values`（各方向归一化值 0-1，长度即方向数，按 0..360 度均匀分布）与可选 `color`（缺省走主题主色）。各方向值决定半径，连成闭合多边形，半透明填充 + 同色描边；`series` 已改为可选，纯雷达数据可以只传 `polygon`。
+`PublishDial` 支持推送 `series`、`range`、`yawAngle`、`isNorthFacing`，以及可选 `polygon: DialPolygon[]` 绘制雷达多边形：每个多边形提供 `values`（各方向归一化值 0-1，长度即方向数，按 0..360 度均匀分布）、可选 `color`（缺省走主题主色）与可选 `showDots`（是否绘制顶点小圆点，缺省 true）。各方向值决定半径，连成闭合多边形，径向渐变填充 + 细描边 + 顶点圆点；`series` 已改为可选，纯雷达数据可以只传 `polygon`。
 
 ```tsx
 import { Dial, PSType, type Publish } from '@rfkit/charts';
@@ -113,15 +111,14 @@ dialRef.current?.({
 
 ## 信号标注接入
 
-信号标注数据由业务项目负责适配，图表只接收内部结构。外部常见的 `fromRSDBT`、`signalLevel` 字段不要原样传入：`fromRSDBT=true` 转为 `StationInfoType`，`false` 转为 `SignalData`；`signalLevel` 映射为 `level`（`-1/0/1/2`），`signalType` 映射为 `Legitimate`、`UnKnown`、`Know`、`Violation` 或 `Illegal`。有业务颜色时将 `color` 原样传入（包括 `rgba(...)`）；没有显式颜色时，台站库和非合法信号使用内置类型色，信号库中的合法信号使用绿色等级色阶。
+信号标注数据由业务项目负责适配，图表只接收内部结构。有业务颜色时按约定传入，没有显式颜色时使用内置类型色。
 
 ```ts
 import { PSType, SignalDataType } from '@rfkit/charts';
 
-const { station, simple } = adaptBusinessAnnotations(items);
-
-publish({ pstype: PSType.Signal, type: SignalDataType.Station, data: station });
-publish({ pstype: PSType.Signal, type: SignalDataType.Simple, data: simple });
+// 业务侧先把外部信号数据适配成 charts 内部结构（StationInfoType[] / SignalData[]）
+publish({ pstype: PSType.Signal, type: SignalDataType.Station, data: stationData });
+publish({ pstype: PSType.Signal, type: SignalDataType.Simple, data: simpleData });
 ```
 
 同一来源后续发布会替换上一批数据，发布空数组可单独清空该来源。`SignalData.details` 可传入 `name`、`organization`、`modulation` 和 `remark`；频谱游标命中台站库或信号库时会展示两者共有的详情，合法信号库数据额外显示等级。
@@ -236,27 +233,7 @@ cleanup();
 - 不再兜底旧 `--theme-*` 变量
 - 不负责替宿主生成 `:root` 上的 canonical token
 
-## 非公开边界
-
-以下内容不属于对外源码 API：
-
-- 任意 `src/**` 源码路径
-- `test/**` preview / example 宿主
-- 仓库内部工程文档
-
-## 主题变更摘要
-
-当前主题系统已经完成二阶段收口，外部需要注意的 breaking change 主要有：
-
-- `initChartsTheme()` 不再接受 `themeConfigs` / `sizeConfigs` / `subscribeThemeChange`
-- 新配置入口改为 `tokens` / `sizes` / `onChange`
-- `applyChartsTheme()` 与 `applyChartsThemePreference()` 已移除
-- 默认运行时不再输出旧 `--theme-*` alias
-- `@rfkit/charts/tailwind-bridge.css` 不再暴露 deprecated bridge token
-
 ## 文档边界
 
-- 对外安装、接入方式、主题契约和常用用法以本文为准。
-- 精确公开 API 以 `@rfkit/charts` 包根导出的类型声明和编辑器智能提示为准。
-- npm 打包产物只同步根 `README.md`，不会把仓库内的 `docs/*` 一并作为公开文档入口发布。
-- 仓库内部专题文档只在源码仓库内维护，不属于发布包对外文档入口。
+- 精确公开 API 以 `@rfkit/charts` 包根导出的类型声明为准。
+- npm 打包产物只同步根 `README.md`。

package/charts/Spectrum/Chart.d.ts

@@ -4,6 +4,7 @@ import { type OccupancyPortalProps } from '../../modules/OccupancyPortal';
 import type { ParamsProps } from '../../types';
 export interface Props extends SpectrumChartTypeProps, ParamsProps, OccupancyPortalProps {
     children?: React.ReactNode;
+    touch?: boolean;
     processing?: Partial<ProcessingOptions>;
 }
 declare const Chart: React.FC<Props>;

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

@@ -1,8 +1,2 @@
-/**
- * 选择list中下一个item
- * @param {T} v - 当前值，可以是字符串或数字
- * @param {T[]} list - 值列表
- * @returns {T} 下一个值
- */
 export declare const nextItem: <T extends string | number>(v: T, list: T[]) => T;
 export declare function findNeighbors(currentValue: number, arr: number[], deltaY: number): number | null | undefined;

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

@@ -1,10 +1,10 @@
 import { useVirtualRange } from './tools';
 import type { RenderChartType } from '../../../../types';
-import Ranging, { RangeController, useRangeAutoFocus, useRangeMove, useRangeSet } from './ranging';
+import Ranging, { RangeController, useRangeAutoFocus, useRangeMove, useRangeSet, useRangeZoom } from './ranging';
 import { getVirtualLevel, range2realRange } from './tools';
 interface Props {
     chart: RenderChartType | null;
 }
 declare const useRange: ({ chart }: Props) => Ranging;
 export default useRange;
-export { getVirtualLevel, RangeController, range2realRange, useRangeAutoFocus, useRangeMove, useRangeSet, useVirtualRange };
+export { getVirtualLevel, RangeController, range2realRange, useRangeAutoFocus, useRangeMove, useRangeSet, useRangeZoom, useVirtualRange };

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

@@ -1,51 +1,23 @@
 import type { AxisYRange, RecursiveFunction, RecursiveObject } from '../../../../types';
-/**
- * 图表轴范围管理
- *
- * @class Range
- */
 declare class RangeController {
     state: RecursiveObject;
     constructor(props: RecursiveObject);
-    /**
-     * 更新状态
-     */
     update(p: RecursiveObject): void;
     setAxisY(e: {
         step?: number;
         realRange: AxisYRange;
     }): void;
-    /**
-     * 聚焦
-     */
     focus({ isHand, step: propsStep }?: RecursiveObject): void;
-    /**
-     * 移动
-     */
     move(m: number): void;
-    /**
-     * 边界移动
-     */
     moveBoundary(isUP: boolean, isTop: boolean): void;
     moveWheel(e: React.WheelEvent): void;
-    /**
-     * 根据步进移动
-     */
+    zoom(factor: number, anchorValue: number): void;
     moveStep(isUp: boolean): void;
-    /**
-     * 通知外部
-     */
     onChange(): void;
 }
-/**
- * 使用操作面板自动聚焦
- *
- * @param {*} id
- * @param {*} func
- * @returns
- */
 export declare const useRangeAutoFocus: (id: string, func?: RecursiveFunction<[]>) => (...args: any[]) => void;
 export declare const useRangeMove: (globalID: string, func?: RecursiveFunction<[number]>) => (...args: any[]) => void;
+export declare const useRangeZoom: (globalID: string, func?: RecursiveFunction<[number, number]>) => (...args: any[]) => void;
 export declare const useRangeSet: (globalID: string, func?: RecursiveFunction<[AxisYRange]>) => (...args: any[]) => void;
 export { RangeController };
 export default RangeController;

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

@@ -1,15 +1,9 @@
-/**
- * 虚拟范围数据结构
- */
 interface VirtualRangeData {
     flaw: number;
     offset: number;
     range: [number, number];
     renderRange: [number, number];
 }
-/**
- * 全局共享的虚拟范围值
- */
 export declare const VIRTUAL_RANGE: (globalID: string, virtual?: VirtualRangeData) => VirtualRangeData;
 interface VirtualRangeParams {
     unit?: string;
@@ -17,24 +11,15 @@ interface VirtualRangeParams {
     step?: number;
     globalID: string;
 }
-/**
- * 虚拟范围管理器
- */
 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 }: Range2RealRangeParams): {
     realRange: [number, number];
     renderRange: [number, number];
 };
-/**
- * 获取虚拟电频值
- */
 export declare function getVirtualLevel(unit: string, v: number): number;
 export {};

package/components/Cursor/tools.d.ts

@@ -2,9 +2,6 @@ import type { RecursiveFunction } from '../../types';
 type CursorTimer = ReturnType<typeof setTimeout> | null;
 export declare const CURSOR_TIMEOUT: (globalID: string, timer?: CursorTimer) => CursorTimer;
 export declare const CURSOR_SETACTIVE: (globalID: string, func?: RecursiveFunction) => (...args: any[]) => void;
-/**
- * 将位置信息转换为视觉left
- */
 export declare function convertCoordToVisualLeft({ coord, zoom, segments }: {
     coord: {
         left: number;
@@ -19,9 +16,6 @@ export declare function convertCoordToVisualLeft({ coord, zoom, segments }: {
         totalPoints: number;
     };
 }): number;
-/**
- * 将视觉left转换为真实left
- */
 export declare function convertVisualLeftToRealLeft({ visualLeft, zoom, segments }: {
     visualLeft: number;
     zoom: {

package/components/DragSelectBox/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * 通用拖拽框选组件
- * 用于创建可拖拽、可调整大小的矩形框
- */
 import type React from 'react';
 import { type ReactNode } from 'react';
 import { type DragType, type RectBounds, type RectPosition } from '../../hooks/useDragSelect';

package/components/EventBus/tools.d.ts

@@ -9,17 +9,8 @@ export declare const createMouseUpEventManager: (id: string, name?: string, func
 export declare const createMouseLeaveEventManager: (id: string, name?: string, func?: CSMCallback) => (...args: any[]) => void;
 export declare const createMouseEnterEventManager: (id: string, name?: string, func?: CSMCallback) => (...args: any[]) => void;
 export declare const createWheelEventManager: (id: string, name?: string, func?: CSMCallback) => (...args: any[]) => void;
-/**
- * 创建拖拽事件管理器
- */
 export declare const createDragEventManager: (id: string, name?: string, func?: CSMCallback) => (...args: any[]) => void;
-/**
- * 创建缩放事件管理器
- */
 export declare const createZoomEventManager: (id: string, name?: string, func?: CSMCallback) => (...args: any[]) => void;
-/**
- * 创建长按事件管理器
- */
 export declare const createLongPressEventManager: (id: string, name?: string, func?: CSMCallback) => (...args: any[]) => void;
 export declare const calculateEventRelativePosition: (e: React.MouseEvent<HTMLElement> | React.WheelEvent<HTMLElement> | EventPositionSource) => TopRightBottomLeft;
 export declare const EVENT_PRIORITY_LEVELS: {
@@ -34,9 +25,6 @@ export declare const EVENT_PRIORITY_LEVELS: {
     stripe: number;
     frequencyTagLine: number;
 };
-/**
- * 事件样式映射
- */
 export declare const CURSOR_STYLE_MAP: {
     markers: string;
     stripe: string;
@@ -48,23 +36,6 @@ export declare const CURSOR_STYLE_MAP: {
 };
 export declare const getEventLevel: (id: string, level?: string) => string;
 export declare const getEventType: (id: string, type?: string) => string;
-/**
- * 比较事件优先级
- * @param id 事件ID
- * @param targetLevel 目标级别
- * @param type 事件类型
- * @returns 如果目标级别优先级大于等于当前级别，返回true
- */
 export declare function compareEventPriority(id: string, targetLevel: string, type?: string): boolean;
-/**
- * 获取事件对应的鼠标光标样式
- * @param id 事件ID
- * @returns 光标样式字符串
- */
 export declare function getEventCursor(id: string): string;
-/**
- * 重置事件级别
- * @param id 事件ID
- * @param level 要重置的级别
- */
 export declare function resetEventLevel(id: string, level: string): void;

package/components/Toolbar/primitives/styles.d.ts

@@ -1,7 +1,7 @@
 export declare const TOOLBAR_SHELL_CLASS_NAME = "relative flex h-10 w-full items-center justify-between pl-[var(--size-gap-base)] text-xs text-foreground";
 export declare const TOOLBAR_SHELL_STYLE: {
-    readonly background: "linear-gradient(to bottom, color-mix(in srgb, var(--background) 100%, transparent), color-mix(in srgb, var(--background) 86%, transparent))";
-    readonly boxShadow: "0 1px 4px color-mix(in srgb, var(--border) 72%, transparent)";
+    readonly background: 'linear-gradient(to bottom, color-mix(in srgb, var(--background) 100%, transparent), color-mix(in srgb, var(--background) 86%, transparent))';
+    readonly boxShadow: '0 1px 4px color-mix(in srgb, var(--border) 72%, transparent)';
 };
 export declare const TOOLBAR_ITEMS_CLASS_NAME = "flex h-full items-center gap-[var(--size-gap-base)]";
 export declare const TOOLBAR_SEPARATOR_BASE_CLASS_NAME = "self-center";
@@ -11,16 +11,16 @@ export declare const TOOLBAR_SURFACE_CLASS_NAME = "pointer-events-auto box-borde
 export declare const TOOLBAR_INTERACTIVE_SURFACE_CLASS_NAME = "cursor-pointer appearance-none border-0 hover:bg-accent/72 hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-primary/70 focus-visible:ring-offset-1 focus-visible:ring-offset-background";
 export declare const TOOLBAR_DISABLED_SURFACE_CLASS_NAME = "cursor-not-allowed opacity-45 hover:bg-secondary";
 export declare const TOOLBAR_TONE_CLASS_NAME_MAP: {
-    readonly default: "text-foreground";
-    readonly primary: "text-primary";
-    readonly warning: "text-warning";
-    readonly destructive: "text-destructive";
+    readonly default: 'text-foreground';
+    readonly primary: 'text-primary';
+    readonly warning: 'text-warning';
+    readonly destructive: 'text-destructive';
 };
 export declare const TOOLBAR_ACTIVE_SURFACE_CLASS_NAME_MAP: {
-    readonly default: "data-[active=true]:bg-accent/72 data-[active=true]:text-foreground data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--border)_72%,transparent)] data-[active=true]:hover:bg-accent/72";
-    readonly primary: "data-[active=true]:bg-accent/72 data-[active=true]:text-primary data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--border)_72%,transparent)] data-[active=true]:hover:bg-accent/72";
-    readonly warning: "data-[active=true]:bg-warning/10 data-[active=true]:text-warning data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--warning)_24%,transparent)] data-[active=true]:hover:bg-warning/12";
-    readonly destructive: "data-[active=true]:bg-destructive/10 data-[active=true]:text-destructive data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--destructive)_24%,transparent)] data-[active=true]:hover:bg-destructive/12";
+    readonly default: 'data-[active=true]:bg-accent/72 data-[active=true]:text-foreground data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--border)_72%,transparent)] data-[active=true]:hover:bg-accent/72';
+    readonly primary: 'data-[active=true]:bg-accent/72 data-[active=true]:text-primary data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--border)_72%,transparent)] data-[active=true]:hover:bg-accent/72';
+    readonly warning: 'data-[active=true]:bg-warning/10 data-[active=true]:text-warning data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--warning)_24%,transparent)] data-[active=true]:hover:bg-warning/12';
+    readonly destructive: 'data-[active=true]:bg-destructive/10 data-[active=true]:text-destructive data-[active=true]:shadow-[inset_0_0_0_1px_color-mix(in_srgb,var(--destructive)_24%,transparent)] data-[active=true]:hover:bg-destructive/12';
 };
 export type ToolbarTone = keyof typeof TOOLBAR_TONE_CLASS_NAME_MAP;
 export declare const TOOLBAR_ICON_TRIGGER_CLASS_NAME = "inline-flex h-[26px] min-w-[26px] shrink-0 items-center justify-center";

package/components/Zoom/tools.d.ts

@@ -0,0 +1,5 @@
+import type { AxisXRange } from '../../types';
+export declare const buildZoomFullRange: <T extends {
+    interval: AxisXRange;
+    isScanSegmentsUpdateMagnify: boolean;
+}>(zoom: T, totalPoints: number) => T;

package/components/ui/button.d.ts

@@ -1,15 +1,15 @@
 import { type VariantProps } from 'class-variance-authority';
 import type { ButtonHTMLAttributes } from 'react';
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "destructive" | "secondary" | "default" | "outline" | "ghost" | null | undefined;
-    size?: "default" | "icon" | "sm" | "lg" | null | undefined;
+    variant?: "default" | "destructive" | "ghost" | "link" | "outline" | "secondary" | null | undefined;
+    size?: "default" | "icon" | "lg" | "sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type ButtonProps = ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;
 };
 export declare const Button: import("react").ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: ({
-    variant?: "link" | "destructive" | "secondary" | "default" | "outline" | "ghost" | null | undefined;
-    size?: "default" | "icon" | "sm" | "lg" | null | undefined;
+    variant?: "default" | "destructive" | "ghost" | "link" | "outline" | "secondary" | null | undefined;
+    size?: "default" | "icon" | "lg" | "sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string> & {
     asChild?: boolean;
 } & import("react").RefAttributes<HTMLButtonElement>>;

package/components/ui/panel.d.ts

@@ -1,8 +1,8 @@
 import { type VariantProps } from 'class-variance-authority';
 import { type HTMLAttributes } from 'react';
 export declare const panelVariants: (props?: ({
-    variant?: "default" | "ghost" | "subtle" | "floating" | null | undefined;
-    size?: "sm" | "lg" | "xs" | "md" | null | undefined;
+    variant?: "default" | "floating" | "ghost" | "subtle" | null | undefined;
+    size?: "lg" | "md" | "sm" | "xs" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface PanelProps extends HTMLAttributes<HTMLDivElement>, VariantProps<typeof panelVariants> {
 }

package/config/constants.d.ts

@@ -9,9 +9,7 @@ export declare const SERIES: {
 };
 export declare const SERIES_NAMES: string[];
 export declare const REAL_DATA_NAME: string;
-/** @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",

package/config/setting.d.ts

@@ -1,10 +1,5 @@
-/**
- * UI 配置常量
- */
 export declare const UI_CONFIG: {
-    /** 缩放最小范围 */
     readonly ZOOM_MIN_RANGE: 10;
-    /** Popover 边距 */
     readonly POPOVER_MARGIN: 16;
 };
 export declare const SPECTRUM_THRESHOLD_COLOR = "#A855F7";
@@ -44,30 +39,9 @@ interface Config {
     marker: string[];
 }
 declare const defaultConfig: Config;
-/**
- * 更新配置到localStorage
- *
- * @param {Partial<Config>} [c={}]
- */
 declare const setConfig: (c?: Partial<Config>) => void;
-/**
- * 获取配置
- *
- * @param {keyof Config} [name]
- */
 declare function getConfig(): Config;
 declare function getConfig<K extends keyof Config>(name: K): Config[K];
-/**
- * 获取series的配置
- *
- * @returns {Config['line']}
- */
-declare const getSeriesConfig: () => Config["line"];
-/**
- * 获取当前色带
- *
- * @param {number} [i=0]
- * @returns {string[]}
- */
+declare const getSeriesConfig: () => Config['line'];
 declare const getGradient: (i?: number) => string[];
 export { defaultConfig, getConfig, getGradient, getSeriesConfig, setConfig };

package/hooks/data/index.d.ts

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

package/hooks/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * Hooks 统一导出
- */
 export { useChannel, usePoints, useSegments } from './data';
 export { type EnhancedPublish, PUB_SUB, usePublish, useSafePublish } from './publish';
 export { SET_SEGMENTS_DISPLAY, type UseSpectrumChartTypeProps, useSpectrumChartType, useSpectrumRule } from './spectrum';

package/hooks/publish/index.d.ts

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

package/hooks/spectrum/index.d.ts

@@ -1,7 +1,5 @@
-/**
- * 频谱相关 hooks
- */
 export type { Props as UseSpectrumChartTypeProps } from './useSpectrumChartType';
 export { default as useSpectrumChartType } from './useSpectrumChartType';
 export { default as useSpectrumRule, SET_SEGMENTS_DISPLAY } from './useSpectrumRule';
+export { default as useTouchMode } from './useTouchMode';
 export { shouldEnableSpectrumWaterfall } from './waterfall';

package/hooks/spectrum/useTouchMode.d.ts

@@ -0,0 +1 @@
+export default function useTouchMode(touch?: boolean): void;

package/hooks/useChart/index.d.ts

@@ -1,9 +1,5 @@
 import type React from 'react';
 import type { RecursiveObject, RenderChartType } from '../../types';
-/**
- * Render 类构造函数类型
- * 所有 render 类必须接受 id 和 globalID 参数，并实现 RenderChartType 接口
- */
 type RenderConstructor<T extends RenderChartType = RenderChartType> = new (props: {
     id: string;
     globalID: string;

package/hooks/useChartComponent.d.ts

@@ -1,11 +1,5 @@
 import React, { type ComponentType } from 'react';
 import type { Publish } from '../types';
-/**
- * 创建图表组件的高阶函数，提供安全的publish功能
- * @param ChartComponent 要包装的图表组件
- * @param componentName 组件名称，用于调试
- * @returns 包装后的forwardRef组件
- */
 export declare function withChartPublisher<TProps extends {
     publish?: Publish;
 }>(ChartComponent: ComponentType<TProps>, componentName: string): React.ForwardRefExoticComponent<React.PropsWithoutRef<Omit<TProps, "publish">> & React.RefAttributes<Publish>>;

package/hooks/useDragSelect.d.ts

@@ -1,7 +1,3 @@
-/**
- * 通用拖拽框选 Hook
- * 提炼自 HeatmapCapture/Slider 的框选能力
- */
 export type DragType = 'top' | 'bottom' | 'left' | 'right' | 'middle' | null;
 export interface RectPosition {
     position: number;
@@ -28,9 +24,6 @@ export interface UseDragSelectConfig {
     preserveDefaultRect?: boolean;
     bounds?: RectBounds;
 }
-/**
- * 通用拖拽框选 Hook
- */
 export declare const useDragSelect: (config?: UseDragSelectConfig) => {
     rect: RectPosition;
     isDragging: boolean;

package/hooks/useModuleSubscription.d.ts

@@ -2,63 +2,13 @@ import type { ModuleType } from '../config';
 import type { PublishData } from '../types';
 import { type ChartSubscriptionInterface, type DataExtractor, type ModuleEventHandler, type ModulePublishType } from './module-subscription-core';
 interface UseModuleSubscriptionOptions<TData = unknown> {
-    /**
-     * 模块类型
-     */
     moduleType: ModuleType;
-    /**
-     * 图表实例
-     */
     chart: ChartSubscriptionInterface<TData> | null | undefined;
-    /**
-     * 从 PublishData 中提取数据（默认直接传递整个 d）
-     */
     extractData?: DataExtractor<TData, PublishData>;
-    /**
-     * 显式声明哪些 pstype 视作当前模块的渲染主路径
-     */
     renderPSTypes?: ModulePublishType[];
-    /**
-     * 当事件没有 pstype 时，是否也视为 render 事件
-     */
     treatMissingPSTypeAsRender?: boolean;
-    /**
-     * 自定义 render 处理逻辑；未提供时走 updateSeries + extractData 默认链路
-     */
     handleRender?: ModuleEventHandler<TData, PublishData>;
-    /**
-     * 事件级处理器，优先级高于默认 Render/Reset/Resize 行为
-     */
     eventHandlers?: Partial<Record<ModulePublishType, ModuleEventHandler<TData, PublishData>>>;
 }
-/**
- * 模块订阅 Hook
- *
- * 提供统一的数据订阅模式，处理 Render/Reset/Resize 事件
- *
- * @example
- * // 基础用法
- * useModuleSubscription({
- *   moduleType: ModuleType.Dial,
- *   chart
- * });
- *
- * @example
- * // 提取特定数据字段
- * useModuleSubscription({
- *   moduleType: ModuleType.Occupancy,
- *   chart,
- *   extractData: (d) => d.data
- * });
- *
- * @example
- * // 自定义 render 类型或事件处理
- * useModuleSubscription({
- *   moduleType: ModuleType.Gauge,
- *   chart,
- *   renderPSTypes: [PSType.Gauge],
- *   treatMissingPSTypeAsRender: true
- * });
- */
 export declare function useModuleSubscription<TData = unknown>({ moduleType, chart, extractData, renderPSTypes, treatMissingPSTypeAsRender, handleRender, eventHandlers }: UseModuleSubscriptionOptions<TData>): void;
 export default useModuleSubscription;

package/hooks/useSeriesManager/index.d.ts

@@ -1,6 +1,2 @@
-/**
- * useSeriesManager 统一导出
- * 提供所有 series 相关的 hooks
- */
 export { useFilteredSeries } from './useFilteredSeries';
 export { useSeriesForComponent, useSeriesManager } from './useSeriesManager';

package/hooks/useSeriesManager/useFilteredSeries.d.ts

@@ -1,19 +1,11 @@
-/**
- * 过滤的 Series Hook
- * 提供过滤后的 series 数据
- */
 import type { SeriesConfig } from '../../utils/series';
-/**
- * 过滤的 Series Hook
- * 提供过滤后的 series 数据，并保持稳定的顺序
- */
 export declare function useFilteredSeries(globalID: string | undefined, filter?: (config: SeriesConfig) => boolean): {
-    originalIndex: number;
     name: string;
     label: string;
     color: string;
     thickness: number;
     display: boolean;
     type: import("@rfkit/renderer").GraphicType;
+    originalIndex: number;
 }[];
 export default useFilteredSeries;

package/hooks/useSeriesManager/useSeriesManager.d.ts

@@ -1,34 +1,16 @@
-/**
- * 统一的 Series 管理 Hook
- * 整合所有 series 相关功能，避免多个分散的 hooks
- */
 import type { SeriesConfig } from '../../utils/series';
 import { type SeriesMode } from '../../utils/series';
 export interface UseSeriesManagerOptions {
-    /** 是否订阅模式变化 */
     subscribeToMode?: boolean;
-    /** 是否订阅series数据变化 */
     subscribeToData?: boolean;
-    /** 特定要监听的series名称，如果不指定则监听所有 */
     watchSeries?: string[];
 }
 export interface UseSeriesManagerResult {
-    /** 当前所有series数据 */
     series: Map<string, SeriesConfig>;
-    /** 当前series模式 */
     mode: SeriesMode;
-    /** 更新series配置 */
     updateSeries: (config: SeriesConfig) => void;
-    /** 强制刷新数据 */
     forceUpdate: () => void;
-    /** 获取特定series配置 */
     getSeries: (name: string) => SeriesConfig | undefined;
 }
-/**
- * 统一的 Series 管理 Hook
- */
 export declare function useSeriesManager(globalID: string | undefined, options?: UseSeriesManagerOptions): UseSeriesManagerResult;
-/**
- * 专门用于组件的版本 - 自动订阅所有变化
- */
 export declare function useSeriesForComponent(globalID: string | undefined): UseSeriesManagerResult;

package/index.d.ts

@@ -6,9 +6,7 @@ export { setFrequencyAllocationChannelsToCache, setFrequencyAllocationToCache }
 export { type ChartsThemeChange, type InitChartsThemeOptions, type InitChartsThemeResult, initChartsTheme } from './theme/init-charts-theme';
 export { type ChartsThemePreference, type ChartsThemeState, getChartsThemeState, subscribeChartsThemeChange } from './theme/theme-runtime';
 export type { ChartsSizeTokensConfig, ChartsThemeTokensConfig } from './theme/theme-tokens';
-export type { AxisXProps, AxisYRange, BandProps, ChartRef, DialPolygon, FrequencyAllocationChannel, FrequencyAllocationDensity, FrequencyAllocationItem, MarkerProps, MarkerType, Publish, PublishData, PublishDial, PublishGauge, PublishHeatmap, PublishIQ, PublishLevelStream, PublishOccupancy, PublishSpectrum, RecursiveFunction, // 递归方法 后期会删除
-RecursiveObject, // 递归对象 后期会删除
-Render, Reset, SegmentsOriginal, SeriesConfig, SetAntennaFactor, SetChannels, SetMarker, SetSegments, SetSeries, SetSpectrumBandwidth, SignalData, SignalDetails, SpectrumBandwidth, SpectrumExtraData, StationInfoType } from './types';
+export type { AxisXProps, AxisYRange, BandProps, ChartRef, DialPolygon, FrequencyAllocationChannel, FrequencyAllocationDensity, FrequencyAllocationItem, MarkerProps, MarkerType, Publish, PublishData, PublishDial, PublishGauge, PublishHeatmap, PublishIQ, PublishLevelStream, PublishOccupancy, PublishSpectrum, RecursiveFunction, RecursiveObject, Render, Reset, SegmentsOriginal, SeriesConfig, SetAntennaFactor, SetChannels, SetMarker, SetSegments, SetSeries, SetSpectrumBandwidth, SignalData, SignalDetails, SpectrumBandwidth, SpectrumExtraData, StationInfoType } from './types';
 export { HeatmapCaptureType, MarkerMode } from './types';
 export { SignalDataType } from './types/store';
 export type { FrequencyUnitResult } from './utils';