@rfkit/charts 1.4.0 → 1.4.2

package/hooks/useModuleSubscription.d.ts

@@ -1,15 +1,6 @@
 import type { ModuleType } from '../config';
 import type { PublishData } from '../types';
-/**
- * 模块订阅所需的图表接口（最小化）
- */
-interface ChartSubscriptionInterface<TData = unknown> {
-    updateSeries?(data: TData): void;
-    reset(): void;
-    resize(): void;
-}
-type DataExtractor<TData> = (d: PublishData) => TData;
-type CustomHandler = (d: PublishData) => boolean | undefined;
+import { type ChartSubscriptionInterface, type DataExtractor, type ModuleEventHandler, type ModulePublishType } from './module-subscription-core';
 interface UseModuleSubscriptionOptions<TData = unknown> {
     /**
      * 模块类型
@@ -22,11 +13,23 @@ interface UseModuleSubscriptionOptions<TData = unknown> {
     /**
      * 从 PublishData 中提取数据（默认直接传递整个 d）
      */
-    extractData?: DataExtractor<TData>;
+    extractData?: DataExtractor<TData, PublishData>;
+    /**
+     * 显式声明哪些 pstype 视作当前模块的渲染主路径
+     */
+    renderPSTypes?: ModulePublishType[];
+    /**
+     * 当事件没有 pstype 时，是否也视为 render 事件
+     */
+    treatMissingPSTypeAsRender?: boolean;
+    /**
+     * 自定义 render 处理逻辑；未提供时走 updateSeries + extractData 默认链路
+     */
+    handleRender?: ModuleEventHandler<TData, PublishData>;
     /**
-     * 自定义处理器（返回 true 表示已处理，跳过默认逻辑）
+     * 事件级处理器，优先级高于默认 Render/Reset/Resize 行为
      */
-    customHandler?: CustomHandler;
+    eventHandlers?: Partial<Record<ModulePublishType, ModuleEventHandler<TData, PublishData>>>;
 }
 /**
  * 模块订阅 Hook
@@ -49,18 +52,13 @@ interface UseModuleSubscriptionOptions<TData = unknown> {
  * });
  *
  * @example
- * // 自定义处理
+ * // 自定义 render 类型或事件处理
  * useModuleSubscription({
- *   moduleType: ModuleType.Heatmap,
+ *   moduleType: ModuleType.Gauge,
  *   chart,
- *   customHandler: (d) => {
- *     if (d.pstype === PSType.Option) {
- *       // 自定义处理
- *       return true; // 已处理
- *     }
- *     return false; // 继续默认处理
- *   }
+ *   renderPSTypes: [PSType.Gauge],
+ *   treatMissingPSTypeAsRender: true
  * });
  */
-export declare function useModuleSubscription<TData = unknown>({ moduleType, chart, extractData, customHandler }: UseModuleSubscriptionOptions<TData>): void;
+export declare function useModuleSubscription<TData = unknown>({ moduleType, chart, extractData, renderPSTypes, treatMissingPSTypeAsRender, handleRender, eventHandlers }: UseModuleSubscriptionOptions<TData>): void;
 export default useModuleSubscription;

package/index.d.ts

@@ -1,11 +1,11 @@
 import './theme/library.css';
-export { setFrequencyAllocationToCache } from './components/FrequencyAllocation/tools';
-export { ChartType, FrequencyUnit, MarkerEventType, ModuleType, OptionKey, PSType, SegmentsEvent, SeriesType, ToolsBarItemType, ToolType } from './config';
+export { Dial, Gauge, Heatmap, IQ, LevelStream, Occupancy, Spectrum } from './charts';
+export { ChartType, FrequencyUnit, MarkerEventType, ModuleType, OptionKey, PSType, SegmentsEvent, SeriesType, ToolbarItemType, ToolType } from './config';
 export { type EnhancedPublish, useSafePublish, withChartPublisher } from './hooks';
-export { Dial, Gauge, Heatmap, IQ, LevelStream, Occupancy, Spectrum } from './lib';
-export { applyChartsTheme, applyChartsThemePreference, type ChartsThemePreference, type ChartsThemeState, getChartsThemePreference, getChartsThemeState, subscribeChartsThemeChange } from './theme/charts-theme-controller';
+export { setFrequencyAllocationToCache } from './modules/Spectrum/FrequencyAllocation/tools';
 export { type ChartsThemeChange, type InitChartsThemeOptions, type InitChartsThemeResult, initChartsTheme } from './theme/init-charts-theme';
-export { RFKIT_CHARTS_SHADCN_THEME_CONFIGS } from './theme/shadcn-theme-config';
+export { type ChartsThemePreference, type ChartsThemeState, getChartsThemeState, subscribeChartsThemeChange } from './theme/theme-runtime';
+export type { ChartsSizeTokensConfig, ChartsThemeTokensConfig } from './theme/theme-tokens';
 export type { AxisXProps, AxisYRange, ChartRef, FrequencyAllocationItem, MarkerProps, MarkerType, Publish, PublishData, PublishDial, PublishGauge, PublishHeatmap, PublishIQ, PublishLevelStream, PublishOccupancy, PublishSpectrum, RecursiveFunction, // 递归方法 后期会删除
 RecursiveObject, // 递归对象 后期会删除
 Render, Reset, SegmentsOriginal, SeriesConfig, SetAntennaFactor, SetChannels, SetMarker, SetSegments, SetSeries, SetSpectrumBandwidth, SpectrumBandwidth, SpectrumExtraData, StationInfoType } from './types';