@363045841yyt/klinechart-core 0.8.14 → 0.9.0-alpha.0

package/dist/foundation/plugin/PluginHost.js

@@ -0,0 +1,200 @@
+/**
+ * 插件宿主 - 核心管理类
+ */
+import { KLineChartError } from '../../errors';
+import { ConfigManager } from './ConfigManager';
+import { EventBus } from './EventBus';
+import { HookSystem } from './HookSystem';
+import { PluginRegistry } from './PluginRegistry';
+import { StateStore } from './StateStore';
+export class PluginHostImpl {
+    registry;
+    eventBus;
+    hookSystem;
+    configManager;
+    stateStore;
+    services = new Map();
+    isDestroyed = false;
+    logger;
+    constructor(logger) {
+        this.registry = new PluginRegistry();
+        this.eventBus = new EventBus();
+        this.hookSystem = new HookSystem();
+        this.configManager = new ConfigManager();
+        this.stateStore = new StateStore();
+        this.logger = logger ?? console;
+    }
+    // 实现 PluginHost 接口
+    events = {
+        on: (event, handler) => {
+            this.eventBus.on(event, handler);
+        },
+        off: (event, handler) => {
+            this.eventBus.off(event, handler);
+        },
+        emit: (event, data) => {
+            this.eventBus.emit(event, data);
+        },
+        once: (event, handler) => {
+            this.eventBus.once(event, handler);
+        },
+    };
+    hooks = {
+        tap: (hookName, fn, priority = 0) => {
+            this.hookSystem.tap(hookName, fn, priority);
+        },
+        untap: (hookName, fn) => {
+            this.hookSystem.untap(hookName, fn);
+        },
+        call: async (hookName, context, options) => {
+            return this.hookSystem.call(hookName, context, options);
+        },
+        callSync: (hookName, context, options) => {
+            return this.hookSystem.callSync(hookName, context, options);
+        },
+    };
+    getConfig(pluginName, key, defaultValue) {
+        return this.configManager.get(pluginName, key, defaultValue);
+    }
+    setConfig(pluginName, key, value) {
+        this.configManager.set(pluginName, key, value);
+    }
+    getPlugin(name) {
+        return this.registry.getPlugin(name);
+    }
+    log(level, message, ...args) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [${level.toUpperCase()}]`;
+        this.logger[level](`${prefix} ${message}`, ...args);
+    }
+    // ============ 状态存储 API ============
+    setSharedState(namespace, state, ownerId) {
+        this.stateStore.setState(namespace, state, ownerId);
+    }
+    getSharedState(namespace) {
+        return this.stateStore.getState(namespace);
+    }
+    clearSharedState(namespace) {
+        this.stateStore.clearState(namespace);
+    }
+    registerStateOwner(ownerId, namespaces) {
+        this.stateStore.registerStateOwner(ownerId, namespaces);
+    }
+    clearByOwner(ownerId) {
+        this.stateStore.clearByOwner(ownerId);
+    }
+    registerService(name, service) {
+        this.services.set(name, service);
+    }
+    getService(name) {
+        return this.services.get(name);
+    }
+    /**
+     * 安装插件
+     */
+    async use(plugin, config) {
+        this.ensureNotDestroyed();
+        if (this.registry.has(plugin.name)) {
+            throw new KLineChartError('INVALID_STATE', `Plugin "${plugin.name}" is already installed`);
+        }
+        try {
+            // 注册插件
+            const descriptor = this.registry.register(plugin, config);
+            // 注册默认配置
+            if (config) {
+                this.configManager.setAll(plugin.name, config);
+            }
+            // 触发安装前钩子
+            await this.hooks.call('plugin:beforeInstall', { plugin, config }, { throwOnError: true });
+            // 安装插件
+            await plugin.install(this, descriptor.config);
+            // 更新状态
+            this.registry.updateState(plugin.name, 'installed');
+            // 触发安装后钩子
+            await this.hooks.call('plugin:afterInstall', { plugin, config }, { throwOnError: true });
+            this.log('info', `Plugin "${plugin.name}" installed successfully`);
+        }
+        catch (error) {
+            this.registry.updateState(plugin.name, 'error', error instanceof Error ? error : new Error(String(error)));
+            this.log('error', `Failed to install plugin "${plugin.name}":`, error);
+            throw error;
+        }
+    }
+    /**
+     * 移除插件
+     */
+    async remove(name) {
+        this.ensureNotDestroyed();
+        const descriptor = this.registry.get(name);
+        if (!descriptor) {
+            throw new KLineChartError('INVALID_STATE', `Plugin "${name}" is not installed`);
+        }
+        try {
+            // 触发卸载前钩子
+            await this.hooks.call('plugin:beforeUninstall', { name }, { throwOnError: true });
+            // 调用插件的卸载方法
+            if (descriptor.plugin.uninstall) {
+                await descriptor.plugin.uninstall();
+            }
+            // 清理
+            this.registry.unregister(name);
+            this.configManager.clear(name);
+            // 触发卸载后钩子
+            await this.hooks.call('plugin:afterUninstall', { name }, { throwOnError: true });
+            this.log('info', `Plugin "${name}" removed successfully`);
+        }
+        catch (error) {
+            this.log('error', `Failed to remove plugin "${name}":`, error);
+            throw error;
+        }
+    }
+    /**
+     * 获取所有插件
+     */
+    getPlugins() {
+        return this.registry.getAll();
+    }
+    /**
+     * 获取插件状态
+     */
+    getState(name) {
+        return this.registry.get(name)?.state;
+    }
+    /**
+     * 销毁宿主
+     */
+    async destroy() {
+        if (this.isDestroyed)
+            return;
+        // 卸载所有插件
+        for (const descriptor of this.registry.getAll()) {
+            try {
+                if (descriptor.plugin.uninstall) {
+                    await descriptor.plugin.uninstall();
+                }
+            }
+            catch (error) {
+                this.log('error', `Error uninstalling "${descriptor.plugin.name}":`, error);
+            }
+        }
+        // 清理资源
+        this.registry.clear();
+        this.eventBus.clear();
+        this.hookSystem.clear();
+        this.configManager.clear();
+        this.stateStore.clear();
+        this.services.clear();
+        this.isDestroyed = true;
+        this.log('info', 'PluginHost destroyed');
+    }
+    ensureNotDestroyed() {
+        if (this.isDestroyed) {
+            throw new KLineChartError('DISPOSED', 'PluginHost has been destroyed');
+        }
+    }
+}
+// 导出工厂函数
+export function createPluginHost(logger) {
+    return new PluginHostImpl(logger);
+}
+//# sourceMappingURL=PluginHost.js.map

package/dist/foundation/plugin/PluginHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHost.js","sourceRoot":"","sources":["../../../src/foundation/plugin/PluginHost.ts"],"names":[],"mappings":"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"}

package/dist/foundation/plugin/PluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistry.d.ts","sourceRoot":"","sources":["../../../src/foundation/plugin/PluginRegistry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEpE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA2C;IAE1D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAmB5E;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIjE;;OAEG;IACH,MAAM,IAAI,gBAAgB,EAAE;IAI5B;;OAEG;IACH,UAAU,IAAI,gBAAgB,EAAE;IAIhC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAUlE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/foundation/plugin/PluginRegistry.js

@@ -0,0 +1,81 @@
+/**
+ * 插件注册表
+ */
+import { KLineChartError } from '../../errors';
+export class PluginRegistry {
+    plugins = new Map();
+    /**
+     * 注册插件
+     */
+    register(plugin, config) {
+        if (this.plugins.has(plugin.name)) {
+            throw new KLineChartError('INVALID_STATE', `Plugin "${plugin.name}" is already registered`);
+        }
+        const descriptor = {
+            plugin,
+            config: {
+                enabled: true,
+                priority: 0,
+                ...config,
+            },
+            state: 'registered',
+        };
+        this.plugins.set(plugin.name, descriptor);
+        return descriptor;
+    }
+    /**
+     * 注销插件
+     */
+    unregister(name) {
+        return this.plugins.delete(name);
+    }
+    /**
+     * 获取插件描述符
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * 获取插件实例
+     */
+    getPlugin(name) {
+        return this.plugins.get(name)?.plugin;
+    }
+    /**
+     * 获取所有插件
+     */
+    getAll() {
+        return [...this.plugins.values()];
+    }
+    /**
+     * 获取所有已启用的插件
+     */
+    getEnabled() {
+        return this.getAll().filter((d) => d.config?.enabled !== false);
+    }
+    /**
+     * 更新插件状态
+     */
+    updateState(name, state, error) {
+        const descriptor = this.plugins.get(name);
+        if (descriptor) {
+            descriptor.state = state;
+            if (error) {
+                descriptor.error = error;
+            }
+        }
+    }
+    /**
+     * 检查插件是否存在
+     */
+    has(name) {
+        return this.plugins.has(name);
+    }
+    /**
+     * 清除所有插件
+     */
+    clear() {
+        this.plugins.clear();
+    }
+}
+//# sourceMappingURL=PluginRegistry.js.map

package/dist/foundation/plugin/PluginRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRegistry.js","sourceRoot":"","sources":["../../../src/foundation/plugin/PluginRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAI9C,MAAM,OAAO,cAAc;IACjB,OAAO,GAAkC,IAAI,GAAG,EAAE,CAAA;IAE1D;;OAEG;IACH,QAAQ,CAAC,MAAc,EAAE,MAAgC;QACvD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,WAAW,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAA;QAC7F,CAAC;QAED,MAAM,UAAU,GAAqB;YACnC,MAAM;YACN,MAAM,EAAE;gBACN,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,CAAC;gBACX,GAAG,MAAM;aACV;YACD,KAAK,EAAE,YAA2B;SACnC,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QACzC,OAAO,UAAU,CAAA;IACnB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,SAAS,CAA4B,IAAY;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAuB,CAAA;IACxD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC,CAAA;IACjE,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY,EAAE,KAAkB,EAAE,KAAa;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/foundation/plugin/StateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.d.ts","sourceRoot":"","sources":["../../../src/foundation/plugin/StateStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEjD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,eAAe,CAAsC;IAE7D;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,SAAS,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3F;;;OAGG;IACH,QAAQ,CAAC,CAAC,SAAS,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAKxE;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;IAI/D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAenC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/foundation/plugin/StateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.js","sourceRoot":"","sources":["../../../src/foundation/plugin/StateStore.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,UAAU;IACb,MAAM,GAAoC,IAAI,GAAG,EAAE,CAAA;IACnD,eAAe,GAA6B,IAAI,GAAG,EAAE,CAAA;IAE7D;;;;;OAKG;IACH,QAAQ,CAA+B,SAAiB,EAAE,KAAQ,EAAE,OAAgB;QAClF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IACnC,CAAC;IAED;;;OAGG;IACH,QAAQ,CAA+B,SAAiB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAkB,CAAA;QACzD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,SAAiB;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAC/B,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,OAAe,EAAE,UAAoB;QACtD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;IACxD,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAe;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpD,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;gBACtB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACxB,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,YAAY,OAAO,GAAG,CAAC,CAAA;gBACxE,CAAC;YACH,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,4DAA4D,OAAO,EAAE,CAAC,CAAA;QACrF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACnB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;CACF"}

package/dist/foundation/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundation/plugin/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/foundation/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundation/plugin/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO;AACP,cAAc,SAAS,CAAA;AAEvB,MAAM;AACN,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/D,MAAM;AACN,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,QAAQ;AACR,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA"}

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

@@ -0,0 +1,86 @@
+/**
+ * 渲染器插件管理器
+ */
+import { UpdateLevel } from '../../engine/layout/pane';
+import type { RendererPlugin, RenderContext, PaneInfo, RendererPluginWithHost, PluginHost } from './types';
+/** 渲染器错误事件（裁剪后，不含大数据） */
+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;
+    private transactionDepth;
+    private invalidatePending;
+    /** 设置重绘回调（由 Chart 注入） */
+    setInvalidateCallback(cb: () => void): void;
+    /** 合并一组 renderer 变更，仅在最外层事务结束时触发一次重绘。 */
+    transaction<T>(run: () => T): T;
+    private invalidate;
+    /** 设置 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;
+}
+//# sourceMappingURL=rendererPluginManager.d.ts.map

package/dist/foundation/plugin/rendererPluginManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendererPluginManager.d.ts","sourceRoot":"","sources":["../../../src/foundation/plugin/rendererPluginManager.ts"],"names":[],"mappings":"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"}