ee-core 5.0.0-beta.2 → 5.0.0-beta.6

package/dist/cjs/jobs/load-balancer/index.js

@@ -4,15 +4,15 @@ exports.LoadBalancer = void 0;
 const consts_js_1 = require("./consts.js");
 const scheduler_js_1 = require("./scheduler.js");
 /**
- * 负载均衡器
- * @intro 参考electron-re项目，并做了一些改动
+ * Load Balancer
+ * @intro Based on the electron-re project with some modifications
  * @since 1.0.0
  */
 class LoadBalancer {
     /**
-     * @param options - 配置选项
-     * @param options.targets - 负载均衡目标列表 [{id: 1, weight: 1}, {id: 2, weight: 2}]
-     * @param options.algorithm - 算法名称
+     * @param options - Configuration options
+     * @param options.targets - Load balancing target list [{id: 1, weight: 1}, {id: 2, weight: 2}]
+     * @param options.algorithm - Algorithm name
      */
     constructor(options) {
         this.targets = options.targets;
@@ -30,7 +30,7 @@ class LoadBalancer {
         this.calculateWeightIndex();
     }
     /**
-     * 算法参数
+     * Algorithm parameters
      */
     memorizedParams() {
         return {
@@ -45,7 +45,7 @@ class LoadBalancer {
         };
     }
     /**
-     * 刷新参数
+     * Refresh parameters
      */
     refreshParams(pidMap) {
         const infos = Object.values(pidMap);
@@ -55,7 +55,7 @@ class LoadBalancer {
         }
     }
     /**
-     * 选举出一个进程
+     * Elect a single process
      */
     pickOne(...params) {
         const memoFn = this.memoParams[this.algorithm];
@@ -65,13 +65,13 @@ class LoadBalancer {
         return this.scheduler.calculate(this.targets, memoFn(...params));
     }
     /**
-     * 选举出多个进程
+     * Elect multiple processes
      */
     pickMulti(count = 1, ...params) {
         return new Array(count).fill(null).map(() => this.pickOne(...params));
     }
     /**
-     * 计算权重
+     * Calculate weights
      */
     calculateWeightIndex() {
         this.params.weightTotal = this.targets.reduce((total, cur) => total + (cur.weight || 0), 0);
@@ -80,7 +80,7 @@ class LoadBalancer {
         }
     }
     /**
-     * 计算索引
+     * Calculate index
      */
     calculateIndex() {
         if (this.params.currentIndex >= this.targets.length) {
@@ -88,7 +88,7 @@ class LoadBalancer {
         }
     }
     /**
-     * 清除data
+     * Clean data
      */
     clean(id) {
         if (id !== undefined) {
@@ -108,7 +108,7 @@ class LoadBalancer {
         }
     }
     /**
-     * 添加一个进程信息
+     * Add a process entry
      */
     add(task) {
         if (this.targets.find(target => target.id === task.id)) {
@@ -119,7 +119,7 @@ class LoadBalancer {
         this.calculateWeightIndex();
     }
     /**
-     * 删除一个进程信息
+     * Delete a process entry
      */
     del(target) {
         let found = false;
@@ -141,7 +141,7 @@ class LoadBalancer {
         }
     }
     /**
-     * 擦除
+     * Wipe all data
      */
     wipe() {
         this.targets = [];
@@ -149,7 +149,7 @@ class LoadBalancer {
         this.clean();
     }
     /**
-     * 更新计算参数
+     * Update calculation parameters
      */
     updateParams(object) {
         Object.entries(object).forEach(([key, value]) => {
@@ -159,7 +159,7 @@ class LoadBalancer {
         });
     }
     /**
-     * 设置targets
+     * Set targets
      */
     setTargets(targets) {
         const targetsMap = targets.reduce((total, cur) => {
@@ -176,7 +176,7 @@ class LoadBalancer {
         this.calculateWeightIndex();
     }
     /**
-     * 设置算法
+     * Set algorithm
      */
     setAlgorithm(algorithm) {
         if (algorithm in consts_js_1.AlgorithmType) {

package/dist/cjs/jobs/load-balancer/scheduler.d.ts

@@ -1,16 +1,16 @@
 import type { LoadBalancerTarget } from './types.js';
 /**
- * 算法调度器
+ * Algorithm scheduler
  */
 export declare class Scheduler {
     private algorithm;
     constructor(algorithm?: string);
     /**
-     * 计算
+     * Calculate
      */
     calculate(tasks: LoadBalancerTarget[], params: unknown[]): LoadBalancerTarget | null;
     /**
-     * 设置算法
+     * Set algorithm
      */
     setAlgorithm(algorithm: string): void;
 }

package/dist/cjs/jobs/load-balancer/scheduler.js

@@ -7,21 +7,21 @@ exports.Scheduler = void 0;
 const consts_js_1 = require("./consts.js");
 const index_js_1 = __importDefault(require("./algorithm/index.js"));
 /**
- * 算法调度器
+ * Algorithm scheduler
  */
 class Scheduler {
     constructor(algorithm) {
         this.algorithm = algorithm || consts_js_1.AlgorithmType.polling;
     }
     /**
-     * 计算
+     * Calculate
      */
     calculate(tasks, params) {
         const algo = index_js_1.default[this.algorithm];
         return algo(tasks, ...params);
     }
     /**
-     * 设置算法
+     * Set algorithm
      */
     setAlgorithm(algorithm) {
         if (algorithm in consts_js_1.AlgorithmType) {

package/dist/cjs/jobs/load-balancer/types.d.ts

@@ -1,22 +1,43 @@
+/**
+ * @module jobs/load-balancer/types
+ * @description Load balancer type definitions.
+ */
+/** Load balancer target (child process) */
 export interface LoadBalancerTarget {
+    /** Target identifier (usually child process PID) */
     id: string | number;
+    /** Weight value (used by weighted algorithms) */
     weight?: number;
 }
+/** Load balancer runtime parameters */
 export interface LoadBalancerParams {
+    /** Current polling index */
     currentIndex: number;
+    /** Current weight index (for weighted round-robin) */
     weightIndex: number;
+    /** Sum of all weights */
     weightTotal: number;
+    /** Connections map: pid -> current connection count */
     connectionsMap: Record<string | number, number>;
+    /** CPU occupancy map: pid -> CPU usage */
     cpuOccupancyMap: Record<string | number, number>;
+    /** Memory occupancy map: pid -> memory usage */
     memoryOccupancyMap: Record<string | number, number>;
 }
+/** Load balancer configuration options */
 export interface LoadBalancerOptions {
+    /** Target list */
     targets: LoadBalancerTarget[];
+    /** Algorithm name (default: polling) */
     algorithm?: string;
 }
+/** Process info (CPU/memory) */
 export interface PidInfo {
+    /** Process ID */
     pid: string | number;
+    /** CPU usage */
     cpu: number;
+    /** Memory usage */
     memory: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/cjs/jobs/load-balancer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/jobs/load-balancer/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,kBAAkB,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/jobs/load-balancer/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;CACrD;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,OAAO;IACtB,iBAAiB;IACjB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/cjs/jobs/load-balancer/types.js

@@ -1,3 +1,7 @@
 "use strict";
+/**
+ * @module jobs/load-balancer/types
+ * @description Load balancer type definitions.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/cjs/jobs/load-balancer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/jobs/load-balancer/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/jobs/load-balancer/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/cjs/jobs/registry.d.ts

@@ -0,0 +1,24 @@
+/** Killable job manager interface */
+type Killable = {
+    killAll: () => void;
+} | {
+    getPids: () => string[];
+    kill: (pid: string | number) => void;
+};
+/**
+ * Register a job manager
+ *
+ * Called after creating a ChildJob or ChildPoolJob to ensure cleanup on application exit.
+ *
+ * @param job - Job manager instance (ChildJob or ChildPoolJob)
+ */
+export declare function registerJobManager(job: Killable): void;
+/**
+ * Kill all registered job managers
+ *
+ * Called in the Electron before-quit event to ensure all child processes are properly terminated.
+ * Prefers killAll(), falls back to killing individual processes.
+ */
+export declare function killAllJobs(): void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/cjs/jobs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/jobs/registry.ts"],"names":[],"mappings":"AAOA,qCAAqC;AACrC,KAAK,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;CAAE,CAAC;AAK5G;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAoBlC"}

package/dist/cjs/jobs/registry.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerJobManager = registerJobManager;
+exports.killAllJobs = killAllJobs;
+/**
+ * @module jobs/registry
+ * @description Job manager registry. Centrally manages all ChildJob and ChildPoolJob instances,
+ * terminating all child processes on application exit (before-quit) to prevent process leaks.
+ */
+const index_js_1 = require("../log/index.js");
+/** List of registered job managers */
+const registeredJobs = [];
+/**
+ * Register a job manager
+ *
+ * Called after creating a ChildJob or ChildPoolJob to ensure cleanup on application exit.
+ *
+ * @param job - Job manager instance (ChildJob or ChildPoolJob)
+ */
+function registerJobManager(job) {
+    registeredJobs.push(job);
+}
+/**
+ * Kill all registered job managers
+ *
+ * Called in the Electron before-quit event to ensure all child processes are properly terminated.
+ * Prefers killAll(), falls back to killing individual processes.
+ */
+function killAllJobs() {
+    const failed = [];
+    for (const job of registeredJobs) {
+        try {
+            if ('killAll' in job && typeof job.killAll === 'function') {
+                job.killAll();
+            }
+            else if ('getPids' in job && 'kill' in job) {
+                const pids = job.getPids();
+                for (const pid of pids) {
+                    job.kill(typeof pid === 'string' ? parseInt(pid, 10) : pid);
+                }
+            }
+        }
+        catch (err) {
+            index_js_1.coreLogger.error('[jobs/registry] error killing job manager:', err);
+            failed.push(err);
+        }
+    }
+    if (failed.length > 0) {
+        index_js_1.coreLogger.error(`[jobs/registry] ${failed.length} job manager(s) failed to kill, processes may be orphaned`);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/cjs/jobs/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/jobs/registry.ts"],"names":[],"mappings":";;AAoBA,gDAEC;AAQD,kCAoBC;AAlDD;;;;GAIG;AACH,8CAA6C;AAK7C,sCAAsC;AACtC,MAAM,cAAc,GAAe,EAAE,CAAC;AAEtC;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,GAAa;IAC9C,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW;IACzB,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,IAAI,SAAS,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC1D,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,CAAC;iBAAM,IAAI,SAAS,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qBAAU,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;YACpE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,qBAAU,CAAC,KAAK,CAAC,mBAAmB,MAAM,CAAC,MAAM,2DAA2D,CAAC,CAAC;IAChH,CAAC;AACH,CAAC"}

package/dist/cjs/loader/index.d.ts

@@ -1,6 +1,58 @@
+/**
+ * Load a file and automatically execute function exports
+ *
+ * If the file exports a plain function (not a class or bytecode class), automatically calls that function
+ * and returns the execution result. Suitable for config files that need to dynamically return content based on appInfo.
+ *
+ * @param filepath - File path (relative paths are based on electronDir)
+ * @param inject - Arguments passed to the function export (spread into the call)
+ * @returns File export content or function execution result
+ * @throws Throws an error if the file does not exist
+ */
 export declare function loadFile(filepath: string, ...inject: unknown[]): unknown;
+/**
+ * Load a file (without auto-execution)
+ *
+ * Returns the module export content directly, without any processing.
+ * Suitable for scenarios where the original module reference is needed (e.g. child process task loading).
+ *
+ * @param filepath - Absolute file path
+ * @returns Module export content
+ */
 export declare function requireFile(filepath: string): unknown;
+/**
+ * Load and run a file
+ *
+ * Determines execution method based on export type:
+ * - Class/bytecode class -> Instantiate with new, inject as constructor arguments
+ * - Plain function -> Call directly, inject as function arguments
+ * - Other -> Return as-is
+ *
+ * @param filepath - Absolute file path
+ * @param inject - Arguments passed to the constructor or function (spread into the call)
+ * @returns Instantiated class object or function execution result
+ */
 export declare function execFile(filepath: string, ...inject: unknown[]): unknown;
+/**
+ * Resolve the absolute path of a module
+ *
+ * First tries require.resolve(), then falls back to suffix-based rules:
+ * - .default / .prod -> Try .jsc (bytecode version)
+ * - .js -> Try .jsc
+ * - No suffix -> Try .js and .jsc
+ *
+ * @param filepath - Module path
+ * @returns Absolute path of the module, or undefined if it cannot be resolved
+ */
 export declare function resolveModule(filepath: string): string | undefined;
+/**
+ * Get the absolute path of a file under the electron directory
+ *
+ * Relative paths are resolved based on electronDir, and resolveModule is also attempted to find the actual file.
+ *
+ * @param filepath - File path (relative or absolute)
+ * @returns Absolute path of the file
+ * @throws Throws an error if the file does not exist
+ */
 export declare function getFullpath(filepath: string): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/loader/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loader/index.ts"],"names":[],"mappings":"AAOA,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAiBxE;AAGD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAGD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAQxE;AAGD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBlE;AAGD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loader/index.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAkBxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAQxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA4BlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpD"}

package/dist/cjs/loader/index.js

@@ -8,12 +8,34 @@ exports.requireFile = requireFile;
 exports.execFile = execFile;
 exports.resolveModule = resolveModule;
 exports.getFullpath = getFullpath;
+/**
+ * @module loader
+ * @description File loading module. Provides multiple file loading and execution methods,
+ * serving as the foundational dependency for controller loading, config loading, and task execution.
+ *
+ * Core functions:
+ * - loadFile: Load a file, automatically execute if the export is a function
+ * - requireFile: Load a file without auto-execution
+ * - execFile: Load a file, instantiate if class, execute if function
+ * - resolveModule: Resolve the absolute path of a module
+ * - getFullpath: Get the absolute path of a file under the electron directory
+ */
 const type_check_js_1 = require("../utils/type_check.js");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../core/utils/index.js");
 const index_js_2 = require("../ps/index.js");
-// 加载单个文件(如果是函数，将被执行)
+/**
+ * Load a file and automatically execute function exports
+ *
+ * If the file exports a plain function (not a class or bytecode class), automatically calls that function
+ * and returns the execution result. Suitable for config files that need to dynamically return content based on appInfo.
+ *
+ * @param filepath - File path (relative paths are based on electronDir)
+ * @param inject - Arguments passed to the function export (spread into the call)
+ * @returns File export content or function execution result
+ * @throws Throws an error if the file does not exist
+ */
 function loadFile(filepath, ...inject) {
     let fullpath = filepath;
     const isAbsolute = path_1.default.isAbsolute(fullpath);
@@ -25,39 +47,78 @@ function loadFile(filepath, ...inject) {
         throw new Error(`[ee-core] [loader/index] loadFile ${filepath} does not exist`);
     }
     let ret = (0, index_js_1.loadFile)(fullpath);
+    // Plain function export: auto-execute, inject arguments (e.g. appInfo)
     if ((0, type_check_js_1.isFunction)(ret) && !(0, type_check_js_1.isClass)(ret) && !(0, index_js_1.isBytecodeClass)(ret)) {
         ret = ret(...inject);
     }
     return ret;
 }
-// requireFile
+/**
+ * Load a file (without auto-execution)
+ *
+ * Returns the module export content directly, without any processing.
+ * Suitable for scenarios where the original module reference is needed (e.g. child process task loading).
+ *
+ * @param filepath - Absolute file path
+ * @returns Module export content
+ */
 function requireFile(filepath) {
     return (0, index_js_1.loadFile)(filepath);
 }
-// 加载并运行文件
+/**
+ * Load and run a file
+ *
+ * Determines execution method based on export type:
+ * - Class/bytecode class -> Instantiate with new, inject as constructor arguments
+ * - Plain function -> Call directly, inject as function arguments
+ * - Other -> Return as-is
+ *
+ * @param filepath - Absolute file path
+ * @param inject - Arguments passed to the constructor or function (spread into the call)
+ * @returns Instantiated class object or function execution result
+ */
 function execFile(filepath, ...inject) {
     let ret = (0, index_js_1.loadFile)(filepath);
     if ((0, type_check_js_1.isClass)(ret) || (0, index_js_1.isBytecodeClass)(ret)) {
-        ret = new ret(inject);
+        ret = new ret(...inject);
     }
     else if ((0, type_check_js_1.isFunction)(ret)) {
-        ret = ret(inject);
+        ret = ret(...inject);
     }
     return ret;
 }
-// 模块的绝对路径
+/**
+ * Resolve the absolute path of a module
+ *
+ * First tries require.resolve(), then falls back to suffix-based rules:
+ * - .default / .prod -> Try .jsc (bytecode version)
+ * - .js -> Try .jsc
+ * - No suffix -> Try .js and .jsc
+ *
+ * @param filepath - Module path
+ * @returns Absolute path of the module, or undefined if it cannot be resolved
+ */
 function resolveModule(filepath) {
     let fullpath;
     try {
         fullpath = require.resolve(filepath);
     }
     catch {
-        // 特殊后缀处理
-        if (filepath && (filepath.endsWith('.defalut') || filepath.endsWith('.prod'))) {
+        // Special suffix handling: config filenames like config.default, config.prod
+        if (filepath && (filepath.endsWith('.default') || filepath.endsWith('.prod'))) {
             fullpath = filepath + '.jsc';
         }
         else if (filepath && filepath.endsWith('.js')) {
-            fullpath = filepath + 'c';
+            fullpath = filepath + 'c'; // .js → .jsc
+        }
+        // In packaged mode, require.resolve may fail; try checking if the file exists directly
+        if (!fullpath || !fs_1.default.existsSync(fullpath)) {
+            if (fs_1.default.existsSync(filepath + '.js')) {
+                fullpath = filepath + '.js';
+            }
+            else if (fs_1.default.existsSync(filepath + '.jsc')) {
+                fullpath = filepath + '.jsc';
+            }
         }
         if (!fs_1.default.existsSync(filepath) && (!fullpath || !fs_1.default.existsSync(fullpath))) {
             console.warn(`[ee-core] [loader] resolveModule unknow filepath: ${JSON.stringify({ filepath, fullpath })}`);
@@ -66,7 +127,15 @@ function resolveModule(filepath) {
     }
     return fullpath;
 }
-// 获取electron目录下文件的绝对路径
+/**
+ * Get the absolute path of a file under the electron directory
+ *
+ * Relative paths are resolved based on electronDir, and resolveModule is also attempted to find the actual file.
+ *
+ * @param filepath - File path (relative or absolute)
+ * @returns Absolute path of the file
+ * @throws Throws an error if the file does not exist
+ */
 function getFullpath(filepath) {
     let fullpath;
     const isAbsolute = path_1.default.isAbsolute(filepath);

package/dist/cjs/loader/index.js.map

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

package/dist/cjs/log/index.d.ts

@@ -1,5 +1,25 @@
+/**
+ * @module log
+ * @description Log module entry point. Provides log creation, loading, and retrieval functionality.
+ *
+ * Three log instances:
+ * - logger: Application log, records business code output
+ * - coreLogger: Framework core log, records framework internal runtime information
+ * - errorLogger: Error log, only records error/fatal levels
+ *
+ * Wraps log methods with Proxy, compatible with multiple calling styles:
+ * - pino standard: logger.info({ key: 'value' }, 'message')
+ * - pino printf: logger.info('count: %d', 42)
+ * - Concatenation mode: logger.info('msg:', value) → auto-concatenates to 'msg: value'
+ */
 import pino from 'pino';
 import { PinoLoggers } from './logger.js';
+/**
+ * EeLogger interface
+ *
+ * Defines the framework's unified log interface, shielding pino internal implementation details.
+ * Supports six levels: trace/debug/info/warn/error/fatal and child() sub-logger.
+ */
 export interface EeLogger {
     trace(...args: unknown[]): void;
     debug(...args: unknown[]): void;
@@ -9,10 +29,31 @@ export interface EeLogger {
     fatal(...args: unknown[]): void;
     child(bindings: pino.Bindings): EeLogger;
 }
+/**
+ * Create log instances
+ *
+ * @param config - Custom log configuration (optional)
+ * @returns PinoLoggers object
+ */
 export declare function createLog(config?: Record<string, unknown>): PinoLoggers;
+/**
+ * Load log system
+ *
+ * Creates log instances using system configuration. Called by boot.ts init() during framework startup flow.
+ */
 export declare function loadLog(): void;
+/**
+ * Get log instance collection
+ *
+ * If logs have not been loaded yet, automatically triggers loading.
+ *
+ * @returns PinoLoggers object
+ */
 export declare function getLoggers(): PinoLoggers;
+/** Application log instance (Proxy wrapped) */
 export declare const logger: EeLogger;
+/** Framework core log instance (Proxy wrapped) */
 export declare const coreLogger: EeLogger;
+/** Error log instance (Proxy wrapped, error/fatal level only) */
 export declare const errorLogger: EeLogger;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/log/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAU,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAC1C;AAID,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAEvE;AAED,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,wBAAgB,UAAU,IAAI,WAAW,CAGxC;AA6DD,eAAO,MAAM,MAAM,EAAE,QAAwC,CAAC;AAC9D,eAAO,MAAM,UAAU,EAAE,QAA4C,CAAC;AACtE,eAAO,MAAM,WAAW,EAAE,QAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/log/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,WAAW,EAAU,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAC1C;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAGxC;AAgFD,+CAA+C;AAC/C,eAAO,MAAM,MAAM,EAAE,QAA0D,CAAC;AAChF,kDAAkD;AAClD,eAAO,MAAM,UAAU,EAAE,QAA8D,CAAC;AACxF,iEAAiE;AACjE,eAAO,MAAM,WAAW,EAAE,QAA+D,CAAC"}