@chatbi-v/core 2.1.3 → 2.1.5

package/dist/index.d.mts

@@ -1209,11 +1209,18 @@ declare class PluginManager {
      * @param notify - 是否在注册完成后触发状态变更通知
      */
     register(plugin: Plugin, notify?: boolean): void;
+    /**
+     * 手动挂载指定插件（支持按需加载）
+     * @description 如果插件依赖尚未挂载，会递归挂载所有依赖
+     * @param pluginId 插件 ID
+     */
+    mountPlugin(pluginId: string): Promise<void>;
     /**
      * 初始化所有插件
      * @param sharedContext 共享上下文
+     * @param autoMount 是否自动挂载所有插件 (默认为 false，启用按需加载模式)
      */
-    initPlugins(sharedContext?: Record<string, any>): Promise<void>;
+    initPlugins(sharedContext?: Record<string, any>, autoMount?: boolean): Promise<void>;
     /**
      * 获取排序后的插件 ID 列表 (处理依赖)
      */
@@ -1222,8 +1229,9 @@ declare class PluginManager {
      * 加载插件列表
      * @param configs 插件配置
      * @param registry 插件注册表 (动态导入函数)
+     * @param notify 是否在加载完成后触发通知，默认为 true
      */
-    loadPlugins(configs: Record<string, any>, registry: Record<string, () => Promise<any>>): Promise<void>;
+    loadPlugins(configs: Record<string, any>, registry: Record<string, () => Promise<any>>, notify?: boolean): Promise<void>;
     /**
      * 加载远程插件
      * @param pluginId 插件 ID

package/dist/index.d.ts

@@ -1209,11 +1209,18 @@ declare class PluginManager {
      * @param notify - 是否在注册完成后触发状态变更通知
      */
     register(plugin: Plugin, notify?: boolean): void;
+    /**
+     * 手动挂载指定插件（支持按需加载）
+     * @description 如果插件依赖尚未挂载，会递归挂载所有依赖
+     * @param pluginId 插件 ID
+     */
+    mountPlugin(pluginId: string): Promise<void>;
     /**
      * 初始化所有插件
      * @param sharedContext 共享上下文
+     * @param autoMount 是否自动挂载所有插件 (默认为 false，启用按需加载模式)
      */
-    initPlugins(sharedContext?: Record<string, any>): Promise<void>;
+    initPlugins(sharedContext?: Record<string, any>, autoMount?: boolean): Promise<void>;
     /**
      * 获取排序后的插件 ID 列表 (处理依赖)
      */
@@ -1222,8 +1229,9 @@ declare class PluginManager {
      * 加载插件列表
      * @param configs 插件配置
      * @param registry 插件注册表 (动态导入函数)
+     * @param notify 是否在加载完成后触发通知，默认为 true
      */
-    loadPlugins(configs: Record<string, any>, registry: Record<string, () => Promise<any>>): Promise<void>;
+    loadPlugins(configs: Record<string, any>, registry: Record<string, () => Promise<any>>, notify?: boolean): Promise<void>;
     /**
      * 加载远程插件
      * @param pluginId 插件 ID

package/dist/index.js

@@ -1781,11 +1781,53 @@ var PluginManager = class {
       this.notify();
     }
   }
+  /**
+   * 手动挂载指定插件（支持按需加载）
+   * @description 如果插件依赖尚未挂载，会递归挂载所有依赖
+   * @param pluginId 插件 ID
+   */
+  async mountPlugin(pluginId) {
+    const runtime = this.runtimes.get(pluginId);
+    if (!runtime) {
+      const msg = `\u5C1D\u8BD5\u6302\u8F7D\u4E0D\u5B58\u5728\u6216\u672A\u521D\u59CB\u5316\u7684\u63D2\u4EF6: ${pluginId}`;
+      logger6.warn(msg);
+      throw new Error(msg);
+    }
+    if (runtime.status === "mounted") return;
+    const plugin = this.plugins.get(pluginId);
+    if (plugin?.metadata.dependencies) {
+      for (const depId of plugin.metadata.dependencies) {
+        if (!this.runtimes.has(depId)) {
+          logger6.error(`\u63D2\u4EF6 ${pluginId} \u4F9D\u8D56\u7F3A\u5931: ${depId}`);
+          throw new Error(`Dependency ${depId} missing for ${pluginId}`);
+        }
+        await this.mountPlugin(depId);
+      }
+    }
+    if (runtime.status === "initial") {
+      try {
+        await runtime.load();
+      } catch (e) {
+        logger6.error(`\u63D2\u4EF6 ${pluginId} load \u5931\u8D25:`, e);
+        throw e;
+      }
+    }
+    if (runtime.status === "loaded") {
+      try {
+        await runtime.mount();
+        this.notify();
+      } catch (e) {
+        logger6.error(`\u63D2\u4EF6 ${pluginId} \u6302\u8F7D\u5931\u8D25:`, e);
+        throw e;
+      }
+    }
+  }
   /**
    * 初始化所有插件
    * @param sharedContext 共享上下文
+   * @param autoMount 是否自动挂载所有插件 (默认为 false，启用按需加载模式)
    */
-  async initPlugins(sharedContext = {}) {
+  async initPlugins(sharedContext = {}, autoMount = false) {
     if (this.isInitializing) {
       logger6.warn("PluginManager is already initializing, skipping...");
       return;
@@ -1837,6 +1879,9 @@ var PluginManager = class {
       }
       for (const id of sortedPluginIds) {
         if (!idsToLoad.has(id)) continue;
+        const plugin = this.plugins.get(id);
+        const shouldMount = autoMount || plugin && ["system", "theme"].includes(plugin.metadata.type);
+        if (!shouldMount) continue;
         const runtime = this.runtimes.get(id);
         if (runtime && (runtime.status === "loaded" || runtime.status === "initial")) {
           try {
@@ -1848,6 +1893,7 @@ var PluginManager = class {
       }
     } finally {
       this.isInitializing = false;
+      this.notify();
     }
   }
   /**
@@ -1894,8 +1940,9 @@ var PluginManager = class {
    * 加载插件列表
    * @param configs 插件配置
    * @param registry 插件注册表 (动态导入函数)
+   * @param notify 是否在加载完成后触发通知，默认为 true
    */
-  async loadPlugins(configs, registry) {
+  async loadPlugins(configs, registry, notify = true) {
     logger6.info("\u5F00\u59CB\u52A0\u8F7D\u63D2\u4EF6...");
     const localLoadPromises = Object.entries(registry).map(async ([registryId, importFn]) => {
       try {
@@ -1929,7 +1976,9 @@ var PluginManager = class {
         this.register(plugin, false);
       }
     });
-    this.notify();
+    if (notify) {
+      this.notify();
+    }
     logger6.info(`\u63D2\u4EF6\u52A0\u8F7D\u5B8C\u6210\uFF0C\u5171\u52A0\u8F7D ${this.plugins.size} \u4E2A\u63D2\u4EF6`);
   }
   /**
@@ -2119,6 +2168,17 @@ var SlotSkeletons = ({ slot, expanded }) => {
 
 // src/components/PluginSlot.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
+var ExtensionLoader = ({ pluginId, component: Component2, props }) => {
+  const status = pluginManager.getPluginRuntimeStatus(pluginId);
+  if (status !== "mounted") {
+    const error = pluginManager.getPluginError(pluginId);
+    if (error) {
+      throw error;
+    }
+    throw pluginManager.mountPlugin(pluginId);
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Component2, { ...props });
+};
 var PluginSlot = ({
   slot,
   props = {},
@@ -2131,7 +2191,9 @@ var PluginSlot = ({
   const [, forceUpdate] = (0, import_react4.useState)({});
   (0, import_react4.useEffect)(() => {
     const unsubscribe = pluginManager.subscribe(() => {
-      forceUpdate({});
+      (0, import_react4.startTransition)(() => {
+        forceUpdate({});
+      });
     }, slot);
     return unsubscribe;
   }, [slot]);
@@ -2152,7 +2214,14 @@ var PluginSlot = ({
       return {
         key,
         extension: ext,
-        component: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PluginErrorBoundary, { pluginId: ext._pluginId, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react4.Suspense, { fallback: skeleton || /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(SlotSkeletons, { slot }), children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Component2, { ...mergedProps }) }) }, key)
+        component: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(PluginErrorBoundary, { pluginId: ext._pluginId, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react4.Suspense, { fallback: skeleton || /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(SlotSkeletons, { slot }), children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+          ExtensionLoader,
+          {
+            pluginId: ext._pluginId || "",
+            component: Component2,
+            props: mergedProps
+          }
+        ) }) }, key)
       };
     });
   }, [extensions, mergedProps]);
@@ -2774,10 +2843,10 @@ var usePluginLoader = (options) => {
           const { configManager: configManager2 } = await Promise.resolve().then(() => (init_config_manager(), config_manager_exports));
           configManager2.set("system", options.systemConfig);
         }
-        await pluginManager.loadPlugins(pluginConfigs, finalRegistry);
-        await pluginManager.initPlugins(sharedContext);
+        await pluginManager.loadPlugins(pluginConfigs, finalRegistry, false);
+        await pluginManager.initPlugins(sharedContext, false);
         setPluginsLoaded(true);
-        logger10.info("Plugins loaded successfully");
+        logger10.info("Plugins loaded successfully (Lazy Mode)");
       } catch (error) {
         logger10.error("Failed to load plugins:", error);
       } finally {
@@ -2785,14 +2854,9 @@ var usePluginLoader = (options) => {
       }
     };
     load();
-    return () => {
-      unsubscribe();
-    };
+    return unsubscribe;
   }, []);
-  return {
-    pluginsLoaded,
-    pluginVersion
-  };
+  return { pluginsLoaded, pluginVersion };
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {