@oxog/vld 2.0.1 → 2.0.3

package/dist/cli/commands/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,UAmJ7B,CAAC"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,UA0J7B,CAAC"}

package/dist/codecs/index.js

@@ -1,4 +1,4 @@
-export { D as base64Json, w as base64ToBytes, x as base64UrlToBytes, y as base64urlToBytes, C as bytesToUtf8, p as epochMillisToDate, o as epochSecondsToDate, A as hexLowerToBytes, z as hexToBytes, m as isoDatetimeToDate, q as jsonCodec, E as jwtPayload, n as numberToBigInt, k as stringToBigInt, l as stringToBoolean, t as stringToHttpURL, j as stringToInt, i as stringToNumber, r as stringToURL, v as uriComponent, B as utf8ToBytes } from '../chunks/index-BoV-4S1F.js';
-import '../chunks/bigint-ZKkWLdmi.js';
-import '../chunks/unknown-CjSRcELI.js';
+export { d as base64Json, e as base64ToBytes, g as base64UrlToBytes, h as base64urlToBytes, i as bytesToUtf8, j as epochMillisToDate, k as epochSecondsToDate, l as hexLowerToBytes, m as hexToBytes, o as isoDatetimeToDate, p as jsonCodec, q as jwtPayload, r as numberToBigInt, s as stringToBigInt, t as stringToBoolean, u as stringToHttpURL, v as stringToInt, w as stringToNumber, x as stringToURL, D as uriComponent, E as utf8ToBytes } from '../chunks/index-DO8CFMxD.js';
+import '../chunks/bigint-CRS0QVsy.js';
+import '../chunks/unknown-Dhzri_T-.js';
 //# sourceMappingURL=index.js.map

package/dist/coercion/index.js

@@ -1,5 +1,5 @@
-export { a as VldCoerceBoolean, V as VldCoerceDate, b as VldCoerceNumber, c as VldCoerceString } from '../chunks/date-7Iz2BGsL.js';
-import { d as VldBigInt, t as getMessages } from '../chunks/bigint-ZKkWLdmi.js';
+export { a as VldCoerceBoolean, V as VldCoerceDate, b as VldCoerceNumber, c as VldCoerceString } from '../chunks/date-50JV_Mfj.js';
+import { V as VldBigInt, u as getMessages } from '../chunks/bigint-CRS0QVsy.js';
 
 /**
  * BigInt coercion validator that attempts to convert values to bigint

package/dist/index.d.ts

@@ -45,6 +45,7 @@ import { VldJson } from './validators/json';
 import { type CustomValidatorOptions } from './validators/custom';
 import { VldPreprocess } from './validators/base';
 import { VldOptional } from './validators/base';
+import { VldExactOptional } from './validators/base';
 import { VldNullable } from './validators/base';
 import { VldNullish } from './validators/base';
 import { VldCodec } from './validators/codec';
@@ -60,6 +61,7 @@ export type { ParseResult } from './validators/base';
 export type { Infer, Input, Output } from './validators';
 export { VldBase } from './validators/base';
 export { VldIntersection } from './validators/intersection';
+export { VldMeta, type SchemaMetadata } from './validators/base';
 export { setLocale, getLocale, getMessages, type Locale } from './locales';
 export { VldError, VldIssue, VldErrorCode, VldErrorTree, VldFlattenedError, VldErrorJSON, treeifyError, prettifyError, prettifyErrorColored, prettifyErrorPlain, flattenError, type PrettifyOptions } from './errors';
 export { base64ToUint8Array, uint8ArrayToBase64, uint8ArrayToBase64Url, hexToUint8Array, uint8ArrayToHex, stringToUint8Array, uint8ArrayToString } from './utils/codec-utils';
@@ -73,6 +75,11 @@ export declare const v: {
     number: () => VldNumber;
     int: () => VldNumber;
     int32: () => VldNumber;
+    uint32: () => VldNumber;
+    uint64: () => VldNumber;
+    int64: () => VldNumber;
+    float32: () => VldNumber;
+    float64: () => VldNumber;
     boolean: () => VldBoolean;
     date: () => VldDate;
     bigint: () => VldBigInt;
@@ -109,6 +116,7 @@ export declare const v: {
     optional: <T>(validator: VldBase<unknown, T>) => VldOptional<unknown, T>;
     nullable: <T>(validator: VldBase<unknown, T>) => VldNullable<unknown, T>;
     nullish: <T>(validator: VldBase<unknown, T>) => VldNullish<unknown, T>;
+    exactOptional: <T>(validator: VldBase<unknown, T>) => VldExactOptional<unknown, T>;
     lazy: <T>(schemaGetter: () => VldBase<unknown, T>) => VldLazy<unknown, T>;
     json: <T = unknown>(schema?: VldBase<unknown, T>) => VldJson<T>;
     custom: <TOutput = unknown>(options: CustomValidatorOptions<TOutput>) => import("./validators").VldCustom<TOutput>;
@@ -141,10 +149,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     uuid: (options?: {
         version?: "v4" | "v6" | "v7";
@@ -165,10 +179,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     uuidv4: () => {
         readonly _format: string;
@@ -187,10 +207,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     hostname: () => {
         readonly _format: string;
@@ -209,10 +235,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     emoji: () => {
         readonly _format: string;
@@ -231,10 +263,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     base64: () => {
         readonly _format: string;
@@ -253,10 +291,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     base64url: () => {
         readonly _format: string;
@@ -275,10 +319,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     hex: () => {
         readonly _format: string;
@@ -297,10 +347,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     jwt: () => {
         readonly _format: string;
@@ -319,10 +375,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     nanoid: () => {
         readonly _format: string;
@@ -341,10 +403,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     cuid: () => {
         readonly _format: string;
@@ -363,10 +431,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     cuid2: () => {
         readonly _format: string;
@@ -385,10 +459,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     ulid: () => {
         readonly _format: string;
@@ -407,10 +487,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     ipv4: () => {
         readonly _format: string;
@@ -429,10 +515,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     ipv6: () => {
         readonly _format: string;
@@ -451,10 +543,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     mac: () => {
         readonly _format: string;
@@ -473,10 +571,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     cidrv4: () => {
         readonly _format: string;
@@ -495,10 +599,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     cidrv6: () => {
         readonly _format: string;
@@ -517,10 +627,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     e164: () => {
         readonly _format: string;
@@ -539,10 +655,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     hash: (algorithm: "md5" | "sha1" | "sha256" | "sha384" | "sha512") => {
         readonly _format: string;
@@ -561,10 +683,16 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     iso: {
         date: () => {
@@ -584,10 +712,16 @@ export declare const v: {
             optional(): VldOptional<unknown, string>;
             nullable(): VldNullable<unknown, string>;
             nullish(): VldNullish<unknown, string>;
+            exactOptional(): VldExactOptional<unknown, string>;
             pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
             readonly(): import("./validators").VldReadonly<unknown, string>;
             brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
             apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+            check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+            check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+            meta(): import("./validators/base").SchemaMetadata | undefined;
+            meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+            describe(description: string): import("./validators/base").VldMeta<unknown, string>;
         };
         time: () => {
             readonly _format: string;
@@ -606,10 +740,16 @@ export declare const v: {
             optional(): VldOptional<unknown, string>;
             nullable(): VldNullable<unknown, string>;
             nullish(): VldNullish<unknown, string>;
+            exactOptional(): VldExactOptional<unknown, string>;
             pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
             readonly(): import("./validators").VldReadonly<unknown, string>;
             brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
             apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+            check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+            check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+            meta(): import("./validators/base").SchemaMetadata | undefined;
+            meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+            describe(description: string): import("./validators/base").VldMeta<unknown, string>;
         };
         dateTime: () => {
             readonly _format: string;
@@ -628,10 +768,16 @@ export declare const v: {
             optional(): VldOptional<unknown, string>;
             nullable(): VldNullable<unknown, string>;
             nullish(): VldNullish<unknown, string>;
+            exactOptional(): VldExactOptional<unknown, string>;
             pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
             readonly(): import("./validators").VldReadonly<unknown, string>;
             brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
             apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+            check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+            check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+            meta(): import("./validators/base").SchemaMetadata | undefined;
+            meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+            describe(description: string): import("./validators/base").VldMeta<unknown, string>;
         };
         duration: () => {
             readonly _format: string;
@@ -650,10 +796,16 @@ export declare const v: {
             optional(): VldOptional<unknown, string>;
             nullable(): VldNullable<unknown, string>;
             nullish(): VldNullish<unknown, string>;
+            exactOptional(): VldExactOptional<unknown, string>;
             pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
             readonly(): import("./validators").VldReadonly<unknown, string>;
             brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
             apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+            check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+            check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+            meta(): import("./validators/base").SchemaMetadata | undefined;
+            meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+            describe(description: string): import("./validators/base").VldMeta<unknown, string>;
         };
     };
     stringFormat: (name: string, validator: ((val: string) => boolean) | RegExp) => {
@@ -673,10 +825,100 @@ export declare const v: {
         optional(): VldOptional<unknown, string>;
         nullable(): VldNullable<unknown, string>;
         nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
         pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
         readonly(): import("./validators").VldReadonly<unknown, string>;
         brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
         apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
+    };
+    xid: () => {
+        readonly _format: string;
+        readonly _validator: (val: string) => boolean;
+        readonly _errorMessage?: string | undefined;
+        parse(value: unknown): string;
+        safeParse(value: unknown): import("./validators").ParseResult<string>;
+        isValid(value: unknown): boolean;
+        parseOrDefault(value: unknown, defaultValue: string): string;
+        refine<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        refine(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        superRefine(refinement: (value: string, ctx: import("./validators").SuperRefineContext) => void | Promise<void>): import("./validators").VldSuperRefine<unknown, string>;
+        transform<TTransformed>(transformer: (value: string) => TTransformed): import("./validators").VldTransform<unknown, string, TTransformed>;
+        default(defaultValue: string): import("./validators").VldDefault<unknown, string>;
+        catch(fallbackValue: string): import("./validators").VldCatch<unknown, string>;
+        optional(): VldOptional<unknown, string>;
+        nullable(): VldNullable<unknown, string>;
+        nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
+        pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
+        readonly(): import("./validators").VldReadonly<unknown, string>;
+        brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
+        apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
+    };
+    guid: () => {
+        readonly _format: string;
+        readonly _validator: (val: string) => boolean;
+        readonly _errorMessage?: string | undefined;
+        parse(value: unknown): string;
+        safeParse(value: unknown): import("./validators").ParseResult<string>;
+        isValid(value: unknown): boolean;
+        parseOrDefault(value: unknown, defaultValue: string): string;
+        refine<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        refine(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        superRefine(refinement: (value: string, ctx: import("./validators").SuperRefineContext) => void | Promise<void>): import("./validators").VldSuperRefine<unknown, string>;
+        transform<TTransformed>(transformer: (value: string) => TTransformed): import("./validators").VldTransform<unknown, string, TTransformed>;
+        default(defaultValue: string): import("./validators").VldDefault<unknown, string>;
+        catch(fallbackValue: string): import("./validators").VldCatch<unknown, string>;
+        optional(): VldOptional<unknown, string>;
+        nullable(): VldNullable<unknown, string>;
+        nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
+        pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
+        readonly(): import("./validators").VldReadonly<unknown, string>;
+        brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
+        apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
+    };
+    httpUrl: () => {
+        readonly _format: string;
+        readonly _validator: (val: string) => boolean;
+        readonly _errorMessage?: string | undefined;
+        parse(value: unknown): string;
+        safeParse(value: unknown): import("./validators").ParseResult<string>;
+        isValid(value: unknown): boolean;
+        parseOrDefault(value: unknown, defaultValue: string): string;
+        refine<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        refine(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        superRefine(refinement: (value: string, ctx: import("./validators").SuperRefineContext) => void | Promise<void>): import("./validators").VldSuperRefine<unknown, string>;
+        transform<TTransformed>(transformer: (value: string) => TTransformed): import("./validators").VldTransform<unknown, string, TTransformed>;
+        default(defaultValue: string): import("./validators").VldDefault<unknown, string>;
+        catch(fallbackValue: string): import("./validators").VldCatch<unknown, string>;
+        optional(): VldOptional<unknown, string>;
+        nullable(): VldNullable<unknown, string>;
+        nullish(): VldNullish<unknown, string>;
+        exactOptional(): VldExactOptional<unknown, string>;
+        pipe<TNextOutput>(next: VldBase<string, TNextOutput>): import("./validators").VldPipe<unknown, string, TNextOutput>;
+        readonly(): import("./validators").VldReadonly<unknown, string>;
+        brand<TBrand extends string>(): import("./validators").VldBrand<unknown, string, TBrand>;
+        apply<TNewOutput>(fn: (schema: /*elided*/ any) => VldBase<unknown, TNewOutput>): VldBase<unknown, TNewOutput>;
+        check<TRefined extends string>(predicate: (value: string) => value is TRefined, message?: string): import("./validators").VldRefine<unknown, string, TRefined>;
+        check(predicate: (value: string) => boolean, message?: string): import("./validators").VldRefine<unknown, string, string>;
+        meta(): import("./validators/base").SchemaMetadata | undefined;
+        meta(data: Partial<import("./validators/base").SchemaMetadata>): import("./validators/base").VldMeta<unknown, string>;
+        describe(description: string): import("./validators/base").VldMeta<unknown, string>;
     };
     templateLiteral: (...components: (VldBase<any, any> | string)[]) => import("./validators").VldTemplateLiteral;
     base64Bytes: () => VldBase64;
@@ -686,6 +928,7 @@ export declare const v: {
         decode: (value: TInput) => TOutput | Promise<TOutput>;
         encode: (value: TOutput) => TInput | Promise<TInput>;
     }) => VldCodec<TInput, TOutput>;
+    promise: <T>(inner: VldBase<unknown, T>) => import("./validators").VldPromise<T>;
 };
 export type { Result, VldResult } from './compat/result';
 export { Ok, Err, success, failure, isOk, isErr, isResult, unwrap, unwrapOr, map, mapErr, flatMap, match, tryCatch, tryCatchAsync, all, fromNullable, ResultUtils } from './compat/result';
@@ -694,5 +937,6 @@ export type { VldEvents, VldEventPayload, ParseStartEvent, ParseSuccessEvent, Pa
 export { createVldKernel, getVldKernel, resetVldKernel, usePlugin, definePlugin, type VldContext, type VldPlugin, type VldKernelInstance, type VldKernelOptions, type ValidatorFactory, type TransformFactory, type CodecFactory, type HookContext, type PluginBuilder, type PluginMeta, type PluginHooks } from './kernel';
 export { createLogger, initLogger, getLogger, setLogLevel, enableDebug, disableLogging, createNoOpLogger, type Logger, type LoggerOptions, type LogLevel, type LogEntry, type LogHandler } from './logger';
 export { pigment, supportsColor, bold, dim, italic, underline, red, green, yellow, blue, magenta, cyan, white, gray, grey, strip, vldTheme, createTheme, type Theme } from './pigment';
+export { toJSONSchema, fromJSONSchema, type JSONSchemaDefinition, type ToJSONSchemaOptions } from './utils/json-schema';
 export default v;
 //# sourceMappingURL=index.d.ts.map