ee-core 4.1.5 → 5.0.0-beta.5

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

@@ -0,0 +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/cjs/config/config_loader.d.ts.map

@@ -0,0 +1 @@
+{"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/cjs/config/config_loader.js

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": 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 = {};
+        for (const filename of names) {
+            const config = this._loadConfig((0, index_js_1.getElectronDir)(), filename);
+            if (config) {
+                (0, extend_js_1.extend)(true, target, config);
+            }
+        }
+        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)(),
+            electronDir: (0, index_js_1.getElectronDir)(),
+            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);
+        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;
+        return config;
+    }
+}
+exports.ConfigLoader = ConfigLoader;
+//# sourceMappingURL=config_loader.js.map

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

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

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

@@ -0,0 +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/cjs/config/default_config.d.ts.map

@@ -0,0 +1 @@
+{"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/cjs/config/default_config.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": 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,
+            height: 650,
+            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,
+            /** 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: {
+                /** Cross-origin origin setting */
+                origin: true,
+            },
+            /** SocketIO communication channel */
+            channel: channel_js_1.SocketIO.partySoftware,
+        },
+        /** HTTP server configuration */
+        httpServer: {
+            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',
+            /** 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: {},
+    };
+}
+//# sourceMappingURL=default_config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default_config.js","sourceRoot":"","sources":["../../../src/config/default_config.ts"],"names":[],"mappings":";;;;;AAgBA,gCAuLC;AAvMD;;;;;GAKG;AACH,gDAAwB;AACxB,6CAA8D;AAC9D,oDAA+C;AAG/C;;;;GAIG;AACH,SAAwB,aAAa;IACnC,OAAO;QACL,2EAA2E;QAC3E,YAAY,EAAE,KAAK;QACnB,sGAAsG;QACtG,UAAU,EAAE,IAAI;QAEhB,gCAAgC;QAChC,aAAa,EAAE;YACb,KAAK,EAAE,cAAc;YACrB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,GAAG;YACb,SAAS,EAAE,GAAG;YACd,cAAc,EAAE;gBACd,8FAA8F;gBAC9F,0GAA0G;gBAC1G,sFAAsF;gBACtF,gBAAgB,EAAE,KAAK;gBACvB,eAAe,EAAE,IAAI;aACtB;YACD,0CAA0C;YAC1C,KAAK,EAAE,IAAI;YACX,oHAAoH;YACpH,IAAI,EAAE,KAAK;YACX,4BAA4B;YAC5B,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC;SACjE;QAED,4BAA4B;QAC5B,MAAM,EAAE;YACN,iCAAiC;YACjC,GAAG,EAAE,IAAA,oBAAS,GAAE;YAChB,6DAA6D;YAC7D,KAAK,EAAE,MAAM;YACb,qEAAqE;YACrE,WAAW,EAAE,IAAA,gBAAK,GAAE;YACpB,+BAA+B;YAC/B,UAAU,EAAE,YAAY;YACxB,+BAA+B;YAC/B,UAAU,EAAE,QAAQ;YACpB,kCAAkC;YAClC,WAAW,EAAE,aAAa;YAC1B,yBAAyB;YACzB,YAAY,EAAE,cAAc;YAC5B,wDAAwD;YACxD,OAAO,EAAE,KAAK;YACd,mDAAmD;YACnD,MAAM,EAAE,EAAE;YACV,kCAAkC;YAClC,YAAY,EAAE,YAAY;YAC1B,mCAAmC;YACnC,SAAS,EAAE,IAAI;YACf,uFAAuF;YACvF,QAAQ,EAAE,KAAK;YACf,uBAAuB;YACvB,IAAI,EAAE,IAAI;YACV,wCAAwC;YACxC,OAAO,EAAE,KAAK;YACd,uBAAuB;YACvB,WAAW,EAAE,EAAE;YACf,wBAAwB;YACxB,YAAY,EAAE,EAAE;YAChB,uCAAuC;YACvC,UAAU,EAAE,CAAC;YACb,gEAAgE;YAChE,IAAI,EAAE,IAAI;YACV,gCAAgC;YAChC,OAAO,EAAE,IAAI;SACd;QAED,oCAAoC;QACpC,YAAY,EAAE;YACZ,MAAM,EAAE,KAAK;YACb,uEAAuE;YACvE,IAAI,EAAE,IAAI;YACV,oBAAoB;YACpB,IAAI,EAAE,aAAa;YACnB,+CAA+C;YAC/C,cAAc,EAAE,KAAK;YACrB,6CAA6C;YAC7C,WAAW,EAAE,KAAK;YAClB,8CAA8C;YAC9C,YAAY,EAAE,KAAK;YACnB,4CAA4C;YAC5C,iBAAiB,EAAE,GAAG;YACtB,mEAAmE;YACnE,UAAU,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;YACpC,IAAI,EAAE;gBACJ,kCAAkC;gBAClC,MAAM,EAAE,IAAI;aACb;YACD,qCAAqC;YACrC,OAAO,EAAE,qBAAQ,CAAC,aAAa;SAChC;QAED,gCAAgC;QAChC,UAAU,EAAE;YACV,MAAM,EAAE,KAAK;YACb,0BAA0B;YAC1B,KAAK,EAAE;gBACL,MAAM,EAAE,KAAK;gBACb,2BAA2B;gBAC3B,GAAG,EAAE,6BAA6B;gBAClC,2BAA2B;gBAC3B,IAAI,EAAE,6BAA6B;aACpC;YACD,sBAAsB;YACtB,QAAQ,EAAE,SAAS;YACnB,qBAAqB;YACrB,IAAI,EAAE,WAAW;YACjB,uEAAuE;YACvE,IAAI,EAAE,IAAI;YACV,IAAI,EAAE;gBACJ,MAAM,EAAE,GAAG;aACZ;YACD,6DAA6D;YAC7D,IAAI,EAAE;gBACJ,2DAA2D;gBAC3D,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE;oBACV,+CAA+C;oBAC/C,cAAc,EAAE,IAAI;iBACrB;aACF;YACD,2GAA2G;YAC3G,aAAa,EAAE;gBACb,IAAI,EAAE,CAAC,aAAa,CAAC;gBACrB,UAAU,EAAE,EAAE;aACf;YACD,uHAAuH;YACvH,SAAS,EAAE;gBACT,qEAAqE;gBACrE,aAAa,EAAE,EAAE;gBACjB,0EAA0E;gBAC1E,cAAc,EAAE,EAAE;gBAClB,yEAAyE;gBACzE,YAAY,EAAE,IAAI;aACnB;SACF;QAED,mCAAmC;QACnC,MAAM,EAAE;YACN,MAAM,EAAE,KAAK;YACb,yBAAyB;YACzB,GAAG,EAAE,EAAE;SACR;QAED,kFAAkF;QAClF,UAAU,EAAE;YACV,wEAAwE;YACxE,QAAQ,EAAE,SAAS;YACnB,0BAA0B;YAC1B,SAAS,EAAE,yBAAyB;YACpC,mDAAmD;YACnD,OAAO,EAAE,EAAE;YACX,2FAA2F;YAC3F,QAAQ,EAAE,EAAE;YACZ,8FAA8F;YAC9F,WAAW,EAAE,EAAE;YACf,qEAAqE;YACrE,gBAAgB,EAAE,GAAG;SACtB;QAED,uCAAuC;QACvC,SAAS,EAAE;YACT,gDAAgD;YAChD,QAAQ,EAAE,KAAK;YACf,iDAAiD;YACjD,SAAS,EAAE,KAAK;YAChB,oDAAoD;YACpD,YAAY,EAAE,IAAI;SACnB;QAED,mCAAmC;QACnC,IAAI,EAAE;YACJ,kCAAkC;YAClC,UAAU,EAAE,KAAK;SAClB;QAED,oEAAoE;QACpE,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,34 @@
+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/cjs/config/index.d.ts.map

@@ -0,0 +1 @@
+{"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"}

package/dist/cjs/config/index.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.getConfig = getConfig;
+exports.setConfig = setConfig;
+exports.getAppInfo = getAppInfo;
+/**
+ * @module config
+ * @description Configuration module entry point. Provides configuration loading and retrieval functionality.
+ *
+ * Usage:
+ * - loadConfig(): Called once during framework startup to load and merge configuration
+ * - getConfig(): Retrieve the final merged runtime configuration
+ * - getAppInfo(): Retrieve application basic info (name, paths, environment, etc.)
+ */
+const config_loader_js_1 = require("./config_loader.js");
+/** Runtime configuration (assigned after startup) */
+let config = null;
+/**
+ * Load configuration
+ *
+ * Uses ConfigLoader to load and merge default configuration with business configuration.
+ * Called by init() in boot.ts during the framework startup flow.
+ */
+function loadConfig() {
+    const loader = new config_loader_js_1.ConfigLoader();
+    config = loader.load();
+}
+/**
+ * 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
+ */
+function getConfig() {
+    if (!config) {
+        loadConfig();
+    }
+    return 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
+ */
+function setConfig(cfg) {
+    config = cfg;
+}
+/**
+ * Get application basic info
+ *
+ * @returns Object containing application name, directories, environment, and other info
+ */
+function getAppInfo() {
+    return {
+        name: process.env.EE_APP_NAME || '',
+        baseDir: process.env.EE_BASE_DIR || '',
+        electronDir: process.env.EE_ELECTRON_DIR || '',
+        env: process.env.EE_ENV || 'prod',
+        root: process.env.EE_BASE_DIR || '',
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;AAqBA,gCAGC;AAUD,8BAKC;AAWD,8BAEC;AAOD,gCAQC;AAnED;;;;;;;;GAQG;AACH,yDAAkD;AAGlD,qDAAqD;AACrD,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC;;;;;GAKG;AACH,SAAgB,UAAU;IACxB,MAAM,MAAM,GAAG,IAAI,+BAAY,EAAE,CAAC;IAClC,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;IACf,CAAC;IACD,OAAO,MAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,GAAW;IACnC,MAAM,GAAG,GAAG,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU;IACxB,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QACtC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;QAC9C,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM;QACjC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/cjs/const/channel.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @module const/channel
+ * @description IPC communication channel and event constant definitions.
+ * Centrally manages channel names and event names used internally by the framework, avoiding hardcoded strings.
+ */
+/** Inter-process communication channels */
+export declare const Processes: {
+    /** Exception display channel: renderer process displays an exception dialog upon receiving this channel message */
+    readonly showException: "ee#showException";
+    /** Channel for child process to send messages to the main process */
+    readonly sendToMain: "ee#sendToMain";
+};
+/** SocketIO communication channels */
+export declare const SocketIO: {
+    /** Third-party software communication channel (default SocketIO communication channel name) */
+    readonly partySoftware: "socket-channel";
+};
+/** Process lifecycle events */
+export declare const Events: {
+    /** Child process exit event */
+    readonly childProcessExit: "ee#childProcess#exit";
+    /** Child process error event */
+    readonly childProcessError: "ee#childProcess#error";
+};
+/** Message receiver types */
+export declare const Receiver: {
+    /** ChildJob-type child process */
+    readonly childJob: "job";
+    /** Fork process (generic task) */
+    readonly forkProcess: "task";
+    /** All receivers */
+    readonly all: "all";
+};
+//# sourceMappingURL=channel.d.ts.map

package/dist/cjs/const/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/const/channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,eAAO,MAAM,SAAS;IACpB,mHAAmH;;IAEnH,qEAAqE;;CAE7D,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,QAAQ;IACnB,+FAA+F;;CAEvF,CAAC;AAEX,+BAA+B;AAC/B,eAAO,MAAM,MAAM;IACjB,+BAA+B;;IAE/B,gCAAgC;;CAExB,CAAC;AAEX,6BAA6B;AAC7B,eAAO,MAAM,QAAQ;IACnB,kCAAkC;;IAElC,kCAAkC;;IAElC,oBAAoB;;CAEZ,CAAC"}

package/dist/cjs/const/channel.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * @module const/channel
+ * @description IPC communication channel and event constant definitions.
+ * Centrally manages channel names and event names used internally by the framework, avoiding hardcoded strings.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Receiver = exports.Events = exports.SocketIO = exports.Processes = void 0;
+/** Inter-process communication channels */
+exports.Processes = {
+    /** Exception display channel: renderer process displays an exception dialog upon receiving this channel message */
+    showException: 'ee#showException',
+    /** Channel for child process to send messages to the main process */
+    sendToMain: 'ee#sendToMain',
+};
+/** SocketIO communication channels */
+exports.SocketIO = {
+    /** Third-party software communication channel (default SocketIO communication channel name) */
+    partySoftware: 'socket-channel',
+};
+/** Process lifecycle events */
+exports.Events = {
+    /** Child process exit event */
+    childProcessExit: 'ee#childProcess#exit',
+    /** Child process error event */
+    childProcessError: 'ee#childProcess#error',
+};
+/** Message receiver types */
+exports.Receiver = {
+    /** ChildJob-type child process */
+    childJob: 'job',
+    /** Fork process (generic task) */
+    forkProcess: 'task',
+    /** All receivers */
+    all: 'all',
+};
+//# sourceMappingURL=channel.js.map

package/dist/cjs/const/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/const/channel.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAA2C;AAC9B,QAAA,SAAS,GAAG;IACvB,mHAAmH;IACnH,aAAa,EAAE,kBAAkB;IACjC,qEAAqE;IACrE,UAAU,EAAE,eAAe;CACnB,CAAC;AAEX,sCAAsC;AACzB,QAAA,QAAQ,GAAG;IACtB,+FAA+F;IAC/F,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAEX,+BAA+B;AAClB,QAAA,MAAM,GAAG;IACpB,+BAA+B;IAC/B,gBAAgB,EAAE,sBAAsB;IACxC,gCAAgC;IAChC,iBAAiB,EAAE,uBAAuB;CAClC,CAAC;AAEX,6BAA6B;AAChB,QAAA,QAAQ,GAAG;IACtB,kCAAkC;IAClC,QAAQ,EAAE,KAAK;IACf,kCAAkC;IAClC,WAAW,EAAE,MAAM;IACnB,oBAAoB;IACpB,GAAG,EAAE,KAAK;CACF,CAAC"}

package/dist/cjs/controller/controller_loader.d.ts

@@ -0,0 +1,29 @@
+import { Timing } from '../core/utils/timing.js';
+/**
+ * ControllerLoader — Controller loader
+ *
+ * Responsible for loading all controller files under the electron/controller/ directory
+ * and wrapping class methods into callable middleware functions.
+ */
+export declare class ControllerLoader {
+    timing: Timing;
+    constructor();
+    /**
+     * Load controllers synchronously
+     *
+     * Uses registry first (bundle mode), otherwise falls back to globby file scanning (dev mode).
+     *
+     * @returns Controller method mapping object, structured as { controller: { module: { method: fn } } }
+     */
+    load(): Record<string, unknown>;
+    /**
+     * Load controllers asynchronously (ESM support)
+     *
+     * Uses dynamic import() instead of require(), supporting ESM format controller files.
+     * Same flow as load(), but file loading and parsing are asynchronous operations.
+     *
+     * @returns Controller method mapping object
+     */
+    loadAsync(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=controller_loader.d.ts.map

package/dist/cjs/controller/controller_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller_loader.d.ts","sourceRoot":"","sources":["../../../src/controller/controller_loader.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAOjD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,EAAE,MAAM,CAAC;;IAMf;;;;;;OAMG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuB/B;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAsBpD"}