@e-xi/xion 0.0.6

package/dist/chunk-files/chunk-YZOJOLFL.js

@@ -0,0 +1,121 @@
+import {
+  AppMode,
+  RuntimeConfigUtil
+} from "./chunk-GN2FNR3Z.js";
+
+// src/main/utils/window-util.ts
+import { app } from "electron";
+import fs from "node:fs";
+import path from "node:path";
+var WindowUtil = class _WindowUtil {
+  /**
+   * 窗口记录转窗口标识
+   * @param {XoWindow.Record} record 窗口记录
+   * @returns {XoWindow.Identity}
+   */
+  static recordToIdentity(record) {
+    return {
+      // 窗口记录ID
+      recordId: record.id,
+      // 窗口类型名称
+      typeName: record.type.name,
+      // 窗口加载路径
+      url: record.url
+    };
+  }
+  /**
+   * 从窗口记录获取唯一ID
+   * @param {XoWindow.Record} record 窗口记录
+   * @returns {string}
+   */
+  static recordToUID(record) {
+    return `'WinID: ${record.window.id}:${record.type.name}:${record.id}@${record.url}'`;
+  }
+  /**
+   * 从窗口获取唯一ID
+   * @param {WindowManager}          windowManager 窗口管理器
+   * @param {Electron.BrowserWindow} window        窗口记录
+   * @returns {string}
+   */
+  static windowToUID(windowManager, window) {
+    const record = windowManager.getRecordByBrowserWindowId(window.id);
+    if (!record) {
+      return `'WinID: ${window.id}:-:-@-'`;
+    }
+    return _WindowUtil.recordToUID(record);
+  }
+  /**
+   * 从窗口标识获取唯一ID
+   * @param {XoWindow.Identity} identity 窗口标识
+   * @returns {string}
+   */
+  static identityToUID(identity) {
+    return `'WinID: -:${identity.typeName}:${identity.recordId}@${identity.url}'`;
+  }
+  /**
+   * 开发环境加载首页
+   * @param {XoAppAbstract}   xoApp  XionApp
+   * @param {XoWindow.Record} record 窗口实例
+   * @returns {Promise<void>}
+   */
+  static async loadUrl(xoApp, record) {
+    const winUID = _WindowUtil.recordToUID(record);
+    if (!AppMode.isDev()) {
+      throw new Error(`\u6E32\u67D3\u8FDB\u7A0B\u5728\u975E\u5F00\u53D1\u73AF\u5883\u4E0B\u4E0D\u5141\u8BB8\u52A0\u8F7D\u5F00\u53D1\u670D\u52A1\u9875\u9762\uFF0C${winUID}`);
+    }
+    const rendererUrl = process.env.ELECTRON_RENDERER_URL;
+    if (!rendererUrl) {
+      throw new Error(`\u6E32\u67D3\u8FDB\u7A0B\u672A\u83B7\u53D6\u5230\u5F00\u53D1\u670D\u52A1\u9875\u9762\uFF0C${winUID}`);
+    }
+    const recordUrl = `/${record.url.replace(/^\/+/, "")}`;
+    const devUrl = new URL(recordUrl, rendererUrl).toString();
+    await record.window.loadURL(devUrl);
+    xoApp?.windowLog?.debug(`\u6E32\u67D3\u8FDB\u7A0B\u5F00\u53D1\u670D\u52A1\u5DF2\u8FDE\u63A5: ${devUrl}`, winUID);
+  }
+  /**
+   * 使用自定义协议加载生产环境首页
+   * @param {XoAppAbstract}   xoApp   XionApp
+   * @param {XoWindow.Record} record  窗口实例
+   * @param {string}          entryUrl 渲染进程入口地址
+   * @returns {Promise<void>}
+   */
+  static async loadProtocol(xoApp, record, entryUrl) {
+    const winUID = _WindowUtil.recordToUID(record);
+    const protocol = new URL(entryUrl).protocol.replace(/:$/, "");
+    if (!record.window.webContents.session.protocol.isProtocolHandled(protocol)) {
+      throw new Error(`\u6E32\u67D3\u8FDB\u7A0B\u5165\u53E3\u534F\u8BAE\u672A\u6CE8\u518C\u5904\u7406\u5668: ${protocol}\uFF0C${winUID}`);
+    }
+    await record.window.loadURL(entryUrl);
+    xoApp?.windowLog?.debug(`\u6E32\u67D3\u8FDB\u7A0B\u81EA\u5B9A\u4E49\u534F\u8BAE\u5DF2\u8FDE\u63A5: ${entryUrl}`, winUID);
+  }
+  /**
+   * 生产环境加载首页
+   * @param {XoAppAbstract}   xoApp  XionApp
+   * @param {XoWindow.Record} record 窗口实例
+   * @returns {Promise<void>}
+   */
+  static async loadFile(xoApp, record) {
+    const winUID = _WindowUtil.recordToUID(record);
+    const rendererOutDir = RuntimeConfigUtil.rendererOutDir;
+    if (!rendererOutDir) {
+      throw new Error(`\u6E32\u67D3\u8FDB\u7A0B\u672A\u83B7\u53D6\u5230\u751F\u4EA7\u9875\u9762\u8DEF\u5F84\uFF0C${winUID}\uFF0C${JSON.stringify({
+        runtimeConfigFiles: RuntimeConfigUtil.configFiles()
+      })}`);
+    }
+    const fileDir = path.isAbsolute(rendererOutDir) ? rendererOutDir : path.resolve(app.getAppPath(), rendererOutDir);
+    const url = new URL(record.url, "file:///");
+    const filePath = path.join(fileDir, url.pathname.replace(/^\/+/, ""));
+    if (!fs.existsSync(filePath)) {
+      throw new Error(`\u6E32\u67D3\u8FDB\u7A0B\u5165\u53E3\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${filePath}`);
+    }
+    await record.window.loadFile(filePath, {
+      query: Object.fromEntries(url.searchParams),
+      hash: url.hash.replace(/^#/, "")
+    });
+    xoApp?.windowLog?.debug(`\u6E32\u67D3\u8FDB\u7A0B\u5165\u53E3\u6587\u4EF6\u5DF2\u52A0\u8F7D\uFF1A${fileDir}/${record.url.replace(/^\/+/, "")}`, winUID);
+  }
+};
+
+export {
+  WindowUtil
+};

package/dist/main/app/app-lifecycle-abstract.d.ts

@@ -0,0 +1,190 @@
+import { XoAppAbstract } from './xo-app-abstract';
+/**
+ * Xion 生命周期抽象类
+ * <p>约定：来自 app.on(...) 的 Electron 事件使用 on 前缀；主动阶段方法不使用 on 前缀。</p>
+ * @class AppLifecycleAbstract
+ */
+export declare abstract class AppLifecycleAbstract {
+    /**
+     * XionApp
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 构造函数
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * XionApp 启动前
+     * <p>此阶段通常用于应用启动前的准备工作，如校验配置、注册全局处理器等。</p>
+     * @returns {Promise<void>}
+     */
+    xoAppBeforeStart(): Promise<void>;
+    /**
+     * XionApp 启动后
+     * <p>此阶段通常用于应用启动完成后的补充工作，如主动检查更新、输出启动日志等。</p>
+     * @returns {Promise<void>}
+     */
+    xoAppAfterStart(): Promise<void>;
+    /**
+     * Electron 就绪
+     * <p>对应 app.whenReady() 阶段，此时可以安全地创建窗口、初始化菜单等。</p>
+     * @returns {Promise<void>}
+     */
+    whenReady(): Promise<void>;
+    /**
+     * 浏览器窗口创建后
+     * <p>对应 app.on('browser-window-created') 事件。</p>
+     * @param {Electron.Event}         event  事件对象
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {Promise<void>}
+     */
+    onBrowserWindowCreated(event: Electron.Event, window: Electron.BrowserWindow): Promise<void>;
+    /**
+     * 浏览器窗口获得焦点
+     * <p>对应 app.on('browser-window-focus') 事件。</p>
+     * @param {Electron.Event}         event  事件对象
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {Promise<void>}
+     */
+    onBrowserWindowFocus(event: Electron.Event, window: Electron.BrowserWindow): Promise<void>;
+    /**
+     * 浏览器窗口失去焦点
+     * <p>对应 app.on('browser-window-blur') 事件。</p>
+     * @param {Electron.Event}         event  事件对象
+     * @param {Electron.BrowserWindow} window 窗口
+     * @returns {Promise<void>}
+     */
+    onBrowserWindowBlur(event: Electron.Event, window: Electron.BrowserWindow): Promise<void>;
+    /**
+     * 应用激活
+     * <p>对应 app.on('activate') 事件，常用于 macOS 下在无窗口时重新创建主窗口。</p>
+     * @param {Electron.Event} event             事件对象
+     * @param {boolean}        hasVisibleWindows 是否存在可见窗口
+     * @returns {Promise<void>}
+     */
+    onActivate(event: Electron.Event, hasVisibleWindows: boolean): Promise<void>;
+    /**
+     * 第二个实例启动
+     * <p>对应 app.on('second-instance') 事件，常用于单实例应用聚焦主窗口。</p>
+     * @param {Electron.Event} event            事件对象
+     * @param {string[]}       argv             第二个实例的命令行参数
+     * @param {string}         workingDirectory 第二个实例工作目录
+     * @param {unknown}        additionalData   第二个实例附加数据
+     * @returns {Promise<void>}
+     */
+    onSecondInstance(event: Electron.Event, argv: string[], workingDirectory: string, additionalData: unknown): Promise<void>;
+    /**
+     * 所有窗口关闭
+     * <p>对应 app.on('window-all-closed') 事件，常用于非 macOS 平台退出应用。</p>
+     * @returns {Promise<void>}
+     */
+    onWindowAllClosed(): Promise<void>;
+    /**
+     * 应用退出前
+     * <p>对应 app.on('before-quit') 事件，适合做退出前的收尾工作。</p>
+     * @param {Electron.Event} event 事件对象
+     * @returns {Promise<void>}
+     */
+    onBeforeQuit(event: Electron.Event): Promise<void>;
+    /**
+     * 应用即将退出
+     * <p>对应 app.on('will-quit') 事件，适合做最终清理工作。</p>
+     * @param {Electron.Event} event 事件对象
+     * @returns {Promise<void>}
+     */
+    onWillQuit(event: Electron.Event): Promise<void>;
+    /**
+     * 应用打开文件
+     * <p>对应 app.on('open-file') 事件，主要用于 macOS 文件关联场景。</p>
+     * @param {Electron.Event} event 事件对象
+     * @param {string}         path  文件路径
+     * @returns {Promise<void>}
+     */
+    onOpenFile(event: Electron.Event, path: string): Promise<void>;
+    /**
+     * 应用打开 URL
+     * <p>对应 app.on('open-url') 事件，主要用于 macOS 协议唤起场景。</p>
+     * @param {Electron.Event} event 事件对象
+     * @param {string}         url   URL 地址
+     * @returns {Promise<void>}
+     */
+    onOpenUrl(event: Electron.Event, url: string): Promise<void>;
+    /**
+     * WebContents 创建后
+     * <p>对应 app.on('web-contents-created') 事件。</p>
+     * @param {Electron.Event}       event       事件对象
+     * @param {Electron.WebContents} webContents WebContents
+     * @returns {Promise<void>}
+     */
+    onWebContentsCreated(event: Electron.Event, webContents: Electron.WebContents): Promise<void>;
+    /**
+     * Electron Session 创建后
+     * <p>对应 app.on('session-created') 事件。</p>
+     * @param {Electron.Session} session Session
+     * @returns {Promise<void>}
+     */
+    onSessionCreated(session: Electron.Session): Promise<void>;
+    /**
+     * 子进程退出
+     * <p>对应 app.on('child-process-gone') 事件。</p>
+     * @param {Electron.Event}   event   事件对象
+     * @param {Electron.Details} details 子进程退出详情
+     * @returns {Promise<void>}
+     */
+    onChildProcessGone(event: Electron.Event, details: Electron.Details): Promise<void>;
+    /**
+     * GPU 信息更新
+     * <p>对应 app.on('gpu-info-update') 事件。</p>
+     * @returns {Promise<void>}
+     */
+    onGpuInfoUpdate(): Promise<void>;
+    /**
+     * 渲染进程崩溃
+     * <p>对应 app.on('render-process-gone') 事件。</p>
+     * @param {Electron.Event}                    event       事件对象
+     * @param {Electron.WebContents}              webContents WebContents
+     * @param {Electron.RenderProcessGoneDetails} details     渲染进程崩溃详情
+     * @returns {Promise<void>}
+     */
+    onRenderProcessGone(event: Electron.Event, webContents: Electron.WebContents, details: Electron.RenderProcessGoneDetails): Promise<void>;
+    /**
+     * XionApp 运行错误
+     * <p>统一处理启动流程中的错误。对于 uncaughtException、unhandledRejection 这类更底层的 Node 事件，
+     * 建议在具体实现中按需注册后仍汇总到此方法处理，而不是在生命周期抽象中额外拆出独立钩子。</p>
+     * @param {unknown}       error 错误对象
+     * @returns {Promise<void>}
+     */
+    onError(error: XoApp.LifecycleError): Promise<void>;
+    /**
+     * 设置应用名称
+     * @param {string} productName 应用名称
+     * @private
+     */
+    private setAppName;
+    /**
+     * 设置 APPID
+     * @param {string} appId APPID
+     * @private
+     */
+    private setAppUserModelId;
+    /**
+     * 如果是静默启动模式，则隐藏所有窗口
+     * @param {boolean} silentStartupMode 是否静默启动模式
+     * @private
+     */
+    private hideAllWindowsIfSilentLaunchMode;
+    /**
+     * 设置开机启动
+     * @private
+     */
+    private setLaunchOnStartup;
+    /**
+     * 提示并退出
+     * @param {string} message 消息
+     * @returns {Promise<void>}
+     * @private
+     */
+    private dialogAndExit;
+}

package/dist/main/app/app-lifecycle.d.ts

@@ -0,0 +1,7 @@
+import { AppLifecycleAbstract } from './app-lifecycle-abstract';
+/**
+ * Xion 默认生命周期
+ * @class AppLifecycle
+ */
+export declare class AppLifecycle extends AppLifecycleAbstract {
+}

package/dist/main/app/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './app-lifecycle-abstract';
+export * from './app-lifecycle';
+export * from './xo-app-abstract';
+export * from './xo-app';
+export type * from './types/app';