@363045841yyt/klinechart 0.7.1 → 0.7.3-alpha.1

package/dist/src/plugin/PluginHost.d.ts

@@ -1,57 +0,0 @@
-import { Plugin, PluginConfig, PluginHost, PluginState, BaseIndicatorState, PluginLogger, HookCallOptions } from './types';
-export declare class PluginHostImpl implements PluginHost {
-    private registry;
-    private eventBus;
-    private hookSystem;
-    private configManager;
-    private stateStore;
-    private services;
-    private isDestroyed;
-    private logger;
-    constructor(logger?: PluginLogger);
-    readonly events: {
-        on: <T = unknown>(event: string, handler: (data: T) => void) => void;
-        off: <T = unknown>(event: string, handler: (data: T) => void) => void;
-        emit: <T = unknown>(event: string, data: T) => void;
-        once: <T = unknown>(event: string, handler: (data: T) => void) => void;
-    };
-    readonly hooks: {
-        tap: <T = unknown, R = unknown>(hookName: string, fn: (context: T) => R | Promise<R>, priority?: number) => void;
-        untap: (hookName: string, fn: (context: unknown) => unknown) => void;
-        call: <T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions) => Promise<R[]>;
-        callSync: <T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions) => R[];
-    };
-    getConfig<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
-    setConfig(pluginName: string, key: string, value: unknown): void;
-    getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
-    log(level: 'info' | 'warn' | 'error', message: string, ...args: unknown[]): void;
-    setSharedState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
-    getSharedState<T extends BaseIndicatorState>(namespace: string): T | undefined;
-    clearSharedState(namespace: string): void;
-    registerStateOwner(ownerId: string, namespaces: string[]): void;
-    clearByOwner(ownerId: string): void;
-    registerService(name: string, service: unknown): void;
-    getService<T = unknown>(name: string): T | undefined;
-    /**
-     * 安装插件
-     */
-    use(plugin: Plugin, config?: PluginConfig): Promise<void>;
-    /**
-     * 移除插件
-     */
-    remove(name: string): Promise<void>;
-    /**
-     * 获取所有插件
-     */
-    getPlugins(): import('./types').PluginDescriptor[];
-    /**
-     * 获取插件状态
-     */
-    getState(name: string): PluginState | undefined;
-    /**
-     * 销毁宿主
-     */
-    destroy(): Promise<void>;
-    private ensureNotDestroyed;
-}
-export declare function createPluginHost(logger?: PluginLogger): PluginHostImpl;

package/dist/src/plugin/PluginRegistry.d.ts

@@ -1,40 +0,0 @@
-import { Plugin, PluginDescriptor, PluginState } from './types';
-export declare class PluginRegistry {
-    private plugins;
-    /**
-     * 注册插件
-     */
-    register(plugin: Plugin, config?: Record<string, unknown>): PluginDescriptor;
-    /**
-     * 注销插件
-     */
-    unregister(name: string): boolean;
-    /**
-     * 获取插件描述符
-     */
-    get(name: string): PluginDescriptor | undefined;
-    /**
-     * 获取插件实例
-     */
-    getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
-    /**
-     * 获取所有插件
-     */
-    getAll(): PluginDescriptor[];
-    /**
-     * 获取所有已启用的插件
-     */
-    getEnabled(): PluginDescriptor[];
-    /**
-     * 更新插件状态
-     */
-    updateState(name: string, state: PluginState, error?: Error): void;
-    /**
-     * 检查插件是否存在
-     */
-    has(name: string): boolean;
-    /**
-     * 清除所有插件
-     */
-    clear(): void;
-}

package/dist/src/plugin/StateStore.d.ts

@@ -1,37 +0,0 @@
-import { BaseIndicatorState } from './types';
-export declare class StateStore {
-    private states;
-    private ownerNamespaces;
-    /**
-     * 设置状态
-     * @param namespace 状态命名空间
-     * @param state 状态值
-     * @param ownerId 可选的拥有者 ID（用于冲突检测）
-     */
-    setState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
-    /**
-     * 获取状态
-     * @param namespace 状态命名空间
-     */
-    getState<T extends BaseIndicatorState>(namespace: string): T | undefined;
-    /**
-     * 清除指定命名空间的状态
-     * @param namespace 状态命名空间
-     */
-    clearState(namespace: string): void;
-    /**
-     * 注册状态拥有者
-     * @param ownerId 拥有者 ID（通常是渲染器名称）
-     * @param namespaces 声明的命名空间列表
-     */
-    registerStateOwner(ownerId: string, namespaces: string[]): void;
-    /**
-     * 按拥有者清除所有状态
-     * @param ownerId 拥有者 ID
-     */
-    clearByOwner(ownerId: string): void;
-    /**
-     * 清空所有状态
-     */
-    clear(): void;
-}

package/dist/src/plugin/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * 插件系统入口
- */
-export * from './types';
-export { PluginRegistry } from './PluginRegistry';
-export { PluginHostImpl, createPluginHost } from './PluginHost';
-export { EventBus } from './EventBus';
-export { HookSystem } from './HookSystem';
-export { ConfigManager } from './ConfigManager';
-export { RendererPluginManager } from './rendererPluginManager';
-export type { RendererErrorEvent } from './rendererPluginManager';

package/dist/src/plugin/rendererPluginManager.d.ts

@@ -1,77 +0,0 @@
-import { RendererPlugin, RenderContext, PaneInfo, RendererPluginWithHost, PluginHost } from './types';
-import { UpdateLevel } from '../core/layout/pane';
-/** 渲染器错误事件（裁剪后，不含大数据） */
-export interface RendererErrorEvent {
-    name: string;
-    error: {
-        message: string;
-        stack?: string;
-    };
-    paneId: string;
-    timestamp: number;
-}
-/**
- * 渲染器插件管理器
- *
- * 启用状态优先级：
- * 1. setEnabled() 运行时设置的状态（enabledState 中存在）
- * 2. 插件初始 enabled 字段
- * 3. 默认启用（enabled !== false）
- */
-export declare class RendererPluginManager {
-    private plugins;
-    private pluginHost;
-    private enabledState;
-    private groupCache;
-    private mergedCache;
-    private knownPaneIds;
-    private cacheInvalid;
-    private onInvalidate;
-    /** 设置重绘回调（由 Chart 注入） */
-    setInvalidateCallback(cb: () => void): void;
-    /** 设置 PluginHost（用于支持 RendererPluginWithHost） */
-    setPluginHost(host: PluginHost): void;
-    /** 添加已知的 paneId */
-    addKnownPaneId(paneId: string): void;
-    /** 移除 paneId */
-    removeKnownPaneId(paneId: string): void;
-    /** 覆盖已知 paneId 集合 */
-    setKnownPaneIds(paneIds: string[]): void;
-    /** 注册渲染器插件 */
-    register(plugin: RendererPlugin | RendererPluginWithHost): void;
-    /** 移除渲染器插件 */
-    unregister(name: string): void;
-    /** 清空所有插件 */
-    clear(): void;
-    /**
-     * 归并两个已排序数组 O(n)
-     * 优先级相同时，pane 专属渲染器（a）先于 global 渲染器（b）
-     */
-    private mergeSorted;
-    /** 重建缓存（统一管理所有缓存逻辑） */
-    private rebuildCache;
-    /** 判断渲染器是否启用 */
-    private isRendererEnabled;
-    /** 获取指定 pane 的合并渲染器（包含 system 渲染器） */
-    private getMergedRenderers;
-    /** 获取指定 pane 的渲染器（已缓存，无穿透） */
-    getRenderers(paneId: string): RendererPlugin[];
-    /** 渲染指定 pane（带错误隔离，支持按 UpdateLevel 过滤） */
-    render(paneId: string, context: RenderContext, level?: UpdateLevel): RendererErrorEvent[];
-    /** 渲染指定名称的插件（带错误隔离，用于系统渲染器） */
-    renderPlugin(name: string, context: RenderContext): RendererErrorEvent[];
-    /** 启用/禁用渲染器（修改独立状态，不影响原始插件对象） */
-    setEnabled(name: string, enabled: boolean): void;
-    /** 更新配置（自动触发重绘） */
-    updateConfig(name: string, config: Record<string, unknown>): boolean;
-    /** 获取所有渲染器插件 */
-    getAllPlugins(): RendererPlugin[];
-    /** 获取指定渲染器 */
-    getPlugin<T extends RendererPlugin = RendererPlugin>(name: string): T | undefined;
-    notifyDataUpdate(data: unknown[], range: {
-        start: number;
-        end: number;
-    }): void;
-    /** 通知尺寸变化 */
-    notifyResize(paneId: string, pane: PaneInfo): void;
-}

package/dist/src/plugin/stateKeys.d.ts

@@ -1,6 +0,0 @@
-/**
- * 状态命名空间工厂函数
- * 用于生成渲染器间共享状态的键名
- */
-/** 创建指标状态键 */
-export declare const createIndicatorStateKey: (type: string, paneId: string) => `indicator:${string}:${string}`;

package/dist/src/plugin/types.d.ts

@@ -1,445 +0,0 @@
-import { KLineData } from '../types/price';
-import { CandleWebGLSurface, LineWebGLSurface } from '../core/renderers/webgl/candleSurface';
-/** 插件生命周期状态 */
-export declare enum PluginState {
-    Registered = "registered",
-    Installed = "installed",
-    Error = "error"
-}
-/** 插件配置 */
-export interface PluginConfig {
-    enabled?: boolean;
-    priority?: number;
-    [key: string]: unknown;
-}
-/** 插件元信息 */
-export interface PluginMeta {
-    name: string;
-    version: string;
-    description?: string;
-    author?: string;
-}
-/** 插件接口 */
-export interface Plugin extends PluginMeta {
-    /** 安装插件 */
-    install(host: PluginHost, config?: Record<string, unknown>): void | Promise<void>;
-    /** 卸载插件 */
-    uninstall?(): void | Promise<void>;
-}
-/** 插件描述符（注册时使用） */
-export interface PluginDescriptor {
-    plugin: Plugin;
-    config?: PluginConfig;
-    state: PluginState;
-    error?: Error;
-}
-/** Hook 函数类型 */
-export type HookFn<T = unknown, R = unknown> = (context: T) => R | Promise<R>;
-/** Hook 调用选项 */
-export interface HookCallOptions {
-    throwOnError?: boolean;
-}
-/** Hook 描述符 */
-export interface HookDescriptor<T = unknown, R = unknown> {
-    name: string;
-    fn: HookFn<T, R>;
-    priority: number;
-}
-/** 事件处理器 */
-export type EventHandler<T = unknown> = (data: T) => void;
-/** 插件日志器 */
-export interface PluginLogger {
-    info(message?: unknown, ...optionalParams: unknown[]): void;
-    warn(message?: unknown, ...optionalParams: unknown[]): void;
-    error(message?: unknown, ...optionalParams: unknown[]): void;
-}
-/** 插件宿主接口（暴露给插件使用的 API） */
-export interface PluginHost {
-    /** 事件总线 */
-    readonly events: {
-        on<T = unknown>(event: string, handler: EventHandler<T>): void;
-        off<T = unknown>(event: string, handler: EventHandler<T>): void;
-        emit<T = unknown>(event: string, data: T): void;
-        once<T = unknown>(event: string, handler: EventHandler<T>): void;
-    };
-    /** Hook 系统 */
-    readonly hooks: {
-        tap<T = unknown, R = unknown>(hookName: string, fn: HookFn<T, R>, priority?: number): void;
-        untap(hookName: string, fn: HookFn): void;
-        call<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): Promise<R[]>;
-        callSync<T = unknown, R = unknown>(hookName: string, context: T, options?: HookCallOptions): R[];
-    };
-    /** 获取配置 */
-    getConfig<K = unknown>(pluginName: string, key: string, defaultValue?: K): K;
-    /** 设置配置 */
-    setConfig(pluginName: string, key: string, value: unknown): void;
-    /** 获取其他插件 */
-    getPlugin<T extends Plugin = Plugin>(name: string): T | undefined;
-    /** 日志工具 */
-    log(level: 'info' | 'warn' | 'error', message: string, ...args: unknown[]): void;
-    /** 设置共享状态 */
-    setSharedState<T extends BaseIndicatorState>(namespace: string, state: T, ownerId?: string): void;
-    /** 获取共享状态 */
-    getSharedState<T extends BaseIndicatorState>(namespace: string): T | undefined;
-    /** 清除共享状态 */
-    clearSharedState(namespace: string): void;
-    /** 注册状态拥有者 */
-    registerStateOwner(ownerId: string, namespaces: string[]): void;
-    /** 按拥有者清除状态 */
-    clearByOwner(ownerId: string): void;
-    /** 注册服务 */
-    registerService(name: string, service: unknown): void;
-    /** 获取已注册的服务 */
-    getService<T = unknown>(name: string): T | undefined;
-}
-/** Pane 角色 */
-export type PaneRole = 'price' | 'indicator' | 'auxiliary';
-/** Pane 能力开关 */
-export interface PaneCapabilities {
-    showPriceAxisTicks: boolean;
-    showCrosshairPriceLabel: boolean;
-    candleHitTest: boolean;
-    supportsPriceTranslate: boolean;
-}
-/** Pane 信息接口 */
-export interface PaneInfo {
-    id: string;
-    role: PaneRole;
-    capabilities: PaneCapabilities;
-    top: number;
-    height: number;
-    yAxis: {
-        priceToY(price: number): number;
-        yToPrice(y: number): number;
-        getPaddingTop(): number;
-        getPaddingBottom(): number;
-        getPriceOffset(): number;
-        getDisplayRange(baseRange?: {
-            maxPrice: number;
-            minPrice: number;
-        }): {
-            maxPrice: number;
-            minPrice: number;
-        };
-        getScaleType(): 'linear' | 'log';
-    };
-    priceRange: {
-        maxPrice: number;
-        minPrice: number;
-    };
-}
-/**
- * 创建 PaneInfo 的只读包装
- *
- * 设计决策：
- * - 使用 Readonly<T> 类型标注而非 Object.freeze，避免热路径上的运行时开销
- * - yAxis 方法通过闭包包装，隔离原始函数引用
- * - 依赖团队代码规范约束插件行为，而非运行时强制
- */
-export declare function wrapPaneInfo(pane: {
-    id: string;
-    role: PaneRole;
-    capabilities: PaneCapabilities;
-    top: number;
-    height: number;
-    yAxis: PaneInfo['yAxis'];
-    priceRange: PaneInfo['priceRange'];
-}): Readonly<PaneInfo>;
-/** Y轴标签（价格标签） */
-export interface YAxisLabel {
-    /** 关联的数据索引 */
-    dataIndex: number;
-    /** 价格值 */
-    price: number;
-    /** 标签在轴上的Y坐标（世界坐标，相对pane） */
-    y: number;
-    /** 标签类型，用于区分不同渲染外观 */
-    type?: 'lastPrice' | 'extrema' | 'anchor' | string;
-    /** 标签样式覆盖 */
-    style?: {
-        bgColor?: string;
-        borderColor?: string;
-        textColor?: string;
-    };
-}
-/** X轴标签（时间标签） */
-export interface XAxisLabel {
-    /** 关联的数据索引 */
-    dataIndex: number;
-    /** 时间戳（毫秒） */
-    timestamp: number;
-    /** 标签在轴上的X坐标（世界坐标，未减去scrollLeft） */
-    x: number;
-    /** 标签样式覆盖 */
-    style?: {
-        bgColor?: string;
-        textColor?: string;
-    };
-}
-/** Y轴范围带（半透明填充区域） */
-export interface YAxisRange {
-    /** 范围上界Y坐标（相对pane，canvas方向：小值=上方） */
-    topY: number;
-    /** 范围下界Y坐标（相对pane，canvas方向：大值=下方） */
-    bottomY: number;
-    /** 填充颜色（hex 或 rgba） */
-    color: string;
-    /** 填充不透明度 */
-    opacity: number;
-}
-/** X轴范围带（半透明填充区域） */
-export interface XAxisRange {
-    /** 范围左界X坐标（世界坐标，未减去scrollLeft） */
-    leftX: number;
-    /** 范围右界X坐标（世界坐标，未减去scrollLeft） */
-    rightX: number;
-    /** 填充颜色（hex 或 rgba） */
-    color: string;
-    /** 填充不透明度 */
-    opacity: number;
-}
-/** 渲染上下文 */
-/** MarkerManager 接口（用于 RenderContext） */
-export interface MarkerManagerLike {
-    getCustomMarkers(): unknown[];
-    setCustomMarkerPosition(id: string, x: number, y: number, size: number, shape: string): void;
-}
-export interface RenderContext {
-    ctx: CanvasRenderingContext2D;
-    pane: PaneInfo;
-    data: unknown[];
-    range: {
-        start: number;
-        end: number;
-    };
-    scrollLeft: number;
-    kWidth: number;
-    kGap: number;
-    dpr: number;
-    paneWidth: number;
-    kLinePositions: number[];
-    /** 每根K线柱中心的X坐标（物理像素对齐后，逻辑像素） */
-    kLineCenters: number[];
-    /** 每根K线对应柱的X/宽度（物理像素对齐后，逻辑像素），供柱状图使用 */
-    kBarRects: Array<{
-        x: number;
-        width: number;
-    }>;
-    markerManager?: MarkerManagerLike;
-    /** 十字线指向的 K 线索引（无十字线时为 null） */
-    crosshairIndex?: number | null;
-    yAxisCtx?: CanvasRenderingContext2D;
-    xAxisCtx?: CanvasRenderingContext2D;
-    borderCtx?: CanvasRenderingContext2D;
-    /** 覆盖层 Canvas 上下文（用于十字线、Tooltip 等动态内容） */
-    overlayCtx?: CanvasRenderingContext2D;
-    /** price pane 可选的 WebGL candle surface */
-    candleWebGLSurface?: CandleWebGLSurface;
-    /** line indicator 可选的 WebGL line surface */
-    lineWebGLSurface?: LineWebGLSurface;
-    /** 当前缩放级别（1 ~ zoomLevels） */
-    zoomLevel?: number;
-    /** 总缩放级别数 */
-    zoomLevelCount?: number;
-    viewport?: {
-        scrollLeft: number;
-        plotWidth: number;
-        plotHeight: number;
-    };
-    /** 用户设置配置（渲染器只读） */
-    settings?: import('../config/chartSettings').ChartSettings;
-    /** 需要在Y轴上绘制的标签列表（由各类标记渲染器填充） */
-    yAxisLabels?: YAxisLabel[];
-    /** 需要在X轴上绘制的标签列表（由各类标记渲染器填充） */
-    xAxisLabels?: XAxisLabel[];
-    /** 需要在Y轴上绘制的范围带列表（由绘图渲染器填充，先于标签绘制） */
-    yAxisRanges?: YAxisRange[];
-    /** 需要在X轴上绘制的范围带列表（由绘图渲染器填充，先于标签绘制） */
-    xAxisRanges?: XAxisRange[];
-    /** 当前主题 */
-    theme: import('../core/theme/colors').ChartTheme;
-}
-export type DrawingAnchor = {
-    id: string;
-    index: number;
-    time?: number | string;
-    price: number;
-};
-export type DrawingKind = 'trend-line' | 'ray' | 'extended-line' | 'horizontal-line' | 'horizontal-ray' | 'vertical-line' | 'cross-line' | 'info-line' | 'parallel-channel' | 'regression-channel' | 'flat-line' | 'disjoint-channel';
-export type DrawingStyle = {
-    stroke?: string;
-    strokeWidth?: number;
-    strokeStyle?: 'solid' | 'dashed' | 'dotted';
-    fill?: string;
-    fillOpacity?: number;
-    pointRadius?: number;
-    textColor?: string;
-    fontSize?: number;
-};
-export type DrawingObject<TParams = Record<string, unknown>> = {
-    id: string;
-    kind: DrawingKind;
-    paneId: string;
-    visible: boolean;
-    locked?: boolean;
-    zIndex?: number;
-    anchors: DrawingAnchor[];
-    params: TParams;
-    style: DrawingStyle;
-};
-export type ScreenPoint = {
-    x: number;
-    y: number;
-};
-export type PointPrimitive = {
-    kind: 'point';
-    point: ScreenPoint;
-    role?: 'anchor' | 'handle' | 'marker' | 'center';
-    style?: DrawingStyle;
-};
-export type LinePrimitive = {
-    kind: 'line';
-    a: ScreenPoint;
-    b: ScreenPoint;
-    extend?: 'none' | 'left' | 'right' | 'both';
-    showEndpoints?: boolean;
-    style?: DrawingStyle;
-};
-export type AreaPrimitive = {
-    kind: 'area';
-    points: ScreenPoint[];
-    closed: boolean;
-    style?: DrawingStyle;
-};
-export type TextPrimitive = {
-    kind: 'text';
-    point: ScreenPoint;
-    text: string;
-    align?: 'left' | 'center' | 'right';
-    baseline?: 'top' | 'middle' | 'bottom';
-    style?: DrawingStyle;
-};
-export type DrawingPrimitive = PointPrimitive | LinePrimitive | AreaPrimitive | TextPrimitive;
-export type DrawingGeometry = {
-    primitives: DrawingPrimitive[];
-    bounds?: {
-        left: number;
-        top: number;
-        right: number;
-        bottom: number;
-    };
-    meta?: Record<string, unknown>;
-    computedAnchors?: DrawingAnchor[];
-};
-export type DrawingComputeContext = {
-    pane: PaneInfo;
-    visibleData: KLineData[];
-    seriesData: KLineData[];
-    range: {
-        start: number;
-        end: number;
-    };
-    kLinePositions: number[];
-    kLineCenters: number[];
-    kBarRects: Array<{
-        x: number;
-        width: number;
-    }>;
-    kWidth: number;
-    kGap: number;
-    dpr: number;
-    paneWidth: number;
-    viewport: {
-        scrollLeft: number;
-        plotWidth: number;
-        plotHeight: number;
-    };
-    toScreen(anchor: DrawingAnchor): ScreenPoint;
-};
-export interface DrawingDefinition<TParams = Record<string, unknown>> {
-    kind: DrawingKind;
-    minAnchors: number;
-    maxAnchors: number;
-    compute(drawing: DrawingObject<TParams>, context: DrawingComputeContext): DrawingGeometry;
-}
-/** 全局 Pane ID（渲染到所有 pane） */
-export declare const GLOBAL_PANE_ID: unique symbol;
-/** 优先级推荐范围 */
-export declare const RENDERER_PRIORITY: {
-    readonly LAST_PRICE_LABEL: -25;
-    readonly SYSTEM_YAXIS: -20;
-    readonly SYSTEM_XAXIS: -20;
-    readonly BACKGROUND: 0;
-    readonly GRID: 10;
-    /**
-     * 指标渲染器（MACD, RSI 等）
-     * 所有指标渲染器必须使用此优先级或 ≤30 的值
-     */
-    readonly INDICATOR: 30;
-    readonly MAIN: 50;
-    /**
-     * 指标刻度渲染器（依赖于前方指标写入的共享状态）
-     * 必须晚于 INDICATOR 和 MAIN，确保每次绘制时先更新指标状态再绘制刻度。
-     */
-    readonly INDICATOR_SCALE: 55;
-    readonly OVERLAY: 80;
-    readonly FOREGROUND: 100;
-    readonly SYSTEM_BORDER: 120;
-    readonly SYSTEM_CROSSHAIR: 150;
-};
-/** 渲染器插件接口（独立定义，不继承 Plugin） */
-export interface RendererPlugin {
-    /** 唯一标识 */
-    readonly name: string;
-    /** 版本号 */
-    readonly version?: string;
-    /** 描述 */
-    readonly description?: string;
-    /** 调试用显示名称 */
-    readonly debugName?: string;
-    /** 渲染目标 pane（'main' | 'sub' | GLOBAL_PANE_ID 表示所有） */
-    paneId: string | symbol;
-    /** 渲染优先级（数字越大越后渲染） */
-    priority: number;
-    /** 是否启用（仅作为初始值，运行时状态由 Manager 管理） */
-    enabled?: boolean;
-    /**
-     * 是否为系统渲染器
-     * 系统渲染器不会通过 getRenderers() 返回，只能通过 renderPlugin() 单独渲染
-     * 用于时间轴、全局边框等需要单独控制渲染时机的场景
-     */
-    isSystem?: boolean;
-    /**
-     * 渲染器所属层，决定 UpdateLevel 过滤行为
-     * - 'main': 低频/静态内容，随主画布一起渲染
-     * - 'overlay': 高频/动态内容，可在 overlay-only 更新时独立重绘
-     * 未指定时默认为 'main'（向后兼容）
-     */
-    layer?: 'main' | 'overlay';
-    /** 渲染方法 */
-    draw(context: RenderContext): void;
-    /** 数据更新时回调 */
-    onDataUpdate?(data: unknown[], range: {
-        start: number;
-        end: number;
-    }): void;
-    /** 容器尺寸变化时回调 */
-    onResize?(pane: PaneInfo): void;
-    /** 获取配置 */
-    getConfig?(): Record<string, unknown>;
-    /** 设置配置 */
-    setConfig?(config: Record<string, unknown>): void;
-    /** 卸载时清理资源 */
-    onUninstall?(): void;
-}
-/** 带插件系统能力的渲染器（可选） */
-export interface RendererPluginWithHost extends RendererPlugin {
-    /** 安装时获取 PluginHost 访问权限 */
-    onInstall?(host: PluginHost): void;
-    /** 声明该渲染器所拥有的状态命名空间，卸载时框架会自动清理 */
-    getDeclaredNamespaces?(): string[];
-}
-/** 指标渲染器状态基类 */
-export interface BaseIndicatorState {
-    timestamp: number;
-}