@hy_ong/zod-kit 0.2.2 → 0.2.4

package/dist/common/datetime.cjs

@@ -4,12 +4,12 @@
 
 
 
-var _chunkOPQJWHXNcjs = require('../chunk-OPQJWHXN.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunk53EEWALQcjs = require('../chunk-53EEWALQ.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
 
 
 
 
-exports.DATETIME_PATTERNS = _chunkOPQJWHXNcjs.DATETIME_PATTERNS; exports.datetime = _chunkOPQJWHXNcjs.datetime; exports.normalizeDateTimeValue = _chunkOPQJWHXNcjs.normalizeDateTimeValue; exports.parseDateTimeValue = _chunkOPQJWHXNcjs.parseDateTimeValue; exports.validateDateTimeFormat = _chunkOPQJWHXNcjs.validateDateTimeFormat;
+exports.DATETIME_PATTERNS = _chunk53EEWALQcjs.DATETIME_PATTERNS; exports.datetime = _chunk53EEWALQcjs.datetime; exports.normalizeDateTimeValue = _chunk53EEWALQcjs.normalizeDateTimeValue; exports.parseDateTimeValue = _chunk53EEWALQcjs.parseDateTimeValue; exports.validateDateTimeFormat = _chunk53EEWALQcjs.validateDateTimeFormat;

package/dist/common/datetime.js

@@ -4,8 +4,8 @@ import {
   normalizeDateTimeValue,
   parseDateTimeValue,
   validateDateTimeFormat
-} from "../chunk-ZXUMK2RR.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-RHKBT3M2.js";
+import "../chunk-POIDES2L.js";
 export {
   DATETIME_PATTERNS,
   datetime,

package/dist/common/email.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkHMSM6FFAcjs = require('../chunk-HMSM6FFA.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkH25N5GP6cjs = require('../chunk-H25N5GP6.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
-exports.email = _chunkHMSM6FFAcjs.email;
+exports.email = _chunkH25N5GP6cjs.email;

package/dist/common/email.js

@@ -1,7 +1,7 @@
 import {
   email
-} from "../chunk-MM7IL2RG.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-XAN4CAVH.js";
+import "../chunk-POIDES2L.js";
 export {
   email
 };

package/dist/common/file.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkHTEHINI7cjs = require('../chunk-HTEHINI7.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkKIUO2HIRcjs = require('../chunk-KIUO2HIR.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
-exports.file = _chunkHTEHINI7cjs.file;
+exports.file = _chunkKIUO2HIRcjs.file;

package/dist/common/file.js

@@ -1,7 +1,7 @@
 import {
   file
-} from "../chunk-WDI4QJMQ.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-OGU7AIZF.js";
+import "../chunk-POIDES2L.js";
 export {
   file
 };

package/dist/common/id.cjs

@@ -3,11 +3,11 @@
 
 
 
-var _chunkB4EZYZOKcjs = require('../chunk-B4EZYZOK.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkJZEF5Q3Wcjs = require('../chunk-JZEF5Q3W.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
 
 
 
-exports.ID_PATTERNS = _chunkB4EZYZOKcjs.ID_PATTERNS; exports.detectIdType = _chunkB4EZYZOKcjs.detectIdType; exports.id = _chunkB4EZYZOKcjs.id; exports.validateIdType = _chunkB4EZYZOKcjs.validateIdType;
+exports.ID_PATTERNS = _chunkJZEF5Q3Wcjs.ID_PATTERNS; exports.detectIdType = _chunkJZEF5Q3Wcjs.detectIdType; exports.id = _chunkJZEF5Q3Wcjs.id; exports.validateIdType = _chunkJZEF5Q3Wcjs.validateIdType;

package/dist/common/id.js

@@ -3,8 +3,8 @@ import {
   detectIdType,
   id,
   validateIdType
-} from "../chunk-MHJFYYGV.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-H6STFX4I.js";
+import "../chunk-POIDES2L.js";
 export {
   ID_PATTERNS,
   detectIdType,

package/dist/common/ip.cjs

@@ -2,10 +2,10 @@
 
 
 
-var _chunk32JI34CVcjs = require('../chunk-32JI34CV.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkLXFRQLH4cjs = require('../chunk-LXFRQLH4.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
 
 
-exports.ip = _chunk32JI34CVcjs.ip; exports.validateIPv4 = _chunk32JI34CVcjs.validateIPv4; exports.validateIPv6 = _chunk32JI34CVcjs.validateIPv6;
+exports.ip = _chunkLXFRQLH4cjs.ip; exports.validateIPv4 = _chunkLXFRQLH4cjs.validateIPv4; exports.validateIPv6 = _chunkLXFRQLH4cjs.validateIPv6;

package/dist/common/ip.js

@@ -2,8 +2,8 @@ import {
   ip,
   validateIPv4,
   validateIPv6
-} from "../chunk-RO47DKQG.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-7SKH66CM.js";
+import "../chunk-POIDES2L.js";
 export {
   ip,
   validateIPv4,

package/dist/common/many-of.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkBZWQPSHOcjs = require('../chunk-BZWQPSHO.cjs');
+require('../chunk-Q7TUNJD4.cjs');
+
+
+exports.manyOf = _chunkBZWQPSHOcjs.manyOf;

package/dist/common/many-of.d.cts

@@ -0,0 +1,111 @@
+import { ZodType } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.cjs';
+
+/**
+ * @fileoverview ManyOf validator for Zod Kit
+ *
+ * Provides multi-select validation that restricts input to an array of values
+ * from a predefined set, with min/max selection, duplicate control, and transformation.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.2.2
+ */
+
+/**
+ * Type definition for manyOf validation error messages
+ *
+ * @interface ManyOfMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when a value is not in the allowed list
+ * @property {string} [minSelect] - Message when fewer than minimum items are selected
+ * @property {string} [maxSelect] - Message when more than maximum items are selected
+ * @property {string} [duplicate] - Message when duplicate values are found
+ */
+type ManyOfMessages = {
+    required?: string;
+    invalid?: string;
+    minSelect?: string;
+    maxSelect?: string;
+    duplicate?: string;
+};
+/**
+ * Configuration options for manyOf validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values
+ *
+ * @interface ManyOfOptions
+ * @property {T[]} values - Array of allowed values
+ * @property {T[] | null} [defaultValue] - Default value when input is empty
+ * @property {number} [min] - Minimum number of selections
+ * @property {number} [max] - Maximum number of selections
+ * @property {boolean} [allowDuplicates=false] - Whether to allow duplicate selections
+ * @property {boolean} [caseSensitive=true] - Whether string matching is case-sensitive
+ * @property {Function} [transform] - Custom transformation function applied to each value
+ * @property {Record<Locale, ManyOfMessages>} [i18n] - Custom error messages for different locales
+ */
+type ManyOfOptions<IsRequired extends boolean = true, V extends readonly (string | number)[] = readonly (string | number)[]> = {
+    values: V;
+    defaultValue?: IsRequired extends true ? V[number][] : V[number][] | null;
+    min?: number;
+    max?: number;
+    allowDuplicates?: boolean;
+    caseSensitive?: boolean;
+    transform?: (value: V[number][]) => V[number][];
+    i18n?: Partial<Record<Locale, Partial<ManyOfMessages>>>;
+};
+/**
+ * Type alias for manyOf validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @template T - The type of allowed values
+ */
+type ManyOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true ? ZodType<V[number][]> : ZodType<V[number][] | null>;
+/**
+ * Creates a Zod schema for multi-select validation that restricts values to a predefined set
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values (string | number)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {ManyOfOptions<IsRequired, T>} options - Configuration options (values is required)
+ * @returns {ManyOfSchema<IsRequired, T>} Zod schema for manyOf validation
+ *
+ * @example
+ * ```typescript
+ * // Basic multi-select (optional by default)
+ * const tagsSchema = manyOf(false, { values: ["js", "ts", "rust", "go"] })
+ * tagsSchema.parse(["js", "ts"]) // ✓ ["js", "ts"]
+ * tagsSchema.parse(null)          // ✓ null
+ *
+ * // Required with min/max
+ * const skillsSchema = manyOf(true, {
+ *   values: ["react", "vue", "angular", "svelte"],
+ *   min: 1,
+ *   max: 3,
+ * })
+ * skillsSchema.parse(["react"])                        // ✓
+ * skillsSchema.parse([])                               // ✗ minSelect
+ * skillsSchema.parse(["react", "vue", "angular", "svelte"]) // ✗ maxSelect
+ *
+ * // Case-insensitive matching
+ * const colorsSchema = manyOf(true, {
+ *   values: ["red", "green", "blue"],
+ *   caseSensitive: false,
+ * })
+ * colorsSchema.parse(["RED", "Green"]) // ✓ ["red", "green"]
+ *
+ * // No duplicates (default)
+ * const rolesSchema = manyOf(true, { values: ["admin", "editor", "viewer"] })
+ * rolesSchema.parse(["admin", "admin"]) // ✗ duplicate
+ *
+ * // Allow duplicates
+ * const itemsSchema = manyOf(true, {
+ *   values: [1, 2, 3],
+ *   allowDuplicates: true,
+ * })
+ * itemsSchema.parse([1, 1, 2]) // ✓ [1, 1, 2]
+ * ```
+ */
+declare function manyOf<IsRequired extends boolean = false, const V extends readonly (string | number)[] = readonly (string | number)[]>(required?: IsRequired, options?: Omit<ManyOfOptions<IsRequired, V>, "required">): ManyOfSchema<IsRequired, V>;
+
+export { type ManyOfMessages, type ManyOfOptions, type ManyOfSchema, manyOf };

package/dist/common/many-of.d.ts

@@ -0,0 +1,111 @@
+import { ZodType } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.js';
+
+/**
+ * @fileoverview ManyOf validator for Zod Kit
+ *
+ * Provides multi-select validation that restricts input to an array of values
+ * from a predefined set, with min/max selection, duplicate control, and transformation.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.2.2
+ */
+
+/**
+ * Type definition for manyOf validation error messages
+ *
+ * @interface ManyOfMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when a value is not in the allowed list
+ * @property {string} [minSelect] - Message when fewer than minimum items are selected
+ * @property {string} [maxSelect] - Message when more than maximum items are selected
+ * @property {string} [duplicate] - Message when duplicate values are found
+ */
+type ManyOfMessages = {
+    required?: string;
+    invalid?: string;
+    minSelect?: string;
+    maxSelect?: string;
+    duplicate?: string;
+};
+/**
+ * Configuration options for manyOf validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values
+ *
+ * @interface ManyOfOptions
+ * @property {T[]} values - Array of allowed values
+ * @property {T[] | null} [defaultValue] - Default value when input is empty
+ * @property {number} [min] - Minimum number of selections
+ * @property {number} [max] - Maximum number of selections
+ * @property {boolean} [allowDuplicates=false] - Whether to allow duplicate selections
+ * @property {boolean} [caseSensitive=true] - Whether string matching is case-sensitive
+ * @property {Function} [transform] - Custom transformation function applied to each value
+ * @property {Record<Locale, ManyOfMessages>} [i18n] - Custom error messages for different locales
+ */
+type ManyOfOptions<IsRequired extends boolean = true, V extends readonly (string | number)[] = readonly (string | number)[]> = {
+    values: V;
+    defaultValue?: IsRequired extends true ? V[number][] : V[number][] | null;
+    min?: number;
+    max?: number;
+    allowDuplicates?: boolean;
+    caseSensitive?: boolean;
+    transform?: (value: V[number][]) => V[number][];
+    i18n?: Partial<Record<Locale, Partial<ManyOfMessages>>>;
+};
+/**
+ * Type alias for manyOf validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @template T - The type of allowed values
+ */
+type ManyOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true ? ZodType<V[number][]> : ZodType<V[number][] | null>;
+/**
+ * Creates a Zod schema for multi-select validation that restricts values to a predefined set
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values (string | number)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {ManyOfOptions<IsRequired, T>} options - Configuration options (values is required)
+ * @returns {ManyOfSchema<IsRequired, T>} Zod schema for manyOf validation
+ *
+ * @example
+ * ```typescript
+ * // Basic multi-select (optional by default)
+ * const tagsSchema = manyOf(false, { values: ["js", "ts", "rust", "go"] })
+ * tagsSchema.parse(["js", "ts"]) // ✓ ["js", "ts"]
+ * tagsSchema.parse(null)          // ✓ null
+ *
+ * // Required with min/max
+ * const skillsSchema = manyOf(true, {
+ *   values: ["react", "vue", "angular", "svelte"],
+ *   min: 1,
+ *   max: 3,
+ * })
+ * skillsSchema.parse(["react"])                        // ✓
+ * skillsSchema.parse([])                               // ✗ minSelect
+ * skillsSchema.parse(["react", "vue", "angular", "svelte"]) // ✗ maxSelect
+ *
+ * // Case-insensitive matching
+ * const colorsSchema = manyOf(true, {
+ *   values: ["red", "green", "blue"],
+ *   caseSensitive: false,
+ * })
+ * colorsSchema.parse(["RED", "Green"]) // ✓ ["red", "green"]
+ *
+ * // No duplicates (default)
+ * const rolesSchema = manyOf(true, { values: ["admin", "editor", "viewer"] })
+ * rolesSchema.parse(["admin", "admin"]) // ✗ duplicate
+ *
+ * // Allow duplicates
+ * const itemsSchema = manyOf(true, {
+ *   values: [1, 2, 3],
+ *   allowDuplicates: true,
+ * })
+ * itemsSchema.parse([1, 1, 2]) // ✓ [1, 1, 2]
+ * ```
+ */
+declare function manyOf<IsRequired extends boolean = false, const V extends readonly (string | number)[] = readonly (string | number)[]>(required?: IsRequired, options?: Omit<ManyOfOptions<IsRequired, V>, "required">): ManyOfSchema<IsRequired, V>;
+
+export { type ManyOfMessages, type ManyOfOptions, type ManyOfSchema, manyOf };

package/dist/common/many-of.js

@@ -0,0 +1,7 @@
+import {
+  manyOf
+} from "../chunk-7X3XPK6A.js";
+import "../chunk-POIDES2L.js";
+export {
+  manyOf
+};

package/dist/common/number.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEGHL277Kcjs = require('../chunk-EGHL277K.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkG747FHUZcjs = require('../chunk-G747FHUZ.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
-exports.number = _chunkEGHL277Kcjs.number;
+exports.number = _chunkG747FHUZcjs.number;

package/dist/common/number.js

@@ -1,7 +1,7 @@
 import {
   number
-} from "../chunk-FM3EZ72O.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-3QLUXIY2.js";
+import "../chunk-POIDES2L.js";
 export {
   number
 };

package/dist/common/one-of.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkFMPHW7IDcjs = require('../chunk-FMPHW7ID.cjs');
+require('../chunk-Q7TUNJD4.cjs');
+
+
+exports.oneOf = _chunkFMPHW7IDcjs.oneOf;

package/dist/common/one-of.d.cts

@@ -0,0 +1,104 @@
+import { ZodType } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.cjs';
+
+/**
+ * @fileoverview OneOf validator for Zod Kit
+ *
+ * Provides single-select validation that restricts input to a predefined set of allowed values,
+ * with support for case-insensitive matching, default values, and transformation.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.2.2
+ */
+
+/**
+ * Type definition for oneOf validation error messages
+ *
+ * @interface OneOfMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when value is not in the allowed list
+ */
+type OneOfMessages = {
+    required?: string;
+    invalid?: string;
+};
+/**
+ * Configuration options for oneOf validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values
+ *
+ * @interface OneOfOptions
+ * @property {T[]} values - Array of allowed values
+ * @property {T | null} [defaultValue] - Default value when input is empty
+ * @property {boolean} [caseSensitive=true] - Whether string matching is case-sensitive
+ * @property {Function} [transform] - Custom transformation function applied after validation
+ * @property {Record<Locale, OneOfMessages>} [i18n] - Custom error messages for different locales
+ */
+type OneOfOptions<IsRequired extends boolean = true, V extends readonly (string | number)[] = readonly (string | number)[]> = {
+    values: V;
+    defaultValue?: IsRequired extends true ? V[number] : V[number] | null;
+    caseSensitive?: boolean;
+    transform?: (value: V[number]) => V[number];
+    i18n?: Partial<Record<Locale, Partial<OneOfMessages>>>;
+};
+/**
+ * Type alias for oneOf validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @template T - The type of allowed values
+ */
+type OneOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true ? ZodType<V[number]> : ZodType<V[number] | null>;
+/**
+ * Creates a Zod schema for single-select validation that restricts values to a predefined set
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values (string | number)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {OneOfOptions<IsRequired, T>} options - Configuration options (values is required)
+ * @returns {OneOfSchema<IsRequired, T>} Zod schema for oneOf validation
+ *
+ * @example
+ * ```typescript
+ * // Basic single-select validation (optional by default)
+ * const roleSchema = oneOf(false, { values: ["admin", "editor", "viewer"] })
+ * roleSchema.parse("admin") // ✓ "admin"
+ * roleSchema.parse(null)    // ✓ null
+ *
+ * // Required
+ * const statusSchema = oneOf(true, { values: ["active", "inactive", "pending"] })
+ * statusSchema.parse("active") // ✓ "active"
+ * statusSchema.parse(null)     // ✗ Required
+ * statusSchema.parse("banned") // ✗ Invalid
+ *
+ * // Numeric values
+ * const prioritySchema = oneOf(true, { values: [1, 2, 3, 4, 5] })
+ * prioritySchema.parse(3)  // ✓ 3
+ * prioritySchema.parse(10) // ✗ Invalid
+ *
+ * // Case-insensitive matching
+ * const colorSchema = oneOf(true, {
+ *   values: ["red", "green", "blue"],
+ *   caseSensitive: false
+ * })
+ * colorSchema.parse("RED")   // ✓ "red" (normalized to match original)
+ * colorSchema.parse("Green") // ✓ "green"
+ *
+ * // With default value
+ * const tierSchema = oneOf(false, {
+ *   values: ["free", "pro", "enterprise"],
+ *   defaultValue: "free"
+ * })
+ * tierSchema.parse(null) // ✓ "free"
+ *
+ * // With transform
+ * const sizeSchema = oneOf(true, {
+ *   values: ["s", "m", "l", "xl"],
+ *   transform: (val) => val.toUpperCase() as any
+ * })
+ * sizeSchema.parse("m") // ✓ "M"
+ * ```
+ */
+declare function oneOf<IsRequired extends boolean = false, const V extends readonly (string | number)[] = readonly (string | number)[]>(required?: IsRequired, options?: Omit<OneOfOptions<IsRequired, V>, "required">): OneOfSchema<IsRequired, V>;
+
+export { type OneOfMessages, type OneOfOptions, type OneOfSchema, oneOf };

package/dist/common/one-of.d.ts

@@ -0,0 +1,104 @@
+import { ZodType } from 'zod';
+import { L as Locale } from '../config-CABSSvAp.js';
+
+/**
+ * @fileoverview OneOf validator for Zod Kit
+ *
+ * Provides single-select validation that restricts input to a predefined set of allowed values,
+ * with support for case-insensitive matching, default values, and transformation.
+ *
+ * @author Ong Hoe Yuan
+ * @version 0.2.2
+ */
+
+/**
+ * Type definition for oneOf validation error messages
+ *
+ * @interface OneOfMessages
+ * @property {string} [required] - Message when field is required but empty
+ * @property {string} [invalid] - Message when value is not in the allowed list
+ */
+type OneOfMessages = {
+    required?: string;
+    invalid?: string;
+};
+/**
+ * Configuration options for oneOf validation
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values
+ *
+ * @interface OneOfOptions
+ * @property {T[]} values - Array of allowed values
+ * @property {T | null} [defaultValue] - Default value when input is empty
+ * @property {boolean} [caseSensitive=true] - Whether string matching is case-sensitive
+ * @property {Function} [transform] - Custom transformation function applied after validation
+ * @property {Record<Locale, OneOfMessages>} [i18n] - Custom error messages for different locales
+ */
+type OneOfOptions<IsRequired extends boolean = true, V extends readonly (string | number)[] = readonly (string | number)[]> = {
+    values: V;
+    defaultValue?: IsRequired extends true ? V[number] : V[number] | null;
+    caseSensitive?: boolean;
+    transform?: (value: V[number]) => V[number];
+    i18n?: Partial<Record<Locale, Partial<OneOfMessages>>>;
+};
+/**
+ * Type alias for oneOf validation schema based on required flag
+ *
+ * @template IsRequired - Whether the field is required
+ * @template T - The type of allowed values
+ */
+type OneOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true ? ZodType<V[number]> : ZodType<V[number] | null>;
+/**
+ * Creates a Zod schema for single-select validation that restricts values to a predefined set
+ *
+ * @template IsRequired - Whether the field is required (affects return type)
+ * @template T - The type of allowed values (string | number)
+ * @param {IsRequired} [required=false] - Whether the field is required
+ * @param {OneOfOptions<IsRequired, T>} options - Configuration options (values is required)
+ * @returns {OneOfSchema<IsRequired, T>} Zod schema for oneOf validation
+ *
+ * @example
+ * ```typescript
+ * // Basic single-select validation (optional by default)
+ * const roleSchema = oneOf(false, { values: ["admin", "editor", "viewer"] })
+ * roleSchema.parse("admin") // ✓ "admin"
+ * roleSchema.parse(null)    // ✓ null
+ *
+ * // Required
+ * const statusSchema = oneOf(true, { values: ["active", "inactive", "pending"] })
+ * statusSchema.parse("active") // ✓ "active"
+ * statusSchema.parse(null)     // ✗ Required
+ * statusSchema.parse("banned") // ✗ Invalid
+ *
+ * // Numeric values
+ * const prioritySchema = oneOf(true, { values: [1, 2, 3, 4, 5] })
+ * prioritySchema.parse(3)  // ✓ 3
+ * prioritySchema.parse(10) // ✗ Invalid
+ *
+ * // Case-insensitive matching
+ * const colorSchema = oneOf(true, {
+ *   values: ["red", "green", "blue"],
+ *   caseSensitive: false
+ * })
+ * colorSchema.parse("RED")   // ✓ "red" (normalized to match original)
+ * colorSchema.parse("Green") // ✓ "green"
+ *
+ * // With default value
+ * const tierSchema = oneOf(false, {
+ *   values: ["free", "pro", "enterprise"],
+ *   defaultValue: "free"
+ * })
+ * tierSchema.parse(null) // ✓ "free"
+ *
+ * // With transform
+ * const sizeSchema = oneOf(true, {
+ *   values: ["s", "m", "l", "xl"],
+ *   transform: (val) => val.toUpperCase() as any
+ * })
+ * sizeSchema.parse("m") // ✓ "M"
+ * ```
+ */
+declare function oneOf<IsRequired extends boolean = false, const V extends readonly (string | number)[] = readonly (string | number)[]>(required?: IsRequired, options?: Omit<OneOfOptions<IsRequired, V>, "required">): OneOfSchema<IsRequired, V>;
+
+export { type OneOfMessages, type OneOfOptions, type OneOfSchema, oneOf };

package/dist/common/one-of.js

@@ -0,0 +1,7 @@
+import {
+  oneOf
+} from "../chunk-3ZF5JO3F.js";
+import "../chunk-POIDES2L.js";
+export {
+  oneOf
+};

package/dist/common/password.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkYPSEIDURcjs = require('../chunk-YPSEIDUR.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkQ24GYUTOcjs = require('../chunk-Q24GYUTO.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
-exports.password = _chunkYPSEIDURcjs.password;
+exports.password = _chunkQ24GYUTOcjs.password;

package/dist/common/password.js

@@ -1,7 +1,7 @@
 import {
   password
-} from "../chunk-46VAH2BJ.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-NWQSOSNF.js";
+import "../chunk-POIDES2L.js";
 export {
   password
 };

package/dist/common/text.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkORFHDJIIcjs = require('../chunk-ORFHDJII.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkHZ2WESSLcjs = require('../chunk-HZ2WESSL.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
-exports.text = _chunkORFHDJIIcjs.text;
+exports.text = _chunkHZ2WESSLcjs.text;

package/dist/common/text.js

@@ -1,7 +1,7 @@
 import {
   text
-} from "../chunk-K2UOY6TB.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-T7PG4JDW.js";
+import "../chunk-POIDES2L.js";
 export {
   text
 };