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

package/dist/cjs/cross/crossProcess.js

@@ -37,6 +37,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CrossProcess = void 0;
+/**
+ * @module cross/crossProcess
+ * @description Cross-process child process management. Encapsulates the logic of using cross-spawn
+ * to create external processes, handling process path resolution, platform differences,
+ * lifecycle monitoring, and graceful exit.
+ *
+ * Supported external program types:
+ * - Go compiled binaries
+ * - Python scripts
+ * - Other executable programs
+ *
+ * Process path resolution rules:
+ * - Config has cmd → use cmd as executable file path
+ * - Config has no cmd → use extraResourcesDir/{name} as path
+ * - Windows platform automatically adds .exe extension
+ * - Dev environment relative to project root, production relative to extraResources directory
+ */
 const events_1 = __importDefault(require("events"));
 const path_1 = __importDefault(require("path"));
 const cross_spawn_1 = __importDefault(require("cross-spawn"));
@@ -48,6 +65,14 @@ const helper_js_1 = require("../utils/helper.js");
 const pargv_js_1 = require("../utils/pargv.js");
 const is = __importStar(require("../utils/is.js"));
 const index_js_3 = require("../electron/app/index.js");
+/**
+ * CrossProcess - child process instance
+ *
+ * Encapsulates the complete lifecycle of an external process:
+ * Create → Run → Listen for events → Terminate
+ *
+ * Notifies the Cross manager of child process events (exit/error) via the host's emitter.
+ */
 class CrossProcess {
     constructor(host, opt = { targetConf: { name: '' }, port: 0 }) {
         this.emitter = new events_1.default();
@@ -60,18 +85,26 @@ class CrossProcess {
         this._init(opt);
     }
     /**
-     * 初始化子进程
+     * Initialize child process
+     *
+     * Execution flow:
+     * 1. Save configuration and port
+     * 2. Resolve executable file path (handle cmd/directory configuration and platform differences)
+     * 3. Set standard output mode (inherit in dev environment, ignore in production)
+     * 4. Start child process using cross-spawn
+     * 5. Listen for exit and error events
      */
     _init(options = { targetConf: { name: '' }, port: 0 }) {
         const { targetConf, port } = options;
         this.config = targetConf;
         this.port = port;
-        // 该名称如果在childrenMap重复，会被重写
+        // This name may be rewritten by the Cross manager if duplicated in childrenMap
         this.name = targetConf.name;
-        // Launch executable program
+        // Resolve executable file path
         let cmdPath = '';
         const cmdArgs = targetConf.args || [];
         let execDir = (0, index_js_2.getExtraResourcesDir)();
+        // Standard output configuration: inherit terminal output in dev, ignore in production
         let standardOutput = ['inherit', 'inherit', 'inherit', 'ipc'];
         if ((0, index_js_2.isPackaged)()) {
             standardOutput = ['ignore', 'ignore', 'ignore', 'ipc'];
@@ -80,28 +113,28 @@ class CrossProcess {
             standardOutput = targetConf.stdio;
         }
         const { cmd, directory } = targetConf;
-        // use cmd first
+        // Prefer cmd configuration
         if (cmd) {
             if (!directory) {
                 throw new Error(`[ee-core] [cross] The config [directory] attribute does not exist`);
             }
             cmdPath = cmd;
+            // In non-dev environments, relative paths are resolved based on extraResources
             if (!path_1.default.isAbsolute(cmd) && !(0, index_js_2.isDev)()) {
                 cmdPath = path_1.default.join((0, index_js_2.getExtraResourcesDir)(), cmd);
             }
         }
         else {
+            // Without cmd, use extraResourcesDir/{name} as the executable file path
             cmdPath = path_1.default.join((0, index_js_2.getExtraResourcesDir)(), targetConf.name);
         }
-        // windows
+        // Windows platform automatically adds .exe extension
         if (is.windows() && path_1.default.extname(cmdPath) !== '.exe') {
-            // Complete the executable program extension
-            // notice: python.exe may bring up the App Store
             if (targetConf.windowsExtname === true || !(0, index_js_2.isDev)()) {
                 cmdPath += '.exe';
             }
         }
-        // executable program directory
+        // Resolve working directory
         if (directory && path_1.default.isAbsolute(directory)) {
             execDir = directory;
         }
@@ -124,13 +157,14 @@ class CrossProcess {
         });
         this.child = coreProcess;
         this.pid = coreProcess.pid || 0;
+        // Listen for child process exit: caused by external termination or internal error
         coreProcess.on('exit', (code, signal) => {
             const data = { pid: this.pid };
             this.host.emitter?.emit(channel_js_1.Events.childProcessExit, data);
-            // Child process closed: The child process was killed externally or an internal error caused the application to stop, resulting in the application exiting
             index_js_1.coreLogger.info(`[cross/process] received a exit from child-process, code:${code}, signal:${signal}, pid:${this.pid}, cmd:${cmdPath}, args: ${cmdArgs}`);
             this._exitElectron();
         });
+        // Listen for child process errors
         coreProcess.on('error', (err) => {
             const data = { pid: this.pid };
             this.host.emitter?.emit(channel_js_1.Events.childProcessError, data);
@@ -139,20 +173,40 @@ class CrossProcess {
         });
     }
     /**
-     * kill
+     * Terminate child process
+     *
+     * First sends SIGINT signal for graceful exit, then sends SIGKILL for forced termination if it fails.
+     * If the process still hasn't exited after timeout, triggers _exitElectron as a safety net.
+     *
+     * @param timeout - Timeout for waiting exit (milliseconds)
      */
     kill(timeout = 1000) {
         (0, tree_kill_1.default)(this.pid, 'SIGINT', (err) => {
             if (err) {
                 index_js_1.coreLogger.error(`[cross/process] kill cross-process, error: ${err}, pid:${this.pid}`);
+                // SIGINT failed, use SIGKILL for forced termination
                 (0, tree_kill_1.default)(this.pid, 'SIGKILL');
             }
+            // Timeout safety net: if exit event is not triggered within timeout, manually call _exitElectron
             setTimeout(() => {
-                this._exitElectron();
+                if (this.child && !this.child.killed) {
+                    this._exitElectron();
+                }
             }, timeout);
         });
     }
+    /**
+     * Get the service URL of the child process
+     *
+     * Parses hostname and ssl flag from startup arguments, constructs HTTP/HTTPS URL.
+     * Outputs warning when port is 0 (service may not have bound port correctly).
+     *
+     * @returns Service URL, e.g., http://127.0.0.1:7070
+     */
     getUrl() {
+        if (!this.port) {
+            index_js_1.coreLogger.warn(`[cross/process] getUrl called with port 0, pid:${this.pid}`);
+        }
         const ssl = (0, helper_js_1.getValueFromArgv)(this.config.args || [], 'ssl');
         let hostname = (0, helper_js_1.getValueFromArgv)(this.config.args || [], 'hostname');
         let protocol = 'http://';
@@ -163,24 +217,42 @@ class CrossProcess {
         const url = protocol + hostname + ':' + this.port;
         return url;
     }
+    /**
+     * Get key-value object of startup arguments
+     *
+     * @returns Parsed arguments object
+     */
     getArgsObj() {
         const obj = (0, pargv_js_1.parseArgv)(this.config.args || []);
         return obj;
     }
+    /**
+     * Set port number
+     *
+     * @param port - Port number (strings will be converted to numbers)
+     */
     setPort(port) {
         this.port = typeof port === 'string' ? parseInt(port, 10) : port;
     }
+    /**
+     * Generate unique ID
+     *
+     * @returns Unique identifier in the format 'node:{pid}:{randomString}'
+     */
     _generateId() {
         const rid = (0, helper_js_1.getRandomString)();
         return `node:${this.pid}:${rid}`;
     }
     /**
-     * exit electron
+     * Trigger Electron main process exit when child process exits
+     *
+     * Only effective when appExit=true is configured, ensuring the main process also exits when the child process crashes.
+     *
+     * @param timeout - Delayed exit time (milliseconds), waiting for resource release
      */
     _exitElectron(timeout = 1000) {
         if (this.config.appExit) {
             setTimeout(() => {
-                // 主进程退出
                 index_js_3.electronApp.quit();
             }, timeout);
         }

package/dist/cjs/cross/crossProcess.js.map

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

package/dist/cjs/electron/app/index.d.ts

@@ -1,7 +1,23 @@
+/**
+ * @module electron/app
+ * @description Electron application lifecycle management. Responsible for creating application instances,
+ * registering system events, managing single instance locks, and handling cleanup on window close and app exit.
+ *
+ * Lifecycle:
+ * 1. createElectron() — Check single instance lock → app.whenReady() → Create main window → Load page
+ * 2. window-all-closed — Quit app on non-macOS platforms
+ * 3. before-quit — Clean up cross-process services and child tasks
+ */
 import { app as electronApp } from 'electron';
 export { electronApp };
 /**
- * 创建electron应用
+ * Create and start Electron application
+ *
+ * Execution flow:
+ * 1. Check single instance lock (when singleLock=true is configured, prevents running multiple instances simultaneously)
+ * 2. Wait for app.whenReady() to complete
+ * 3. Create main window, emit Preload event, load service page, emit ElectronAppReady event
+ * 4. Register system event listeners: window-all-closed, before-quit
  */
 export declare function createElectron(): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/electron/app/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC;AAQ9C,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA6BrC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,UAAU,CAAC;AAS9C,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAmCrC"}

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

@@ -35,6 +35,16 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.electronApp = void 0;
 exports.createElectron = createElectron;
+/**
+ * @module electron/app
+ * @description Electron application lifecycle management. Responsible for creating application instances,
+ * registering system events, managing single instance locks, and handling cleanup on window close and app exit.
+ *
+ * Lifecycle:
+ * 1. createElectron() — Check single instance lock → app.whenReady() → Create main window → Load page
+ * 2. window-all-closed — Quit app on non-macOS platforms
+ * 3. before-quit — Clean up cross-process services and child tasks
+ */
 const electron_1 = require("electron");
 Object.defineProperty(exports, "electronApp", { enumerable: true, get: function () { return electron_1.app; } });
 const index_js_1 = require("../../log/index.js");
@@ -43,33 +53,47 @@ const index_js_2 = require("../../cross/index.js");
 const index_js_3 = require("../window/index.js");
 const events_js_1 = require("../../app/events.js");
 const index_js_4 = require("../../config/index.js");
+const registry_js_1 = require("../../jobs/registry.js");
 /**
- * 创建electron应用
+ * Create and start Electron application
+ *
+ * Execution flow:
+ * 1. Check single instance lock (when singleLock=true is configured, prevents running multiple instances simultaneously)
+ * 2. Wait for app.whenReady() to complete
+ * 3. Create main window, emit Preload event, load service page, emit ElectronAppReady event
+ * 4. Register system event listeners: window-all-closed, before-quit
  */
 function createElectron() {
     const { singleLock } = (0, index_js_4.getConfig)();
-    // 允许多个实例
+    // Request single instance lock
     const gotTheLock = electron_1.app.requestSingleInstanceLock();
     if (singleLock && !gotTheLock) {
+        // Another instance is already running, quit current instance
         electron_1.app.quit();
         return;
     }
+    // After Electron app is ready, create window and load page
     electron_1.app.whenReady().then(() => {
         (0, index_js_3.createMainWindow)();
         events_js_1.eventBus.emitLifecycle(events_js_1.Preload);
         (0, index_js_3.loadServer)();
+        events_js_1.eventBus.emitLifecycle(events_js_1.ElectronAppReady);
     });
+    // Quit app when all windows are closed (except on macOS, where apps typically stay running)
     electron_1.app.on('window-all-closed', () => {
         if (!is.macOS()) {
             index_js_1.coreLogger.info('[lib/eeApp] window-all-closed quit');
             electron_1.app.quit();
         }
     });
+    // Clean up resources before app quits
     electron_1.app.on('before-quit', () => {
         (0, index_js_3.setCloseAndQuit)(true);
         events_js_1.eventBus.emitLifecycle(events_js_1.BeforeClose);
+        // Terminate all cross-process services (Go/Python backends, etc.)
         index_js_2.cross.killAll();
+        // Terminate all child task processes
+        (0, registry_js_1.killAllJobs)();
     });
-    events_js_1.eventBus.emitLifecycle(events_js_1.ElectronAppReady);
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,wCA6BC;AA1CD,uCAA8C;AAQrC,4FARO,cAAW,OAQP;AAPpB,iDAAgD;AAChD,sDAAwC;AACxC,mDAA6C;AAC7C,iDAAmF;AACnF,mDAAuF;AACvF,oDAAkD;AAIlD;;GAEG;AACH,SAAgB,cAAc;IAC5B,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,oBAAS,GAA6B,CAAC;IAC9D,SAAS;IACT,MAAM,UAAU,GAAG,cAAW,CAAC,yBAAyB,EAAE,CAAC;IAC3D,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,cAAW,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,cAAW,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAChC,IAAA,2BAAgB,GAAE,CAAC;QACnB,oBAAQ,CAAC,aAAa,CAAC,mBAAO,CAAC,CAAC;QAChC,IAAA,qBAAU,GAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,cAAW,CAAC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACvC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,qBAAU,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YACtD,cAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,cAAW,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACjC,IAAA,0BAAe,EAAC,IAAI,CAAC,CAAC;QACtB,oBAAQ,CAAC,aAAa,CAAC,uBAAW,CAAC,CAAC;QACpC,gBAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,oBAAQ,CAAC,aAAa,CAAC,4BAAgB,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/electron/app/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,wCAmCC;AAjED;;;;;;;;;GASG;AACH,uCAA8C;AASrC,4FATO,cAAW,OASP;AARpB,iDAAgD;AAChD,sDAAwC;AACxC,mDAA6C;AAC7C,iDAAmF;AACnF,mDAAuF;AACvF,oDAAkD;AAClD,wDAAqD;AAIrD;;;;;;;;GAQG;AACH,SAAgB,cAAc;IAC5B,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,oBAAS,GAA6B,CAAC;IAC9D,+BAA+B;IAC/B,MAAM,UAAU,GAAG,cAAW,CAAC,yBAAyB,EAAE,CAAC;IAC3D,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9B,6DAA6D;QAC7D,cAAW,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,2DAA2D;IAC3D,cAAW,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAChC,IAAA,2BAAgB,GAAE,CAAC;QACnB,oBAAQ,CAAC,aAAa,CAAC,mBAAO,CAAC,CAAC;QAChC,IAAA,qBAAU,GAAE,CAAC;QACb,oBAAQ,CAAC,aAAa,CAAC,4BAAgB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,4FAA4F;IAC5F,cAAW,CAAC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACvC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,qBAAU,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YACtD,cAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,cAAW,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACjC,IAAA,0BAAe,EAAC,IAAI,CAAC,CAAC;QACtB,oBAAQ,CAAC,aAAa,CAAC,uBAAW,CAAC,CAAC;QACpC,kEAAkE;QAClE,gBAAK,CAAC,OAAO,EAAE,CAAC;QAChB,qCAAqC;QACrC,IAAA,yBAAW,GAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,4 +1,10 @@
 export { electronApp, createElectron } from './app/index.js';
 export { getMainWindow, createMainWindow, restoreMainWindow, setCloseAndQuit, getCloseAndQuit, loadServer } from './window/index.js';
+/**
+ * Load Electron main process functionality
+ *
+ * Calls createElectron() to create the application and register system events.
+ * Called last by Application.run() in the framework startup flow.
+ */
 export declare function loadElectron(): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGrI,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErI;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/cjs/electron/index.js

@@ -2,6 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadServer = exports.getCloseAndQuit = exports.setCloseAndQuit = exports.restoreMainWindow = exports.createMainWindow = exports.getMainWindow = exports.createElectron = exports.electronApp = void 0;
 exports.loadElectron = loadElectron;
+/**
+ * @module electron
+ * @description Electron main process functionality module entry point. Provides application lifecycle management and window management features.
+ *
+ * Core features:
+ * - createElectron(): Create Electron application, register system events
+ * - createMainWindow(): Create main window
+ * - loadServer(): Load page content based on environment
+ * - getMainWindow(): Get main window instance
+ */
 const index_js_1 = require("./app/index.js");
 var index_js_2 = require("./app/index.js");
 Object.defineProperty(exports, "electronApp", { enumerable: true, get: function () { return index_js_2.electronApp; } });
@@ -13,7 +23,12 @@ Object.defineProperty(exports, "restoreMainWindow", { enumerable: true, get: fun
 Object.defineProperty(exports, "setCloseAndQuit", { enumerable: true, get: function () { return index_js_3.setCloseAndQuit; } });
 Object.defineProperty(exports, "getCloseAndQuit", { enumerable: true, get: function () { return index_js_3.getCloseAndQuit; } });
 Object.defineProperty(exports, "loadServer", { enumerable: true, get: function () { return index_js_3.loadServer; } });
-// load socket server
+/**
+ * Load Electron main process functionality
+ *
+ * Calls createElectron() to create the application and register system events.
+ * Called last by Application.run() in the framework startup flow.
+ */
 function loadElectron() {
     (0, index_js_1.createElectron)();
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":";;;AAMA,oCAEC;AARD,6CAAgD;AAEhD,2CAA6D;AAApD,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AACpC,8CAAqI;AAA5H,yGAAA,aAAa,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,sGAAA,UAAU,OAAA;AAEzG,qBAAqB;AACrB,SAAgB,YAAY;IAC1B,IAAA,yBAAc,GAAE,CAAC;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/electron/index.ts"],"names":[],"mappings":";;;AAqBA,oCAEC;AAvBD;;;;;;;;;GASG;AACH,6CAAgD;AAEhD,2CAA6D;AAApD,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AACpC,8CAAqI;AAA5H,yGAAA,aAAa,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,sGAAA,UAAU,OAAA;AAEzG;;;;;GAKG;AACH,SAAgB,YAAY;IAC1B,IAAA,yBAAc,GAAE,CAAC;AACnB,CAAC"}

package/dist/cjs/electron/window/index.d.ts

@@ -1,8 +1,45 @@
 import { BrowserWindow } from 'electron';
+/**
+ * Get main window instance
+ *
+ * @returns BrowserWindow instance, or null if not created
+ */
 export declare function getMainWindow(): BrowserWindow | null;
+/**
+ * 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
+ */
 export declare function createMainWindow(): BrowserWindow;
+/**
+ * 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.
+ */
 export declare function restoreMainWindow(): void;
+/**
+ * Set close and quit flag
+ *
+ * @param flag - true means the application will quit after window closes
+ */
 export declare function setCloseAndQuit(flag: boolean): void;
+/**
+ * Get close and quit flag
+ */
 export declare function getCloseAndQuit(): boolean;
+/**
+ * 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
+ */
 export declare function loadServer(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/electron/window/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAuBzC,wBAAgB,aAAa,IAAI,aAAa,GAAG,IAAI,CAEpD;AAGD,wBAAgB,gBAAgB,IAAI,aAAa,CAiBhD;AAGD,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAmGhD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/electron/window/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA2DzC;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,aAAa,GAAG,IAAI,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAShD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA6EhD"}