@oxog/vld 2.0.3 → 2.2.5

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

@@ -1,4 +1,4 @@
-import { VldBase, ParseResult } from './base';
+import { VldBase, ParseResult } from './base.js';
 /**
  * Configuration for string boolean validation
  */
@@ -16,6 +16,11 @@ export interface StringBoolOptions {
  */
 export declare class VldStringBool extends VldBase<unknown, boolean> {
     private readonly options;
+    private readonly truthyValues;
+    private readonly falsyValues;
+    private readonly normalizedTruthySet;
+    private readonly normalizedFalsySet;
+    private readonly validValuesText;
     private constructor();
     /**
      * Create a new string boolean validator
@@ -25,14 +30,7 @@ export declare class VldStringBool extends VldBase<unknown, boolean> {
      * Normalize a string value based on case sensitivity setting
      */
     private normalizeValue;
-    /**
-     * Get the effective truthy values (custom or default)
-     */
-    private getTruthyValues;
-    /**
-     * Get the effective falsy values (custom or default)
-     */
-    private getFalsyValues;
+    private normalizeValues;
     /**
      * Parse and validate a string boolean value
      */
@@ -58,4 +56,3 @@ export declare class VldStringBool extends VldBase<unknown, boolean> {
      */
     caseInsensitive(): VldStringBool;
 }
-//# sourceMappingURL=string-bool.d.ts.map

package/dist/validators/string-bool.js

@@ -0,0 +1 @@
+import{VldBase as t,VLD_VALIDATOR_TYPES as e}from"./base.js";import{getMessages as s}from"../locales/runtime.js";const r=["true","1","yes","on","y","enabled"],i=["false","0","no","off","n","disabled"];class VldStringBool extends t{constructor(t){super(e.STRING_BOOL),this.options=t,this.truthyValues=t.truthy??r,this.falsyValues=t.falsy??i;const s=this.normalizeValues(this.truthyValues),o=this.normalizeValues(this.falsyValues);this.normalizedTruthySet=new Set(s),this.normalizedFalsySet=new Set(o),this.validValuesText=[...s,...o].join(", ")}static create(t={}){return new VldStringBool(t)}normalizeValue(t){return this.options.caseSensitive?t:t.toLowerCase()}normalizeValues(t){return this.options.caseSensitive?t:t.map(t=>t.toLowerCase())}parse(t){if("string"!=typeof t){if("boolean"==typeof t)return t;throw new Error(s().stringExpected(typeof t,"string"))}const e=this.normalizeValue(t);if(this.normalizedTruthySet.has(e))return!0;if(this.normalizedFalsySet.has(e))return!1;throw new Error(s().stringBoolExpected(this.validValuesText,t))}safeParse(t){try{return{success:!0,data:this.parse(t)}}catch(t){return{success:!1,error:t}}}withTruthy(t){return new VldStringBool({...this.options,truthy:t})}withFalsy(t){return new VldStringBool({...this.options,falsy:t})}caseSensitive(){return new VldStringBool({...this.options,caseSensitive:!0})}caseInsensitive(){return new VldStringBool({...this.options,caseSensitive:!1})}}export{VldStringBool};

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

@@ -3,67 +3,63 @@
  * Part of Zod 4 API parity implementation
  * Provides convenient validators for common string formats
  */
-import { VldBase } from './base';
-import type { ParseResult } from './base';
-/**
- * Pre-compiled regex patterns for performance
- */
-declare const REGEXES: {
-    readonly email: RegExp;
-    readonly uuid: RegExp;
-    readonly uuidv4: RegExp;
-    readonly uuidv6: RegExp;
-    readonly uuidv7: RegExp;
-    readonly hostname: RegExp;
-    readonly emoji: RegExp;
-    readonly base64: RegExp;
-    readonly base64url: RegExp;
-    readonly hex: RegExp;
-    readonly jwt: RegExp;
-    readonly nanoid: RegExp;
-    readonly cuid: RegExp;
-    readonly cuid2: RegExp;
-    readonly ulid: RegExp;
-    readonly ipv4: RegExp;
-    readonly ipv6: RegExp;
-    readonly mac: RegExp;
-    readonly cidrv4: RegExp;
-    readonly cidrv6: RegExp;
-    readonly e164: RegExp;
-    readonly isoDate: RegExp;
-    readonly isoTime: RegExp;
-    readonly isoDateTime: RegExp;
-    readonly md5: RegExp;
-    readonly sha1: RegExp;
-    readonly sha256: RegExp;
-    readonly sha384: RegExp;
-    readonly sha512: RegExp;
-    readonly xid: RegExp;
-    readonly guid: RegExp;
-    readonly httpUrl: RegExp;
-};
-/**
- * Generic string format validator
- */
-declare class VldStringFormat extends VldBase<unknown, string> {
+import { VldBase } from './base.js';
+import type { ParseResult } from './base.js';
+export type UUIDVersion = 'v1' | 'v2' | 'v3' | 'v4' | 'v5' | 'v6' | 'v7' | 'v8';
+export interface URLFormatOptions {
+    hostname?: RegExp;
+    normalize?: boolean;
+    protocol?: RegExp;
+}
+export interface ISOTimeOptions {
+    precision?: number | null;
+}
+export interface ISODateTimeOptions extends ISOTimeOptions {
+    local?: boolean;
+    offset?: boolean;
+}
+declare function uuidRegex(version?: number): RegExp;
+declare function timeRegex(options?: ISOTimeOptions): RegExp;
+declare function dateTimeRegex(options?: ISODateTimeOptions): RegExp;
+declare function stringRegex(options?: {
+    minimum?: number;
+    maximum?: number;
+}): RegExp;
+declare function macRegex(delimiter?: string): RegExp;
+type StaticRegexName = 'base64' | 'base64url' | 'bigint' | 'boolean' | 'browserEmail' | 'cidrv4' | 'cidrv6' | 'creditCard' | 'cuid' | 'cuid2' | 'date' | 'domain' | 'duration' | 'e164' | 'email' | 'extendedDuration' | 'guid' | 'hex' | 'hostname' | 'html5Email' | 'httpProtocol' | 'httpUrl' | 'idnEmail' | 'integer' | 'ipv4' | 'ipv6' | 'jwt' | 'ksuid' | 'lowercase' | 'md5' | 'md5_base64' | 'md5_base64url' | 'md5_hex' | 'nanoid' | 'null' | 'number' | 'rfc5322Email' | 'sha1' | 'sha1_base64' | 'sha1_base64url' | 'sha1_hex' | 'sha256' | 'sha256_base64' | 'sha256_base64url' | 'sha256_hex' | 'sha384' | 'sha384_base64' | 'sha384_base64url' | 'sha384_hex' | 'sha512' | 'sha512_base64' | 'sha512_base64url' | 'sha512_hex' | 'ulid' | 'undefined' | 'unicodeEmail' | 'uppercase' | 'uuid4' | 'uuid6' | 'uuid7' | 'xid';
+export type RegexNamespace = Readonly<Record<StaticRegexName, RegExp> & {
+    datetime: typeof dateTimeRegex;
+    emoji: () => RegExp;
+    mac: typeof macRegex;
+    string: typeof stringRegex;
+    time: typeof timeRegex;
+    uuid: typeof uuidRegex;
+}>;
+/** Public regex helpers matching the current Zod 4 namespace. */
+declare const REGEXES: RegexNamespace;
+/** Generic string format validator. */
+export declare class VldStringFormat extends VldBase<unknown, string> {
     readonly _format: string;
-    readonly _validator: (val: string) => boolean;
+    readonly _validator: (value: string) => boolean;
     readonly _errorMessage?: string | undefined;
-    constructor(_format: string, _validator: (val: string) => boolean, _errorMessage?: string | undefined);
-    static create(format: string, validator: (val: string) => boolean, errorMessage?: string): VldStringFormat;
+    private readonly _normalize;
+    private readonly _patternSource?;
+    constructor(_format: string, _validator: (value: string) => boolean, _errorMessage?: string | undefined, _normalize?: (value: string) => string, _patternSource?: string | undefined);
+    static create(format: string, validator: (value: string) => boolean, errorMessage?: string, normalize?: (value: string) => string, patternSource?: string): VldStringFormat;
+    private _createFormatIssue;
     parse(value: unknown): string;
     safeParse(value: unknown): ParseResult<string>;
 }
-/**
- * Top-level string format validators
- */
 export declare const email: (options?: {
     pattern?: RegExp;
 }) => VldStringFormat;
+export declare const url: (options?: URLFormatOptions) => VldStringFormat;
 export declare const uuid: (options?: {
-    version?: "v4" | "v6" | "v7";
+    version?: UUIDVersion;
 }) => VldStringFormat;
 export declare const uuidv4: () => VldStringFormat;
+export declare const uuidv6: () => VldStringFormat;
+export declare const uuidv7: () => VldStringFormat;
 export declare const hostname: () => VldStringFormat;
 export declare const emoji: () => VldStringFormat;
 export declare const base64: () => VldStringFormat;
@@ -76,28 +72,31 @@ export declare const cuid2: () => VldStringFormat;
 export declare const ulid: () => VldStringFormat;
 export declare const ipv4: () => VldStringFormat;
 export declare const ipv6: () => VldStringFormat;
-export declare const mac: () => VldStringFormat;
+export declare const mac: (options?: {
+    delimiter?: string;
+}) => VldStringFormat;
 export declare const cidrv4: () => VldStringFormat;
 export declare const cidrv6: () => VldStringFormat;
 export declare const e164: () => VldStringFormat;
 export declare const xid: () => VldStringFormat;
 export declare const guid: () => VldStringFormat;
 export declare const httpUrl: () => VldStringFormat;
+export declare const ksuid: () => VldStringFormat;
 export declare const hash: (algorithm: "md5" | "sha1" | "sha256" | "sha384" | "sha512") => VldStringFormat;
-/**
- * ISO date/time validators
- */
+export declare function isValidCreditCard(input: string): boolean;
+export declare const creditCard: (params?: {
+    message?: string;
+}) => VldStringFormat;
 export declare const iso: {
-    date: () => VldStringFormat;
-    time: () => VldStringFormat;
-    dateTime: (_options?: {
-        offset?: boolean;
-    }) => VldStringFormat;
-    duration: () => VldStringFormat;
+    readonly ZodISODate: typeof VldStringFormat;
+    readonly ZodISODateTime: typeof VldStringFormat;
+    readonly ZodISODuration: typeof VldStringFormat;
+    readonly ZodISOTime: typeof VldStringFormat;
+    readonly date: () => VldStringFormat;
+    readonly time: (options?: ISOTimeOptions) => VldStringFormat;
+    readonly datetime: (options?: ISODateTimeOptions) => VldStringFormat;
+    readonly dateTime: (options?: ISODateTimeOptions) => VldStringFormat;
+    readonly duration: () => VldStringFormat;
 };
-/**
- * Custom format validator
- */
-export declare const stringFormat: (name: string, validator: ((val: string) => boolean) | RegExp) => VldStringFormat;
+export declare const stringFormat: (name: string, validator: ((value: string) => boolean) | RegExp) => VldStringFormat;
 export { REGEXES as regexes };
-//# sourceMappingURL=string-formats.d.ts.map

package/dist/validators/string-formats.js

@@ -0,0 +1 @@
+import{VldBase as t,VLD_VALIDATOR_TYPES as a}from"./base.js";import{getMessages as r}from"../locales/runtime.js";import{i as e}from"../chunks/ip-validation-g5LWgy9t.js";import{V as i,c as n,g as d}from"../chunks/errors-core-Cqi4-9ew.js";const o="(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))";function s(t,a){return t.lastIndex=0,t.test(a)}function c(t,a){return new RegExp(`^[A-Za-z0-9+/]{${t}}${a}$`)}function u(t){return new RegExp(`^[A-Za-z0-9_-]{${t}}$`)}function m(t){const a="(?:[01]\\d|2[0-3]):[0-5]\\d";return"number"!=typeof t.precision?`${a}(?::[0-5]\\d(?:\\.\\d+)?)?`:-1===t.precision?a:0===t.precision?`${a}:[0-5]\\d`:`${a}:[0-5]\\d\\.\\d{${t.precision}}`}function f(t){return void 0===t?/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/:new RegExp(`^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-${t}[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`)}const l={cuid:/^[cC][0-9a-z]{6,}$/,cuid2:/^[0-9a-z]+$/,ulid:/^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$/,xid:/^[0-9a-vA-V]{20}$/,ksuid:/^[A-Za-z0-9]{27}$/,nanoid:/^[a-zA-Z0-9_-]{21}$/,duration:/^P(?:(\d+W)|(?!.*W)(?=\d|T\d)(\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+([.,]\d+)?S)?)?)$/,extendedDuration:/^[-+]?P(?!$)(?:(?:[-+]?\d+Y)|(?:[-+]?\d+[.,]\d+Y$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:(?:[-+]?\d+W)|(?:[-+]?\d+[.,]\d+W$))?(?:(?:[-+]?\d+D)|(?:[-+]?\d+[.,]\d+D$))?(?:T(?=[\d+-])(?:(?:[-+]?\d+H)|(?:[-+]?\d+[.,]\d+H$))?(?:(?:[-+]?\d+M)|(?:[-+]?\d+[.,]\d+M$))?(?:[-+]?\d+(?:[.,]\d+)?S)?)??$/,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})$/,creditCard:/^\d(?:[ -]?\d){11,18}$/,uuid:f,uuid4:f(4),uuid6:f(6),uuid7:f(7),email:/^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+.-]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9-]*\.)+[A-Za-z]{2,}$/,html5Email:/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/,rfc5322Email:/^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}))$/,unicodeEmail:/^[^\s@"]{1,64}@[^\s@]{1,255}$/u,idnEmail:/^[^\s@"]{1,64}@[^\s@]{1,255}$/u,browserEmail:/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/,emoji:()=>/^(\p{Extended_Pictographic}|\p{Emoji_Component})+$/u,ipv4:/^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][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}|:))$/,mac:function(t=":"){const a=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`^(?:[0-9A-F]{2}${a}){5}[0-9A-F]{2}$|^(?:[0-9a-f]{2}${a}){5}[0-9a-f]{2}$`)},cidrv4:/^((25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\/([0-9]|[1-2][0-9]|3[0-2])$/,cidrv6:/^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|::|([0-9a-fA-F]{1,4})?::([0-9a-fA-F]{1,4}:?){0,6})\/(12[0-8]|1[01][0-9]|[1-9]?[0-9])$/,base64:/^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$/,base64url:/^[A-Za-z0-9_-]*$/,hostname:/^(?=.{1,253}\.?$)[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[-0-9a-zA-Z]{0,61}[0-9a-zA-Z])?)*\.?$/,domain:/^([a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,}$/,httpProtocol:/^https?$/,e164:/^\+[1-9]\d{6,14}$/,date:new RegExp(`^${o}$`),time:function(t={}){return new RegExp(`^${m(t)}$`)},datetime:function(t={}){const a=["Z"];return t.local&&a.push(""),t.offset&&a.push("([+-](?:[01]\\d|2[0-3]):[0-5]\\d)"),new RegExp(`^${o}T${m(t)}(?:${a.join("|")})$`)},string:function(t){const a=t?`[\\s\\S]{${t.minimum??0},${t.maximum??""}}`:"[\\s\\S]*";return new RegExp(`^${a}$`)},bigint:/^-?\d+n?$/,integer:/^-?\d+$/,number:/^-?\d+(?:\.\d+)?$/,boolean:/^(?:true|false)$/i,null:/^null$/i,undefined:/^undefined$/i,lowercase:/^[^A-Z]*$/,uppercase:/^[^a-z]*$/,hex:/^[0-9a-fA-F]*$/,md5_hex:/^[0-9a-fA-F]{32}$/,md5_base64:c(22,"=="),md5_base64url:u(22),sha1_hex:/^[0-9a-fA-F]{40}$/,sha1_base64:c(27,"="),sha1_base64url:u(27),sha256_hex:/^[0-9a-fA-F]{64}$/,sha256_base64:c(43,"="),sha256_base64url:u(43),sha384_hex:/^[0-9a-fA-F]{96}$/,sha384_base64:c(64,""),sha384_base64url:u(64),sha512_hex:/^[0-9a-fA-F]{128}$/,sha512_base64:c(86,"=="),sha512_base64url:u(86),jwt:/^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]*$/,httpUrl:/^https?:\/\/[^\s/$.?#].[^\s]*$/,md5:/^[a-f0-9]{32}$/i,sha1:/^[a-f0-9]{40}$/i,sha256:/^[a-f0-9]{64}$/i,sha384:/^[a-f0-9]{96}$/i,sha512:/^[a-f0-9]{128}$/i};class VldStringFormat extends t{constructor(t,r,e,i=t=>t,n){super(a.STRING_FORMAT),this._format=t,this._validator=r,this._errorMessage=e,this._normalize=i,this._patternSource=n}static create(t,a,r,e,i){return new VldStringFormat(t,a,r,e,i)}_createFormatIssue(){const t={code:"invalid_format",path:[],origin:"string",format:this._format,message:this._errorMessage||`Invalid ${this._format}`};return this._patternSource&&(t.pattern=this._patternSource),new i([t])}parse(t){if("string"!=typeof t)throw new i([n("string",d(t),r().invalidString)]);if(!this._validator(t))throw this._createFormatIssue();return this._normalize(t)}safeParse(t){return"string"!=typeof t?{success:!1,error:new i([n("string",d(t),r().invalidString)])}:this._validator(t)?{success:!0,data:this._normalize(t)}:{success:!1,error:this._createFormatIssue()}}}const A=t=>{const a=t?.pattern??l.email;return VldStringFormat.create("email",t=>s(a,t),void 0,void 0,a.source)},$=(t={})=>VldStringFormat.create("url",a=>{const r=(t=>{try{return new URL(t)}catch{return}})(a);return void 0!==r&&(!t.hostname||s(t.hostname,r.hostname))&&(!t.protocol||s(t.protocol,r.protocol.slice(0,-1)))},void 0,t.normalize?t=>new URL(t).href:void 0),F=t=>{const a=f(void 0===t?.version?void 0:Number(t.version.slice(1)));return VldStringFormat.create("uuid",t=>s(a,t))},g=()=>VldStringFormat.create("uuid",t=>s(l.uuid4,t)),h=()=>VldStringFormat.create("uuid",t=>s(l.uuid6,t)),p=()=>VldStringFormat.create("uuid",t=>s(l.uuid7,t)),S=()=>VldStringFormat.create("hostname",t=>s(l.hostname,t)),z=()=>VldStringFormat.create("emoji",t=>s(l.emoji(),t)),Z=()=>VldStringFormat.create("base64",t=>s(l.base64,t)),_=()=>VldStringFormat.create("base64url",t=>s(l.base64url,t)),V=()=>VldStringFormat.create("hex",t=>s(l.hex,t)),v=()=>VldStringFormat.create("jwt",t=>s(l.jwt,t)),x=()=>VldStringFormat.create("nanoid",t=>s(l.nanoid,t)),b=()=>VldStringFormat.create("cuid",t=>s(l.cuid,t)),w=()=>VldStringFormat.create("cuid2",t=>s(l.cuid2,t)),E=()=>VldStringFormat.create("ulid",t=>s(l.ulid,t)),j=()=>VldStringFormat.create("ipv4",t=>s(l.ipv4,t)),I=()=>VldStringFormat.create("ipv6",t=>s(l.ipv6,t)),R=t=>{const a=l.mac(t?.delimiter);return VldStringFormat.create("mac",t=>s(a,t))},M=()=>VldStringFormat.create("cidrv4",t=>s(l.cidrv4,t)),T=()=>VldStringFormat.create("cidrv6",t=>{const a=t.lastIndexOf("/");if(a<=0)return!1;const r=Number(t.slice(a+1));return Number.isInteger(r)&&r>=0&&r<=128&&e(t.slice(0,a))}),D=()=>VldStringFormat.create("e164",t=>s(l.e164,t)),k=()=>VldStringFormat.create("xid",t=>s(l.xid,t)),C=()=>VldStringFormat.create("guid",t=>s(l.guid,t)),O=()=>VldStringFormat.create("httpUrl",t=>s(l.httpUrl,t)),P=()=>VldStringFormat.create("ksuid",t=>s(l.ksuid,t)),N=t=>VldStringFormat.create("hash",a=>l[t]?.test(a)??!1,`Invalid ${t} hash`),U=/[ -]/g;function y(t){return!!l.creditCard.test(t)&&function(t){let a=0,r=!1;for(let e=t.length-1;e>=0;e--){let i=t.charCodeAt(e)-48;r&&(i*=2,i>9&&(i-=9)),a+=i,r=!r}return a%10==0}(t.replace(U,""))}const H=t=>VldStringFormat.create("credit_card",y,t?.message,void 0,l.creditCard.source),W={ZodISODate:VldStringFormat,ZodISODateTime:VldStringFormat,ZodISODuration:VldStringFormat,ZodISOTime:VldStringFormat,date:()=>VldStringFormat.create("date",t=>s(l.date,t)),time:(t={})=>{const a=l.time(t);return VldStringFormat.create("time",t=>s(a,t))},datetime:(t={})=>{const a=l.datetime(t);return VldStringFormat.create("datetime",t=>s(a,t))},dateTime:(t={local:!0})=>{const a=l.datetime(t);return VldStringFormat.create("datetime",t=>s(a,t))},duration:()=>VldStringFormat.create("duration",t=>s(l.duration,t))},Y=(t,a)=>{const r=a instanceof RegExp?t=>s(a,t):a;return VldStringFormat.create(t,r)};export{VldStringFormat,Z as base64,_ as base64url,M as cidrv4,T as cidrv6,H as creditCard,b as cuid,w as cuid2,D as e164,A as email,z as emoji,C as guid,N as hash,V as hex,S as hostname,O as httpUrl,j as ipv4,I as ipv6,y as isValidCreditCard,W as iso,v as jwt,P as ksuid,R as mac,x as nanoid,l as regexes,Y as stringFormat,E as ulid,$ as url,F as uuid,g as uuidv4,h as uuidv6,p as uuidv7,k as xid};

package/dist/validators/string.d.ts

@@ -1,4 +1,4 @@
-import { VldBase, ParseResult } from './base';
+import { VldBase, ParseResult, ValidatorType, type ErrorParam } from './base.js';
 /**
  * Type for string validation check functions
  */
@@ -7,13 +7,33 @@ type StringCheck = (value: string) => boolean;
  * Type for string transformation functions
  */
 type StringTransform = (value: string) => string;
+interface StringJSONSchemaHints {
+    minLength?: number;
+    maxLength?: number;
+    exactLength?: number;
+    format?: string;
+    pattern?: string;
+}
+/**
+ * Metadata for a single string constraint, enabling Zod 4-compatible issues.
+ */
+interface StringCheckMeta {
+    readonly kind: 'min' | 'max' | 'length' | 'format' | 'regex' | 'other';
+    readonly value?: number;
+    readonly format?: string;
+    readonly pattern?: string;
+    readonly message: string | undefined;
+}
 /**
  * Configuration for string validator
  */
 interface StringValidatorConfig {
     readonly checks: ReadonlyArray<StringCheck>;
     readonly transforms: ReadonlyArray<StringTransform>;
-    readonly errorMessage?: string;
+    readonly errorMessage: string | undefined;
+    readonly validatorType?: ValidatorType;
+    readonly jsonSchema: StringJSONSchemaHints | undefined;
+    readonly checkMetas: ReadonlyArray<StringCheckMeta> | undefined;
 }
 /**
  * Immutable string validator with chainable methods
@@ -21,28 +41,41 @@ interface StringValidatorConfig {
  */
 export declare class VldString extends VldBase<string, string> {
     protected readonly config: StringValidatorConfig;
-    private _compiledValidator;
+    private readonly _checks;
+    private readonly _transforms;
+    private readonly _isSimple;
+    private readonly _checkMetas;
     /**
      * Protected constructor to allow extension while maintaining immutability
      */
     protected constructor(config?: Partial<StringValidatorConfig>);
     /**
-     * Compile all transforms and checks into a single optimized function
-     * This eliminates loop overhead and enables better JIT optimization
+     * Create a new string validator
+     */
+    static create(): VldString;
+    /**
+     * Returns true if this is a simple string validator with no transforms or checks
+     * Used by VldObject for optimized fast-path dispatch
      */
-    private _compileValidator;
+    get isSimple(): boolean;
     /**
-     * Get the cached compiled validator, creating it if necessary
+     * Build the Zod 4-compatible VldIssue for a failed check at the given index.
      */
-    private _getCompiledValidator;
+    private _createCheckIssue;
     /**
-     * Create a new string validator
+     * Run all checks against a known string and return the first failing meta, or null.
      */
-    static create(): VldString;
+    private _runChecks;
+    private _fallbackMeta;
     /**
-     * Parse and validate a string value - ultra-optimized with pre-compiled validator
+     * Parse and validate a string value without allocating intermediate result objects.
      */
     parse(value: unknown): string;
+    /**
+     * Parse a value that has already passed the string type guard.
+     * @internal Used by object validators to avoid duplicate hot-path checks.
+     */
+    parseKnownString(value: string): string;
     /**
      * Safely parse and validate a string value
      */
@@ -50,31 +83,53 @@ export declare class VldString extends VldBase<string, string> {
     /**
      * Create a new validator with minimum length constraint
      */
-    min(length: number, message?: string): VldString;
+    min(length: number, message?: ErrorParam): VldString;
     /**
      * Create a new validator with maximum length constraint
      */
-    max(length: number, message?: string): VldString;
+    max(length: number, message?: ErrorParam): VldString;
     /**
      * Create a new validator with exact length constraint
      */
-    length(length: number, message?: string): VldString;
+    length(length: number, message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks for valid email format
      */
-    email(message?: string): VldString;
+    email(message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks for valid URL format
      */
-    url(message?: string): VldString;
+    url(message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks for valid UUID format
      */
-    uuid(message?: string): VldString;
+    uuid(message?: ErrorParam): VldString;
+    private format;
+    uuidv4(message?: ErrorParam): VldString;
+    uuidv6(message?: ErrorParam): VldString;
+    uuidv7(message?: ErrorParam): VldString;
+    emoji(message?: ErrorParam): VldString;
+    base64(message?: ErrorParam): VldString;
+    base64url(message?: ErrorParam): VldString;
+    jwt(message?: ErrorParam): VldString;
+    nanoid(message?: ErrorParam): VldString;
+    cuid(message?: ErrorParam): VldString;
+    cuid2(message?: ErrorParam): VldString;
+    ulid(message?: ErrorParam): VldString;
+    cidrv4(message?: ErrorParam): VldString;
+    cidrv6(message?: ErrorParam): VldString;
+    e164(message?: ErrorParam): VldString;
+    xid(message?: ErrorParam): VldString;
+    guid(message?: ErrorParam): VldString;
+    ksuid(message?: ErrorParam): VldString;
+    date(message?: ErrorParam): VldString;
+    time(message?: ErrorParam): VldString;
+    datetime(message?: ErrorParam): VldString;
+    duration(message?: ErrorParam): VldString;
     /**
      * Create a new validator with regex pattern matching
      */
-    regex(pattern: RegExp, message?: string): VldString;
+    regex(pattern: RegExp, message?: ErrorParam): VldString;
     /**
      * Create a new validator that trims whitespace
      */
@@ -83,38 +138,41 @@ export declare class VldString extends VldBase<string, string> {
      * Create a new validator that converts to lowercase
      */
     toLowerCase(): VldString;
+    lowercase(): VldString;
     /**
      * Create a new validator that converts to uppercase
      */
     toUpperCase(): VldString;
+    uppercase(): VldString;
+    normalize(form?: 'NFC' | 'NFD' | 'NFKC' | 'NFKD'): VldString;
+    slugify(): VldString;
     /**
      * Create a new validator that checks if string starts with a substring
      */
-    startsWith(str: string, message?: string): VldString;
+    startsWith(str: string, message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks if string ends with a substring
      */
-    endsWith(str: string, message?: string): VldString;
+    endsWith(str: string, message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks if string includes a substring
      */
-    includes(str: string, message?: string): VldString;
+    includes(str: string, message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks for valid IP address (v4 or v6)
      */
-    ip(message?: string): VldString;
+    ip(message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks for valid IPv4 address
      */
-    ipv4(message?: string): VldString;
+    ipv4(message?: ErrorParam): VldString;
     /**
      * Create a new validator that checks for valid IPv6 address
      */
-    ipv6(message?: string): VldString;
+    ipv6(message?: ErrorParam): VldString;
     /**
      * Create a new validator that ensures string is not empty
      */
-    nonempty(message?: string): VldString;
+    nonempty(message?: ErrorParam): VldString;
 }
 export {};
-//# sourceMappingURL=string.d.ts.map

package/dist/validators/string.js

@@ -0,0 +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-Cqi4-9ew.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}_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.d.ts

@@ -1,9 +1,9 @@
-import { VldBase, ParseResult } from './base';
+import { VldBase, ParseResult } from './base.js';
 /**
  * Immutable symbol validator
  */
 export declare class VldSymbol extends VldBase<symbol, symbol> {
-    private readonly errorMessage?;
+    private readonly errorMessage;
     /**
      * Private constructor to enforce immutability
      */
@@ -12,13 +12,18 @@ export declare class VldSymbol extends VldBase<symbol, symbol> {
      * Create a new symbol validator
      */
     static create(): VldSymbol;
+    get isSimple(): boolean;
     /**
      * Parse and validate a symbol value
      */
     parse(value: unknown): symbol;
+    /**
+     * Parse a value that has already passed the symbol type guard.
+     * @internal Used by object validators to avoid duplicate hot-path checks.
+     */
+    parseKnownSymbol(value: symbol): symbol;
     /**
      * Safely parse and validate a symbol value
      */
     safeParse(value: unknown): ParseResult<symbol>;
 }
-//# sourceMappingURL=symbol.d.ts.map

package/dist/validators/symbol.js

@@ -0,0 +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-Cqi4-9ew.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/template-literal.d.ts

@@ -1,4 +1,4 @@
-import { VldBase, ParseResult } from './base';
+import { VldBase, ParseResult } from './base.js';
 /**
  * Template literal component types
  */
@@ -29,4 +29,3 @@ export declare class VldTemplateLiteral extends VldBase<unknown, string> {
  */
 export declare function templateLiteral(...components: TLComponent[]): VldTemplateLiteral;
 export {};
-//# sourceMappingURL=template-literal.d.ts.map

package/dist/validators/template-literal.js

@@ -0,0 +1 @@
+import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{getMessages as t}from"../locales/runtime.js";class VldTemplateLiteral extends e{constructor(e){super(r.TEMPLATE_LITERAL),this.pattern=e}static create(...e){let r="^";for(const t of e)r+="string"==typeof t?t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"):a(t);return r+="$",new VldTemplateLiteral(new RegExp(r))}parse(e){if("string"!=typeof e)throw new Error(t().invalidString);if(!this.pattern.test(e))throw new Error(t().stringPatternInvalid);return e}safeParse(e){try{return{success:!0,data:this.parse(e)}}catch(e){return{success:!1,error:e}}}}function a(e){switch(e.validatorType){case r.STRING:case r.STRING_FORMAT:return"(.+)";case r.NUMBER:case r.COERCE_NUMBER:return"(-?\\d+(?:\\.\\d+)?)";case r.BIGINT:case r.COERCE_BIGINT:return"(-?\\d+)";case r.BOOLEAN:case r.COERCE_BOOLEAN:return"(true|false)";case r.NULL:return"(null)";case r.UNDEFINED:case r.VOID:return"(undefined)";case r.LITERAL:{const r=e;if(void 0!==r.literal){return"("+String(r.literal).replace(/[.*+?^${}()|[\]\\]/g,"\\$&")+")"}break}}return"(.+)"}function s(...e){return VldTemplateLiteral.create(...e)}export{VldTemplateLiteral,s as templateLiteral};

package/dist/validators/tuple.d.ts

@@ -1,31 +1,48 @@
-import { VldBase, ParseResult } from './base';
+import { VldBase, ParseResult } from './base.js';
+type FixedTupleOutput<T extends readonly VldBase<any, any>[]> = {
+    -readonly [K in keyof T]: ReturnType<T[K]['parse']>;
+};
+type TupleOutput<T extends readonly VldBase<any, any>[], TRest extends VldBase<any, any> | null> = TRest extends VldBase<any, any> ? [...FixedTupleOutput<T>, ...ReturnType<TRest['parse']>[]] : FixedTupleOutput<T>;
 /**
  * Immutable tuple validator for fixed-length arrays
  */
-export declare class VldTuple<T extends readonly VldBase<any, any>[]> extends VldBase<unknown, {
-    [K in keyof T]: T[K] extends VldBase<any, infer U> ? U : never;
-}> {
+export declare class VldTuple<T extends readonly VldBase<any, any>[], TRest extends VldBase<any, any> | null = null> extends VldBase<unknown, TupleOutput<T, TRest>> {
     private readonly validators;
     private readonly errorMessage?;
+    private readonly restValidator;
     /**
      * Private constructor to enforce immutability
      */
+    private readonly _length;
+    private readonly _validatorTypes;
+    private readonly _simpleItemModes;
+    private readonly _simpleItemValues;
     private constructor();
+    get items(): T;
+    private getSimpleItemMode;
+    private getSimpleItemError;
     /**
      * Create a new tuple validator
      */
-    static create<T extends readonly VldBase<any, any>[]>(...validators: T): VldTuple<T>;
+    static create<T extends readonly VldBase<any, any>[]>(...validators: T): VldTuple<T, null>;
+    rest<TSchema extends VldBase<any, any>>(validator: TSchema): VldTuple<T, TSchema>;
     /**
      * Parse and validate a tuple value
      */
-    parse(value: unknown): {
-        [K in keyof T]: T[K] extends VldBase<any, infer U> ? U : never;
-    };
+    parse(value: unknown): TupleOutput<T, TRest>;
+    /**
+     * Parse a value that has already passed the tuple array type guard.
+     * @internal Used by object validators to avoid duplicate hot-path checks.
+     */
+    parseKnownTuple(value: unknown[]): TupleOutput<T, TRest>;
     /**
      * Safely parse and validate a tuple value
      */
-    safeParse(value: unknown): ParseResult<{
-        [K in keyof T]: T[K] extends VldBase<any, infer U> ? U : never;
-    }>;
+    safeParse(value: unknown): ParseResult<TupleOutput<T, TRest>>;
+    encode(value: TupleOutput<T, TRest>): unknown;
+    safeEncode(value: TupleOutput<T, TRest>): ParseResult<unknown>;
+    encodeAsync(value: TupleOutput<T, TRest>): Promise<unknown>;
+    safeEncodeAsync(value: TupleOutput<T, TRest>): Promise<ParseResult<unknown>>;
+    private validateEncodedLength;
 }
-//# sourceMappingURL=tuple.d.ts.map
+export {};

package/dist/validators/tuple.js

@@ -0,0 +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-Cqi4-9ew.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.d.ts

@@ -1,11 +1,11 @@
-import { VldBase, ParseResult } from './base';
+import { VldBase, ParseResult } from './base.js';
 /**
  * Configuration for Uint8Array validator
  * BUG-NEW-010 FIX: Use config object pattern for immutability
  */
 interface Uint8ArrayValidatorConfig {
-    readonly minLength?: number;
-    readonly maxLength?: number;
+    readonly minLength?: number | undefined;
+    readonly maxLength?: number | undefined;
     readonly exactLength?: number;
 }
 /**
@@ -39,4 +39,3 @@ export declare class VldUint8Array extends VldBase<Uint8Array, Uint8Array> {
     static create(): VldUint8Array;
 }
 export {};
-//# sourceMappingURL=uint8array.d.ts.map

package/dist/validators/uint8array.js

@@ -0,0 +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-Cqi4-9ew.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.d.ts

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

package/dist/validators/undefined.js

@@ -0,0 +1 @@
+import{VldBase as e,VLD_VALIDATOR_TYPES as r}from"./base.js";import{V as s}from"../chunks/errors-core-Cqi4-9ew.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};