@rfkit/charts 1.10.12 → 1.11.0

package/modules/base/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * 渲染器基类导出
- */
 export { BaseRenderer, type BaseRenderState, type IRenderer } from './BaseRenderer';
 export { type CircularData, CircularRenderer, type CircularRenderState, type CircularSeriesItem } from './CircularRenderer';
 export { GradientRenderer, type GradientRenderState } from './GradientRenderer';

package/package.json

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

package/runtime/interaction/index.d.ts

@@ -38,6 +38,8 @@ export interface InteractionRuntimeOptions {
 }
 type PointerListener = (snapshot: PointerSnapshot | null) => void;
 type SampleListener = (snapshot: CursorSampleSnapshot | null) => void;
+declare const createBounds: (left: number, top: number, right: number, bottom: number) => InteractionBounds;
+declare const toCursorEventSnapshot: (snapshot: PointerSnapshot | CursorSampleSnapshot) => CursorEventSnapshot;
 export declare class InteractionRuntime {
     private readonly entries;
     private readonly sampleIntervalMs;
@@ -66,6 +68,6 @@ export declare class InteractionRuntime {
     private cleanupEntryIfEmpty;
 }
 export declare const interactionRuntime: InteractionRuntime;
-export declare const createInteractionBounds: (left: number, top: number, right: number, bottom: number) => InteractionBounds;
-export declare const toCursorSnapshotEvent: (snapshot: PointerSnapshot | CursorSampleSnapshot) => CursorEventSnapshot;
+export declare const createInteractionBounds: typeof createBounds;
+export declare const toCursorSnapshotEvent: typeof toCursorEventSnapshot;
 export {};

package/runtime/passThrough.d.ts

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

package/store/Params.d.ts

@@ -1,12 +1,5 @@
 import type React from 'react';
 import type { AxisYProps, ParamsProps, StoreState } from '../types';
-/**
- * 混合参数
- * @param key 参数键名
- * @param params 要混合的参数
- * @param state 当前状态
- * @returns 混合后的参数
- */
 export declare function mergeParameter<K extends keyof StoreState>(key: K, params: StoreState[K] | Partial<StoreState[K]> | null | undefined, state?: StoreState): StoreState[K];
 export declare function normalizeAxisYProps(axisY?: Partial<AxisYProps>): Partial<AxisYProps> | undefined;
 declare const Params: React.FC<ParamsProps>;

package/store/bandState.d.ts

@@ -1,7 +1,3 @@
 import { type BandState } from '../types/store/ui.ts';
 export type BandUpdateStrategy = 'merge' | 'replace';
-/**
- * 将 prop / publish 的 Band 输入归一化为唯一内部状态。
- * 无效输入返回当前状态引用，避免破坏已生效的 Band。
- */
 export declare function resolveBandState(input: Record<string, unknown>, current?: BandState, strategy?: BandUpdateStrategy): BandState;

package/store/defaultState.d.ts

@@ -1,6 +1,2 @@
 import { type StoreState } from '../types/store';
-/**
- * 创建默认参数
- * @returns 默认参数对象
- */
 export declare function createParams(): StoreState;

package/store/globalState.d.ts

@@ -1,14 +1,5 @@
 import type { RecursiveObject } from '../types';
 import type { StoreState } from '../types/store';
-/**
- * 设置全局store状态
- */
 export declare const setGlobalStoreState: (globalID: string, state: RecursiveObject) => void;
-/**
- * 获取全局store状态
- */
 export declare const getGlobalStoreState: (globalID: string) => StoreState | null;
-/**
- * 清理指定图表实例的全局store状态
- */
 export declare const clearGlobalStoreState: (globalID: string) => void;

package/store/hooks/useStore.d.ts

@@ -1,21 +1,12 @@
 import type { DispatchAction, StoreState } from '../../types/store';
 import type { ChartStore } from '../chart-store';
 import type { ChartRuntime } from '../runtime';
-/**
- * 使用全局状态的 hook
- * @returns 状态和 dispatch 函数
- */
 export declare function useStore(): {
     dispatch: (action: DispatchAction) => void;
     runtime: ChartRuntime;
     state: StoreState;
     store: ChartStore;
 };
-/**
- * 获取特定状态的 hook
- * @param selector 选择器函数
- * @returns 选择的状态
- */
 export declare function useSelector<T>(selector: (state: StoreState) => T): T;
 export declare function useStoreApi(): {
     dispatch: (action: DispatchAction) => void;

package/theme/style-scope.d.ts

@@ -4,17 +4,17 @@ export declare const CHARTS_STYLE_SCOPE_VALUE = "true";
 export declare const CHARTS_PORTAL_SLOT_ATTRIBUTE = "data-rfkit-charts-portal";
 export declare const CHARTS_PORTAL_Z_INDEX: Record<string, number>;
 export declare const CHARTS_SCOPE_STYLE_VARS: {
-    readonly '--radius': "0px";
-    readonly '--radius-sm': "0px";
-    readonly '--radius-md': "0px";
-    readonly '--radius-lg': "0px";
-    readonly '--radius-xl': "0px";
-    readonly '--radius-micro': "0px";
-    readonly '--radius-control': "0px";
-    readonly '--radius-group': "0px";
-    readonly '--radius-surface': "0px";
-    readonly '--radius-pill': "9999px";
-    readonly '--size-border-radius-second': "var(--radius-control)";
+    readonly '--radius': '0px';
+    readonly '--radius-sm': '0px';
+    readonly '--radius-md': '0px';
+    readonly '--radius-lg': '0px';
+    readonly '--radius-xl': '0px';
+    readonly '--radius-micro': '0px';
+    readonly '--radius-control': '0px';
+    readonly '--radius-group': '0px';
+    readonly '--radius-surface': '0px';
+    readonly '--radius-pill': '9999px';
+    readonly '--size-border-radius-second': 'var(--radius-control)';
 };
 export declare const applyChartsScopeRoot: (element: HTMLElement) => void;
 export declare const ensureChartsPortalRoot: (slot: string) => HTMLDivElement | null;

package/theme/theme-color.d.ts

@@ -3,7 +3,6 @@ export interface ThemeFillStyle {
     fillStylePrimary: string;
     fillStyleTransparentBase: string;
 }
-/** 文本图例沿用颜色色相，但去除业务填充色的透明度以保证可读性。 */
 export declare const toOpaqueCssColor: (value: string) => string;
 export declare function getThemeFillStyle(scopeTarget?: Element | null): ThemeFillStyle;
 export declare const getThemeColor: (property: string, opacity?: number, scopeTarget?: Element | null) => string;

package/theme/theme-contract.d.ts

@@ -2,13 +2,13 @@ export declare const THEME_KEY = "theme";
 export declare const THEME_FOLLOW_OS_KEY = "theme-follow-OS";
 export declare const SIZE_KEY = "size";
 export declare const ThemeType: {
-    readonly Dark: "dark";
-    readonly Light: "light";
+    readonly Dark: 'dark';
+    readonly Light: 'light';
 };
 export type ThemeType = (typeof ThemeType)[keyof typeof ThemeType];
 export declare const SizeType: {
-    readonly Middle: "middle";
-    readonly Small: "small";
+    readonly Middle: 'middle';
+    readonly Small: 'small';
 };
 export type SizeType = (typeof SizeType)[keyof typeof SizeType];
 export interface ChartsThemeContract {

package/theme/theme-tokens.d.ts

@@ -13,51 +13,51 @@ export interface SizeVariableDefinition extends SizeScaleValues {
     name: string;
 }
 export declare const SEMANTIC_TOKEN_VARIABLES: {
-    readonly accent: "--accent";
-    readonly accentForeground: "--accent-foreground";
-    readonly background: "--background";
-    readonly border: "--border";
-    readonly card: "--card";
-    readonly cardForeground: "--card-foreground";
-    readonly destructive: "--destructive";
-    readonly destructiveForeground: "--destructive-foreground";
-    readonly foreground: "--foreground";
-    readonly input: "--input";
-    readonly muted: "--muted";
-    readonly mutedForeground: "--muted-foreground";
-    readonly popover: "--popover";
-    readonly popoverForeground: "--popover-foreground";
-    readonly primary: "--primary";
-    readonly primaryForeground: "--primary-foreground";
-    readonly radius: "--radius";
-    readonly ring: "--ring";
-    readonly secondary: "--secondary";
-    readonly secondaryForeground: "--secondary-foreground";
-    readonly success: "--success";
-    readonly successForeground: "--success-foreground";
-    readonly warning: "--warning";
-    readonly warningForeground: "--warning-foreground";
+    readonly accent: '--accent';
+    readonly accentForeground: '--accent-foreground';
+    readonly background: '--background';
+    readonly border: '--border';
+    readonly card: '--card';
+    readonly cardForeground: '--card-foreground';
+    readonly destructive: '--destructive';
+    readonly destructiveForeground: '--destructive-foreground';
+    readonly foreground: '--foreground';
+    readonly input: '--input';
+    readonly muted: '--muted';
+    readonly mutedForeground: '--muted-foreground';
+    readonly popover: '--popover';
+    readonly popoverForeground: '--popover-foreground';
+    readonly primary: '--primary';
+    readonly primaryForeground: '--primary-foreground';
+    readonly radius: '--radius';
+    readonly ring: '--ring';
+    readonly secondary: '--secondary';
+    readonly secondaryForeground: '--secondary-foreground';
+    readonly success: '--success';
+    readonly successForeground: '--success-foreground';
+    readonly warning: '--warning';
+    readonly warningForeground: '--warning-foreground';
 };
 export declare const CHART_TOKEN_VARIABLES: {
-    readonly grid: "--chart-grid";
-    readonly gridStrong: "--chart-grid-strong";
-    readonly highlight: "--chart-highlight";
-    readonly panel: "--chart-panel";
-    readonly panelForeground: "--chart-panel-foreground";
-    readonly surface: "--chart-surface";
+    readonly grid: '--chart-grid';
+    readonly gridStrong: '--chart-grid-strong';
+    readonly highlight: '--chart-highlight';
+    readonly panel: '--chart-panel';
+    readonly panelForeground: '--chart-panel-foreground';
+    readonly surface: '--chart-surface';
 };
 export declare const SIZE_TOKEN_VARIABLES: {
     readonly font: {
-        readonly base: "--size-font-base";
-        readonly max: "--size-font-max";
-        readonly second: "--size-font-second";
+        readonly base: '--size-font-base';
+        readonly max: '--size-font-max';
+        readonly second: '--size-font-second';
     };
     readonly radius: {
-        readonly base: "--size-border-radius-base";
-        readonly second: "--size-border-radius-second";
+        readonly base: '--size-border-radius-base';
+        readonly second: '--size-border-radius-second';
     };
     readonly spacing: {
-        readonly base: "--size-gap-base";
+        readonly base: '--size-gap-base';
     };
 };
 export type SemanticTokenName = keyof typeof SEMANTIC_TOKEN_VARIABLES;

package/types/publish.d.ts

@@ -91,10 +91,9 @@ export interface PublishIQ {
     QData: number[];
 }
 export interface DialPolygon {
-    /** 各方向归一化值(0-1)，长度即方向数，按 0..360 度均匀分布；值决定该方向半径，1 贴最外网格 */
     values: number[];
-    /** 多边形颜色；缺省走主题主色 fillStylePrimary，边框与半透明填充均由此色派生 */
     color?: string;
+    showDots?: boolean;
 }
 export interface PublishDial {
     pstype?: PSType.Dial;
@@ -144,7 +143,6 @@ export interface Render {
 export type PublishData = SetOption | SetSeries | SetSpectrumBandwidth | SetSegments | SetChannels | SetMarker | SetAntennaFactor | SetSignal | PublishSpectrum | PublishHeatmap | PublishFluorescence | PublishOccupancy | PublishLevelStream | PublishIQ | PublishDial | PublishGauge | AutorangingEvent | PointsEvent | BandEvent | ScopeEvent | Reset | Clear | Resize | Render;
 export type Publish = ((p: PublishData) => void) & {
     getSourceData: () => rawData;
-    /** 将支持视口的图表恢复为完整数据范围；不支持时为空操作。 */
     resetViewport?: () => void;
 };
 export {};

package/types/store/index.d.ts

@@ -1,15 +1,3 @@
-/**
- * Store 类型定义
- *
- * 按功能模块拆分：
- * - axis: 坐标轴配置
- * - marker: 标记配置
- * - signal: 信号配置
- * - heatmap: 热力图配置
- * - series: 系列数据配置
- * - frequency: 频率分配配置
- * - ui: UI 组件配置
- */
 export * from './axis';
 export * from './frequency';
 export * from './heatmap';

package/types/store/marker.d.ts

@@ -4,11 +4,11 @@ export declare enum MarkerMode {
     DDC = "ddc"
 }
 export declare enum MarkerAction {
-    Add = "add",// 添加markers
-    Move = "move",// 移动marker
-    Update = "update",// 更新marker
-    Delete = "delete",// 删除markers
-    Clear = "clear",// 清空所有
+    Add = "add",
+    Move = "move",
+    Update = "update",
+    Delete = "delete",
+    Clear = "clear",
     Select = "select"
 }
 export interface MarkerChangeEvent {

package/types/store/signal.d.ts

@@ -1,8 +1,7 @@
 export declare enum SignalDataType {
-    Station = "station",// 台站信号（详细信息）
+    Station = "station",
     Simple = "simple"
 }
-/** 信号库可选详情；与台站库的公共展示信息保持一致。 */
 export interface SignalDetails {
     name?: string;
     organization?: string;

package/types/store/ui.d.ts

@@ -45,14 +45,11 @@ export interface CursorProps {
     mode?: ModuleType;
 }
 export interface ZoomOverviewProps {
-    /** 是否在独立瀑布图缩放后显示全景导航。仅在 zoom.xy=true 时生效。 */
     show?: boolean;
 }
 export interface ZoomProps {
     show: boolean;
-    /** 独立瀑布图是否启用 X/Y 同步缩放。 */
     xy?: boolean;
-    /** 独立瀑布图的可选全景导航。 */
     overview?: ZoomOverviewProps;
     select: boolean;
     interval: AxisXRange;
@@ -89,15 +86,13 @@ type BandFrequencyRangeProps = {
     frequency?: never;
     bandwidth?: never;
 };
-/** Band 对外配置：百分比、中心频率带宽、起止频率三种定位方式互斥。 */
 export type BandProps = BandSharedProps & (BandPositionProps | BandCenterBandwidthProps | BandFrequencyRangeProps);
 export declare const BandKind: {
-    readonly Position: "position";
-    readonly CenterBandwidth: "centerBandwidth";
-    readonly FrequencyRange: "frequencyRange";
+    readonly Position: 'position';
+    readonly CenterBandwidth: 'centerBandwidth';
+    readonly FrequencyRange: 'frequencyRange';
 };
 export type BandKind = (typeof BandKind)[keyof typeof BandKind];
-/** Band 内部归一化状态。 */
 export type BandState = {
     kind: typeof BandKind.Position;
     show: boolean;

package/types/store.d.ts

@@ -1,13 +1 @@
-/**
- * Store 类型定义
- *
- * 类型已按功能模块拆分到 store/ 目录：
- * - store/axis.ts: 坐标轴配置 (AxisXProps, AxisYProps)
- * - store/marker.ts: 标记配置 (MarkerProps, MarkerType, MarkerMode, MarkerAction)
- * - store/signal.ts: 信号配置 (SignalProps, SignalData, SignalDataType)
- * - store/heatmap.ts: 热力图配置 (HeatmapCaptureProps, HeatmapCaptureType)
- * - store/series.ts: 系列数据配置 (SeriesProps, LevelStreamProps)
- * - store/frequency.ts: 频率分配配置 (FrequencyAllocationProps, FrequencyAllocationItem)
- * - store/ui.ts: UI 组件配置 (CursorProps, ZoomProps, LimitProps, etc.)
- */
 export * from './store/index';

package/utils/array.d.ts

@@ -1,9 +1,3 @@
-/**
- * 数组操作工具函数
- */
-/**
- * 查找数组最大值及索引
- */
 export declare function arrayFindMax(arr: Array<number>): {
     max?: undefined;
     maxIndex?: undefined;
@@ -15,17 +9,8 @@ interface MinResult {
     min: number;
     minIndex: number;
 }
-/**
- * 查找数组最小值及索引
- */
 export declare function arrayFindMin(arr: Array<number>): MinResult | 0;
-/**
- * 是否为有效数字
- */
 export declare const isNumberAlias: (n: unknown) => boolean;
-/**
- * 获取平均值、最大值、最小值
- */
 export declare function getDimInfo(d: Array<number>): {
     min?: number;
     minIndex?: number;
@@ -33,8 +18,5 @@ export declare function getDimInfo(d: Array<number>): {
     maxIndex?: number;
     avg?: number;
 };
-/**
- * 获取中间索引
- */
 export declare function getMidIndex(indexStart: number, indexEnd: number): number;
 export {};

package/utils/cursor.d.ts

@@ -8,5 +8,5 @@ interface CursorStateLike {
     } | null;
 }
 export declare const hasActiveSpectrumCursor: (cursor: CursorStateLike) => boolean;
-export declare const resolveCursorVisibleBounds: (target: HTMLElement) => CursorEventSnapshot["bounds"];
+export declare const resolveCursorVisibleBounds: (target: HTMLElement) => CursorEventSnapshot['bounds'];
 export {};

package/utils/frequency.d.ts

@@ -1,23 +1,8 @@
-/**
- * 频率计算工具函数
- */
 import { FrequencyUnit } from '../config/constants';
 import type { RecursiveObject, SegmentsOriginal, SegmentsType } from '../types';
-/**
- * 格式化频率为固定小数位字符串
- */
 export declare const getFrequencyToFixed: (frequency: number, fixedNum?: number) => string;
-/**
- * 是否是 dBm 单位
- */
 export declare function isdBm(unit: string): boolean;
-/**
- * 通过 left segments 格式化 frequency 频谱信息
- */
 export declare const leftSegments2frequency: (segments: SegmentsType) => (left: number) => string;
-/**
- * 点信息转换成频率
- */
 export declare const leftToIndex: (left: number, length: number) => number;
 export declare function leftPoints2frequency<T>(points: Array<T>): (left: number) => T | undefined;
 interface ScopeInfo {
@@ -25,49 +10,16 @@ interface ScopeInfo {
     startLeft: number;
     endLeft: number;
 }
-/**
- * 通过范围框中信息的 left segments 转换成 bandwidth
- */
 export declare const scopeLeftSegments2bandwidth: (e: ScopeInfo | null | undefined) => number;
-/**
- * 生成频率段
- */
 export declare const generateFrequencySegments: (e: RecursiveObject) => SegmentsType;
-/**
- * 为无频率规则的模式生成默认 segments（如 LiteNormalized）
- */
 export declare const generateNormalizedSegments: (totalPoints: number) => SegmentsType;
-/**
- * 生成大段频率数据
- */
 export declare const generateGreatSegments: (prevSegments: SegmentsOriginal[]) => SegmentsType;
-/**
- * 频率单位自适应结果
- */
 export interface FrequencyUnitResult {
     value: number;
     unit: FrequencyUnit;
     formatted: string;
 }
-/**
- * 频率单位自适应转换（基于 kHz）
- * @param frequencyKHz 频率（单位：kHz）
- * @param precision 小数位数，默认 2
- * @returns 转换后的频率值、单位和格式化字符串
- */
 export declare const formatFrequencyUnit: (frequencyKHz: number, precision?: number) => FrequencyUnitResult;
-/**
- * 频率单位自适应转换（基于 MHz）
- * @param frequencyMHz 频率（单位：MHz）
- * @param precision 小数位数，默认 2
- * @returns 转换后的频率值、单位和格式化字符串
- */
 export declare const formatFrequencyUnitFromMHz: (frequencyMHz: number, precision?: number) => FrequencyUnitResult;
-/**
- * 频率单位自适应转换（基于 Hz）
- * @param frequencyHz 频率（单位：Hz）
- * @param precision 小数位数，默认 2
- * @returns 转换后的频率值、单位和格式化字符串
- */
 export declare const formatFrequencyUnitFromHz: (frequencyHz: number, precision?: number) => FrequencyUnitResult;
 export {};