@e-xi/xion 0.0.6

package/dist/renderer/components/index.js

@@ -0,0 +1,1282 @@
+// src/renderer/components/captcha/internal/captcha-controller.ts
+import { useXoAppStore, useXoThemeStore } from "../store/index";
+import { computed, nextTick as nextTick2, ref, watch } from "vue";
+
+// src/renderer/components/captcha/internal/captcha-css-property.ts
+var XoCaptchaCssProperty = class {
+  /**
+   * 构造函数
+   * @param {XoPropsCaptcha} props 组件属性
+   * @param {boolean}        dark  是否使用深色主题
+   */
+  constructor(props, dark) {
+    this.props = props;
+    this.dark = dark;
+  }
+  /**
+   * 动态主题 css 变量
+   * @returns {Record<string, string | number | undefined>} CSS 变量
+   */
+  withTheme() {
+    const dark = {
+      backgroundColor: "#111",
+      dragBarColor: "#666",
+      dragBackgroundColor: "#3E7CFF",
+      maskColor: "#fff",
+      maskOpacity: 0,
+      borderColor: "rgba(255, 255, 255, 0.3)",
+      titleColor: "#fff",
+      iconColor: "#fff",
+      shadow: "0 0 15px rgba(255, 255, 255, 0.2)"
+    };
+    const light = {
+      backgroundColor: "#fff",
+      dragBarColor: "#E0E0E0",
+      dragBackgroundColor: "#3E7CFF",
+      maskColor: "#000",
+      maskOpacity: 0,
+      borderColor: "rgba(0, 0, 0, 0.3)",
+      titleColor: "#000",
+      iconColor: "#333",
+      shadow: "0 0 15px rgba(0, 0, 0, 0.2)"
+    };
+    const defaults = this.dark ? dark : light;
+    return {
+      // 公共主题 css 变量
+      ...this.commonCssProperty(),
+      // 动态主题 css 变量
+      "--gc-background-color": this.props?.backgroundColor ?? defaults.backgroundColor,
+      "--gc-drag-bar-color": this.props?.dragBarColor ?? defaults.dragBarColor,
+      "--gc-drag-background-color": this.props?.dragBackgroundColor ?? defaults.dragBackgroundColor,
+      "--gc-mask-color": this.props?.maskColor ?? defaults.maskColor,
+      "--gc-mask-opacity": this.props?.maskOpacity ?? defaults.maskOpacity,
+      "--gc-border-color": this.props?.borderColor ?? defaults.borderColor,
+      "--gc-title-color": this.props?.titleColor ?? defaults.titleColor,
+      "--gc-icon-color": this.props?.iconColor ?? defaults.iconColor,
+      "--gc-shadow": this.props?.shadow ?? defaults.shadow
+    };
+  }
+  /**
+   * 公共主题 css 变量
+   * @returns {Record<string, string>} 公共 CSS 变量
+   * @private
+   */
+  commonCssProperty() {
+    return {
+      "--gc-title-font-size": `${this.props?.titleFontSize || 16}px`,
+      "--gc-radius": `${this.props?.radiusSize || 10}px`
+    };
+  }
+};
+
+// src/renderer/components/captcha/internal/captcha-defaults.ts
+var CaptchaDefaults = {
+  /** 默认显示状态 */
+  modelValue: false,
+  /** 默认请求基础地址 */
+  baseUrl: "",
+  /** 默认验证码接口路径 */
+  captchaUrl: "/captcha",
+  /** 默认请求超时时间，单位为毫秒 */
+  timeout: 5e3,
+  /** 默认验证码标题 */
+  title: "\u8BF7\u62D6\u52A8\u6ED1\u5757\u5B8C\u6210\u62FC\u56FE",
+  /** 默认刷新按钮提示 */
+  refreshIconTitle: "\u5237\u65B0\u9A8C\u8BC1\u7801",
+  /** 默认关闭按钮提示 */
+  closeIconTitle: "\u5173\u95ED\u9A8C\u8BC1\u7801",
+  /** 默认显示主题容器 */
+  showTheme: true,
+  /** 默认横向内边距 */
+  horizontalPadding: 20,
+  /** 默认纵向内边距 */
+  verticalPadding: 20,
+  /** 默认图标尺寸 */
+  iconSize: 20,
+  /** 默认标题字号 */
+  titleFontSize: 16,
+  /** 默认圆角尺寸 */
+  radiusSize: 10,
+  /** 默认错误消息清除延迟，单位为毫秒 */
+  errorClearDelay: 2e3,
+  /** 默认动作类型 */
+  action: ""
+};
+
+// src/renderer/components/captcha/internal/captcha-errors.ts
+var XoCaptchaScriptLoadError = class extends Error {
+  /**
+   * 脚本路径
+   * @type {string}
+   */
+  src;
+  /**
+   * 触发事件
+   * @type {Event | string}
+   */
+  causeEvent;
+  /**
+   * 创建脚本加载错误。
+   * @param {string} src 脚本路径
+   * @param {Event | string} causeEvent 触发错误的事件或错误描述
+   */
+  constructor(src, causeEvent) {
+    super(`Script load failed: ${src}`);
+    this.name = "XoCaptchaScriptLoadError";
+    this.src = src;
+    this.causeEvent = causeEvent;
+  }
+};
+
+// src/renderer/components/captcha/internal/captcha-helper.ts
+var XoCaptchaHelper = class {
+  /**
+   * 深拷贝
+   * @template T 数据类型
+   * @param {T} data 数据
+   * @returns {T} 深拷贝数据
+   */
+  static clone(data) {
+    return typeof structuredClone === "function" ? structuredClone(data) : JSON.parse(JSON.stringify(data));
+  }
+  /**
+   * 默认滑块验证码配置（基于组件属性）
+   * @param {XoPropsCaptcha} props 组件属性
+   * @returns {CaptchaSlideConfig} 滑块配置
+   */
+  static buildSlideConfigFromProps(props) {
+    return {
+      title: props.title,
+      horizontalPadding: props.horizontalPadding,
+      verticalPadding: props.verticalPadding,
+      iconSize: props.iconSize,
+      showTheme: props.showTheme
+    };
+  }
+  /**
+   * 默认滑块验证码数据
+   * @returns {CaptchaSlideData} 默认滑块数据
+   */
+  static buildDefaultSlideData() {
+    return {
+      thumbX: 0,
+      thumbY: 0,
+      thumbWidth: 0,
+      thumbHeight: 0,
+      image: "",
+      thumb: ""
+    };
+  }
+  /**
+   * 生成响应转换为滑块验证码数据
+   * @param {CaptchaGenerateResponse} generateResp 生成响应
+   * @returns {CaptchaSlideData} 滑块数据
+   */
+  static generateRespToSlideData(generateResp) {
+    return {
+      thumbX: generateResp.thumbX,
+      thumbY: generateResp.thumbY,
+      thumbWidth: generateResp.thumbWidth,
+      thumbHeight: generateResp.thumbHeight,
+      image: generateResp.image,
+      thumb: generateResp.thumb
+    };
+  }
+  /**
+   * 利用生成响应初始化 wasm 请求
+   * @param {CaptchaGenerateResponse} generateResp 生成响应
+   * @param {string}                  rootId       验证码容器根ID
+   * @returns {CaptchaWasmRequest} WASM 签名请求
+   */
+  static buildWasmReqFromGenerateResp(generateResp, rootId) {
+    return {
+      rootId,
+      captchaId: generateResp.id,
+      seed: generateResp.seed,
+      token: generateResp.token,
+      generateTime: Date.now()
+      // 验证码生成时间
+    };
+  }
+  /**
+   * 利用生成响应更新滑块大小
+   * @param {Ref<CaptchaSlideConfig>} slideConfig  验证码配置
+   * @param {CaptchaGenerateResponse} generateResp 生成响应
+   */
+  static applyThumbSizeFromGenerateResp(slideConfig, generateResp) {
+    slideConfig.value.thumbWidth = generateResp.thumbWidth;
+    slideConfig.value.thumbHeight = generateResp.thumbHeight;
+  }
+  /**
+   * 利用配置响应更新背景大小
+   * @param {Ref<CaptchaSlideConfig>} slideConfig 验证码配置
+   * @param {CaptchaConfigResponse}   configResp 配置响应
+   */
+  static applyBackgroundSizeFromConfigResp(slideConfig, configResp) {
+    slideConfig.value.width = configResp?.width ?? 0;
+    slideConfig.value.height = configResp?.height ?? 0;
+  }
+  /**
+   * 构建验证请求
+   * @param {string}             action  需要验证的动作类型
+   * @param {CaptchaWasmRequest} wasmReq 验证码 WASM 加签请求
+   * @param {string}             sign    签名
+   * @returns {CaptchaVerifyRequest} 验证请求
+   */
+  static buildVerifyReq(action, wasmReq, sign) {
+    return {
+      captchaId: wasmReq.captchaId,
+      action,
+      sign: sign ?? "",
+      userAgent: window.navigator?.userAgent ?? "",
+      language: window.navigator?.language ?? "",
+      screenWidth: window.screen?.width ?? 0,
+      screenHeight: window.screen?.height ?? 0,
+      colorDepth: window.screen?.colorDepth ?? 0
+    };
+  }
+  /**
+   * 生成 UUID
+   * @returns {string}
+   */
+  static genUUID() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.random() * 16 | 0;
+      const v = c === "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
+  }
+  /**
+   * 去除字符串首尾斜杠
+   * @param {string} str 字符串
+   * @returns {string}
+   * @private
+   */
+  static trimSlash(str) {
+    return str.replace(/^\/+|\/+$/g, "");
+  }
+};
+
+// src/renderer/components/captcha/internal/captcha-injector.ts
+import { inject, provide, reactive } from "vue";
+var CaptchaGlobalOptionsKey = Symbol("XoCaptchaGlobalOptions");
+var XoCaptchaInjector = class {
+  /**
+   * 提供验证码全局配置
+   * @param {XoComponent.CaptchaProvideOptions} options 配置
+   */
+  static provide(options) {
+    provide(CaptchaGlobalOptionsKey, reactive({
+      baseUrl: options.baseUrl,
+      timeout: options.timeout,
+      captchaUrl: options.captchaUrl
+    }));
+  }
+  /**
+   * 获取验证码全局配置
+   * @returns {XoComponent.CaptchaGlobalOptions}
+   */
+  static inject() {
+    return inject(CaptchaGlobalOptionsKey, reactive({
+      baseUrl: CaptchaDefaults.baseUrl,
+      timeout: CaptchaDefaults.timeout,
+      captchaUrl: CaptchaDefaults.captchaUrl
+    }));
+  }
+};
+
+// src/renderer/components/captcha/internal/captcha-ui-patch.ts
+import { nextTick } from "vue";
+var XoCaptchaUiPatch = class {
+  /**
+   * 构造函数
+   * @param {CaptchaUiPatchOptions} config 配置
+   */
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * 应用补丁
+   * @returns {Promise<void>}
+   */
+  async apply() {
+    await nextTick();
+    this.replaceCloseIcon();
+    this.setIconTitle();
+    this.setGcBodyRef();
+  }
+  /**
+   * 替换关闭图标
+   * @private
+   */
+  replaceCloseIcon() {
+    const oldSvg = this.config.domRefs.captchaRef.value?.querySelector(
+      ".gc-header .gc-icon-block svg:first-child"
+    );
+    if (!(oldSvg instanceof SVGSVGElement)) return;
+    const doc = new DOMParser().parseFromString(this.closeSVG(), "image/svg+xml");
+    if (doc.documentElement.nodeName.toLowerCase() === "parsererror" || doc.getElementsByTagName("parsererror").length > 0) {
+      return;
+    }
+    const newSvg = doc.documentElement;
+    if (!(newSvg instanceof SVGSVGElement)) return;
+    oldSvg.setAttribute("viewBox", newSvg.getAttribute("viewBox") || "0 0 1024 1024");
+    oldSvg.innerHTML = newSvg.innerHTML;
+  }
+  /**
+   * 为刷新和关闭按钮添加 title 属性
+   */
+  setIconTitle() {
+    const svgs = this.config.domRefs.captchaRef.value?.querySelectorAll(".gc-header .gc-icon-block svg");
+    if (!svgs || svgs.length < 2) return;
+    const closeIconTitle = `${this.config.props?.closeIconTitle ?? CaptchaDefaults.closeIconTitle} (ESC)`;
+    const refreshIconTitle = `${this.config.props?.refreshIconTitle ?? CaptchaDefaults.refreshIconTitle} (F5)`;
+    this.setSvgTooltip(svgs[0], closeIconTitle);
+    this.setSvgTooltip(svgs[1], refreshIconTitle);
+  }
+  /**
+   * 设置 SVG 元素的 title 属性
+   * @param {Element} svg SVG 元素
+   * @param {string} text title 文本
+   * @private
+   */
+  setSvgTooltip(svg, text) {
+    const el = svg;
+    let titleNode = el.querySelector(":scope > title");
+    if (!titleNode) {
+      titleNode = document.createElementNS("http://www.w3.org/2000/svg", "title");
+      el.prepend(titleNode);
+    }
+    titleNode.textContent = text;
+    el.setAttribute("aria-label", text);
+  }
+  /**
+   * 更新 .go-captcha .gc-body 容器
+   * @private
+   */
+  setGcBodyRef() {
+    this.config.domRefs.gcBodyRef.value = this.config.domRefs.captchaRef.value?.querySelector(".go-captcha .gc-body");
+  }
+  /**
+   * 关闭按钮 SVG 图标
+   * @private
+   */
+  closeSVG() {
+    return `<svg class="icon" viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg">
+            <path d="M638.693769 311.555519l-129.957576 129.957576-129.957576-129.957576-71.138251 71.13825 129.957576
+                129.957576-129.957576 129.957577 71.138251 71.13825 129.957576-129.957576 129.957576 129.957576
+                71.138251-71.13825-129.957577-129.957577 129.957577-129.957576-71.138251-71.13825zM508.736193
+                9.911779C230.965679 9.911779 5.996626 234.880832 5.996626 512.651345S230.965679 1015.390912 508.736193
+                1015.390912s502.739567-224.969053 502.739567-502.739567S786.492547 9.911779 508.736193 9.911779z m0
+                904.93122c-221.698166 0-402.191654-180.479327-402.191654-402.191654 0-221.712326 180.479327-402.191654
+                402.191654-402.191653S910.927846 290.939019 910.927846 512.651345c0 221.698166-180.493487
+                402.191654-402.191653 402.191654z m0 0">
+            </path>
+        </svg>`;
+  }
+};
+
+// src/renderer/components/captcha/internal/captcha-wasm-loader.ts
+var loadingPromise;
+var XoCaptchaWasmLoader = class {
+  /**
+   * 创建验证码 WASM 加载器
+   * @param {CaptchaWasmLoaderOptions} options WASM 加载配置
+   */
+  constructor(options) {
+    this.options = options;
+  }
+  /**
+   * 加载 WASM 运行时和验证码模块
+   * @returns {Promise<void>} WASM 服务准备完成的 Promise
+   */
+  async load() {
+    if (window.__GCaptcha?.Loaded) return;
+    if (loadingPromise) {
+      return loadingPromise;
+    }
+    loadingPromise = this.loadResources();
+    try {
+      await loadingPromise;
+    } finally {
+      loadingPromise = void 0;
+    }
+  }
+  /**
+   * 执行一次 WASM 资源加载
+   * @returns {Promise<void>} WASM 服务准备完成的 Promise
+   * @private
+   */
+  async loadResources() {
+    const config = window.__GCaptcha?.Config;
+    if (!config?.wasmExec || !config.wasm) {
+      throw new Error("WASM \u8D44\u6E90\u914D\u7F6E\u4E0D\u5B8C\u6574");
+    }
+    const root = joinUrl(this.options.baseUrl, this.options.captchaUrl);
+    await this.loadWasmExec(joinUrl(root, config.wasmExec));
+    const go = new window.Go();
+    const controller = new AbortController();
+    const timer = window.setTimeout(() => controller.abort(), this.options.timeout);
+    try {
+      const response = await window.fetch(joinUrl(root, config.wasm), { signal: controller.signal });
+      if (!response.ok) {
+        throw new Error(`WASM \u52A0\u8F7D\u5931\u8D25 [${response.status}]`);
+      }
+      const { instance } = await WebAssembly.instantiateStreaming(response, go.importObject);
+      void go.run(instance);
+      await this.waitUntilReady();
+      window.__GCaptcha.Loaded = true;
+    } finally {
+      window.clearTimeout(timer);
+    }
+  }
+  /**
+   * 注入 wasm_exec.js 脚本
+   * @param {string} src 脚本地址
+   * @returns {Promise<void>} 脚本加载完成的 Promise
+   * @private
+   */
+  loadWasmExec(src) {
+    return new Promise((resolve, reject) => {
+      if (window.Go) {
+        resolve();
+        return;
+      }
+      const script = document.createElement("script");
+      const timer = window.setTimeout(() => {
+        script.remove();
+        reject(new Error(`WASM Bridge \u52A0\u8F7D\u8D85\u65F6 [${this.options.timeout}ms]`));
+      }, this.options.timeout);
+      script.src = src;
+      script.onload = () => {
+        window.clearTimeout(timer);
+        resolve();
+      };
+      script.onerror = (event) => {
+        window.clearTimeout(timer);
+        reject(new XoCaptchaScriptLoadError(src, event));
+      };
+      document.head.appendChild(script);
+    });
+  }
+  /**
+   * 等待 Go WASM 暴露验证码服务
+   * @returns {Promise<void>} 服务准备完成的 Promise
+   * @private
+   */
+  async waitUntilReady() {
+    const startTime = Date.now();
+    while (!window.__GCaptcha?.Service) {
+      if (Date.now() - startTime > this.options.timeout) {
+        throw new Error(`WASM \u52A0\u8F7D\u8D85\u65F6 [${this.options.timeout}ms]`);
+      }
+      await new Promise((resolve) => window.setTimeout(resolve, 50));
+    }
+  }
+};
+function joinUrl(...parts) {
+  return parts.filter(Boolean).map((part, index) => index === 0 ? part.replace(/\/$/, "") : part.replace(/^\/+|\/+$/g, "")).join("/");
+}
+
+// src/renderer/components/captcha/internal/captcha-controller.ts
+var XoCaptchaCancelledError = class extends Error {
+  /**
+   * 创建验证码取消错误
+   */
+  constructor() {
+    super("\u9A8C\u8BC1\u7801\u64CD\u4F5C\u5DF2\u53D6\u6D88");
+    this.name = "XoCaptchaCancelledError";
+  }
+};
+var XoCaptchaController = class {
+  /**
+   * 组件全局请求配置
+   * @type {XoComponentCaptchaGlobalOptions}
+   * @private
+   */
+  globalProps;
+  /** 当前滑块验证码配置 */
+  slideConfig;
+  /** 当前滑块验证码数据 */
+  slideData;
+  /**
+   * 组件引用
+   * @type {CaptchaDomRefs}
+   * @private
+   */
+  domRefs;
+  /**
+   * 组件属性
+   * @type {XoPropsCaptcha}
+   * @private
+   */
+  props;
+  /**
+   * 组件事件
+   * @type {XoComponentCaptchaEmits}
+   * @private
+   */
+  emits;
+  /** 传递给 go-captcha-vue 的滑块事件 */
+  slideEvents;
+  /**
+   * 验证码 WASM 加签请求
+   * @type {CaptchaWasmRequest}
+   * @private
+   */
+  wasmReq;
+  /** 当前验证码主题 CSS 变量 */
+  cssProperties;
+  /** 当前验证码错误或过期提示 */
+  errorMessage = ref("");
+  /**
+   * 错误消息清除定时器
+   * @type {number | null}
+   * @private
+   */
+  errorClearTimer = null;
+  /**
+   * 验证码过期预警定时器
+   * @type {number | null}
+   * @private
+   */
+  expirationWarningTimer = null;
+  /**
+   * 验证码过期刷新定时器
+   * @type {number | null}
+   * @private
+   */
+  expirationRefreshTimer = null;
+  /**
+   * 验证码过期倒计时定时器
+   * @type {number | null}
+   * @private
+   */
+  expirationCountdownTimer = null;
+  /**
+   * 验证码内部显示状态
+   * @type {Ref<boolean>}
+   * @private
+   */
+  innerVisible;
+  /** 当前验证码显示状态，优先使用 v-model */
+  visible;
+  /** 验证码根元素 ID */
+  rootId;
+  /**
+   * 绑定后的按键监听器
+   * @type {(event: KeyboardEvent) => void}
+   * @private
+   */
+  boundKeydownHandler;
+  /** 当前仍在执行的 HTTP 请求控制器 */
+  requestControllers = /* @__PURE__ */ new Set();
+  /** 当前验证码加载序号，用于阻止旧异步任务回写状态 */
+  loadSequence = 0;
+  /** 组件是否已销毁 */
+  destroyed = false;
+  /**
+   * 创建验证码控制器并绑定组件生命周期监听
+   * @param {CaptchaDomRefs}            domRefs 组件引用
+   * @param {XoPropsCaptcha}             props   组件属性
+   * @param {XoComponentCaptchaEmits}   emits   组件事件
+   */
+  constructor(domRefs, props, emits) {
+    this.innerVisible = ref(false);
+    this.visible = computed(() => props.modelValue ?? this.innerVisible.value);
+    const globalProps = XoCaptchaInjector.inject();
+    const appRemoteServiceRootUrl = useXoAppStore().remoteServiceRootUrl;
+    this.globalProps = {
+      baseUrl: props.baseUrl ?? (globalProps.baseUrl || appRemoteServiceRootUrl || CaptchaDefaults.baseUrl),
+      timeout: props.timeout ?? globalProps.timeout ?? CaptchaDefaults.timeout,
+      captchaUrl: props.captchaUrl ?? globalProps.captchaUrl ?? CaptchaDefaults.captchaUrl
+    };
+    this.rootId = domRefs.rootId ?? ref(`xo-captcha-${XoCaptchaHelper.genUUID()}`);
+    this.domRefs = { ...domRefs, rootId: this.rootId };
+    this.props = props;
+    this.emits = emits;
+    this.slideConfig = ref(XoCaptchaHelper.buildSlideConfigFromProps(props));
+    this.slideData = ref(XoCaptchaHelper.buildDefaultSlideData());
+    this.slideEvents = ref({
+      move: this.move.bind(this),
+      refresh: this.refresh.bind(this),
+      close: this.close.bind(this),
+      confirm: this.confirm.bind(this)
+    });
+    const themeStore = useXoThemeStore();
+    this.cssProperties = computed(() => new XoCaptchaCssProperty(props, themeStore.shouldUseDarkColors).withTheme());
+    watch(
+      () => [
+        props.title,
+        props.horizontalPadding,
+        props.verticalPadding,
+        props.showTheme,
+        props.iconSize
+      ],
+      () => Object.assign(this.slideConfig.value, XoCaptchaHelper.buildSlideConfigFromProps(props)),
+      { immediate: true }
+    );
+    watch(
+      () => [
+        props.closeIconTitle,
+        props.refreshIconTitle
+      ],
+      // 应用 UI 补丁
+      async () => {
+        await this.applyUiPatch(this.visible.value);
+      }
+    );
+    this.boundKeydownHandler = this.keydownHandler.bind(this);
+    watch(
+      this.visible,
+      (visible) => {
+        if (visible) {
+          void this.getCaptcha();
+          this.addKeydownListener();
+        } else {
+          this.cancelPendingOperations();
+          this.wasmUnregister();
+          this.removeKeydownListener();
+        }
+      },
+      { immediate: true }
+    );
+  }
+  //<editor-fold desc="事件">
+  /**
+   * 移动滑块
+   * @private
+   * @param _x
+   * @param _y
+   */
+  move(_x, _y) {
+  }
+  /**
+   * 打开验证码
+   * @private
+   */
+  open() {
+    if (this.destroyed) return;
+    this.resetErrorClearTimer();
+    this.innerVisible.value = true;
+    this.emits("update:modelValue", true);
+  }
+  /**
+   * 刷新验证码
+   * @private
+   */
+  refresh() {
+    if (this.destroyed) return;
+    this.resetErrorClearTimer();
+    this.resetExpirationTimers();
+    void this.getCaptcha();
+  }
+  /**
+   * 关闭验证码
+   * @private
+   */
+  close() {
+    this.resetErrorClearTimer();
+    this.resetExpirationTimers();
+    this.cancelPendingOperations();
+    this.innerVisible.value = false;
+    this.emits("update:modelValue", false);
+  }
+  /**
+   * 销毁组件
+   */
+  destroy() {
+    this.destroyed = true;
+    this.cancelPendingOperations();
+    this.wasmUnregister();
+    this.removeKeydownListener();
+    this.resetExpirationTimers();
+    this.resetErrorClearTimer();
+  }
+  /**
+   * 确认验证码
+   * @param {CaptchaSlidePoint} point 滑块位置
+   * @param {() => void} resetCaptcha 重置验证码
+   * @private
+   */
+  confirm(point, resetCaptcha) {
+    const handleSuccess = (verifyRes) => {
+      this.emits("verified", {
+        ticket: verifyRes?.ticket ?? "",
+        action: this.props.action
+      });
+      this.close();
+    };
+    const handleError = (error) => {
+      if (error instanceof XoCaptchaCancelledError) return;
+      this.setErrMsg(errorMessage(error, "\u9A8C\u8BC1\u8BF7\u6C42\u5931\u8D25"), () => {
+        resetCaptcha();
+        void this.getCaptcha();
+      });
+    };
+    this.confirmHandler(point).then(handleSuccess).catch(handleError);
+  }
+  /**
+   * 确认验证码处理器
+   * @param {CaptchaSlidePoint} _ 滑块位置
+   * @returns {Promise<CaptchaVerifyResponse>}
+   * @private
+   */
+  async confirmHandler(_) {
+    const wasmResp = window.__GCaptcha?.Service?.Sign(XoCaptchaHelper.clone(this.wasmReq));
+    if (!wasmResp?.success) throw new Error("\u7B7E\u540D\u5931\u8D25");
+    const verifyReq = XoCaptchaHelper.buildVerifyReq(this.props.action, this.wasmReq, wasmResp?.data?.sign);
+    const verifyPart = window.__GCaptcha?.Config?.verify ?? "";
+    const data = await this.requestJson(verifyPart, {
+      method: "POST",
+      body: JSON.stringify(verifyReq)
+    });
+    if (!data?.success) throw new Error(data?.message ?? `\u9A8C\u8BC1\u672A\u901A\u8FC7`);
+    const verifyResponse = data.data;
+    if (!verifyResponse?.ticket) throw new Error("\u9A8C\u8BC1\u7ED3\u679C\u7F3A\u5C11\u7968\u636E");
+    return verifyResponse;
+  }
+  //</editor-fold>
+  //<editor-fold desc="后端加载">
+  /**
+   * 同步加载验证码
+   */
+  async getCaptcha() {
+    if (this.destroyed) return;
+    const sequence = this.startLoad();
+    try {
+      await this.loadCaptcha(sequence);
+    } catch (error) {
+      if (error instanceof XoCaptchaCancelledError) return;
+      const fallback = error instanceof XoCaptchaScriptLoadError ? "WASM Bridge \u52A0\u8F7D\u5931\u8D25" : "\u9A8C\u8BC1\u7801\u52A0\u8F7D\u5931\u8D25";
+      this.setErrMsg(errorMessage(error, fallback));
+    }
+  }
+  /**
+   * 加载验证码配置（全局）
+   * @returns {Promise<void>}
+   */
+  async loadConfig() {
+    if (!window.__GCaptcha) {
+      window.__GCaptcha = {};
+    }
+    if (window.__GCaptcha.Config === void 0) {
+      const captchaUrl = this.getCaptchaUrl();
+      if (!captchaUrl) throw new Error("\u57FA\u7840\u8DEF\u5F84\u672A\u914D\u7F6E");
+      const data = await this.requestJson();
+      if (!data?.success) throw new Error(`\u914D\u7F6E\u52A0\u8F7D\u5931\u8D25`);
+      const configResp = data.data;
+      if (!configResp) throw new Error("\u914D\u7F6E\u54CD\u5E94\u7F3A\u5C11\u6570\u636E");
+      if (!configResp?.generate) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'generate' \u8DEF\u5F84\u53C2\u6570`);
+      if (!configResp?.verify) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'verify' \u8DEF\u5F84\u53C2\u6570`);
+      if (!configResp?.wasmExec) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'wasmExec' \u8DEF\u5F84\u53C2\u6570`);
+      if (!configResp?.wasm) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'wasm' \u8DEF\u5F84\u53C2\u6570`);
+      if (!configResp?.width) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'width' \u53C2\u6570`);
+      if (!configResp?.height) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'height' \u53C2\u6570`);
+      if (!configResp?.validity) throw new Error(`\u914D\u7F6E\u7F3A\u5C11 'validity' \u53C2\u6570`);
+      window.__GCaptcha.Config = {
+        ...configResp,
+        // 格式化路径
+        generate: XoCaptchaHelper.trimSlash(configResp.generate),
+        verify: XoCaptchaHelper.trimSlash(configResp.verify),
+        wasmExec: XoCaptchaHelper.trimSlash(configResp.wasmExec),
+        wasm: XoCaptchaHelper.trimSlash(configResp.wasm)
+      };
+    }
+    XoCaptchaHelper.applyBackgroundSizeFromConfigResp(this.slideConfig, window.__GCaptcha.Config);
+  }
+  /**
+   * 加载验证码数据
+   * @returns {Promise<void>}
+   */
+  async loadCaptcha(sequence) {
+    this.clearErrMsg();
+    this.resetExpirationTimers();
+    await this.applyUiPatch(true);
+    this.ensureCurrentLoad(sequence);
+    await this.loadConfig();
+    this.ensureCurrentLoad(sequence);
+    await new XoCaptchaWasmLoader({
+      baseUrl: this.getBaseUrl(),
+      captchaUrl: this.getCaptchaUrl(),
+      timeout: this.getTimeout()
+    }).load();
+    this.ensureCurrentLoad(sequence);
+    const generatePart = window.__GCaptcha?.Config?.generate ?? "";
+    const data = await this.requestJson(generatePart);
+    this.ensureCurrentLoad(sequence);
+    if (!data?.success) throw new Error(data?.message ?? `\u9A8C\u8BC1\u7801\u751F\u6210\u5931\u8D25`);
+    const generateResp = data.data;
+    if (!generateResp) throw new Error("\u9A8C\u8BC1\u7801\u54CD\u5E94\u7F3A\u5C11\u6570\u636E");
+    if (!generateResp?.thumbWidth) throw new Error(`\u9A8C\u8BC1\u7801\u7F3A\u5C11 'sliderW' \u53C2\u6570`);
+    if (!generateResp?.thumbHeight) throw new Error(`\u9A8C\u8BC1\u7801\u7F3A\u5C11 'sliderH' \u53C2\u6570`);
+    XoCaptchaHelper.applyThumbSizeFromGenerateResp(this.slideConfig, generateResp);
+    this.slideData.value = XoCaptchaHelper.generateRespToSlideData(generateResp);
+    this.wasmReq = XoCaptchaHelper.buildWasmReqFromGenerateResp(generateResp, this.domRefs.rootId.value);
+    await nextTick2();
+    this.ensureCurrentLoad(sequence);
+    this.wasmRegister();
+    this.startExpirationTimers();
+  }
+  //</editor-fold>
+  //<editor-fold desc="UI 补丁及 WASM 功能">
+  /**
+   * 应用 UI 补丁
+   * @param {boolean} apply 使用应用
+   * @returns {Promise<void>}
+   * @private
+   */
+  async applyUiPatch(apply) {
+    if (!apply) return;
+    await new XoCaptchaUiPatch({ domRefs: this.domRefs, props: this.props }).apply();
+  }
+  /**
+   * WASM 功能注册
+   * @private
+   */
+  wasmRegister() {
+    const resp = window.__GCaptcha?.Service?.Register(this.domRefs.rootId.value);
+    if (!resp?.success) throw new Error(resp?.error || "\u9A8C\u8BC1\u7801\u5BB9\u5668\u7ED1\u5B9A\u5931\u8D25");
+  }
+  /**
+   * WASM 功能注销
+   * @private
+   */
+  wasmUnregister() {
+    window.__GCaptcha?.Service?.Unregister(this.domRefs.rootId.value);
+  }
+  //</editor-fold>
+  //<editor-fold desc="动态属性">
+  /**
+   * 请求验证码 JSON 接口
+   * @template T 响应数据类型
+   * @param {string}       part    验证码接口相对子路径
+   * @param {RequestInit}  options 请求选项
+   * @returns {Promise<XoCaptchaResponse<T>>}
+   * @private
+   */
+  async requestJson(part = "", options = {}) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const timer = window.setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, this.getTimeout());
+    this.requestControllers.add(controller);
+    const headers = new Headers(options.headers);
+    if (options.body !== void 0 && !headers.has("Content-Type")) {
+      headers.set("Content-Type", "application/json");
+    }
+    const requestUrl = this.buildCaptchaUrl(part);
+    try {
+      const response = await window.fetch(requestUrl, {
+        ...options,
+        headers,
+        signal: controller.signal
+      });
+      if (!response.ok && response.status !== 400) {
+        throw new Error(`\u9A8C\u8BC1\u7801\u8BF7\u6C42\u5931\u8D25 [${response.status}]`);
+      }
+      return await response.json();
+    } catch (error) {
+      if (isAbortError(error)) {
+        if (!timedOut) throw new XoCaptchaCancelledError();
+        throw new Error(`\u9A8C\u8BC1\u7801\u8BF7\u6C42\u8D85\u65F6 [${this.getTimeout()}ms]`);
+      }
+      throw error;
+    } finally {
+      window.clearTimeout(timer);
+      this.requestControllers.delete(controller);
+    }
+  }
+  /**
+   * 开始一次新的验证码加载并取消上一轮 HTTP 请求
+   * @returns {number} 本次加载序号
+   * @private
+   */
+  startLoad() {
+    this.abortRequests();
+    this.loadSequence += 1;
+    return this.loadSequence;
+  }
+  /**
+   * 确认当前异步任务仍属于最新验证码加载
+   * @param {number} sequence 加载序号
+   * @private
+   */
+  ensureCurrentLoad(sequence) {
+    if (this.destroyed || sequence !== this.loadSequence || !this.visible.value) {
+      throw new XoCaptchaCancelledError();
+    }
+  }
+  /**
+   * 取消当前组件仍在执行的 HTTP 请求
+   * @private
+   */
+  abortRequests() {
+    this.requestControllers.forEach((controller) => controller.abort());
+    this.requestControllers.clear();
+  }
+  /**
+   * 取消验证码异步操作并使旧加载序号失效
+   * @private
+   */
+  cancelPendingOperations() {
+    this.loadSequence += 1;
+    this.abortRequests();
+  }
+  /**
+   * 获取当前基础地址
+   * @returns {string}
+   * @private
+   */
+  getBaseUrl() {
+    return trimTrailingSlash(this.props.baseUrl ?? this.globalProps.baseUrl ?? CaptchaDefaults.baseUrl);
+  }
+  /**
+   * 获取当前请求超时
+   * @returns {number}
+   * @private
+   */
+  getTimeout() {
+    return this.props.timeout ?? this.globalProps.timeout ?? CaptchaDefaults.timeout;
+  }
+  /**
+   * 获取当前验证码路径
+   * @returns {string}
+   * @private
+   */
+  getCaptchaUrl() {
+    return XoCaptchaHelper.trimSlash(this.props.captchaUrl ?? this.globalProps.captchaUrl ?? CaptchaDefaults.captchaUrl);
+  }
+  /**
+   * 构建验证码地址
+   * @param {string} part 子路径
+   * @returns {string}
+   * @private
+   */
+  buildCaptchaUrl(part = "") {
+    return [this.getBaseUrl(), this.getCaptchaUrl(), XoCaptchaHelper.trimSlash(part)].filter(Boolean).join("/");
+  }
+  //</editor-fold>
+  //<editor-fold desc="计时器">
+  /**
+   * 启动验证码有效期定时器
+   * @private
+   */
+  startExpirationTimers() {
+    const warningLeadS = 5;
+    const validityMs = Number(window.__GCaptcha?.Config?.validity ?? 0) * 1e3;
+    if (validityMs <= 0) return;
+    const warningDelay = Math.max(validityMs - warningLeadS * 1e3, 0);
+    const countdownMessage = (second) => `\u9A8C\u8BC1\u7801\u5373\u5C06\u8FC7\u671F\uFF0C${second} \u79D2\u540E\u81EA\u52A8\u5237\u65B0`;
+    this.expirationWarningTimer = window.setTimeout(() => {
+      if (!this.visible.value) return;
+      let remainS = warningLeadS;
+      this.errorMessage.value = countdownMessage(remainS);
+      this.expirationCountdownTimer = window.setInterval(() => {
+        if (!this.visible.value) return;
+        remainS -= 1;
+        if (remainS <= 0) {
+          this.clearErrMsg();
+          this.resetExpirationCountdownTimer();
+          return;
+        }
+        this.errorMessage.value = countdownMessage(remainS);
+      }, 1e3);
+    }, warningDelay);
+    this.expirationRefreshTimer = window.setTimeout(() => {
+      if (!this.visible.value) return;
+      this.clearErrMsg();
+      this.refresh();
+    }, validityMs);
+  }
+  /**
+   * 重置验证码有效期定时器
+   * @private
+   */
+  resetExpirationTimers() {
+    if (this.expirationWarningTimer) {
+      clearTimeout(this.expirationWarningTimer);
+      this.expirationWarningTimer = null;
+    }
+    if (this.expirationRefreshTimer) {
+      clearTimeout(this.expirationRefreshTimer);
+      this.expirationRefreshTimer = null;
+    }
+    this.resetExpirationCountdownTimer();
+  }
+  /**
+   * 重置验证码过期倒计时定时器
+   * @private
+   */
+  resetExpirationCountdownTimer() {
+    if (this.expirationCountdownTimer) {
+      clearInterval(this.expirationCountdownTimer);
+      this.expirationCountdownTimer = null;
+    }
+  }
+  /**
+   * 重置错误消息清除定时器
+   * @private
+   */
+  resetErrorClearTimer() {
+    if (this.errorClearTimer) {
+      clearTimeout(this.errorClearTimer);
+      this.errorClearTimer = null;
+    }
+  }
+  //</editor-fold>
+  //<editor-fold desc="按键监听">
+  /**
+   * 按键监听处理器
+   * @param {KeyboardEvent} event 按键事件
+   * @private
+   */
+  keydownHandler(event) {
+    if (!this.visible.value) return;
+    if (event.key === "Escape" || event.key === "Esc") {
+      event.preventDefault();
+      event.stopPropagation();
+      event.stopImmediatePropagation();
+      this.close();
+      return;
+    }
+    if (event.key === "F5") {
+      event.preventDefault();
+      event.stopPropagation();
+      event.stopImmediatePropagation();
+      this.refresh();
+    }
+  }
+  /**
+   * 添加按键监听器
+   * @private
+   */
+  addKeydownListener() {
+    document.addEventListener("keydown", this.boundKeydownHandler, true);
+  }
+  /**
+   * 移除按键监听器
+   * @private
+   */
+  removeKeydownListener() {
+    document.removeEventListener("keydown", this.boundKeydownHandler, true);
+  }
+  //</editor-fold>
+  //<editor-fold desc="错误消息">
+  /**
+   * 设置错误消息
+   * @param {string}     msg      错误消息
+   * @param {() => void} callback 回调函数
+   * @private
+   */
+  setErrMsg(msg, callback) {
+    this.errorMessage.value = msg;
+    this.resetErrorClearTimer();
+    const errorClearDelay = this.props?.errorClearDelay ?? 0;
+    if (errorClearDelay > 0) {
+      this.errorClearTimer = window.setTimeout(() => {
+        this.clearErrMsg();
+        typeof callback === "function" && callback();
+      }, errorClearDelay);
+    }
+  }
+  /**
+   * 清空错误消息
+   * @private
+   */
+  clearErrMsg() {
+    this.errorMessage.value = "";
+  }
+  //</editor-fold>
+};
+function errorMessage(error, fallback) {
+  return error instanceof Error ? error.message : fallback;
+}
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError";
+}
+function trimTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+
+// src/renderer/components/captcha/internal/captcha-service.ts
+var host = null;
+function registerCaptchaHost(instance) {
+  host = instance;
+}
+function unregisterCaptchaHost(instance) {
+  if (host === instance) {
+    host = null;
+  }
+}
+function openCaptcha(options) {
+  const normalizedOptions = typeof options === "string" ? { action: options } : options;
+  const action = normalizedOptions.action.trim();
+  if (!action) {
+    return Promise.reject(new Error("\u9A8C\u8BC1\u7801\u52A8\u4F5C\u7C7B\u578B\u4E0D\u80FD\u4E3A\u7A7A"));
+  }
+  if (!host) {
+    return Promise.reject(new Error("\u9A8C\u8BC1\u7801\u7EC4\u4EF6\u672A\u521D\u59CB\u5316"));
+  }
+  return host.open({ ...normalizedOptions, action });
+}
+function closeCaptcha() {
+  host?.close();
+}
+
+// src/renderer/components/captcha.ts
+var XoCaptchaApi = class {
+  /**
+   * 在当前 Vue 应用上下文中提供验证码全局请求配置
+   * @param {XoComponent.CaptchaProvideOptions} options 配置
+   */
+  static provide(options) {
+    XoCaptchaInjector.provide(options);
+  }
+  /**
+   * 获取当前 Vue 应用上下文中的验证码全局请求配置
+   * @returns {XoComponent.CaptchaGlobalOptions}
+   */
+  static inject() {
+    return XoCaptchaInjector.inject();
+  }
+  /**
+   * 通过已挂载的 XoCaptchaHost 打开验证码
+   * @param {string | XoComponent.CaptchaServiceOptions} options 服务选项
+   * @returns {Promise<XoComponent.CaptchaTicket>}
+   */
+  static open(options) {
+    return openCaptcha(options);
+  }
+  /**
+   * 关闭已挂载的全局验证码
+   */
+  static close() {
+    closeCaptcha();
+  }
+};
+var XoCaptchaRuntime = {
+  /** 验证码组件状态和生命周期控制器 */
+  Controller: XoCaptchaController,
+  /** 注册全局验证码主机 */
+  registerHost: registerCaptchaHost,
+  /** 注销全局验证码主机 */
+  unregisterHost: unregisterCaptchaHost
+};
+
+// src/renderer/components/index.ts
+import { default as default2 } from "./captcha/xo-captcha-host.vue";
+import { default as default3 } from "./captcha/xo-captcha.vue";
+
+// src/renderer/components/context-menu.ts
+import XoContextMenu from "./context-menu/xo-context-menu.vue";
+import { createApp } from "vue";
+var XoContextMenuPlugin = {
+  /**
+   * 安装插件
+   * @param {App}                           app     Vue 应用
+   * @param {XoRendererContextMenu.Options} options 配置
+   */
+  install(app, options = {}) {
+    const unmount = XoMountContextMenu(options);
+    app.onUnmount(() => {
+      unmount();
+    });
+  }
+};
+function XoMountContextMenu(options = {}) {
+  const container = createContainer(options.rootId);
+  const app = createApp(XoContextMenu, {
+    maxWidth: options.maxWidth,
+    viewportPadding: options.viewportPadding
+  });
+  app.mount(container);
+  return () => {
+    app.unmount();
+    container.remove();
+  };
+}
+function createContainer(rootId = "xo-context-menu-root") {
+  const exists = document.getElementById(rootId);
+  if (exists) {
+    return exists;
+  }
+  const container = document.createElement("div");
+  container.id = rootId;
+  document.body.appendChild(container);
+  return container;
+}
+
+// src/renderer/components/index.ts
+import { default as default4 } from "./context-menu/xo-context-menu-items.vue";
+import { default as default5 } from "./context-menu/xo-context-menu.vue";
+import { default as default6 } from "./divider/xo-divider.vue";
+import { default as default7 } from "./form/xo-form-flex-row.vue";
+import { default as default8 } from "./form/xo-form-flex.vue";
+import { default as default9 } from "./layouts/xo-app-layout.vue";
+import { default as default10 } from "./layouts/xo-mini-layout.vue";
+import { default as default11 } from "./layouts/xo-simple-layout.vue";
+import { default as default12 } from "./pages/xo-app-page.vue";
+import { default as default13 } from "./pages/xo-bootstrap-page.vue";
+import { default as default14 } from "./pages/xo-dynamic-page.vue";
+import { default as default15 } from "./pages/xo-settings-page.vue";
+import { default as default16 } from "./radio-group/xo-radio-group.vue";
+import { default as default17 } from "./service-status-bar/xo-service-status-bar.vue";
+import { default as default18 } from "./settings-components/xo-setting-app-opacity.vue";
+import { default as default19 } from "./settings-components/xo-setting-log-level.vue";
+import { default as default20 } from "./settings-components/xo-setting-shortcut-keys-record-for-form-flex-rows.vue";
+import { default as default21 } from "./settings-components/xo-setting-shortcut-keys-record.vue";
+import { default as default22 } from "./settings-components/xo-setting-window-material.vue";
+import { default as default23 } from "./settings-pages/xo-setting-page-folder.vue";
+import { default as default24 } from "./settings-pages/xo-setting-page-general.vue";
+import { default as default25 } from "./settings-pages/xo-setting-page-remote-service.vue";
+import { default as default26 } from "./settings-pages/xo-setting-page-updater.vue";
+import { default as default27 } from "./shortcut-keys-record/xo-shortcut-keys-record.vue";
+import { default as default28 } from "./side-bar/xo-sidebar-logo.vue";
+import { default as default29 } from "./spacing-line/xo-spacing-line.vue";
+import { default as default30 } from "./theme-switch/xo-theme-switch-mini.vue";
+import { default as default31 } from "./theme-switch/xo-theme-switch.vue";
+import { default as default32 } from "./title-bar/xo-title-bar.vue";
+import { default as default33 } from "./updater/xo-updater.vue";
+import { default as default34 } from "./window-control/xo-window-control.vue";
+export {
+  default9 as XoAppLayout,
+  default12 as XoAppPage,
+  default13 as XoBootstrapPage,
+  default3 as XoCaptcha,
+  XoCaptchaApi,
+  default2 as XoCaptchaHost,
+  XoCaptchaRuntime,
+  default5 as XoContextMenu,
+  default4 as XoContextMenuItems,
+  XoContextMenuPlugin,
+  default6 as XoDivider,
+  default14 as XoDynamicPage,
+  default8 as XoFormFlex,
+  default7 as XoFormFlexRow,
+  default10 as XoMiniLayout,
+  XoMountContextMenu,
+  default16 as XoRadioGroup,
+  default17 as XoServiceStatusBar,
+  default18 as XoSettingAppOpacity,
+  default19 as XoSettingLogLevel,
+  default23 as XoSettingPageFolder,
+  default24 as XoSettingPageGeneral,
+  default25 as XoSettingPageRemoteService,
+  default26 as XoSettingPageUpdater,
+  default21 as XoSettingShortcutKeysRecord,
+  default20 as XoSettingShortcutKeysRecordForFormFlexRows,
+  default22 as XoSettingWindowMaterial,
+  default15 as XoSettingsPage,
+  default27 as XoShortcutKeysRecord,
+  default28 as XoSidebarLogo,
+  default11 as XoSimpleLayout,
+  default29 as XoSpacingLine,
+  default31 as XoThemeSwitch,
+  default30 as XoThemeSwitchMini,
+  default32 as XoTitleBar,
+  default33 as XoUpdater,
+  default34 as XoWindowControl
+};