@oxog/vld 1.0.0 → 1.1.0

package/dist/validators/string-ultra.js

@@ -0,0 +1,217 @@
+import { VldBase } from './base.js';
+import { getMessages } from '../locales.js';
+/**
+ * Ultra-optimized string validator with pre-compiled validations
+ */
+export class VldStringUltra extends VldBase {
+    constructor(config = {}) {
+        super();
+        this.customValidations = [];
+        this.minLength = config.minLength;
+        this.maxLength = config.maxLength;
+        this.exactLength = config.exactLength;
+        this.pattern = config.pattern;
+        this.isEmail = config.isEmail;
+        this.isUrl = config.isUrl;
+        this.transform = config.transform;
+    }
+    static create() {
+        return new VldStringUltra();
+    }
+    /**
+     * Ultra-fast string validation with minimal overhead
+     */
+    parse(value) {
+        // Ultra-fast type check
+        if (typeof value !== 'string') {
+            throw new Error(getMessages().invalidString);
+        }
+        let str = value;
+        // Apply transform first if present
+        if (this.transform) {
+            str = this.transform(str);
+        }
+        const len = str.length;
+        // Fast length checks with bitwise operations for small numbers
+        if (this.exactLength !== undefined && len !== this.exactLength) {
+            throw new Error(getMessages().stringLength(this.exactLength));
+        }
+        if (this.minLength !== undefined && len < this.minLength) {
+            throw new Error(getMessages().stringMinLength(this.minLength));
+        }
+        if (this.maxLength !== undefined && len > this.maxLength) {
+            throw new Error(getMessages().stringMaxLength(this.maxLength));
+        }
+        // Ultra-fast email validation (simplified for speed)
+        if (this.isEmail && !VldStringUltra.EMAIL_REGEX.test(str)) {
+            throw new Error(getMessages().invalidEmail);
+        }
+        // Ultra-fast URL validation
+        if (this.isUrl && !VldStringUltra.URL_REGEX.test(str)) {
+            throw new Error(getMessages().invalidUrl);
+        }
+        // Pattern matching
+        if (this.pattern && !this.pattern.test(str)) {
+            throw new Error(getMessages().stringPattern);
+        }
+        // Custom validations (loop unrolling for small arrays)
+        const validationsLength = this.customValidations.length;
+        if (validationsLength > 0) {
+            for (let i = 0; i < validationsLength; i++) {
+                if (!this.customValidations[i](str)) {
+                    throw new Error(getMessages().customValidation);
+                }
+            }
+        }
+        return str;
+    }
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    }
+    // Chainable methods with ultra-fast creation
+    min(length) {
+        return new VldStringUltra({
+            minLength: length,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: this.transform
+        });
+    }
+    max(length) {
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: length,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: this.transform
+        });
+    }
+    length(length) {
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: length,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: this.transform
+        });
+    }
+    /**
+     * Ultra-fast email validation using simplified regex
+     */
+    email() {
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: true,
+            isUrl: this.isUrl,
+            transform: this.transform
+        });
+    }
+    /**
+     * Ultra-fast URL validation
+     */
+    url() {
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: true,
+            transform: this.transform
+        });
+    }
+    /**
+     * Pattern matching with custom regex
+     */
+    regex(pattern) {
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: this.transform
+        });
+    }
+    /**
+     * Transform string after validation
+     */
+    trim() {
+        const currentTransform = this.transform;
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: currentTransform ?
+                (str) => currentTransform(str).trim() :
+                (str) => str.trim()
+        });
+    }
+    toLowerCase() {
+        const currentTransform = this.transform;
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: currentTransform ?
+                (str) => currentTransform(str).toLowerCase() :
+                (str) => str.toLowerCase()
+        });
+    }
+    toUpperCase() {
+        const currentTransform = this.transform;
+        return new VldStringUltra({
+            minLength: this.minLength,
+            maxLength: this.maxLength,
+            exactLength: this.exactLength,
+            pattern: this.pattern,
+            isEmail: this.isEmail,
+            isUrl: this.isUrl,
+            transform: currentTransform ?
+                (str) => currentTransform(str).toUpperCase() :
+                (str) => str.toUpperCase()
+        });
+    }
+    nonempty() {
+        return this.min(1);
+    }
+    startsWith(prefix) {
+        this.customValidations.push((str) => str.startsWith(prefix));
+        return this;
+    }
+    endsWith(suffix) {
+        this.customValidations.push((str) => str.endsWith(suffix));
+        return this;
+    }
+    includes(substring) {
+        this.customValidations.push((str) => str.includes(substring));
+        return this;
+    }
+}
+// Pre-compiled ultra-fast email regex (simplified but fast)
+VldStringUltra.EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+// Pre-compiled URL regex
+VldStringUltra.URL_REGEX = /^https?:\/\/[^\s]+$/;
+//# sourceMappingURL=string-ultra.js.map

package/dist/validators/string-ultra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-ultra.js","sourceRoot":"","sources":["../../src/validators/string-ultra.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Ultra-optimized string validator with pre-compiled validations\n */\nexport class VldStringUltra extends VldBase<unknown, string> {\n  private readonly minLength?: number;\n  private readonly maxLength?: number;\n  private readonly exactLength?: number;\n  private readonly pattern?: RegExp;\n  private readonly isEmail?: boolean;\n  private readonly isUrl?: boolean;\n  private readonly transform?: (value: string) => string;\n  private readonly customValidations: Array<(value: string) => boolean> = [];\n  \n  // Pre-compiled ultra-fast email regex (simplified but fast)\n  private static readonly EMAIL_REGEX = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n  \n  // Pre-compiled URL regex\n  private static readonly URL_REGEX = /^https?:\\/\\/[^\\s]+$/;\n  \n  private constructor(config: {\n    minLength?: number;\n    maxLength?: number;\n    exactLength?: number;\n    pattern?: RegExp;\n    isEmail?: boolean;\n    isUrl?: boolean;\n    transform?: (value: string) => string;\n  } = {}) {\n    super();\n    this.minLength = config.minLength;\n    this.maxLength = config.maxLength;\n    this.exactLength = config.exactLength;\n    this.pattern = config.pattern;\n    this.isEmail = config.isEmail;\n    this.isUrl = config.isUrl;\n    this.transform = config.transform;\n  }\n  \n  static create(): VldStringUltra {\n    return new VldStringUltra();\n  }\n  \n  /**\n   * Ultra-fast string validation with minimal overhead\n   */\n  parse(value: unknown): string {\n    // Ultra-fast type check\n    if (typeof value !== 'string') {\n      throw new Error(getMessages().invalidString);\n    }\n    \n    let str = value;\n    \n    // Apply transform first if present\n    if (this.transform) {\n      str = this.transform(str);\n    }\n    \n    const len = str.length;\n    \n    // Fast length checks with bitwise operations for small numbers\n    if (this.exactLength !== undefined && len !== this.exactLength) {\n      throw new Error(getMessages().stringLength(this.exactLength));\n    }\n    \n    if (this.minLength !== undefined && len < this.minLength) {\n      throw new Error(getMessages().stringMinLength(this.minLength));\n    }\n    \n    if (this.maxLength !== undefined && len > this.maxLength) {\n      throw new Error(getMessages().stringMaxLength(this.maxLength));\n    }\n    \n    // Ultra-fast email validation (simplified for speed)\n    if (this.isEmail && !VldStringUltra.EMAIL_REGEX.test(str)) {\n      throw new Error(getMessages().invalidEmail);\n    }\n    \n    // Ultra-fast URL validation\n    if (this.isUrl && !VldStringUltra.URL_REGEX.test(str)) {\n      throw new Error(getMessages().invalidUrl);\n    }\n    \n    // Pattern matching\n    if (this.pattern && !this.pattern.test(str)) {\n      throw new Error(getMessages().stringPattern);\n    }\n    \n    // Custom validations (loop unrolling for small arrays)\n    const validationsLength = this.customValidations.length;\n    if (validationsLength > 0) {\n      for (let i = 0; i < validationsLength; i++) {\n        if (!this.customValidations[i](str)) {\n          throw new Error(getMessages().customValidation);\n        }\n      }\n    }\n    \n    return str;\n  }\n  \n  safeParse(value: unknown): ParseResult<string> {\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  // Chainable methods with ultra-fast creation\n  min(length: number): VldStringUltra {\n    return new VldStringUltra({\n      minLength: length,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: this.transform\n    });\n  }\n  \n  max(length: number): VldStringUltra {\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: length,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: this.transform\n    });\n  }\n  \n  length(length: number): VldStringUltra {\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: length,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: this.transform\n    });\n  }\n  \n  /**\n   * Ultra-fast email validation using simplified regex\n   */\n  email(): VldStringUltra {\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: true,\n      isUrl: this.isUrl,\n      transform: this.transform\n    });\n  }\n  \n  /**\n   * Ultra-fast URL validation\n   */\n  url(): VldStringUltra {\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: true,\n      transform: this.transform\n    });\n  }\n  \n  /**\n   * Pattern matching with custom regex\n   */\n  regex(pattern: RegExp): VldStringUltra {\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: this.transform\n    });\n  }\n  \n  /**\n   * Transform string after validation\n   */\n  trim(): VldStringUltra {\n    const currentTransform = this.transform;\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: currentTransform ? \n        (str: string) => currentTransform(str).trim() : \n        (str: string) => str.trim()\n    });\n  }\n  \n  toLowerCase(): VldStringUltra {\n    const currentTransform = this.transform;\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: currentTransform ? \n        (str: string) => currentTransform(str).toLowerCase() : \n        (str: string) => str.toLowerCase()\n    });\n  }\n  \n  toUpperCase(): VldStringUltra {\n    const currentTransform = this.transform;\n    return new VldStringUltra({\n      minLength: this.minLength,\n      maxLength: this.maxLength,\n      exactLength: this.exactLength,\n      pattern: this.pattern,\n      isEmail: this.isEmail,\n      isUrl: this.isUrl,\n      transform: currentTransform ? \n        (str: string) => currentTransform(str).toUpperCase() : \n        (str: string) => str.toUpperCase()\n    });\n  }\n  \n  nonempty(): VldStringUltra {\n    return this.min(1);\n  }\n  \n  startsWith(prefix: string): VldStringUltra {\n    this.customValidations.push((str: string) => str.startsWith(prefix));\n    return this;\n  }\n  \n  endsWith(suffix: string): VldStringUltra {\n    this.customValidations.push((str: string) => str.endsWith(suffix));\n    return this;\n  }\n  \n  includes(substring: string): VldStringUltra {\n    this.customValidations.push((str: string) => str.includes(substring));\n    return this;\n  }\n}"]}

package/dist/validators/string.d.ts

@@ -0,0 +1,109 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * Type for string validation check functions
+ */
+type StringCheck = (value: string) => boolean;
+/**
+ * Type for string transformation functions
+ */
+type StringTransform = (value: string) => string;
+/**
+ * Configuration for string validator
+ */
+interface StringValidatorConfig {
+    readonly checks: ReadonlyArray<StringCheck>;
+    readonly transforms: ReadonlyArray<StringTransform>;
+    readonly errorMessage?: string;
+}
+/**
+ * Immutable string validator with chainable methods
+ */
+export declare class VldString extends VldBase<string, string> {
+    protected readonly config: StringValidatorConfig;
+    /**
+     * Protected constructor to allow extension while maintaining immutability
+     */
+    protected constructor(config?: Partial<StringValidatorConfig>);
+    /**
+     * Create a new string validator
+     */
+    static create(): VldString;
+    /**
+     * Parse and validate a string value - ultra-optimized
+     */
+    parse(value: unknown): string;
+    /**
+     * Safely parse and validate a string value
+     */
+    safeParse(value: unknown): ParseResult<string>;
+    /**
+     * Create a new validator with minimum length constraint
+     */
+    min(length: number, message?: string): VldString;
+    /**
+     * Create a new validator with maximum length constraint
+     */
+    max(length: number, message?: string): VldString;
+    /**
+     * Create a new validator with exact length constraint
+     */
+    length(length: number, message?: string): VldString;
+    /**
+     * Create a new validator that checks for valid email format
+     */
+    email(message?: string): VldString;
+    /**
+     * Create a new validator that checks for valid URL format
+     */
+    url(message?: string): VldString;
+    /**
+     * Create a new validator that checks for valid UUID format
+     */
+    uuid(message?: string): VldString;
+    /**
+     * Create a new validator with regex pattern matching
+     */
+    regex(pattern: RegExp, message?: string): VldString;
+    /**
+     * Create a new validator that trims whitespace
+     */
+    trim(): VldString;
+    /**
+     * Create a new validator that converts to lowercase
+     */
+    toLowerCase(): VldString;
+    /**
+     * Create a new validator that converts to uppercase
+     */
+    toUpperCase(): VldString;
+    /**
+     * Create a new validator that checks if string starts with a substring
+     */
+    startsWith(str: string, message?: string): VldString;
+    /**
+     * Create a new validator that checks if string ends with a substring
+     */
+    endsWith(str: string, message?: string): VldString;
+    /**
+     * Create a new validator that checks if string includes a substring
+     */
+    includes(str: string, message?: string): VldString;
+    /**
+     * Create a new validator that checks for valid IP address (v4 or v6)
+     */
+    ip(message?: string): VldString;
+    /**
+     * Create a new validator that checks for valid IPv4 address
+     */
+    ipv4(message?: string): VldString;
+    /**
+     * Create a new validator that checks for valid IPv6 address
+     */
+    ipv6(message?: string): VldString;
+    /**
+     * Create a new validator that ensures string is not empty
+     */
+    nonempty(message?: string): VldString;
+}
+export {};
+//# sourceMappingURL=string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/validators/string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAmB9C;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAE9C;;GAEG;AACH,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;AAEjD;;GAEG;AACH,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAEjD;;OAEG;IACH,SAAS,aAAa,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAS7D;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,SAAS;IAI1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAwB7B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;IAQ9C;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQhD;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQhD;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQnD;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQlC;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQhC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQjC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQnD;;OAEG;IACH,IAAI,IAAI,SAAS;IAQjB;;OAEG;IACH,WAAW,IAAI,SAAS;IAQxB;;OAEG;IACH,WAAW,IAAI,SAAS;IAQxB;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQpD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQlD;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQlD;;OAEG;IACH,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQ/B;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQjC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;IAQjC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS;CAOtC"}

package/dist/validators/string.js

@@ -0,0 +1,242 @@
+import { VldBase } from './base.js';
+import { getMessages } from '../locales.js';
+/**
+ * Ultra-fast email validation using simplified regex for maximum performance
+ */
+const FAST_EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Pre-compiled regex patterns for common validations
+ */
+const REGEX_PATTERNS = {
+    email: FAST_EMAIL_REGEX, // Use simplified fast regex
+    uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+    url: /^https?:\/\/[^\s]+$/, // Simplified for speed
+    ipv4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
+    ipv6: /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+};
+/**
+ * Immutable string validator with chainable methods
+ */
+export class VldString extends VldBase {
+    /**
+     * Protected constructor to allow extension while maintaining immutability
+     */
+    constructor(config) {
+        super();
+        this.config = {
+            checks: config?.checks || [],
+            transforms: config?.transforms || [],
+            errorMessage: config?.errorMessage
+        };
+    }
+    /**
+     * Create a new string validator
+     */
+    static create() {
+        return new VldString();
+    }
+    /**
+     * Parse and validate a string value - ultra-optimized
+     */
+    parse(value) {
+        if (typeof value !== 'string') {
+            throw new Error(this.config.errorMessage || getMessages().invalidString);
+        }
+        let result = value;
+        // Apply transformations with optimized loop
+        const transformsLength = this.config.transforms.length;
+        for (let i = 0; i < transformsLength; i++) {
+            result = this.config.transforms[i](result);
+        }
+        // Apply checks with optimized loop and early termination
+        const checksLength = this.config.checks.length;
+        for (let i = 0; i < checksLength; i++) {
+            if (!this.config.checks[i](result)) {
+                throw new Error(this.config.errorMessage || getMessages().invalidString);
+            }
+        }
+        return result;
+    }
+    /**
+     * Safely parse and validate a string value
+     */
+    safeParse(value) {
+        try {
+            return { success: true, data: this.parse(value) };
+        }
+        catch (error) {
+            return { success: false, error: error };
+        }
+    }
+    /**
+     * Create a new validator with minimum length constraint
+     */
+    min(length, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.length >= length],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringMin(length)
+        });
+    }
+    /**
+     * Create a new validator with maximum length constraint
+     */
+    max(length, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.length <= length],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringMax(length)
+        });
+    }
+    /**
+     * Create a new validator with exact length constraint
+     */
+    length(length, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.length === length],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringLength(length)
+        });
+    }
+    /**
+     * Create a new validator that checks for valid email format
+     */
+    email(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => REGEX_PATTERNS.email.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringEmail
+        });
+    }
+    /**
+     * Create a new validator that checks for valid URL format
+     */
+    url(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => REGEX_PATTERNS.url.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringUrl
+        });
+    }
+    /**
+     * Create a new validator that checks for valid UUID format
+     */
+    uuid(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => REGEX_PATTERNS.uuid.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringUuid
+        });
+    }
+    /**
+     * Create a new validator with regex pattern matching
+     */
+    regex(pattern, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => pattern.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringRegex
+        });
+    }
+    /**
+     * Create a new validator that trims whitespace
+     */
+    trim() {
+        return new VldString({
+            checks: this.config.checks,
+            transforms: [...this.config.transforms, (v) => v.trim()],
+            errorMessage: this.config.errorMessage
+        });
+    }
+    /**
+     * Create a new validator that converts to lowercase
+     */
+    toLowerCase() {
+        return new VldString({
+            checks: this.config.checks,
+            transforms: [...this.config.transforms, (v) => v.toLowerCase()],
+            errorMessage: this.config.errorMessage
+        });
+    }
+    /**
+     * Create a new validator that converts to uppercase
+     */
+    toUpperCase() {
+        return new VldString({
+            checks: this.config.checks,
+            transforms: [...this.config.transforms, (v) => v.toUpperCase()],
+            errorMessage: this.config.errorMessage
+        });
+    }
+    /**
+     * Create a new validator that checks if string starts with a substring
+     */
+    startsWith(str, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.startsWith(str)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringStartsWith(str)
+        });
+    }
+    /**
+     * Create a new validator that checks if string ends with a substring
+     */
+    endsWith(str, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.endsWith(str)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringEndsWith(str)
+        });
+    }
+    /**
+     * Create a new validator that checks if string includes a substring
+     */
+    includes(str, message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.includes(str)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringIncludes(str)
+        });
+    }
+    /**
+     * Create a new validator that checks for valid IP address (v4 or v6)
+     */
+    ip(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => REGEX_PATTERNS.ipv4.test(v) || REGEX_PATTERNS.ipv6.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringIp
+        });
+    }
+    /**
+     * Create a new validator that checks for valid IPv4 address
+     */
+    ipv4(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => REGEX_PATTERNS.ipv4.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringIpv4
+        });
+    }
+    /**
+     * Create a new validator that checks for valid IPv6 address
+     */
+    ipv6(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => REGEX_PATTERNS.ipv6.test(v)],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringIpv6
+        });
+    }
+    /**
+     * Create a new validator that ensures string is not empty
+     */
+    nonempty(message) {
+        return new VldString({
+            checks: [...this.config.checks, (v) => v.length > 0],
+            transforms: this.config.transforms,
+            errorMessage: message || getMessages().stringEmpty
+        });
+    }
+}
+//# sourceMappingURL=string.js.map

package/dist/validators/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/validators/string.ts"],"names":[],"mappings":"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","sourcesContent":["import { VldBase, ParseResult } from './base';\nimport { getMessages } from '../locales';\n\n/**\n * Ultra-fast email validation using simplified regex for maximum performance\n */\nconst FAST_EMAIL_REGEX = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n\n/**\n * Pre-compiled regex patterns for common validations\n */\nconst REGEX_PATTERNS = {\n  email: FAST_EMAIL_REGEX, // Use simplified fast regex\n  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n  url: /^https?:\\/\\/[^\\s]+$/,  // Simplified for speed\n  ipv4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,\n  ipv6: /^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,\n};\n\n/**\n * Type for string validation check functions\n */\ntype StringCheck = (value: string) => boolean;\n\n/**\n * Type for string transformation functions\n */\ntype StringTransform = (value: string) => string;\n\n/**\n * Configuration for string validator\n */\ninterface StringValidatorConfig {\n  readonly checks: ReadonlyArray<StringCheck>;\n  readonly transforms: ReadonlyArray<StringTransform>;\n  readonly errorMessage?: string;\n}\n\n/**\n * Immutable string validator with chainable methods\n */\nexport class VldString extends VldBase<string, string> {\n  protected readonly config: StringValidatorConfig;\n  \n  /**\n   * Protected constructor to allow extension while maintaining immutability\n   */\n  protected constructor(config?: Partial<StringValidatorConfig>) {\n    super();\n    this.config = {\n      checks: config?.checks || [],\n      transforms: config?.transforms || [],\n      errorMessage: config?.errorMessage\n    };\n  }\n  \n  /**\n   * Create a new string validator\n   */\n  static create(): VldString {\n    return new VldString();\n  }\n  \n  /**\n   * Parse and validate a string value - ultra-optimized\n   */\n  parse(value: unknown): string {\n    if (typeof value !== 'string') {\n      throw new Error(this.config.errorMessage || getMessages().invalidString);\n    }\n    \n    let result = value;\n    \n    // Apply transformations with optimized loop\n    const transformsLength = this.config.transforms.length;\n    for (let i = 0; i < transformsLength; i++) {\n      result = this.config.transforms[i](result);\n    }\n    \n    // Apply checks with optimized loop and early termination\n    const checksLength = this.config.checks.length;\n    for (let i = 0; i < checksLength; i++) {\n      if (!this.config.checks[i](result)) {\n        throw new Error(this.config.errorMessage || getMessages().invalidString);\n      }\n    }\n    \n    return result;\n  }\n  \n  /**\n   * Safely parse and validate a string value\n   */\n  safeParse(value: unknown): ParseResult<string> {\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   * Create a new validator with minimum length constraint\n   */\n  min(length: number, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.length >= length],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringMin(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with maximum length constraint\n   */\n  max(length: number, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.length <= length],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringMax(length)\n    });\n  }\n  \n  /**\n   * Create a new validator with exact length constraint\n   */\n  length(length: number, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.length === length],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringLength(length)\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for valid email format\n   */\n  email(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => REGEX_PATTERNS.email.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringEmail\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for valid URL format\n   */\n  url(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => REGEX_PATTERNS.url.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringUrl\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for valid UUID format\n   */\n  uuid(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => REGEX_PATTERNS.uuid.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringUuid\n    });\n  }\n  \n  /**\n   * Create a new validator with regex pattern matching\n   */\n  regex(pattern: RegExp, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => pattern.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringRegex\n    });\n  }\n  \n  /**\n   * Create a new validator that trims whitespace\n   */\n  trim(): VldString {\n    return new VldString({\n      checks: this.config.checks,\n      transforms: [...this.config.transforms, (v: string) => v.trim()],\n      errorMessage: this.config.errorMessage\n    });\n  }\n  \n  /**\n   * Create a new validator that converts to lowercase\n   */\n  toLowerCase(): VldString {\n    return new VldString({\n      checks: this.config.checks,\n      transforms: [...this.config.transforms, (v: string) => v.toLowerCase()],\n      errorMessage: this.config.errorMessage\n    });\n  }\n  \n  /**\n   * Create a new validator that converts to uppercase\n   */\n  toUpperCase(): VldString {\n    return new VldString({\n      checks: this.config.checks,\n      transforms: [...this.config.transforms, (v: string) => v.toUpperCase()],\n      errorMessage: this.config.errorMessage\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if string starts with a substring\n   */\n  startsWith(str: string, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.startsWith(str)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringStartsWith(str)\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if string ends with a substring\n   */\n  endsWith(str: string, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.endsWith(str)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringEndsWith(str)\n    });\n  }\n  \n  /**\n   * Create a new validator that checks if string includes a substring\n   */\n  includes(str: string, message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.includes(str)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringIncludes(str)\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for valid IP address (v4 or v6)\n   */\n  ip(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => REGEX_PATTERNS.ipv4.test(v) || REGEX_PATTERNS.ipv6.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringIp\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for valid IPv4 address\n   */\n  ipv4(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => REGEX_PATTERNS.ipv4.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringIpv4\n    });\n  }\n  \n  /**\n   * Create a new validator that checks for valid IPv6 address\n   */\n  ipv6(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => REGEX_PATTERNS.ipv6.test(v)],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringIpv6\n    });\n  }\n  \n  /**\n   * Create a new validator that ensures string is not empty\n   */\n  nonempty(message?: string): VldString {\n    return new VldString({\n      checks: [...this.config.checks, (v: string) => v.length > 0],\n      transforms: this.config.transforms,\n      errorMessage: message || getMessages().stringEmpty\n    });\n  }\n}"]}

package/dist/validators/symbol.d.ts

@@ -0,0 +1,24 @@
+import { VldBase, ParseResult } from './base';
+/**
+ * Immutable symbol validator
+ */
+export declare class VldSymbol extends VldBase<symbol, symbol> {
+    private readonly errorMessage?;
+    /**
+     * Private constructor to enforce immutability
+     */
+    private constructor();
+    /**
+     * Create a new symbol validator
+     */
+    static create(): VldSymbol;
+    /**
+     * Parse and validate a symbol value
+     */
+    parse(value: unknown): symbol;
+    /**
+     * Safely parse and validate a symbol value
+     */
+    safeParse(value: unknown): ParseResult<symbol>;
+}
+//# sourceMappingURL=symbol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.d.ts","sourceRoot":"","sources":["../../src/validators/symbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAG9C;;GAEG;AACH,qBAAa,SAAU,SAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IAEvC;;OAEG;IACH,OAAO;IAKP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,SAAS;IAI1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAO7B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;CAS/C"}