@oxog/vld 2.4.0 → 3.0.4

package/dist/validators/string-v2.d.ts

@@ -0,0 +1,274 @@
+/**
+ * VldStringV2 — OPTIMIZED: check classes return Issue | null (no per-call
+ * payload allocation), hot path uses early-return, isSimple is precomputed.
+ *
+ * Same public API as the legacy VldString.
+ */
+import { VldBase, type ErrorParam, type ParseResult } from './base.js';
+import { type VldIssue } from '../errors-core.js';
+export declare abstract class VldStringCheck {
+    abstract readonly kind: string;
+    abstract check(value: string): VldIssue | null;
+    abstract meta(): Record<string, any>;
+}
+export declare class VldCheckMin extends VldStringCheck {
+    readonly length: number;
+    private _msg?;
+    readonly kind = "min";
+    constructor(length: number, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        value: number;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckMax extends VldStringCheck {
+    readonly length: number;
+    private _msg?;
+    readonly kind = "max";
+    constructor(length: number, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        value: number;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckLength extends VldStringCheck {
+    readonly length: number;
+    private _msg?;
+    readonly kind = "length";
+    constructor(length: number, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        value: number;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckEmail extends VldStringCheck {
+    private _msg?;
+    readonly kind = "format";
+    private static RE;
+    constructor(_msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckUrl extends VldStringCheck {
+    private _msg?;
+    readonly kind = "format";
+    private static RE;
+    constructor(_msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckUuid extends VldStringCheck {
+    private _msg?;
+    readonly kind = "format";
+    private static RE;
+    constructor(_msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckRegex extends VldStringCheck {
+    readonly pattern: RegExp;
+    private _msg?;
+    readonly kind = "regex";
+    constructor(pattern: RegExp, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        pattern: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckStartsWith extends VldStringCheck {
+    readonly prefix: string;
+    private _msg?;
+    readonly kind = "startsWith";
+    constructor(prefix: string, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        value: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckEndsWith extends VldStringCheck {
+    readonly suffix: string;
+    private _msg?;
+    readonly kind = "endsWith";
+    constructor(suffix: string, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        value: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckIncludes extends VldStringCheck {
+    readonly substring: string;
+    private _msg?;
+    readonly kind = "includes";
+    constructor(substring: string, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        value: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckRegexFormat extends VldStringCheck {
+    readonly pattern: RegExp;
+    readonly formatName: string;
+    private _msg?;
+    readonly kind = "format";
+    constructor(pattern: RegExp, formatName: string, _msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        pattern: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckIp extends VldStringCheck {
+    private _msg?;
+    readonly kind = "format";
+    private static V4;
+    constructor(_msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckIpv4 extends VldStringCheck {
+    private _msg?;
+    readonly kind = "format";
+    private static RE;
+    constructor(_msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        message: string | undefined;
+    };
+}
+export declare class VldCheckIpv6 extends VldStringCheck {
+    private _msg?;
+    readonly kind = "format";
+    constructor(_msg?: string | undefined);
+    get message(): string | undefined;
+    check(value: string): VldIssue | null;
+    meta(): {
+        kind: string;
+        format: string;
+        message: string | undefined;
+    };
+}
+export interface VldStringDef {
+    readonly type: 'string';
+    readonly checks: ReadonlyArray<VldStringCheck>;
+    readonly transforms: ReadonlyArray<(v: string) => string>;
+    readonly jsonSchema?: {
+        minLength?: number;
+        maxLength?: number;
+        format?: string;
+        pattern?: string;
+    } | undefined;
+    readonly errorMessage?: string | undefined;
+    readonly isSimple: boolean;
+}
+export declare class VldStringV2 extends VldBase<string, string> {
+    readonly __def: VldStringDef;
+    constructor(def?: VldStringDef);
+    static create(): VldStringV2;
+    get isSimple(): boolean;
+    get minLength(): number | null;
+    get maxLength(): number | null;
+    get getFormat(): string | null;
+    get isCoercion(): boolean;
+    parse(value: unknown): string;
+    /** Hot path — early-return, no payload allocation. */
+    parseKnownString(value: string): string;
+    safeParse(value: unknown): ParseResult<string>;
+    protected withDef(def: Partial<VldStringDef> & {
+        type: 'string';
+    }): VldStringV2;
+    min(length: number, message?: ErrorParam): VldStringV2;
+    max(length: number, message?: ErrorParam): VldStringV2;
+    length(length: number, message?: ErrorParam): VldStringV2;
+    email(message?: ErrorParam): VldStringV2;
+    url(message?: ErrorParam): VldStringV2;
+    uuid(message?: ErrorParam): VldStringV2;
+    regex(pattern: RegExp, message?: ErrorParam): VldStringV2;
+    trim(): VldStringV2;
+    toLowerCase(): VldStringV2;
+    lowercase(): VldStringV2;
+    toUpperCase(): VldStringV2;
+    uppercase(): VldStringV2;
+    normalize(form?: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): VldStringV2;
+    slugify(): VldStringV2;
+    startsWith(str: string, message?: ErrorParam): VldStringV2;
+    endsWith(str: string, message?: ErrorParam): VldStringV2;
+    includes(str: string, message?: ErrorParam): VldStringV2;
+    ip(message?: ErrorParam): VldStringV2;
+    ipv4(message?: ErrorParam): VldStringV2;
+    ipv6(message?: ErrorParam): VldStringV2;
+    nonempty(message?: ErrorParam): VldStringV2;
+    private addFormat;
+    uuidv4(message?: ErrorParam): VldStringV2;
+    uuidv6(message?: ErrorParam): VldStringV2;
+    uuidv7(message?: ErrorParam): VldStringV2;
+    emoji(message?: ErrorParam): VldStringV2;
+    base64(message?: ErrorParam): VldStringV2;
+    base64url(message?: ErrorParam): VldStringV2;
+    jwt(message?: ErrorParam): VldStringV2;
+    nanoid(message?: ErrorParam): VldStringV2;
+    cuid(message?: ErrorParam): VldStringV2;
+    cuid2(message?: ErrorParam): VldStringV2;
+    ulid(message?: ErrorParam): VldStringV2;
+    cidrv4(message?: ErrorParam): VldStringV2;
+    cidrv6(message?: ErrorParam): VldStringV2;
+    e164(message?: ErrorParam): VldStringV2;
+    xid(message?: ErrorParam): VldStringV2;
+    guid(message?: ErrorParam): VldStringV2;
+    ksuid(message?: ErrorParam): VldStringV2;
+    date(message?: ErrorParam): VldStringV2;
+    time(message?: ErrorParam): VldStringV2;
+    datetime(message?: ErrorParam): VldStringV2;
+    duration(message?: ErrorParam): VldStringV2;
+}
+export declare class VldCoerceStringV2 extends VldStringV2 {
+    constructor(def?: VldStringDef);
+    static create(): VldCoerceStringV2;
+    parse(value: unknown): string;
+}

package/dist/validators/string-v2.js

@@ -0,0 +1 @@
+import{VLD_VALIDATOR_TYPES as e,VldBase as t,resolveErrorMessage as s}from"./base.js";import{V as r,c as i,g as n}from"../chunks/errors-core-BU14-Dk8.js";import{getMessages as a}from"../locales/runtime.js";import{i as h}from"../chunks/ip-validation-g5LWgy9t.js";class VldStringCheck{}class VldCheckMin extends VldStringCheck{constructor(e,t){super(),this.length=e,this._msg=t,this.kind="min"}get message(){return this._msg}check(e){return e.length<this.length?{code:"too_small",path:[],origin:"string",minimum:this.length,inclusive:!0,message:this._msg||`Too small: expected string to have >=${this.length} characters`}:null}meta(){return{kind:"min",value:this.length,message:this._msg}}}class VldCheckMax extends VldStringCheck{constructor(e,t){super(),this.length=e,this._msg=t,this.kind="max"}get message(){return this._msg}check(e){return e.length>this.length?{code:"too_big",path:[],origin:"string",maximum:this.length,inclusive:!0,message:this._msg||`Too big: expected string to have <=${this.length} characters`}:null}meta(){return{kind:"max",value:this.length,message:this._msg}}}class VldCheckLength extends VldStringCheck{constructor(e,t){super(),this.length=e,this._msg=t,this.kind="length"}get message(){return this._msg}check(e){return e.length!==this.length?{code:"too_big",path:[],origin:"string",exact:this.length,message:this._msg||`Too big: expected string to have exactly ${this.length} characters`}:null}meta(){return{kind:"length",value:this.length,message:this._msg}}}class VldCheckEmail extends VldStringCheck{constructor(e){super(),this._msg=e,this.kind="format"}get message(){return this._msg}check(e){return VldCheckEmail.RE.test(e)?null:{code:"invalid_format",path:[],origin:"string",format:"email",message:this._msg||"Invalid email"}}meta(){return{kind:"format",format:"email",message:this._msg}}}VldCheckEmail.RE=/^[^\s@]+@[^\s@]+\.[^\s@]+$/;class VldCheckUrl extends VldStringCheck{constructor(e){super(),this._msg=e,this.kind="format"}get message(){return this._msg}check(e){return VldCheckUrl.RE.test(e)?null:{code:"invalid_format",path:[],origin:"string",format:"url",message:this._msg||"Invalid url"}}meta(){return{kind:"format",format:"url",message:this._msg}}}VldCheckUrl.RE=/^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)$/;class VldCheckUuid extends VldStringCheck{constructor(e){super(),this._msg=e,this.kind="format"}get message(){return this._msg}check(e){return VldCheckUuid.RE.test(e)?null:{code:"invalid_format",path:[],origin:"string",format:"uuid",message:this._msg||"Invalid uuid"}}meta(){return{kind:"format",format:"uuid",message:this._msg}}}VldCheckUuid.RE=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;class VldCheckRegex extends VldStringCheck{constructor(e,t){super(),this.pattern=e,this._msg=t,this.kind="regex"}get message(){return this._msg}check(e){return this.pattern.test(e)?null:{code:"invalid_format",path:[],origin:"string",format:"regex",pattern:this.pattern.source,message:this._msg||"Invalid string: does not match pattern"}}meta(){return{kind:"regex",pattern:this.pattern.source,message:this._msg}}}class VldCheckStartsWith extends VldStringCheck{constructor(e,t){super(),this.prefix=e,this._msg=t,this.kind="startsWith"}get message(){return this._msg}check(e){return e.startsWith(this.prefix)?null:{code:"invalid_string",path:[],message:this._msg||`Invalid string: must start with "${this.prefix}"`}}meta(){return{kind:"startsWith",value:this.prefix,message:this._msg}}}class VldCheckEndsWith extends VldStringCheck{constructor(e,t){super(),this.suffix=e,this._msg=t,this.kind="endsWith"}get message(){return this._msg}check(e){return e.endsWith(this.suffix)?null:{code:"invalid_string",path:[],message:this._msg||`Invalid string: must end with "${this.suffix}"`}}meta(){return{kind:"endsWith",value:this.suffix,message:this._msg}}}class VldCheckIncludes extends VldStringCheck{constructor(e,t){super(),this.substring=e,this._msg=t,this.kind="includes"}get message(){return this._msg}check(e){return e.includes(this.substring)?null:{code:"invalid_string",path:[],message:this._msg||`Invalid string: must include "${this.substring}"`}}meta(){return{kind:"includes",value:this.substring,message:this._msg}}}class VldCheckRegexFormat extends VldStringCheck{constructor(e,t,s){super(),this.pattern=e,this.formatName=t,this._msg=s,this.kind="format"}get message(){return this._msg}check(e){return this.pattern.test(e)?null:{code:"invalid_format",path:[],origin:"string",format:this.formatName,pattern:this.pattern.source,message:this._msg||`Invalid ${this.formatName}`}}meta(){return{kind:"format",format:this.formatName,pattern:this.pattern.source,message:this._msg}}}class VldCheckIp extends VldStringCheck{constructor(e){super(),this._msg=e,this.kind="format"}get message(){return this._msg}check(e){return e.length>100||!VldCheckIp.V4.test(e)&&!h(e)?{code:"invalid_format",path:[],origin:"string",format:"ip",message:this._msg||"Invalid ip"}:null}meta(){return{kind:"format",format:"ip",message:this._msg}}}VldCheckIp.V4=/^(?:(?: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]?)$/;class VldCheckIpv4 extends VldStringCheck{constructor(e){super(),this._msg=e,this.kind="format"}get message(){return this._msg}check(e){return VldCheckIpv4.RE.test(e)?null:{code:"invalid_format",path:[],origin:"string",format:"ipv4",message:this._msg||"Invalid ipv4"}}meta(){return{kind:"format",format:"ipv4",message:this._msg}}}VldCheckIpv4.RE=/^(?:(?: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]?)$/;class VldCheckIpv6 extends VldStringCheck{constructor(e){super(),this._msg=e,this.kind="format"}get message(){return this._msg}check(e){return h(e)?null:{code:"invalid_format",path:[],origin:"string",format:"ipv6",message:this._msg||"Invalid ipv6"}}meta(){return{kind:"format",format:"ipv6",message:this._msg}}}const c=Object.freeze({type:"string",checks:Object.freeze([]),transforms:Object.freeze([]),isSimple:!0});class VldStringV2 extends t{constructor(t=c){super(e.STRING),this.__def=t}static create(){return new VldStringV2(c)}get isSimple(){return this.__def.isSimple}get minLength(){return this.__def.jsonSchema?.minLength??null}get maxLength(){return this.__def.jsonSchema?.maxLength??null}get getFormat(){return this.__def.jsonSchema?.format??null}get isCoercion(){return this.validatorType===e.COERCE_STRING}parse(e){if("string"!=typeof e)throw new r([i("string",n(e),this.__def.errorMessage)]);return this.__def.isSimple?e:this.parseKnownString(e)}parseKnownString(e){const t=this.__def,s=t.transforms;let i=e;switch(s.length){case 0:break;case 1:i=s[0](i);break;case 2:i=s[1](s[0](i));break;case 3:i=s[2](s[1](s[0](i)));break;default:for(let e=0;e<s.length;e++)i=s[e](i)}const n=t.checks;for(let e=0;e<n.length;e++){const t=n[e].check(i);if(null!==t)throw new r([t])}return i}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:e instanceof r?e:new r([{code:"custom",path:[],message:String(e)}])}}}withDef(e){const t=(s=e.checks??this.__def.checks,r=e.transforms??this.__def.transforms,i=e.jsonSchema??this.__def.jsonSchema,n=e.errorMessage??this.__def.errorMessage,Object.freeze({type:"string",checks:s,transforms:r,jsonSchema:i,errorMessage:n,isSimple:0===s.length&&0===r.length}));var s,r,i,n;return new this.constructor(t)}min(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckMin(e,s(t,a().stringMin(e)))],jsonSchema:{...this.__def.jsonSchema,minLength:e},errorMessage:s(t,a().stringMin(e))})}max(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckMax(e,s(t,a().stringMax(e)))],jsonSchema:{...this.__def.jsonSchema,maxLength:e},errorMessage:s(t,a().stringMax(e))})}length(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckLength(e,s(t,a().stringLength(e)))],jsonSchema:{...this.__def.jsonSchema,exactLength:e},errorMessage:s(t,a().stringLength(e))})}email(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckEmail(s(e,a().stringEmail))],jsonSchema:{...this.__def.jsonSchema,format:"email"},errorMessage:s(e,a().stringEmail)})}url(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckUrl(s(e,a().stringUrl))],jsonSchema:{...this.__def.jsonSchema,format:"uri"},errorMessage:s(e,a().stringUrl)})}uuid(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckUuid(s(e,a().stringUuid))],jsonSchema:{...this.__def.jsonSchema,format:"uuid"},errorMessage:s(e,a().stringUuid)})}regex(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckRegex(e,s(t,a().stringRegex))],jsonSchema:{...this.__def.jsonSchema,pattern:e.source},errorMessage:s(t,a().stringRegex)})}trim(){return this.withDef({type:"string",transforms:[...this.__def.transforms,e=>e.trim()]})}toLowerCase(){return this.withDef({type:"string",transforms:[...this.__def.transforms,e=>e.toLowerCase()]})}lowercase(){return this.toLowerCase()}toUpperCase(){return this.withDef({type:"string",transforms:[...this.__def.transforms,e=>e.toUpperCase()]})}uppercase(){return this.toUpperCase()}normalize(e){return this.withDef({type:"string",transforms:[...this.__def.transforms,t=>t.normalize(e)]})}slugify(){return this.withDef({type:"string",transforms:[...this.__def.transforms,e=>e.toLowerCase().trim().replace(/[^\w\s-]/g,"").replace(/[\s_-]+/g,"-").replace(/^-+|-+$/g,"")]})}startsWith(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckStartsWith(e,s(t,a().stringStartsWith(e)))],errorMessage:s(t,a().stringStartsWith(e))})}endsWith(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckEndsWith(e,s(t,a().stringEndsWith(e)))],errorMessage:s(t,a().stringEndsWith(e))})}includes(e,t){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckIncludes(e,s(t,a().stringIncludes(e)))],errorMessage:s(t,a().stringIncludes(e))})}ip(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckIp(s(e,a().stringIp))],jsonSchema:{...this.__def.jsonSchema,format:"ip"},errorMessage:s(e,a().stringIp)})}ipv4(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckIpv4(s(e,a().stringIpv4))],jsonSchema:{...this.__def.jsonSchema,format:"ipv4"},errorMessage:s(e,a().stringIpv4)})}ipv6(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckIpv6(s(e,a().stringIpv6))],jsonSchema:{...this.__def.jsonSchema,format:"ipv6"},errorMessage:s(e,a().stringIpv6)})}nonempty(e){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckMin(1,s(e,a().stringEmpty))],jsonSchema:{...this.__def.jsonSchema,minLength:Math.max(this.__def.jsonSchema?.minLength||0,1)},errorMessage:s(e,a().stringEmpty)})}addFormat(e,t,r){return this.withDef({type:"string",checks:[...this.__def.checks,new VldCheckRegexFormat(e,t,s(r,`Invalid ${t}`))],jsonSchema:{...this.__def.jsonSchema,format:t,pattern:e.source},errorMessage:s(r,`Invalid ${t}`)})}uuidv4(e){return this.addFormat(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,"uuid",e)}uuidv6(e){return this.addFormat(/^[0-9a-f]{8}-[0-9a-f]{4}-6[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,"uuid",e)}uuidv7(e){return this.addFormat(/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,"uuid",e)}emoji(e){return this.addFormat(/^(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F)(?:\u200D(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F))*$/u,"emoji",e)}base64(e){return this.addFormat(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,"base64",e)}base64url(e){return this.addFormat(/^[A-Za-z0-9_-]*$/,"base64url",e)}jwt(e){return this.addFormat(/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*$/,"jwt",e)}nanoid(e){return this.addFormat(/^[A-Za-z0-9_-]{21}$/,"nanoid",e)}cuid(e){return this.addFormat(/^c[^\s-]{8,}$/i,"cuid",e)}cuid2(e){return this.addFormat(/^[0-9a-z]+$/,"cuid2",e)}ulid(e){return this.addFormat(/^[0-9A-HJKMNP-TV-Z]{26}$/,"ulid",e)}cidrv4(e){return this.addFormat(/^(?:(?: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]?)\/(?:3[0-2]|[12]?[0-9])$/,"cidrv4",e)}cidrv6(e){return this.addFormat(/^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$|^::(?:[0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$|^(?:[0-9a-fA-F]{1,4}:){1,7}:\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,"cidrv6",e)}e164(e){return this.addFormat(/^\+[1-9]\d{1,14}$/,"e164",e)}xid(e){return this.addFormat(/^[A-HJKMNP-TV-Z0-9]{20}$/,"xid",e)}guid(e){return this.addFormat(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/i,"guid",e)}ksuid(e){return this.addFormat(/^[0-9A-Za-z]{27}$/,"ksuid",e)}date(e){return this.addFormat(/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/,"date",e)}time(e){return this.addFormat(/^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?$/,"time",e)}datetime(e){return this.addFormat(/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?Z?$/,"datetime",e)}duration(e){return this.addFormat(/^-?P(?!$)(?:\d+(?:\.\d+)?Y)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?W)?(?:\d+(?:\.\d+)?D)?(?:T(?=\d)(?:\d+(?:\.\d+)?H)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?S)?)?$/,"duration",e)}}class VldCoerceStringV2 extends VldStringV2{constructor(t=c){super(t),this.validatorType=e.COERCE_STRING}static create(){return new VldCoerceStringV2}parse(e){let t;if("string"==typeof e)t=e;else if("number"==typeof e)t=String(e);else if("boolean"==typeof e)t=e?"true":"false";else if("bigint"==typeof e)t=e.toString();else if("symbol"==typeof e)t=String(e);else{if(null==e)throw new Error(a().coercionFailed("string",e));t=e instanceof Date?e.toISOString():Array.isArray(e)?e.join(","):e instanceof RegExp?e.toString():e instanceof Error?e.message||e.toString():String(e)}if(t.length>1e6)throw new Error(a().coercionFailed("string",e));const s=t.replace(/[\x00-\x1F\x7F]/g,"");return super.parse(s)}}export{VldCheckEmail,VldCheckEndsWith,VldCheckIncludes,VldCheckIp,VldCheckIpv4,VldCheckIpv6,VldCheckLength,VldCheckMax,VldCheckMin,VldCheckRegex,VldCheckRegexFormat,VldCheckStartsWith,VldCheckUrl,VldCheckUuid,VldCoerceStringV2,VldStringCheck,VldStringV2};

package/dist/validators/string.js

@@ -1 +1 @@
-import{VldBase as s,VLD_VALIDATOR_TYPES as e,resolveErrorMessage as t}from"./base.js";import{getMessages as r}from"../locales/runtime.js";import{i}from"../chunks/ip-validation-g5LWgy9t.js";import{V as n,c as a,g as c}from"../chunks/errors-core-CerMg2rq.js";const o={email:/^[^\s@]+@[^\s@]+\.[^\s@]+$/,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?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)$/,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]?)$/,uuidv4:/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,uuidv6:/^[0-9a-f]{8}-[0-9a-f]{4}-6[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,uuidv7:/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,emoji:/^(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F)(?:\u200D(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F))*$/u,base64:/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,base64url:/^[A-Za-z0-9_-]*$/,jwt:/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*$/,nanoid:/^[A-Za-z0-9_-]{21}$/,cuid:/^c[^\s-]{8,}$/i,cuid2:/^[0-9a-z]+$/,ulid:/^[0-9A-HJKMNP-TV-Z]{26}$/,cidrv4:/^(?:(?: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]?)\/(?:3[0-2]|[12]?[0-9])$/,cidrv6:/^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$|^::(?:[0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$|^(?:[0-9a-fA-F]{1,4}:){1,7}:\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,e164:/^\+[1-9]\d{1,14}$/,xid:/^[A-HJKMNP-TV-Z0-9]{20}$/,guid:/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/i,ksuid:/^[0-9A-Za-z]{27}$/,isoDate:/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/,isoTime:/^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?$/,isoDateTime:/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?Z?$/,isoDuration:/^-?P(?!$)(?:\d+(?:\.\d+)?Y)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?W)?(?:\d+(?:\.\d+)?D)?(?:T(?=\d)(?:\d+(?:\.\d+)?H)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?S)?)?$/};class VldString extends s{constructor(s){super(s?.validatorType||e.STRING),this.config={checks:s?.checks||[],transforms:s?.transforms||[],errorMessage:s?.errorMessage,jsonSchema:s?.jsonSchema,checkMetas:s?.checkMetas},this._checks=this.config.checks,this._transforms=this.config.transforms,this._isSimple=0===this._checks.length&&0===this._transforms.length,this._checkMetas=this.config.checkMetas}static create(){return new VldString}get isSimple(){return this._isSimple}get minLength(){return this.config.jsonSchema?.minLength??null}get maxLength(){return this.config.jsonSchema?.maxLength??null}_createCheckIssue(s){switch(s.kind){case"min":return{code:"too_small",path:[],origin:"string",minimum:s.value,inclusive:!0,message:s.message||`Too small: expected string to have >=${s.value} characters`};case"max":return{code:"too_big",path:[],origin:"string",maximum:s.value,inclusive:!0,message:s.message||`Too big: expected string to have <=${s.value} characters`};case"length":return{code:"too_big",path:[],origin:"string",exact:s.value,message:s.message||`Too big: expected string to have exactly ${s.value} characters`};case"format":{const e={code:"invalid_format",path:[],origin:"string",format:s.format,message:s.message||`Invalid ${s.format}`};return void 0!==s.pattern&&(e.pattern=s.pattern),e}case"regex":{const e={code:"invalid_format",path:[],origin:"string",format:"regex",message:s.message||"Invalid string: does not match pattern"};return void 0!==s.pattern&&(e.pattern=s.pattern),e}default:return{code:"custom",path:[],message:s.message||"Invalid string"}}}_runChecks(s){const e=this._checks,t=this._checkMetas;for(let r=0;r<e.length;r++)if(!e[r](s))return t?.[r]??this._fallbackMeta();return null}_fallbackMeta(){return{kind:"other",message:this.config.errorMessage}}parse(s){if("string"!=typeof s)throw new n([a("string",c(s),this.config.errorMessage)]);return this._isSimple?s:this.parseKnownString(s)}parseKnownString(s){if(this._isSimple)return s;const e=this._transforms;let t=s;switch(e.length){case 0:break;case 1:t=e[0](t);break;case 2:t=e[1](e[0](t));break;case 3:t=e[2](e[1](e[0](t)));break;default:for(let s=0;s<e.length;s++)t=e[s](t)}const r=this._runChecks(t);if(r)throw new n([this._createCheckIssue(r)]);return t}safeParse(s){if("string"!=typeof s)return{success:!1,error:new n([a("string",c(s),this.config.errorMessage)])};if(this._isSimple)return{success:!0,data:s};try{return{success:!0,data:this.parseKnownString(s)}}catch(s){return s instanceof n?{success:!1,error:s}:{success:!1,error:(e=s.message,new n([{code:"invalid_string",path:[],message:e}]))}}var e}min(s,e){return new VldString({checks:[...this.config.checks,e=>e.length>=s],transforms:this.config.transforms,errorMessage:t(e,r().stringMin(s)),jsonSchema:{...this.config.jsonSchema,minLength:s},checkMetas:[...this.config.checkMetas??[],{kind:"min",value:s,message:t(e,r().stringMin(s))}]})}max(s,e){return new VldString({checks:[...this.config.checks,e=>e.length<=s],transforms:this.config.transforms,errorMessage:t(e,r().stringMax(s)),jsonSchema:{...this.config.jsonSchema,maxLength:s},checkMetas:[...this.config.checkMetas??[],{kind:"max",value:s,message:t(e,r().stringMax(s))}]})}length(s,e){return new VldString({checks:[...this.config.checks,e=>e.length===s],transforms:this.config.transforms,errorMessage:t(e,r().stringLength(s)),jsonSchema:{...this.config.jsonSchema,exactLength:s},checkMetas:[...this.config.checkMetas??[],{kind:"length",value:s,message:t(e,r().stringLength(s))}]})}email(s){return new VldString({checks:[...this.config.checks,s=>o.email.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringEmail),jsonSchema:{...this.config.jsonSchema,format:"email"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"email",message:t(s,r().stringEmail)}]})}url(s){return new VldString({checks:[...this.config.checks,s=>o.url.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringUrl),jsonSchema:{...this.config.jsonSchema,format:"uri"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"url",message:t(s,r().stringUrl)}]})}uuid(s){return new VldString({checks:[...this.config.checks,s=>o.uuid.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringUuid),jsonSchema:{...this.config.jsonSchema,format:"uuid"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"uuid",message:t(s,r().stringUuid)}]})}format(s,e,r){return new VldString({checks:[...this.config.checks,e=>s.test(e)],transforms:this.config.transforms,errorMessage:t(r,`Invalid ${e}`),jsonSchema:{...this.config.jsonSchema,format:e,pattern:s.source},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:e,pattern:s.source,message:t(r,`Invalid ${e}`)}]})}uuidv4(s){return this.format(o.uuidv4,"uuid",s)}uuidv6(s){return this.format(o.uuidv6,"uuid",s)}uuidv7(s){return this.format(o.uuidv7,"uuid",s)}emoji(s){return this.format(o.emoji,"emoji",s)}base64(s){return this.format(o.base64,"base64",s)}base64url(s){return this.format(o.base64url,"base64url",s)}jwt(s){return this.format(o.jwt,"jwt",s)}nanoid(s){return this.format(o.nanoid,"nanoid",s)}cuid(s){return this.format(o.cuid,"cuid",s)}cuid2(s){return this.format(o.cuid2,"cuid2",s)}ulid(s){return this.format(o.ulid,"ulid",s)}cidrv4(s){return this.format(o.cidrv4,"cidrv4",s)}cidrv6(s){return this.format(o.cidrv6,"cidrv6",s)}e164(s){return this.format(o.e164,"e164",s)}xid(s){return this.format(o.xid,"xid",s)}guid(s){return this.format(o.guid,"guid",s)}ksuid(s){return this.format(o.ksuid,"ksuid",s)}date(s){return this.format(o.isoDate,"date",s)}time(s){return this.format(o.isoTime,"time",s)}datetime(s){return this.format(o.isoDateTime,"datetime",s)}duration(s){return this.format(o.isoDuration,"duration",s)}regex(s,e){return new VldString({checks:[...this.config.checks,e=>s.test(e)],transforms:this.config.transforms,errorMessage:t(e,r().stringRegex),jsonSchema:{...this.config.jsonSchema,pattern:s.source},checkMetas:[...this.config.checkMetas??[],{kind:"regex",pattern:s.source,message:t(e,r().stringRegex)}]})}trim(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.trim()],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}toLowerCase(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.toLowerCase()],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}lowercase(){return this.toLowerCase()}toUpperCase(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.toUpperCase()],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}uppercase(){return this.toUpperCase()}normalize(s){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,e=>e.normalize(s)],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}slugify(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.toLowerCase().trim().replace(/[^\w\s-]/g,"").replace(/[\s_-]+/g,"-").replace(/^-+|-+$/g,"")],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}startsWith(s,e){return new VldString({checks:[...this.config.checks,e=>e.startsWith(s)],transforms:this.config.transforms,errorMessage:t(e,r().stringStartsWith(s)),jsonSchema:this.config.jsonSchema})}endsWith(s,e){return new VldString({checks:[...this.config.checks,e=>e.endsWith(s)],transforms:this.config.transforms,errorMessage:t(e,r().stringEndsWith(s)),jsonSchema:this.config.jsonSchema})}includes(s,e){return new VldString({checks:[...this.config.checks,e=>e.includes(s)],transforms:this.config.transforms,errorMessage:t(e,r().stringIncludes(s)),jsonSchema:this.config.jsonSchema})}ip(s){return new VldString({checks:[...this.config.checks,s=>!(s.length>100)&&(o.ipv4.test(s)||i(s))],transforms:this.config.transforms,errorMessage:t(s,r().stringIp),jsonSchema:{...this.config.jsonSchema,format:"ip"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"ip",message:t(s,r().stringIp)}]})}ipv4(s){return new VldString({checks:[...this.config.checks,s=>o.ipv4.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringIpv4),jsonSchema:{...this.config.jsonSchema,format:"ipv4"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"ipv4",message:t(s,r().stringIpv4)}]})}ipv6(s){return new VldString({checks:[...this.config.checks,s=>i(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringIpv6),jsonSchema:{...this.config.jsonSchema,format:"ipv6"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"ipv6",message:t(s,r().stringIpv6)}]})}nonempty(s){return new VldString({checks:[...this.config.checks,s=>s.length>0],transforms:this.config.transforms,errorMessage:t(s,r().stringEmpty),jsonSchema:{...this.config.jsonSchema,minLength:Math.max(this.config.jsonSchema?.minLength||0,1)},checkMetas:[...this.config.checkMetas??[],{kind:"min",value:1,message:t(s,r().stringEmpty)}]})}}export{VldString};
+import{VldBase as s,VLD_VALIDATOR_TYPES as e,resolveErrorMessage as t}from"./base.js";import{getMessages as r}from"../locales/runtime.js";import{i}from"../chunks/ip-validation-g5LWgy9t.js";import{V as n,c as a,g as c}from"../chunks/errors-core-BU14-Dk8.js";const o={email:/^[^\s@]+@[^\s@]+\.[^\s@]+$/,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?:\/\/(www\.)?[-a-zA-Z0-9@:%._+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_+.~#?&//=]*)$/,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]?)$/,uuidv4:/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,uuidv6:/^[0-9a-f]{8}-[0-9a-f]{4}-6[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,uuidv7:/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,emoji:/^(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F)(?:\u200D(?:\p{Emoji_Presentation}|\p{Emoji}\uFE0F))*$/u,base64:/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,base64url:/^[A-Za-z0-9_-]*$/,jwt:/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*$/,nanoid:/^[A-Za-z0-9_-]{21}$/,cuid:/^c[^\s-]{8,}$/i,cuid2:/^[0-9a-z]+$/,ulid:/^[0-9A-HJKMNP-TV-Z]{26}$/,cidrv4:/^(?:(?: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]?)\/(?:3[0-2]|[12]?[0-9])$/,cidrv6:/^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$|^::(?:[0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4}\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$|^(?:[0-9a-fA-F]{1,4}:){1,7}:\/(?:12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,e164:/^\+[1-9]\d{1,14}$/,xid:/^[A-HJKMNP-TV-Z0-9]{20}$/,guid:/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/i,ksuid:/^[0-9A-Za-z]{27}$/,isoDate:/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/,isoTime:/^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?$/,isoDateTime:/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?Z?$/,isoDuration:/^-?P(?!$)(?:\d+(?:\.\d+)?Y)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?W)?(?:\d+(?:\.\d+)?D)?(?:T(?=\d)(?:\d+(?:\.\d+)?H)?(?:\d+(?:\.\d+)?M)?(?:\d+(?:\.\d+)?S)?)?$/};class VldString extends s{constructor(s){super(s?.validatorType||e.STRING),this.config={checks:s?.checks||[],transforms:s?.transforms||[],errorMessage:s?.errorMessage,jsonSchema:s?.jsonSchema,checkMetas:s?.checkMetas},this._checks=this.config.checks,this._transforms=this.config.transforms,this._isSimple=0===this._checks.length&&0===this._transforms.length,this._checkMetas=this.config.checkMetas}static create(){return new VldString}get isSimple(){return this._isSimple}get minLength(){return this.config.jsonSchema?.minLength??null}get maxLength(){return this.config.jsonSchema?.maxLength??null}_createCheckIssue(s){switch(s.kind){case"min":return{code:"too_small",path:[],origin:"string",minimum:s.value,inclusive:!0,message:s.message||`Too small: expected string to have >=${s.value} characters`};case"max":return{code:"too_big",path:[],origin:"string",maximum:s.value,inclusive:!0,message:s.message||`Too big: expected string to have <=${s.value} characters`};case"length":return{code:"too_big",path:[],origin:"string",exact:s.value,message:s.message||`Too big: expected string to have exactly ${s.value} characters`};case"format":{const e={code:"invalid_format",path:[],origin:"string",format:s.format,message:s.message||`Invalid ${s.format}`};return void 0!==s.pattern&&(e.pattern=s.pattern),e}case"regex":{const e={code:"invalid_format",path:[],origin:"string",format:"regex",message:s.message||"Invalid string: does not match pattern"};return void 0!==s.pattern&&(e.pattern=s.pattern),e}default:return{code:"custom",path:[],message:s.message||"Invalid string"}}}_runChecks(s){const e=this._checks,t=this._checkMetas;for(let r=0;r<e.length;r++)if(!e[r](s))return t?.[r]??this._fallbackMeta();return null}_fallbackMeta(){return{kind:"other",message:this.config.errorMessage}}parse(s){if("string"!=typeof s)throw new n([a("string",c(s),this.config.errorMessage)]);return this._isSimple?s:this.parseKnownString(s)}parseKnownString(s){if(this._isSimple)return s;const e=this._transforms;let t=s;switch(e.length){case 0:break;case 1:t=e[0](t);break;case 2:t=e[1](e[0](t));break;case 3:t=e[2](e[1](e[0](t)));break;default:for(let s=0;s<e.length;s++)t=e[s](t)}const r=this._runChecks(t);if(r)throw new n([this._createCheckIssue(r)]);return t}safeParse(s){if("string"!=typeof s)return{success:!1,error:new n([a("string",c(s),this.config.errorMessage)])};if(this._isSimple)return{success:!0,data:s};try{return{success:!0,data:this.parseKnownString(s)}}catch(s){return s instanceof n?{success:!1,error:s}:{success:!1,error:(e=s.message,new n([{code:"invalid_string",path:[],message:e}]))}}var e}min(s,e){return new VldString({checks:[...this.config.checks,e=>e.length>=s],transforms:this.config.transforms,errorMessage:t(e,r().stringMin(s)),jsonSchema:{...this.config.jsonSchema,minLength:s},checkMetas:[...this.config.checkMetas??[],{kind:"min",value:s,message:t(e,r().stringMin(s))}]})}max(s,e){return new VldString({checks:[...this.config.checks,e=>e.length<=s],transforms:this.config.transforms,errorMessage:t(e,r().stringMax(s)),jsonSchema:{...this.config.jsonSchema,maxLength:s},checkMetas:[...this.config.checkMetas??[],{kind:"max",value:s,message:t(e,r().stringMax(s))}]})}length(s,e){return new VldString({checks:[...this.config.checks,e=>e.length===s],transforms:this.config.transforms,errorMessage:t(e,r().stringLength(s)),jsonSchema:{...this.config.jsonSchema,exactLength:s},checkMetas:[...this.config.checkMetas??[],{kind:"length",value:s,message:t(e,r().stringLength(s))}]})}email(s){return new VldString({checks:[...this.config.checks,s=>o.email.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringEmail),jsonSchema:{...this.config.jsonSchema,format:"email"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"email",message:t(s,r().stringEmail)}]})}url(s){return new VldString({checks:[...this.config.checks,s=>o.url.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringUrl),jsonSchema:{...this.config.jsonSchema,format:"uri"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"url",message:t(s,r().stringUrl)}]})}uuid(s){return new VldString({checks:[...this.config.checks,s=>o.uuid.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringUuid),jsonSchema:{...this.config.jsonSchema,format:"uuid"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"uuid",message:t(s,r().stringUuid)}]})}format(s,e,r){return new VldString({checks:[...this.config.checks,e=>s.test(e)],transforms:this.config.transforms,errorMessage:t(r,`Invalid ${e}`),jsonSchema:{...this.config.jsonSchema,format:e,pattern:s.source},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:e,pattern:s.source,message:t(r,`Invalid ${e}`)}]})}uuidv4(s){return this.format(o.uuidv4,"uuid",s)}uuidv6(s){return this.format(o.uuidv6,"uuid",s)}uuidv7(s){return this.format(o.uuidv7,"uuid",s)}emoji(s){return this.format(o.emoji,"emoji",s)}base64(s){return this.format(o.base64,"base64",s)}base64url(s){return this.format(o.base64url,"base64url",s)}jwt(s){return this.format(o.jwt,"jwt",s)}nanoid(s){return this.format(o.nanoid,"nanoid",s)}cuid(s){return this.format(o.cuid,"cuid",s)}cuid2(s){return this.format(o.cuid2,"cuid2",s)}ulid(s){return this.format(o.ulid,"ulid",s)}cidrv4(s){return this.format(o.cidrv4,"cidrv4",s)}cidrv6(s){return this.format(o.cidrv6,"cidrv6",s)}e164(s){return this.format(o.e164,"e164",s)}xid(s){return this.format(o.xid,"xid",s)}guid(s){return this.format(o.guid,"guid",s)}ksuid(s){return this.format(o.ksuid,"ksuid",s)}date(s){return this.format(o.isoDate,"date",s)}time(s){return this.format(o.isoTime,"time",s)}datetime(s){return this.format(o.isoDateTime,"datetime",s)}duration(s){return this.format(o.isoDuration,"duration",s)}regex(s,e){return new VldString({checks:[...this.config.checks,e=>s.test(e)],transforms:this.config.transforms,errorMessage:t(e,r().stringRegex),jsonSchema:{...this.config.jsonSchema,pattern:s.source},checkMetas:[...this.config.checkMetas??[],{kind:"regex",pattern:s.source,message:t(e,r().stringRegex)}]})}trim(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.trim()],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}toLowerCase(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.toLowerCase()],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}lowercase(){return this.toLowerCase()}toUpperCase(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.toUpperCase()],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}uppercase(){return this.toUpperCase()}normalize(s){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,e=>e.normalize(s)],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}slugify(){return new VldString({checks:this.config.checks,transforms:[...this.config.transforms,s=>s.toLowerCase().trim().replace(/[^\w\s-]/g,"").replace(/[\s_-]+/g,"-").replace(/^-+|-+$/g,"")],errorMessage:this.config.errorMessage,jsonSchema:this.config.jsonSchema})}startsWith(s,e){return new VldString({checks:[...this.config.checks,e=>e.startsWith(s)],transforms:this.config.transforms,errorMessage:t(e,r().stringStartsWith(s)),jsonSchema:this.config.jsonSchema})}endsWith(s,e){return new VldString({checks:[...this.config.checks,e=>e.endsWith(s)],transforms:this.config.transforms,errorMessage:t(e,r().stringEndsWith(s)),jsonSchema:this.config.jsonSchema})}includes(s,e){return new VldString({checks:[...this.config.checks,e=>e.includes(s)],transforms:this.config.transforms,errorMessage:t(e,r().stringIncludes(s)),jsonSchema:this.config.jsonSchema})}ip(s){return new VldString({checks:[...this.config.checks,s=>!(s.length>100)&&(o.ipv4.test(s)||i(s))],transforms:this.config.transforms,errorMessage:t(s,r().stringIp),jsonSchema:{...this.config.jsonSchema,format:"ip"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"ip",message:t(s,r().stringIp)}]})}ipv4(s){return new VldString({checks:[...this.config.checks,s=>o.ipv4.test(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringIpv4),jsonSchema:{...this.config.jsonSchema,format:"ipv4"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"ipv4",message:t(s,r().stringIpv4)}]})}ipv6(s){return new VldString({checks:[...this.config.checks,s=>i(s)],transforms:this.config.transforms,errorMessage:t(s,r().stringIpv6),jsonSchema:{...this.config.jsonSchema,format:"ipv6"},checkMetas:[...this.config.checkMetas??[],{kind:"format",format:"ipv6",message:t(s,r().stringIpv6)}]})}nonempty(s){return new VldString({checks:[...this.config.checks,s=>s.length>0],transforms:this.config.transforms,errorMessage:t(s,r().stringEmpty),jsonSchema:{...this.config.jsonSchema,minLength:Math.max(this.config.jsonSchema?.minLength||0,1)},checkMetas:[...this.config.checkMetas??[],{kind:"min",value:1,message:t(s,r().stringEmpty)}]})}}export{VldString};

package/dist/validators/symbol.js

@@ -1 +1 @@
-import{VldBase as r,VLD_VALIDATOR_TYPES as e}from"./base.js";import{getMessages as s}from"../locales/runtime.js";import{V as o}from"../chunks/errors-core-CerMg2rq.js";class VldSymbol extends r{constructor(r){super(e.SYMBOL),this.errorMessage=r}static create(){return new VldSymbol}get isSimple(){return!0}parse(r){if("symbol"!=typeof r)throw new Error(this.errorMessage||s().invalidSymbol);return r}parseKnownSymbol(r){return r}safeParse(r){return"symbol"==typeof r?{success:!0,data:r}:{success:!1,error:(e=this.errorMessage||s().invalidSymbol,new o([{code:"invalid_type",path:[],message:e}]))};var e}}export{VldSymbol};
+import{VldBase as r,VLD_VALIDATOR_TYPES as e}from"./base.js";import{getMessages as s}from"../locales/runtime.js";import{V as o}from"../chunks/errors-core-BU14-Dk8.js";class VldSymbol extends r{constructor(r){super(e.SYMBOL),this.errorMessage=r}static create(){return new VldSymbol}get isSimple(){return!0}parse(r){if("symbol"!=typeof r)throw new Error(this.errorMessage||s().invalidSymbol);return r}parseKnownSymbol(r){return r}safeParse(r){return"symbol"==typeof r?{success:!0,data:r}:{success:!1,error:(e=this.errorMessage||s().invalidSymbol,new o([{code:"invalid_type",path:[],message:e}]))};var e}}export{VldSymbol};

package/dist/validators/tuple.js

@@ -1 +1 @@
-import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{getMessages as t}from"../locales/runtime.js";import{V as s}from"../chunks/errors-core-CerMg2rq.js";function i(e){return new s([{code:"invalid_array",path:[],message:e}])}class VldTuple extends e{constructor(e,t,s=null){super(r.TUPLE),this.validators=e,this.errorMessage=t,this.restValidator=s,this._length=e.length,this._validatorTypes=e.map(e=>e.validatorType),this._simpleItemModes=e.map((e,r)=>this.getSimpleItemMode(e,this._validatorTypes[r])),this._simpleItemValues=e.map((e,r)=>"literal"===this._simpleItemModes[r]?e.literal:void 0)}get items(){return this.validators}getSimpleItemMode(e,t){if(!0===e.isSimple)switch(t){case r.STRING:return"string";case r.NUMBER:return"number";case r.BOOLEAN:return"boolean";case r.BIGINT:return"bigint";case r.SYMBOL:return"symbol";case r.NULL:return"null";case r.UNDEFINED:case r.VOID:return"undefinedValue";case r.LITERAL:return"literal";case r.ANY:case r.UNKNOWN:return"passthrough";default:return}}getSimpleItemError(e,r,s){switch(e){case"string":return t().invalidString;case"number":return t().invalidNumber;case"boolean":return t().invalidBoolean;case"bigint":return t().invalidBigint;case"symbol":return t().invalidSymbol;case"null":return"Expected null, received "+typeof s;case"undefinedValue":return t().expectedUndefined;case"literal":return t().literalExpected(JSON.stringify(r),JSON.stringify(s));default:return t().invalidTuple}}static create(...e){return new VldTuple(e)}rest(e){return new VldTuple(this.validators,this.errorMessage,e)}parse(e){if(!Array.isArray(e))throw new Error(this.errorMessage||t().invalidTuple);return this.parseKnownTuple(e)}parseKnownTuple(e){if(null===this.restValidator&&e.length!==this._length||null!==this.restValidator&&e.length<this._length)throw new Error(this.errorMessage||t().tupleLength(this._length,e.length));const r=new Array(e.length);for(let s=0;s<this._length;s++){const i=this._simpleItemModes[s],n=e[s];if(void 0!==i)switch(i){case"string":if("string"!=typeof n)throw new Error(t().arrayItem(s,t().invalidString));r[s]=n;continue;case"number":if("number"!=typeof n||isNaN(n))throw new Error(t().arrayItem(s,t().invalidNumber));r[s]=n;continue;case"boolean":if("boolean"!=typeof n)throw new Error(t().arrayItem(s,t().invalidBoolean));r[s]=n;continue;case"bigint":if("bigint"!=typeof n)throw new Error(t().arrayItem(s,t().invalidBigint));r[s]=n;continue;case"symbol":if("symbol"!=typeof n)throw new Error(t().arrayItem(s,t().invalidSymbol));r[s]=n;continue;case"null":if(null!==n)throw new Error(t().arrayItem(s,this.getSimpleItemError(i,void 0,n)));r[s]=null;continue;case"undefinedValue":if(void 0!==n)throw new Error(t().arrayItem(s,t().expectedUndefined));r[s]=void 0;continue;case"literal":{const e=this._simpleItemValues[s];if(n!==e)throw new Error(t().arrayItem(s,this.getSimpleItemError(i,e,n)));r[s]=e;continue}case"passthrough":r[s]=n;continue}try{const e=this.validators[s];r[s]=e.parse(n)}catch(e){throw new Error(t().arrayItem(s,e.message))}}if(this.restValidator)for(let s=this._length;s<e.length;s++)try{r[s]=this.restValidator.parse(e[s])}catch(e){throw new Error(t().arrayItem(s,e.message))}return r}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:i(e.message)}}}encode(e){if(!Array.isArray(e))throw new Error(this.errorMessage||t().invalidTuple);this.validateEncodedLength(e.length);const r=new Array(e.length);for(let t=0;t<this._length;t++)r[t]=this.validators[t].encode(e[t]);if(this.restValidator)for(let t=this._length;t<e.length;t++)r[t]=this.restValidator.encode(e[t]);return r}safeEncode(e){try{return{success:!0,data:this.encode(e)}}catch(e){return{success:!1,error:i(e.message)}}}async encodeAsync(e){if(!Array.isArray(e))throw new Error(this.errorMessage||t().invalidTuple);this.validateEncodedLength(e.length);const r=new Array(e.length);for(let t=0;t<this._length;t++)r[t]=await this.validators[t].encodeAsync(e[t]);if(this.restValidator)for(let t=this._length;t<e.length;t++)r[t]=await this.restValidator.encodeAsync(e[t]);return r}async safeEncodeAsync(e){try{return{success:!0,data:await this.encodeAsync(e)}}catch(e){return{success:!1,error:i(e.message)}}}validateEncodedLength(e){if(null===this.restValidator&&e!==this._length||null!==this.restValidator&&e<this._length)throw new Error(this.errorMessage||t().tupleLength(this._length,e))}}export{VldTuple};
+import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{getMessages as t}from"../locales/runtime.js";import{V as s}from"../chunks/errors-core-BU14-Dk8.js";function i(e){return new s([{code:"invalid_array",path:[],message:e}])}class VldTuple extends e{constructor(e,t,s=null){super(r.TUPLE),this.validators=e,this.errorMessage=t,this.restValidator=s,this._length=e.length,this._validatorTypes=e.map(e=>e.validatorType),this._simpleItemModes=e.map((e,r)=>this.getSimpleItemMode(e,this._validatorTypes[r])),this._simpleItemValues=e.map((e,r)=>"literal"===this._simpleItemModes[r]?e.literal:void 0)}get items(){return this.validators}getSimpleItemMode(e,t){if(!0===e.isSimple)switch(t){case r.STRING:return"string";case r.NUMBER:return"number";case r.BOOLEAN:return"boolean";case r.BIGINT:return"bigint";case r.SYMBOL:return"symbol";case r.NULL:return"null";case r.UNDEFINED:case r.VOID:return"undefinedValue";case r.LITERAL:return"literal";case r.ANY:case r.UNKNOWN:return"passthrough";default:return}}getSimpleItemError(e,r,s){switch(e){case"string":return t().invalidString;case"number":return t().invalidNumber;case"boolean":return t().invalidBoolean;case"bigint":return t().invalidBigint;case"symbol":return t().invalidSymbol;case"null":return"Expected null, received "+typeof s;case"undefinedValue":return t().expectedUndefined;case"literal":return t().literalExpected(JSON.stringify(r),JSON.stringify(s));default:return t().invalidTuple}}static create(...e){return new VldTuple(e)}rest(e){return new VldTuple(this.validators,this.errorMessage,e)}parse(e){if(!Array.isArray(e))throw new Error(this.errorMessage||t().invalidTuple);return this.parseKnownTuple(e)}parseKnownTuple(e){if(null===this.restValidator&&e.length!==this._length||null!==this.restValidator&&e.length<this._length)throw new Error(this.errorMessage||t().tupleLength(this._length,e.length));const r=new Array(e.length);for(let s=0;s<this._length;s++){const i=this._simpleItemModes[s],n=e[s];if(void 0!==i)switch(i){case"string":if("string"!=typeof n)throw new Error(t().arrayItem(s,t().invalidString));r[s]=n;continue;case"number":if("number"!=typeof n||isNaN(n))throw new Error(t().arrayItem(s,t().invalidNumber));r[s]=n;continue;case"boolean":if("boolean"!=typeof n)throw new Error(t().arrayItem(s,t().invalidBoolean));r[s]=n;continue;case"bigint":if("bigint"!=typeof n)throw new Error(t().arrayItem(s,t().invalidBigint));r[s]=n;continue;case"symbol":if("symbol"!=typeof n)throw new Error(t().arrayItem(s,t().invalidSymbol));r[s]=n;continue;case"null":if(null!==n)throw new Error(t().arrayItem(s,this.getSimpleItemError(i,void 0,n)));r[s]=null;continue;case"undefinedValue":if(void 0!==n)throw new Error(t().arrayItem(s,t().expectedUndefined));r[s]=void 0;continue;case"literal":{const e=this._simpleItemValues[s];if(n!==e)throw new Error(t().arrayItem(s,this.getSimpleItemError(i,e,n)));r[s]=e;continue}case"passthrough":r[s]=n;continue}try{const e=this.validators[s];r[s]=e.parse(n)}catch(e){throw new Error(t().arrayItem(s,e.message))}}if(this.restValidator)for(let s=this._length;s<e.length;s++)try{r[s]=this.restValidator.parse(e[s])}catch(e){throw new Error(t().arrayItem(s,e.message))}return r}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:i(e.message)}}}encode(e){if(!Array.isArray(e))throw new Error(this.errorMessage||t().invalidTuple);this.validateEncodedLength(e.length);const r=new Array(e.length);for(let t=0;t<this._length;t++)r[t]=this.validators[t].encode(e[t]);if(this.restValidator)for(let t=this._length;t<e.length;t++)r[t]=this.restValidator.encode(e[t]);return r}safeEncode(e){try{return{success:!0,data:this.encode(e)}}catch(e){return{success:!1,error:i(e.message)}}}async encodeAsync(e){if(!Array.isArray(e))throw new Error(this.errorMessage||t().invalidTuple);this.validateEncodedLength(e.length);const r=new Array(e.length);for(let t=0;t<this._length;t++)r[t]=await this.validators[t].encodeAsync(e[t]);if(this.restValidator)for(let t=this._length;t<e.length;t++)r[t]=await this.restValidator.encodeAsync(e[t]);return r}async safeEncodeAsync(e){try{return{success:!0,data:await this.encodeAsync(e)}}catch(e){return{success:!1,error:i(e.message)}}}validateEncodedLength(e){if(null===this.restValidator&&e!==this._length||null!==this.restValidator&&e<this._length)throw new Error(this.errorMessage||t().tupleLength(this._length,e))}}export{VldTuple};

package/dist/validators/uint8array.js

@@ -1 +1 @@
-import{VldBase as t,VLD_VALIDATOR_TYPES as r}from"./base.js";import{createIssue as n}from"../errors.js";import{getMessages as e}from"../locales/runtime.js";import{V as i}from"../chunks/errors-core-CerMg2rq.js";class VldUint8Array extends t{constructor(t){super(r.UINT8_ARRAY),this.config=t||{}}parse(t){const r=this.safeParse(t);if(!r.success)throw r.error;return r.data}safeParse(t){return t instanceof Uint8Array?void 0!==this.config.exactLength&&t.length!==this.config.exactLength?{success:!1,error:new i([n("custom",[],e().uint8ArrayExactLength(this.config.exactLength))])}:void 0!==this.config.minLength&&t.length<this.config.minLength?{success:!1,error:new i([n("custom",[],e().uint8ArrayMinLength(this.config.minLength))])}:void 0!==this.config.maxLength&&t.length>this.config.maxLength?{success:!1,error:new i([n("custom",[],e().uint8ArrayMaxLength(this.config.maxLength))])}:{success:!0,data:t}:{success:!1,error:new i([n("invalid_type",[],e().expectedUint8Array)])}}min(t){return new VldUint8Array({...this.config,minLength:t})}max(t){return new VldUint8Array({...this.config,maxLength:t})}length(t){return new VldUint8Array({exactLength:t,minLength:void 0,maxLength:void 0})}static create(){return new VldUint8Array}}export{VldUint8Array};
+import{VldBase as t,VLD_VALIDATOR_TYPES as r}from"./base.js";import{createIssue as n}from"../errors.js";import{getMessages as e}from"../locales/runtime.js";import{V as i}from"../chunks/errors-core-BU14-Dk8.js";class VldUint8Array extends t{constructor(t){super(r.UINT8_ARRAY),this.config=t||{}}parse(t){const r=this.safeParse(t);if(!r.success)throw r.error;return r.data}safeParse(t){return t instanceof Uint8Array?void 0!==this.config.exactLength&&t.length!==this.config.exactLength?{success:!1,error:new i([n("custom",[],e().uint8ArrayExactLength(this.config.exactLength))])}:void 0!==this.config.minLength&&t.length<this.config.minLength?{success:!1,error:new i([n("custom",[],e().uint8ArrayMinLength(this.config.minLength))])}:void 0!==this.config.maxLength&&t.length>this.config.maxLength?{success:!1,error:new i([n("custom",[],e().uint8ArrayMaxLength(this.config.maxLength))])}:{success:!0,data:t}:{success:!1,error:new i([n("invalid_type",[],e().expectedUint8Array)])}}min(t){return new VldUint8Array({...this.config,minLength:t})}max(t){return new VldUint8Array({...this.config,maxLength:t})}length(t){return new VldUint8Array({exactLength:t,minLength:void 0,maxLength:void 0})}static create(){return new VldUint8Array}}export{VldUint8Array};

package/dist/validators/undefined.js

@@ -1 +1 @@
-import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{V as s}from"../chunks/errors-core-CerMg2rq.js";class VldUndefined extends e{constructor(){super(r.UNDEFINED)}static create(){return new VldUndefined}get isSimple(){return!0}parse(e){if(void 0!==e)throw new Error("Expected undefined, received "+typeof e)}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:(r=e.message,new s([{code:"invalid_type",path:[],message:r}]))}}var r}}export{VldUndefined};
+import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{V as s}from"../chunks/errors-core-BU14-Dk8.js";class VldUndefined extends e{constructor(){super(r.UNDEFINED)}static create(){return new VldUndefined}get isSimple(){return!0}parse(e){if(void 0!==e)throw new Error("Expected undefined, received "+typeof e)}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:(r=e.message,new s([{code:"invalid_type",path:[],message:r}]))}}var r}}export{VldUndefined};

package/dist/validators/union-v2.d.ts

@@ -0,0 +1,28 @@
+/**
+ * VldUnionV2 — single-def union validator.
+ * The legacy VldUnion has 5 own properties (validators, errorMessage,
+ * typeCheckers, simpleModes, simpleValues). V2 collapses them into a
+ * single `__def`, reducing per-instance shape size and letting V8 use
+ * a more uniform hidden class.
+ *
+ * Public API mirrors VldUnion 1:1. Exposed via v.unionV2().
+ */
+import { VldBase, type ParseResult } from './base.js';
+type SimpleUnionMode = 'string' | 'number' | 'boolean' | 'bigint' | 'symbol' | 'null' | 'undefined' | 'literal' | 'passthrough' | undefined;
+export interface VldUnionDef {
+    readonly type: 'union';
+    readonly validators: ReadonlyArray<VldBase<any, any>>;
+    readonly typeCheckers: ReadonlyArray<(value: unknown) => boolean>;
+    readonly simpleModes: ReadonlyArray<SimpleUnionMode>;
+    readonly simpleValues: ReadonlyArray<unknown>;
+    readonly errorMessage?: string | undefined;
+}
+export declare class VldUnionV2<T extends readonly VldBase<any, any>[]> extends VldBase<T[number] extends VldBase<any, infer U> ? U : never, T[number] extends VldBase<any, infer U> ? U : never> {
+    readonly __def: VldUnionDef;
+    constructor(validators: T, errorMessage?: string);
+    static create<T extends readonly VldBase<any, any>[]>(...validators: T): VldUnionV2<T>;
+    get options(): T;
+    parse(value: unknown): T[number] extends VldBase<any, infer U> ? U : never;
+    safeParse(value: unknown): ParseResult<T[number] extends VldBase<any, infer U> ? U : never>;
+}
+export {};

package/dist/validators/union-v2.js

@@ -0,0 +1 @@
+import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{V as s}from"../chunks/errors-core-BU14-Dk8.js";import{getMessages as t}from"../locales/runtime.js";function n(e){if(!0===e.isSimple)switch(e.validatorType){case r.STRING:return"string";case r.NUMBER:return"number";case r.BOOLEAN:return"boolean";case r.BIGINT:return"bigint";case r.SYMBOL:return"symbol";case r.NULL:return"null";case r.UNDEFINED:case r.VOID:return"undefined";case r.LITERAL:return"literal";case r.ANY:case r.UNKNOWN:return"passthrough";default:return}}function a(e){switch(e.validatorType){case r.STRING:return e=>"string"==typeof e;case r.NUMBER:return e=>"number"==typeof e&&!isNaN(e);case r.BOOLEAN:return e=>"boolean"==typeof e;case r.BIGINT:return e=>"bigint"==typeof e;case r.SYMBOL:return e=>"symbol"==typeof e;case r.NAN:return e=>"number"==typeof e&&Number.isNaN(e);case r.ARRAY:return Array.isArray;case r.OBJECT:return e=>"object"==typeof e&&null!==e&&!Array.isArray(e);case r.NULL:return e=>null===e;case r.UNDEFINED:case r.VOID:return e=>void 0===e;case r.ENUM:return e=>"string"==typeof e||"number"==typeof e;case r.LITERAL:{const r=e.literal;return e=>e===r}case r.NEVER:return()=>!1;case r.ANY:case r.UNKNOWN:default:return()=>!0}}class VldUnionV2 extends e{constructor(e,s){super(r.UNION),this.__def=function(e,r){const s=e.map(a),t=e.map(n),c=e.map((e,r)=>"literal"===t[r]?e.literal:void 0);return{type:"union",validators:e,typeCheckers:s,simpleModes:t,simpleValues:c,errorMessage:r}}(e,s)}static create(...e){return new VldUnionV2(e)}get options(){return this.__def.validators}parse(e){const r=[],{validators:s,typeCheckers:n,simpleModes:a,simpleValues:c}=this.__def;for(let t=0;t<s.length;t++){const o=s[t],u=n[t];if(u&&!u(e))continue;const i=a[t];if(void 0!==i)switch(i){case"string":case"number":case"boolean":case"bigint":case"symbol":case"passthrough":return e;case"null":return null;case"undefined":return;case"literal":return c[t]}try{return o.parse(e)}catch(e){r.push(e instanceof Error?e.message:String(e))}}throw new Error(this.__def.errorMessage||t().unionNoMatch(r))}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:e instanceof s?e:new s([{code:"custom",path:[],message:e.message}])}}}}export{VldUnionV2};

package/dist/validators/void.js

@@ -1 +1 @@
-import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{getMessages as s}from"../locales/runtime.js";import{V as o}from"../chunks/errors-core-CerMg2rq.js";class VldVoid extends e{constructor(){super(r.VOID)}static create(){return new VldVoid}get isSimple(){return!0}parse(e){if(void 0!==e)throw new Error(s().expectedUndefined)}safeParse(e){return void 0===e?{success:!0,data:void 0}:{success:!1,error:new o([{code:"invalid_type",path:[],message:s().expectedUndefined}])}}}export{VldVoid};
+import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{getMessages as s}from"../locales/runtime.js";import{V as o}from"../chunks/errors-core-BU14-Dk8.js";class VldVoid extends e{constructor(){super(r.VOID)}static create(){return new VldVoid}get isSimple(){return!0}parse(e){if(void 0!==e)throw new Error(s().expectedUndefined)}safeParse(e){return void 0===e?{success:!0,data:void 0}:{success:!1,error:new o([{code:"invalid_type",path:[],message:s().expectedUndefined}])}}}export{VldVoid};

package/dist/validators/wrapper-v2.d.ts

@@ -0,0 +1,74 @@
+/**
+ * V2 wrappers: VldOptionalV2, VldNullableV2, VldNullishV2, VldRefineV2, VldTransformV2.
+ * All single-def pattern. Public API mirrors legacy wrappers 1:1.
+ */
+import { VldBase, type ParseResult } from './base.js';
+export interface VldOptionalDef<TInput, TOutput> {
+    readonly type: 'optional';
+    readonly inner: VldBase<TInput, TOutput>;
+}
+export declare class VldOptionalV2<TInput, TOutput> extends VldBase<TInput | undefined, TOutput | undefined> {
+    readonly __def: VldOptionalDef<TInput, TOutput>;
+    constructor(inner: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldOptionalV2<TInput, TOutput>;
+    parse(value: unknown): TOutput | undefined;
+    safeParse(value: unknown): ParseResult<TOutput | undefined>;
+    unwrap(): VldBase<TInput, TOutput>;
+}
+export interface VldNullableDef<TInput, TOutput> {
+    readonly type: 'nullable';
+    readonly inner: VldBase<TInput, TOutput>;
+}
+export declare class VldNullableV2<TInput, TOutput> extends VldBase<TInput | null, TOutput | null> {
+    readonly __def: VldNullableDef<TInput, TOutput>;
+    constructor(inner: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullableV2<TInput, TOutput>;
+    parse(value: unknown): TOutput | null;
+    safeParse(value: unknown): ParseResult<TOutput | null>;
+    unwrap(): VldBase<TInput, TOutput>;
+}
+export interface VldNullishDef<TInput, TOutput> {
+    readonly type: 'nullish';
+    readonly inner: VldBase<TInput, TOutput>;
+}
+export declare class VldNullishV2<TInput, TOutput> extends VldBase<TInput | null | undefined, TOutput | null | undefined> {
+    readonly __def: VldNullishDef<TInput, TOutput>;
+    constructor(inner: VldBase<TInput, TOutput>);
+    static create<TInput, TOutput>(baseValidator: VldBase<TInput, TOutput>): VldNullishV2<TInput, TOutput>;
+    parse(value: unknown): TOutput | null | undefined;
+    safeParse(value: unknown): ParseResult<TOutput | null | undefined>;
+    unwrap(): VldBase<TInput, TOutput>;
+}
+export interface VldRefineDef<TInput, TBase> {
+    readonly type: 'refine';
+    readonly inner: VldBase<TInput, TBase>;
+    readonly predicate: (value: TBase) => boolean | Promise<boolean>;
+    readonly message: string;
+    readonly path?: ReadonlyArray<string | number> | undefined;
+}
+export declare class VldRefineV2<TInput, TBase, TOutput extends TBase = TBase> extends VldBase<TInput, TOutput> {
+    readonly __def: VldRefineDef<TInput, TBase>;
+    constructor(inner: VldBase<TInput, TBase>, predicate: (value: TBase) => boolean | Promise<boolean>, message?: string, path?: ReadonlyArray<string | number>);
+    static create<TInput, TBase, TOutput extends TBase = TBase>(inner: VldBase<TInput, TBase>, predicate: (value: TBase) => value is TOutput, message?: string): VldRefineV2<TInput, TBase, TOutput>;
+    static create<TInput, TBase, TOutput extends TBase = TBase>(inner: VldBase<TInput, TBase>, predicate: (value: TBase) => boolean | Promise<boolean>, message?: string): VldRefineV2<TInput, TBase, TOutput>;
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+    parseAsync(value: unknown): Promise<TOutput>;
+    safeParseAsync(value: unknown): Promise<ParseResult<TOutput>>;
+    unwrap(): VldBase<TInput, TBase>;
+}
+export interface VldTransformDef<TInput, TBase, TOutput> {
+    readonly type: 'transform';
+    readonly inner: VldBase<TInput, TBase>;
+    readonly transformer: (value: TBase) => TOutput | Promise<TOutput>;
+}
+export declare class VldTransformV2<TInput, TBase, TOutput> extends VldBase<TInput, TOutput> {
+    readonly __def: VldTransformDef<TInput, TBase, TOutput>;
+    constructor(inner: VldBase<TInput, TBase>, transformer: (value: TBase) => TOutput | Promise<TOutput>);
+    static create<TInput, TBase, TOutput>(inner: VldBase<TInput, TBase>, transformer: (value: TBase) => TOutput | Promise<TOutput>): VldTransformV2<TInput, TBase, TOutput>;
+    parse(value: unknown): TOutput;
+    safeParse(value: unknown): ParseResult<TOutput>;
+    parseAsync(value: unknown): Promise<TOutput>;
+    safeParseAsync(value: unknown): Promise<ParseResult<TOutput>>;
+    unwrap(): VldBase<TInput, TBase>;
+}

package/dist/validators/wrapper-v2.js

@@ -0,0 +1 @@
+import{VldBase as e,VLD_VALIDATOR_TYPES as r,ensureVldError as s}from"./base.js";import{V as t}from"../chunks/errors-core-BU14-Dk8.js";class VldOptionalV2 extends e{constructor(e){super(r.OPTIONAL),this.__def=Object.freeze({type:"optional",inner:e})}static create(e){return new VldOptionalV2(e)}parse(e){if(void 0!==e)return this.__def.inner.parse(e)}safeParse(e){return void 0===e?{success:!0,data:void 0}:this.__def.inner.safeParse(e)}unwrap(){return this.__def.inner}}class VldNullableV2 extends e{constructor(e){super(r.NULLABLE),this.__def=Object.freeze({type:"nullable",inner:e})}static create(e){return new VldNullableV2(e)}parse(e){return null===e?null:this.__def.inner.parse(e)}safeParse(e){return null===e?{success:!0,data:null}:this.__def.inner.safeParse(e)}unwrap(){return this.__def.inner}}class VldNullishV2 extends e{constructor(e){super(r.NULLISH),this.__def=Object.freeze({type:"nullish",inner:e})}static create(e){return new VldNullishV2(e)}parse(e){return null==e?e:this.__def.inner.parse(e)}safeParse(e){return null==e?{success:!0,data:e}:this.__def.inner.safeParse(e)}unwrap(){return this.__def.inner}}class VldRefineV2 extends e{constructor(e,s,t="Refinement check failed",n){super(r.REFINE),this.__def=Object.freeze({type:"refine",inner:e,predicate:s,message:t,path:n})}static create(e,r,s="Refinement check failed"){return new VldRefineV2(e,r,s)}parse(e){const r=this.__def.inner.parse(e),s=this.__def.predicate(r);if(s instanceof Promise)throw new Error("Use parseAsync for async refinements");if(!s)throw new t([{code:"custom",path:this.__def.path?[...this.__def.path]:[],message:this.__def.message}]);return r}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:s(e)}}}async parseAsync(e){const r=await this.__def.inner.parseAsync(e);if(!await this.__def.predicate(r))throw new t([{code:"custom",path:[],message:this.__def.message}]);return r}async safeParseAsync(e){try{return{success:!0,data:await this.parseAsync(e)}}catch(e){return{success:!1,error:s(e)}}}unwrap(){return this.__def.inner}}class VldTransformV2 extends e{constructor(e,s){super(r.TRANSFORM),this.__def=Object.freeze({type:"transform",inner:e,transformer:s})}static create(e,r){return new VldTransformV2(e,r)}parse(e){const r=this.__def.inner.parse(e);try{const e=this.__def.transformer(r);if(e instanceof Promise)throw new Error("Use parseAsync for async transforms");return e}catch(e){throw new Error(`Transform failed: ${e.message}`)}}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:s(e)}}}async parseAsync(e){const r=await this.__def.inner.parseAsync(e);return this.__def.transformer(r)}async safeParseAsync(e){try{return{success:!0,data:await this.parseAsync(e)}}catch(e){return{success:!1,error:s(e)}}}unwrap(){return this.__def.inner}}export{VldNullableV2,VldNullishV2,VldOptionalV2,VldRefineV2,VldTransformV2};

package/dist/zod-error.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ZodError compatibility layer.
+ *
+ * Converts a VldError into a ZodError-shaped object so VLD can be a true
+ * drop-in replacement for Zod. The result has the same `issues` shape
+ * and `format()` / `flatten()` helpers that Zod users expect.
+ *
+ * @example
+ *   const r = v.object({ a: v.string() }).safeParse({ a: 1 });
+ *   if (!r.success) {
+ *     const zErr = toZodError(r.error);
+ *     console.log(zErr.issues[0].expected); // "string"
+ *     console.log(zErr.format());
+ *   }
+ */
+export interface ZodLikeIssue {
+    /** The validator that failed: 'string', 'number', 'object', etc. */
+    origin?: string;
+    /** Discriminator code: 'invalid_type', 'too_small', 'invalid_format', etc. */
+    code: string;
+    /** Path to the failing field. */
+    path: (string | number)[];
+    /** Human-readable error message. */
+    message: string;
+    /** The expected value/type, when applicable. */
+    expected?: string | number | boolean | null;
+    /** The actual value/type that was received, when applicable. */
+    received?: unknown;
+    /** For numeric bounds. */
+    minimum?: number;
+    maximum?: number;
+    inclusive?: boolean;
+    /** For string length / array length bounds. */
+    format?: string;
+    pattern?: string;
+    /** Allow additional fields. */
+    [key: string]: unknown;
+}
+export declare class ZodLikeError extends Error {
+    /** Array of individual issue descriptors. */
+    readonly issues: ReadonlyArray<ZodLikeIssue>;
+    /** Top-level error code (VLD-specific; Zod doesn't have this). */
+    readonly code: string;
+    constructor(issues: ReadonlyArray<ZodLikeIssue>);
+    /**
+     * Zod-compatible `format()` method. Returns a nested error tree
+     * keyed by path. For backward compatibility with Zod, the default
+     * format() returns `_errors: string[]` and any nested fields.
+     */
+    format(): Record<string, any>;
+    /**
+     * Zod-compatible `flatten()` method. Returns `{ formErrors: string[],
+     * fieldErrors: Record<string, string[]> }`.
+     */
+    flatten(): {
+        formErrors: string[];
+        fieldErrors: Record<string, string[]>;
+    };
+    /** Zod-compatible `errors` getter (alias of `issues`). */
+    get errors(): ReadonlyArray<ZodLikeIssue>;
+}
+/**
+ * Convert a VldError to a ZodError-shaped error.
+ *
+ * The returned ZodLikeError has the same `issues` array shape, plus
+ * `format()` and `flatten()` helpers that Zod users expect.
+ */
+export declare function toZodError(vldError: any): ZodLikeError;
+/**
+ * Convenience: convert a safeParse result to a Zod-shaped result.
+ * If `result.success === false`, the `error` field will be a ZodLikeError
+ * instead of the raw VldError. Otherwise the result is unchanged.
+ */
+export declare function toZodSafeResult<T>(result: {
+    success: boolean;
+    data?: T;
+    error?: any;
+}): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: ZodLikeError;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxog/vld",
-  "version": "2.4.0",
+  "version": "3.0.4",
   "description": "Ultra-fast TypeScript-first schema validation with zero dependencies, 27+ language support, plugin system, and CLI tools",
   "type": "module",
   "main": "./dist/cjs/index.cjs",

package/dist/chunks/errors-core-CerMg2rq.js

@@ -1 +0,0 @@
-function e(e){return null===e?"null":void 0===e?"undefined":Array.isArray(e)?"array":"number"==typeof e?Number.isNaN(e)?"nan":e===1/0?"Infinity":e===-1/0?"-Infinity":"number":e instanceof Date?"date":e instanceof Map?"map":e instanceof Set?"set":typeof e}function s(e,s,r){return{code:"invalid_type",path:[],expected:e,received:s,message:r??`Invalid input: expected ${e}, received ${s}`}}function r(e){const s={code:e.code,path:e.path,message:e.message};return void 0!==e.expected&&(s.expected=e.expected),void 0!==e.received&&(s.received=e.received),void 0!==e.keys&&(s.keys=e.keys),void 0!==e.minimum&&(s.minimum=e.minimum),void 0!==e.maximum&&(s.maximum=e.maximum),void 0!==e.exact&&(s.exact=e.exact),void 0!==e.inclusive&&(s.inclusive=e.inclusive),void 0!==e.origin&&(s.origin=e.origin),void 0!==e.format&&(s.format=e.format),void 0!==e.values&&(s.values=e.values),void 0!==e.pattern&&(s.pattern=e.pattern),s}function i(e){const s={code:e.code,path:e.path,message:e.message};return void 0!==e.expected&&(s.expected=e.expected),void 0!==e.received&&(s.received=e.received),void 0!==e.keys&&(s.keys=e.keys),void 0!==e.minimum&&(s.minimum=e.minimum),void 0!==e.maximum&&(s.maximum=e.maximum),void 0!==e.exact&&(s.exact=e.exact),void 0!==e.inclusive&&(s.inclusive=e.inclusive),void 0!==e.origin&&(s.origin=e.origin),void 0!==e.format&&(s.format=e.format),void 0!==e.values&&(s.values=e.values),void 0!==e.pattern&&(s.pattern=e.pattern),s}class VldError extends Error{constructor(e,s){const r=e[0];super(void 0!==s?s:1===e.length&&void 0!==r?r.message:`${e.length} validation errors`),this.name="VldError",this.issues=e,Error.captureStackTrace&&Error.captureStackTrace(this,VldError)}get firstError(){return this.issues[0]}get errors(){return this.issues}get isEmpty(){return 0===this.issues.length}get formattedErrors(){return this.issues.map(e=>e.message)}addIssue(e){this.issues.push(e)}addIssues(e=[]){this.issues.push(...e)}format(){const e={_errors:[]};for(const s of this.issues)if(s.path&&0!==s.path.length){let r=e;for(const e of s.path)r[e]||(r[e]={_errors:[]}),r=r[e];r._errors.push(s.message)}else e._errors.push(s.message);return e}flatten(e){const s=e??(e=>e.message),r=[],i={};for(const e of this.issues)if(e.path&&0!==e.path.length){const r=String(e.path[0]);i[r]=i[r]??[],i[r].push(s(e))}else r.push(s(e));return{formErrors:r,fieldErrors:i}}toJSON(){return{name:this.name,message:this.message,code:"VLD_VALIDATION_ERROR",issues:this.issues.map(r)}}static fromJSON(e){const s=e.issues.map(i);return new VldError(s)}static isVldError(e){return e instanceof VldError}}export{VldError as V,s as c,e as g};