@yumerijs/loader 3.1.1 → 3.1.2

package/dist/index.d.ts

@@ -3,6 +3,7 @@ interface Plugin {
     apply: (ctx: Context, config: Config) => Promise<void>;
     disable: (ctx: Context) => Promise<void>;
     depend: Array<string>;
+    optional?: Array<string>;
     provide: Array<string>;
     render?: string;
     config?: Schema<any>;
@@ -23,6 +24,7 @@ export declare class PluginLoader {
     plugins: {
         [name: string]: Plugin & {
             depend?: string[];
+            optional?: string[];
             provide?: string[];
         };
     };
@@ -51,7 +53,7 @@ export declare class PluginLoader {
     unregall(pluginName: string): void;
     loadConfig(configPath: string): Promise<void>;
     loadPlugins(): Promise<void>;
-    loadSinglePlugin(pluginName: string, triggerPendingCheck?: boolean, onlypending?: boolean): Promise<boolean>;
+    loadSinglePlugin(pluginName: string, triggerPendingCheck?: boolean, onlypending?: boolean, requireOptionalDependencies?: boolean): Promise<boolean>;
     private _loadPendingPlugins;
     unloadPlugin(pluginNameToUnload: string, ispending?: boolean): Promise<void>;
     private _unloadSinglePlugin;

package/dist/index.js

@@ -153,26 +153,20 @@ export class PluginLoader {
             this.logger.info('No enabled plugins found in configuration.');
             return;
         }
-        let loadedInLastPass = true;
-        while (loadedInLastPass) {
-            loadedInLastPass = false;
-            for (const pluginName of enabledPlugins) {
-                if (this.pluginStatus[pluginName] === "enabled" /* PluginStatus.ENABLED */) {
-                    continue;
-                }
-                const success = await this.loadSinglePlugin(pluginName, false);
-                if (success) {
-                    loadedInLastPass = true;
-                }
-            }
+        // 第一阶段：将 optional 与 depend 一样处理，尽量让可选服务先完成加载并注入。
+        while (await this._loadPendingPlugins(true)) {
+            // Continue scanning until no plugin can satisfy all required and optional dependencies.
+        }
+        // 第二阶段：严格扫描无法推进后，忽略尚未提供的 optional；depend 仍必须满足。
+        while (await this._loadPendingPlugins(false)) {
+            // Continue scanning in relaxed mode until only genuinely missing dependencies remain.
         }
-        await this._loadPendingPlugins();
         const pendingPlugins = Object.keys(this.pluginStatus).filter(p => this.pluginStatus[p] === "pending" /* PluginStatus.PENDING */);
         if (pendingPlugins.length > 0) {
-            // this.logger.warn('Some plugins could not be loaded due to unresolved dependencies:', pendingPlugins);
+            this.logger.warn('Some plugins could not be loaded due to unresolved required dependencies:', pendingPlugins);
         }
     }
-    async loadSinglePlugin(pluginName, triggerPendingCheck = true, onlypending = false) {
+    async loadSinglePlugin(pluginName, triggerPendingCheck = true, onlypending = false, requireOptionalDependencies = true) {
         if (!this.pluginStatus[pluginName]) {
             this.pluginStatus[pluginName] = "pending" /* PluginStatus.PENDING */;
         }
@@ -211,7 +205,10 @@ export class PluginLoader {
                     }
                 }
             }
-            const deps = pluginInstance.depend || [];
+            const deps = [
+                ...(pluginInstance.depend || []),
+                ...(requireOptionalDependencies ? (pluginInstance.optional || []) : []),
+            ];
             const unmetDependencies = deps.filter(dep => !this.core.components[dep] && !this.core.services[dep]);
             if (unmetDependencies.length > 0) {
                 return false;
@@ -231,7 +228,7 @@ export class PluginLoader {
             await this.core.plugin(pluginInstance, context, finalConfig);
             this.pluginStatus[pluginName] = "enabled" /* PluginStatus.ENABLED */;
             if (triggerPendingCheck) {
-                await this._loadPendingPlugins();
+                await this._loadPendingPlugins(requireOptionalDependencies);
             }
             if (this.isDev) {
                 let pluginPathToWatch = null;
@@ -265,13 +262,14 @@ export class PluginLoader {
             return false;
         }
     }
-    async _loadPendingPlugins() {
+    async _loadPendingPlugins(requireOptionalDependencies = true) {
         const pendingPlugins = Object.keys(this.pluginStatus).filter(p => this.pluginStatus[p] === "pending" /* PluginStatus.PENDING */);
-        if (pendingPlugins.length === 0)
-            return;
+        let loadedAny = false;
         for (const pluginName of pendingPlugins) {
-            await this.loadSinglePlugin(pluginName, false);
+            const loaded = await this.loadSinglePlugin(pluginName, false, true, requireOptionalDependencies);
+            loadedAny ||= loaded;
         }
+        return loadedAny;
     }
     async unloadPlugin(pluginNameToUnload, ispending = false) {
         const dependents = [];
@@ -325,7 +323,10 @@ export class PluginLoader {
         this.logger.info(`Reloading plugin: "${pluginName}"...`);
         await this.reloadConfigFile();
         await this.unloadPlugin(pluginName, true);
-        const success = await this.loadSinglePlugin(pluginName, true, false);
+        let success = await this.loadSinglePlugin(pluginName, true, false, true);
+        if (!success) {
+            success = await this.loadSinglePlugin(pluginName, true, false, false);
+        }
         if (success) {
             this.logger.info(`Plugin "${pluginName}" reloaded successfully.`);
             this.core.emit('plugin-reloaded', pluginName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yumerijs/loader",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Module loader for yumeri",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",