@e-xi/xion 0.0.6

package/dist/main/ipc/ipc-manager-abstract.d.ts

@@ -0,0 +1,46 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * IPC 管理器抽象类
+ * @class IpcManagerAbstract
+ */
+export declare abstract class IpcManagerAbstract {
+    /**
+     * 是否已注册
+     * @type {boolean}
+     * @private
+     */
+    private registered;
+    /**
+     * 已注册处理器类
+     * @type {Set<XoIpc.HandlersConstructor>}
+     * @private
+     */
+    private readonly registeredHandlerClasses;
+    /**
+     * 已注册通道
+     * @type {Set<XoIpc.Channel>}
+     * @private
+     */
+    private readonly registeredChannels;
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 注册所有处理器
+     */
+    register(): void;
+    /**
+     * 创建处理器列表
+     * @returns {XoIpc.HandlersConstructor[]}
+     * @protected
+     */
+    protected abstract handlers(): XoIpc.HandlersConstructor[];
+}

package/dist/main/ipc/ipc-manager.d.ts

@@ -0,0 +1,13 @@
+import { IpcManagerAbstract } from './ipc-manager-abstract';
+/**
+ * IPC 管理器
+ * @class IpcManager
+ */
+export declare class IpcManager extends IpcManagerAbstract {
+    /**
+     * 处理器列表
+     * @returns {XoIpc.HandlersConstructor[]}
+     * @protected
+     */
+    protected handlers(): XoIpc.HandlersConstructor[];
+}

package/dist/main/ipc/types/ipc-handler.d.ts

@@ -0,0 +1,22 @@
+import type {XoAppAbstract}       from '../../app/xo-app-abstract'
+import type {IpcHandlersAbstract} from '../ipc-handlers-abstract'
+
+declare global {
+
+    // IPC
+    namespace XoIpc {
+
+        // 处理器
+        type Handler<R extends Result = Result> = (event: Electron.IpcMainInvokeEvent, request: any) => Promise<R | void>
+
+        // 处理器映射
+        type HandlerMap = {
+            [key in Channel]?: Handler
+        }
+
+        // 处理器构造函数
+        type HandlersConstructor = new (app: XoAppAbstract) => IpcHandlersAbstract
+    }
+}
+
+export {}

package/dist/main/ipc/utils/ipc-handler-util.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IPC 处理器工具
+ * @class IpcHandlerUtil
+ */
+export declare class IpcHandlerUtil {
+    /**
+     * 包装IPC处理器
+     * @param {XoIpc.Handler} handler 原始处理器
+     * @returns {XoIpc.Handler}
+     */
+    static wrap(handler: XoIpc.Handler): XoIpc.Handler;
+    /**
+     * 判断是否为IPC结果
+     * @param {unknown} value 值
+     * @returns {value is XoIpc.Result}
+     */
+    private static isResult;
+    /**
+     * 转换错误消息
+     * @param {unknown} error 错误
+     * @returns {string}
+     */
+    private static toMessage;
+}

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

@@ -0,0 +1,4 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './xo-logger';

package/dist/main/logger/index.js

@@ -0,0 +1,13 @@
+import {
+  XoLogger
+} from "../../chunk-files/chunk-YXAEUJKJ.js";
+import "../../chunk-files/chunk-P4CX6I4J.js";
+import "../../chunk-files/chunk-3KBZWBNP.js";
+import "../../chunk-files/chunk-FPN7JYR4.js";
+import "../../chunk-files/chunk-RODB64YF.js";
+import "../../chunk-files/chunk-GN2FNR3Z.js";
+import "../../chunk-files/chunk-3RVKOFMP.js";
+import "../../chunk-files/chunk-FMQTZ3QV.js";
+export {
+  XoLogger
+};

package/dist/main/logger/xo-logger.d.ts

@@ -0,0 +1,113 @@
+import type { Logger } from 'electron-log';
+/**
+ * Xion 日志
+ * @class XoLogger
+ */
+export declare class XoLogger {
+    /**
+     * ElectronLog 日志实例
+     * @type {Logger}
+     * @private
+     */
+    private readonly instance;
+    /**
+     * 进程类型
+     * @type {XoApp.Process}
+     * @private
+     */
+    private readonly processType;
+    /**
+     * 日志配置
+     * @type {XoLogger.Config}
+     * @private
+     */
+    private readonly config;
+    /**
+     * 可清理的日志目录
+     * @type {Map<string, string>}
+     * @private
+     */
+    private readonly cleanedDirs;
+    /**
+     * 构造函数
+     * @param {XoApp.Process}   processType 进程类型
+     * @param {XoLogger.Config} config      日志配置
+     */
+    constructor(processType: XoApp.Process, config?: XoLogger.Config);
+    /**
+     * 获取日志实例
+     * @returns {Logger}
+     */
+    get log(): Logger;
+    /**
+     * 设置日志等级
+     * <p>开发环境设置控制台和文件日志，打包环境仅设置文件日志。</p>
+     * @param {XoLogger.Level} level 日志等级
+     * @returns {void}
+     */
+    setLevel(level?: XoLogger.Level): void;
+    /**
+     * 初始化默认 ElectronLog
+     * @private
+     */
+    private static initialize;
+    /**
+     * 获取或创建日志实例
+     * @param {XoLogger} log Xion 日志
+     * @returns {Logger}
+     * @private
+     */
+    private static getOrCreate;
+    /**
+     * 日志根目录
+     * @returns {string}
+     * @private
+     */
+    private rootDir;
+    /**
+     * 清理过期日志
+     * @param {string} logsDir 日志目录
+     * @param {string} today   今日日期，如：0000-00-00
+     * @private
+     */
+    private cleanupExpiredLogs;
+    /**
+     * 日志等级格式化
+     * @param {string}       level   日志等级
+     * @param {LevelOptions} options 日志等级选项
+     * @returns {string}
+     * @private
+     */
+    private levelFormatter;
+    /**
+     * 日志消息格式化
+     * @param {XoLogger.Format} template 日志模板
+     * @param {FormatOptions}   options  日志格式选项
+     * @returns {Exclude<Format string>}
+     * @private
+     */
+    private messageFormatter;
+    /**
+     * 格式化日志值
+     * @param {unknown}       value   日志值
+     * @param {FormatOptions} options 日志格式选项
+     * @returns {unknown}
+     * @private
+     */
+    private formatValue;
+    /**
+     * 格式化日志文本
+     * @param {string}        text    日志文本
+     * @param {FormatOptions} options 日志格式选项
+     * @returns {string}
+     * @private
+     */
+    private formatText;
+    /**
+     * 是否为普通对象
+     * @param {unknown} value 值
+     * @returns {value is Record<string, unknown>}
+     * @private
+     */
+    private isPlainObject;
+}

package/dist/main/menu/consts/menu-type.d.ts

@@ -0,0 +1 @@
+export declare const MenuTypePrefix: "MenuType_";

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

@@ -0,0 +1,8 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './consts/menu-type';
+export * from './menu-items';
+export * from './menu-manager-abstract';
+export * from './menu-manager';
+export type * from './types/menu';

package/dist/main/menu/index.js

@@ -0,0 +1,28 @@
+import {
+  MenuTypePrefix
+} from "../../chunk-files/chunk-HT5V5A7S.js";
+import {
+  MenuItems,
+  MenuManager,
+  MenuManagerAbstract
+} from "../../chunk-files/chunk-UFYEZIUE.js";
+import "../../chunk-files/chunk-GUOSVDXA.js";
+import "../../chunk-files/chunk-EQTU45UO.js";
+import "../../chunk-files/chunk-YLZRRUY7.js";
+import "../../chunk-files/chunk-DEODEAKM.js";
+import "../../chunk-files/chunk-PVWRRUOK.js";
+import "../../chunk-files/chunk-OUFO3LM4.js";
+import "../../chunk-files/chunk-6FDO72PN.js";
+import "../../chunk-files/chunk-U4XEWVBH.js";
+import "../../chunk-files/chunk-BMOLIJ3W.js";
+import "../../chunk-files/chunk-6BOPFOZD.js";
+import "../../chunk-files/chunk-Y3OEXVQ2.js";
+import "../../chunk-files/chunk-ID3YDA2K.js";
+import "../../chunk-files/chunk-FPN7JYR4.js";
+import "../../chunk-files/chunk-RODB64YF.js";
+export {
+  MenuItems,
+  MenuManager,
+  MenuManagerAbstract,
+  MenuTypePrefix
+};

package/dist/main/menu/menu-items.d.ts

@@ -0,0 +1,192 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * Xion 内置菜单项
+ * @class MenuItems
+ */
+export declare class MenuItems {
+    /**
+     * 内置菜单图标
+     * @param {string} name 图标名称
+     * @returns {XoMenu.Icon}
+     */
+    protected static icon(name: string): XoMenu.Icon;
+    /**
+     * 菜单组
+     * @param {string}          label 菜单组名称
+     * @param {XoMenu.SubMenus} items 菜单项
+     * @returns {XoMenu.Item}
+     */
+    static group(label: string, items: XoMenu.SubMenus): XoMenu.Item;
+    /**
+     * 分割线
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static separator(enabled?: boolean): XoMenu.Item;
+    /**
+     * 撤销
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static undo(enabled?: boolean): XoMenu.Item;
+    /**
+     * 重做
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static redo(enabled?: boolean): XoMenu.Item;
+    /**
+     * 剪切
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static cut(enabled?: boolean): XoMenu.Item;
+    /**
+     * 复制
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static copy(enabled?: boolean): XoMenu.Item;
+    /**
+     * 粘贴
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static paste(enabled?: boolean): XoMenu.Item;
+    /**
+     * 删除
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static del(enabled?: boolean): XoMenu.Item;
+    /**
+     * 全选
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static selectAll(enabled?: boolean): XoMenu.Item;
+    /**
+     * 最小化
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static minimize(enabled?: boolean): XoMenu.Item;
+    /**
+     * 刷新
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static reload(enabled?: boolean): XoMenu.Item;
+    /**
+     * 强制刷新
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static forceReload(enabled?: boolean): XoMenu.Item;
+    /**
+     * 切换全屏
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static toggleFullscreen(enabled?: boolean): XoMenu.Item;
+    /**
+     * 切换开发者工具
+     * @returns {XoMenu.Item}
+     */
+    static toggleDevTools(): XoMenu.Item;
+    /**
+     * 关闭窗口
+     * @param {boolean} enabled 是否启用
+     * @param {string}  label   名称
+     * @returns {XoMenu.Item}
+     */
+    static close(enabled?: boolean, label?: string): XoMenu.Item;
+    /**
+     * 关于
+     * @param {boolean} enabled 是否启用
+     * @param {string}  label   名称
+     * @returns {XoMenu.Item}
+     */
+    static about(enabled?: boolean, label?: string): XoMenu.Item;
+    /**
+     * 打开链接
+     * @param {string}  url     链接地址
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static openLink(url?: string, enabled?: boolean): XoMenu.Item;
+    /**
+     * 复制链接地址
+     * @param {string}  url     链接地址
+     * @param {boolean} enabled 是否启用
+     * @returns {XoMenu.Item}
+     */
+    static copyLink(url?: string, enabled?: boolean): XoMenu.Item;
+    /**
+     * 打开图片
+     * @param {XoMenu.ContextState} state 上下文状态
+     * @returns {XoMenu.Item}
+     */
+    static openImage(state: XoMenu.ContextState): XoMenu.Item;
+    /**
+     * 复制图片
+     * @param {XoMenu.ContextState} state 上下文状态
+     * @returns {XoMenu.Item}
+     */
+    static copyImage(state: XoMenu.ContextState): XoMenu.Item;
+    /**
+     * 复制图像链接
+     * @param {XoMenu.ContextState} state 上下文状态
+     * @returns {XoMenu.Item}
+     */
+    static copyImageLink(state: XoMenu.ContextState): XoMenu.Item;
+    /**
+     * 将图像另存为
+     * @param {XoMenu.ContextState} state 上下文状态
+     * @returns {XoMenu.Item}
+     */
+    static saveImageAs(state: XoMenu.ContextState): XoMenu.Item;
+    /**
+     * 获取图片文件名
+     * @param {XoMenu.ContextState} state 上下文状态
+     * @returns {string}
+     */
+    protected static imageFileName(state: XoMenu.ContextState): string;
+    /**
+     * 显示主窗口
+     * @param {XoAppAbstract} xoApp XionApp
+     * @returns {XoMenu.Item}
+     */
+    static showMainWindow(xoApp: XoAppAbstract): XoMenu.Item;
+    /**
+     * 显示设置窗口
+     * @param {XoAppAbstract} xoApp XionApp
+     * @param {string}        label 名称
+     * @returns {XoMenu.Item}
+     */
+    static showSettingWindow(xoApp: XoAppAbstract, label?: string): XoMenu.Item;
+    /**
+     * 检查更新
+     * @param {XoAppAbstract} xoApp   XionApp
+     * @param {string}        label   名称
+     * @param {string}        version 当前版本号
+     * @returns {XoMenu.Item}
+     */
+    static checkForUpdate(xoApp: XoAppAbstract, label?: string, version?: string): XoMenu.Item;
+    /**
+     * 打开设置窗口并跳转到指定路由
+     * <p>先确保设置窗口存在，避免首次创建时丢失路由请求。</p>
+     * @param {XoAppAbstract} xoApp XionApp
+     * @param {XoWindow.RouteRedirectRequestWithoutWindow} request 路由重定向请求
+     * @returns {Promise<void>}
+     * @private
+     */
+    private static showSettingWindowWithRoute;
+    /**
+     * 退出应用
+     * @param {XoAppAbstract} xoApp XionApp
+     * @param {string}        label 名称
+     * @returns {XoMenu.Item}
+     */
+    static appQuit(xoApp: XoAppAbstract, label?: string): XoMenu.Item;
+}