vue-mtcaptcha 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ng-mtcaptcha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,304 @@
+# vue-mtcaptcha
+
+Vue 3 MTCaptcha component library with TypeScript support. [MTCaptcha](https://www.mtcaptcha.com) is an efficient security solution to protect your Vue application against spam and automated abuse. It can be integrated with login, registration, forgot password, comments, contact forms, and any custom forms.
+
+## Top Highlights of MTCaptcha
+
+- GDPR compliance
+- Enterprise friendly
+- Accessibility compliance
+- Adaptive risk engine
+- High availability around the world
+
+## Summary of Features
+
+- Easy to configure custom skin for captcha that suits your app theme.
+- Flexible localization support via built-in language options and `customLangText`.
+- Supports explicit widget control through ref methods.
+
+## Supported Languages
+
+MTCaptcha supports localization for 60+ languages.
+
+Use `lang` to select the active language code (for example: `en`, `fr`, `ta`).
+
+Use `customLangText` to override labels for one or more language codes.
+
+## Forms You Can Protect
+
+- Login form protection
+- Registration form protection
+- Comments form protection
+- Forgot password form protection
+- Contact form protection
+- Any custom form you want to secure
+
+## Installation
+
+### Prerequisites
+
+- Vue 3.0.0 or higher
+- MTCaptcha account and sitekey
+
+Install with npm:
+
+```bash
+npm install vue-mtcaptcha
+```
+
+## Basic Usage (Vue 3)
+
+Use the [MTCaptcha demo site](https://service-origin.mtc4ptch4.com/mtcv1/demo/) to build a custom configuration tailored to your specific needs
+
+```vue
+<template>
+  <MTCaptcha
+    ref="captchaRef"
+    sitekey="YOUR_SITE_KEY"
+    :verified-callback="onVerified"
+  />
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import MTCaptcha, { type MTCaptchaState } from 'vue-mtcaptcha';
+
+const captchaRef = ref<InstanceType<typeof MTCaptcha> | null>(null);
+
+function onVerified(state: MTCaptchaState) {
+  console.log('Verified token:', state.verifiedToken);
+}
+
+function readToken() {
+  const token = captchaRef.value?.getVerifiedToken();
+  console.log('Token via ref:', token);
+}
+</script>
+```
+
+The component automatically injects the MTCaptcha client scripts and renders a `div.mtcaptcha`.
+
+## Optional Plugin Usage
+
+If you prefer plugin-style setup:
+
+```ts
+import { createApp } from 'vue';
+import App from './App.vue';
+import { MTCaptchaPlugin } from 'vue-mtcaptcha';
+
+const app = createApp(App);
+app.use(MTCaptchaPlugin, {
+  siteKey: 'YOUR_SITE_KEY',
+  action: 'login.submit',
+});
+app.mount('#app');
+```
+
+## Props
+
+
+| Name                           | Type                                                                                                                                                    | Required | Default      | Description                                                                                                                                   |
+| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `sitekey`                      | `string`                                                                                                                                                | Yes      | `-`          | Your MTCaptcha site key.                                                                                                                      |
+| `enableTestMode`               | `string`                                                                                                                                                | No       | `-`          | Test key from MTCaptcha Admin Console (next to PrivateKey).                                                                                   |
+| `lang`                         | `string`                                                                                                                                                | No       | `-`          | Active language code used by the widget (for example: `en`, `fr`, `ta`).                                                                      |
+| `customLangText` | `MTCaptchaCustomLangText`                                                                                                                               | No       | `-`          | Custom language text JSON.                                                                                                                    |
+| `customStyle`                  | `MTCaptchaCustomStyle`                                                                                                                                  | No       | `-`          | Custom style JSON for widget look-and-feel.                                                                                                   |
+| `theme`                        | `'basic' \| 'overcast' \| 'neowhite' \| 'goldbezel' \| 'blackmoon' \| 'darkruby' \| 'touchoforange' \| 'caribbean' \| 'woodyallen' \| 'chrome' \| 'highcontrast'` | No       | `basic`      | Widget theme preset.                                                                                                                          |
+| `challengeType`                | `'imageonly' \| 'standard'`                                                                                                                                | No       | `standard`   | Challenge mode. Use `imageonly` to force image-only challenges.                                                                               |
+| `action`                       | `string`                                                                                                                                                | No       | `-`          | Action tag. Must match `^[a-zA-Z0-9\\-_. ,]{1,30}$`.                                                                                          |
+| `widgetSize`                   | `'mini' \| 'standard'`                                                                                                                                   | No       | `standard`   | Widget size mode.                                                                                                                             |
+| `miniFormWidth`                | `number`                                                                                                                                                | No       | `responsive` | Width for mini widget. Range: `265` to `600`.                                                                                                 |
+| `miniFormHeight`               | `number`                                                                                                                                                | No       | `45`         | Height for mini widget. Range: `42` to `55`.                                                                                                  |
+| `loadAnimation`                | `boolean`                                                                                                                                               | No       | `true`       | Set to `false` to disable loading animation.                                                                                                  |
+| `autoFadeOuterText`            | `boolean`                                                                                                                                               | No       | `-`          | When `true`, outer text fades automatically; when `false`, it does not.                                                                       |
+| `lowFrictionInvisible`         | `'force-visible' \| 'force-invisible'`                                                                                                                   | No       | `-`          | Controls visibility behavior when low-friction invisible mode is enabled.                                                                     |
+| `autoFormValidate`             | `boolean`                                                                                                                                               | No       | `-`          | Enables auto form validation behavior in MTCaptcha.                                                                                           |
+| `jsloadedCallback`             | `(state: MTCaptchaState) => void`                                                                                                                       | No       | `-`          | Called when the MTCaptcha JavaScript library has loaded.                                                                                      |
+| `renderedCallback`             | `(state: MTCaptchaState) => void`                                                                                                                       | No       | `-`          | Called when the widget is rendered (made visible). It may not fire if captcha remains invisible due to low-friction or IP whitelist settings. |
+| `verifiedCallback`             | `(state: MTCaptchaState) => void`                                                                                                                       | No       | `-`          | Called when the user is verified. a `verifiedToken` is available on callback.                                                                 |
+| `verifyexpiredCallback`        | `(state: MTCaptchaState) => void`                                                                                                                       | No       | `-`          | Called when the last `verifiedToken` has expired.                                                                                             |
+| `errorCallback`                | `(state: MTCaptchaState) => void`                                                                                                                       | No       | `-`          | Called when an error occurs (for example bad sitekey or connection issues).                                                                   |
+
+For complete documentation, please visit our official [docs site](https://docs.mtcaptcha.com/dev-guide-quickstart)
+
+## Ref Methods
+
+You can call these through a component ref:
+
+
+| Method                        | Description                                                                                                   |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `setEnableTestMode(testKey?)` | Enables automated test mode with a test key.                                                                  |
+| `getConfiguration()`          | Returns a copy of the captcha configuration object for debugging; mutating the returned object has no effect. |
+| `getStatus()`                 | Returns the current captcha state object.                                                                     |
+| `getVerifiedToken()`          | Returns the current `verifiedToken` string, or `null` when not verified.                                      |
+| `renderUI()`                  | Explicitly renders/re-renders the widget (useful for explicit or async-safe render flows).                    |
+| `resetUI()`                   | Resets the widget and its state.                                                                              |
+| `remove()`                    | Completely removes the widget from the DOM; it can be re-instantiated with `renderUI()`.                      |
+| `showMandatory()`             | Forces mandatory validation styling/message, useful with custom form validation flows.                        |
+
+
+## Callback State Type
+
+```ts
+interface MTCaptchaState {
+  element: HTMLElement | null;
+  domID: string;
+  statusCode: number;
+  verifiedToken: string | null;
+  isVerified: boolean;
+  isVisible: boolean;
+  statusDesc: string;
+}
+```
+
+## customLangText Interface
+
+Use `customLangText` to override widget text by language code. Pair it with `lang` to choose which entry is used at runtime.
+
+```ts
+interface MTCaptchaCustomLangEntry {
+  inputPrompt?: string;
+  captchaRefresh?: string;
+  loading?: string;
+  reload?: string;
+  verifying?: string;
+  verifyFail?: string;
+  verifySuccess?: string;
+  captchaExpired?: string;
+  verifyExpired?: string;
+  emptyCaptcha?: string;
+  incompleteCaptcha?: string;
+  audioPlay?: string;
+  audioPlaying?: string;
+  continueAudio?: string;
+  downloadAudio?: string;
+  audioDownloading?: string;
+  connectionError?: string;
+}
+
+type MTCaptchaCustomLangText = Record<string, MTCaptchaCustomLangEntry>;
+```
+
+Example:
+
+```ts
+const customLangText = {
+  en: {
+    inputPrompt: 'Enter captcha text',
+    verifyFail: 'Verification failed',
+    verifySuccess: 'Verified',
+  },
+  zh: {
+    inputPrompt: '[input|☺|☺|<html>]',
+    captchaRefresh:
+      '!!this is a very very long <refresh> msg intended to be <silly> ☺ and no <script> ☺ to see how it would react to multiline message and if the widget adjusts height correctly!!',
+    loading: '!!loading!!',
+    reload: '!!reloading!!',
+    verifying: '!!verifying...!!',
+    verifyFail: '!!verification failed!!',
+    verifySuccess: '!!✓success✓!!',
+    captchaExpired: '!!token expired!!',
+    verifyExpired: '!!captcha expired!!',
+    emptyCaptcha: '!!please complete captcha!!',
+    incompleteCaptcha: '!!please complete captcha!!',
+    audioPlay: '!!play audio!!',
+    audioPlaying: '!!audio playing...!!',
+    continueAudio: '!!continue play!!',
+    downloadAudio: '!!download audio!!',
+    audioDownloading: '!!audio downloading!!',
+    connectionError:
+      '!!Failed to reach MTCaptcha Service <br>, Please check your internet connection and try again!!',
+  },
+};
+```
+
+Usage:
+
+```vue
+<MTCaptcha
+  sitekey="YOUR_SITE_KEY"
+  lang="zh"
+  :custom-lang-text="customLangText"
+/>
+```
+
+## customStyle Interface
+
+Use `customStyle` to override widget colors, fonts, and borders.
+
+```ts
+interface MTCaptchaInputBorderColor {
+  byDefault?: string;
+  hover?: string;
+  active?: string;
+}
+
+interface MTCaptchaButtonIconColor {
+  refresh?: string;
+  verify?: string;
+  success?: string;
+  fail?: string;
+  audio?: string;
+  audiofocus?: string;
+}
+
+interface MTCaptchaCustomStyle {
+  cardColor?: string;
+  cardShadowColor?: string;
+  cardBorder?: string;
+  placeHolderColor?: string;
+  inputTextColor?: string;
+  inputTextFont?: string;
+  msgTextColor?: string;
+  invalidMsgTextColor?: string;
+  msgTextFont?: string;
+  inputBackgroundColor?: string;
+  inputBorderColor?: MTCaptchaInputBorderColor;
+  buttonIconColor?: MTCaptchaButtonIconColor;
+  loadAnimationDotColor?: string;
+  loadAnimationBorderColor?: string;
+}
+```
+
+Example:
+
+```ts
+const customStyle = {
+  cardColor: '#32FF2F',
+  cardShadowColor: 'rgba(197,255,73,1)',
+  cardBorder: '10px #DEDEDE',
+  placeHolderColor: '#46FFB9',
+  inputTextColor: '#DAFFEC',
+  inputTextFont: 'San serif',
+  msgTextColor: '#63FF8B',
+  invalidMsgTextColor: '#61FFCE',
+  msgTextFont: 'Arial',
+  inputBackgroundColor: '#2EF3FF',
+  inputBorderColor: {
+    byDefault: '#4AFF97',
+    hover: '#60FF6E',
+    active: '#70FFFE',
+  },
+  buttonIconColor: {
+    refresh: '#DDFF80',
+    verify: '#93FF66',
+    success: '#AFE9FF',
+    fail: '#3D84FF',
+    audio: '#FF7E32',
+    audiofocus: '#FF500F',
+  },
+  loadAnimationDotColor: '#F122FF',
+  loadAnimationBorderColor: '#DFFF78',
+};
+```
+
+## License
+
+MIT License - see [LICENSE](https://github.com/mtcaptcha-public/vue-mtcaptcha/blob/main/LICENSE) file for details.
+
+## Support
+
+For issues and feature requests, please use the [GitHub issue tracker](https://github.com/mtcaptcha-public/vue-mtcaptcha/issues).

package/dist/MTCaptcha.d.ts

@@ -0,0 +1,247 @@
+import { type App, type Plugin } from 'vue';
+declare global {
+    interface Window {
+        mtcaptchaConfig?: Record<string, unknown>;
+        mtcaptcha?: {
+            enableTestMode: (testKey?: string) => void;
+            getConfiguration: () => unknown;
+            getStatus: () => unknown;
+            getVerifiedToken: () => string | undefined;
+            resetUI: () => void;
+            renderUI: () => void;
+            remove: () => void;
+            showMandatory: () => void;
+        };
+    }
+}
+export interface MTCaptchaState {
+    element: HTMLElement | null;
+    domID: string;
+    statusCode: number;
+    verifiedToken: string | null;
+    isVerified: boolean;
+    isVisible: boolean;
+    statusDesc: string;
+}
+export type MTCaptchaCustomLangText = Record<string, Record<string, string>>;
+export interface MTCaptchaInputBorderColor {
+    byDefault?: string;
+    hover?: string;
+    active?: string;
+}
+export interface MTCaptchaButtonIconColor {
+    refresh?: string;
+    verify?: string;
+    success?: string;
+    fail?: string;
+    audio?: string;
+    audiofocus?: string;
+}
+export interface MTCaptchaCustomStyle {
+    cardColor?: string;
+    cardShadowColor?: string;
+    cardBorder?: string;
+    placeHolderColor?: string;
+    inputTextColor?: string;
+    inputTextFont?: string;
+    msgTextColor?: string;
+    invalidMsgTextColor?: string;
+    msgTextFont?: string;
+    inputBackgroundColor?: string;
+    inputBorderColor?: MTCaptchaInputBorderColor;
+    buttonIconColor?: MTCaptchaButtonIconColor;
+    loadAnimationDotColor?: string;
+    loadAnimationBorderColor?: string;
+}
+export interface MTCaptchaOptions {
+    siteKey: string;
+    enableTestMode?: string;
+    lang?: string;
+    challengeType?: 'imageonly' | 'standard';
+    customLangText?: MTCaptchaCustomLangText;
+    customStyle?: MTCaptchaCustomStyle;
+    theme?: 'basic' | 'overcast' | 'neowhite' | 'goldbezel' | 'blackmoon' | 'darkruby' | 'touchoforange' | 'caribbean' | 'woodyallen' | 'chrome' | 'highcontrast';
+    action?: string;
+    widgetSize?: 'mini' | 'standard';
+    miniFormWidth?: number;
+    miniFormHeight?: number;
+    loadAnimation?: boolean;
+    lowFrictionInvisible?: 'force-visible' | 'force-invisible';
+    jsloadedCallback?: (state: MTCaptchaState) => void;
+    renderedCallback?: (state: MTCaptchaState) => void;
+    verifiedCallback?: (state: MTCaptchaState) => void;
+    verifyexpiredCallback?: (state: MTCaptchaState) => void;
+    errorCallback?: (state: MTCaptchaState) => void;
+    autoFormValidate?: boolean;
+    autoFadeOuterText?: boolean;
+}
+export type MTCaptchaPlugin = Plugin & {
+    install(app: App, options?: MTCaptchaOptions): void;
+};
+declare const MTCaptchaPluginImpl: MTCaptchaPlugin;
+export declare const MTCaptchaComponent: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    sitekey: {
+        type: StringConstructor;
+        required: true;
+    };
+    action: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    enableTestMode: {
+        type: StringConstructor;
+        required: false;
+    };
+    lang: {
+        type: StringConstructor;
+        required: false;
+    };
+    customLangText: {
+        type: ObjectConstructor;
+        required: false;
+    };
+    customStyle: {
+        type: ObjectConstructor;
+        required: false;
+    };
+    theme: {
+        type: StringConstructor;
+        required: false;
+        default: string;
+        validator: (value: string) => boolean;
+    };
+    widgetSize: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    miniFormWidth: {
+        type: NumberConstructor;
+        required: false;
+        validator: (value: number) => boolean;
+    };
+    miniFormHeight: {
+        type: NumberConstructor;
+        required: false;
+        validator: (value: number) => boolean;
+    };
+    loadAnimation: {
+        type: BooleanConstructor;
+        required: false;
+        default: boolean;
+    };
+    lowFrictionInvisible: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    challengeType: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    jsloadedCallback: FunctionConstructor;
+    renderedCallback: FunctionConstructor;
+    verifiedCallback: FunctionConstructor;
+    verifyexpiredCallback: FunctionConstructor;
+    errorCallback: FunctionConstructor;
+    autoFormValidate: {
+        type: BooleanConstructor;
+        required: false;
+    };
+    autoFadeOuterText: {
+        type: BooleanConstructor;
+        required: false;
+    };
+}>, {}, {}, {}, {
+    setEnableTestMode(testKey?: string): void;
+    getConfiguration(): unknown;
+    getStatus(): unknown;
+    getVerifiedToken(): string | undefined;
+    resetUI(): void;
+    renderUI(): void;
+    remove(): void;
+    showMandatory(): void;
+}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    sitekey: {
+        type: StringConstructor;
+        required: true;
+    };
+    action: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    enableTestMode: {
+        type: StringConstructor;
+        required: false;
+    };
+    lang: {
+        type: StringConstructor;
+        required: false;
+    };
+    customLangText: {
+        type: ObjectConstructor;
+        required: false;
+    };
+    customStyle: {
+        type: ObjectConstructor;
+        required: false;
+    };
+    theme: {
+        type: StringConstructor;
+        required: false;
+        default: string;
+        validator: (value: string) => boolean;
+    };
+    widgetSize: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    miniFormWidth: {
+        type: NumberConstructor;
+        required: false;
+        validator: (value: number) => boolean;
+    };
+    miniFormHeight: {
+        type: NumberConstructor;
+        required: false;
+        validator: (value: number) => boolean;
+    };
+    loadAnimation: {
+        type: BooleanConstructor;
+        required: false;
+        default: boolean;
+    };
+    lowFrictionInvisible: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    challengeType: {
+        type: StringConstructor;
+        required: false;
+        validator: (value: string) => boolean;
+    };
+    jsloadedCallback: FunctionConstructor;
+    renderedCallback: FunctionConstructor;
+    verifiedCallback: FunctionConstructor;
+    verifyexpiredCallback: FunctionConstructor;
+    errorCallback: FunctionConstructor;
+    autoFormValidate: {
+        type: BooleanConstructor;
+        required: false;
+    };
+    autoFadeOuterText: {
+        type: BooleanConstructor;
+        required: false;
+    };
+}>> & Readonly<{}>, {
+    theme: string;
+    loadAnimation: boolean;
+    autoFormValidate: boolean;
+    autoFadeOuterText: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default MTCaptchaPluginImpl;

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import type { App } from 'vue';
+import MTCaptchaPluginImpl, { type MTCaptchaOptions, MTCaptchaComponent } from './MTCaptcha';
+export * from './MTCaptcha';
+export default MTCaptchaComponent;
+export declare function install(app: App, options?: MTCaptchaOptions): void;
+export { MTCaptchaComponent as MTCaptcha, MTCaptchaPluginImpl as MTCaptchaPlugin };

package/dist/vue-mtcaptcha.es.js

@@ -0,0 +1,215 @@
+import { defineComponent as e, h as t } from "vue";
+//#region src/MTCaptcha.ts
+var n = !1, r = /^[a-zA-Z0-9\-_. ,]{1,30}$/;
+function i(e) {
+	return e == null || e === "" ? !0 : r.test(e);
+}
+function a(e) {
+	return e == null || e === "" ? !0 : e === "mini" || e === "standard";
+}
+function o(e) {
+	return e == null ? !0 : Number.isFinite(e) && e >= 265 && e <= 600;
+}
+function s(e) {
+	return e == null ? !0 : Number.isFinite(e) && e >= 42 && e <= 55;
+}
+function c(e) {
+	return e == null || e === "" ? !0 : e === "force-visible" || e === "force-invisible";
+}
+function l(e) {
+	return e == null || e === "" ? !0 : e === "imageonly" || e === "standard";
+}
+function u(e) {
+	return e == null || e === "" ? !0 : [
+		"basic",
+		"overcast",
+		"neowhite",
+		"goldbezel",
+		"blackmoon",
+		"darkruby",
+		"touchoforange",
+		"caribbean",
+		"woodyallen",
+		"chrome",
+		"highcontrast"
+	].includes(e);
+}
+function d() {
+	if (n) return;
+	n = !0;
+	let e = document.getElementsByTagName("head")[0] || document.getElementsByTagName("body")[0], t = document.createElement("script");
+	t.async = !0, t.src = "https://qa-service.sadtron.com/mtcv1/client/mtcaptcha.min.js", e.appendChild(t);
+	let r = document.createElement("script");
+	r.async = !0, r.src = "https://qa-service2.sadtron.com/mtcv1/client/mtcaptcha2.min.js", e.appendChild(r);
+}
+var f = { install(e, t) {
+	if (!t?.siteKey) throw Error("MTCaptcha: \"siteKey\" is required");
+	if (!i(t.action)) throw Error("MTCaptcha: \"action\" is invalid. Use 1-30 chars [a-zA-Z0-9-_. ,]");
+	if (!a(t.widgetSize)) throw Error("MTCaptcha: \"widgetSize\" must be \"mini\" or \"standard\"");
+	if (!o(t.miniFormWidth)) throw Error("MTCaptcha: \"miniFormWidth\" must be between 265 and 600");
+	if (!s(t.miniFormHeight)) throw Error("MTCaptcha: \"miniFormHeight\" must be between 42 and 55");
+	if (!c(t.lowFrictionInvisible)) throw Error("MTCaptcha: \"lowFrictionInvisible\" must be \"force-visible\" or \"force-invisible\"");
+	if (!l(t.challengeType)) throw Error("MTCaptcha: \"challengeType\" must be \"imageonly\" or \"standard\"");
+	if (!u(t.theme)) throw Error("MTCaptcha: \"theme\" must be one of basic, overcast, neowhite, goldbezel, blackmoon, darkruby, touchoforange, caribbean, woodyallen, chrome, highcontrast");
+	t && (window.mtcaptchaConfig = {
+		...window.mtcaptchaConfig ?? {},
+		sitekey: t.siteKey,
+		render: "explicit",
+		enableTestMode: t.enableTestMode ?? window.mtcaptchaConfig?.enableTestMode,
+		lang: t.lang ?? window.mtcaptchaConfig?.lang,
+		customLangText: t.customLangText ?? window.mtcaptchaConfig?.customLangText,
+		customStyle: t.customStyle ?? window.mtcaptchaConfig?.customStyle,
+		theme: t.theme ?? window.mtcaptchaConfig?.theme ?? "basic",
+		action: t.action ?? window.mtcaptchaConfig?.action,
+		widgetSize: t.widgetSize ?? window.mtcaptchaConfig?.widgetSize,
+		miniFormWidth: t.miniFormWidth ?? window.mtcaptchaConfig?.miniFormWidth,
+		miniFormHeight: t.miniFormHeight ?? window.mtcaptchaConfig?.miniFormHeight,
+		loadAnimation: t.loadAnimation ?? window.mtcaptchaConfig?.loadAnimation ?? !0,
+		lowFrictionInvisible: t.lowFrictionInvisible ?? window.mtcaptchaConfig?.lowFrictionInvisible,
+		challengeType: t.challengeType ?? window.mtcaptchaConfig?.challengeType,
+		"jsloaded-callback": t.jsloadedCallback ?? window.mtcaptchaConfig?.["jsloaded-callback"],
+		"rendered-callback": t.renderedCallback ?? window.mtcaptchaConfig?.["rendered-callback"],
+		"verified-callback": t.verifiedCallback ?? window.mtcaptchaConfig?.["verified-callback"],
+		"verifyexpired-callback": t.verifyexpiredCallback ?? window.mtcaptchaConfig?.["verifyexpired-callback"],
+		"error-callback": t.errorCallback ?? window.mtcaptchaConfig?.["error-callback"],
+		autoFormValidate: t.autoFormValidate ?? window.mtcaptchaConfig?.autoFormValidate,
+		autoFadeOuterText: t.autoFadeOuterText ?? window.mtcaptchaConfig?.autoFadeOuterText
+	}), d();
+} }, p = e({
+	name: "MTCaptcha",
+	props: {
+		sitekey: {
+			type: String,
+			required: !0
+		},
+		action: {
+			type: String,
+			required: !1,
+			validator: (e) => i(e)
+		},
+		enableTestMode: {
+			type: String,
+			required: !1
+		},
+		lang: {
+			type: String,
+			required: !1
+		},
+		customLangText: {
+			type: Object,
+			required: !1
+		},
+		customStyle: {
+			type: Object,
+			required: !1
+		},
+		theme: {
+			type: String,
+			required: !1,
+			default: "basic",
+			validator: (e) => u(e)
+		},
+		widgetSize: {
+			type: String,
+			required: !1,
+			validator: (e) => a(e)
+		},
+		miniFormWidth: {
+			type: Number,
+			required: !1,
+			validator: (e) => o(e)
+		},
+		miniFormHeight: {
+			type: Number,
+			required: !1,
+			validator: (e) => s(e)
+		},
+		loadAnimation: {
+			type: Boolean,
+			required: !1,
+			default: !0
+		},
+		lowFrictionInvisible: {
+			type: String,
+			required: !1,
+			validator: (e) => c(e)
+		},
+		challengeType: {
+			type: String,
+			required: !1,
+			validator: (e) => l(e)
+		},
+		jsloadedCallback: Function,
+		renderedCallback: Function,
+		verifiedCallback: Function,
+		verifyexpiredCallback: Function,
+		errorCallback: Function,
+		autoFormValidate: {
+			type: Boolean,
+			required: !1
+		},
+		autoFadeOuterText: {
+			type: Boolean,
+			required: !1
+		}
+	},
+	methods: {
+		setEnableTestMode(e) {
+			window.mtcaptcha?.enableTestMode(e);
+		},
+		getConfiguration() {
+			return window.mtcaptcha?.getConfiguration();
+		},
+		getStatus() {
+			return window.mtcaptcha?.getStatus();
+		},
+		getVerifiedToken() {
+			return window.mtcaptcha?.getVerifiedToken();
+		},
+		resetUI() {
+			window.mtcaptcha?.resetUI();
+		},
+		renderUI() {
+			window.mtcaptcha?.renderUI();
+		},
+		remove() {
+			window.mtcaptcha?.remove();
+		},
+		showMandatory() {
+			window.mtcaptcha?.showMandatory();
+		}
+	},
+	mounted() {
+		d(), window.mtcaptchaConfig = {
+			...window.mtcaptchaConfig ?? {},
+			sitekey: this.sitekey,
+			enableTestMode: this.enableTestMode ?? window.mtcaptchaConfig?.enableTestMode,
+			lang: this.lang ?? window.mtcaptchaConfig?.lang,
+			customLangText: this.customLangText ?? window.mtcaptchaConfig?.customLangText,
+			customStyle: this.customStyle ?? window.mtcaptchaConfig?.customStyle,
+			theme: this.theme ?? window.mtcaptchaConfig?.theme ?? "basic",
+			action: this.action ?? window.mtcaptchaConfig?.action,
+			widgetSize: this.widgetSize ?? window.mtcaptchaConfig?.widgetSize,
+			miniFormWidth: this.miniFormWidth ?? window.mtcaptchaConfig?.miniFormWidth,
+			miniFormHeight: this.miniFormHeight ?? window.mtcaptchaConfig?.miniFormHeight,
+			loadAnimation: this.loadAnimation ?? window.mtcaptchaConfig?.loadAnimation ?? !0,
+			lowFrictionInvisible: this.lowFrictionInvisible ?? window.mtcaptchaConfig?.lowFrictionInvisible,
+			challengeType: this.challengeType ?? window.mtcaptchaConfig?.challengeType,
+			"jsloaded-callback": this.jsloadedCallback ?? window.mtcaptchaConfig?.["jsloaded-callback"],
+			"rendered-callback": this.renderedCallback ?? window.mtcaptchaConfig?.["rendered-callback"],
+			"verified-callback": this.verifiedCallback ?? window.mtcaptchaConfig?.["verified-callback"],
+			"verifyexpired-callback": this.verifyexpiredCallback ?? window.mtcaptchaConfig?.["verifyexpired-callback"],
+			"error-callback": this.errorCallback ?? window.mtcaptchaConfig?.["error-callback"],
+			autoFormValidate: this.autoFormValidate ?? window.mtcaptchaConfig?.autoFormValidate,
+			autoFadeOuterText: this.autoFadeOuterText ?? window.mtcaptchaConfig?.autoFadeOuterText
+		};
+	},
+	render() {
+		return t("div", { class: "mtcaptcha" });
+	}
+}), m = p;
+function h(e, t) {
+	e.use(f, t);
+}
+//#endregion
+export { p as MTCaptcha, p as MTCaptchaComponent, f as MTCaptchaPlugin, m as default, h as install };

package/dist/vue-mtcaptcha.umd.js

@@ -0,0 +1 @@
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require(`vue`)):typeof define==`function`&&define.amd?define([`exports`,`vue`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.MTCaptchaVue={},e.Vue))})(this,function(e,t){Object.defineProperties(e,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var n=!1,r=/^[a-zA-Z0-9\-_. ,]{1,30}$/;function i(e){return e==null||e===``?!0:r.test(e)}function a(e){return e==null||e===``?!0:e===`mini`||e===`standard`}function o(e){return e==null?!0:Number.isFinite(e)&&e>=265&&e<=600}function s(e){return e==null?!0:Number.isFinite(e)&&e>=42&&e<=55}function c(e){return e==null||e===``?!0:e===`force-visible`||e===`force-invisible`}function l(e){return e==null||e===``?!0:e===`imageonly`||e===`standard`}function u(e){return e==null||e===``?!0:[`basic`,`overcast`,`neowhite`,`goldbezel`,`blackmoon`,`darkruby`,`touchoforange`,`caribbean`,`woodyallen`,`chrome`,`highcontrast`].includes(e)}function d(){if(n)return;n=!0;let e=document.getElementsByTagName(`head`)[0]||document.getElementsByTagName(`body`)[0],t=document.createElement(`script`);t.async=!0,t.src=`https://qa-service.sadtron.com/mtcv1/client/mtcaptcha.min.js`,e.appendChild(t);let r=document.createElement(`script`);r.async=!0,r.src=`https://qa-service2.sadtron.com/mtcv1/client/mtcaptcha2.min.js`,e.appendChild(r)}var f={install(e,t){if(!t?.siteKey)throw Error(`MTCaptcha: "siteKey" is required`);if(!i(t.action))throw Error(`MTCaptcha: "action" is invalid. Use 1-30 chars [a-zA-Z0-9-_. ,]`);if(!a(t.widgetSize))throw Error(`MTCaptcha: "widgetSize" must be "mini" or "standard"`);if(!o(t.miniFormWidth))throw Error(`MTCaptcha: "miniFormWidth" must be between 265 and 600`);if(!s(t.miniFormHeight))throw Error(`MTCaptcha: "miniFormHeight" must be between 42 and 55`);if(!c(t.lowFrictionInvisible))throw Error(`MTCaptcha: "lowFrictionInvisible" must be "force-visible" or "force-invisible"`);if(!l(t.challengeType))throw Error(`MTCaptcha: "challengeType" must be "imageonly" or "standard"`);if(!u(t.theme))throw Error(`MTCaptcha: "theme" must be one of basic, overcast, neowhite, goldbezel, blackmoon, darkruby, touchoforange, caribbean, woodyallen, chrome, highcontrast`);t&&(window.mtcaptchaConfig={...window.mtcaptchaConfig??{},sitekey:t.siteKey,render:`explicit`,enableTestMode:t.enableTestMode??window.mtcaptchaConfig?.enableTestMode,lang:t.lang??window.mtcaptchaConfig?.lang,customLangText:t.customLangText??window.mtcaptchaConfig?.customLangText,customStyle:t.customStyle??window.mtcaptchaConfig?.customStyle,theme:t.theme??window.mtcaptchaConfig?.theme??`basic`,action:t.action??window.mtcaptchaConfig?.action,widgetSize:t.widgetSize??window.mtcaptchaConfig?.widgetSize,miniFormWidth:t.miniFormWidth??window.mtcaptchaConfig?.miniFormWidth,miniFormHeight:t.miniFormHeight??window.mtcaptchaConfig?.miniFormHeight,loadAnimation:t.loadAnimation??window.mtcaptchaConfig?.loadAnimation??!0,lowFrictionInvisible:t.lowFrictionInvisible??window.mtcaptchaConfig?.lowFrictionInvisible,challengeType:t.challengeType??window.mtcaptchaConfig?.challengeType,"jsloaded-callback":t.jsloadedCallback??window.mtcaptchaConfig?.[`jsloaded-callback`],"rendered-callback":t.renderedCallback??window.mtcaptchaConfig?.[`rendered-callback`],"verified-callback":t.verifiedCallback??window.mtcaptchaConfig?.[`verified-callback`],"verifyexpired-callback":t.verifyexpiredCallback??window.mtcaptchaConfig?.[`verifyexpired-callback`],"error-callback":t.errorCallback??window.mtcaptchaConfig?.[`error-callback`],autoFormValidate:t.autoFormValidate??window.mtcaptchaConfig?.autoFormValidate,autoFadeOuterText:t.autoFadeOuterText??window.mtcaptchaConfig?.autoFadeOuterText}),d()}},p=(0,t.defineComponent)({name:`MTCaptcha`,props:{sitekey:{type:String,required:!0},action:{type:String,required:!1,validator:e=>i(e)},enableTestMode:{type:String,required:!1},lang:{type:String,required:!1},customLangText:{type:Object,required:!1},customStyle:{type:Object,required:!1},theme:{type:String,required:!1,default:`basic`,validator:e=>u(e)},widgetSize:{type:String,required:!1,validator:e=>a(e)},miniFormWidth:{type:Number,required:!1,validator:e=>o(e)},miniFormHeight:{type:Number,required:!1,validator:e=>s(e)},loadAnimation:{type:Boolean,required:!1,default:!0},lowFrictionInvisible:{type:String,required:!1,validator:e=>c(e)},challengeType:{type:String,required:!1,validator:e=>l(e)},jsloadedCallback:Function,renderedCallback:Function,verifiedCallback:Function,verifyexpiredCallback:Function,errorCallback:Function,autoFormValidate:{type:Boolean,required:!1},autoFadeOuterText:{type:Boolean,required:!1}},methods:{setEnableTestMode(e){window.mtcaptcha?.enableTestMode(e)},getConfiguration(){return window.mtcaptcha?.getConfiguration()},getStatus(){return window.mtcaptcha?.getStatus()},getVerifiedToken(){return window.mtcaptcha?.getVerifiedToken()},resetUI(){window.mtcaptcha?.resetUI()},renderUI(){window.mtcaptcha?.renderUI()},remove(){window.mtcaptcha?.remove()},showMandatory(){window.mtcaptcha?.showMandatory()}},mounted(){d(),window.mtcaptchaConfig={...window.mtcaptchaConfig??{},sitekey:this.sitekey,enableTestMode:this.enableTestMode??window.mtcaptchaConfig?.enableTestMode,lang:this.lang??window.mtcaptchaConfig?.lang,customLangText:this.customLangText??window.mtcaptchaConfig?.customLangText,customStyle:this.customStyle??window.mtcaptchaConfig?.customStyle,theme:this.theme??window.mtcaptchaConfig?.theme??`basic`,action:this.action??window.mtcaptchaConfig?.action,widgetSize:this.widgetSize??window.mtcaptchaConfig?.widgetSize,miniFormWidth:this.miniFormWidth??window.mtcaptchaConfig?.miniFormWidth,miniFormHeight:this.miniFormHeight??window.mtcaptchaConfig?.miniFormHeight,loadAnimation:this.loadAnimation??window.mtcaptchaConfig?.loadAnimation??!0,lowFrictionInvisible:this.lowFrictionInvisible??window.mtcaptchaConfig?.lowFrictionInvisible,challengeType:this.challengeType??window.mtcaptchaConfig?.challengeType,"jsloaded-callback":this.jsloadedCallback??window.mtcaptchaConfig?.[`jsloaded-callback`],"rendered-callback":this.renderedCallback??window.mtcaptchaConfig?.[`rendered-callback`],"verified-callback":this.verifiedCallback??window.mtcaptchaConfig?.[`verified-callback`],"verifyexpired-callback":this.verifyexpiredCallback??window.mtcaptchaConfig?.[`verifyexpired-callback`],"error-callback":this.errorCallback??window.mtcaptchaConfig?.[`error-callback`],autoFormValidate:this.autoFormValidate??window.mtcaptchaConfig?.autoFormValidate,autoFadeOuterText:this.autoFadeOuterText??window.mtcaptchaConfig?.autoFadeOuterText}},render(){return(0,t.h)(`div`,{class:`mtcaptcha`})}}),m=p;function h(e,t){e.use(f,t)}e.MTCaptcha=p,e.MTCaptchaComponent=p,e.MTCaptchaPlugin=f,e.default=m,e.install=h});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "vue-mtcaptcha",
+  "version": "1.0.1",
+  "description": "A Vue 3 plugin for MTCaptcha integration.",
+  "author": "MTCaptcha Public",
+  "organization": "MTcaptcha",
+  "homepage": "https://github.com/mtcaptcha-public/vue-mtcaptcha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mtcaptcha-public/vue-mtcaptcha.git",
+    "web": "https://github.com/mtcaptcha-public/vue-mtcaptcha"
+  },
+  "bugs": {
+    "url": "https://github.com/mtcaptcha-public/vue-mtcaptcha/issues"
+  },
+  "license": "MIT",
+  "main": "dist/vue-mtcaptcha.umd.js",
+  "module": "dist/vue-mtcaptcha.es.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],  
+  "scripts": {
+    "build": "vite build && npm run build:types",
+    "build:types": "tsc -p tsconfig.types.json",
+    "dev": "vite dev",
+    "preview": "vite preview"
+  },
+  "keywords": [
+    "vue",
+    "mtcaptcha",
+    "captcha",
+    "vue-library",
+    "vue-component",
+    "security",
+    "mtcaptcha-vue"
+  ],
+  "peerDependencies": {
+    "vue": "^3.5.30"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@vitejs/plugin-vue": "^6.0.5",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.0"
+  }
+}