@oxog/vld 1.3.1 → 1.4.0

package/dist/validators/discriminated-union.js

@@ -0,0 +1,98 @@
+/**
+ * VldDiscriminatedUnion - Fast union validation using discriminator field
+ * Part of Zod 4 API parity implementation
+ * Provides O(1) lookup performance by using a discriminator key
+ */
+import { VldBase } from './base.js';
+import { VldObject } from './object.js';
+import { VldLiteral } from './literal.js';
+import { VldEnum } from './enum.js';
+/**
+ * Extract literal values from a schema
+ */
+function extractLiteralValues(schema) {
+    if (schema instanceof VldLiteral) {
+        const value = schema.literal;
+        return [value];
+    }
+    if (schema instanceof VldEnum) {
+        return schema.values;
+    }
+    throw new Error('Discriminator must be a literal or enum schema');
+}
+/**
+ * Discriminated union validator - validates union based on discriminator key
+ * Much faster than regular union when you have a discriminator field
+ */
+export class VldDiscriminatedUnion extends VldBase {
+    constructor(_discriminator, _options) {
+        super();
+        this._discriminator = _discriminator;
+        this._options = _options;
+        // Build discriminator map for O(1) lookup
+        this._discriminatorMap = new Map();
+        for (const option of _options) {
+            if (!(option instanceof VldObject)) {
+                throw new Error('All options in a discriminated union must be objects');
+            }
+            const discriminatorSchema = option.config?.shape?.[this._discriminator];
+            if (!discriminatorSchema) {
+                throw new Error(`Missing discriminator key "${this._discriminator}" in one of the options`);
+            }
+            const values = extractLiteralValues(discriminatorSchema);
+            for (const value of values) {
+                if (this._discriminatorMap.has(value)) {
+                    throw new Error(`Duplicate discriminator value "${String(value)}" found in discriminated union`);
+                }
+                this._discriminatorMap.set(value, option);
+            }
+        }
+    }
+    static create(discriminator, options) {
+        return new VldDiscriminatedUnion(discriminator, options);
+    }
+    parse(value) {
+        const result = this.safeParse(value);
+        if (!result.success) {
+            throw result.error;
+        }
+        return result.data;
+    }
+    safeParse(value) {
+        // Check if input is an object
+        if (typeof value !== 'object' || value === null) {
+            return {
+                success: false,
+                error: new Error(`Expected object, received ${value === null ? 'null' : typeof value}`)
+            };
+        }
+        // Get discriminator value
+        const discriminatorValue = value[this._discriminator];
+        // Look up matching schema
+        const matchedSchema = this._discriminatorMap.get(discriminatorValue);
+        if (!matchedSchema) {
+            const validValues = Array.from(this._discriminatorMap.keys());
+            return {
+                success: false,
+                error: new Error(`Invalid discriminator value for "${this._discriminator}". ` +
+                    `Expected one of: ${JSON.stringify(validValues)}, ` +
+                    `received: ${JSON.stringify(discriminatorValue)}`)
+            };
+        }
+        // Validate against matched schema
+        return matchedSchema.safeParse(value);
+    }
+    /**
+     * Get the discriminator key
+     */
+    getDiscriminator() {
+        return this._discriminator;
+    }
+    /**
+     * Get all options
+     */
+    getOptions() {
+        return this._options;
+    }
+}
+//# sourceMappingURL=discriminated-union.js.map

package/dist/validators/discriminated-union.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminated-union.js","sourceRoot":"","sources":["../../src/validators/discriminated-union.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * VldDiscriminatedUnion - Fast union validation using discriminator field\n * Part of Zod 4 API parity implementation\n * Provides O(1) lookup performance by using a discriminator key\n */\n\nimport { VldBase } from './base';\nimport { VldObject } from './object';\nimport { VldLiteral } from './literal';\nimport { VldEnum } from './enum';\nimport type { ParseResult } from './base';\n\n/**\n * Extract literal values from a schema\n */\nfunction extractLiteralValues(schema: VldBase<unknown, any>): unknown[] {\n  if (schema instanceof VldLiteral) {\n    const value = (schema as any).literal;\n    return [value];\n  }\n  if (schema instanceof VldEnum) {\n    return (schema as any).values as unknown[];\n  }\n  throw new Error('Discriminator must be a literal or enum schema');\n}\n\n/**\n * Discriminated union validator - validates union based on discriminator key\n * Much faster than regular union when you have a discriminator field\n */\nexport class VldDiscriminatedUnion<K extends string, Options extends VldBase<any, any>[]>\n  extends VldBase<unknown, Options[number] extends VldBase<any, infer T> ? T : never> {\n\n  private readonly _discriminatorMap: Map<unknown, VldBase<any, any>>;\n\n  constructor(\n    private readonly _discriminator: K,\n    private readonly _options: Options\n  ) {\n    super();\n\n    // Build discriminator map for O(1) lookup\n    this._discriminatorMap = new Map();\n\n    for (const option of _options) {\n      if (!(option instanceof VldObject)) {\n        throw new Error('All options in a discriminated union must be objects');\n      }\n\n      const discriminatorSchema = (option as any).config?.shape?.[this._discriminator];\n      if (!discriminatorSchema) {\n        throw new Error(`Missing discriminator key \"${this._discriminator}\" in one of the options`);\n      }\n\n      const values = extractLiteralValues(discriminatorSchema);\n\n      for (const value of values) {\n        if (this._discriminatorMap.has(value)) {\n          throw new Error(`Duplicate discriminator value \"${String(value)}\" found in discriminated union`);\n        }\n        this._discriminatorMap.set(value, option);\n      }\n    }\n  }\n\n  static create<K extends string, Options extends VldBase<any, any>[]>(\n    discriminator: K,\n    options: Options\n  ): VldDiscriminatedUnion<K, Options> {\n    return new VldDiscriminatedUnion(discriminator, options);\n  }\n\n  parse(value: unknown): Options[number] extends VldBase<any, infer T> ? T : never {\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<Options[number] extends VldBase<any, infer T> ? T : never> {\n    // Check if input is an object\n    if (typeof value !== 'object' || value === null) {\n      return {\n        success: false,\n        error: new Error(\n          `Expected object, received ${value === null ? 'null' : typeof value}`\n        )\n      };\n    }\n\n    // Get discriminator value\n    const discriminatorValue = (value as any)[this._discriminator];\n\n    // Look up matching schema\n    const matchedSchema = this._discriminatorMap.get(discriminatorValue);\n\n    if (!matchedSchema) {\n      const validValues = Array.from(this._discriminatorMap.keys());\n      return {\n        success: false,\n        error: new Error(\n          `Invalid discriminator value for \"${this._discriminator}\". ` +\n          `Expected one of: ${JSON.stringify(validValues)}, ` +\n          `received: ${JSON.stringify(discriminatorValue)}`\n        )\n      };\n    }\n\n    // Validate against matched schema\n    return matchedSchema.safeParse(value) as ParseResult<Options[number] extends VldBase<any, infer T> ? T : never>;\n  }\n\n  /**\n   * Get the discriminator key\n   */\n  getDiscriminator(): K {\n    return this._discriminator;\n  }\n\n  /**\n   * Get all options\n   */\n  getOptions(): Options {\n    return this._options;\n  }\n}\n"]}

package/dist/validators/enum.d.ts

@@ -21,5 +21,15 @@ export declare class VldEnum<T extends readonly [string, ...string[]]> extends V
      * Safely parse and validate an enum value
      */
     safeParse(value: unknown): ParseResult<T[number]>;
+    /**
+     * Exclude specific values from the enum
+     * Creates a new enum validator without the specified values
+     */
+    exclude<const E extends readonly string[]>(...excludeValues: E): VldEnum<T[number] extends E[number] ? never : T[number] extends Exclude<T[number], E[number]> ? T : Exclude<T, E>>;
+    /**
+     * Extract specific values from the enum
+     * Creates a new enum validator with only the specified values
+     */
+    extract<const E extends readonly string[]>(...extractValues: E): VldEnum<[string, ...string[]]>;
 }
 //# sourceMappingURL=enum.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;GAEG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAE,SAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAK7F,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IALhC;;OAEG;IACH,OAAO;IAOP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAUhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;CAYlD"}
+{"version":3,"file":"enum.d.ts","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;GAEG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAE,SAAQ,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAK7F,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IALhC;;OAEG;IACH,OAAO;IAOP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAiBhC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAuBjD;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,GAAG,OAAO,CACtE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1G;IASD;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,GAAG,aAAa,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;CAQhG"}

package/dist/validators/enum.js

@@ -1,5 +1,5 @@
 import { VldBase } from './base.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Immutable enum validator for string enum values
  */
@@ -22,6 +22,11 @@ export class VldEnum extends VldBase {
      * Parse and validate an enum value
      */
     parse(value) {
+        // BUG-002 FIX: Add type check before includes() to prevent type confusion
+        if (typeof value !== 'string') {
+            throw new Error(this.errorMessage ||
+                getMessages().enumExpected([...this.values], JSON.stringify(value)));
+        }
         if (!this.values.includes(value)) {
             throw new Error(this.errorMessage ||
                 getMessages().enumExpected([...this.values], JSON.stringify(value)));
@@ -32,6 +37,14 @@ export class VldEnum extends VldBase {
      * Safely parse and validate an enum value
      */
     safeParse(value) {
+        // BUG-002 FIX: Add type check before includes() to prevent type confusion
+        if (typeof value !== 'string') {
+            return {
+                success: false,
+                error: new Error(this.errorMessage ||
+                    getMessages().enumExpected([...this.values], JSON.stringify(value)))
+            };
+        }
         if (this.values.includes(value)) {
             return { success: true, data: value };
         }
@@ -41,5 +54,29 @@ export class VldEnum extends VldBase {
                 getMessages().enumExpected([...this.values], JSON.stringify(value)))
         };
     }
+    /**
+     * Exclude specific values from the enum
+     * Creates a new enum validator without the specified values
+     */
+    exclude(...excludeValues) {
+        const filtered = this.values.filter(v => !excludeValues.includes(v));
+        if (filtered.length === 0) {
+            throw new Error('Cannot exclude all enum values');
+        }
+        // Type assertion needed because TypeScript can't guarantee the filtered array maintains the required type
+        return new VldEnum(filtered, this.errorMessage);
+    }
+    /**
+     * Extract specific values from the enum
+     * Creates a new enum validator with only the specified values
+     */
+    extract(...extractValues) {
+        const extracted = this.values.filter(v => extractValues.includes(v));
+        if (extracted.length === 0) {
+            throw new Error('Cannot extract non-existent enum values');
+        }
+        // Type assertion needed because TypeScript can't guarantee the extracted array has the required type
+        return new VldEnum(extracted, this.errorMessage);
+    }
 }
 //# sourceMappingURL=enum.js.map

package/dist/validators/enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,OAAkD,SAAQ,OAA0B;IAC/F;;OAEG;IACH,YACmB,MAAS,EACT,YAAqB;QAEtC,KAAK,EAAE,CAAC;QAHS,WAAM,GAAN,MAAM,CAAG;QACT,iBAAY,GAAZ,YAAY,CAAS;IAGxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAA2C,MAAS;QAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAe,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE,CAAC;QACJ,CAAC;QACD,OAAO,KAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAc;QACtB,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAe,CAAC,EAAE,CAAC;YAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAkB,EAAE,CAAC;QACrD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,KAAK,CACd,IAAI,CAAC,YAAY;gBACjB,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CACpE;SACF,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Immutable enum validator for string enum values\n */\nexport class VldEnum<T extends readonly [string, ...string[]]> extends VldBase<string, T[number]> {\n  /**\n   * Private constructor to enforce immutability\n   */\n  private constructor(\n    private readonly values: T,\n    private readonly errorMessage?: string\n  ) {\n    super();\n  }\n  \n  /**\n   * Create a new enum validator\n   */\n  static create<T extends readonly [string, ...string[]]>(values: T): VldEnum<T> {\n    return new VldEnum(values);\n  }\n  \n  /**\n   * Parse and validate an enum value\n   */\n  parse(value: unknown): T[number] {\n    if (!this.values.includes(value as string)) {\n      throw new Error(\n        this.errorMessage || \n        getMessages().enumExpected([...this.values], JSON.stringify(value))\n      );\n    }\n    return value as T[number];\n  }\n  \n  /**\n   * Safely parse and validate an enum value\n   */\n  safeParse(value: unknown): ParseResult<T[number]> {\n    if (this.values.includes(value as string)) {\n      return { success: true, data: value as T[number] };\n    }\n    return { \n      success: false, \n      error: new Error(\n        this.errorMessage || \n        getMessages().enumExpected([...this.values], JSON.stringify(value))\n      )\n    };\n  }\n}"]}
+{"version":3,"file":"enum.js","sourceRoot":"","sources":["../../src/validators/enum.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Immutable enum validator for string enum values\r\n */\r\nexport class VldEnum<T extends readonly [string, ...string[]]> extends VldBase<string, T[number]> {\r\n  /**\r\n   * Private constructor to enforce immutability\r\n   */\r\n  private constructor(\r\n    private readonly values: T,\r\n    private readonly errorMessage?: string\r\n  ) {\r\n    super();\r\n  }\r\n  \r\n  /**\r\n   * Create a new enum validator\r\n   */\r\n  static create<T extends readonly [string, ...string[]]>(values: T): VldEnum<T> {\r\n    return new VldEnum(values);\r\n  }\r\n  \r\n  /**\r\n   * Parse and validate an enum value\r\n   */\r\n  parse(value: unknown): T[number] {\r\n    // BUG-002 FIX: Add type check before includes() to prevent type confusion\r\n    if (typeof value !== 'string') {\r\n      throw new Error(\r\n        this.errorMessage ||\r\n        getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n      );\r\n    }\r\n    if (!this.values.includes(value)) {\r\n      throw new Error(\r\n        this.errorMessage ||\r\n        getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n      );\r\n    }\r\n    return value as T[number];\r\n  }\r\n\r\n  /**\r\n   * Safely parse and validate an enum value\r\n   */\r\n  safeParse(value: unknown): ParseResult<T[number]> {\r\n    // BUG-002 FIX: Add type check before includes() to prevent type confusion\r\n    if (typeof value !== 'string') {\r\n      return {\r\n        success: false,\r\n        error: new Error(\r\n          this.errorMessage ||\r\n          getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n        )\r\n      };\r\n    }\r\n    if (this.values.includes(value)) {\r\n      return { success: true, data: value as T[number] };\r\n    }\r\n    return {\r\n      success: false,\r\n      error: new Error(\r\n        this.errorMessage ||\r\n        getMessages().enumExpected([...this.values], JSON.stringify(value))\r\n      )\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Exclude specific values from the enum\r\n   * Creates a new enum validator without the specified values\r\n   */\r\n  exclude<const E extends readonly string[]>(...excludeValues: E): VldEnum<\r\n    T[number] extends E[number] ? never : T[number] extends Exclude<T[number], E[number]> ? T : Exclude<T, E>\r\n  > {\r\n    const filtered = this.values.filter(v => !excludeValues.includes(v));\r\n    if (filtered.length === 0) {\r\n      throw new Error('Cannot exclude all enum values');\r\n    }\r\n    // Type assertion needed because TypeScript can't guarantee the filtered array maintains the required type\r\n    return new VldEnum(filtered as any, this.errorMessage);\r\n  }\r\n\r\n  /**\r\n   * Extract specific values from the enum\r\n   * Creates a new enum validator with only the specified values\r\n   */\r\n  extract<const E extends readonly string[]>(...extractValues: E): VldEnum<[string, ...string[]]> {\r\n    const extracted = this.values.filter(v => extractValues.includes(v));\r\n    if (extracted.length === 0) {\r\n      throw new Error('Cannot extract non-existent enum values');\r\n    }\r\n    // Type assertion needed because TypeScript can't guarantee the extracted array has the required type\r\n    return new VldEnum(extracted as any, this.errorMessage);\r\n  }\r\n}"]}

package/dist/validators/file.d.ts

@@ -0,0 +1,57 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * File representation for validation
+ * In browsers: File object
+ * In Node.js: Object with size and type properties
+ */
+export type VldFileValue = File | {
+    size: number;
+    type: string;
+    name?: string;
+};
+/**
+ * Immutable file validator for file uploads
+ * Supports size and MIME type validation
+ */
+export declare class VldFile extends VldBase<unknown, VldFileValue> {
+    private readonly checks;
+    private constructor();
+    /**
+     * Create a new file validator
+     */
+    static create(): VldFile;
+    /**
+     * Parse and validate a file value
+     */
+    parse(value: unknown): VldFileValue;
+    /**
+     * Run all validation checks on the file
+     */
+    private runChecks;
+    /**
+     * Safely parse and validate a file value
+     */
+    safeParse(value: unknown): ParseResult<VldFileValue>;
+    /**
+     * Set minimum file size in bytes
+     */
+    min(bytes: number, message?: string): VldFile;
+    /**
+     * Set maximum file size in bytes
+     */
+    max(bytes: number, message?: string): VldFile;
+    /**
+     * Set allowed MIME types
+     */
+    mime(types: string | string[], message?: string): VldFile;
+    /**
+     * Set both minimum and maximum file size
+     */
+    size(min: number, max: number, message?: string): VldFile;
+}
+/**
+ * Helper function to create file validators
+ * Usage: v.file().min(1024).max(10485760).mime(['image/jpeg', 'image/png'])
+ */
+export declare function file(): VldFile;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/validators/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAW9C;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC;IAEvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IADzB,OAAO;IAMP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,OAAO;IAIxB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY;IA2BnC;;OAEG;IACH,OAAO,CAAC,SAAS;IAqCjB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC;IAQpD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAKzD;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;CAG1D;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B"}

package/dist/validators/file.js

@@ -0,0 +1,114 @@
+import { VldBase } from './base.js';
+import { getMessages } from '../locales/index.js';
+/**
+ * Immutable file validator for file uploads
+ * Supports size and MIME type validation
+ */
+export class VldFile extends VldBase {
+    constructor(checks = []) {
+        super();
+        this.checks = checks;
+    }
+    /**
+     * Create a new file validator
+     */
+    static create() {
+        return new VldFile();
+    }
+    /**
+     * Parse and validate a file value
+     */
+    parse(value) {
+        // Check if File API is supported
+        const FileSupported = typeof File !== 'undefined';
+        if (!FileSupported) {
+            throw new Error(getMessages().fileNotSupported || 'File API not supported in this environment');
+        }
+        // Check if value is a File object
+        if (!(value instanceof File)) {
+            // Allow plain object with size and type for Node.js compatibility
+            if (typeof value === 'object' &&
+                value !== null &&
+                'size' in value &&
+                'type' in value) {
+                const fileObj = value;
+                return this.runChecks(fileObj);
+            }
+            throw new Error(getMessages().invalidFile || 'Expected a File object');
+        }
+        return this.runChecks(value);
+    }
+    /**
+     * Run all validation checks on the file
+     */
+    runChecks(file) {
+        const msgs = getMessages();
+        for (const check of this.checks) {
+            switch (check.type) {
+                case 'min':
+                    if (file.size < check.value) {
+                        throw new Error(check.message ||
+                            (msgs.fileMinSize?.(check.value) || `File size must be at least ${check.value} bytes`));
+                    }
+                    break;
+                case 'max':
+                    if (file.size > check.value) {
+                        throw new Error(check.message ||
+                            (msgs.fileMaxSize?.(check.value) || `File size must not exceed ${check.value} bytes`));
+                    }
+                    break;
+                case 'mime':
+                    if (!check.value.includes(file.type)) {
+                        throw new Error(check.message ||
+                            (msgs.fileMimeType?.(check.value) || `Invalid file type. Expected: ${check.value.join(', ')}`));
+                    }
+                    break;
+            }
+        }
+        return file;
+    }
+    /**
+     * Safely parse and validate a file value
+     */
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    }
+    /**
+     * Set minimum file size in bytes
+     */
+    min(bytes, message) {
+        return new VldFile([...this.checks, { type: 'min', value: bytes, message }]);
+    }
+    /**
+     * Set maximum file size in bytes
+     */
+    max(bytes, message) {
+        return new VldFile([...this.checks, { type: 'max', value: bytes, message }]);
+    }
+    /**
+     * Set allowed MIME types
+     */
+    mime(types, message) {
+        const typeArray = Array.isArray(types) ? types : [types];
+        return new VldFile([...this.checks, { type: 'mime', value: typeArray, message }]);
+    }
+    /**
+     * Set both minimum and maximum file size
+     */
+    size(min, max, message) {
+        return this.min(min, message).max(max, message);
+    }
+}
+/**
+ * Helper function to create file validators
+ * Usage: v.file().min(1024).max(10485760).mime(['image/jpeg', 'image/png'])
+ */
+export function file() {
+    return VldFile.create();
+}
+//# sourceMappingURL=file.js.map

package/dist/validators/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/validators/file.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * File validation check types\n */\ntype FileCheck =\n  | { type: 'min'; value: number; message?: string }\n  | { type: 'max'; value: number; message?: string }\n  | { type: 'mime'; value: string[]; message?: string };\n\n/**\n * File representation for validation\n * In browsers: File object\n * In Node.js: Object with size and type properties\n */\nexport type VldFileValue = File | { size: number; type: string; name?: string };\n\n/**\n * Immutable file validator for file uploads\n * Supports size and MIME type validation\n */\nexport class VldFile extends VldBase<unknown, VldFileValue> {\n  private constructor(\n    private readonly checks: readonly FileCheck[] = []\n  ) {\n    super();\n  }\n\n  /**\n   * Create a new file validator\n   */\n  static create(): VldFile {\n    return new VldFile();\n  }\n\n  /**\n   * Parse and validate a file value\n   */\n  parse(value: unknown): VldFileValue {\n    // Check if File API is supported\n    const FileSupported = typeof File !== 'undefined';\n\n    if (!FileSupported) {\n      throw new Error(getMessages().fileNotSupported || 'File API not supported in this environment');\n    }\n\n    // Check if value is a File object\n    if (!(value instanceof File)) {\n      // Allow plain object with size and type for Node.js compatibility\n      if (\n        typeof value === 'object' &&\n        value !== null &&\n        'size' in value &&\n        'type' in value\n      ) {\n        const fileObj = value as { size: number; type: string; name?: string };\n        return this.runChecks(fileObj);\n      }\n\n      throw new Error(getMessages().invalidFile || 'Expected a File object');\n    }\n\n    return this.runChecks(value);\n  }\n\n  /**\n   * Run all validation checks on the file\n   */\n  private runChecks(file: VldFileValue): VldFileValue {\n    const msgs = getMessages();\n\n    for (const check of this.checks) {\n      switch (check.type) {\n        case 'min':\n          if (file.size < check.value) {\n            throw new Error(\n              check.message ||\n              (msgs.fileMinSize?.(check.value) || `File size must be at least ${check.value} bytes`)\n            );\n          }\n          break;\n\n        case 'max':\n          if (file.size > check.value) {\n            throw new Error(\n              check.message ||\n              (msgs.fileMaxSize?.(check.value) || `File size must not exceed ${check.value} bytes`)\n            );\n          }\n          break;\n\n        case 'mime':\n          if (!check.value.includes(file.type)) {\n            throw new Error(\n              check.message ||\n              (msgs.fileMimeType?.(check.value) || `Invalid file type. Expected: ${check.value.join(', ')}`)\n            );\n          }\n          break;\n      }\n    }\n\n    return file;\n  }\n\n  /**\n   * Safely parse and validate a file value\n   */\n  safeParse(value: unknown): ParseResult<VldFileValue> {\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  /**\n   * Set minimum file size in bytes\n   */\n  min(bytes: number, message?: string): VldFile {\n    return new VldFile([...this.checks, { type: 'min', value: bytes, message }]);\n  }\n\n  /**\n   * Set maximum file size in bytes\n   */\n  max(bytes: number, message?: string): VldFile {\n    return new VldFile([...this.checks, { type: 'max', value: bytes, message }]);\n  }\n\n  /**\n   * Set allowed MIME types\n   */\n  mime(types: string | string[], message?: string): VldFile {\n    const typeArray = Array.isArray(types) ? types : [types];\n    return new VldFile([...this.checks, { type: 'mime', value: typeArray, message }]);\n  }\n\n  /**\n   * Set both minimum and maximum file size\n   */\n  size(min: number, max: number, message?: string): VldFile {\n    return this.min(min, message).max(max, message);\n  }\n}\n\n/**\n * Helper function to create file validators\n * Usage: v.file().min(1024).max(10485760).mime(['image/jpeg', 'image/png'])\n */\nexport function file(): VldFile {\n  return VldFile.create();\n}\n"]}

package/dist/validators/function.d.ts

@@ -0,0 +1,26 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * Immutable function validator
+ * Validates that a value is a function
+ */
+export declare class VldFunction extends VldBase<unknown, Function> {
+    private constructor();
+    /**
+     * Create a new function validator
+     */
+    static create(): VldFunction;
+    /**
+     * Parse and validate a function value
+     */
+    parse(value: unknown): Function;
+    /**
+     * Safely parse and validate a function value
+     */
+    safeParse(value: unknown): ParseResult<Function>;
+}
+/**
+ * Helper function to create function validators
+ * Usage: v.function()
+ */
+export declare function functionValidator(): VldFunction;
+//# sourceMappingURL=function.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/validators/function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;;GAGG;AACH,qBAAa,WAAY,SAAQ,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;IACzD,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,WAAW;IAI5B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ;IAU/B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC;CAOjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/validators/function.js

@@ -0,0 +1,45 @@
+import { VldBase } from './base.js';
+import { getMessages } from '../locales/index.js';
+/**
+ * Immutable function validator
+ * Validates that a value is a function
+ */
+export class VldFunction extends VldBase {
+    constructor() {
+        super();
+    }
+    /**
+     * Create a new function validator
+     */
+    static create() {
+        return new VldFunction();
+    }
+    /**
+     * Parse and validate a function value
+     */
+    parse(value) {
+        if (typeof value !== 'function') {
+            throw new Error(getMessages().invalidFunction || 'Expected a function');
+        }
+        return value;
+    }
+    /**
+     * Safely parse and validate a function value
+     */
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    }
+}
+/**
+ * Helper function to create function validators
+ * Usage: v.function()
+ */
+export function functionValidator() {
+    return VldFunction.create();
+}
+//# sourceMappingURL=function.js.map

package/dist/validators/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/validators/function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,OAA0B;IACzD;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,WAAW,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAc;QAClB,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,WAAW,EAAE,CAAC,eAAe,IAAI,qBAAqB,CACvD,CAAC;QACJ,CAAC;QAED,OAAO,KAAiB,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,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;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC,MAAM,EAAE,CAAC;AAC9B,CAAC","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Immutable function validator\n * Validates that a value is a function\n */\nexport class VldFunction extends VldBase<unknown, Function> {\n  private constructor() {\n    super();\n  }\n\n  /**\n   * Create a new function validator\n   */\n  static create(): VldFunction {\n    return new VldFunction();\n  }\n\n  /**\n   * Parse and validate a function value\n   */\n  parse(value: unknown): Function {\n    if (typeof value !== 'function') {\n      throw new Error(\n        getMessages().invalidFunction || 'Expected a function'\n      );\n    }\n\n    return value as Function;\n  }\n\n  /**\n   * Safely parse and validate a function value\n   */\n  safeParse(value: unknown): ParseResult<Function> {\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\n/**\n * Helper function to create function validators\n * Usage: v.function()\n */\nexport function functionValidator(): VldFunction {\n  return VldFunction.create();\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/validators/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI9C;;GAEG;AACH,qBAAa,MAAO,SAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAErD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,SAAS,UAAQ;IAK7B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAQ7B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;IAoC9C;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB,MAAM,CAAC,MAAM,CAAC,SAAS,UAAQ,GAAG,MAAM;CAGzC"}
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../src/validators/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAI9C;;GAEG;AACH,qBAAa,MAAO,SAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;IAEjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAErD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,SAAS,UAAQ;IAK7B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAQ7B,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;IAoC9C;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB,MAAM,CAAC,MAAM,CAAC,SAAS,UAAQ,GAAG,MAAM;CAGzC"}

package/dist/validators/hex.js

@@ -1,6 +1,6 @@
 import { VldBase } from './base.js';
 import { VldError, createIssue } from '../errors.js';
-import { getMessages } from '../locales.js';
+import { getMessages } from '../locales/index.js';
 /**
  * Hexadecimal string validator
  */
@@ -57,5 +57,6 @@ export class VldHex extends VldBase {
         return new VldHex(lowercase);
     }
 }
-VldHex.HEX_REGEX = /^[0-9a-fA-F]+$/;
+// BUG-008 FIX: Use * instead of + to allow empty hex strings (consistent with base64 validator)
+VldHex.HEX_REGEX = /^[0-9a-fA-F]*$/;
 //# sourceMappingURL=hex.js.map

package/dist/validators/hex.js.map

@@ -1 +1 @@
-{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/validators/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,OAAuB;IAKjD,YAAY,SAAS,GAAG,KAAK;QAC3B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC;iBAC9D,CAAC;aACH,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC;iBACpD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC;iBACpD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK;QAC7B,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;;AA9DuB,gBAAS,GAAG,gBAAgB,CAAC","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { VldError, createIssue } from '../errors';\nimport { getMessages } from '../locales';\n\n/**\n * Hexadecimal string validator\n */\nexport class VldHex extends VldBase<string, string> {\n  private static readonly HEX_REGEX = /^[0-9a-fA-F]+$/;\n  \n  private readonly lowercase: boolean;\n  \n  constructor(lowercase = false) {\n    super();\n    this.lowercase = lowercase;\n  }\n  \n  parse(value: unknown): string {\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<string> {\n    if (typeof value !== 'string') {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('invalid_type', [], getMessages().expectedString)\n        ])\n      };\n    }\n    \n    // Check if it's a valid hex string\n    if (!VldHex.HEX_REGEX.test(value)) {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('custom', [], getMessages().invalidHex)\n        ])\n      };\n    }\n    \n    // Check if even length (full bytes)\n    if (value.length % 2 !== 0) {\n      return {\n        success: false,\n        error: new VldError([\n          createIssue('custom', [], getMessages().invalidHex)\n        ])\n      };\n    }\n    \n    // Normalize case if required\n    const normalizedValue = this.lowercase ? value.toLowerCase() : value;\n    \n    return { success: true, data: normalizedValue };\n  }\n  \n  /**\n   * Require lowercase hex characters\n   */\n  lowercaseMode(): VldHex {\n    return new VldHex(true);\n  }\n  \n  static create(lowercase = false): VldHex {\n    return new VldHex(lowercase);\n  }\n}"]}
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/validators/hex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,MAAO,SAAQ,OAAuB;IAMjD,YAAY,SAAS,GAAG,KAAK;QAC3B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,cAAc,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,cAAc,CAAC;iBAC9D,CAAC;aACH,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC;iBACpD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,QAAQ,CAAC;oBAClB,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC;iBACpD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK;QAC7B,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;;AA/DD,gGAAgG;AACxE,gBAAS,GAAG,gBAAgB,CAAC","sourcesContent":["import { VldBase, ParseResult } from './base';\r\nimport { VldError, createIssue } from '../errors';\r\nimport { getMessages } from '../locales';\r\n\r\n/**\r\n * Hexadecimal string validator\r\n */\r\nexport class VldHex extends VldBase<string, string> {\r\n  // BUG-008 FIX: Use * instead of + to allow empty hex strings (consistent with base64 validator)\r\n  private static readonly HEX_REGEX = /^[0-9a-fA-F]*$/;\r\n  \r\n  private readonly lowercase: boolean;\r\n  \r\n  constructor(lowercase = false) {\r\n    super();\r\n    this.lowercase = lowercase;\r\n  }\r\n  \r\n  parse(value: unknown): string {\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<string> {\r\n    if (typeof value !== 'string') {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('invalid_type', [], getMessages().expectedString)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    // Check if it's a valid hex string\r\n    if (!VldHex.HEX_REGEX.test(value)) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().invalidHex)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    // Check if even length (full bytes)\r\n    if (value.length % 2 !== 0) {\r\n      return {\r\n        success: false,\r\n        error: new VldError([\r\n          createIssue('custom', [], getMessages().invalidHex)\r\n        ])\r\n      };\r\n    }\r\n    \r\n    // Normalize case if required\r\n    const normalizedValue = this.lowercase ? value.toLowerCase() : value;\r\n    \r\n    return { success: true, data: normalizedValue };\r\n  }\r\n  \r\n  /**\r\n   * Require lowercase hex characters\r\n   */\r\n  lowercaseMode(): VldHex {\r\n    return new VldHex(true);\r\n  }\r\n  \r\n  static create(lowercase = false): VldHex {\r\n    return new VldHex(lowercase);\r\n  }\r\n}"]}

package/dist/validators/index.d.ts

@@ -1,11 +1,12 @@
 /**
  * Main entry point for all validators
  */
-export { VldBase, ParseResult, VldRefine, VldTransform, VldDefault, VldCatch, VldOptional, VldNullable, VldNullish } from './base';
+export { VldBase, ParseResult, VldRefine, VldTransform, VldDefault, VldCatch, VldOptional, VldNullable, VldNullish, VldPipe, VldReadonly, VldBrand, SuperRefineContext, VldSuperRefine, VldPreprocess } from './base';
 export { VldString } from './string';
 export { VldNumber } from './number';
 export { VldBoolean } from './boolean';
 export { VldDate } from './date';
+export { VldStringBool } from './string-bool';
 export { VldArray } from './array';
 export { VldObject } from './object';
 export { VldUnion } from './union';
@@ -22,6 +23,22 @@ export { VldAny } from './any';
 export { VldUnknown } from './unknown';
 export { VldVoid } from './void';
 export { VldNever } from './never';
+export { VldNull } from './null';
+export { VldUndefined } from './undefined';
+export { VldNan } from './nan';
+export { VldLazy } from './lazy';
+export { VldDiscriminatedUnion } from './discriminated-union';
+export { VldXor } from './xor';
+export { VldJson } from './json';
+export { VldTemplateLiteral, templateLiteral } from './template-literal';
+export { VldCustom, custom } from './custom';
+export type { CustomValidatorOptions } from './custom';
+export { VldFile, file } from './file';
+export type { VldFileValue } from './file';
+export { VldFunction, functionValidator } from './function';
+export { email, uuid, uuidv4, hostname, emoji, base64, base64url, hex, jwt, nanoid, cuid, cuid2, ulid, ipv4, ipv6, mac, cidrv4, e164, hash, iso, stringFormat, regexes } from './string-formats';
 import { VldBase } from './base';
 export type Infer<T extends VldBase<any, any>> = T extends VldBase<any, infer U> ? U : never;
+export type Input<T extends VldBase<any, any>> = T extends VldBase<infer I, any> ? I : never;
+export type Output<T extends VldBase<any, any>> = T extends VldBase<any, infer O> ? O : never;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,OAAO,EACP,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGjC,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"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"}

package/dist/validators/index.js

@@ -2,12 +2,13 @@
  * Main entry point for all validators
  */
 // Export base types and classes
-export { VldBase, VldRefine, VldTransform, VldDefault, VldCatch, VldOptional, VldNullable, VldNullish } from './base.js';
+export { VldBase, VldRefine, VldTransform, VldDefault, VldCatch, VldOptional, VldNullable, VldNullish, VldPipe, VldReadonly, VldBrand, VldSuperRefine, VldPreprocess } from './base.js';
 // Export primitive validators
 export { VldString } from './string.js';
 export { VldNumber } from './number.js';
 export { VldBoolean } from './boolean.js';
 export { VldDate } from './date.js';
+export { VldStringBool } from './string-bool.js';
 // Export complex validators
 export { VldArray } from './array.js';
 export { VldObject } from './object.js';
@@ -27,4 +28,18 @@ export { VldAny } from './any.js';
 export { VldUnknown } from './unknown.js';
 export { VldVoid } from './void.js';
 export { VldNever } from './never.js';
+// Export Zod 4 parity validators
+export { VldNull } from './null.js';
+export { VldUndefined } from './undefined.js';
+export { VldNan } from './nan.js';
+export { VldLazy } from './lazy.js';
+export { VldDiscriminatedUnion } from './discriminated-union.js';
+export { VldXor } from './xor.js';
+export { VldJson } from './json.js';
+export { VldTemplateLiteral, templateLiteral } from './template-literal.js';
+export { VldCustom, custom } from './custom.js';
+export { VldFile, file } from './file.js';
+export { VldFunction, functionValidator } from './function.js';
+// Export string format validators
+export { email, uuid, uuidv4, hostname, emoji, base64, base64url, hex, jwt, nanoid, cuid, cuid2, ulid, ipv4, ipv6, mac, cidrv4, e164, hash, iso, stringFormat, regexes } from './string-formats.js';
 //# sourceMappingURL=index.js.map