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

package/dist/esm/app/events.js

@@ -1,44 +1,124 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.eventBus = exports.EventBus = exports.Preload = exports.BeforeClose = exports.WindowReady = exports.ElectronAppReady = exports.Ready = void 0;
+/**
+ * @module app/events
+ * @description Event bus module, providing lifecycle events and custom event mechanisms within the framework.
+ *
+ * Two event types:
+ * - Lifecycle events (lifecycleEvents): Triggered at framework core milestones, e.g. ready, electron-app-ready, window-ready
+ * - Custom events (eventsMap): Freely used by business code via on/emit
+ *
+ * Event handlers support both synchronous and asynchronous functions. Async errors are caught and logged
+ * without causing the process to crash.
+ */
+const index_js_1 = require("../log/index.js");
+/** Lifecycle: Framework foundational features loaded (controllers, communication services ready) */
 exports.Ready = 'ready';
+/** Lifecycle: Electron app.whenReady() completed */
 exports.ElectronAppReady = 'electron-app-ready';
+/** Lifecycle: Main window created */
 exports.WindowReady = 'window-ready';
+/** Lifecycle: Before window closes, can be used for cleanup operations */
 exports.BeforeClose = 'before-close';
+/** Lifecycle: Preload script injection timing */
 exports.Preload = 'preload';
+/**
+ * EventBus — Event bus
+ *
+ * Design highlights:
+ * - Lifecycle events and custom events are stored separately to avoid naming conflicts
+ * - register() registers lifecycle events, on() registers custom events
+ * - Re-registering the same event name overwrites the previous handler and outputs a warning (rather than silently ignoring)
+ * - emit methods have built-in try/catch, ensuring a single handler exception does not affect other logic
+ * - Promises returned by async handlers have errors automatically caught
+ */
 class EventBus {
     constructor() {
+        /** Lifecycle event handler mapping */
         this.lifecycleEvents = {};
+        /** Custom event handler mapping */
         this.eventsMap = {};
     }
-    // add lifecycle event
+    /**
+     * Register a lifecycle event handler
+     *
+     * Lifecycle events are triggered internally by the framework; business code registers hooks via this method.
+     * If the event name is already registered, the old handler is overwritten and a warning is logged.
+     *
+     * @param eventName - Lifecycle event name (Ready / ElectronAppReady / WindowReady / BeforeClose / Preload)
+     * @param handler - Event handler function, supports sync or async
+     */
     register(eventName, handler) {
-        if (!this.lifecycleEvents[eventName]) {
-            this.lifecycleEvents[eventName] = handler;
+        if (this.lifecycleEvents[eventName]) {
+            index_js_1.coreLogger.warn(`[EventBus] Lifecycle event '${eventName}' already registered, overriding.`);
         }
+        this.lifecycleEvents[eventName] = handler;
     }
-    // call lifecycle event
-    // [todo] 如果是一个 async 函数，且函数的运行时间比较长，如何正确执行
+    /**
+     * Emit a lifecycle event
+     *
+     * Invokes the corresponding event handler. Errors are NOT silently swallowed —
+     * sync errors propagate to the caller, async errors are re-thrown as unhandled rejections
+     * (caught by the global exception handler).
+     *
+     * @param eventName - Lifecycle event name
+     * @param args - Arguments passed to the handler
+     */
     emitLifecycle(eventName, ...args) {
         const eventFn = this.lifecycleEvents[eventName];
-        if (eventFn) {
-            eventFn(...args);
+        if (!eventFn)
+            return;
+        const result = eventFn(...args);
+        // Async handler: re-throw as unhandled rejection so the global handler catches it
+        if (result instanceof Promise) {
+            result.catch((err) => {
+                index_js_1.coreLogger.error(`[EventBus] Async lifecycle handler '${eventName}' error:`, err);
+                throw err;
+            });
         }
     }
-    // add listener
+    /**
+     * Register a custom event handler
+     *
+     * Business code can register custom events via this method, triggered by business code itself.
+     * If the event name is already registered, the old handler is overwritten and a warning is logged.
+     *
+     * @param eventName - Custom event name
+     * @param handler - Event handler function, supports sync or async
+     */
     on(eventName, handler) {
-        if (!this.eventsMap[eventName]) {
-            this.eventsMap[eventName] = handler;
+        if (this.eventsMap[eventName]) {
+            index_js_1.coreLogger.warn(`[EventBus] Event '${eventName}' already registered, overriding.`);
         }
+        this.eventsMap[eventName] = handler;
     }
-    // emit listener
+    /**
+     * Emit a custom event
+     *
+     * Invokes the corresponding event handler, automatically catching synchronous exceptions and async rejections.
+     *
+     * @param eventName - Custom event name
+     * @param args - Arguments passed to the handler
+     */
     emit(eventName, ...args) {
         const eventFn = this.eventsMap[eventName];
         if (eventFn) {
-            eventFn(...args);
+            try {
+                const result = eventFn(...args);
+                if (result instanceof Promise) {
+                    result.catch((err) => {
+                        index_js_1.coreLogger.error(`[EventBus] Async event handler '${eventName}' error:`, err);
+                    });
+                }
+            }
+            catch (err) {
+                index_js_1.coreLogger.error(`[EventBus] Event handler '${eventName}' error:`, err);
+            }
         }
     }
 }
 exports.EventBus = EventBus;
+/** Event bus singleton, globally shared */
 exports.eventBus = new EventBus();
 //# sourceMappingURL=events.js.map

package/dist/esm/app/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/app/events.ts"],"names":[],"mappings":";;;AAAa,QAAA,KAAK,GAAG,OAAO,CAAC;AAChB,QAAA,gBAAgB,GAAG,oBAAoB,CAAC;AACxC,QAAA,WAAW,GAAG,cAAc,CAAC;AAC7B,QAAA,WAAW,GAAG,cAAc,CAAC;AAC7B,QAAA,OAAO,GAAG,SAAS,CAAC;AAEjC,MAAa,QAAQ;IAArB;QACU,oBAAe,GAAiD,EAAE,CAAC;QACnE,cAAS,GAAiD,EAAE,CAAC;IAgCvE,CAAC;IA9BC,sBAAsB;IACtB,QAAQ,CAAC,SAAiB,EAAE,OAAqC;QAC/D,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,2CAA2C;IAC3C,aAAa,CAAC,SAAiB,EAAE,GAAG,IAAe;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,eAAe;IACf,EAAE,CAAC,SAAiB,EAAE,OAAqC;QACzD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QACtC,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,SAAiB,EAAE,GAAG,IAAe;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAlCD,4BAkCC;AAEY,QAAA,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/app/events.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,8CAA6C;AAE7C,oGAAoG;AACvF,QAAA,KAAK,GAAG,OAAO,CAAC;AAC7B,oDAAoD;AACvC,QAAA,gBAAgB,GAAG,oBAAoB,CAAC;AACrD,qCAAqC;AACxB,QAAA,WAAW,GAAG,cAAc,CAAC;AAC1C,0EAA0E;AAC7D,QAAA,WAAW,GAAG,cAAc,CAAC;AAC1C,iDAAiD;AACpC,QAAA,OAAO,GAAG,SAAS,CAAC;AAIjC;;;;;;;;;GASG;AACH,MAAa,QAAQ;IAArB;QACE,sCAAsC;QAC9B,oBAAe,GAAiC,EAAE,CAAC;QAC3D,mCAAmC;QAC3B,cAAS,GAAiC,EAAE,CAAC;IAiFvD,CAAC;IA/EC;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAqB;QAC/C,IAAI,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,qBAAU,CAAC,IAAI,CAAC,+BAA+B,SAAS,mCAAmC,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC5C,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,SAAiB,EAAE,GAAG,IAAe;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,kFAAkF;QAClF,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBAC5B,qBAAU,CAAC,KAAK,CAAC,uCAAuC,SAAS,UAAU,EAAE,GAAG,CAAC,CAAC;gBAClF,MAAM,GAAG,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,EAAE,CAAC,SAAiB,EAAE,OAAqB;QACzC,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,qBAAU,CAAC,IAAI,CAAC,qBAAqB,SAAS,mCAAmC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IACtC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,SAAiB,EAAE,GAAG,IAAe;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;gBAChC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;wBAC5B,qBAAU,CAAC,KAAK,CAAC,mCAAmC,SAAS,UAAU,EAAE,GAAG,CAAC,CAAC;oBAChF,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,qBAAU,CAAC,KAAK,CAAC,6BAA6B,SAAS,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;CACF;AArFD,4BAqFC;AAED,2CAA2C;AAC9B,QAAA,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC"}

package/dist/esm/config/config_loader.d.ts

@@ -1,10 +1,54 @@
 import { Timing } from '../core/utils/timing.js';
 import type { Config } from '../types/index.js';
+/** Structure of a configuration registry entry in bundle mode */
+interface ConfigRegistryEntry {
+    /** Configuration filename (without extension), e.g. 'config.default', 'config.prod' */
+    filename: string;
+    /** Configuration module, can be an object or function (function receives appInfo parameter) */
+    module: unknown;
+}
+declare global {
+    var __EE_CONFIG_REGISTRY__: ConfigRegistryEntry[] | undefined;
+}
+/**
+ * ConfigLoader — Configuration loader
+ *
+ * Deep merges default configuration with business configuration to produce the final runtime configuration.
+ * Loading order: defaultConfig (framework built-in) -> config.default (business defaults) -> config.{env} (environment-specific)
+ * Later-loaded configuration overrides same-named properties of earlier-loaded configuration.
+ */
 export declare class ConfigLoader {
     timing: Timing;
     constructor();
+    /**
+     * Load and merge configuration
+     *
+     * @returns Merged complete runtime configuration
+     */
     load(): Config;
+    /**
+     * Load business custom configuration
+     *
+     * Loads config.default and config.{env} in order; the latter overrides the former.
+     * In development, loads config.local; in production, loads config.prod.
+     *
+     * @returns Merged business configuration
+     */
     private _AppConfig;
+    /**
+     * Load a single configuration file
+     *
+     * Supports two modes:
+     * - Bundle mode: Finds the configuration module by filename from __EE_CONFIG_REGISTRY__
+     * - Dev mode: Loads from filesystem via loadFile()
+     *
+     * Configuration files can export functions; the function receives an appInfo parameter for dynamic configuration.
+     *
+     * @param dirpath - Directory containing the configuration file (electron directory)
+     * @param filename - Configuration filename (without extension)
+     * @returns Configuration object, or null if loading fails
+     */
     private _loadConfig;
 }
+export {};
 //# sourceMappingURL=config_loader.d.ts.map

package/dist/esm/config/config_loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config_loader.d.ts","sourceRoot":"","sources":["../../../src/config/config_loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIzD,qBAAa,YAAY;IACvB,MAAM,EAAE,MAAM,CAAC;;IAMf,IAAI,IAAI,MAAM;IAYd,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,WAAW;CAepB"}
+{"version":3,"file":"config_loader.d.ts","sourceRoot":"","sources":["../../../src/config/config_loader.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIzD,iEAAiE;AACjE,UAAU,mBAAmB;IAC3B,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,sBAAsB,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;CAC/D;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,MAAM,EAAE,MAAM,CAAC;;IAMf;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAed;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,WAAW;CA2CpB"}

package/dist/esm/config/config_loader.js

@@ -4,27 +4,67 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigLoader = void 0;
+/**
+ * @module config/config_loader
+ * @description Configuration loader. Responsible for loading and merging framework default configuration
+ * with business custom configuration.
+ *
+ * Configuration loading flow:
+ * 1. Load framework built-in default configuration (defaultConfig)
+ * 2. Load business configuration: first load config.default (full defaults), then load config.{env} (environment-specific)
+ * 3. Deep merge: business configuration overrides default configuration
+ *
+ * Supports two loading modes:
+ * - Bundle mode: Reads pre-registered configuration modules from globalThis.__EE_CONFIG_REGISTRY__
+ * - Dev mode: Loads configuration files from the filesystem by path
+ *
+ * Configuration files support function exports. The function receives an appInfo parameter and can dynamically return configuration based on environment.
+ */
 const debug_1 = __importDefault(require("debug"));
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../ps/index.js");
 const extend_js_1 = require("../utils/extend.js");
 const index_js_2 = require("../loader/index.js");
+const type_check_js_1 = require("../utils/type_check.js");
 const timing_js_1 = require("../core/utils/timing.js");
 const default_config_js_1 = __importDefault(require("./default_config.js"));
 const debugLog = (0, debug_1.default)('ee-core:config:config_loader');
+/**
+ * ConfigLoader — Configuration loader
+ *
+ * Deep merges default configuration with business configuration to produce the final runtime configuration.
+ * Loading order: defaultConfig (framework built-in) -> config.default (business defaults) -> config.{env} (environment-specific)
+ * Later-loaded configuration overrides same-named properties of earlier-loaded configuration.
+ */
 class ConfigLoader {
     constructor() {
         this.timing = new timing_js_1.Timing();
     }
+    /**
+     * Load and merge configuration
+     *
+     * @returns Merged complete runtime configuration
+     */
     load() {
         this.timing.start('Load Config');
+        // Load business custom configuration (config.default + config.{env})
         const appConfig = this._AppConfig();
+        // Load framework default configuration
         const defaultConf = (0, default_config_js_1.default)();
+        // Deep merge: business configuration overrides default configuration
         const config = (0, extend_js_1.extend)(true, defaultConf, appConfig);
         debugLog('[load] config: %o', config);
         this.timing.end('Load Config');
         return config;
     }
+    /**
+     * Load business custom configuration
+     *
+     * Loads config.default and config.{env} in order; the latter overrides the former.
+     * In development, loads config.local; in production, loads config.prod.
+     *
+     * @returns Merged business configuration
+     */
     _AppConfig() {
         const names = ['config.default', `config.${(0, index_js_1.env)()}`];
         const target = {};
@@ -36,7 +76,21 @@ class ConfigLoader {
         }
         return target;
     }
+    /**
+     * Load a single configuration file
+     *
+     * Supports two modes:
+     * - Bundle mode: Finds the configuration module by filename from __EE_CONFIG_REGISTRY__
+     * - Dev mode: Loads from filesystem via loadFile()
+     *
+     * Configuration files can export functions; the function receives an appInfo parameter for dynamic configuration.
+     *
+     * @param dirpath - Directory containing the configuration file (electron directory)
+     * @param filename - Configuration filename (without extension)
+     * @returns Configuration object, or null if loading fails
+     */
     _loadConfig(dirpath, filename) {
+        // Build appInfo for use by configuration functions
         const appInfo = {
             name: (0, index_js_1.appName)(),
             baseDir: (0, index_js_1.getBaseDir)(),
@@ -44,8 +98,35 @@ class ConfigLoader {
             env: (0, index_js_1.env)(),
             root: (0, index_js_1.getRootDir)(),
         };
+        if (globalThis.__EE_CONFIG_REGISTRY__) {
+            // Bundle mode: find configuration module from registry
+            const entry = globalThis.__EE_CONFIG_REGISTRY__.find((e) => e.filename === filename);
+            if (!entry)
+                return null;
+            // ESM interop: esbuild wraps config modules as { __esModule: true, default: fn }.
+            // Unwrap .default only when the __esModule marker is present, matching FileLoader.parseFromRegistry().
+            let mod = entry.module;
+            if (mod && mod.__esModule && 'default' in mod) {
+                mod = mod.default;
+            }
+            debugLog('[_loadConfig] bundled filename: %s', filename);
+            // Configuration file may export a function, receiving appInfo to dynamically generate configuration
+            if ((0, type_check_js_1.isFunction)(mod)) {
+                return mod(appInfo);
+            }
+            return mod;
+        }
+        // Dev mode: load from filesystem
+        // Silently skip if file not found (e.g. child process where bundle dir lacks config files)
         const filepath = path_1.default.join(dirpath, 'config', filename);
-        const config = (0, index_js_2.loadFile)(filepath, appInfo);
+        let config;
+        try {
+            config = (0, index_js_2.loadFile)(filepath, appInfo);
+        }
+        catch {
+            debugLog('[_loadConfig] file not found, skipping: %s', filepath);
+            return null;
+        }
         debugLog('[_loadConfig] filepath: %s', filepath);
         if (!config)
             return null;

package/dist/esm/config/config_loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"config_loader.js","sourceRoot":"","sources":["../../../src/config/config_loader.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,gDAAwB;AACxB,6CAAsF;AACtF,kDAA4C;AAC5C,iDAA8C;AAC9C,uDAAiD;AACjD,4EAAgD;AAGhD,MAAM,QAAQ,GAAG,IAAA,eAAK,EAAC,8BAA8B,CAAC,CAAC;AAEvD,MAAa,YAAY;IAGvB;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,IAAA,2BAAa,GAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAA,kBAAM,EAAC,IAAI,EAAE,WAAsC,EAAE,SAAS,CAAW,CAAC;QACzF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,UAAU;QAChB,MAAM,KAAK,GAAG,CAAC,gBAAgB,EAAE,UAAU,IAAA,cAAG,GAAE,EAAE,CAAC,CAAC;QACpD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAA,yBAAc,GAAE,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,MAAM,EAAE,CAAC;gBACX,IAAA,kBAAM,EAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,WAAW,CAAC,OAAe,EAAE,QAAgB;QACnD,MAAM,OAAO,GAAY;YACvB,IAAI,EAAE,IAAA,kBAAO,GAAE;YACf,OAAO,EAAE,IAAA,qBAAU,GAAE;YACrB,WAAW,EAAE,IAAA,yBAAc,GAAE;YAC7B,GAAG,EAAE,IAAA,cAAG,GAAE;YACV,IAAI,EAAE,IAAA,qBAAU,GAAE;SACnB,CAAC;QACF,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,OAAO,MAAiC,CAAC;IAC3C,CAAC;CACF;AA9CD,oCA8CC"}
+{"version":3,"file":"config_loader.js","sourceRoot":"","sources":["../../../src/config/config_loader.ts"],"names":[],"mappings":"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"}

package/dist/esm/config/default_config.d.ts

@@ -1,3 +1,8 @@
 import type { Config } from '../types/index.js';
+/**
+ * Generate framework default configuration
+ *
+ * @returns Complete default configuration object
+ */
 export default function defaultConfig(): Config;
 //# sourceMappingURL=default_config.d.ts.map

package/dist/esm/config/default_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default_config.d.ts","sourceRoot":"","sources":["../../../src/config/default_config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,OAAO,UAAU,aAAa,IAAI,MAAM,CAkG9C"}
+{"version":3,"file":"default_config.d.ts","sourceRoot":"","sources":["../../../src/config/default_config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,IAAI,MAAM,CAuL9C"}

package/dist/esm/config/default_config.js

@@ -4,13 +4,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = defaultConfig;
+/**
+ * @module config/default_config
+ * @description Framework built-in default configuration. All configuration items have default values defined here;
+ * business configuration can override them. Configuration items are grouped by function:
+ * window, logging, communication services, main server, exception handling, jobs, cross-process.
+ */
 const path_1 = __importDefault(require("path"));
 const index_js_1 = require("../ps/index.js");
 const channel_js_1 = require("../const/channel.js");
+/**
+ * Generate framework default configuration
+ *
+ * @returns Complete default configuration object
+ */
 function defaultConfig() {
     return {
+        /** Whether to open DevTools (only effective in development environment) */
         openDevTools: false,
+        /** Whether to enable single-instance lock (prevents running multiple app instances simultaneously) */
         singleLock: true,
+        /** Main window configuration */
         windowsOption: {
             title: 'electron-egg',
             width: 980,
@@ -18,91 +32,164 @@ function defaultConfig() {
             minWidth: 400,
             minHeight: 300,
             webPreferences: {
+                // Security warning: contextIsolation=false + nodeIntegration=true allows the renderer process
+                // full access to Node.js APIs. Any XSS vulnerability in the renderer could lead to remote code execution.
+                // New projects are recommended to set contextIsolation=true and use a preload script.
                 contextIsolation: false,
                 nodeIntegration: true,
             },
+            /** Whether to show native window frame */
             frame: true,
+            /** Whether to show the window immediately on creation (false allows loading content first to avoid blank screen) */
             show: false,
+            /** Application icon path */
             icon: path_1.default.join((0, index_js_1.getBaseDir)(), 'public', 'images', 'logo-32.png'),
         },
+        /** Logging configuration */
         logger: {
+            /** Log file storage directory */
             dir: (0, index_js_1.getLogDir)(),
+            /** Log level: trace < debug < info < warn < error < fatal */
             level: 'info',
+            /** Whether to use pretty format output in development environment */
             prettyPrint: (0, index_js_1.isDev)(),
+            /** Log filename date format */
             dateFormat: 'yyyy-MM-dd',
+            /** Application log filename */
             appLogName: 'ee.log',
+            /** Framework core log filename */
             coreLogName: 'ee-core.log',
+            /** Error log filename */
             errorLogName: 'ee-error.log',
+            /** Log rotation strategy: day (daily), hour (hourly) */
             rotator: 'day',
+            /** List of field paths that need to be redacted */
             redact: [],
+            /** Redaction replacement value */
             redactCensor: '[Redacted]',
+            /** Whether to include timestamp */
             timestamp: true,
+            /** IANA timezone for log timestamps (file JSON logs); 'UTC' or e.g. 'Asia/Shanghai' */
+            timezone: 'UTC',
+            /** pino logger name */
             name: 'ee',
+            /** Maximum size of a single log file */
             maxSize: '10m',
+            /** pino serializers */
             serializers: {},
+            /** Custom log levels */
             customLevels: {},
+            /** Object serialization depth limit */
             depthLimit: 5,
+            /** Safe mode: do not throw exceptions when log writing fails */
             safe: true,
+            /** Whether to enable logging */
             enabled: true,
         },
+        /** SocketIO server configuration */
         socketServer: {
-            enable: false, // is it enabled
-            port: 7070, // default port (if the port is in use, randomly select one)
-            path: "/socket.io/", // path
-            connectTimeout: 45000, // client connection timeout
-            pingTimeout: 30000, // heartbeat detection timeout
-            pingInterval: 25000, // heartbeat detection interval
-            maxHttpBufferSize: 1e8, // the data size of each message 1M
-            transports: ["polling", "websocket"], // http polling or websocket
+            enable: false,
+            /** Default port (automatically selects a random port when occupied) */
+            port: 7070,
+            /** SocketIO path */
+            path: "/socket.io/",
+            /** Client connection timeout (milliseconds) */
+            connectTimeout: 45000,
+            /** Heartbeat check timeout (milliseconds) */
+            pingTimeout: 30000,
+            /** Heartbeat check interval (milliseconds) */
+            pingInterval: 25000,
+            /** Maximum data size per message (100MB) */
+            maxHttpBufferSize: 1e8,
+            /** Transport methods: polling (HTTP long-polling) and websocket */
+            transports: ["polling", "websocket"],
             cors: {
-                origin: true, // http协议时，要设置跨域 类型 Boolean String RegExp Array Function
+                /** Cross-origin origin setting */
+                origin: true,
             },
+            /** SocketIO communication channel */
             channel: channel_js_1.SocketIO.partySoftware,
         },
+        /** HTTP server configuration */
         httpServer: {
-            enable: false, // is it enabled
+            enable: false,
+            /** HTTPS configuration */
             https: {
                 enable: false,
+                /** SSL private key path */
                 key: '/public/ssl/localhost+1.key',
+                /** SSL certificate path */
                 cert: '/public/ssl/localhost+1.pem',
             },
+            /** Protocol prefix */
             protocol: 'http://',
+            /** Listen address */
             host: '127.0.0.1',
-            port: 7071, // Default port (if the port is in use, randomly select one)
+            /** Default port (automatically selects a random port when occupied) */
+            port: 7071,
             cors: {
                 origin: '*',
             },
+            /** Request body parsing configuration (based on koa-body) */
             body: {
+                /** Whether to support multipart/form-data (file upload) */
                 multipart: true,
                 formidable: {
+                    /** Whether to keep uploaded file extensions */
                     keepExtensions: true,
                 },
             },
+            /** Request filter rules: matching URIs return specified data directly without going through controllers */
             filterRequest: {
                 uris: ['favicon.ico'],
                 returnData: '',
             },
+            /** Koa middleware extension: pre/post middleware chains and a custom error handler (all optional, empty by default) */
+            koaConfig: {
+                /** Middleware executed before route handling (e.g. auth, logging) */
+                preMiddleware: [],
+                /** Middleware executed after route handling (e.g. response formatting) */
+                postMiddleware: [],
+                /** Custom Koa error handler; null falls back to the framework default */
+                errorHandler: null,
+            },
         },
+        /** Remote service configuration */
         remote: {
             enable: false,
+            /** Remote service URL */
             url: '',
         },
+        /** Main server configuration (controls how the renderer process loads content) */
         mainServer: {
+            /** Protocol: file:// loads local files, http:// loads remote service */
             protocol: 'file://',
+            /** Home page file path */
             indexPath: '/public/dist/index.html',
+            /** Additional options for BrowserWindow.loadURL */
             options: {},
+            /** Cross-process takeover identifier: when non-empty, the Cross module provides the URL */
             takeover: '',
+            /** Loading page path: shown first after window creation, switches to main page once loaded */
             loadingPage: '',
+            /** IPC channel separator, used for concatenating controller paths */
             channelSeparator: '/',
         },
+        /** Exception handling configuration */
         exception: {
+            /** Whether to exit on main process exception */
             mainExit: false,
+            /** Whether to exit on child process exception */
             childExit: false,
+            /** Whether to exit on renderer process exception */
             rendererExit: true,
         },
+        /** Background job configuration */
         jobs: {
+            /** Whether to log job messages */
             messageLog: false,
         },
+        /** Cross-process communication configuration (dynamically added) */
         cross: {},
     };
 }

package/dist/esm/config/default_config.js.map

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

package/dist/esm/config/index.d.ts

@@ -1,4 +1,34 @@
-import type { Config } from '../types/index.js';
+import type { AppInfo, Config } from '../types/index.js';
+/**
+ * Load configuration
+ *
+ * Uses ConfigLoader to load and merge default configuration with business configuration.
+ * Called by init() in boot.ts during the framework startup flow.
+ */
 export declare function loadConfig(): void;
+/**
+ * Get runtime configuration
+ *
+ * If configuration has not been loaded yet, loading is automatically triggered.
+ * Typically used after framework startup to ensure configuration is ready.
+ *
+ * @returns Complete runtime configuration object
+ */
 export declare function getConfig(): Config;
+/**
+ * Set runtime configuration directly
+ *
+ * Used by child processes to receive config from the main process,
+ * avoiding filesystem loading which may fail in child processes
+ * (e.g. bundle output directory lacks config files).
+ *
+ * @param cfg - Configuration object to set
+ */
+export declare function setConfig(cfg: Config): void;
+/**
+ * Get application basic info
+ *
+ * @returns Object containing application name, directories, environment, and other info
+ */
+export declare function getAppInfo(): AppInfo;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAQpC"}