@e-xi/xion 0.0.6

package/dist/renderer/app/index.js

@@ -0,0 +1,164 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+
+// src/renderer/app/styles-element-plus.internal.ts
+var styles_element_plus_internal_exports = {};
+import "element-plus/dist/index.css";
+import "element-plus/theme-chalk/dark/css-vars.css";
+var init_styles_element_plus_internal = __esm({
+  "src/renderer/app/styles-element-plus.internal.ts"() {
+    "use strict";
+  }
+});
+
+// src/renderer/app/styles-xion.internal.ts
+var styles_xion_internal_exports = {};
+import "../styles/index.less";
+import "../icons/iconfont.css";
+var init_styles_xion_internal = __esm({
+  "src/renderer/app/styles-xion.internal.ts"() {
+    "use strict";
+  }
+});
+
+// src/renderer/app/bootstrap-renderer.ts
+import { XoContextMenuPlugin } from "../components/index";
+import { useXoAppStore, useXoAuthStore, useXoRemoteServiceStore, useXoThemeStore, useXoUpdaterStore, useXoWindowStore } from "../store/index";
+import { MessageUtil, RouterUtil } from "../utils/index";
+
+// src/shared/errors/ipc-invoke-error.ts
+var IpcInvokeErrorName = "IpcInvokeError";
+function isIpcInvokeError(error) {
+  if (typeof error !== "object" || error === null) {
+    return false;
+  }
+  const value = error;
+  return typeof value.message === "string" && (value.kind === IpcInvokeErrorName || value.name === IpcInvokeErrorName);
+}
+
+// src/renderer/app/bootstrap-renderer.ts
+import dayjs from "dayjs";
+import timezone from "dayjs/plugin/timezone";
+import utc from "dayjs/plugin/utc";
+import { provideGlobalConfig } from "element-plus";
+import zhCn from "element-plus/es/locale/lang/zh-cn";
+import { createPinia } from "pinia";
+import { createApp, nextTick } from "vue";
+var defaultOptions = {
+  mount: "#app",
+  uses: [],
+  initializeAppStore: true,
+  initializeAuthStore: true,
+  initializeThemeStore: true,
+  initializeUpdaterStore: true,
+  initializeRemoteServiceStore: true,
+  initializeWindowStore: true,
+  autoImportElementPlusStyle: true,
+  styleImporter: [],
+  timezone: "Asia/Shanghai",
+  contextMenuOptions: {}
+};
+var installedPlugins = /* @__PURE__ */ new WeakMap();
+var unhandledRejectionInstalled = false;
+function installIpcErrorHandler(app) {
+  const originalErrorHandler = app.config.errorHandler;
+  app.config.errorHandler = (error, instance, info) => {
+    if (isIpcInvokeError(error)) {
+      MessageUtil.error(error);
+      return;
+    }
+    if (originalErrorHandler) {
+      originalErrorHandler(error, instance, info);
+      return;
+    }
+    console.error(`[Vue] ${info}`, error);
+  };
+  if (!unhandledRejectionInstalled) {
+    window.addEventListener("unhandledrejection", (event) => {
+      if (!isIpcInvokeError(event.reason)) {
+        return;
+      }
+      event.preventDefault();
+      MessageUtil.error(event.reason);
+    });
+    unhandledRejectionInstalled = true;
+  }
+}
+function usePluginOnce(app, plugin) {
+  let plugins = installedPlugins.get(app);
+  if (!plugins) {
+    plugins = /* @__PURE__ */ new WeakSet();
+    installedPlugins.set(app, plugins);
+  }
+  if (plugins.has(plugin)) {
+    return;
+  }
+  app.use(plugin);
+  plugins.add(plugin);
+}
+async function BootstrapRenderer(options) {
+  const mergedOptions = {
+    ...defaultOptions,
+    ...options
+  };
+  dayjs.extend(utc);
+  dayjs.extend(timezone);
+  dayjs.tz.setDefault(mergedOptions.timezone);
+  if (mergedOptions.autoImportElementPlusStyle) {
+    await Promise.resolve().then(() => (init_styles_element_plus_internal(), styles_element_plus_internal_exports));
+  }
+  await Promise.resolve().then(() => (init_styles_xion_internal(), styles_xion_internal_exports));
+  for (const importer of mergedOptions.styleImporter ?? []) {
+    await importer();
+  }
+  const app = createApp(mergedOptions.rootComponent);
+  for (const use of mergedOptions.uses ?? []) {
+    usePluginOnce(app, use);
+  }
+  if (mergedOptions.router) {
+    usePluginOnce(app, mergedOptions.router);
+    RouterUtil.install(mergedOptions.router);
+  }
+  await mergedOptions.setup?.(app);
+  installIpcErrorHandler(app);
+  const pinia = createPinia();
+  app.use(pinia);
+  provideGlobalConfig({ locale: zhCn }, app, true);
+  if (mergedOptions.contextMenuOptions !== false) {
+    app.use(XoContextMenuPlugin, mergedOptions.contextMenuOptions);
+  }
+  await Promise.all([
+    // 自动初始化应用信息存储
+    mergedOptions.initializeAppStore ? useXoAppStore(pinia).initialize() : Promise.resolve(),
+    // 自动初始化/监听 JWT 认证状态
+    mergedOptions.initializeAuthStore ? useXoAuthStore(pinia).initialize() : Promise.resolve(),
+    // 自动初始化/监听主题存储
+    mergedOptions.initializeThemeStore ? useXoThemeStore(pinia).initialize() : Promise.resolve(),
+    // 自动初始化/监听窗口存储
+    mergedOptions.initializeWindowStore ? useXoWindowStore(pinia).initialize() : Promise.resolve()
+  ]);
+  await mergedOptions.router?.isReady();
+  app.mount(mergedOptions.mount || defaultOptions.mount);
+  if (mergedOptions.initializeUpdaterStore) {
+    void useXoUpdaterStore(pinia).initialize();
+  }
+  if (mergedOptions.initializeRemoteServiceStore) {
+    void useXoRemoteServiceStore(pinia).initialize();
+  }
+  if (await window.xion.window.shouldShowAfterRendererReady()) {
+    await nextTick();
+    await new Promise((resolve) => {
+      requestAnimationFrame(() => {
+        requestAnimationFrame(() => {
+          window.setTimeout(resolve, 50);
+        });
+      });
+    });
+  }
+  await window.xion.window.ready();
+}
+export {
+  BootstrapRenderer
+};

package/dist/renderer/app/styles-element-plus.internal.d.ts

@@ -0,0 +1,2 @@
+import 'element-plus/dist/index.css';
+import 'element-plus/theme-chalk/dark/css-vars.css';

package/dist/renderer/app/styles-xion.internal.d.ts

@@ -0,0 +1,2 @@
+import '../styles/index.less';
+import '../icons/iconfont.css';

package/dist/renderer/app/types/app.d.ts

@@ -0,0 +1,51 @@
+import type {App, Component, Plugin} from 'vue'
+import type {Router}                 from 'vue-router'
+
+declare global {
+
+    // Renderer App
+    namespace XoRendererApp {
+
+        // 业务侧启动回调
+        type Setup = (app: App) => void | Promise<void>
+
+        // 启动配置
+        interface BootstrapOptions {
+            // 根组件
+            rootComponent: Component
+            // 挂载目标
+            mount?: string | Element
+            // 需要安装的无参数 Vue 插件
+            uses?: Plugin[]
+            // 路由实例，传入后会自动 app.use(router) 并安装 RouterUtil
+            router?: Router
+            // 自动初始化应用信息存储
+            initializeAppStore?: boolean
+            // 自动初始化/监听 JWT 认证存储
+            initializeAuthStore?: boolean
+            // 自动初始化/监听主题存储
+            initializeThemeStore?: boolean
+            // 自动初始化/监听更新器存储
+            initializeUpdaterStore?: boolean
+            // 自动初始化/监听远程服务存储
+            initializeRemoteServiceStore?: boolean
+            // 自动初始化/监听窗口存储
+            initializeWindowStore?: boolean
+            // 是否加载 Element Plus 全局样式
+            autoImportElementPlusStyle?: boolean
+            // 项目样式导入器（在 Element Plus 之后加载）
+            // 如： styleLoaders: [
+            //     () => import('./styles/index.less'),
+            // ]
+            styleImporter?: Array<() => void | Promise<unknown>>
+            // dayjs 默认时区
+            timezone?: string
+            // 上下文菜单配置，false 表示禁用
+            contextMenuOptions?: XoRendererContextMenu.Options | false
+            // 业务侧自定义配置
+            setup?: Setup
+        }
+    }
+}
+
+export {}

package/dist/renderer/components/captcha/internal/captcha-controller.d.ts

@@ -0,0 +1,280 @@
+import type { XoComponentCaptchaEmits, XoPropsCaptcha } from '../types/captcha';
+import type { ComputedRef, Ref } from 'vue';
+import type { CaptchaDomRefs } from './captcha-runtime-types';
+import type { CaptchaSlideConfig, CaptchaSlideData, CaptchaSlideEvent } from './captcha-slide-types';
+/**
+ * 验证码组件控制器
+ *
+ * 负责组件显示状态、验证码请求、WASM 注册、键盘事件和定时器生命周期
+ * @class XoCaptchaController
+ */
+export declare class XoCaptchaController {
+    /**
+     * 组件全局请求配置
+     * @type {XoComponentCaptchaGlobalOptions}
+     * @private
+     */
+    private readonly globalProps;
+    /** 当前滑块验证码配置 */
+    readonly slideConfig: Ref<CaptchaSlideConfig>;
+    /** 当前滑块验证码数据 */
+    readonly slideData: Ref<CaptchaSlideData>;
+    /**
+     * 组件引用
+     * @type {CaptchaDomRefs}
+     * @private
+     */
+    private readonly domRefs;
+    /**
+     * 组件属性
+     * @type {XoPropsCaptcha}
+     * @private
+     */
+    private readonly props;
+    /**
+     * 组件事件
+     * @type {XoComponentCaptchaEmits}
+     * @private
+     */
+    private readonly emits;
+    /** 传递给 go-captcha-vue 的滑块事件 */
+    readonly slideEvents: Ref<CaptchaSlideEvent>;
+    /**
+     * 验证码 WASM 加签请求
+     * @type {CaptchaWasmRequest}
+     * @private
+     */
+    private wasmReq;
+    /** 当前验证码主题 CSS 变量 */
+    readonly cssProperties: ComputedRef<Record<string, string | number | undefined>>;
+    /** 当前验证码错误或过期提示 */
+    readonly errorMessage: Ref<string>;
+    /**
+     * 错误消息清除定时器
+     * @type {number | null}
+     * @private
+     */
+    private errorClearTimer;
+    /**
+     * 验证码过期预警定时器
+     * @type {number | null}
+     * @private
+     */
+    private expirationWarningTimer;
+    /**
+     * 验证码过期刷新定时器
+     * @type {number | null}
+     * @private
+     */
+    private expirationRefreshTimer;
+    /**
+     * 验证码过期倒计时定时器
+     * @type {number | null}
+     * @private
+     */
+    private expirationCountdownTimer;
+    /**
+     * 验证码内部显示状态
+     * @type {Ref<boolean>}
+     * @private
+     */
+    private readonly innerVisible;
+    /** 当前验证码显示状态，优先使用 v-model */
+    readonly visible: ComputedRef<boolean>;
+    /** 验证码根元素 ID */
+    readonly rootId: Ref<string>;
+    /**
+     * 绑定后的按键监听器
+     * @type {(event: KeyboardEvent) => void}
+     * @private
+     */
+    private readonly boundKeydownHandler;
+    /** 当前仍在执行的 HTTP 请求控制器 */
+    private readonly requestControllers;
+    /** 当前验证码加载序号，用于阻止旧异步任务回写状态 */
+    private loadSequence;
+    /** 组件是否已销毁 */
+    private destroyed;
+    /**
+     * 创建验证码控制器并绑定组件生命周期监听
+     * @param {CaptchaDomRefs}            domRefs 组件引用
+     * @param {XoPropsCaptcha}             props   组件属性
+     * @param {XoComponentCaptchaEmits}   emits   组件事件
+     */
+    constructor(domRefs: CaptchaDomRefs, props: XoPropsCaptcha, emits: XoComponentCaptchaEmits);
+    /**
+     * 移动滑块
+     * @private
+     * @param _x
+     * @param _y
+     */
+    private move;
+    /**
+     * 打开验证码
+     * @private
+     */
+    open(): void;
+    /**
+     * 刷新验证码
+     * @private
+     */
+    refresh(): void;
+    /**
+     * 关闭验证码
+     * @private
+     */
+    close(): void;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+    /**
+     * 确认验证码
+     * @param {CaptchaSlidePoint} point 滑块位置
+     * @param {() => void} resetCaptcha 重置验证码
+     * @private
+     */
+    private confirm;
+    /**
+     * 确认验证码处理器
+     * @param {CaptchaSlidePoint} _ 滑块位置
+     * @returns {Promise<CaptchaVerifyResponse>}
+     * @private
+     */
+    private confirmHandler;
+    /**
+     * 同步加载验证码
+     */
+    getCaptcha(): Promise<void>;
+    /**
+     * 加载验证码配置（全局）
+     * @returns {Promise<void>}
+     */
+    private loadConfig;
+    /**
+     * 加载验证码数据
+     * @returns {Promise<void>}
+     */
+    private loadCaptcha;
+    /**
+     * 应用 UI 补丁
+     * @param {boolean} apply 使用应用
+     * @returns {Promise<void>}
+     * @private
+     */
+    private applyUiPatch;
+    /**
+     * WASM 功能注册
+     * @private
+     */
+    private wasmRegister;
+    /**
+     * WASM 功能注销
+     * @private
+     */
+    private wasmUnregister;
+    /**
+     * 请求验证码 JSON 接口
+     * @template T 响应数据类型
+     * @param {string}       part    验证码接口相对子路径
+     * @param {RequestInit}  options 请求选项
+     * @returns {Promise<XoCaptchaResponse<T>>}
+     * @private
+     */
+    private requestJson;
+    /**
+     * 开始一次新的验证码加载并取消上一轮 HTTP 请求
+     * @returns {number} 本次加载序号
+     * @private
+     */
+    private startLoad;
+    /**
+     * 确认当前异步任务仍属于最新验证码加载
+     * @param {number} sequence 加载序号
+     * @private
+     */
+    private ensureCurrentLoad;
+    /**
+     * 取消当前组件仍在执行的 HTTP 请求
+     * @private
+     */
+    private abortRequests;
+    /**
+     * 取消验证码异步操作并使旧加载序号失效
+     * @private
+     */
+    private cancelPendingOperations;
+    /**
+     * 获取当前基础地址
+     * @returns {string}
+     * @private
+     */
+    private getBaseUrl;
+    /**
+     * 获取当前请求超时
+     * @returns {number}
+     * @private
+     */
+    private getTimeout;
+    /**
+     * 获取当前验证码路径
+     * @returns {string}
+     * @private
+     */
+    private getCaptchaUrl;
+    /**
+     * 构建验证码地址
+     * @param {string} part 子路径
+     * @returns {string}
+     * @private
+     */
+    private buildCaptchaUrl;
+    /**
+     * 启动验证码有效期定时器
+     * @private
+     */
+    private startExpirationTimers;
+    /**
+     * 重置验证码有效期定时器
+     * @private
+     */
+    private resetExpirationTimers;
+    /**
+     * 重置验证码过期倒计时定时器
+     * @private
+     */
+    private resetExpirationCountdownTimer;
+    /**
+     * 重置错误消息清除定时器
+     * @private
+     */
+    private resetErrorClearTimer;
+    /**
+     * 按键监听处理器
+     * @param {KeyboardEvent} event 按键事件
+     * @private
+     */
+    private keydownHandler;
+    /**
+     * 添加按键监听器
+     * @private
+     */
+    private addKeydownListener;
+    /**
+     * 移除按键监听器
+     * @private
+     */
+    private removeKeydownListener;
+    /**
+     * 设置错误消息
+     * @param {string}     msg      错误消息
+     * @param {() => void} callback 回调函数
+     * @private
+     */
+    private setErrMsg;
+    /**
+     * 清空错误消息
+     * @private
+     */
+    private clearErrMsg;
+}

package/dist/renderer/components/captcha/internal/captcha-css-property.d.ts

@@ -0,0 +1,25 @@
+import type { XoPropsCaptcha } from '../types/captcha';
+/**
+ * 验证码 CSS 变量生成器
+ */
+export declare class XoCaptchaCssProperty {
+    private readonly props;
+    private readonly dark;
+    /**
+     * 构造函数
+     * @param {XoPropsCaptcha} props 组件属性
+     * @param {boolean}        dark  是否使用深色主题
+     */
+    constructor(props: XoPropsCaptcha, dark: boolean);
+    /**
+     * 动态主题 css 变量
+     * @returns {Record<string, string | number | undefined>} CSS 变量
+     */
+    withTheme(): Record<string, string | number | undefined>;
+    /**
+     * 公共主题 css 变量
+     * @returns {Record<string, string>} 公共 CSS 变量
+     * @private
+     */
+    private commonCssProperty;
+}

package/dist/renderer/components/captcha/internal/captcha-defaults.d.ts

@@ -0,0 +1,33 @@
+/** 验证码组件默认值 */
+export declare const CaptchaDefaults: {
+    /** 默认显示状态 */
+    modelValue: false;
+    /** 默认请求基础地址 */
+    baseUrl: string;
+    /** 默认验证码接口路径 */
+    captchaUrl: string;
+    /** 默认请求超时时间，单位为毫秒 */
+    timeout: number;
+    /** 默认验证码标题 */
+    title: string;
+    /** 默认刷新按钮提示 */
+    refreshIconTitle: string;
+    /** 默认关闭按钮提示 */
+    closeIconTitle: string;
+    /** 默认显示主题容器 */
+    showTheme: true;
+    /** 默认横向内边距 */
+    horizontalPadding: number;
+    /** 默认纵向内边距 */
+    verticalPadding: number;
+    /** 默认图标尺寸 */
+    iconSize: number;
+    /** 默认标题字号 */
+    titleFontSize: number;
+    /** 默认圆角尺寸 */
+    radiusSize: number;
+    /** 默认错误消息清除延迟，单位为毫秒 */
+    errorClearDelay: number;
+    /** 默认动作类型 */
+    action: string;
+};

package/dist/renderer/components/captcha/internal/captcha-errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 脚本加载错误
+ */
+export declare class XoCaptchaScriptLoadError extends Error {
+    /**
+     * 脚本路径
+     * @type {string}
+     */
+    readonly src: string;
+    /**
+     * 触发事件
+     * @type {Event | string}
+     */
+    readonly causeEvent?: Event | string;
+    /**
+     * 创建脚本加载错误。
+     * @param {string} src 脚本路径
+     * @param {Event | string} causeEvent 触发错误的事件或错误描述
+     */
+    constructor(src: string, causeEvent?: Event | string);
+}

package/dist/renderer/components/captcha/internal/captcha-helper.d.ts

@@ -0,0 +1,72 @@
+import type { XoPropsCaptcha } from '../types/captcha';
+import type { Ref } from 'vue';
+import type { CaptchaConfigResponse, CaptchaGenerateResponse, CaptchaVerifyRequest, CaptchaWasmRequest } from './captcha-runtime-types';
+import type { CaptchaSlideConfig, CaptchaSlideData } from './captcha-slide-types';
+/**
+ * 验证码数据转换工具。
+ */
+export declare class XoCaptchaHelper {
+    /**
+     * 深拷贝
+     * @template T 数据类型
+     * @param {T} data 数据
+     * @returns {T} 深拷贝数据
+     */
+    static clone<T>(data: T): T;
+    /**
+     * 默认滑块验证码配置（基于组件属性）
+     * @param {XoPropsCaptcha} props 组件属性
+     * @returns {CaptchaSlideConfig} 滑块配置
+     */
+    static buildSlideConfigFromProps(props: XoPropsCaptcha): CaptchaSlideConfig;
+    /**
+     * 默认滑块验证码数据
+     * @returns {CaptchaSlideData} 默认滑块数据
+     */
+    static buildDefaultSlideData(): CaptchaSlideData;
+    /**
+     * 生成响应转换为滑块验证码数据
+     * @param {CaptchaGenerateResponse} generateResp 生成响应
+     * @returns {CaptchaSlideData} 滑块数据
+     */
+    static generateRespToSlideData(generateResp: CaptchaGenerateResponse): CaptchaSlideData;
+    /**
+     * 利用生成响应初始化 wasm 请求
+     * @param {CaptchaGenerateResponse} generateResp 生成响应
+     * @param {string}                  rootId       验证码容器根ID
+     * @returns {CaptchaWasmRequest} WASM 签名请求
+     */
+    static buildWasmReqFromGenerateResp(generateResp: CaptchaGenerateResponse, rootId: string): CaptchaWasmRequest;
+    /**
+     * 利用生成响应更新滑块大小
+     * @param {Ref<CaptchaSlideConfig>} slideConfig  验证码配置
+     * @param {CaptchaGenerateResponse} generateResp 生成响应
+     */
+    static applyThumbSizeFromGenerateResp(slideConfig: Ref<CaptchaSlideConfig>, generateResp: CaptchaGenerateResponse): void;
+    /**
+     * 利用配置响应更新背景大小
+     * @param {Ref<CaptchaSlideConfig>} slideConfig 验证码配置
+     * @param {CaptchaConfigResponse}   configResp 配置响应
+     */
+    static applyBackgroundSizeFromConfigResp(slideConfig: Ref<CaptchaSlideConfig>, configResp: CaptchaConfigResponse): void;
+    /**
+     * 构建验证请求
+     * @param {string}             action  需要验证的动作类型
+     * @param {CaptchaWasmRequest} wasmReq 验证码 WASM 加签请求
+     * @param {string}             sign    签名
+     * @returns {CaptchaVerifyRequest} 验证请求
+     */
+    static buildVerifyReq(action: string, wasmReq: CaptchaWasmRequest, sign?: string): CaptchaVerifyRequest;
+    /**
+     * 生成 UUID
+     * @returns {string}
+     */
+    static genUUID(): string;
+    /**
+     * 去除字符串首尾斜杠
+     * @param {string} str 字符串
+     * @returns {string}
+     * @private
+     */
+    static trimSlash(str: string): string;
+}

package/dist/renderer/components/captcha/internal/captcha-injector.d.ts

@@ -0,0 +1,16 @@
+import type { XoComponentCaptchaGlobalOptions } from '../types/captcha';
+/**
+ * 验证码全局请求配置注入器
+ */
+export declare class XoCaptchaInjector {
+    /**
+     * 提供验证码全局配置
+     * @param {XoComponent.CaptchaProvideOptions} options 配置
+     */
+    static provide(options: XoComponent.CaptchaProvideOptions): void;
+    /**
+     * 获取验证码全局配置
+     * @returns {XoComponent.CaptchaGlobalOptions}
+     */
+    static inject(): XoComponentCaptchaGlobalOptions;
+}