ee-core 4.1.5 → 5.0.0-beta.5

package/dist/cjs/cross/crossProcess.js

@@ -0,0 +1,262 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": 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"));
+const tree_kill_1 = __importDefault(require("tree-kill"));
+const index_js_1 = require("../log/index.js");
+const index_js_2 = require("../ps/index.js");
+const channel_js_1 = require("../const/channel.js");
+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();
+        this.host = host;
+        this.child = undefined;
+        this.pid = 0;
+        this.port = 0;
+        this.name = '';
+        this.config = { name: '' };
+        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;
+        // This name may be rewritten by the Cross manager if duplicated in childrenMap
+        this.name = targetConf.name;
+        // 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'];
+        }
+        if (targetConf.stdio) {
+            standardOutput = targetConf.stdio;
+        }
+        const { cmd, directory } = targetConf;
+        // 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 platform automatically adds .exe extension
+        if (is.windows() && path_1.default.extname(cmdPath) !== '.exe') {
+            if (targetConf.windowsExtname === true || !(0, index_js_2.isDev)()) {
+                cmdPath += '.exe';
+            }
+        }
+        // Resolve working directory
+        if (directory && path_1.default.isAbsolute(directory)) {
+            execDir = directory;
+        }
+        else if (directory && !path_1.default.isAbsolute(directory)) {
+            if ((0, index_js_2.isDev)()) {
+                execDir = path_1.default.join((0, index_js_2.getBaseDir)(), directory);
+            }
+            else {
+                execDir = path_1.default.join((0, index_js_2.getExtraResourcesDir)(), directory);
+            }
+        }
+        else {
+            execDir = (0, index_js_2.getExtraResourcesDir)();
+        }
+        index_js_1.coreLogger.info(`[cross/run] cmd: ${cmdPath}, args: ${cmdArgs}`);
+        const coreProcess = (0, cross_spawn_1.default)(cmdPath, cmdArgs, {
+            stdio: standardOutput,
+            detached: false,
+            cwd: execDir,
+        });
+        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);
+            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);
+            index_js_1.coreLogger.error(`[cross/process] received a error from child-process, error: ${err}, pid:${this.pid}`);
+            this._exitElectron();
+        });
+    }
+    /**
+     * 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(() => {
+                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://';
+        if (ssl && (ssl === 'true' || ssl === '1')) {
+            protocol = 'https://';
+        }
+        hostname = hostname ? hostname : '127.0.0.1';
+        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}`;
+    }
+    /**
+     * 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);
+        }
+    }
+}
+exports.CrossProcess = CrossProcess;
+//# sourceMappingURL=crossProcess.js.map

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

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

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

@@ -0,0 +1,4 @@
+export { Cross, cross } from './cross.js';
+export { CrossProcess } from './crossProcess.js';
+export type { CrossTargetConfig, CrossProcessOptions, CrossHost } from './crossProcess.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cross/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cjs/cross/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrossProcess = exports.cross = exports.Cross = void 0;
+var cross_js_1 = require("./cross.js");
+Object.defineProperty(exports, "Cross", { enumerable: true, get: function () { return cross_js_1.Cross; } });
+Object.defineProperty(exports, "cross", { enumerable: true, get: function () { return cross_js_1.cross; } });
+var crossProcess_js_1 = require("./crossProcess.js");
+Object.defineProperty(exports, "CrossProcess", { enumerable: true, get: function () { return crossProcess_js_1.CrossProcess; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cross/index.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAAjC,iGAAA,KAAK,OAAA;AAAE,iGAAA,KAAK,OAAA;AACrB,qDAAiD;AAAxC,+GAAA,YAAY,OAAA"}

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

@@ -0,0 +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 };
+/**
+ * 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

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

@@ -0,0 +1,99 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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");
+const is = __importStar(require("../../utils/is.js"));
+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");
+/**
+ * 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)();
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

@@ -0,0 +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

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

@@ -0,0 +1,35 @@
+"use strict";
+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; } });
+Object.defineProperty(exports, "createElectron", { enumerable: true, get: function () { return index_js_2.createElectron; } });
+var index_js_3 = require("./window/index.js");
+Object.defineProperty(exports, "getMainWindow", { enumerable: true, get: function () { return index_js_3.getMainWindow; } });
+Object.defineProperty(exports, "createMainWindow", { enumerable: true, get: function () { return index_js_3.createMainWindow; } });
+Object.defineProperty(exports, "restoreMainWindow", { enumerable: true, get: function () { return index_js_3.restoreMainWindow; } });
+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 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)();
+}
+//# sourceMappingURL=index.js.map

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

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

@@ -0,0 +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

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