@e-xi/xion 0.0.6

package/dist/main/config/types/logger.d.ts

@@ -0,0 +1,82 @@
+declare global {
+
+    // 日志配置
+    namespace XoLogger {
+
+        // 日志格式
+        // 占位符：
+        // {y}-{m}-{d}    -> 2026-05-09 日期
+        // {h}:{i}:{s}    -> 12:21:30   时间
+        // {ms}           -> 123        毫秒
+        // {level}        -> info       等级（小写）
+        // {levelUpper}   -> INFO       等级（大写）
+        // {initial}      -> i w e      等级（首字母，小写）
+        // {initialUpper} -> I W E      等级（首字母，大写）
+        // {scopeLabel}   -> main       作用域标签
+        // {message}      -> message    日志消息
+        // 如：{y}-{m}-{d} {h}:{i}:{s}.{ms} [{levelUpper}] {scopeLabel}{message}
+        type Format = string
+
+        // 支持的日志等级
+        type Level = 'debug'
+                     | 'info'
+                     | 'warn'
+                     | 'error'
+                     | 'verbose'
+                     | 'silly'
+
+        // 日志清理频率
+        type CleanupFrequency = 'daily'
+
+        // 日志等级颜色
+        // 如：{
+        //   info : 'green',
+        //   warn : 'yellow',
+        //   error: 'red',
+        //   ...
+        // }
+        type LevelColors = {
+            readonly [K in Level]: keyof XoColor.Ansi
+        }
+
+        // 控制台日志配置
+        interface Console {
+            // 日志等级
+            level?: Level
+            // 日志格式
+            format?: Format
+            // 是否使用样式
+            useStyles?: boolean
+            // 日志等级颜色
+            colors?: LevelColors
+        }
+
+        // 文件日志配置
+        interface File {
+            // 日志等级
+            level?: Level
+            // 日志格式
+            format?: Format
+            // 日志目录
+            dir?: string
+            // 文件主名称
+            fileName?: string
+            // 文件后缀
+            extension?: string
+            // 保留文件天数
+            retentionDays?: number
+            // 日志清理频率：daily=按天
+            cleanupFrequency?: CleanupFrequency
+        }
+
+        // 日志配置
+        interface Config {
+            // 控制台选项
+            console?: Console
+            // 文件选项
+            file?: File
+        }
+    }
+}
+
+export {}

package/dist/main/config/types/window.d.ts

@@ -0,0 +1,35 @@
+declare global {
+
+    // 窗口
+    namespace XoWindow {
+
+        // 窗口配置
+        interface Config {
+            // electron 窗口选项
+            browserOptions?: Electron.BrowserWindowConstructorOptions
+            // 窗口材质（browserOptions.backgroundMaterial 未设置时生效，优先级高于 XoApp.Config.windowMaterial）
+            // - transparent 窗口透明无边框 {backgroundMaterial: 'none'， transparent: true, backgroundColor: '#00000000', frame: false, thickFrame: false}
+            // - none        不使用材质 {backgroundMaterial: 'none', transparent: false}
+            // - mica        Windows 11 云母材质（带系统色调的柔和背景） {transparent: false, backgroundColor: '#00000000'}
+            // - acrylic     Windows 10 亚克力材质（毛玻璃，有半透明、模糊、透出背后内容的效果） {transparent: false, backgroundColor: '#00000000'}
+            // - tabbed      窗口背景使用 tabbed 风格的系统材质 {transparent: false, backgroundColor: '#00000000'}
+            windowMaterial?: XoApp.WindowMaterial
+            // 标题栏高度（优先级高于 XoApp.Config.titleBarOverlayConfig）
+            titleBarHeight?: number
+            // 是否等待 Renderer 渲染完成后再显示窗口
+            showAfterRendererReady?: boolean
+            // 开启开发者工具选项
+            openDevTools?: Electron.OpenDevToolsOptions
+            // 是否开启调试位置
+            debugPosition?: boolean
+            // 是否开启调试输入事件
+            debugInputEvent?: boolean
+            // 是否开启调试 IPC 消息
+            debugIpcMessage?: boolean
+            // 是否开启调试控制台
+            debugConsole?: boolean
+        }
+    }
+}
+
+export {}

package/dist/main/config/updater-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 定义更新器配置
+ * @param {XoUpdater.Config} config 更新器配置
+ * @returns {XoUpdater.Config}
+ */
+export declare const defineUpdaterConfig: (config?: XoUpdater.Config) => XoUpdater.Config;

package/dist/main/config/window/main-window-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 定义主窗口配置
+ * @param {XoWindow.Config} config 主窗口配置
+ * @returns {XoWindow.Config}
+ */
+export declare const defineMainWindowConfig: (config?: XoWindow.Config) => XoWindow.Config;

package/dist/main/config/window/setting-window-config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 定义配置窗口配置
+ * @param {XoWindow.Config} config 配置窗口配置
+ * @returns {XoWindow.Config}
+ */
+export declare const defineSettingWindowConfig: (config?: XoWindow.Config) => XoWindow.Config;

package/dist/main/file-association/file-association-handlers-abstract.d.ts

@@ -0,0 +1,23 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * 文件关联处理器抽象类
+ * @class FileAssociationHandlersAbstract
+ */
+export declare abstract class FileAssociationHandlersAbstract {
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 处理器映射
+     * @returns {XoFileAssociation.HandlerMap}
+     */
+    abstract handlerMap(): XoFileAssociation.HandlerMap;
+}

package/dist/main/file-association/file-association-manager-abstract.d.ts

@@ -0,0 +1,87 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * 文件关联管理器抽象类
+ * @class FileAssociationManagerAbstract
+ */
+export declare abstract class FileAssociationManagerAbstract {
+    /** 是否已初始化 */
+    private initialized;
+    /** 是否可以处理关联文件 */
+    private ready;
+    /** 文件处理队列 */
+    private readonly pendingFiles;
+    /** 文件处理任务队列 */
+    private processingPromise;
+    /** 已注册处理器类 */
+    private readonly registeredHandlerClasses;
+    /** 已注册文件扩展名 */
+    private readonly registeredExtensions;
+    /** 文件关联处理器映射 */
+    private readonly handlerMap;
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 初始化文件关联处理器
+     * @returns {boolean}
+     */
+    initialize(): boolean;
+    /**
+     * 注册处理器映射
+     * @param {XoFileAssociation.HandlerMap} handlers 处理器映射
+     * @returns {void}
+     * @private
+     */
+    private registerHandlerMap;
+    /**
+     * 文件处理就绪
+     * @returns {Promise<void>}
+     */
+    setReady(): Promise<void>;
+    /**
+     * 处理启动参数
+     * @param {readonly string[]} argv 启动参数
+     * @returns {Promise<boolean>} 是否处理了关联文件
+     */
+    handleArgv(argv: readonly string[]): Promise<boolean>;
+    /**
+     * 处理关联文件
+     * @param {string} value 文件路径
+     * @returns {Promise<boolean>}
+     */
+    handleFile(value: string): Promise<boolean>;
+    /**
+     * 解析关联文件
+     * @param {string} value 文件路径
+     * @returns {XoFileAssociation.Context | undefined}
+     * @private
+     */
+    private parseFile;
+    /**
+     * 处理当前等待队列
+     * @returns {Promise<void>}
+     * @private
+     */
+    private processPendingFiles;
+    /**
+     * 分发关联文件
+     * @param {string} filePath 文件路径
+     * @returns {Promise<void>}
+     * @private
+     */
+    private dispatch;
+    /**
+     * 创建自定义处理器列表
+     * @returns {XoFileAssociation.HandlersConstructor[]}
+     * @protected
+     */
+    protected abstract handlers(): XoFileAssociation.HandlersConstructor[];
+}

package/dist/main/file-association/file-association-manager.d.ts

@@ -0,0 +1,13 @@
+import { FileAssociationManagerAbstract } from './file-association-manager-abstract';
+/**
+ * 文件关联管理器
+ * @class FileAssociationManager
+ */
+export declare class FileAssociationManager extends FileAssociationManagerAbstract {
+    /**
+     * 自定义处理器列表
+     * @returns {XoFileAssociation.HandlersConstructor[]}
+     * @protected
+     */
+    protected handlers(): XoFileAssociation.HandlersConstructor[];
+}

package/dist/main/file-association/handlers/app-file-association-handlers.d.ts

@@ -0,0 +1,12 @@
+import { FileAssociationHandlersAbstract } from '../file-association-handlers-abstract';
+/**
+ * 应用文件关联处理器（内置）
+ * @class AppFileAssociationHandlers
+ */
+export declare class AppFileAssociationHandlers extends FileAssociationHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoFileAssociation.HandlerMap}
+     */
+    handlerMap(): XoFileAssociation.HandlerMap;
+}

package/dist/main/file-association/index.d.ts

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

package/dist/main/file-association/index.js

@@ -0,0 +1,13 @@
+import {
+  AppFileAssociationHandlers,
+  FileAssociationHandlersAbstract,
+  FileAssociationManager,
+  FileAssociationManagerAbstract
+} from "../../chunk-files/chunk-IH3R2NDR.js";
+import "../../chunk-files/chunk-VGDNICVG.js";
+export {
+  AppFileAssociationHandlers,
+  FileAssociationHandlersAbstract,
+  FileAssociationManager,
+  FileAssociationManagerAbstract
+};

package/dist/main/file-association/types/file-association.d.ts

@@ -0,0 +1,31 @@
+import type {XoAppAbstract}                   from '../../app/xo-app-abstract'
+import type {FileAssociationHandlersAbstract} from '../file-association-handlers-abstract'
+
+declare global {
+
+    // 文件关联
+    namespace XoFileAssociation {
+
+        // 文件扩展名（不带点）
+        type Extension = string
+
+        // 文件关联处理上下文
+        interface Context {
+            // 文件完整路径
+            filePath: string
+            // 文件扩展名（不带点）
+            extension: Extension
+        }
+
+        // 文件关联处理器
+        type Handler = (context: Context) => Promise<void> | void
+
+        // 文件关联处理器映射
+        type HandlerMap = Partial<Record<Extension, Handler>>
+
+        // 文件关联处理器构造函数
+        type HandlersConstructor = new (xoApp: XoAppAbstract) => FileAssociationHandlersAbstract
+    }
+}
+
+export {}

package/dist/main/ipc/handlers/app-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 应用处理器（内置）
+ * @class AppHandlers
+ */
+export declare class AppHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/auth-handlers.d.ts

@@ -0,0 +1,12 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * JWT 认证处理器（内置）
+ * @class AuthHandlers
+ */
+export declare class AuthHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/clipboard-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 剪切板处理器（内置）
+ * @class ClipboardHandlers
+ */
+export declare class ClipboardHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/contex-menu-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 上下文菜单处理器（内置）
+ * @class ContexMenuHandlers
+ */
+export declare class ContexMenuHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/dialog-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 对话框处理器（内置）
+ * @class DialogHandlers
+ */
+export declare class DialogHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/file-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 文件处理器（内置）
+ * @class FileHandlers
+ */
+export declare class FileHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/log-handlers.d.ts

@@ -0,0 +1,45 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 渲染进程日志处理器（内置）
+ * @class LogHandlers
+ */
+export declare class LogHandlers extends IpcHandlersAbstract {
+    /** 每个渲染进程的日志限流记录 */
+    private readonly rateLimits;
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+    /**
+     * 写入渲染进程日志
+     * @param {Electron.IpcMainInvokeEvent} event   IPC 事件
+     * @param {XoIpcLogger.Level}           level   日志等级
+     * @param {XoIpcLogger.Request}         request 日志请求
+     * @returns {Promise<XoIpc.Result>}
+     * @private
+     */
+    private write;
+    /**
+     * 验证 IPC 来源为受管理窗口的主 frame
+     * @param {Electron.IpcMainInvokeEvent} event IPC 事件
+     * @returns {boolean}
+     * @private
+     */
+    private isAllowedSender;
+    /**
+     * 检查日志请求序列化大小
+     * @param {XoIpcLogger.Request} request 日志请求
+     * @returns {boolean}
+     * @private
+     */
+    private isAllowedRequestSize;
+    /**
+     * 消耗一次日志限流额度
+     * @param {number} senderId WebContents ID
+     * @returns {boolean}
+     * @private
+     */
+    private consumeRateLimit;
+}

package/dist/main/ipc/handlers/remote-service-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 远程服务处理器（内置）
+ * @class RemoteServiceHandlers
+ */
+export declare class RemoteServiceHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/shell-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * Shell 处理器（内置）
+ * @class ShellHandlers
+ */
+export declare class ShellHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/theme-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 主题处理器（内置）
+ * @class ThemeHandlers
+ */
+export declare class ThemeHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/updater-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 更新器处理器（内置）
+ * @class UpdaterHandlers
+ */
+export declare class UpdaterHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

package/dist/main/ipc/handlers/window-handlers.d.ts

@@ -0,0 +1,13 @@
+import { IpcHandlersAbstract } from '../ipc-handlers-abstract';
+/**
+ * 窗口处理器（内置）
+ * @class WindowHandlers
+ */
+export declare class WindowHandlers extends IpcHandlersAbstract {
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     * @constructor
+     */
+    handlerMap(): XoIpc.HandlerMap;
+}

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

@@ -0,0 +1,20 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './handlers/app-handlers';
+export * from './handlers/auth-handlers';
+export * from './handlers/clipboard-handlers';
+export * from './handlers/contex-menu-handlers';
+export * from './handlers/dialog-handlers';
+export * from './handlers/file-handlers';
+export * from './handlers/log-handlers';
+export * from './handlers/remote-service-handlers';
+export * from './handlers/shell-handlers';
+export * from './handlers/theme-handlers';
+export * from './handlers/updater-handlers';
+export * from './handlers/window-handlers';
+export * from './ipc-handlers-abstract';
+export * from './ipc-manager-abstract';
+export * from './ipc-manager';
+export * from './utils/ipc-handler-util';
+export type * from './types/ipc-handler';

package/dist/main/ipc/index.js

@@ -0,0 +1,60 @@
+import {
+  AppHandlers,
+  AuthHandlers,
+  ClipboardHandlers,
+  ContexMenuHandlers,
+  DialogHandlers,
+  FileHandlers,
+  IpcHandlerUtil,
+  IpcHandlersAbstract,
+  IpcManager,
+  IpcManagerAbstract,
+  LogHandlers,
+  RemoteServiceHandlers,
+  ShellHandlers,
+  ThemeHandlers,
+  UpdaterHandlers,
+  WindowHandlers
+} from "../../chunk-files/chunk-4SSGMLEE.js";
+import "../../chunk-files/chunk-W2I3I7U7.js";
+import "../../chunk-files/chunk-BPTFUGTP.js";
+import "../../chunk-files/chunk-KFV4GXVE.js";
+import "../../chunk-files/chunk-RAVPJRBA.js";
+import "../../chunk-files/chunk-LQ67F6EY.js";
+import "../../chunk-files/chunk-BFD2LHLK.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-RN7AI33H.js";
+import "../../chunk-files/chunk-6BOPFOZD.js";
+import "../../chunk-files/chunk-WKVLVI6N.js";
+import "../../chunk-files/chunk-Y3OEXVQ2.js";
+import "../../chunk-files/chunk-UIJUY7QZ.js";
+import "../../chunk-files/chunk-T3QCAOCO.js";
+import "../../chunk-files/chunk-ID3YDA2K.js";
+import "../../chunk-files/chunk-KFK47PDH.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 {
+  AppHandlers,
+  AuthHandlers,
+  ClipboardHandlers,
+  ContexMenuHandlers,
+  DialogHandlers,
+  FileHandlers,
+  IpcHandlerUtil,
+  IpcHandlersAbstract,
+  IpcManager,
+  IpcManagerAbstract,
+  LogHandlers,
+  RemoteServiceHandlers,
+  ShellHandlers,
+  ThemeHandlers,
+  UpdaterHandlers,
+  WindowHandlers
+};

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

@@ -0,0 +1,23 @@
+import type { XoAppAbstract } from '../app/xo-app-abstract';
+/**
+ * IPC 处理器抽象类
+ * @class IpcHandlersAbstract
+ */
+export declare abstract class IpcHandlersAbstract {
+    /**
+     * Xion 应用
+     * @type {XoAppAbstract}
+     * @protected
+     */
+    protected readonly xoApp: XoAppAbstract;
+    /**
+     * 构造函数
+     * @param {XoAppAbstract} xoApp Xion 应用
+     */
+    constructor(xoApp: XoAppAbstract);
+    /**
+     * 处理器映射
+     * @returns {XoIpc.HandlerMap}
+     */
+    abstract handlerMap(): XoIpc.HandlerMap;
+}