@rfkit/charts 1.3.13 → 1.4.1

package/modules/Gauge/render.d.ts

@@ -21,11 +21,9 @@ interface GaugeRenderState extends BaseRenderState<Gauge> {
  * 不完全继承 CircularRenderer，而是直接继承 BaseRenderer
  */
 export default class GaugeRender extends BaseRenderer<Gauge, GaugeRenderState, GaugeData> {
-    private themeUnsubscribe;
     constructor(props: GaugeRenderProps);
     protected init(): void;
     updateProps(p: Record<string, unknown>): void;
     updateSeries(data: GaugeData): void;
-    destroy(): void;
 }
 export {};

package/{components/HeatmapCapture → modules/Heatmap/Capture}/tools.d.ts

@@ -1,4 +1,4 @@
-import type { AxisXProps, HeatmapAreaData, HeatmapCaptureProps } from '../../types';
+import type { AxisXProps, HeatmapAreaData, HeatmapCaptureProps } from '../../../types';
 interface Coordinates {
     startLeft: number;
     endLeft: number;

package/modules/Heatmap/CursorPopover.d.ts

@@ -0,0 +1,6 @@
+import type React from 'react';
+interface HeatmapCursorPopoverProps {
+    id: string;
+}
+declare const HeatmapCursorPopover: React.FC<HeatmapCursorPopoverProps>;
+export default HeatmapCursorPopover;

package/modules/Heatmap/render.d.ts

@@ -14,9 +14,11 @@ interface HeatmapRenderState extends GradientRenderState<IHeatmap> {
     heatmapDefaultData: number[][];
 }
 export default class Heatmap extends GradientRenderer<IHeatmap, HeatmapRenderState, number[][]> {
+    private lastSeriesData;
     constructor(props: HeatmapRenderProps);
     protected init(): void;
     updateSeries(data: number[][]): void;
+    updateParams(params: Partial<HeatmapRenderState>): void;
     setRange(realRange?: [number, number]): void;
     reset(): void;
     resize(): void;

package/modules/Level/CursorPopover.d.ts

@@ -0,0 +1,6 @@
+import type React from 'react';
+interface LevelCursorPopoverProps {
+    id: string;
+}
+declare const LevelCursorPopover: React.FC<LevelCursorPopoverProps>;
+export default LevelCursorPopover;

package/modules/Occupancy/CursorPopover.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+declare const OccupancyCursorPopover: React.FC;
+export default OccupancyCursorPopover;

package/modules/Occupancy/TotalLine/index.d.ts

@@ -1,6 +1,6 @@
 import type React from 'react';
 interface Props {
-    value?: number;
+    id: string;
 }
 declare const TotalLine: React.FC<Props>;
 export default TotalLine;

package/modules/Occupancy/total-line-runtime.d.ts

@@ -0,0 +1,4 @@
+export declare const TOTAL_LINE_HIDDEN_OFFSET = -200;
+export declare const applyOccupancyTotalLineValue: (lineElement: HTMLDivElement | null, valueElement: HTMLDivElement | null, value?: number) => void;
+export declare const withOccupancyTotalLine: (id: string, name?: string, func?: (value: number) => void) => (...args: any[]) => void;
+export declare const publishOccupancyTotalLine: (id: string, value?: number) => void;

package/modules/Spectrum/AxisYCanvas/index.d.ts

@@ -0,0 +1,6 @@
+import type { RenderChartType } from '../../../types';
+interface AxisYCanvasProps {
+    chart: RenderChartType;
+}
+export default function AxisYCanvas(props: AxisYCanvasProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/{components/AxisYByCanvas → modules/Spectrum/AxisYCanvas}/useCanvasAxisY.d.ts

@@ -1,6 +1,6 @@
-import type Range from '../AxisY/spectrum/useRanging/ranging';
+import type { RangeController } from '../../../components/AxisY/spectrum/useRanging';
 interface CanvasAxisYOptions {
-    ranging?: Range;
+    ranging?: RangeController;
 }
 interface TickData {
     value: number;

package/modules/Spectrum/BandLayer/index.d.ts

@@ -0,0 +1,5 @@
+import type React from 'react';
+import useBandLayerController from './useBandLayerController';
+export { useBandLayerController };
+declare const BandLayer: React.FC;
+export default BandLayer;

package/modules/Spectrum/BandLayer/useBandLayerController.d.ts

@@ -0,0 +1,2 @@
+import type { BandProps } from '../../../types';
+export default function useBandLayerController(): (e: BandProps) => void;

package/{components → modules/Spectrum}/Blaze/tools.d.ts

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

package/modules/Spectrum/CursorPopover.d.ts

@@ -0,0 +1,6 @@
+import type React from 'react';
+interface SpectrumCursorPopoverProps {
+    id: string;
+}
+declare const SpectrumCursorPopover: React.FC<SpectrumCursorPopoverProps>;
+export default SpectrumCursorPopover;

package/{components → modules/Spectrum}/FrequencyAllocation/color.d.ts

@@ -1,4 +1,4 @@
-import type { FrequencyAllocationItem } from '../../types';
+import type { FrequencyAllocationItem } from '../../../types';
 export declare const optimizedColors: string[];
 export declare function hexToHsl(hex: string): {
     h: number;

package/{components → modules/Spectrum}/FrequencyAllocation/index.d.ts

@@ -1,6 +1,6 @@
 import type React from 'react';
-import AllocationInfo from './AllocationInfo';
+import { AllocationInfo } from './presenters';
+export { useAllocationFinder } from './model';
 export { AllocationInfo };
-export { useAllocationFinder } from './useAllocationFinder';
 declare const FrequencyAllocation: React.FC;
 export default FrequencyAllocation;

package/modules/Spectrum/FrequencyAllocation/model/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveFrequencyAllocationData } from './resolveFrequencyAllocationData';
+export { type FrequencyAllocationSegmentData, findFrequencyAllocationAtCursor, resolveFrequencyAllocationRange, resolveFrequencyAllocationSegments } from './resolver';
+export { useAllocationAtCursor, useAllocationFinder } from './useAllocationAtCursor';
+export { useFrequencyAllocationData } from './useFrequencyAllocationData';

package/modules/Spectrum/FrequencyAllocation/model/resolveFrequencyAllocationData.d.ts

@@ -0,0 +1,2 @@
+import type { FrequencyAllocationItem } from '../../../../types';
+export declare function resolveFrequencyAllocationData(data?: FrequencyAllocationItem[]): FrequencyAllocationItem[];

package/modules/Spectrum/FrequencyAllocation/model/resolver.d.ts

@@ -0,0 +1,18 @@
+import type { CSSProperties } from 'react';
+import type { FrequencyAllocationItem, SegmentType } from '../../../../types';
+import type { BandPosition, FrequencyRange } from '../types';
+export interface FrequencyAllocationSegmentData {
+    segment: SegmentType;
+    segmentIndex: number;
+    bandPositions: BandPosition[];
+    style: CSSProperties;
+}
+export declare const resolveFrequencyAllocationRange: (band: FrequencyAllocationItem) => FrequencyRange | null;
+export declare const resolveFrequencyAllocationSegments: ({ segments, allocations }: {
+    segments: SegmentType[];
+    allocations: FrequencyAllocationItem[];
+}) => FrequencyAllocationSegmentData[];
+export declare const findFrequencyAllocationAtCursor: ({ allocations, frequency }: {
+    allocations: FrequencyAllocationItem[];
+    frequency: number;
+}) => FrequencyAllocationItem | undefined;

package/modules/Spectrum/FrequencyAllocation/model/useAllocationAtCursor.d.ts

@@ -0,0 +1,6 @@
+interface UseAllocationFinderProps {
+    frequency: string;
+}
+export declare function useAllocationAtCursor({ frequency }: UseAllocationFinderProps): import("../../../..").FrequencyAllocationItem;
+export declare const useAllocationFinder: typeof useAllocationAtCursor;
+export {};

package/modules/Spectrum/FrequencyAllocation/model/useFrequencyAllocationData.d.ts

@@ -0,0 +1 @@
+export declare function useFrequencyAllocationData(): import("../../../..").FrequencyAllocationItem[];

package/modules/Spectrum/FrequencyAllocation/overlays/Tooltip/index.d.ts

@@ -0,0 +1,4 @@
+import type React from 'react';
+import type { TooltipState } from '../../types';
+declare const Tooltip: React.FC<TooltipState>;
+export default Tooltip;

package/modules/Spectrum/FrequencyAllocation/overlays/index.d.ts

@@ -0,0 +1 @@
+export { default as AllocationTooltip } from './Tooltip';

package/{components/FrequencyAllocation → modules/Spectrum/FrequencyAllocation/presenters}/AllocationInfo/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { FrequencyAllocationItem } from '../../../types';
+import type { FrequencyAllocationItem } from '../../../../../types';
 interface Props {
     allocationInfo?: FrequencyAllocationItem & {
         startFrequency?: string | number;

package/modules/Spectrum/FrequencyAllocation/presenters/AllocationSegments/index.d.ts

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

package/modules/Spectrum/FrequencyAllocation/presenters/index.d.ts

@@ -0,0 +1,2 @@
+export { default as AllocationInfo } from './AllocationInfo';
+export { default as AllocationSegments } from './AllocationSegments';

package/{components → modules/Spectrum}/FrequencyAllocation/tools.d.ts

@@ -1,4 +1,4 @@
-import type { FrequencyAllocationItem } from '../../types';
+import type { FrequencyAllocationItem } from '../../../types';
 /**
  * 从本地缓存读取FrequencyAllocation数据
  * @returns FrequencyAllocationItem数组或null

package/{components → modules/Spectrum}/FrequencyAllocation/types.d.ts

@@ -1,4 +1,4 @@
-import type { FrequencyAllocationItem } from '../../types';
+import type { FrequencyAllocationItem } from '../../../types';
 export interface TooltipState extends FrequencyAllocationItem {
     visible: boolean;
     x: number;

package/modules/Spectrum/FrequencyDataBoard/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useStationFinder, useStationInfoAtCursor } from './useStationInfoAtCursor';

package/modules/Spectrum/FrequencyDataBoard/hooks/useStationInfoAtCursor.d.ts

@@ -0,0 +1 @@
+export { useStationFinder, useStationInfoAtCursor } from '../../Signal/model';

package/{components → modules/Spectrum}/FrequencyDataBoard/index.d.ts

@@ -6,6 +6,7 @@ interface Props {
         frequency: string;
     }) => void;
     updateKey?: number;
+    showStationInfo?: boolean;
 }
 declare const _default: React.NamedExoticComponent<Props>;
 export default _default;

package/{components/FrequencyDataBoard/StationInfo → modules/Spectrum/FrequencyDataBoard/panels/StationInfoPanel}/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { StationInfoType } from '../../../types';
+import type { StationInfoType } from '../../../../../types';
 interface Props {
     stationInfo?: StationInfoType;
 }

package/modules/Spectrum/FrequencyDataBoard/panels/index.d.ts

@@ -0,0 +1 @@
+export { default as StationInfoPanel } from './StationInfoPanel';

package/{components → modules/Spectrum}/FrequencyTagLine/index.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
-import { ToolType } from '../../config';
+import { ToolType } from '../../../config';
 import FrequencyTagLineBoard from './Board';
 import FrequencyTagLineSwitch from './Switch';
-export { FrequencyTagLineSwitch, FrequencyTagLineBoard };
+export { FrequencyTagLineBoard, FrequencyTagLineSwitch };
 export declare const COMPONENT_KEY = ToolType.FrequencyTagLine;
 interface Props {
     id: string;

package/{components → modules/Spectrum}/Markers/MarkerItem/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { MarkerType } from '../../../types';
+import type { MarkerType } from '../../../../types';
 interface Props {
     marker: MarkerType;
 }

package/{components → modules/Spectrum}/Markers/hooks/useMarkerEvents.d.ts

@@ -1,4 +1,4 @@
-import type { MarkerType, TopRightBottomLeft } from '../../../types';
+import type { MarkerType, TopRightBottomLeft } from '../../../../types';
 interface UseMarkerEventsProps {
     id: string;
     markers: MarkerType[];

package/{components → modules/Spectrum}/Markers/hooks/useMarkers.d.ts

@@ -15,8 +15,8 @@
  * - realData.peaks.peaks[1] = 次峰
  * - realData.peaks.peaks[n] = 第 n+1 峰（可扩展）
  */
-import { MarkerEventType } from '../../../config';
-import type { MarkerType, SetMarker } from '../../../types';
+import { MarkerEventType } from '../../../../config';
+import type { MarkerType, SetMarker } from '../../../../types';
 interface UseMarkersProps {
     id: string;
     globalID: string;

package/{components → modules/Spectrum}/Markers/tools.d.ts

@@ -1,4 +1,4 @@
-import type { MarkerType, RecursiveFunction, SegmentsType } from '../../types';
+import type { MarkerType, RecursiveFunction, SegmentsType } from '../../../types';
 /**
  * Marker 工具函数集合 - 精简版
  */

package/{components → modules/Spectrum}/Scope/useScope.d.ts

@@ -1,2 +1,2 @@
-import type { RecursiveObject } from '../../types';
+import type { RecursiveObject } from '../../../types';
 export default function useScope(): (e: RecursiveObject) => void;

package/{components → modules/Spectrum}/Signal/index.d.ts

@@ -1,7 +1,8 @@
 import type React from 'react';
 import SignalSwitch from './Switch';
+export { useStationFinder } from './model';
+export { useSignalDataManager } from './useSignalDataManager';
 export { SignalSwitch };
-export { useStationFinder } from './useStationFinder';
 interface Props {
     left?: number;
     show?: boolean;

package/modules/Spectrum/Signal/metadata/index.d.ts

@@ -0,0 +1 @@
+export { SIGNAL_TYPE_MAP, SignalType, signalTypeMap } from './signalType';

package/modules/Spectrum/Signal/model/index.d.ts

@@ -0,0 +1,3 @@
+export { findStationAtCursor, resolveSignalMatchCandidates, resolveSignalPositions, resolveSignalSegments, type SignalPosition, type SignalSegmentData } from './resolver';
+export { useStationFinder, useStationInfoAtCursor } from './useStationInfoAtCursor';
+export { useUnifiedSignals } from './useUnifiedSignals';

package/modules/Spectrum/Signal/model/resolver.d.ts

@@ -0,0 +1,40 @@
+import type { CSSProperties } from 'react';
+import type { SegmentType, StationInfoType } from '../../../../types';
+import { type SignalMatchCandidate, type UnifiedSignalItem } from '../utils';
+export interface SignalPosition extends SignalMatchCandidate {
+    key: string;
+    position: {
+        left: string;
+        width: string;
+    };
+    color: string;
+    tooltip?: string;
+}
+export interface SignalSegmentData {
+    segment: SegmentType;
+    segmentIndex: number;
+    signalPositions: SignalPosition[];
+    activeSignalKey?: string;
+    style: CSSProperties;
+}
+export declare const resolveSignalMatchCandidates: (signalItems: UnifiedSignalItem[], segment: SegmentType) => SignalMatchCandidate[];
+export declare const resolveSignalPositions: (signalItems: UnifiedSignalItem[], segment: SegmentType) => SignalPosition[];
+export declare const resolveSignalSegments: ({ segments, signalItems, isCursorActive, currentFrequency, currentPosition }: {
+    segments: SegmentType[];
+    signalItems: UnifiedSignalItem[];
+    isCursorActive: boolean;
+    currentFrequency: number;
+    currentPosition: {
+        segmentIndex: number;
+        pointIndex: number;
+    };
+}) => SignalSegmentData[];
+export declare const findStationAtCursor: ({ frequency, signalItems, segments, currentPosition }: {
+    frequency: number;
+    signalItems: UnifiedSignalItem[];
+    segments: SegmentType[];
+    currentPosition: {
+        segmentIndex: number;
+        pointIndex: number;
+    };
+}) => StationInfoType | undefined;

package/modules/Spectrum/Signal/model/useStationInfoAtCursor.d.ts

@@ -0,0 +1,7 @@
+interface UseStationFinderProps {
+    frequency: string;
+    enabled?: boolean;
+}
+export declare function useStationInfoAtCursor({ frequency, enabled }: UseStationFinderProps): import("../../../..").StationInfoType;
+export declare const useStationFinder: typeof useStationInfoAtCursor;
+export {};

package/modules/Spectrum/Signal/model/useUnifiedSignals.d.ts

@@ -0,0 +1,6 @@
+import type { UnifiedSignalItem } from '../utils';
+interface UseUnifiedSignalsOptions {
+    respectVisibility?: boolean;
+}
+export declare function useUnifiedSignals({ respectVisibility }?: UseUnifiedSignalsOptions): UnifiedSignalItem[];
+export {};

package/modules/Spectrum/Signal/presenters/SignalSegments/index.d.ts

@@ -0,0 +1,10 @@
+import type React from 'react';
+import type { SignalPosition } from '../../model';
+interface SignalSegmentsProps {
+    style: React.CSSProperties;
+    signalPositions: SignalPosition[];
+    activeSignalKey?: string;
+    segmentIndex: number;
+}
+declare const SignalSegments: React.FC<SignalSegmentsProps>;
+export default SignalSegments;

package/modules/Spectrum/Signal/presenters/index.d.ts

@@ -0,0 +1 @@
+export { default as SignalSegments } from './SignalSegments';

package/{components → modules/Spectrum}/Signal/tools.d.ts

@@ -1,4 +1,4 @@
-import type { RecursiveFunction, StationInfoType } from '../../types';
+import type { RecursiveFunction, StationInfoType } from '../../../types';
 /**
  * 台站数据更新订阅管理器
  * 用于通知组件台站数据已更新，触发重新渲染

package/{components → modules/Spectrum}/Signal/useSignalDataManager.d.ts

@@ -1,4 +1,4 @@
-import type { SignalData, SignalDataType, StationInfoType } from '../../types';
+import type { SignalData, SignalDataType, StationInfoType } from '../../../types';
 /**
  * Signal 数据管理 Hook
  * - 台站信息 → 全局 openData（通过 STATION_DATA）

package/modules/Spectrum/Signal/utils.d.ts

@@ -0,0 +1,27 @@
+import type { StationInfoType } from '../../../types';
+import type { SignalData } from '../../../types/store';
+import type { FrequencyRange, FrequencyRangeInput } from '../../../utils';
+/**
+ * 统一的信号数据类型（兼容 StationInfo 和 SignalData）
+ */
+export type UnifiedSignalItem = StationInfoType | SignalData;
+export interface SignalMatchCandidate {
+    item: UnifiedSignalItem;
+    range: FrequencyRange;
+    startIndex: number;
+    stopIndex: number;
+}
+/**
+ * 判断是否为完整的台站信息
+ */
+export declare function isStationInfo(item: UnifiedSignalItem): item is StationInfoType;
+export declare function getUnifiedSignalKey(item: UnifiedSignalItem): string;
+/**
+ * 将统一的信号数据转换为频率范围输入（处理 string | number 类型）
+ */
+export declare function toFrequencyRangeInput(item: UnifiedSignalItem): FrequencyRangeInput;
+export declare function resolveBestSignalMatch<T extends SignalMatchCandidate>(candidates: T[], options: {
+    currentFrequency: number;
+    currentPointIndex: number;
+    indexTolerance?: number;
+}): T | undefined;

package/modules/Spectrum/render.d.ts

@@ -1,69 +1,48 @@
 import { type ISeries } from '@rfkit/renderer';
-import type { SeriesConfig } from '../../types';
-interface SpectrumState {
-    chart: ISeries | null;
+import { BaseRenderer, type BaseRenderState } from '../base/BaseRenderer';
+import type { AxisYRange, SeriesConfig, SpectrumExtraData } from '../../types';
+interface SpectrumChart extends ISeries {
+    clear(): void;
+    dispose(): void;
+    draw(): void;
+    render(config: {
+        data: Float32Array;
+        name: string;
+    } & Partial<SeriesConfig>): void;
+    resize(): void;
+    setIntervel(interval: number): void;
+    setRange(range: AxisYRange): void;
+    setSeries(config: Partial<SeriesConfig> & {
+        name: string;
+    }): void;
+    updateProps(props: Record<string, unknown>): void;
+}
+interface SpectrumState extends BaseRenderState<SpectrumChart> {
     autoranging: boolean;
-    prevAutoRangeTime: number;
-    id: string;
-    renderRange: [number, number];
+    globalID: string;
     interval: number;
+    prevAutoRangeTime: number;
+    renderRange: AxisYRange;
     series: Record<string, SeriesConfig>;
-    globalID: string;
-    [key: string]: unknown;
 }
-export default class Spectrum {
-    state: SpectrumState;
+export interface SpectrumRenderPayload {
+    data: Record<string | number, Float32Array>;
+    extraData?: SpectrumExtraData;
+}
+export default class Spectrum extends BaseRenderer<SpectrumChart, SpectrumState, SpectrumRenderPayload> {
     useRangeAutoFocus: () => void;
-    useRangeSet: () => void;
     firstRenderAutoFocus: boolean;
-    seriesUnsubscribe?: () => void;
     constructor(props: Record<string, unknown>);
-    /**
-     * 初始化 series 订阅机制
-     */
-    initSeriesSubscription(): void;
-    init(): void;
+    protected init(): void;
     initSeries(): void;
-    /**
-     * 更新数据
-     * TODO:可以自定义线
-     */
-    updateSeries(d: Record<string | number, Float32Array>, extraData?: Map<string, {
-        outputData: Float32Array;
-        originalData: Float32Array;
-    }>): void;
-    updateMainSeries(data: {
-        length: number;
-        at: (arg0: number) => number | undefined;
-    }): void;
-    /**
-     * 更新参数
-     */
-    updateParams(params: Record<string, unknown>): void;
-    /**
-     * 设置线信息
-     */
+    updateSeries({ data, extraData }: SpectrumRenderPayload): void;
+    private updateMainSeries;
     setSeries(config: SeriesConfig, skipEventEmit?: boolean): void;
     setDisabledClearRect(disabledClearRect: boolean): void;
-    setRange(renderRange?: [number, number]): void;
+    setRange(renderRange?: AxisYRange): void;
     zoom(): void;
     reset(): void;
     resize(): void;
-    /**
-     * 清除图表内容（不取消订阅）
-     */
     clearChart(): void;
-    /**
-     * 销毁实例（取消订阅）
-     */
-    destroy(): void;
-    /**
-     * 组件卸载时的清理（useChart 会调用此方法）
-     */
-    dispose(): () => void;
-    /**
-     * @deprecated 使用 clearChart() 或 destroy()
-     */
-    clear(): void;
 }
 export {};

package/{hooks → modules/Spectrum}/useSpectrumAnalyzer/index.d.ts

@@ -1,3 +1,3 @@
 import { type SpectrumConfig } from '@rfkit/spectrum-analyzer';
-import type { PublishData } from '../../types';
+import type { PublishData } from '../../../types';
 export default function useSpectrumAnalyzer(props?: SpectrumConfig): (e: PublishData) => Promise<void>;

package/modules/base/BaseRenderer.d.ts

@@ -30,7 +30,9 @@ interface ChartLike {
     clear?: () => void;
     draw?: () => void;
     updateProps?: (props: Record<string, unknown>) => void;
+    dispose?: () => void;
 }
+type RendererCleanup = () => void;
 /**
  * 渲染器抽象基类
  *
@@ -42,6 +44,9 @@ export declare abstract class BaseRenderer<TChart extends ChartLike, TState exte
     /** 公开 state 以兼容 RenderChartType 接口 */
     state: TState;
     protected resizeTimer: ReturnType<typeof setTimeout> | null;
+    protected resizeObserver: ResizeObserver | null;
+    private destroyed;
+    private cleanupTasks;
     constructor(initialState: TState);
     /**
      * 初始化图表引擎（子类必须实现）
@@ -51,6 +56,14 @@ export declare abstract class BaseRenderer<TChart extends ChartLike, TState exte
      * 更新数据（子类必须实现）
      */
     abstract updateSeries(data: TData): void;
+    /**
+     * 更新运行时参数
+     */
+    updateParams(params: Partial<TState>): void;
+    /**
+     * 参数更新后的钩子，为子类提供 hook
+     */
+    protected onParamsUpdated(_params: Partial<TState>): void;
     /**
      * 重置（清空 + 调整大小）
      */
@@ -79,5 +92,55 @@ export declare abstract class BaseRenderer<TChart extends ChartLike, TState exte
      * 清理 resize 定时器
      */
     protected clearResizeTimer(): void;
+    /**
+     * 注册统一 cleanup，由基类在 destroy 时回收
+     */
+    protected trackCleanup(cleanup?: RendererCleanup | null): () => void;
+    /**
+     * 获取图表容器元素
+     */
+    protected getContainerElement(): HTMLElement | null;
+    /**
+     * 获取图表容器当前尺寸
+     */
+    protected getContainerSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * 子类可覆盖最小可绘制尺寸
+     */
+    protected getMinimumContainerSize(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * 当前容器尺寸是否足以安全触发 renderer 绘制
+     */
+    protected hasRenderableContainerSize(): boolean;
+    /**
+     * 监听图表容器尺寸，避免只靠初始化阶段的一次性 resize
+     */
+    protected observeContainerResize(): void;
+    /**
+     * 清理容器尺寸监听
+     */
+    protected clearResizeObserver(): void;
+    /**
+     * 清理统一注册的 cleanup 任务
+     */
+    protected runCleanupTasks(): void;
+    /**
+     * 销毁前钩子，子类可覆盖
+     */
+    protected beforeDestroy(): void;
+    /**
+     * 释放底层 chart 实例，避免 renderer 引擎残留监听和 canvas/WebGL 资源
+     */
+    protected disposeChartInstance(): void;
+    /**
+     * 在容器尺寸满足条件后再初始化 chart，避免 renderer 在错误尺寸下提前绘制
+     */
+    protected initializeChartWhenReady(): void;
 }
 export {};