@rfkit/charts 1.3.13 → 1.4.1

package/modules/base/CircularRenderer.d.ts

@@ -42,7 +42,10 @@ export interface CircularRenderState<TChart extends CircularChartLike> extends B
  * 圆形图表渲染器基类
  */
 export declare abstract class CircularRenderer<TChart extends CircularChartLike, TState extends CircularRenderState<TChart> = CircularRenderState<TChart>> extends BaseRenderer<TChart, TState, CircularData> {
-    protected themeUnsubscribe: (() => void) | null;
+    protected getMinimumContainerSize(): {
+        width: number;
+        height: number;
+    };
     /**
      * 订阅主题变化
      */
@@ -51,9 +54,5 @@ export declare abstract class CircularRenderer<TChart extends CircularChartLike,
      * 更新数据
      */
     updateSeries(data: CircularData): void;
-    /**
-     * 销毁资源
-     */
-    destroy(): void;
 }
 export {};

package/package.json

@@ -1,10 +1,34 @@
 {
   "name": "@rfkit/charts",
-  "description": "a chart library based on all",
-  "module": "index.js",
-  "types": "index.d.ts",
+  "version": "1.4.1",
+  "type": "module",
+  "description": "Chart components for wireless monitoring web applications",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    },
+    "./tailwind-bridge.css": "./tailwind-bridge.css"
+  },
+  "module": "./index.js",
+  "types": "./index.d.ts",
   "author": "Hxgh",
+  "peerDependencies": {
+    "react": ">=16.9.0",
+    "react-dom": ">=16.9.0"
+  },
   "license": "MIT",
-  "version": "1.3.13",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Hxgh/rfkit-charts"
+  },
+  "homepage": "https://github.com/Hxgh/rfkit-charts#readme",
+  "bugs": {
+    "url": "https://github.com/Hxgh/rfkit-charts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.30.3",
   "private": false
 }

package/{modules/tools.d.ts → runtime/passThrough.d.ts}

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

package/store/Params.d.ts

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

package/store/chart-store.d.ts

@@ -0,0 +1,11 @@
+import type { DispatchAction, StoreState } from '../types/store';
+type StoreListener = () => void;
+export interface ChartStore {
+    dispatch: (action: DispatchAction) => StoreState;
+    getState: () => StoreState;
+    setState: (nextState: StoreState) => StoreState;
+    subscribe: (listener: StoreListener) => () => void;
+    updateState: (updater: (state: StoreState) => StoreState) => StoreState;
+}
+export declare function createChartStore(initialState: StoreState): ChartStore;
+export {};

package/store/constants.d.ts

@@ -14,9 +14,8 @@ export declare const axisYTypeList: {
     default: string;
 };
 export declare const DEFAULT_MAX_POINTS = 1001;
-export declare const intervalDefault: {
+export declare const ZOOM_INTERVAL_DEFAULT: {
     start: number;
     end: number;
 };
-export declare const dataRateDefault = 1;
-export declare const HEATMAP_HEIGHT_DEFAULT = 100;
+export declare const DATA_RATE_DEFAULT = 1;

package/store/context.d.ts

@@ -1,7 +1,10 @@
 import React from 'react';
-import type { DispatchAction, StoreState } from '../types/store';
-interface AppContextType {
-    state: StoreState;
+import type { DispatchAction } from '../types/store';
+import type { ChartStore } from './chart-store';
+import type { ChartRuntime } from './runtime';
+export interface AppContextType {
+    runtime: ChartRuntime;
+    store: ChartStore;
     dispatch: (action: DispatchAction) => void;
 }
 declare const AppContext: React.Context<AppContextType>;

package/store/globalState.d.ts

@@ -7,3 +7,7 @@ export declare const setGlobalStoreState: (globalID: string, state: RecursiveObj
  * 获取全局store状态
  */
 export declare const getGlobalStoreState: (globalID: string) => RecursiveObject | null;
+/**
+ * 清理指定图表实例的全局store状态
+ */
+export declare const clearGlobalStoreState: (globalID: string) => void;

package/store/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useSelector, useStore, useStoreApi, useStoreDispatch } from './useStore';

package/store/hooks/useStore.d.ts

@@ -1,11 +1,15 @@
 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(): {
-    state: StoreState;
     dispatch: (action: DispatchAction) => void;
+    runtime: ChartRuntime;
+    state: StoreState;
+    store: ChartStore;
 };
 /**
  * 获取特定状态的 hook
@@ -13,3 +17,9 @@ export declare function useStore(): {
  * @returns 选择的状态
  */
 export declare function useSelector<T>(selector: (state: StoreState) => T): T;
+export declare function useStoreApi(): {
+    dispatch: (action: DispatchAction) => void;
+    runtime: ChartRuntime;
+    store: ChartStore;
+};
+export declare function useStoreDispatch(): (action: DispatchAction) => void;

package/store/index.d.ts

@@ -2,4 +2,4 @@ import type React from 'react';
 import type { StoreProps } from '../types/store';
 declare const Store: React.FC<StoreProps>;
 export default Store;
-export { useSelector, useStore } from './hooks/useStore';
+export { useSelector, useStore, useStoreApi, useStoreDispatch } from './hooks';

package/store/reducer.d.ts

@@ -1,68 +1,2 @@
 import type { DispatchAction, StoreState } from '../types/store';
-export declare const UPDATE_THEME = "UPDATE_THEME";
-export declare const defaultState: () => {
-    [key: string]: unknown;
-    globalID: string;
-    config: unknown;
-    system: import("../types").SystemConfig;
-    eventBus: import("../types").EventBusProps;
-    axisY: import("../types").AxisYProps;
-    axisX: import("..").AxisXProps;
-    toolsBar: import("../types").ToolsBarProps;
-    series: import("../types").SeriesProps;
-    segments: import("../types").SegmentsType;
-    points: unknown[];
-    marker: import("..").MarkerProps;
-    limit: import("../types").LimitProps;
-    heatmapCapture: import("../types").HeatmapCaptureProps;
-    cursor: import("../types").CursorProps;
-    zoom: import("../types").ZoomProps;
-    signal: import("../types").SignalProps;
-    signalAnalysis: import("../types").SignalAnalysisProps;
-    band: import("../types").BandProps;
-    scope: import("../types").ScopeProps;
-    gridLines: boolean;
-    legend: import("../types").LegendProps;
-    frequencyTagLine: import("../types").FrequencyTagLineBoardProps;
-    stripe: import("../types").StripeProps;
-    blaze: import("../types").BlazeProps;
-    frequencyAllocation: import("../types").FrequencyAllocationProps;
-    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) => {
-    [x: string]: unknown;
-    globalID: string;
-    config: unknown;
-    system: import("../types").SystemConfig;
-    eventBus: import("../types").EventBusProps;
-    axisY: import("../types").AxisYProps;
-    axisX: import("..").AxisXProps;
-    toolsBar: import("../types").ToolsBarProps;
-    series: import("../types").SeriesProps;
-    segments: import("../types").SegmentsType;
-    points: unknown[];
-    marker: import("..").MarkerProps;
-    limit: import("../types").LimitProps;
-    heatmapCapture: import("../types").HeatmapCaptureProps;
-    cursor: import("../types").CursorProps;
-    zoom: import("../types").ZoomProps;
-    signal: import("../types").SignalProps;
-    signalAnalysis: import("../types").SignalAnalysisProps;
-    band: import("../types").BandProps;
-    scope: import("../types").ScopeProps;
-    gridLines: boolean;
-    legend: import("../types").LegendProps;
-    frequencyTagLine: import("../types").FrequencyTagLineBoardProps;
-    stripe: import("../types").StripeProps;
-    blaze: import("../types").BlazeProps;
-    frequencyAllocation: import("../types").FrequencyAllocationProps;
-    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) => StoreState;

package/store/runtime.d.ts

@@ -0,0 +1,16 @@
+import type { DispatchAction, StoreState } from '../types/store';
+import { type ChartStore } from './chart-store';
+type RuntimeCleanup = () => void;
+export interface ChartRuntime {
+    destroy: () => void;
+    dispatch: (action: DispatchAction) => StoreState;
+    getGlobalID: () => string;
+    getState: () => StoreState;
+    registerCleanup: (cleanup?: RuntimeCleanup | null) => RuntimeCleanup | null;
+    setGlobalID: (globalID: string) => void;
+    store: ChartStore;
+    subscribe: ChartStore['subscribe'];
+}
+export declare const getChartRuntime: (globalID: string) => ChartRuntime | null;
+export declare function createChartRuntime(initialState: StoreState): ChartRuntime;
+export {};

package/tailwind-bridge.css

@@ -0,0 +1,50 @@
+/* Tailwind/shadcn semantic token bridge for rfkit-charts.
+ *
+ * Default package usage now loads the required component styles automatically.
+ * This file remains as an optional advanced entry for consumers that want to
+ * reuse the same semantic tokens in their own Tailwind v4 global CSS.
+ *
+ * This file intentionally does NOT include Tailwind preflight/reset.
+ * Theme values follow the shared `theme` / `theme-follow-OS` root contract.
+ * It only maps canonical charts tokens into Tailwind/shadcn semantic color
+ * names and does not ship legacy rfkit aliases or deprecated bridge extras.
+ */
+
+/* Use the shared root `theme` / `theme-follow-OS` contract. */
+@custom-variant dark (&:is(:root[theme="dark"] *));
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground, #ffffff);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-warning: var(--warning);
+  --color-warning-foreground: var(--warning-foreground, #ffffff);
+  --color-success: var(--success);
+  --color-success-foreground: var(--success-foreground, #ffffff);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground, #ffffff);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-panel: var(--chart-panel);
+  --color-chart-panel-foreground: var(--chart-panel-foreground);
+  --color-chart-grid: var(--chart-grid);
+  --color-chart-grid-strong: var(--chart-grid-strong);
+  --color-chart-highlight: var(--chart-highlight);
+  --color-chart-surface: var(--chart-surface);
+  --radius-sm: calc(var(--radius, var(--size-border-radius-base, 0px)) - 4px);
+  --radius-md: calc(var(--radius, var(--size-border-radius-base, 0px)) - 2px);
+  --radius-lg: var(--radius, var(--size-border-radius-base, 0px));
+  --radius-xl: calc(var(--radius, var(--size-border-radius-base, 0px)) + 4px);
+}

package/theme/init-charts-theme.d.ts

@@ -0,0 +1,12 @@
+import { type ChartsThemeState } from './theme-runtime.ts';
+import type { ChartsSizeTokensConfig, ChartsThemeTokensConfig } from './theme-tokens.ts';
+export type ChartsThemeChange = ChartsThemeState;
+export interface InitChartsThemeOptions {
+    onChange?: (state: ChartsThemeChange) => void;
+    sizes?: ChartsSizeTokensConfig;
+    tokens?: ChartsThemeTokensConfig;
+}
+export interface InitChartsThemeResult extends ChartsThemeState {
+    cleanup?: () => void;
+}
+export declare function initChartsTheme(options?: InitChartsThemeOptions): InitChartsThemeResult;

package/theme/style-scope.d.ts

@@ -0,0 +1,20 @@
+export declare const CHARTS_STYLE_SCOPE_ATTRIBUTE = "data-rfkit-charts-root";
+export declare const CHARTS_STYLE_SCOPE_SELECTOR = "[data-rfkit-charts-root]";
+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)";
+};
+export declare const applyChartsScopeRoot: (element: HTMLElement) => void;
+export declare const ensureChartsPortalRoot: (slot: string) => HTMLDivElement;

package/theme/theme-color.d.ts

@@ -0,0 +1,7 @@
+export interface ThemeFillStyle {
+    fillStyle: string;
+    fillStylePrimary: string;
+    fillStyleTransparentBase: 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

@@ -0,0 +1,28 @@
+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";
+};
+export type ThemeType = (typeof ThemeType)[keyof typeof ThemeType];
+export declare const SizeType: {
+    readonly Middle: "middle";
+    readonly Small: "small";
+};
+export type SizeType = (typeof SizeType)[keyof typeof SizeType];
+export interface ChartsThemeContract {
+    followOS: boolean;
+    theme: ThemeType;
+}
+export declare const DEFAULT_THEME: ThemeType;
+export declare const DEFAULT_FOLLOW_OS = true;
+export declare const DEFAULT_SIZE: SizeType;
+export declare const canUseDOM: () => boolean;
+export declare const getThemeMedia: () => MediaQueryList;
+export declare const isThemeType: (value: string | null) => value is ThemeType;
+export declare const getSystemTheme: () => ThemeType;
+export declare const readThemeContract: () => ChartsThemeContract;
+export declare const getRootTheme: () => ThemeType;
+export declare const getRootThemeFollowOS: () => boolean;
+export declare const writeThemeContract: ({ followOS, theme }: ChartsThemeContract) => void;

package/theme/theme-runtime.d.ts

@@ -0,0 +1,14 @@
+import { type ThemeType } from './theme-contract.ts';
+export type ChartsThemePreference = 'system' | ThemeType;
+export interface ChartsThemeState {
+    contractTheme: ThemeType;
+    followOS: boolean;
+    preference: ChartsThemePreference;
+    theme: ThemeType;
+}
+type ChartsThemeListener = (state: ChartsThemeState) => void;
+export declare const resolveChartsThemeState: () => ChartsThemeState;
+export declare const getChartsThemeState: () => ChartsThemeState;
+export declare const subscribeChartsThemeChange: (listener: ChartsThemeListener) => () => void;
+export declare const resetChartsThemeRuntimeForTests: () => void;
+export {};

package/theme/theme-styles.d.ts

@@ -0,0 +1,10 @@
+import { type ChartsSizeTokensConfig, type ChartsThemeTokensConfig } from './theme-tokens.ts';
+export interface ThemeStyleOptions {
+    sizes?: ChartsSizeTokensConfig;
+    tokens?: ChartsThemeTokensConfig;
+}
+export declare const ensureRootThemeStyles: ({ tokens }?: ThemeStyleOptions) => void;
+export declare const ensureChartsThemeStyles: ({ tokens }?: ThemeStyleOptions) => void;
+export declare const ensureChartsSizeStyles: (sizes?: ChartsSizeTokensConfig) => void;
+export declare const initializeRootThemeEnvironment: (options?: ThemeStyleOptions) => void;
+export declare const initializeChartsThemeEnvironment: (options?: ThemeStyleOptions) => void;

package/theme/theme-tokens.d.ts

@@ -0,0 +1,85 @@
+export interface ThemeToneValues {
+    dark: string;
+    light: string;
+}
+export interface SizeScaleValues {
+    middle: string;
+    small: string;
+}
+export interface ThemeVariableDefinition extends ThemeToneValues {
+    name: string;
+}
+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";
+};
+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";
+};
+export declare const SIZE_TOKEN_VARIABLES: {
+    readonly font: {
+        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 spacing: {
+        readonly base: "--size-gap-base";
+    };
+};
+export type SemanticTokenName = keyof typeof SEMANTIC_TOKEN_VARIABLES;
+export type ChartTokenName = keyof typeof CHART_TOKEN_VARIABLES;
+export type SemanticTokenConfig = Partial<Record<SemanticTokenName, Partial<ThemeToneValues>>>;
+export type ChartTokenConfig = Partial<Record<ChartTokenName, Partial<ThemeToneValues>>>;
+export interface ChartsThemeTokensConfig {
+    chart?: ChartTokenConfig;
+    semantic?: SemanticTokenConfig;
+}
+export interface ChartsSizeTokensConfig {
+    font?: Partial<Record<keyof typeof SIZE_TOKEN_VARIABLES.font, Partial<SizeScaleValues>>>;
+    radius?: Partial<Record<keyof typeof SIZE_TOKEN_VARIABLES.radius, Partial<SizeScaleValues>>>;
+    spacing?: Partial<Record<keyof typeof SIZE_TOKEN_VARIABLES.spacing, Partial<SizeScaleValues>>>;
+}
+export declare const getCanonicalThemeVariableDefinitions: (tokens?: ChartsThemeTokensConfig) => {
+    dark: string;
+    light: string;
+    name: string;
+}[];
+export declare const getSizeVariableDefinitions: (sizes?: ChartsSizeTokensConfig) => {
+    middle: string;
+    small: string;
+    name: string;
+}[];

package/types/common.d.ts

@@ -20,13 +20,13 @@ export interface RenderChartType {
     reset(): unknown;
     resize(): unknown;
     dispose(): (() => void) | undefined;
+    updateParams(params: RecursiveObject): void;
     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;

package/types/store/index.d.ts

@@ -24,7 +24,7 @@ import type { HeatmapCaptureProps } from './heatmap';
 import type { MarkerProps } from './marker';
 import type { LevelStreamProps, SeriesProps } from './series';
 import type { SignalAnalysisProps, SignalProps } from './signal';
-import type { BandProps, BlazeProps, CursorProps, DeltaMeasurementProps, EventBusProps, FluorescenceProps, FrequencyTagLineBoardProps, LegendProps, LimitProps, ScopeProps, StripeProps, SystemConfig, ToolsBarProps, ZoomProps } from './ui';
+import type { BandProps, BlazeProps, CursorProps, DeltaMeasurementProps, EventBusProps, FluorescenceProps, FrequencyTagLineBoardProps, LegendProps, LimitProps, ScopeProps, StripeProps, SystemConfig, ToolbarProps, ZoomProps } from './ui';
 export interface StoreState {
     globalID: string;
     config: unknown;
@@ -32,7 +32,7 @@ export interface StoreState {
     eventBus: EventBusProps;
     axisY: AxisYProps;
     axisX: AxisXProps;
-    toolsBar: ToolsBarProps;
+    toolbar: ToolbarProps;
     series: SeriesProps;
     segments: SegmentsType;
     points: unknown[];
@@ -58,9 +58,11 @@ export interface StoreState {
     [key: string]: unknown;
     publish?: Publish;
 }
+export type StoreUpdatePayload = Record<string, unknown> | StoreState | ((state: StoreState) => Record<string, unknown> | StoreState | null | undefined);
 export interface DispatchAction {
     type?: string;
-    payload: Record<string, unknown>;
+    payload: StoreUpdatePayload;
+    replace?: boolean;
 }
 export interface StoreProps extends ParamsProps {
     children: React.ReactNode;
@@ -86,7 +88,7 @@ export interface ParamsProps {
     series?: Partial<SeriesProps>;
     frequencyTagLine?: Partial<FrequencyTagLineBoardProps>;
     frequencyAllocation?: Partial<FrequencyAllocationProps>;
-    toolsBar?: Partial<ToolsBarProps>;
+    toolbar?: Partial<ToolbarProps>;
     band?: Partial<BandProps>;
     levelStream?: Partial<LevelStreamProps>;
     deltaMeasurement?: Partial<DeltaMeasurementProps>;

package/types/store/ui.d.ts

@@ -1,6 +1,10 @@
 import type { FluorescenceRenderMode } from '@rfkit/renderer';
 import type { ModuleType } from '../../config';
 import type { AxisXRange, RecursiveObject, TopRightBottomLeft } from '..';
+export interface ToolbarProps {
+    show: boolean;
+    hiddenTools?: string[];
+}
 export interface SystemConfig {
     width: number;
     height: number;
@@ -9,10 +13,6 @@ export interface SystemConfig {
     borderRadius: boolean;
     onChange: (e: RecursiveObject) => void;
 }
-export interface ToolsBarProps {
-    show: boolean;
-    hiddenTools?: string[];
-}
 export interface LimitProps {
     show: boolean;
     disabled?: boolean;
@@ -22,10 +22,24 @@ export interface LimitProps {
     label?: string;
     onChange: (l: number[]) => void;
 }
+export interface CursorEventSnapshot {
+    sourceId: string;
+    sourceType: ModuleType;
+    clientX: number;
+    clientY: number;
+    bounds: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+        width: number;
+        height: number;
+    };
+}
 export interface CursorProps {
     show: boolean;
     active: boolean;
-    event: React.MouseEvent | null;
+    event: CursorEventSnapshot | null;
     coord: TopRightBottomLeft;
     timeout: number;
     mode?: ModuleType;

package/utils/cn.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/utils/converter.d.ts

@@ -12,4 +12,4 @@ declare const mW2dBm: (input: number) => number;
 declare const mW2dBuV: (input: number) => number;
 declare const mW2V: (input: number) => number;
 declare const spectrum2dBm: (inputs: Array<number>) => number[];
-export { dBm2dBuV, dBm2V, dBm2mW, dBuV2dBm, dBuV2V, dBuV2uV, dBuV2mW, V2dBm, V2dBuV, V2mW, mW2dBm, mW2dBuV, mW2V, spectrum2dBm };
+export { dBm2dBuV, dBm2mW, dBm2V, dBuV2dBm, dBuV2mW, dBuV2uV, dBuV2V, mW2dBm, mW2dBuV, mW2V, spectrum2dBm, V2dBm, V2dBuV, V2mW };

package/utils/cursor.d.ts

@@ -0,0 +1,12 @@
+import { ModuleType } from '../config';
+import type { CursorEventSnapshot } from '../types/store';
+interface CursorStateLike {
+    show: boolean;
+    active: boolean;
+    event?: {
+        sourceType?: ModuleType;
+    } | null;
+}
+export declare const hasActiveSpectrumCursor: (cursor: CursorStateLike) => boolean;
+export declare const resolveCursorVisibleBounds: (target: HTMLElement) => CursorEventSnapshot["bounds"];
+export {};

package/utils/frequencyCalculation.d.ts

@@ -135,6 +135,14 @@ export declare function calculatePositionFromFrequencyRange(range: FrequencyRang
  * @returns 光标位置信息
  */
 export declare function calculateCursorPosition(left: number, segments: SegmentType[]): CursorPosition;
+/**
+ * 根据当前光标段位和点索引，获取内部命中使用的精确频率。
+ *
+ * 注意：
+ * - 这里返回的是基于 frequencyCache 的采样频率，不是展示层格式化后的字符串
+ * - 用于 hover / active 命中，可以避免展示格式化或索引换算差异带来的误判
+ */
+export declare function getCursorFrequencyAtPosition(segments: SegmentType[], position: CursorPosition): number;
 /**
  * 判断光标是否在频率范围内（使用索引 + 容差）
  *

package/utils/index.d.ts

@@ -3,10 +3,10 @@
  */
 import type { TimestampedFloat32Array } from '@rfkit/spectrum-analyzer';
 export * from './array';
+export * from './cursor';
 export * from './frequency';
 export * from './frequencyCalculation';
 export * from './object';
-export * from './theme';
 export * from './throttle';
 export * from './time';
 /**