@e-xi/xion 0.0.6

package/dist/shared/ipc/channels/window-channels.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 窗口通道
+ * @class WindowChannels
+ */
+export declare class WindowChannels {
+    /** 渲染进程首屏渲染完成 */
+    static ready: `Channel_${string}`;
+    /** 是否等待 Renderer 渲染完成后再显示窗口 */
+    static shouldShowAfterRendererReady: `Channel_${string}`;
+    /** 获取窗口状态 */
+    static getState: `Channel_${string}`;
+    /** 获取当前已打开窗口标识 */
+    static getOpenedWindowIdentities: `Channel_${string}`;
+    /** 最小化窗口 */
+    static minimize: `Channel_${string}`;
+    /** 最大化窗口 */
+    static maximize: `Channel_${string}`;
+    /** 是否已最大化 */
+    static isMaximized: `Channel_${string}`;
+    /** 取消最大化窗口 */
+    static unmaximize: `Channel_${string}`;
+    /** 全屏窗口 */
+    static fullScreen: `Channel_${string}`;
+    /** 退出全屏窗口 */
+    static exitFullScreen: `Channel_${string}`;
+    /** 重新加载窗口 */
+    static reload: `Channel_${string}`;
+    /** 居中窗口 */
+    static center: `Channel_${string}`;
+    /** 隐藏窗口 */
+    static hide: `Channel_${string}`;
+    /** 还原窗口 */
+    static restore: `Channel_${string}`;
+    /** 切换窗口置顶 */
+    static toggleAlwaysOnTop: `Channel_${string}`;
+    /** 切换侧边栏折叠 */
+    static toggleSidebarFold: `Channel_${string}`;
+    /** 关闭窗口 */
+    static close: `Channel_${string}`;
+    /** 监听窗口状态 */
+    static onState: `Channel_${string}`;
+    /** 监听路由重定向 */
+    static onRouteRedirect: `Channel_${string}`;
+}

package/dist/shared/ipc/consts/ipc-channel.d.ts

@@ -0,0 +1 @@
+export declare const IpcChannelPrefix: "Channel_";

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

@@ -0,0 +1,19 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './channels/app-channels';
+export * from './channels/auth-channels';
+export * from './channels/clipboard-channels';
+export * from './channels/context-menu-channels';
+export * from './channels/dialog-channels';
+export * from './channels/file-channels';
+export * from './channels/log-channels';
+export * from './channels/remote-service-channels';
+export * from './channels/shell-channels';
+export * from './channels/theme-channels';
+export * from './channels/updater-channels';
+export * from './channels/window-channels';
+export * from './consts/ipc-channel';
+export * from './ipc-result';
+export type * from './types/ipc-logger';
+export type * from './types/ipc';

package/dist/shared/ipc/index.js

@@ -0,0 +1,46 @@
+import {
+  IpcResult
+} from "../../chunk-files/chunk-W2I3I7U7.js";
+import {
+  AppChannels,
+  ClipboardChannels,
+  DialogChannels,
+  FileChannels,
+  LogChannels,
+  ShellChannels
+} from "../../chunk-files/chunk-RAVPJRBA.js";
+import {
+  UpdaterChannels
+} from "../../chunk-files/chunk-LQ67F6EY.js";
+import {
+  ContextMenuChannels,
+  WindowChannels
+} from "../../chunk-files/chunk-BFD2LHLK.js";
+import {
+  RemoteServiceChannels
+} from "../../chunk-files/chunk-RN7AI33H.js";
+import {
+  ThemeChannels
+} from "../../chunk-files/chunk-UIJUY7QZ.js";
+import {
+  AuthChannels
+} from "../../chunk-files/chunk-T3QCAOCO.js";
+import {
+  IpcChannelPrefix
+} from "../../chunk-files/chunk-ID3YDA2K.js";
+export {
+  AppChannels,
+  AuthChannels,
+  ClipboardChannels,
+  ContextMenuChannels,
+  DialogChannels,
+  FileChannels,
+  IpcChannelPrefix,
+  IpcResult,
+  LogChannels,
+  RemoteServiceChannels,
+  ShellChannels,
+  ThemeChannels,
+  UpdaterChannels,
+  WindowChannels
+};

package/dist/shared/ipc/ipc-result.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ipc 调用结果
+ * @class IpcResult
+ */
+export declare class IpcResult {
+    /**
+     * 成功结果
+     * @param {any} data IPC 调用结果 data 对象
+     * @returns {XoIpc.Result}
+     */
+    static success(data?: any): XoIpc.Result;
+    /**
+     * 失败结果
+     * @param {string} message 消息
+     * @param {number} code    错误码
+     * @param {any}    data    IPC 调用结果 data 对象
+     * @returns {XoIpc.Result}
+     */
+    static fail(message: string, code?: number, data?: any): XoIpc.Result;
+}

package/dist/shared/ipc/types/ipc-logger.d.ts

@@ -0,0 +1,27 @@
+declare global {
+
+    // Ipc Logger
+    namespace XoIpcLogger {
+
+        // 日志等级
+        type Level = 'debug' | 'info' | 'warn' | 'error'
+
+        // 日志值类型
+        type Value = null | boolean | number | string | Value[] | {
+            [key: string]: Value
+        }
+
+        // 日志请求
+        interface Request {
+            // 日志消息
+            message: string
+            // 日志数据
+            data: Value[]
+        }
+
+        // 日志写入器
+        type Write = (message: string, ...data: unknown[]) => Promise<void>
+    }
+}
+
+export {}

package/dist/shared/ipc/types/ipc.d.ts

@@ -0,0 +1,61 @@
+import {IpcChannelPrefix} from '../consts/ipc-channel'
+
+declare global {
+
+    // IPC
+    namespace XoIpc {
+
+        // IPC 通道
+        type Channel = `${typeof IpcChannelPrefix}${string}`
+
+        // IPC 调用结果
+        interface Result<T = any> {
+            // 是否成功
+            success: boolean
+            // 错误码
+            code: number
+            // 消息
+            message: string
+            // 数据
+            data?: T
+        }
+
+        /**
+         * 监听主进程消息
+         * @param {Result} result 结果
+         */
+        type Listener = (result: Result) => void
+
+        /**
+         * 调用主进程方法
+         * @param {Channel} channel 通道
+         * @param {any}     args    参数
+         * @returns {Promise<Result>}
+         */
+        type Invoke = <T = any>(channel: Channel, args: T) => Promise<Result>
+
+        /**
+         * 发送主进程消息
+         * @param {Channel} channel 通道
+         * @param {any}     args    参数
+         */
+        type Send = <T = any>(channel: Channel, args: T) => void
+
+        /**
+         * 监听主进程消息
+         * @param {Channel}  channel  通道
+         * @param {Listener} listener 监听器
+         * @returns {() => void}
+         */
+        type On = (channel: Channel, listener: Listener) => () => void
+
+        /**
+         * 单次监听主进程消息
+         * @param {Channel}  channel  通道
+         * @param {Listener} listener 监听器
+         */
+        type Once = (channel: Channel, listener: Listener) => void
+    }
+}
+
+export {}

package/dist/shared/logger/consts/log-levels.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 支持的日志等级
+ */
+export declare const LogLevels: readonly ["debug", "info", "warn", "error", "verbose", "silly"];
+/**
+ * 是否为支持的日志等级
+ * @param {unknown} value 值
+ * @returns {value is XoLogger.Level}
+ */
+export declare function isLogLevel(value: unknown): value is XoLogger.Level;
+/**
+ * 日志等级选项
+ */
+export declare const LogLevelOptions: XoRenderer.RadioOptions<XoLogger.Level>;

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

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

package/dist/shared/logger/index.js

@@ -0,0 +1,10 @@
+import {
+  LogLevelOptions,
+  LogLevels,
+  isLogLevel
+} from "../../chunk-files/chunk-WKVLVI6N.js";
+export {
+  LogLevelOptions,
+  LogLevels,
+  isLogLevel
+};

package/dist/shared/menu/consts/menu-command.d.ts

@@ -0,0 +1 @@
+export declare const MenuCommandPrefix: "MenuCommand_";

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

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

package/dist/shared/menu/index.js

@@ -0,0 +1,10 @@
+import {
+  MenuCommands
+} from "../../chunk-files/chunk-GUOSVDXA.js";
+import {
+  MenuCommandPrefix
+} from "../../chunk-files/chunk-U4XEWVBH.js";
+export {
+  MenuCommandPrefix,
+  MenuCommands
+};

package/dist/shared/menu/menu-command.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 内置菜单命令
+ */
+export declare const MenuCommands: {
+    editUndo: `MenuCommand_${string}`;
+    editRedo: `MenuCommand_${string}`;
+    editCut: `MenuCommand_${string}`;
+    editCopy: `MenuCommand_${string}`;
+    editPaste: `MenuCommand_${string}`;
+    editDelete: `MenuCommand_${string}`;
+    editSelectAll: `MenuCommand_${string}`;
+    windowReload: `MenuCommand_${string}`;
+    windowForceReload: `MenuCommand_${string}`;
+    windowMinimize: `MenuCommand_${string}`;
+    windowToggleFullscreen: `MenuCommand_${string}`;
+    windowClose: `MenuCommand_${string}`;
+    windowToggleDevTools: `MenuCommand_${string}`;
+    linkOpen: `MenuCommand_${string}`;
+    linkCopy: `MenuCommand_${string}`;
+    imageOpen: `MenuCommand_${string}`;
+    imageSaveAs: `MenuCommand_${string}`;
+    imageCopy: `MenuCommand_${string}`;
+    imageCopyLink: `MenuCommand_${string}`;
+};

package/dist/shared/menu/types/menu.d.ts

@@ -0,0 +1,72 @@
+import {MenuCommandPrefix} from '../consts/menu-command'
+
+declare global {
+
+    // 菜单
+    namespace XoMenu {
+
+        // 菜单图标
+        interface Icon {
+            // 图标类型
+            type: 'image' | 'class'
+            // 图标值
+            value: string
+        }
+
+        // 渲染进程菜单项
+        interface RendererItem<T = any> {
+            // 菜单项 ID
+            id: string
+            // 菜单名称
+            label: string
+            // 菜单类型
+            type: 'normal' | 'separator' | 'submenu' | 'checkbox' | 'radio'
+            // 是否启用
+            enabled: boolean
+            // 是否显示
+            visible: boolean
+            // 是否选中
+            checked: boolean
+            // 快捷键
+            accelerator: string | null
+            // 图标
+            icon: Icon | null
+            // 命令
+            command: Command | null
+            // 命令参数
+            payload: T
+            // 子菜单
+            submenu: RendererItem[]
+        }
+
+        // 菜单命令
+        type Command = `${typeof MenuCommandPrefix}${string}`
+
+        // 上下文菜单请求
+        interface ContextMenuRequest {
+            // 请求 ID
+            requestId: string
+            // 菜单 X 坐标
+            x: number
+            // 菜单 Y 坐标
+            y: number
+            // 菜单项
+            items: RendererItem[]
+        }
+
+        // 上下文菜单请求监听器
+        type ContextMenuRequestedListener = (request: ContextMenuRequest) => void
+
+        // 执行菜单命令请求
+        interface ExecuteCommandRequest<T = any> {
+            // 请求 ID
+            requestId: string
+            // 命令
+            command: Command
+            // 命令参数
+            payload: T
+        }
+    }
+}
+
+export {}

package/dist/shared/mode/consts/command.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vite 开发命令
+ * @type {string}
+ */
+export declare const CommandServe: XoMode.Command;
+/**
+ * Vite 构建命令
+ * @type {string}
+ */
+export declare const CommandBuild: XoMode.Command;

package/dist/shared/mode/consts/mode.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 开发模式常量
+ * @type {string}
+ */
+export declare const ModeDevelopment: XoMode.Mode;
+/**
+ * 预发布模式常量
+ * @type {string}
+ */
+export declare const ModeStaging: XoMode.Mode;
+/**
+ * 生产模式常量
+ * @type {string}
+ */
+export declare const ModeProduction: XoMode.Mode;
+/**
+ * 标准化模式
+ * @param mode 模式
+ * @returns {XoMode.Mode | undefined}
+ * @constructor
+ */
+export declare const NormalizeMode: (mode: unknown) => XoMode.Mode | undefined;

package/dist/shared/mode/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './consts/command';
+export * from './consts/mode';

package/dist/shared/mode/index.js

@@ -0,0 +1,18 @@
+import {
+  CommandBuild,
+  CommandServe
+} from "../../chunk-files/chunk-3XOVD6UX.js";
+import {
+  ModeDevelopment,
+  ModeProduction,
+  ModeStaging,
+  NormalizeMode
+} from "../../chunk-files/chunk-FMQTZ3QV.js";
+export {
+  CommandBuild,
+  CommandServe,
+  ModeDevelopment,
+  ModeProduction,
+  ModeStaging,
+  NormalizeMode
+};

package/dist/shared/remote-service/const/remote-service.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 远程服务状态
+ */
+export declare const RemoteServiceStatus: readonly ["idle", "connecting", "connected", "disconnected", "error"];
+/**
+ * 远程服务状态选项
+ */
+export declare const RemoteServiceStatusOptions: XoRemoteService.StatusOption[];

package/dist/shared/remote-service/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './const/remote-service';
+export type * from './types/remote-service';

package/dist/shared/remote-service/index.js

@@ -0,0 +1,38 @@
+// src/shared/remote-service/const/remote-service.ts
+var RemoteServiceStatus = ["idle", "connecting", "connected", "disconnected", "error"];
+var RemoteServiceStatusOptions = [
+  {
+    status: "idle",
+    label: "\u7A7A\u95F2",
+    details: "\u8FDC\u7A0B\u670D\u52A1\u7A7A\u95F2",
+    type: "info"
+  },
+  {
+    status: "connecting",
+    label: "\u8FDE\u63A5\u4E2D",
+    details: "\u8FDC\u7A0B\u670D\u52A1\u8FDE\u63A5\u4E2D",
+    type: "primary"
+  },
+  {
+    status: "connected",
+    label: "\u5DF2\u8FDE\u63A5",
+    details: "\u8FDC\u7A0B\u670D\u52A1\u5DF2\u8FDE\u63A5",
+    type: "success"
+  },
+  {
+    status: "disconnected",
+    label: "\u5DF2\u65AD\u5F00",
+    details: "\u8FDC\u7A0B\u670D\u52A1\u5DF2\u65AD\u5F00",
+    type: "warning"
+  },
+  {
+    status: "error",
+    label: "\u9519\u8BEF",
+    details: "\u8FDC\u7A0B\u670D\u52A1\u8FDE\u63A5\u9519\u8BEF",
+    type: "danger"
+  }
+];
+export {
+  RemoteServiceStatus,
+  RemoteServiceStatusOptions
+};

package/dist/shared/remote-service/types/remote-service.d.ts

@@ -0,0 +1,146 @@
+import {RemoteServiceStatus} from '../const/remote-service'
+
+declare global {
+
+    // 远程服务
+    namespace XoRemoteService {
+
+        // 远程服务请求方法
+        type Method = 'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+
+        // 远程服务请求参数
+        interface Request<TBody = unknown> {
+            // 请求方法
+            method: Method
+            // 服务相对路径，只允许以 / 开头
+            path: string
+            // 查询参数
+            query?: Record<string, string | number | boolean | Array<string | number | boolean>>
+            // 请求头，Authorization、X-Refresh-Token、Cookie 等敏感请求头由主进程管理
+            headers?: Record<string, string>
+            // JSON 请求体或文本请求体
+            body?: TBody
+        }
+
+        // JWT 请求
+        type JwtRequest<TBody = unknown> = Omit<Request<TBody>, 'method' | 'path'>
+
+        // 远程服务响应
+        interface Response<T = unknown> {
+            // HTTP 状态码
+            status: number
+            // HTTP 状态文本
+            statusText: string
+            // 响应头
+            headers: Record<string, string>
+            // 响应数据
+            data?: T
+        }
+
+        // 连接状态
+        type Status = typeof RemoteServiceStatus[number]
+
+        // 状态选项
+        interface StatusOption {
+            // 状态
+            status: Status
+            // 标签
+            label: string
+            // 详情
+            details: string
+            // 类型
+            type: XoRenderer.EPTagType
+        }
+
+        // 远程服务配置
+        // 修改时需要同步检查修改 UserSettings、EffectiveSettings
+        interface Config {
+            // 是否启用远程服务，未启用时不发起连接和心跳
+            enabled?: boolean
+            // 服务地址，如 https://api.example.com（http/https 均可）
+            serviceUrl?: string
+            // 连接超时时间（毫秒）
+            connectionTimeout?: number
+            // 连接失败后的最大重试次数
+            retryCount?: number
+            // 重试间隔（毫秒）
+            retryDelay?: number
+            // 快速重试耗尽后的低频探测间隔（毫秒，最小 30000）
+            lowFrequencyProbeInterval?: number
+            // 心跳发送间隔（毫秒）
+            heartbeatInterval?: number
+            // 心跳探测路径，相对服务地址，如 /health
+            heartbeatPath?: string
+            // 远程请求凭据策略
+            requestCredentials?: RequestCredentials
+            // 远程请求重定向策略
+            requestRedirect?: RequestRedirect
+        }
+
+        // 远程服务用户设置（app-store 持久化，优先于 Config）
+        // 修改时需要同步修改 Config、EffectiveSettings
+        interface UserSettings {
+            // 是否启用远程服务
+            enabled?: boolean
+            // 服务地址，如 https://api.example.com（http/https 均可）
+            serviceUrl?: string
+            // 连接超时时间（毫秒）
+            connectionTimeout?: number
+            // 连接失败后的最大重试次数
+            retryCount?: number
+            // 重试间隔（毫秒）
+            retryDelay?: number
+            // 快速重试耗尽后的低频探测间隔（毫秒，最小 30000）
+            lowFrequencyProbeInterval?: number
+            // 心跳发送间隔（毫秒）
+            heartbeatInterval?: number
+            // 心跳探测路径，相对服务地址，如 /health，设置时必填
+            heartbeatPath?: string
+        }
+
+        // 实际生效的远程服务设置
+        // 修改时需要同步修改 Config、UserSettings
+        interface EffectiveSettings {
+            // 是否启用远程服务
+            enabled: boolean
+            // 服务地址
+            serviceUrl: string
+            // 连接超时时间（毫秒）
+            connectionTimeout: number
+            // 连接失败后的最大重试次数
+            retryCount: number
+            // 重试间隔（毫秒）
+            retryDelay: number
+            // 快速重试耗尽后的低频探测间隔（毫秒）
+            lowFrequencyProbeInterval: number
+            // 心跳发送间隔（毫秒）
+            heartbeatInterval: number
+            // 心跳探测路径，相对服务地址，如 /health
+            heartbeatPath: string
+            // 远程请求凭据策略
+            requestCredentials: RequestCredentials
+            // 远程请求重定向策略
+            requestRedirect: RequestRedirect
+        }
+
+        // 远程服务状态
+        interface State {
+            // 当前状态
+            status: Status
+            // 错误信息
+            error?: string
+            // 最近连接成功时间戳
+            connectedAt?: number
+            // 本次运行期间重连次数
+            reconnectCount: number
+        }
+
+        // 状态监听器
+        type StateListener = (state: State) => void
+
+        // 设置监听器
+        type SettingsListener = (settings: EffectiveSettings) => void
+    }
+}
+
+export {}

package/dist/shared/renderer/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export type * from './types/element-plus';
+export type * from './types/input';
+export type * from './types/options';
+export type * from './types/switch';

package/dist/shared/renderer/types/element-plus.d.ts

@@ -0,0 +1,20 @@
+declare global {
+
+    // Renderer
+    namespace XoRenderer {
+
+        // element-plus 大小
+        type EPSize = 'small' | 'default' | 'large'
+
+        // element-plus 按钮类型
+        type EPButtonType = 'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text'
+
+        // element-plus 标签类型
+        type EPTagType = 'primary' | 'success' | 'warning' | 'info' | 'danger'
+
+        // element-plus 文字类型
+        type EPTextType = 'primary' | 'success' | 'info' | 'warning' | 'danger'
+    }
+}
+
+export {}