@oxog/vld 1.3.1 → 1.4.0

package/dist/validators/template-literal.js

@@ -0,0 +1,101 @@
+import { VldBase } from './base.js';
+import { getMessages } from '../locales/index.js';
+/**
+ * Immutable template literal validator
+ * Validates strings matching a template pattern
+ */
+export class VldTemplateLiteral extends VldBase {
+    constructor(pattern) {
+        super();
+        this.pattern = pattern;
+    }
+    /**
+     * Create a template literal validator from components
+     */
+    static create(...components) {
+        // Build regex pattern from components
+        let pattern = '^';
+        for (const comp of components) {
+            if (typeof comp === 'string') {
+                // Escape special regex characters
+                pattern += comp.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            }
+            else {
+                // Add appropriate pattern based on validator type
+                pattern += getPatternForValidator(comp);
+            }
+        }
+        pattern += '$';
+        return new VldTemplateLiteral(new RegExp(pattern));
+    }
+    /**
+     * Parse and validate a template literal string
+     */
+    parse(value) {
+        if (typeof value !== 'string') {
+            throw new Error(getMessages().invalidString);
+        }
+        if (!this.pattern.test(value)) {
+            throw new Error(getMessages().stringPatternInvalid);
+        }
+        return value;
+    }
+    /**
+     * Safely parse and validate a template literal string
+     */
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error
+            };
+        }
+    }
+}
+/**
+ * Get regex pattern for a validator type
+ */
+function getPatternForValidator(validator) {
+    // For template literals, we need to identify the validator type
+    // and return an appropriate capture group pattern
+    const vStr = validator.toString();
+    // Check for specific validator types
+    if (vStr.includes('VldString')) {
+        return '(.+)';
+    }
+    if (vStr.includes('VldNumber')) {
+        return '(-?\\d+(?:\\.\\d+)?)';
+    }
+    if (vStr.includes('VldBigInt')) {
+        return '(-?\\d+)';
+    }
+    if (vStr.includes('VldBoolean')) {
+        return '(true|false)';
+    }
+    if (vStr.includes('VldNull')) {
+        return '(null)';
+    }
+    if (vStr.includes('VldUndefined')) {
+        return '(undefined)';
+    }
+    if (vStr.includes('VldLiteral')) {
+        // Extract literal value from validator
+        const match = vStr.match(/value:\s*['"`]([^'"`]+)['"`]/);
+        if (match) {
+            return '(' + match[1].replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + ')';
+        }
+    }
+    // Default: match any string
+    return '(.+)';
+}
+/**
+ * Helper function to create template literal validators
+ * Usage: v.templateLiteral(v.string(), '-', v.number())
+ */
+export function templateLiteral(...components) {
+    return VldTemplateLiteral.create(...components);
+}
+//# sourceMappingURL=template-literal.js.map

package/dist/validators/template-literal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-literal.js","sourceRoot":"","sources":["../../src/validators/template-literal.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Template literal component types\n */\ntype TLComponent = VldBase<any, any> | string;\n\n/**\n * Immutable template literal validator\n * Validates strings matching a template pattern\n */\nexport class VldTemplateLiteral extends VldBase<unknown, string> {\n  private constructor(\n    private readonly pattern: RegExp\n  ) {\n    super();\n  }\n\n  /**\n   * Create a template literal validator from components\n   */\n  static create(...components: TLComponent[]): VldTemplateLiteral {\n    // Build regex pattern from components\n    let pattern = '^';\n\n    for (const comp of components) {\n      if (typeof comp === 'string') {\n        // Escape special regex characters\n        pattern += comp.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n      } else {\n        // Add appropriate pattern based on validator type\n        pattern += getPatternForValidator(comp);\n      }\n    }\n\n    pattern += '$';\n\n    return new VldTemplateLiteral(new RegExp(pattern));\n  }\n\n  /**\n   * Parse and validate a template literal string\n   */\n  parse(value: unknown): string {\n    if (typeof value !== 'string') {\n      throw new Error(getMessages().invalidString);\n    }\n\n    if (!this.pattern.test(value)) {\n      throw new Error(getMessages().stringPatternInvalid);\n    }\n\n    return value;\n  }\n\n  /**\n   * Safely parse and validate a template literal string\n   */\n  safeParse(value: unknown): ParseResult<string> {\n    try {\n      return { success: true, data: this.parse(value) };\n    } catch (error) {\n      return {\n        success: false,\n        error: error as Error\n      };\n    }\n  }\n}\n\n/**\n * Get regex pattern for a validator type\n */\nfunction getPatternForValidator(validator: VldBase<any, any>): string {\n  // For template literals, we need to identify the validator type\n  // and return an appropriate capture group pattern\n\n  const vStr = validator.toString();\n\n  // Check for specific validator types\n  if (vStr.includes('VldString')) {\n    return '(.+)';\n  }\n  if (vStr.includes('VldNumber')) {\n    return '(-?\\\\d+(?:\\\\.\\\\d+)?)';\n  }\n  if (vStr.includes('VldBigInt')) {\n    return '(-?\\\\d+)';\n  }\n  if (vStr.includes('VldBoolean')) {\n    return '(true|false)';\n  }\n  if (vStr.includes('VldNull')) {\n    return '(null)';\n  }\n  if (vStr.includes('VldUndefined')) {\n    return '(undefined)';\n  }\n  if (vStr.includes('VldLiteral')) {\n    // Extract literal value from validator\n    const match = vStr.match(/value:\\s*['\"`]([^'\"`]+)['\"`]/);\n    if (match) {\n      return '(' + match[1].replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&') + ')';\n    }\n  }\n\n  // Default: match any string\n  return '(.+)';\n}\n\n/**\n * Helper function to create template literal validators\n * Usage: v.templateLiteral(v.string(), '-', v.number())\n */\nexport function templateLiteral(...components: TLComponent[]): VldTemplateLiteral {\n  return VldTemplateLiteral.create(...components);\n}\n"]}

package/dist/validators/tuple.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Immutable tuple validator for fixed-length arrays
  */

package/dist/validators/uint8array.d.ts

@@ -1,25 +1,42 @@
 import { VldBase, ParseResult } from './base';
 /**
- * Uint8Array validator
+ * Configuration for Uint8Array validator
+ * BUG-NEW-010 FIX: Use config object pattern for immutability
+ */
+interface Uint8ArrayValidatorConfig {
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly exactLength?: number;
+}
+/**
+ * Uint8Array validator with immutable configuration
+ * BUG-NEW-010 FIX: Refactored to follow immutability pattern
  */
 export declare class VldUint8Array extends VldBase<Uint8Array, Uint8Array> {
-    private minLength?;
-    private maxLength?;
-    private exactLength?;
+    private readonly config;
+    /**
+     * Protected constructor to maintain immutability
+     */
+    protected constructor(config?: Uint8ArrayValidatorConfig);
     parse(value: unknown): Uint8Array;
     safeParse(value: unknown): ParseResult<Uint8Array>;
     /**
      * Set minimum byte length
+     * Returns new immutable validator instance
      */
     min(length: number): VldUint8Array;
     /**
      * Set maximum byte length
+     * Returns new immutable validator instance
      */
     max(length: number): VldUint8Array;
     /**
      * Set exact byte length
+     * Returns new immutable validator instance
+     * Clears min/max when setting exact length
      */
     length(length: number): VldUint8Array;
     static create(): VldUint8Array;
 }
+export {};
 //# sourceMappingURL=uint8array.d.ts.map

package/dist/validators/uint8array.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uint8array.d.ts","sourceRoot":"","sources":["../../src/validators/uint8array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI9C;;GAEG;AACH,qBAAa,aAAc,SAAQ,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC;IAChE,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU;IAQjC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC;IA2ClD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAQlC;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAQlC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAQrC,MAAM,CAAC,MAAM,IAAI,aAAa;CAG/B"}
+{"version":3,"file":"uint8array.d.ts","sourceRoot":"","sources":["../../src/validators/uint8array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI9C;;;GAGG;AACH,UAAU,yBAAyB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD;;OAEG;IACH,SAAS,aAAa,MAAM,CAAC,EAAE,yBAAyB;IAKxD,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU;IAQjC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC;IA2ClD;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAOlC;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAOlC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IASrC,MAAM,CAAC,MAAM,IAAI,aAAa;CAG/B"}

package/dist/validators/uint8array.js

@@ -1,10 +1,18 @@
 import { VldBase } from './base.js';
 import { VldError, createIssue } from '../errors.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
- * Uint8Array validator
+ * Uint8Array validator with immutable configuration
+ * BUG-NEW-010 FIX: Refactored to follow immutability pattern
  */
 export class VldUint8Array extends VldBase {
+    /**
+     * Protected constructor to maintain immutability
+     */
+    constructor(config) {
+        super();
+        this.config = config || {};
+    }
     parse(value) {
         const result = this.safeParse(value);
         if (!result.success) {
@@ -22,29 +30,29 @@ export class VldUint8Array extends VldBase {
             };
         }
         // Check exact length if specified
-        if (this.exactLength !== undefined && value.length !== this.exactLength) {
+        if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {
             return {
                 success: false,
                 error: new VldError([
-                    createIssue('custom', [], getMessages().uint8ArrayExactLength(this.exactLength))
+                    createIssue('custom', [], getMessages().uint8ArrayExactLength(this.config.exactLength))
                 ])
             };
         }
         // Check minimum length
-        if (this.minLength !== undefined && value.length < this.minLength) {
+        if (this.config.minLength !== undefined && value.length < this.config.minLength) {
             return {
                 success: false,
                 error: new VldError([
-                    createIssue('custom', [], getMessages().uint8ArrayMinLength(this.minLength))
+                    createIssue('custom', [], getMessages().uint8ArrayMinLength(this.config.minLength))
                 ])
             };
         }
         // Check maximum length
-        if (this.maxLength !== undefined && value.length > this.maxLength) {
+        if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {
             return {
                 success: false,
                 error: new VldError([
-                    createIssue('custom', [], getMessages().uint8ArrayMaxLength(this.maxLength))
+                    createIssue('custom', [], getMessages().uint8ArrayMaxLength(this.config.maxLength))
                 ])
             };
         }
@@ -52,33 +60,36 @@ export class VldUint8Array extends VldBase {
     }
     /**
      * Set minimum byte length
+     * Returns new immutable validator instance
      */
     min(length) {
-        const validator = new VldUint8Array();
-        validator.minLength = length;
-        validator.maxLength = this.maxLength;
-        validator.exactLength = this.exactLength;
-        return validator;
+        return new VldUint8Array({
+            ...this.config,
+            minLength: length
+        });
     }
     /**
      * Set maximum byte length
+     * Returns new immutable validator instance
      */
     max(length) {
-        const validator = new VldUint8Array();
-        validator.minLength = this.minLength;
-        validator.maxLength = length;
-        validator.exactLength = this.exactLength;
-        return validator;
+        return new VldUint8Array({
+            ...this.config,
+            maxLength: length
+        });
     }
     /**
      * Set exact byte length
+     * Returns new immutable validator instance
+     * Clears min/max when setting exact length
      */
     length(length) {
-        const validator = new VldUint8Array();
-        validator.minLength = this.minLength;
-        validator.maxLength = this.maxLength;
-        validator.exactLength = length;
-        return validator;
+        return new VldUint8Array({
+            exactLength: length,
+            // Clear min/max when exact length is set
+            minLength: undefined,
+            maxLength: undefined
+        });
     }
     static create() {
         return new VldUint8Array();

package/dist/validators/uint8array.js.map

@@ -1 +1 @@
-{"version":3,"file":"uint8array.js","sourceRoot":"","sources":["../../src/validators/uint8array.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { VldError, createIssue } from '../errors';\nimport { getMessages } from '../locales';\n\n/**\n * Uint8Array validator\n */\nexport class VldUint8Array extends VldBase<Uint8Array, Uint8Array> {\n  private minLength?: number;\n  private maxLength?: number;\n  private exactLength?: number;\n  \n  parse(value: unknown): Uint8Array {\n    const result = this.safeParse(value);\n    if (!result.success) {\n      throw result.error;\n    }\n    return result.data;\n  }\n  \n  safeParse(value: unknown): ParseResult<Uint8Array> {\n    if (!(value instanceof Uint8Array)) {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('invalid_type', [], getMessages().expectedUint8Array)\n        ])\n      };\n    }\n    \n    // Check exact length if specified\n    if (this.exactLength !== undefined && value.length !== this.exactLength) {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('custom', [], getMessages().uint8ArrayExactLength(this.exactLength))\n        ])\n      };\n    }\n    \n    // Check minimum length\n    if (this.minLength !== undefined && value.length < this.minLength) {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('custom', [], getMessages().uint8ArrayMinLength(this.minLength))\n        ])\n      };\n    }\n    \n    // Check maximum length\n    if (this.maxLength !== undefined && value.length > this.maxLength) {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('custom', [], getMessages().uint8ArrayMaxLength(this.maxLength))\n        ])\n      };\n    }\n    \n    return { success: true, data: value };\n  }\n  \n  /**\n   * Set minimum byte length\n   */\n  min(length: number): VldUint8Array {\n    const validator = new VldUint8Array();\n    validator.minLength = length;\n    validator.maxLength = this.maxLength;\n    validator.exactLength = this.exactLength;\n    return validator;\n  }\n  \n  /**\n   * Set maximum byte length\n   */\n  max(length: number): VldUint8Array {\n    const validator = new VldUint8Array();\n    validator.minLength = this.minLength;\n    validator.maxLength = length;\n    validator.exactLength = this.exactLength;\n    return validator;\n  }\n  \n  /**\n   * Set exact byte length\n   */\n  length(length: number): VldUint8Array {\n    const validator = new VldUint8Array();\n    validator.minLength = this.minLength;\n    validator.maxLength = this.maxLength;\n    validator.exactLength = length;\n    return validator;\n  }\n  \n  static create(): VldUint8Array {\n    return new VldUint8Array();\n  }\n}"]}
+{"version":3,"file":"uint8array.js","sourceRoot":"","sources":["../../src/validators/uint8array.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { VldError, createIssue } from '../errors';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Configuration for Uint8Array validator\r\n * BUG-NEW-010 FIX: Use config object pattern for immutability\r\n */\r\ninterface Uint8ArrayValidatorConfig {\r\n  readonly minLength?: number;\r\n  readonly maxLength?: number;\r\n  readonly exactLength?: number;\r\n}\r\n\r\n/**\r\n * Uint8Array validator with immutable configuration\r\n * BUG-NEW-010 FIX: Refactored to follow immutability pattern\r\n */\r\nexport class VldUint8Array extends VldBase<Uint8Array, Uint8Array> {\r\n  private readonly config: Uint8ArrayValidatorConfig;\r\n\r\n  /**\r\n   * Protected constructor to maintain immutability\r\n   */\r\n  protected constructor(config?: Uint8ArrayValidatorConfig) {\r\n    super();\r\n    this.config = config || {};\r\n  }\r\n\r\n  parse(value: unknown): Uint8Array {\r\n    const result = this.safeParse(value);\r\n    if (!result.success) {\r\n      throw result.error;\r\n    }\r\n    return result.data;\r\n  }\r\n\r\n  safeParse(value: unknown): ParseResult<Uint8Array> {\r\n    if (!(value instanceof Uint8Array)) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('invalid_type', [], getMessages().expectedUint8Array)\r\n        ])\r\n      };\r\n    }\r\n\r\n    // Check exact length if specified\r\n    if (this.config.exactLength !== undefined && value.length !== this.config.exactLength) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().uint8ArrayExactLength(this.config.exactLength))\r\n        ])\r\n      };\r\n    }\r\n\r\n    // Check minimum length\r\n    if (this.config.minLength !== undefined && value.length < this.config.minLength) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().uint8ArrayMinLength(this.config.minLength))\r\n        ])\r\n      };\r\n    }\r\n\r\n    // Check maximum length\r\n    if (this.config.maxLength !== undefined && value.length > this.config.maxLength) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().uint8ArrayMaxLength(this.config.maxLength))\r\n        ])\r\n      };\r\n    }\r\n\r\n    return { success: true, data: value };\r\n  }\r\n\r\n  /**\r\n   * Set minimum byte length\r\n   * Returns new immutable validator instance\r\n   */\r\n  min(length: number): VldUint8Array {\r\n    return new VldUint8Array({\r\n      ...this.config,\r\n      minLength: length\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Set maximum byte length\r\n   * Returns new immutable validator instance\r\n   */\r\n  max(length: number): VldUint8Array {\r\n    return new VldUint8Array({\r\n      ...this.config,\r\n      maxLength: length\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Set exact byte length\r\n   * Returns new immutable validator instance\r\n   * Clears min/max when setting exact length\r\n   */\r\n  length(length: number): VldUint8Array {\r\n    return new VldUint8Array({\r\n      exactLength: length,\r\n      // Clear min/max when exact length is set\r\n      minLength: undefined,\r\n      maxLength: undefined\r\n    });\r\n  }\r\n\r\n  static create(): VldUint8Array {\r\n    return new VldUint8Array();\r\n  }\r\n}\r\n"]}

package/dist/validators/undefined.d.ts

@@ -0,0 +1,16 @@
+/**
+ * VldUndefined - Validates that a value is exactly undefined
+ * Part of Zod 4 API parity implementation
+ */
+import { VldBase } from './base';
+import type { ParseResult } from './base';
+/**
+ * Undefined validator - validates that a value is exactly undefined
+ */
+export declare class VldUndefined extends VldBase<unknown, undefined> {
+    private constructor();
+    static create(): VldUndefined;
+    parse(value: unknown): undefined;
+    safeParse(value: unknown): ParseResult<undefined>;
+}
+//# sourceMappingURL=undefined.d.ts.map

package/dist/validators/undefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undefined.d.ts","sourceRoot":"","sources":["../../src/validators/undefined.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C;;GAEG;AACH,qBAAa,YAAa,SAAQ,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;IAC3D,OAAO;IAIP,MAAM,CAAC,MAAM,IAAI,YAAY;IAI7B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS;IAOhC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC;CAOlD"}

package/dist/validators/undefined.js

@@ -0,0 +1,31 @@
+/**
+ * VldUndefined - Validates that a value is exactly undefined
+ * Part of Zod 4 API parity implementation
+ */
+import { VldBase } from './base.js';
+/**
+ * Undefined validator - validates that a value is exactly undefined
+ */
+export class VldUndefined extends VldBase {
+    constructor() {
+        super();
+    }
+    static create() {
+        return new VldUndefined();
+    }
+    parse(value) {
+        if (value !== undefined) {
+            throw new Error(`Expected undefined, received ${typeof value}`);
+        }
+        return undefined;
+    }
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    }
+}
+//# sourceMappingURL=undefined.js.map

package/dist/validators/undefined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undefined.js","sourceRoot":"","sources":["../../src/validators/undefined.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGjC;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,OAA2B;IAC3D;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,YAAY,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAc,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * VldUndefined - Validates that a value is exactly undefined\n * Part of Zod 4 API parity implementation\n */\n\nimport { VldBase } from './base';\nimport type { ParseResult } from './base';\n\n/**\n * Undefined validator - validates that a value is exactly undefined\n */\nexport class VldUndefined extends VldBase<unknown, undefined> {\n  private constructor() {\n    super();\n  }\n\n  static create(): VldUndefined {\n    return new VldUndefined();\n  }\n\n  parse(value: unknown): undefined {\n    if (value !== undefined) {\n      throw new Error(`Expected undefined, received ${typeof value}`);\n    }\n    return undefined;\n  }\n\n  safeParse(value: unknown): ParseResult<undefined> {\n    try {\n      return { success: true, data: this.parse(value) };\n    } catch (error) {\n      return { success: false, error: error as Error };\n    }\n  }\n}\n"]}

package/dist/validators/union.d.ts

@@ -23,11 +23,13 @@ export declare class VldUnion<T extends readonly VldBase<any, any>[]> extends Vl
     /**
      * Parse and validate a value against union options
      * Optimized with type checking and safeParse to avoid try-catch overhead
+     * BUG-NEW-013 FIX: Single-pass error collection to avoid double parsing
      */
     parse(value: unknown): T[number] extends VldBase<any, infer U> ? U : never;
     /**
      * Safely parse and validate a value against union options
      * Optimized version using type checking shortcuts
+     * BUG-NEW-013 FIX: Single-pass error collection to avoid double parsing
      */
     safeParse(value: unknown): ParseResult<T[number] extends VldBase<any, infer U> ? U : never>;
 }

package/dist/validators/union.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/validators/union.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAE,SAAQ,OAAO,CAC3E,OAAO,EACP,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CACpD;IACC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAI;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IAGvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsD;IAEnF;;OAEG;IACH,OAAO;IAeP;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAIpF;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;IAgC1E;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CAiC5F"}
+{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/validators/union.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAE,SAAQ,OAAO,CAC3E,OAAO,EACP,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CACpD;IACC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAI;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IAGvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsD;IAEnF;;OAEG;IACH,OAAO;IAeP;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgDzB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAIpF;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;IA6B1E;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CA8B5F"}

package/dist/validators/union.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Optimized immutable union validator for multiple type options
  * Features type-checking shortcuts for 110x performance improvement
@@ -71,12 +71,14 @@ export class VldUnion extends VldBase {
     /**
      * Parse and validate a value against union options
      * Optimized with type checking and safeParse to avoid try-catch overhead
+     * BUG-NEW-013 FIX: Single-pass error collection to avoid double parsing
      */
     parse(value) {
-        // Fast path: try validators that are likely to match based on type
+        // Single pass: collect errors during validation
+        const errors = [];
         for (const validator of this.validators) {
             const typeChecker = this.typeCheckers.get(validator);
-            // Skip validators that definitely won't match
+            // Skip validators that definitely won't match based on type
             if (typeChecker && !typeChecker(value)) {
                 continue;
             }
@@ -85,27 +87,24 @@ export class VldUnion extends VldBase {
             if (result.success) {
                 return result.data;
             }
+            // Collect error for final message if all validators fail
+            errors.push(result.error.message);
         }
-        // Slow path: collect all errors for better error message
-        const errors = [];
-        for (const validator of this.validators) {
-            const result = validator.safeParse(value);
-            if (!result.success) {
-                errors.push(result.error.message);
-            }
-        }
+        // All validators failed - throw with collected errors
         throw new Error(this.errorMessage ||
             getMessages().unionNoMatch(errors));
     }
     /**
      * Safely parse and validate a value against union options
      * Optimized version using type checking shortcuts
+     * BUG-NEW-013 FIX: Single-pass error collection to avoid double parsing
      */
     safeParse(value) {
-        // Fast path with type checking
+        // Single pass: collect errors during validation
+        const errors = [];
         for (const validator of this.validators) {
             const typeChecker = this.typeCheckers.get(validator);
-            // Skip validators that definitely won't match
+            // Skip validators that definitely won't match based on type
             if (typeChecker && !typeChecker(value)) {
                 continue;
             }
@@ -113,15 +112,10 @@ export class VldUnion extends VldBase {
             if (result.success) {
                 return result;
             }
+            // Collect error for final message if all validators fail
+            errors.push(result.error.message);
         }
-        // All failed - collect errors for message
-        const errors = [];
-        for (const validator of this.validators) {
-            const result = validator.safeParse(value);
-            if (!result.success) {
-                errors.push(result.error.message);
-            }
-        }
+        // All validators failed - return error with collected messages
         return {
             success: false,
             error: new Error(this.errorMessage ||

package/dist/validators/union.js.map

@@ -1 +1 @@
-{"version":3,"file":"union.js","sourceRoot":"","sources":["../../src/validators/union.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Optimized immutable union validator for multiple type options\n * Features type-checking shortcuts for 110x performance improvement\n */\nexport class VldUnion<T extends readonly VldBase<any, any>[]> extends VldBase<\n  unknown,\n  T[number] extends VldBase<any, infer U> ? U : never\n> {\n  private readonly validators: T;\n  private readonly errorMessage?: string;\n  \n  // Cache for type checking optimization\n  private readonly typeCheckers: Map<VldBase<any, any>, (value: unknown) => boolean>;\n  \n  /**\n   * Private constructor to enforce immutability\n   */\n  private constructor(\n    validators: T,\n    errorMessage?: string\n  ) {\n    super();\n    this.validators = validators;\n    this.errorMessage = errorMessage;\n    this.typeCheckers = new Map();\n    \n    // Pre-compile type checkers for common types\n    for (const validator of validators) {\n      this.typeCheckers.set(validator, this.createTypeChecker(validator));\n    }\n  }\n  \n  /**\n   * Create type checker based on validator type for fast path optimization\n   * Uses a safer approach that's less prone to spoofing\n   */\n  private createTypeChecker(validator: VldBase<any, any>): (value: unknown) => boolean {\n    // More conservative approach that prioritizes security and stability\n    // Only use fast path checks for very common, unambiguous types\n\n    try {\n      // Test basic types with safe parsing to validate the validator\n      const stringTest = validator.safeParse('test');\n      if (stringTest.success) {\n        return (v) => typeof v === 'string';\n      }\n\n      const numberTest = validator.safeParse(123);\n      if (numberTest.success) {\n        return (v) => typeof v === 'number' && !isNaN(v as number);\n      }\n\n      const booleanTest = validator.safeParse(true);\n      if (booleanTest.success) {\n        return (v) => typeof v === 'boolean';\n      }\n\n      const arrayTest = validator.safeParse([]);\n      if (arrayTest.success) {\n        return (v) => Array.isArray(v);\n      }\n\n      const objectTest = validator.safeParse({});\n      if (objectTest.success) {\n        return (v) => typeof v === 'object' && v !== null && !Array.isArray(v);\n      }\n\n      const nullTest = validator.safeParse(null);\n      if (nullTest.success) {\n        return (v) => v === null;\n      }\n\n      const undefinedTest = validator.safeParse(undefined);\n      if (undefinedTest.success) {\n        return (v) => v === undefined;\n      }\n    } catch {\n      // If safe testing fails, fall back to safe validation\n    }\n\n    // Fallback: no quick check available - use safe validation\n    return () => true;\n  }\n  \n  /**\n   * Create a new union validator\n   */\n  static create<T extends readonly VldBase<any, any>[]>(...validators: T): VldUnion<T> {\n    return new VldUnion(validators);\n  }\n  \n  /**\n   * Parse and validate a value against union options\n   * Optimized with type checking and safeParse to avoid try-catch overhead\n   */\n  parse(value: unknown): T[number] extends VldBase<any, infer U> ? U : never {\n    // Fast path: try validators that are likely to match based on type\n    for (const validator of this.validators) {\n      const typeChecker = this.typeCheckers.get(validator);\n      \n      // Skip validators that definitely won't match\n      if (typeChecker && !typeChecker(value)) {\n        continue;\n      }\n      \n      // Use safeParse to avoid try-catch overhead\n      const result = validator.safeParse(value);\n      if (result.success) {\n        return result.data;\n      }\n    }\n    \n    // Slow path: collect all errors for better error message\n    const errors: string[] = [];\n    for (const validator of this.validators) {\n      const result = validator.safeParse(value);\n      if (!result.success) {\n        errors.push(result.error.message);\n      }\n    }\n    \n    throw new Error(\n      this.errorMessage || \n      getMessages().unionNoMatch(errors)\n    );\n  }\n  \n  /**\n   * Safely parse and validate a value against union options\n   * Optimized version using type checking shortcuts\n   */\n  safeParse(value: unknown): ParseResult<T[number] extends VldBase<any, infer U> ? U : never> {\n    // Fast path with type checking\n    for (const validator of this.validators) {\n      const typeChecker = this.typeCheckers.get(validator);\n      \n      // Skip validators that definitely won't match\n      if (typeChecker && !typeChecker(value)) {\n        continue;\n      }\n      \n      const result = validator.safeParse(value);\n      if (result.success) {\n        return result;\n      }\n    }\n    \n    // All failed - collect errors for message\n    const errors: string[] = [];\n    for (const validator of this.validators) {\n      const result = validator.safeParse(value);\n      if (!result.success) {\n        errors.push(result.error.message);\n      }\n    }\n    \n    return {\n      success: false,\n      error: new Error(\n        this.errorMessage || \n        getMessages().unionNoMatch(errors)\n      )\n    };\n  }\n}"]}
+{"version":3,"file":"union.js","sourceRoot":"","sources":["../../src/validators/union.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Optimized immutable union validator for multiple type options\r\n * Features type-checking shortcuts for 110x performance improvement\r\n */\r\nexport class VldUnion<T extends readonly VldBase<any, any>[]> extends VldBase<\r\n  unknown,\r\n  T[number] extends VldBase<any, infer U> ? U : never\r\n> {\r\n  private readonly validators: T;\r\n  private readonly errorMessage?: string;\r\n  \r\n  // Cache for type checking optimization\r\n  private readonly typeCheckers: Map<VldBase<any, any>, (value: unknown) => boolean>;\r\n  \r\n  /**\r\n   * Private constructor to enforce immutability\r\n   */\r\n  private constructor(\r\n    validators: T,\r\n    errorMessage?: string\r\n  ) {\r\n    super();\r\n    this.validators = validators;\r\n    this.errorMessage = errorMessage;\r\n    this.typeCheckers = new Map();\r\n    \r\n    // Pre-compile type checkers for common types\r\n    for (const validator of validators) {\r\n      this.typeCheckers.set(validator, this.createTypeChecker(validator));\r\n    }\r\n  }\r\n  \r\n  /**\r\n   * Create type checker based on validator type for fast path optimization\r\n   * Uses a safer approach that's less prone to spoofing\r\n   */\r\n  private createTypeChecker(validator: VldBase<any, any>): (value: unknown) => boolean {\r\n    // More conservative approach that prioritizes security and stability\r\n    // Only use fast path checks for very common, unambiguous types\r\n\r\n    try {\r\n      // Test basic types with safe parsing to validate the validator\r\n      const stringTest = validator.safeParse('test');\r\n      if (stringTest.success) {\r\n        return (v) => typeof v === 'string';\r\n      }\r\n\r\n      const numberTest = validator.safeParse(123);\r\n      if (numberTest.success) {\r\n        return (v) => typeof v === 'number' && !isNaN(v as number);\r\n      }\r\n\r\n      const booleanTest = validator.safeParse(true);\r\n      if (booleanTest.success) {\r\n        return (v) => typeof v === 'boolean';\r\n      }\r\n\r\n      const arrayTest = validator.safeParse([]);\r\n      if (arrayTest.success) {\r\n        return (v) => Array.isArray(v);\r\n      }\r\n\r\n      const objectTest = validator.safeParse({});\r\n      if (objectTest.success) {\r\n        return (v) => typeof v === 'object' && v !== null && !Array.isArray(v);\r\n      }\r\n\r\n      const nullTest = validator.safeParse(null);\r\n      if (nullTest.success) {\r\n        return (v) => v === null;\r\n      }\r\n\r\n      const undefinedTest = validator.safeParse(undefined);\r\n      if (undefinedTest.success) {\r\n        return (v) => v === undefined;\r\n      }\r\n    } catch {\r\n      // If safe testing fails, fall back to safe validation\r\n    }\r\n\r\n    // Fallback: no quick check available - use safe validation\r\n    return () => true;\r\n  }\r\n  \r\n  /**\r\n   * Create a new union validator\r\n   */\r\n  static create<T extends readonly VldBase<any, any>[]>(...validators: T): VldUnion<T> {\r\n    return new VldUnion(validators);\r\n  }\r\n  \r\n  /**\r\n   * Parse and validate a value against union options\r\n   * Optimized with type checking and safeParse to avoid try-catch overhead\r\n   * BUG-NEW-013 FIX: Single-pass error collection to avoid double parsing\r\n   */\r\n  parse(value: unknown): T[number] extends VldBase<any, infer U> ? U : never {\r\n    // Single pass: collect errors during validation\r\n    const errors: string[] = [];\r\n\r\n    for (const validator of this.validators) {\r\n      const typeChecker = this.typeCheckers.get(validator);\r\n\r\n      // Skip validators that definitely won't match based on type\r\n      if (typeChecker && !typeChecker(value)) {\r\n        continue;\r\n      }\r\n\r\n      // Use safeParse to avoid try-catch overhead\r\n      const result = validator.safeParse(value);\r\n      if (result.success) {\r\n        return result.data;\r\n      }\r\n\r\n      // Collect error for final message if all validators fail\r\n      errors.push(result.error.message);\r\n    }\r\n\r\n    // All validators failed - throw with collected errors\r\n    throw new Error(\r\n      this.errorMessage ||\r\n      getMessages().unionNoMatch(errors)\r\n    );\r\n  }\r\n  \r\n  /**\r\n   * Safely parse and validate a value against union options\r\n   * Optimized version using type checking shortcuts\r\n   * BUG-NEW-013 FIX: Single-pass error collection to avoid double parsing\r\n   */\r\n  safeParse(value: unknown): ParseResult<T[number] extends VldBase<any, infer U> ? U : never> {\r\n    // Single pass: collect errors during validation\r\n    const errors: string[] = [];\r\n\r\n    for (const validator of this.validators) {\r\n      const typeChecker = this.typeCheckers.get(validator);\r\n\r\n      // Skip validators that definitely won't match based on type\r\n      if (typeChecker && !typeChecker(value)) {\r\n        continue;\r\n      }\r\n\r\n      const result = validator.safeParse(value);\r\n      if (result.success) {\r\n        return result;\r\n      }\r\n\r\n      // Collect error for final message if all validators fail\r\n      errors.push(result.error.message);\r\n    }\r\n\r\n    // All validators failed - return error with collected messages\r\n    return {\r\n      success: false,\r\n      error: new Error(\r\n        this.errorMessage ||\r\n        getMessages().unionNoMatch(errors)\r\n      )\r\n    };\r\n  }\r\n}"]}

package/dist/validators/void.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Validator that only accepts undefined
  */

package/dist/validators/xor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * VldXor - Exclusive union validator
+ * Part of Zod 4 API parity implementation
+ * Ensures exactly one schema in the union matches
+ */
+import { VldBase } from './base';
+import type { ParseResult } from './base';
+/**
+ * XOR validator - ensures exactly one option matches
+ * Unlike regular union which allows multiple matches, XOR requires exactly one
+ */
+export declare class VldXor<Options extends VldBase<any, any>[]> extends VldBase<unknown, Options[number] extends VldBase<any, infer T> ? T : never> {
+    private readonly _options;
+    constructor(_options: Options);
+    static create<Options extends VldBase<any, any>[]>(options: Options): VldXor<Options>;
+    parse(value: unknown): Options[number] extends VldBase<any, infer T> ? T : never;
+    safeParse(value: unknown): ParseResult<Options[number] extends VldBase<any, infer T> ? T : never>;
+    /**
+     * Get all options
+     */
+    getOptions(): Options;
+}
+//# sourceMappingURL=xor.d.ts.map

package/dist/validators/xor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xor.d.ts","sourceRoot":"","sources":["../../src/validators/xor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE1C;;;GAGG;AACH,qBAAa,MAAM,CAAC,OAAO,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAE,SAAQ,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC9H,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,OAAO;IAI9C,MAAM,CAAC,MAAM,CAAC,OAAO,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAC/C,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,OAAO,CAAC;IAOlB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;IAQhF,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAmCjG;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/validators/xor.js

@@ -0,0 +1,64 @@
+/**
+ * VldXor - Exclusive union validator
+ * Part of Zod 4 API parity implementation
+ * Ensures exactly one schema in the union matches
+ */
+import { VldBase } from './base.js';
+/**
+ * XOR validator - ensures exactly one option matches
+ * Unlike regular union which allows multiple matches, XOR requires exactly one
+ */
+export class VldXor extends VldBase {
+    constructor(_options) {
+        super();
+        this._options = _options;
+    }
+    static create(options) {
+        if (options.length < 2) {
+            throw new Error('XOR requires at least 2 options');
+        }
+        return new VldXor(options);
+    }
+    parse(value) {
+        const result = this.safeParse(value);
+        if (!result.success) {
+            throw result.error;
+        }
+        return result.data;
+    }
+    safeParse(value) {
+        let matchCount = 0;
+        let lastSuccess = null;
+        for (const option of this._options) {
+            const result = option.safeParse(value);
+            if (result.success) {
+                matchCount++;
+                lastSuccess = result;
+                if (matchCount > 1) {
+                    // Early exit if more than one match
+                    break;
+                }
+            }
+        }
+        if (matchCount === 0) {
+            return {
+                success: false,
+                error: new Error('No schema matched in XOR union')
+            };
+        }
+        if (matchCount > 1) {
+            return {
+                success: false,
+                error: new Error(`Input matches ${matchCount} schemas in XOR union, but exactly one is required`)
+            };
+        }
+        return lastSuccess;
+    }
+    /**
+     * Get all options
+     */
+    getOptions() {
+        return this._options;
+    }
+}
+//# sourceMappingURL=xor.js.map