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

package/dist/cjs/electron/window/index.js

@@ -9,6 +9,17 @@ exports.restoreMainWindow = restoreMainWindow;
 exports.setCloseAndQuit = setCloseAndQuit;
 exports.getCloseAndQuit = getCloseAndQuit;
 exports.loadServer = loadServer;
+/**
+ * @module electron/window
+ * @description Main window management module. Responsible for creating BrowserWindow, loading page content,
+ * and handling page loading logic in development/production environments.
+ *
+ * Page loading strategy:
+ * - Remote mode (remote.enable=true): Load remote URL
+ * - Development mode: Load frontend dev server (http://localhost:8080), wait for service to be ready
+ * - Production mode + cross takeover: Wait for cross-process service to be ready then load its URL
+ * - Production mode (default): Load locally packaged HTML file
+ */
 const debug_1 = __importDefault(require("debug"));
 const type_check_js_1 = require("../../utils/type_check.js");
 const path_1 = __importDefault(require("path"));
@@ -20,35 +31,81 @@ const index_js_2 = require("../../ps/index.js");
 const index_js_3 = require("../../log/index.js");
 const index_js_4 = require("../../loader/index.js");
 const index_js_5 = require("../../utils/index.js");
-const index_js_6 = require("../../html/index.js");
 const helper_js_1 = require("../../utils/helper.js");
 const extend_js_1 = require("../../utils/extend.js");
-const index_js_7 = require("../../cross/index.js");
+const index_js_6 = require("../../cross/index.js");
+const index_js_7 = require("../../html/index.js");
 const debugLog = (0, debug_1.default)('ee-core:electron:window');
+/**
+ * Wait for URL to be reachable
+ *
+ * Polls via HTTP GET request to check if service is ready.
+ * Used to wait for frontend dev server or cross-process service to finish starting.
+ *
+ * @param url - URL to check
+ * @param options - Polling options
+ * @param options.retries - Maximum number of retries
+ * @param options.intervalMs - Retry interval (milliseconds)
+ * @param options.timeoutMs - Single request timeout (milliseconds)
+ * @returns Whether the URL is reachable within the retry count
+ */
+async function waitForUrl(url, options) {
+    let count = 0;
+    let ready = false;
+    while (!ready && count < options.retries) {
+        await (0, helper_js_1.sleep)(options.intervalMs);
+        try {
+            await (0, axios_1.default)({
+                method: 'get',
+                url,
+                timeout: options.timeoutMs,
+                proxy: false,
+                headers: { 'Accept': 'text/html, application/json, text/plain, */*' },
+            });
+            ready = true;
+        }
+        catch {
+            // Service not ready, continue retrying
+        }
+        count++;
+    }
+    return ready;
+}
+/** Main window instance and exit flag */
 const Instance = {
     mainWindow: null,
     closeAndQuit: true,
 };
-// getMainWindow
+/**
+ * Get main window instance
+ *
+ * @returns BrowserWindow instance, or null if not created
+ */
 function getMainWindow() {
     return Instance.mainWindow;
 }
-// Create the main application window
+/**
+ * Create main application window
+ *
+ * Creates BrowserWindow using config.windowsOption configuration.
+ * When openDevTools=true in config, automatically opens developer tools.
+ * After window creation, emits WindowReady lifecycle event.
+ *
+ * @returns BrowserWindow instance
+ */
 function createMainWindow() {
-    const { openDevTools, windowsOption } = (0, index_js_1.getConfig)();
+    const { windowsOption } = (0, index_js_1.getConfig)();
     const win = new electron_1.BrowserWindow(windowsOption);
     Instance.mainWindow = win;
-    // DevTools
-    if ((0, type_check_js_1.isObject)(openDevTools)) {
-        win.webContents.openDevTools(openDevTools);
-    }
-    else if (openDevTools === true) {
-        win.webContents.openDevTools({ mode: 'bottom' });
-    }
     events_js_1.eventBus.emitLifecycle(events_js_1.WindowReady);
     return win;
 }
-// restored window
+/**
+ * Restore main window
+ *
+ * If window is minimized, restores it, then shows and focuses it.
+ * Used when a second instance starts to activate the existing instance's window.
+ */
 function restoreMainWindow() {
     if (Instance.mainWindow) {
         if (Instance.mainWindow.isMinimized()) {
@@ -58,26 +115,40 @@ function restoreMainWindow() {
         Instance.mainWindow.focus();
     }
 }
-// Set the flag for exiting after close all windows
+/**
+ * Set close and quit flag
+ *
+ * @param flag - true means the application will quit after window closes
+ */
 function setCloseAndQuit(flag) {
     Instance.closeAndQuit = flag;
 }
+/**
+ * Get close and quit flag
+ */
 function getCloseAndQuit() {
     return Instance.closeAndQuit;
 }
-// load server
-// type: remote | single
+/**
+ * Load service page
+ *
+ * Selects page loading strategy based on configuration and environment:
+ * 1. Remote mode (remote.enable=true) → Load remote URL
+ * 2. Development environment → Load frontend dev server (wait for ready), show startup page first
+ * 3. Production environment + cross takeover → Wait for cross-process service to be ready then load
+ * 4. Production environment (default) → Load locally packaged file
+ */
 async function loadServer() {
     const { remote, mainServer } = (0, index_js_1.getConfig)();
     const win = getMainWindow();
     if (!win)
         return;
-    // remote model
+    // Remote mode: load remote URL directly
     if (remote.enable) {
         loadMainUrl('remote', remote.url);
         return;
     }
-    // 开发环境
+    // Development environment
     if ((0, index_js_2.isDev)()) {
         const binFile = path_1.default.join((0, index_js_2.getBaseDir)(), './cmd/bin.js');
         const binConfig = (0, index_js_4.loadFile)(binFile);
@@ -89,49 +160,27 @@ async function loadServer() {
             indexPath: 'index.html',
             directory: 'frontend/dist',
         }, dev.frontend || {});
-        const electronConf = (0, extend_js_1.extend)(true, {
-            loadingPage: '/public/html/loading.html',
-        }, dev.electron || {});
+        const electronConf = (dev.electron || {});
         let url = frontendConf.protocol + frontendConf.hostname + ':' + frontendConf.port;
         let load = 'url';
+        // file:// protocol loads local file directly
         if ((0, index_js_5.isFileProtocol)(frontendConf.protocol)) {
             url = path_1.default.join((0, index_js_2.getBaseDir)(), frontendConf.directory, frontendConf.indexPath);
             load = 'file';
         }
-        // Check if UI serve is started, load a boot page first
+        // HTTP mode: show startup page first, wait for frontend dev server to be ready
         if (load === 'url') {
-            // loading page
-            let lp = (0, index_js_6.getHtmlFilepath)('boot.html');
+            // Load loading page
             if (electronConf.loadingPage) {
-                lp = path_1.default.join((0, index_js_2.getBaseDir)(), electronConf.loadingPage);
+                _loadingPage(path_1.default.join((0, index_js_2.getBaseDir)(), electronConf.loadingPage));
             }
-            _loadingPage(lp);
-            // check frontend is ready
+            // Poll to check if frontend dev server is ready
             const retryTimes = frontendConf.force === true ? 3 : 60;
-            let count = 0;
-            let frontendReady = false;
-            while (!frontendReady && count < retryTimes) {
-                await (0, helper_js_1.sleep)(1 * 1000);
-                try {
-                    await (0, axios_1.default)({
-                        method: 'get',
-                        url,
-                        timeout: 1000,
-                        proxy: false,
-                        headers: {
-                            'Accept': 'text/html, application/json, text/plain, */*',
-                        },
-                    });
-                    frontendReady = true;
-                }
-                catch (err) {
-                    // ignore
-                }
-                count++;
-            }
-            debugLog('it takes %d seconds to start the frontend', count);
+            const frontendReady = await waitForUrl(url, { retries: retryTimes, intervalMs: 1000, timeoutMs: 1000 });
+            debugLog('frontend ready: %s', frontendReady);
             if (frontendReady === false && frontendConf.force !== true) {
-                const bootFailurePage = (0, index_js_6.getHtmlFilepath)('failure.html');
+                // Frontend service not ready, show failure page
+                const bootFailurePage = (0, index_js_7.getHtmlFilepath)('failure.html');
                 const win = getMainWindow();
                 if (win) {
                     win.loadFile(bootFailurePage);
@@ -143,13 +192,12 @@ async function loadServer() {
         loadMainUrl('spa', url, load);
         return;
     }
-    // 生产环境
-    // cross takeover web
+    // Production environment: cross takeover mode
     if (mainServer.takeover && mainServer.takeover.length > 0) {
         await crossTakeover();
         return;
     }
-    // 主进程
+    // Production environment: load local file
     const indexPath = mainServer.indexPath;
     let prodUrl = path_1.default.join((0, index_js_2.getBaseDir)(), indexPath);
     if (!(0, index_js_5.isFileProtocol)(mainServer.protocol)) {
@@ -158,33 +206,51 @@ async function loadServer() {
     loadMainUrl('spa', prodUrl, 'file');
 }
 /**
- * 主服务
- * @params load <string> value: "url" 、 "file"
+ * Load main page URL or file
+ *
+ * @param type - Load type (remote / spa)
+ * @param url - URL or file path
+ * @param load - Load method: 'url' uses loadURL, 'file' uses loadFile
  */
 function loadMainUrl(type, url, load = 'url') {
-    const { mainServer } = (0, index_js_1.getConfig)();
+    const { openDevTools, mainServer } = (0, index_js_1.getConfig)();
     const win = getMainWindow();
     if (!win)
         return;
     index_js_3.coreLogger.info('Env: %s, Type: %s', (0, index_js_2.env)(), type);
     index_js_3.coreLogger.info('App running at: %s', url);
     debugLog('[loadMainUrl] type:%s, url:%s', type, url);
+    // Open DevTools after the final page finishes loading, avoiding disconnection during page transitions
+    win.webContents.once('did-finish-load', () => {
+        if ((0, type_check_js_1.isObject)(openDevTools)) {
+            win.webContents.openDevTools(openDevTools);
+        }
+        else if (openDevTools === true) {
+            win.webContents.openDevTools({ mode: 'bottom' });
+        }
+    });
     if (load === 'file') {
         win.loadFile(url, mainServer.options)
-            .then()
             .catch((err) => {
             index_js_3.coreLogger.error(`Please check the ${url} !`, err);
+            throw err;
         });
     }
     else {
         win.loadURL(url, mainServer.options)
-            .then()
             .catch((err) => {
             index_js_3.coreLogger.error(`Please check the ${url} !`, err);
+            throw err;
         });
     }
 }
-// loading page
+/**
+ * Load startup page
+ *
+ * Displayed while waiting for frontend service to be ready, avoiding blank screen.
+ *
+ * @param filepath - Startup page HTML file path
+ */
 function _loadingPage(filepath) {
     const win = getMainWindow();
     if (!win)
@@ -194,55 +260,45 @@ function _loadingPage(filepath) {
     }
 }
 /**
- * cross takeover web
+ * Cross-process service takeover page loading
+ *
+ * Waits for the specified cross-process service (e.g., Go/Python backend) to be ready, then loads the URL it provides.
+ * Flow:
+ * 1. Show loading page (if loadingPage is configured)
+ * 2. Check if cross-process service configuration is correct
+ * 3. Poll and wait for service URL to be reachable
+ * 4. Load service URL when ready, show failure page on timeout
  */
 async function crossTakeover() {
     const crossConf = (0, index_js_1.getConfig)().cross;
     const mainConf = (0, index_js_1.getConfig)().mainServer;
-    // loading page
+    // Show loading page
     if (mainConf.loadingPage && mainConf.loadingPage.length > 0) {
         const lp = path_1.default.join((0, index_js_2.getBaseDir)(), mainConf.loadingPage);
         _loadingPage(lp);
     }
-    // cross service url
+    // Get the URL of the cross-process service
     const service = mainConf.takeover;
     if (!Object.prototype.hasOwnProperty.call(crossConf, service)) {
         throw new Error(`[ee-core] Please Check the value of mainServer.takeover in the config file !`);
     }
     const serviceConf = crossConf[service];
-    // check service
     if (!serviceConf || serviceConf.enable !== true) {
         throw new Error(`[ee-core] Please Check the value of cross.${service} enable is true !`);
     }
     const entityName = serviceConf.name || service;
-    const url = index_js_7.cross.getUrl(entityName);
-    // 循环检查
-    let count = 0;
-    let serviceReady = false;
+    const url = index_js_6.cross.getUrl(entityName);
+    if (!url) {
+        throw new Error(`[ee-core] Cannot get URL for cross service [${service}], process may not be running`);
+    }
+    // Poll and wait for service to be ready
     const times = (0, index_js_2.isDev)() ? 20 : 100;
     const sleeptime = (0, index_js_2.isDev)() ? 1000 : 200;
-    while (!serviceReady && count < times) {
-        await (0, helper_js_1.sleep)(sleeptime);
-        try {
-            await (0, axios_1.default)({
-                method: 'get',
-                url,
-                timeout: 100,
-                proxy: false,
-                headers: {
-                    'Accept': 'text/html, application/json, text/plain, */*',
-                },
-            });
-            serviceReady = true;
-        }
-        catch {
-            // ignore
-        }
-        count++;
-    }
-    debugLog('it takes %d seconds to start the cross service', count * sleeptime);
+    const serviceReady = await waitForUrl(url, { retries: times, intervalMs: sleeptime, timeoutMs: 100 });
+    debugLog('cross service ready: %s', serviceReady);
     if (!serviceReady) {
-        const bootFailurePage = (0, index_js_6.getHtmlFilepath)('cross-failure.html');
+        // Service not ready, show failure page
+        const bootFailurePage = (0, index_js_7.getHtmlFilepath)('cross-failure.html');
         const mainWindow = getMainWindow();
         if (mainWindow) {
             mainWindow.loadFile(bootFailurePage);

package/dist/cjs/electron/window/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":";;;;;AA+EA,sCAEC;AAWD,4CASC;AAQD,8CAQC;AAOD,0CAEC;AAKD,0CAEC;AAWD,gCA6EC;AA7ND;;;;;;;;;;GAUG;AACH,kDAA0B;AAC1B,6DAAqD;AACrD,gDAAwB;AACxB,kDAA0B;AAC1B,uCAAyC;AACzC,oDAAkD;AAClD,mDAA4D;AAC5D,gDAA2D;AAC3D,iDAAgD;AAChD,oDAAiD;AACjD,mDAAsD;AACtD,qDAA2D;AAC3D,qDAA+C;AAC/C,mDAA6C;AAC7C,kDAAsD;AAGtD,MAAM,QAAQ,GAAG,IAAA,eAAK,EAAC,yBAAyB,CAAC,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,OAAmE;IACxG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,OAAO,CAAC,KAAK,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACzC,MAAM,IAAA,iBAAK,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,IAAA,eAAK,EAAC;gBACV,MAAM,EAAE,KAAK;gBACb,GAAG;gBACH,OAAO,EAAE,OAAO,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,EAAE,QAAQ,EAAE,8CAA8C,EAAE;aACtE,CAAC,CAAC;YACH,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;QACD,KAAK,EAAE,CAAC;IACV,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yCAAyC;AACzC,MAAM,QAAQ,GAGV;IACF,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF;;;;GAIG;AACH,SAAgB,aAAa;IAC3B,OAAO,QAAQ,CAAC,UAAU,CAAC;AAC7B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,oBAAS,GAElC,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,wBAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;IAE1B,oBAAQ,CAAC,aAAa,CAAC,uBAAW,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB;IAC/B,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YACtC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAChC,CAAC;QACD,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,IAAa;IAC3C,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,QAAQ,CAAC,YAAY,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,UAAU;IAC9B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,oBAAS,GAGvC,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO;IAEjB,wCAAwC;IACxC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,0BAA0B;IAC1B,IAAI,IAAA,gBAAK,GAAE,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,cAAc,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,IAAA,mBAAQ,EAAC,OAAO,CAAuB,CAAC;QAC1D,MAAM,GAAG,GAAG,SAAS,EAAE,GAAG,IAAI,EAAe,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAA,kBAAM,EAAC,IAAI,EAAE;YAChC,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,YAAY;YACvB,SAAS,EAAE,eAAe;SAC3B,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAsB,CAAC;QAC5C,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAsB,CAAC;QAE/D,IAAI,GAAG,GAAG,YAAY,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,GAAG,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC;QAClF,IAAI,IAAI,GAAmB,KAAK,CAAC;QACjC,6CAA6C;QAC7C,IAAI,IAAA,yBAAc,EAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YAC9E,IAAI,GAAG,MAAM,CAAC;QAChB,CAAC;QAED,+EAA+E;QAC/E,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,oBAAoB;YACpB,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;gBAC7B,YAAY,CAAC,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;YAClE,CAAC;YAED,gDAAgD;YAChD,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxG,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;YAE9C,IAAI,aAAa,KAAK,KAAK,IAAI,YAAY,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC3D,gDAAgD;gBAChD,MAAM,eAAe,GAAG,IAAA,0BAAe,EAAC,cAAc,CAAC,CAAC;gBACxD,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;gBAC5B,IAAI,GAAG,EAAE,CAAC;oBACR,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAChC,CAAC;gBACD,qBAAU,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;QACH,CAAC;QAED,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,8CAA8C;IAC9C,IAAI,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,aAAa,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,0CAA0C;IAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IACvC,IAAI,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,IAAA,yBAAc,EAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,UAAU,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5C,CAAC;IACD,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,IAAY,EAAE,GAAW,EAAE,IAAI,GAAG,KAAK;IAC1D,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,IAAA,oBAAS,GAG7C,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO;IAEjB,qBAAU,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAA,cAAG,GAAE,EAAE,IAAI,CAAC,CAAC;IAClD,qBAAU,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;IAC3C,QAAQ,CAAC,+BAA+B,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAErD,sGAAsG;IACtG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC3C,IAAI,IAAA,wBAAQ,EAAC,YAAY,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,YAAuD,CAAC,CAAC;QACxF,CAAC;aAAM,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YACjC,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC;aAClC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,qBAAU,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;YACnD,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC;aACjC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,qBAAU,CAAC,KAAK,CAAC,oBAAoB,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;YACnD,MAAM,GAAG,CAAC;QACZ,CAAC,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO;IAEjB,IAAI,IAAA,uBAAW,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,aAAa;IAC1B,MAAM,SAAS,GAAG,IAAA,oBAAS,GAAE,CAAC,KAAoF,CAAC;IACnH,MAAM,QAAQ,GAAG,IAAA,oBAAS,GAAE,CAAC,UAAuD,CAAC;IAErF,oBAAoB;IACpB,IAAI,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,EAAE,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzD,YAAY,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,2CAA2C;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,mBAAmB,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,IAAI,OAAO,CAAC;IAC/C,MAAM,GAAG,GAAG,gBAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAErC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,+BAA+B,CAAC,CAAC;IACzG,CAAC;IAED,wCAAwC;IACxC,MAAM,KAAK,GAAG,IAAA,gBAAK,GAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACjC,MAAM,SAAS,GAAG,IAAA,gBAAK,GAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACtG,QAAQ,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;IAElD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,uCAAuC;QACvC,MAAM,eAAe,GAAG,IAAA,0BAAe,EAAC,oBAAoB,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,OAAO,KAAK,GAAG,IAAI,CAAC,CAAC;IAChF,CAAC;IAED,qBAAU,CAAC,IAAI,CAAC,kBAAkB,OAAO,2BAA2B,CAAC,CAAC;IACtE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -1,3 +1,15 @@
+/**
+ * Load exception handlers
+ *
+ * Registers global uncaughtException and unhandledRejection listeners.
+ * Should be called at the earliest stage of application startup.
+ */
 export declare function loadException(): void;
+/**
+ * Uncaught exception monitor
+ *
+ * Unlike uncaughtException, this handler is triggered before the exception is caught,
+ * and can be used for exception monitoring and reporting without affecting the subsequent exception handling flow.
+ */
 export declare function uncaughtExceptionMonitorHandler(): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exception/index.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAkBD,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exception/index.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AA6BD;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAKtD"}

package/dist/cjs/exception/index.js

@@ -2,40 +2,75 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadException = loadException;
 exports.uncaughtExceptionMonitorHandler = uncaughtExceptionMonitorHandler;
+/**
+ * @module exception
+ * @description Global exception handling module. Registers uncaughtException and unhandledRejection handlers,
+ * catches unhandled exceptions and Promise rejections, logs them, and decides whether to exit the process based on configuration.
+ *
+ * Called first during framework startup by boot.ts's init(), ensuring that exceptions in subsequent flows can be caught.
+ */
 const index_js_1 = require("../log/index.js");
 const index_js_2 = require("../ps/index.js");
 const index_js_3 = require("../config/index.js");
 const index_js_4 = require("../message/index.js");
-// 捕获异常
+/**
+ * Load exception handlers
+ *
+ * Registers global uncaughtException and unhandledRejection listeners.
+ * Should be called at the earliest stage of application startup.
+ */
 function loadException() {
     uncaughtExceptionHandler();
     unhandledRejectionHandler();
 }
-// 当进程上抛出异常而没有被捕获时触发该事件，并且使异常静默。
+/**
+ * Uncaught exception handler
+ *
+ * Triggered when the process throws an exception that is not caught by try/catch.
+ * Logs the error, and in development mode, child processes also send error information to the terminal.
+ * Decides whether to exit the process based on exception configuration.
+ */
 function uncaughtExceptionHandler() {
     process.on('uncaughtException', function (err) {
         let error = err instanceof Error ? err : new Error(String(err));
         if (error.name === 'Error') {
             error.name = 'unhandledExceptionError';
         }
-        index_js_1.coreLogger.error(error);
+        try {
+            index_js_1.coreLogger.error(error);
+        }
+        catch {
+            // Logger may fail in child processes (e.g. pino transport unavailable);
+            // fall back to console so the error is never silently swallowed.
+            console.error('[ee-core] uncaughtException:', error);
+        }
         _devError(error);
         _exit();
     });
 }
-// 当进程上抛出异常而没有被捕获时触发该事件。
+/**
+ * Uncaught exception monitor
+ *
+ * Unlike uncaughtException, this handler is triggered before the exception is caught,
+ * and can be used for exception monitoring and reporting without affecting the subsequent exception handling flow.
+ */
 function uncaughtExceptionMonitorHandler() {
     process.on('uncaughtExceptionMonitor', function (err) {
         let error = err instanceof Error ? err : new Error(String(err));
         index_js_1.coreLogger.error('uncaughtExceptionMonitor:', error);
     });
 }
-// 当promise中reject的异常在同步任务中没有使用catch捕获就会触发该事件，
-// 即便是在异步情况下使用了catch也会触发该事件
+/**
+ * Unhandled Promise rejection handler
+ *
+ * Triggered when a Promise is rejected and there is no .catch() handler.
+ * Attempts to extract name/message/stack information from non-Error type rejections.
+ */
 function unhandledRejectionHandler() {
     process.on('unhandledRejection', function (err) {
         let error;
         if (!(err instanceof Error)) {
+            // Non-Error type: attempt to extract error information
             const newError = new Error(String(err));
             if (err && typeof err === 'object') {
                 const objErr = err;
@@ -54,16 +89,35 @@ function unhandledRejectionHandler() {
         if (error.name === 'Error') {
             error.name = 'unhandledRejectionError';
         }
-        index_js_1.coreLogger.error(error);
+        try {
+            index_js_1.coreLogger.error(error);
+        }
+        catch {
+            console.error('[ee-core] unhandledRejection:', error);
+        }
         _devError(error);
         _exit();
     });
 }
+/**
+ * Send error information to the terminal from child process in development environment
+ *
+ * Only effective in forked child processes + development environment,
+ * making it convenient to see child process exception information directly in the terminal.
+ */
 function _devError(err) {
     if ((0, index_js_2.isForkedChild)() && (0, index_js_2.isDev)()) {
         index_js_4.childMessage.sendErrorToTerminal(err);
     }
 }
+/**
+ * Decide whether to exit the process based on exception configuration
+ *
+ * Configuration options:
+ * - mainExit: Main process exits on exception
+ * - childExit: Child process exits on exception
+ * - rendererExit: Renderer process exits on exception
+ */
 function _exit() {
     const exceptionConfig = (0, index_js_3.getConfig)().exception;
     const { mainExit, childExit, rendererExit } = exceptionConfig;
@@ -77,9 +131,13 @@ function _exit() {
         _delayExit();
     }
 }
-// 捕获异常后是否退出
+/**
+ * Delay process exit
+ *
+ * Waits 1500ms for async operations like log writes to complete before exiting,
+ * avoiding loss of the last log entries.
+ */
 function _delayExit() {
-    // 等待日志等异步写入完成
     setTimeout(() => {
         process.exit();
     }, 1500);

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

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

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

@@ -1,2 +1,21 @@
+/**
+ * Get the absolute path of an HTML file
+ *
+ * Joins the current directory with the provided filename to generate the full file path.
+ * Typically used with BrowserWindow's loadFile() method to load local HTML pages.
+ *
+ * Usage examples:
+ * ```ts
+ * // Get the path of index.html in the public directory
+ * const htmlPath = getHtmlFilepath('index.html');
+ * // e.g. returns: /path/to/app/public/electron/index.html
+ *
+ * // Get a page in a subdirectory
+ * const subPath = getHtmlFilepath('sub/page.html');
+ * ```
+ *
+ * @param name - HTML filename or relative path (relative to the current module directory)
+ * @returns Absolute path of the HTML file
+ */
 export declare function getHtmlFilepath(name: string): string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/html/index.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/html/index.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}