@e-xi/xion 0.0.6

package/dist/renderer/components/captcha/internal/captcha-runtime-types.d.ts

@@ -0,0 +1,153 @@
+import type { XoComponentCaptchaServiceOptions, XoComponentCaptchaTicket, XoPropsCaptcha } from '../types/captcha';
+import type { Ref } from 'vue';
+/** 全局验证码主机传递给组件的属性 */
+export type CaptchaHostProps = Omit<XoPropsCaptcha, 'modelValue' | 'showTheme'>;
+/** 全局验证码服务主机 */
+export interface CaptchaServiceHost {
+    /** 打开验证码并等待验证票据 */
+    open(options: XoComponentCaptchaServiceOptions): Promise<XoComponentCaptchaTicket>;
+    /** 关闭当前验证码 */
+    close(): void;
+}
+/** 验证码后端配置 */
+export interface CaptchaConfigResponse {
+    /** 验证码生成接口相对路径 */
+    generate?: string;
+    /** 验证码校验接口相对路径 */
+    verify?: string;
+    /** Go WASM 文件相对路径 */
+    wasm?: string;
+    /** wasm_exec.js 文件相对路径 */
+    wasmExec?: string;
+    /** 验证码背景宽度 */
+    width?: number;
+    /** 验证码背景高度 */
+    height?: number;
+    /** 验证码有效时间，单位为秒 */
+    validity?: number;
+}
+/** 验证码生成结果 */
+export interface CaptchaGenerateResponse {
+    /** 验证码 ID */
+    id: string;
+    /** WASM 签名随机种子 */
+    seed: number;
+    /** WASM 签名令牌 */
+    token: string;
+    /** 验证码背景图片 */
+    image: string;
+    /** 验证码滑块图片 */
+    thumb: string;
+    /** 滑块横坐标 */
+    thumbX: number;
+    /** 滑块纵坐标 */
+    thumbY: number;
+    /** 滑块宽度 */
+    thumbWidth: number;
+    /** 滑块高度 */
+    thumbHeight: number;
+}
+/** WASM 签名请求 */
+export interface CaptchaWasmRequest {
+    /** 验证码根元素 ID */
+    rootId: string;
+    /** 验证码 ID */
+    captchaId: string;
+    /** WASM 签名随机种子 */
+    seed: number;
+    /** WASM 签名令牌 */
+    token: string;
+    /** 验证码生成时间戳 */
+    generateTime: number;
+}
+/** WASM 调用结果 */
+export interface CaptchaWasmResponse {
+    /** 调用是否成功 */
+    success: boolean;
+    /** 调用失败信息 */
+    error: string;
+    /** 调用成功数据 */
+    data?: {
+        /** WASM 生成的签名 */
+        sign?: string;
+    };
+}
+/** 验证码校验请求 */
+export interface CaptchaVerifyRequest {
+    /** 验证码 ID */
+    captchaId: string;
+    /** 需要验证的动作类型 */
+    action: string;
+    /** 当前浏览器用户代理 */
+    userAgent: string;
+    /** 当前屏幕宽度 */
+    screenWidth: number;
+    /** 当前屏幕高度 */
+    screenHeight: number;
+    /** 当前屏幕颜色深度 */
+    colorDepth: number;
+    /** 当前浏览器语言 */
+    language: string;
+    /** WASM 生成的签名 */
+    sign: string;
+}
+/** 验证码校验结果 */
+export interface CaptchaVerifyResponse {
+    /** 验证成功后返回的票据 */
+    ticket: string;
+}
+/** 验证码组件 DOM 引用 */
+export interface CaptchaDomRefs {
+    /** 验证码根元素 ID */
+    rootId?: Ref<string>;
+    /** 验证码根元素 */
+    captchaRef: Ref<HTMLElement | null>;
+    /** go-captcha-vue 内容容器 */
+    gcBodyRef: Ref<HTMLElement | null>;
+}
+/** 验证码 UI 补丁配置 */
+export interface CaptchaUiPatchOptions {
+    /** 验证码组件 DOM 引用 */
+    domRefs: CaptchaDomRefs;
+    /** 验证码组件属性 */
+    props: XoPropsCaptcha;
+}
+/** 验证码 WASM 加载配置 */
+export interface CaptchaWasmLoaderOptions {
+    /** 请求基础地址 */
+    baseUrl: string;
+    /** 验证码接口路径 */
+    captchaUrl: string;
+    /** 资源加载超时时间，单位为毫秒 */
+    timeout: number;
+}
+/** Go WASM 暴露的验证码服务 */
+export interface CaptchaWasmService {
+    /** 对验证码请求进行签名 */
+    Sign(request: CaptchaWasmRequest): CaptchaWasmResponse;
+    /** 注册验证码根元素 */
+    Register(rootId: string): CaptchaWasmResponse;
+    /** 注销验证码根元素 */
+    Unregister(rootId: string): void;
+}
+declare global {
+    interface Window {
+        /** wasm_exec.js 注入的 Go 运行时 */
+        Go: new () => {
+            /** Go WASM 实例化所需的导入对象 */
+            importObject: WebAssembly.Imports;
+            /** 启动 Go WASM 实例 */
+            run(instance: WebAssembly.Instance): void | Promise<void>;
+        };
+        /** 验证码 WASM 使用的全局协议对象 */
+        __GCaptcha?: {
+            /** WASM 服务是否加载完成 */
+            Loaded?: boolean;
+            /** 后端返回的验证码配置 */
+            Config?: CaptchaConfigResponse;
+            /** Go WASM 暴露的验证码服务 */
+            Service?: CaptchaWasmService;
+        };
+    }
+}
+export {};

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

@@ -0,0 +1,22 @@
+import type { XoComponentCaptchaServiceOptions, XoComponentCaptchaTicket } from '../types/captcha';
+import type { CaptchaServiceHost } from './captcha-runtime-types';
+/**
+ * 注册验证码服务主机
+ * @param {CaptchaServiceHost} instance 服务主机
+ */
+export declare function registerCaptchaHost(instance: CaptchaServiceHost): void;
+/**
+ * 注销验证码服务主机
+ * @param {CaptchaServiceHost} instance 服务主机
+ */
+export declare function unregisterCaptchaHost(instance: CaptchaServiceHost): void;
+/**
+ * 打开全局验证码
+ * @param {string | XoComponent.CaptchaServiceOptions} options 服务选项
+ * @returns {Promise<XoComponent.CaptchaTicket>}
+ */
+export declare function openCaptcha(options: string | XoComponentCaptchaServiceOptions): Promise<XoComponentCaptchaTicket>;
+/**
+ * 关闭全局验证码
+ */
+export declare function closeCaptcha(): void;

package/dist/renderer/components/captcha/internal/captcha-slide-types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * go-captcha-vue 滑块配置
+ */
+export interface CaptchaSlideConfig {
+    /** 验证码背景宽度 */
+    width?: number;
+    /** 验证码背景高度 */
+    height?: number;
+    /** 滑块宽度 */
+    thumbWidth?: number;
+    /** 滑块高度 */
+    thumbHeight?: number;
+    /** 验证码纵向内边距 */
+    verticalPadding?: number;
+    /** 验证码横向内边距 */
+    horizontalPadding?: number;
+    /** 是否显示第三方组件主题容器 */
+    showTheme?: boolean;
+    /** 验证码标题 */
+    title?: string;
+    /** 刷新和关闭图标尺寸 */
+    iconSize?: number;
+}
+/**
+ * go-captcha-vue 滑块数据
+ */
+export interface CaptchaSlideData {
+    /** 滑块横坐标 */
+    thumbX: number;
+    /** 滑块纵坐标 */
+    thumbY: number;
+    /** 滑块宽度 */
+    thumbWidth: number;
+    /** 滑块高度 */
+    thumbHeight: number;
+    /** 验证码背景图片 */
+    image: string;
+    /** 滑块图片 */
+    thumb: string;
+}
+/**
+ * go-captcha-vue 滑块坐标
+ */
+export interface CaptchaSlidePoint {
+    /** 横坐标 */
+    x: number;
+    /** 纵坐标 */
+    y: number;
+}
+/**
+ * go-captcha-vue 滑块事件
+ */
+export interface CaptchaSlideEvent {
+    /** 滑块移动回调 */
+    move?(x: number, y: number): void;
+    /** 刷新回调 */
+    refresh?(): void;
+    /** 关闭回调 */
+    close?(): void;
+    /** 确认回调 */
+    confirm?(point: CaptchaSlidePoint, reset: () => void): void;
+}

package/dist/renderer/components/captcha/internal/captcha-ui-patch.d.ts

@@ -0,0 +1,43 @@
+import type { CaptchaUiPatchOptions } from './captcha-runtime-types';
+/**
+ * go-captcha-vue DOM 补丁
+ */
+export declare class XoCaptchaUiPatch {
+    private readonly config;
+    /**
+     * 构造函数
+     * @param {CaptchaUiPatchOptions} config 配置
+     */
+    constructor(config: CaptchaUiPatchOptions);
+    /**
+     * 应用补丁
+     * @returns {Promise<void>}
+     */
+    apply(): Promise<void>;
+    /**
+     * 替换关闭图标
+     * @private
+     */
+    private replaceCloseIcon;
+    /**
+     * 为刷新和关闭按钮添加 title 属性
+     */
+    private setIconTitle;
+    /**
+     * 设置 SVG 元素的 title 属性
+     * @param {Element} svg SVG 元素
+     * @param {string} text title 文本
+     * @private
+     */
+    private setSvgTooltip;
+    /**
+     * 更新 .go-captcha .gc-body 容器
+     * @private
+     */
+    private setGcBodyRef;
+    /**
+     * 关闭按钮 SVG 图标
+     * @private
+     */
+    private closeSVG;
+}

package/dist/renderer/components/captcha/internal/captcha-wasm-loader.d.ts

@@ -0,0 +1,36 @@
+import type { CaptchaWasmLoaderOptions } from './captcha-runtime-types';
+/**
+ * 验证码 WASM 加载器
+ */
+export declare class XoCaptchaWasmLoader {
+    private readonly options;
+    /**
+     * 创建验证码 WASM 加载器
+     * @param {CaptchaWasmLoaderOptions} options WASM 加载配置
+     */
+    constructor(options: CaptchaWasmLoaderOptions);
+    /**
+     * 加载 WASM 运行时和验证码模块
+     * @returns {Promise<void>} WASM 服务准备完成的 Promise
+     */
+    load(): Promise<void>;
+    /**
+     * 执行一次 WASM 资源加载
+     * @returns {Promise<void>} WASM 服务准备完成的 Promise
+     * @private
+     */
+    private loadResources;
+    /**
+     * 注入 wasm_exec.js 脚本
+     * @param {string} src 脚本地址
+     * @returns {Promise<void>} 脚本加载完成的 Promise
+     * @private
+     */
+    private loadWasmExec;
+    /**
+     * 等待 Go WASM 暴露验证码服务
+     * @returns {Promise<void>} 服务准备完成的 Promise
+     * @private
+     */
+    private waitUntilReady;
+}

package/dist/renderer/components/captcha/style/index.less

@@ -0,0 +1,132 @@
+// 覆盖 go-captcha-vue 的默认样式
+.xo-captcha {
+    --go-captcha-theme-border-color   : var(--gc-border-color);
+    --go-captcha-theme-text-color     : var(--gc-title-color);
+    --go-captcha-theme-icon-color     : var(--gc-icon-color);
+    --go-captcha-theme-bg-color       : var(--gc-background-color);
+    --go-captcha-theme-drag-bar-color : var(--gc-drag-bar-color);
+    --go-captcha-theme-drag-bg-color  : var(--gc-drag-background-color);
+}
+
+// 验证码容器
+.xo-captcha {
+    position        : fixed;
+    z-index         : 1000;
+    top             : 0;
+    left            : 0;
+    width           : 100%;
+    height          : 100%;
+    display         : flex;
+    align-items     : center;
+    justify-content : center;
+
+    .mask {
+        background : var(--gc-mask-color);
+        opacity    : var(--gc-mask-opacity);
+        position   : relative;
+        z-index    : 1;
+        width      : 100%;
+        height     : 100%;
+    }
+
+    .instance {
+        position        : absolute;
+        width           : 100%;
+        height          : 100%;
+        z-index         : 2;
+        display         : flex;
+        align-items     : center;
+        justify-content : center;
+    }
+
+    &.is-embedded {
+        position : relative;
+        z-index  : 1;
+        width    : auto;
+        height   : auto;
+        display  : block;
+
+        .mask {
+            display : none;
+        }
+
+        .instance {
+            position : relative;
+            z-index  : 1;
+            display  : block;
+        }
+    }
+}
+
+// go-captcha 组件样式覆盖
+.xo-captcha {
+
+    // 自定义错误信息
+    & :deep(.xo-captcha-error) {
+        position        : absolute;
+        z-index         : 10;
+        width           : 100%;
+        height          : 100%;
+        top             : 0;
+        left            : 0;
+        display         : flex;
+        align-items     : flex-end;
+        justify-content : center;
+        padding-bottom  : 10px;
+        padding-left    : 10px;
+        padding-right   : 10px;
+
+        .message {
+            @message-border-size  : calc(~"var(--gc-radius) * 0.66");
+            width                 : 100%;
+            text-align            : center;
+            padding               : 10px 15px;
+            font-size             : 14px;
+            border                : 1px solid #ff7800;
+            background            : rgba(255, 80, 0, 0.66);
+            -webkit-border-radius : @message-border-size;
+            -moz-border-radius    : @message-border-size;
+            border-radius         : @message-border-size;
+            color                 : #ffffff;
+            -webkit-box-shadow    : 0 0 10px rgba(0, 0, 0, 0.33);
+            -moz-box-shadow       : 0 0 10px rgba(0, 0, 0, 0.33);
+            box-shadow            : 0 0 10px rgba(0, 0, 0, 0.33);
+        }
+    }
+
+    // 验证码背景圆角
+    & :deep(.go-captcha .gc-body) {
+        -webkit-border-radius : var(--gc-radius);
+        -moz-border-radius    : var(--gc-radius);
+        border-radius         : var(--gc-radius);
+    }
+
+    // 验证码阴影
+    & :deep(.go-captcha.gc-theme) {
+        -webkit-box-shadow : var(--gc-shadow);
+        -moz-box-shadow    : var(--gc-shadow);
+        box-shadow         : var(--gc-shadow);
+    }
+
+    // 提示文字颜色
+    & :deep(.go-captcha .gc-header span) {
+        font-size : var(--gc-title-font-size);
+    }
+
+    // 调换刷新和关闭图标的位置
+    & :deep(.go-captcha .gc-header .gc-icon-block) {
+        flex-direction : row-reverse;
+    }
+
+    // 关闭按钮 hover 样式
+    & :deep(.go-captcha .gc-header .gc-icon-block svg:nth-child(1):hover) {
+        color : var(--go-captcha-theme-error-color);
+        fill  : var(--go-captcha-theme-error-color);
+    }
+
+    // 刷新按钮 hover 样式
+    & :deep(.go-captcha .gc-header .gc-icon-block svg:nth-child(2):hover) {
+        color : var(--go-captcha-theme-success-color);
+        fill  : var(--go-captcha-theme-success-color);
+    }
+}

package/dist/renderer/components/captcha/types/captcha.d.ts

@@ -0,0 +1,132 @@
+import type {MaybeRefOrGetter} from 'vue'
+
+// 验证码主题颜色样式
+export interface XoComponentCaptchaThemeStyle {
+    // 背景颜色
+    backgroundColor?: string
+    // 拖拽条颜色
+    dragBarColor?: string
+    // 拖拽背景颜色
+    dragBackgroundColor?: string
+    // 遮罩层颜色
+    maskColor?: string
+    // 遮罩层透明度
+    maskOpacity?: number
+    // 边框颜色
+    borderColor?: string
+    // 标题颜色
+    titleColor?: string
+    // 图标颜色
+    iconColor?: string
+    // 阴影样式
+    shadow?: string
+}
+
+// 验证码全局请求配置
+export interface XoComponentCaptchaGlobalOptions {
+    // 请求基础地址
+    baseUrl?: string
+    // 请求超时
+    timeout?: number
+    // 验证码请求路径
+    captchaUrl?: string
+}
+
+// 验证码全局请求提供配置
+export interface XoComponentCaptchaProvideOptions extends XoComponentCaptchaGlobalOptions {
+}
+
+// 验证码组件属性
+export interface XoPropsCaptcha extends XoComponentCaptchaThemeStyle, XoComponentCaptchaGlobalOptions {
+    // 是否显示验证码
+    modelValue?: boolean
+    // 需要验证的动作类型
+    action: string
+    // 验证码标题
+    title?: string
+    // 横向边距
+    horizontalPadding?: number
+    // 纵向边距
+    verticalPadding?: number
+    // 是否显示主题容器
+    showTheme?: boolean
+    // 图标尺寸
+    iconSize?: number
+    // 标题字体大小
+    titleFontSize?: number
+    // 圆角大小
+    radiusSize?: number
+    // 刷新按钮提示
+    refreshIconTitle?: string
+    // 关闭按钮提示
+    closeIconTitle?: string
+    // 错误信息清除延迟
+    errorClearDelay?: number
+}
+
+// 验证码票据
+export interface XoComponentCaptchaTicket {
+    // 票据
+    ticket: string
+    // 动作
+    action: string
+}
+
+// 验证码组件暴露方法
+export interface XoComponentCaptchaExpose {
+    // 打开验证码
+    open(): void
+
+    // 刷新验证码
+    refresh(): void
+
+    // 关闭验证码
+    close(): void
+}
+
+// 验证码组件事件
+export interface XoComponentCaptchaEmits {
+    // 更新显示状态
+    (event: 'update:modelValue', value: boolean): void
+
+    // 验证成功
+    (event: 'verified', ticket: XoComponentCaptchaTicket): void
+}
+
+// 验证码服务选项
+export type XoComponentCaptchaServiceOptions = { action: XoPropsCaptcha['action'] } & Partial<{
+    [K in Exclude<keyof Omit<XoPropsCaptcha, 'modelValue' | 'showTheme'>, 'action'>]: MaybeRefOrGetter<XoPropsCaptcha[K]>
+}>
+
+declare global {
+
+    // 组件
+    namespace XoComponent {
+        // 验证码主题颜色样式
+        type CaptchaThemeStyle = XoComponentCaptchaThemeStyle
+
+        // 验证码全局请求配置
+        type CaptchaGlobalOptions = XoComponentCaptchaGlobalOptions
+
+        // 验证码全局请求提供配置
+        type CaptchaProvideOptions = XoComponentCaptchaProvideOptions
+
+        // 验证码票据
+        type CaptchaTicket = XoComponentCaptchaTicket
+
+        // 验证码组件暴露方法
+        type CaptchaExpose = XoComponentCaptchaExpose
+
+        // 验证码服务选项
+        type CaptchaServiceOptions = XoComponentCaptchaServiceOptions
+    }
+
+    // 属性
+    namespace XoProps {
+        // 验证码组件属性
+        interface Captcha extends XoPropsCaptcha {
+        }
+    }
+}
+
+export {}