@e-xi/xion 0.0.6

package/dist/shared/renderer/types/input.d.ts

@@ -0,0 +1,11 @@
+declare global {
+
+    // Renderer
+    namespace XoRenderer {
+
+        // <el-input-number/> 数字输入框组件 值类型
+        type InputNumberValue = number | null | undefined
+    }
+}
+
+export {}

package/dist/shared/renderer/types/options.d.ts

@@ -0,0 +1,22 @@
+declare global {
+
+    // Renderer
+    namespace XoRenderer {
+
+        // <el-radio/> 单选组件 值类型
+        type RadioValue = string | number | boolean
+
+        // 单选组件选项
+        interface RadioOption<T extends RadioValue> {
+            // 选项标签
+            label: string
+            // 选项值
+            value: T
+        }
+
+        // 单选组件选项列表
+        type RadioOptions<T extends RadioValue> = RadioOption<T>[]
+    }
+}
+
+export {}

package/dist/shared/renderer/types/switch.d.ts

@@ -0,0 +1,11 @@
+declare global {
+
+    // Renderer
+    namespace XoRenderer {
+
+        // <el-switch/> 开关组件 值类型
+        type SwitchValue = boolean | string | number
+    }
+}
+
+export {}

package/dist/shared/renderer-protocol/consts/renderer-protocol-keys.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 内置渲染进程协议主机名
+ * @class RendererProtocolKeys
+ */
+export declare class RendererProtocolKeys {
+    /** 应用渲染根目录主机名 */
+    static readonly root = "root";
+    /** 远程服务代理主机名 */
+    static readonly remoteService = "remote-service";
+}

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

@@ -0,0 +1,5 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './consts/renderer-protocol-keys';
+export type * from './types/renderer-protocol';

package/dist/shared/renderer-protocol/index.js

@@ -0,0 +1,6 @@
+import {
+  RendererProtocolKeys
+} from "../../chunk-files/chunk-WOJ2UKI7.js";
+export {
+  RendererProtocolKeys
+};

package/dist/shared/renderer-protocol/types/renderer-protocol.d.ts

@@ -0,0 +1,7 @@
+/** 内置渲染进程协议地址 */
+export interface RendererProtocolUrls {
+    /** 应用渲染根目录地址 */
+    readonly root?: string
+    /** 远程服务代理根地址 */
+    readonly remoteService?: string
+}

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

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

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

@@ -0,0 +1,20 @@
+declare global {
+
+    // Runtime
+    namespace XoRuntime {
+
+        // 运行时配置
+        interface Config {
+            // 运行模式
+            appMode?: XoMode.Mode
+            // 主进程构建发布目录
+            mainOutDir?: string
+            // 渲染进程构建发布目录
+            rendererOutDir?: string
+            // 预加载进程构建发布目录
+            preloadOutDir?: string
+        }
+    }
+}
+
+export {}

package/dist/shared/shortcut/consts/shortcut-handler-ids.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 内置快捷键处理器 ID
+ */
+export declare class ShortcutHandlerIds {
+    /** 切换所有窗口显示状态 */
+    static toggleAllWindow: `ShortcutID_${string}`;
+    /** 显示设置窗口 */
+    static showSettingWindow: `ShortcutID_${string}`;
+}

package/dist/shared/shortcut/consts/shortcut-id.d.ts

@@ -0,0 +1 @@
+export declare const ShortcutIDPrefix: "ShortcutID_";

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

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

package/dist/shared/shortcut/index.js

@@ -0,0 +1,10 @@
+import {
+  ShortcutHandlerIds
+} from "../../chunk-files/chunk-Q7LCZIQP.js";
+import {
+  ShortcutIDPrefix
+} from "../../chunk-files/chunk-6BOPFOZD.js";
+export {
+  ShortcutHandlerIds,
+  ShortcutIDPrefix
+};

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

@@ -0,0 +1,13 @@
+import {ShortcutIDPrefix} from '../consts/shortcut-id'
+
+declare global {
+
+    // Shortcut
+    namespace XoShortcut {
+
+        // 快捷键ID
+        type ID = `${typeof ShortcutIDPrefix}${string}`
+    }
+}
+
+export {}

package/dist/shared/utils/bytes-util.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 字节工具类
+ * @class BytesUtil
+ */
+export declare class BytesUtil {
+    /** 字节单位 */
+    private static readonly units;
+    /**
+     * 格式化字节大小
+     * @param {number}  bytes          字节数
+     * @param {number}  fractionDigits 最大小数位数
+     * @param {boolean} space          数值与单位之间是否添加空格
+     * @returns {string}
+     */
+    static format(bytes: number, fractionDigits?: number, space?: boolean): string;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './bytes-util';
+export * from './ipc-util';
+export * from './log-util';
+export * from './menu-util';
+export * from './number-util';
+export * from './object-util';
+export * from './regexp-util';
+export * from './shortcut-util';
+export * from './string-util';
+export * from './time-util';
+export * from './validator-util';
+export * from './window-shared-util';

package/dist/shared/utils/index.js

@@ -0,0 +1,42 @@
+import {
+  BytesUtil,
+  NumberUtil,
+  StringUtil,
+  ValidatorUtil,
+  WindowSharedUtil
+} from "../../chunk-files/chunk-OUFO3LM4.js";
+import {
+  RegexpUtil
+} from "../../chunk-files/chunk-6FDO72PN.js";
+import {
+  MenuUtil
+} from "../../chunk-files/chunk-U4XEWVBH.js";
+import {
+  LogUtil
+} from "../../chunk-files/chunk-BMOLIJ3W.js";
+import {
+  ShortcutUtil
+} from "../../chunk-files/chunk-6BOPFOZD.js";
+import {
+  IpcUtil
+} from "../../chunk-files/chunk-ID3YDA2K.js";
+import {
+  TimeUtil
+} from "../../chunk-files/chunk-FPN7JYR4.js";
+import {
+  ObjectUtil
+} from "../../chunk-files/chunk-RODB64YF.js";
+export {
+  BytesUtil,
+  IpcUtil,
+  LogUtil,
+  MenuUtil,
+  NumberUtil,
+  ObjectUtil,
+  RegexpUtil,
+  ShortcutUtil,
+  StringUtil,
+  TimeUtil,
+  ValidatorUtil,
+  WindowSharedUtil
+};

package/dist/shared/utils/ipc-util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * IPC 工具
+ * @class IpcUtil
+ */
+export declare class IpcUtil {
+    /**
+     * 创建IPC通道
+     * @param {string} name 通道名
+     * @returns {XoIpc.Channel}
+     */
+    static channel(name: string): XoIpc.Channel;
+}

package/dist/shared/utils/log-util.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 日志数据工具
+ * @class LogUtil
+ */
+export declare class LogUtil {
+    /**
+     * 标准化渲染进程日志请求
+     * @param {unknown} message 日志消息
+     * @param {unknown} data    附加数据
+     * @returns {XoIpcLogger.Request}
+     */
+    static normalizeRequest(message: unknown, data: unknown): XoIpcLogger.Request;
+    /**
+     * 标准化日志值
+     * @param {unknown}         value            原始值
+     * @param {number}          depth            当前深度
+     * @param {WeakSet<object>} seen             已处理对象
+     * @param {NormalizeBudget} budget           处理预算
+     * @param {boolean}         preserveNewlines 是否保留换行
+     * @returns {XoIpcLogger.Value}
+     * @private
+     */
+    private static normalizeValue;
+    /**
+     * 清理日志文本中的控制字符并限制长度
+     * @param {string}  text             原始文本
+     * @param {number}  maxLength        最大长度
+     * @param {boolean} preserveNewlines 是否保留换行
+     * @returns {string}
+     * @private
+     */
+    private static normalizeText;
+}

package/dist/shared/utils/menu-util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 菜单工具
+ * @class MenuUtil
+ */
+export declare class MenuUtil {
+    /**
+     * 创建菜单命令名
+     * @param {string} name 菜单命令名
+     * @returns {XoMenu.Command}
+     */
+    static command(name: string): XoMenu.Command;
+}

package/dist/shared/utils/number-util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 数字工具类
+ * @class NumberUtil
+ */
+export declare class NumberUtil {
+    /**
+     * 是否为有限数字
+     * @param {unknown} number 数字
+     * @returns {boolean}
+     */
+    static isFinite(number: unknown): boolean;
+}

package/dist/shared/utils/object-util.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 深层可选类型
+ */
+export type DeepPartial<T> = T extends (...args: any[]) => unknown ? T : T extends readonly unknown[] ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * 对象合并选项
+ */
+export interface ObjectMergeOptions {
+    array?: 'append' | 'override';
+    object?: 'recursive' | 'override';
+    undefined?: 'skip' | 'override';
+    null?: 'skip' | 'override';
+    unsafeKeys?: readonly string[];
+}
+/**
+ * 对象工具类
+ * @class ObjectUtil
+ */
+export declare class ObjectUtil {
+    /**
+     * 合并对象
+     * <p>默认数组覆盖、嵌套普通对象递归合并、undefined 跳过、null 覆盖</p>
+     * @template T 对象类型
+     * @param {T}                  base     基础对象
+     * @param {DeepPartial<T>}     override 覆盖对象
+     * @param {ObjectMergeOptions} options  合并选项
+     * @returns {T}
+     */
+    static merge<T extends object>(base: T, override: NoInfer<DeepPartial<T>>, options?: ObjectMergeOptions): T;
+    /**
+     * 按选项合并值
+     * @param {unknown}                    base       基础值
+     * @param {unknown}                    override   覆盖值
+     * @param {NormalizedObjectMergeOptions} options 合并选项
+     * @returns {unknown}
+     * @private
+     */
+    private static mergeObjectValue;
+    /**
+     * 合并普通对象属性
+     * @param {Record<PropertyKey, unknown>} base     基础对象
+     * @param {object}                       override 覆盖对象
+     * @param {NormalizedObjectMergeOptions} options 合并选项
+     * @returns {Record<PropertyKey, unknown>}
+     * @private
+     */
+    private static mergeObjectProperties;
+    /**
+     * 安全复制值
+     * @param {unknown}                      value   值
+     * @param {NormalizedObjectMergeOptions} options 合并选项
+     * @returns {unknown}
+     * @private
+     */
+    private static copySafeValue;
+    /**
+     * 获取可枚举自有属性
+     * @param {object} value 对象
+     * @returns {Array<[PropertyKey, unknown]>}
+     * @private
+     */
+    private static enumerableEntries;
+    /**
+     * 是否是不安全键
+     * @param {PropertyKey}                  key     键
+     * @param {NormalizedObjectMergeOptions} options 合并选项
+     * @returns {boolean}
+     * @private
+     */
+    private static isUnsafeKey;
+    /**
+     * 是否跳过值
+     * @param {unknown}                      value   值
+     * @param {NormalizedObjectMergeOptions} options 合并选项
+     * @returns {boolean}
+     * @private
+     */
+    private static shouldSkipValue;
+    /**
+     * 是否是普通对象
+     * @param {unknown} value 值
+     * @returns {value is Record<PropertyKey, unknown>}
+     * @private
+     */
+    private static isPlainObject;
+}

package/dist/shared/utils/regexp-util.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 正则表达式工具类
+ * @class RegexpUtil
+ */
+export declare class RegexpUtil {
+    /**
+     * js 文件正则表达式 RegExp
+     * @type {RegExp}
+     */
+    static readonly jsFile: RegExp;
+    /**
+     * js 系列文件正则表达式 RegExp，匹配 .cjs .mjs .js
+     * @type {RegExp}
+     */
+    static readonly likeJsFile: RegExp;
+    /**
+     * 是否为图片
+     * @param {string | null} str 字符串
+     * @returns {boolean}
+     */
+    static isImage(str?: string | null): boolean;
+}

package/dist/shared/utils/shortcut-util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 快捷键 工具
+ * @class ShortcutUtil
+ */
+export declare class ShortcutUtil {
+    /**
+     * 创建快捷键ID
+     * @param {string} id 快捷键ID
+     * @returns {XoIpc.Channel}
+     */
+    static id(id: string): XoShortcut.ID;
+}

package/dist/shared/utils/string-util.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 字符串工具类
+ * @class StringUtil
+ */
+export declare class StringUtil {
+    /**
+     * 左侧补齐
+     * @param {any}    value 需要补齐的值
+     * @param {number} len   补齐长度
+     * @param {string} fill  占位字符
+     * @returns {string}
+     */
+    static padLeft(value: any, len?: number, fill?: string): string;
+}

package/dist/shared/utils/time-util.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 时间日期工具类
+ * @class TimeUtil
+ */
+export declare class TimeUtil {
+    /** 时长单位 */
+    private static readonly durationUnits;
+    /**
+     * 将秒数格式化为完整时长
+     * @param {number} seconds 秒数
+     * @returns {string}
+     */
+    static formatSeconds(seconds: number): string;
+    /**
+     * 格式化日期
+     * @param {Date} date 日期对象
+     * @returns {string}
+     */
+    static formatDate(date?: Date): string;
+    /**
+     * 格式化时间
+     * @param {Date} date 日期对象
+     * @returns {string}
+     */
+    static formatTime(date?: Date): string;
+    /**
+     * 获取过期时间
+     * @param {number} days 天数
+     * @returns {Date}
+     */
+    static expireBefore(days: number): Date;
+}

package/dist/shared/utils/validator-util.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 验证器工具
+ * @class ValidatorUtil
+ */
+export declare class ValidatorUtil {
+    /**
+     * 验证 HTTPS 更新订阅地址
+     * @param {string} value 订阅地址
+     * @returns {boolean | string}
+     */
+    static httpsFeedUrl(value: string): boolean | string;
+}

package/dist/shared/utils/window-shared-util.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 窗口共享工具类
+ * @class WindowSharedUtil
+ */
+export declare class WindowSharedUtil {
+    /**
+     * 创建窗口记录 ID
+     * @param {string} id  窗口记录 ID
+     * @returns {XoWindow.RecordID}
+     */
+    static recordId(id: string): XoWindow.RecordID;
+    /**
+     * 创建窗口类型名称
+     * @param {string} name 窗口类型名称
+     * @returns {XoWindow.TypeName}
+     */
+    static typeName(name: string): XoWindow.TypeName;
+    /**
+     * 创建窗口标识
+     * @param {string} recordId 窗口记录ID
+     * @param {string} typeName 窗口类型名称
+     * @param {string} url      窗口加载路径
+     * @returns {XoWindow.Identity}
+     */
+    static identity(recordId: string, typeName: string, url: string): XoWindow.Identity;
+}

package/dist/shared/window/consts/window-record-id.d.ts

@@ -0,0 +1,2 @@
+/** 窗口记录 ID 前缀 */
+export declare const WindowRecordIDPrefix: "WindowRecord_";

package/dist/shared/window/consts/window-type-name.d.ts

@@ -0,0 +1 @@
+export declare const WindowTypeNamePrefix: "WindowType_";

package/dist/shared/window/identity/main-window-identity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 主窗口标识
+ * @type {XoWindow.Identity}
+ */
+export declare const MainWindowIdentity: XoWindow.Identity;

package/dist/shared/window/identity/setting-window-identity.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 主窗口标识
+ * @type {XoWindow.Identity}
+ */
+export declare const SettingWindowIdentity: XoWindow.Identity;

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

@@ -0,0 +1,8 @@
+/**
+ * @file Automatically generated by scripts/gen-exports.ts
+ */
+export * from './consts/window-record-id';
+export * from './consts/window-type-name';
+export * from './identity/main-window-identity';
+export * from './identity/setting-window-identity';
+export type * from './types/window';

package/dist/shared/window/index.js

@@ -0,0 +1,23 @@
+import {
+  MainWindowIdentity
+} from "../../chunk-files/chunk-KFV4GXVE.js";
+import {
+  SettingWindowIdentity
+} from "../../chunk-files/chunk-PVWRRUOK.js";
+import {
+  WindowRecordIDPrefix,
+  WindowTypeNamePrefix
+} from "../../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-ID3YDA2K.js";
+import "../../chunk-files/chunk-FPN7JYR4.js";
+import "../../chunk-files/chunk-RODB64YF.js";
+export {
+  MainWindowIdentity,
+  SettingWindowIdentity,
+  WindowRecordIDPrefix,
+  WindowTypeNamePrefix
+};

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

@@ -0,0 +1,84 @@
+declare global {
+
+    // 窗口
+    namespace XoWindow {
+
+        // 窗口状态
+        interface State {
+            // 生效的窗口快捷材质
+            windowMaterial?: XoApp.WindowMaterial
+            // 是否折叠侧边栏
+            isSidebarFolded: boolean
+            // 是否最大化
+            isMaximized: boolean
+            // 是否全屏
+            isFullScreen: boolean
+            // 是否最小化
+            isMinimized: boolean
+            // 是否置顶
+            isAlwaysOnTop: boolean
+            // 是否可全屏
+            isFullScreenable: boolean
+            // 是否可最小化
+            isMinimizable: boolean
+            // 是否可最大化
+            isMaximizable: boolean
+            // 是否可关闭
+            isClosable: boolean
+        }
+
+        // 窗口状态监听器
+        type StateListener = (state: State) => void
+
+        // 路由查询参数值
+        type RouteQueryValue = string | number | boolean | null | undefined
+
+        // 路由查询参数
+        type RouteQuery = Record<string, RouteQueryValue | RouteQueryValue[]>
+
+        // 路由参数
+        type RouteParams = Record<string, string | number | (string | number)[]>
+
+        // 路由位置
+        interface RouteLocation {
+            // 路由名称
+            name?: string
+            // 路由路径
+            path?: string
+            // 查询参数
+            query?: RouteQuery
+            // 路由参数
+            params?: RouteParams
+            // hash
+            hash?: string
+        }
+
+        // 路由目标
+        type RouteTarget = string | RouteLocation
+
+        // 路由重定向模式
+        type RouteRedirectMode = 'push' | 'replace'
+
+        // 路由重定向请求
+        interface RouteRedirectRequest {
+            // 目标窗口标识
+            windowIdentity: XoWindow.Identity
+            // 路由目标，与 routeName 至少配置一项
+            route?: RouteTarget
+            // 路由名称，配置后覆盖 route.name
+            routeName?: string
+            // 路由重定向模式
+            mode?: RouteRedirectMode
+            // 跳转后是否聚焦目标窗口
+            focus?: boolean
+        }
+
+        // 路由重定向请求，不包含目标窗口
+        type RouteRedirectRequestWithoutWindow = Omit<RouteRedirectRequest, 'windowIdentity'>
+
+        // 路由重定向监听器
+        type RouteRedirectListener = (request: RouteRedirectRequest) => void
+    }
+}
+
+export {}