@rfkit/charts 1.3.13 → 1.4.0

package/lib/index.d.ts

@@ -5,4 +5,4 @@ import IQ from './IQ';
 import LevelStream from './LevelStream';
 import Occupancy from './Occupancy';
 import Spectrum from './Spectrum';
-export { Spectrum, LevelStream, IQ, Gauge, Dial, Heatmap, Occupancy };
+export { Dial, Gauge, Heatmap, IQ, LevelStream, Occupancy, Spectrum };

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "@rfkit/charts",
   "description": "a chart library based on all",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    },
+    "./tailwind-bridge.css": "./tailwind-bridge.css"
+  },
   "module": "index.js",
   "types": "index.d.ts",
   "author": "Hxgh",
   "license": "MIT",
-  "version": "1.3.13",
+  "version": "1.4.0",
   "private": false
 }

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/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,6 +1,6 @@
 import React from 'react';
 import type { DispatchAction, StoreState } from '../types/store';
-interface AppContextType {
+export interface AppContextType {
     state: StoreState;
     dispatch: (action: DispatchAction) => void;
 }

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 } from './useStore';

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 } from './hooks';

package/store/reducer.d.ts

@@ -1,38 +1,4 @@
 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;

package/tailwind-bridge.css

@@ -0,0 +1,123 @@
+/* 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.
+ */
+
+/* Use @rfkit/theme's :root[theme="dark"] / :root[theme="light"] attributes. */
+@custom-variant dark (&:is(:root[theme="dark"] *));
+
+@theme inline {
+  --color-background: var(--background, var(--theme-bg-base));
+  --color-foreground: var(--foreground, var(--theme-color-base));
+  --color-card: var(--card, var(--background, var(--theme-bg-base)));
+  --color-card-foreground: var(
+    --card-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-popover: var(--popover, var(--background, var(--theme-bg-base)));
+  --color-popover-foreground: var(
+    --popover-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-primary: var(--primary, var(--theme-color-primary));
+  --color-primary-foreground: var(--primary-foreground, #ffffff);
+  --color-secondary: var(--secondary, var(--theme-bg-second));
+  --color-secondary-foreground: var(
+    --secondary-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-muted: var(--muted, var(--theme-bg-third, var(--theme-bg-second)));
+  --color-muted-foreground: var(
+    --muted-foreground,
+    color-mix(in srgb, var(--theme-color-base) 70%, transparent)
+  );
+  --color-accent: var(--accent, var(--secondary, var(--theme-bg-second)));
+  --color-accent-foreground: var(
+    --accent-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-warning: var(--warning, var(--theme-color-warn));
+  --color-warning-foreground: var(--warning-foreground, #ffffff);
+  --color-success: var(--success, var(--theme-color-success));
+  --color-success-foreground: var(--success-foreground, #ffffff);
+  --color-destructive: var(--destructive, var(--theme-color-error));
+  --color-destructive-foreground: var(--destructive-foreground, #ffffff);
+  --color-border: var(--border, var(--theme-border-base));
+  --color-input: var(--input, var(--border, var(--theme-border-base)));
+  --color-ring: var(--ring, var(--primary, var(--theme-color-primary)));
+  --color-chart-panel: var(
+    --chart-panel,
+    color-mix(in srgb, var(--theme-bg-base) 96%, transparent)
+  );
+  --color-chart-panel-foreground: var(
+    --chart-panel-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-chart-grid: var(
+    --chart-grid,
+    color-mix(in srgb, var(--theme-color-base) 12%, transparent)
+  );
+  --color-chart-grid-strong: var(
+    --chart-grid-strong,
+    color-mix(in srgb, var(--theme-color-base) 28%, transparent)
+  );
+  --color-chart-highlight: var(
+    --chart-highlight,
+    var(--primary, var(--theme-color-primary))
+  );
+  --color-chart-warning: var(
+    --chart-warning,
+    var(--warning, var(--theme-color-warn))
+  );
+  --color-chart-danger: var(
+    --chart-danger,
+    var(--destructive, var(--theme-color-error))
+  );
+  --color-chart-surface: var(
+    --chart-surface,
+    var(--secondary, var(--theme-bg-second))
+  );
+  --color-chart-1: var(--chart-1, var(--primary, var(--theme-color-primary)));
+  --color-chart-2: var(--chart-2, var(--warning, var(--theme-color-warn)));
+  --color-chart-3: var(--chart-3, #4d7cf8);
+  --color-chart-4: var(--chart-4, #5ab9c1);
+  --color-chart-5: var(--chart-5, #682e8f);
+  --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);
+  --color-sidebar: var(--sidebar, var(--background, var(--theme-bg-base)));
+  --color-sidebar-foreground: var(
+    --sidebar-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-sidebar-primary: var(
+    --sidebar-primary,
+    var(--primary, var(--theme-color-primary))
+  );
+  --color-sidebar-primary-foreground: var(
+    --sidebar-primary-foreground,
+    #ffffff
+  );
+  --color-sidebar-accent: var(
+    --sidebar-accent,
+    var(--secondary, var(--theme-bg-second))
+  );
+  --color-sidebar-accent-foreground: var(
+    --sidebar-accent-foreground,
+    var(--foreground, var(--theme-color-base))
+  );
+  --color-sidebar-border: var(
+    --sidebar-border,
+    var(--border, var(--theme-border-base))
+  );
+  --color-sidebar-ring: var(
+    --sidebar-ring,
+    var(--ring, var(--theme-color-primary))
+  );
+}

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

@@ -0,0 +1,27 @@
+import { ThemeType } from '@rfkit/theme';
+export type ChartsThemePreference = 'system' | ThemeType;
+export interface ChartsThemeState {
+    mode: boolean;
+    preference: ChartsThemePreference;
+    theme: ThemeType;
+}
+export interface ApplyChartsThemeOptions {
+    mode?: boolean;
+    preference?: ChartsThemePreference;
+    theme?: ThemeType;
+}
+type ChartsThemeListener = (state: ChartsThemeState) => void;
+export declare const getChartsThemeState: () => ChartsThemeState;
+export declare const getChartsThemePreference: () => ChartsThemePreference;
+/**
+ * @deprecated 新代码应由应用层或 @rfkit/theme 写入 theme / theme-follow-OS。
+ * charts 仅保留该方法作为兼容层。
+ */
+export declare const applyChartsTheme: (options?: ApplyChartsThemeOptions) => ChartsThemeState;
+/**
+ * @deprecated 新代码应由应用层或 @rfkit/theme 写入 theme / theme-follow-OS。
+ * charts 仅保留该方法作为兼容层。
+ */
+export declare const applyChartsThemePreference: (preference: ChartsThemePreference) => ChartsThemeState;
+export declare const subscribeChartsThemeChange: (listener: ChartsThemeListener) => () => void;
+export {};

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

@@ -0,0 +1,7 @@
+import { type SizeConfigs, type ThemeConfigs } from '@rfkit/theme';
+export declare const ensureChartsThemeStyles: (themeConfigs?: ThemeConfigs) => void;
+export interface InitializeChartsThemeEnvironmentOptions {
+    sizeConfigs?: SizeConfigs;
+    themeConfigs?: ThemeConfigs;
+}
+export declare const initializeChartsThemeEnvironment: (options?: InitializeChartsThemeEnvironmentOptions) => void;

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

@@ -0,0 +1,16 @@
+import type { SizeConfigs, ThemeConfigs } from '@rfkit/theme';
+import type { ChartsThemeState } from './charts-theme-controller';
+export type ChartsThemeChange = Pick<ChartsThemeState, 'mode' | 'theme'>;
+export interface InitChartsThemeOptions {
+    mode?: boolean;
+    sizeConfigs?: SizeConfigs;
+    subscribeThemeChange?: (e: ChartsThemeChange) => void;
+    theme?: ChartsThemeState['theme'];
+    themeConfigs?: ThemeConfigs;
+}
+export interface InitChartsThemeResult {
+    cleanup?: () => void;
+    mode: boolean;
+    theme: ChartsThemeState['theme'];
+}
+export declare function initChartsTheme(options?: InitChartsThemeOptions): InitChartsThemeResult;

package/theme/shadcn-theme-config.d.ts

@@ -0,0 +1,221 @@
+export declare const RFKIT_CHARTS_SHADCN_THEME_CONFIGS: [{
+    readonly name: "--background";
+    readonly dark: "#202020";
+    readonly light: "#FFFFFF";
+}, {
+    readonly name: "--foreground";
+    readonly dark: "#FFFFFF";
+    readonly light: "#1D2129";
+}, {
+    readonly name: "--card";
+    readonly dark: "var(--background)";
+    readonly light: "var(--background)";
+}, {
+    readonly name: "--card-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--popover";
+    readonly dark: "var(--background)";
+    readonly light: "var(--background)";
+}, {
+    readonly name: "--popover-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--primary";
+    readonly dark: "#4371F8";
+    readonly light: "#2A51F7";
+}, {
+    readonly name: "--primary-foreground";
+    readonly dark: "#FFFFFF";
+    readonly light: "#FFFFFF";
+}, {
+    readonly name: "--secondary";
+    readonly dark: "#29292B";
+    readonly light: "#F0F1F3";
+}, {
+    readonly name: "--secondary-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--muted";
+    readonly dark: "#2F2F2F";
+    readonly light: "#E1E2E8";
+}, {
+    readonly name: "--muted-foreground";
+    readonly dark: "rgba(255, 255, 255, 0.7)";
+    readonly light: "rgba(29, 33, 41, 0.7)";
+}, {
+    readonly name: "--accent";
+    readonly dark: "var(--secondary)";
+    readonly light: "var(--secondary)";
+}, {
+    readonly name: "--accent-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--warning";
+    readonly dark: "#FF9626";
+    readonly light: "#FF7D00";
+}, {
+    readonly name: "--warning-foreground";
+    readonly dark: "#FFFFFF";
+    readonly light: "#FFFFFF";
+}, {
+    readonly name: "--success";
+    readonly dark: "#23C343";
+    readonly light: "#00B42A";
+}, {
+    readonly name: "--success-foreground";
+    readonly dark: "#FFFFFF";
+    readonly light: "#FFFFFF";
+}, {
+    readonly name: "--destructive";
+    readonly dark: "#F76965";
+    readonly light: "#F53F3F";
+}, {
+    readonly name: "--destructive-foreground";
+    readonly dark: "#FFFFFF";
+    readonly light: "#FFFFFF";
+}, {
+    readonly name: "--border";
+    readonly dark: "#313131";
+    readonly light: "#F0F0F0";
+}, {
+    readonly name: "--input";
+    readonly dark: "var(--border)";
+    readonly light: "var(--border)";
+}, {
+    readonly name: "--ring";
+    readonly dark: "var(--primary)";
+    readonly light: "var(--primary)";
+}, {
+    readonly name: "--chart-panel";
+    readonly dark: "rgba(32, 32, 32, 0.96)";
+    readonly light: "rgba(255, 255, 255, 0.96)";
+}, {
+    readonly name: "--chart-panel-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--chart-grid";
+    readonly dark: "rgba(255, 255, 255, 0.12)";
+    readonly light: "rgba(29, 33, 41, 0.12)";
+}, {
+    readonly name: "--chart-grid-strong";
+    readonly dark: "rgba(255, 255, 255, 0.28)";
+    readonly light: "rgba(29, 33, 41, 0.28)";
+}, {
+    readonly name: "--chart-highlight";
+    readonly dark: "var(--primary)";
+    readonly light: "var(--primary)";
+}, {
+    readonly name: "--chart-warning";
+    readonly dark: "var(--warning)";
+    readonly light: "var(--warning)";
+}, {
+    readonly name: "--chart-danger";
+    readonly dark: "var(--destructive)";
+    readonly light: "var(--destructive)";
+}, {
+    readonly name: "--chart-surface";
+    readonly dark: "var(--secondary)";
+    readonly light: "var(--secondary)";
+}, {
+    readonly name: "--chart-1";
+    readonly dark: "var(--primary)";
+    readonly light: "var(--primary)";
+}, {
+    readonly name: "--chart-2";
+    readonly dark: "var(--warning)";
+    readonly light: "var(--warning)";
+}, {
+    readonly name: "--chart-3";
+    readonly dark: "#4D7CF8";
+    readonly light: "#4D7CF8";
+}, {
+    readonly name: "--chart-4";
+    readonly dark: "#5AB9C1";
+    readonly light: "#5AB9C1";
+}, {
+    readonly name: "--chart-5";
+    readonly dark: "#682E8F";
+    readonly light: "#682E8F";
+}, {
+    readonly name: "--radius";
+    readonly dark: "var(--size-border-radius-base)";
+    readonly light: "var(--size-border-radius-base)";
+}, {
+    readonly name: "--sidebar";
+    readonly dark: "var(--background)";
+    readonly light: "var(--background)";
+}, {
+    readonly name: "--sidebar-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--sidebar-primary";
+    readonly dark: "var(--primary)";
+    readonly light: "var(--primary)";
+}, {
+    readonly name: "--sidebar-primary-foreground";
+    readonly dark: "var(--primary-foreground)";
+    readonly light: "var(--primary-foreground)";
+}, {
+    readonly name: "--sidebar-accent";
+    readonly dark: "var(--secondary)";
+    readonly light: "var(--secondary)";
+}, {
+    readonly name: "--sidebar-accent-foreground";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--sidebar-border";
+    readonly dark: "var(--border)";
+    readonly light: "var(--border)";
+}, {
+    readonly name: "--sidebar-ring";
+    readonly dark: "var(--ring)";
+    readonly light: "var(--ring)";
+}, {
+    readonly name: "--theme-color-primary";
+    readonly dark: "var(--primary)";
+    readonly light: "var(--primary)";
+}, {
+    readonly name: "--theme-color-warn";
+    readonly dark: "var(--warning)";
+    readonly light: "var(--warning)";
+}, {
+    readonly name: "--theme-color-error";
+    readonly dark: "var(--destructive)";
+    readonly light: "var(--destructive)";
+}, {
+    readonly name: "--theme-color-success";
+    readonly dark: "var(--success)";
+    readonly light: "var(--success)";
+}, {
+    readonly name: "--theme-bg-base";
+    readonly dark: "var(--background)";
+    readonly light: "var(--background)";
+}, {
+    readonly name: "--theme-bg-second";
+    readonly dark: "var(--secondary)";
+    readonly light: "var(--secondary)";
+}, {
+    readonly name: "--theme-bg-third";
+    readonly dark: "var(--muted)";
+    readonly light: "var(--muted)";
+}, {
+    readonly name: "--theme-color-base";
+    readonly dark: "var(--foreground)";
+    readonly light: "var(--foreground)";
+}, {
+    readonly name: "--theme-border-base";
+    readonly dark: "var(--border)";
+    readonly light: "var(--border)";
+}, {
+    readonly name: "--theme-box-shadow-base";
+    readonly dark: "0 1px 2px 0 rgba(255, 255, 255, 0.03),0 1px 6px -1px rgba(255, 255, 255, 0.02),0 2px 4px 0 rgba(255, 255, 255, 0.02)";
+    readonly light: "0 1px 2px 0 rgba(0, 0, 0, 0.03),0 1px 6px -1px rgba(0, 0, 0, 0.02),0 2px 4px 0 rgba(0, 0, 0, 0.02)";
+}];

package/theme/style-scope.d.ts

@@ -0,0 +1,21 @@
+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 '--theme-border-radius-base': "var(--radius-surface)";
+    readonly '--size-border-radius-second': "var(--radius-control)";
+};
+export declare const applyChartsScopeRoot: (element: HTMLElement) => void;
+export declare const ensureChartsPortalRoot: (slot: string) => HTMLDivElement;

package/types/store/ui.d.ts

@@ -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,6 +3,7 @@
  */
 import type { TimestampedFloat32Array } from '@rfkit/spectrum-analyzer';
 export * from './array';
+export * from './cursor';
 export * from './frequency';
 export * from './frequencyCalculation';
 export * from './object';

package/utils/subscription.d.ts

@@ -23,6 +23,7 @@ interface ChartSubscriptions {
     [id: string]: Subscription;
 }
 export declare function createSubscriptionManager(id: string, name?: string, func?: CSMCallback): (...args: any[]) => void;
+export declare function clearChartRuntimeScopes(scopes: Array<string | undefined>): void;
 export interface rawData {
     getAllRawData: (left?: number) => SpectrumOutputData;
 }

package/utils/theme.d.ts

@@ -9,10 +9,10 @@ export interface ThemeFillStyle {
 /**
  * 获取主题填充样式
  */
-export declare function getThemeFillStyle(): ThemeFillStyle;
+export declare function getThemeFillStyle(scopeTarget?: Element | null): ThemeFillStyle;
 /**
  * 获取主题颜色，支持透明度改变
  * @param property CSS 变量名
  * @param opacity 可选的透明度 (0-1)
  */
-export declare const getThemeColor: (property: string, opacity?: number) => string;
+export declare const getThemeColor: (property: string, opacity?: number, scopeTarget?: Element | null) => string;

package/components/FrequencyAllocation/SegmentContainer.d.ts

@@ -1,12 +0,0 @@
-import type React from 'react';
-import type { FrequencyAllocationItem } from '../../types';
-import type { BandPosition, FrequencyRange } from './types';
-interface SegmentContainerProps {
-    style: React.CSSProperties;
-    bandPositions: BandPosition[];
-    onMouseEnter: (band: FrequencyAllocationItem, range: FrequencyRange) => (e: React.MouseEvent) => void;
-    onMouseMove: (e: React.MouseEvent) => void;
-    onMouseLeave: () => void;
-}
-declare const SegmentContainer: React.FC<SegmentContainerProps>;
-export default SegmentContainer;

package/components/FrequencyAllocation/Tooltip/index.d.ts

@@ -1,8 +0,0 @@
-import type React from 'react';
-import type { TooltipState } from '../types';
-/**
- * 频率划分 Tooltip 组件
- * 包含定位逻辑，内部使用 AllocationInfo 展示内容
- */
-declare const Tooltip: React.FC<TooltipState>;
-export default Tooltip;