@hy_ong/zod-kit 0.2.3 → 0.2.5

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

@@ -7,8 +7,11 @@ import { L as Locale } from '../config-CABSSvAp.js';
  * Provides single-select validation that restricts input to a predefined set of allowed values,
  * with support for case-insensitive matching, default values, and transformation.
  *
+ * Uses z.enum() internally to preserve literal type inference for both z.input and z.output,
+ * making it compatible with React Hook Form resolvers and other type-aware form libraries.
+ *
  * @author Ong Hoe Yuan
- * @version 0.2.2
+ * @version 0.2.5
  */
 
 /**
@@ -26,37 +29,40 @@ type OneOfMessages = {
  * Configuration options for oneOf validation
  *
  * @template IsRequired - Whether the field is required (affects return type)
- * @template T - The type of allowed values
+ * @template V - The tuple type of allowed values, preserving literal types
  *
  * @interface OneOfOptions
- * @property {T[]} values - Array of allowed values
- * @property {T | null} [defaultValue] - Default value when input is empty
+ * @property {V} values - Array of allowed values
+ * @property {V[number] | 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, T extends string | number = string | number> = {
-    values: T[];
-    defaultValue?: IsRequired extends true ? T : T | null;
+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: T) => T;
+    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
+ * @template V - The tuple type of allowed values
  */
-type OneOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodType<T> : ZodType<T | null>;
+type OneOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true ? ZodType<V[number], V[number] | "" | null | undefined> : ZodType<V[number] | null, V[number] | "" | null | undefined>;
 /**
  * Creates a Zod schema for single-select validation that restricts values to a predefined set
  *
+ * Uses z.enum() internally to preserve both z.input and z.output literal types,
+ * ensuring compatibility with React Hook Form and other type-aware form libraries.
+ *
  * @template IsRequired - Whether the field is required (affects return type)
- * @template T - The type of allowed values (string | number)
+ * @template V - The tuple type of allowed values (inferred via const type parameter)
  * @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
+ * @param {OneOfOptions<IsRequired, V>} options - Configuration options (values is required)
+ * @returns {OneOfSchema<IsRequired, V>} Zod schema for oneOf validation
  *
  * @example
  * ```typescript
@@ -65,7 +71,7 @@ type OneOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodT
  * roleSchema.parse("admin") // ✓ "admin"
  * roleSchema.parse(null)    // ✓ null
  *
- * // Required
+ * // Required — z.input and z.output are both "active" | "inactive" | "pending"
  * const statusSchema = oneOf(true, { values: ["active", "inactive", "pending"] })
  * statusSchema.parse("active") // ✓ "active"
  * statusSchema.parse(null)     // ✗ Required
@@ -99,6 +105,6 @@ type OneOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodT
  * sizeSchema.parse("m") // ✓ "M"
  * ```
  */
-declare function oneOf<IsRequired extends boolean = false, T extends string | number = string | number>(required?: IsRequired, options?: Omit<OneOfOptions<IsRequired, T>, "required">): OneOfSchema<IsRequired, T>;
+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

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

package/dist/index.cjs

@@ -60,7 +60,7 @@ var _chunkBZSPJJYTcjs = require('./chunk-BZSPJJYT.cjs');
 var _chunkG747FHUZcjs = require('./chunk-G747FHUZ.cjs');
 
 
-var _chunkFMPHW7IDcjs = require('./chunk-FMPHW7ID.cjs');
+var _chunk5NBWPAHCcjs = require('./chunk-5NBWPAHC.cjs');
 
 
 var _chunkQ24GYUTOcjs = require('./chunk-Q24GYUTO.cjs');
@@ -114,7 +114,7 @@ var _chunkKIUO2HIRcjs = require('./chunk-KIUO2HIR.cjs');
 var _chunkJZEF5Q3Wcjs = require('./chunk-JZEF5Q3W.cjs');
 
 
-var _chunkBZWQPSHOcjs = require('./chunk-BZWQPSHO.cjs');
+var _chunk5U5ERV2Pcjs = require('./chunk-5U5ERV2P.cjs');
 
 
 
@@ -185,4 +185,4 @@ var _chunkQ7TUNJD4cjs = require('./chunk-Q7TUNJD4.cjs');
 
 
 
-exports.DATETIME_PATTERNS = _chunk53EEWALQcjs.DATETIME_PATTERNS; exports.ID_PATTERNS = _chunkJZEF5Q3Wcjs.ID_PATTERNS; exports.TAIWAN_BANK_CODES = _chunkQQWX3ICKcjs.TAIWAN_BANK_CODES; exports.TIME_PATTERNS = _chunkEDTNS2XLcjs.TIME_PATTERNS; exports.VALID_3_DIGIT_PREFIXES = _chunkFP4O2ICMcjs.VALID_3_DIGIT_PREFIXES; exports.boolean = _chunkLNWEJED7cjs.boolean; exports.color = _chunkA2GAEU4Ocjs.color; exports.coordinate = _chunkFEL432I2cjs.coordinate; exports.creditCard = _chunkZCX22PY4cjs.creditCard; exports.date = _chunk4AQB4RSUcjs.date; exports.datetime = _chunk53EEWALQcjs.datetime; exports.detectCardType = _chunkZCX22PY4cjs.detectCardType; exports.detectIdType = _chunkJZEF5Q3Wcjs.detectIdType; exports.email = _chunkH25N5GP6cjs.email; exports.file = _chunkKIUO2HIRcjs.file; exports.getLocale = _chunkQ7TUNJD4cjs.getLocale; exports.id = _chunkJZEF5Q3Wcjs.id; exports.ip = _chunkLXFRQLH4cjs.ip; exports.manyOf = _chunkBZWQPSHOcjs.manyOf; exports.normalizeDateTimeValue = _chunk53EEWALQcjs.normalizeDateTimeValue; exports.normalizeTime = _chunkEDTNS2XLcjs.normalizeTime; exports.number = _chunkG747FHUZcjs.number; exports.oneOf = _chunkFMPHW7IDcjs.oneOf; exports.parseDateTimeValue = _chunk53EEWALQcjs.parseDateTimeValue; exports.parseTimeToMinutes = _chunkEDTNS2XLcjs.parseTimeToMinutes; exports.password = _chunkQ24GYUTOcjs.password; exports.setLocale = _chunkQ7TUNJD4cjs.setLocale; exports.text = _chunkHZ2WESSLcjs.text; exports.time = _chunkEDTNS2XLcjs.time; exports.twBankAccount = _chunkQQWX3ICKcjs.twBankAccount; exports.twBusinessId = _chunkIWR3H7IHcjs.twBusinessId; exports.twFax = _chunkBZSPJJYTcjs.twFax; exports.twInvoice = _chunkV2KKGSKQcjs.twInvoice; exports.twLicensePlate = _chunkTPXRQT2Hcjs.twLicensePlate; exports.twMobile = _chunkAYCXAJRAcjs.twMobile; exports.twNationalId = _chunkUCPKW43Kcjs.twNationalId; exports.twPassport = _chunk5ZMTAI4Gcjs.twPassport; exports.twPostalCode = _chunkFP4O2ICMcjs.twPostalCode; exports.twTel = _chunkVKBNKPFOcjs.twTel; exports.url = _chunkTDEXEIHHcjs.url; exports.validate3DigitPostalCode = _chunkFP4O2ICMcjs.validate3DigitPostalCode; exports.validate5DigitPostalCode = _chunkFP4O2ICMcjs.validate5DigitPostalCode; exports.validate6DigitPostalCode = _chunkFP4O2ICMcjs.validate6DigitPostalCode; exports.validateCitizenId = _chunkUCPKW43Kcjs.validateCitizenId; exports.validateColor = _chunkA2GAEU4Ocjs.validateColor; exports.validateCreditCard = _chunkZCX22PY4cjs.validateCreditCard; exports.validateDateTimeFormat = _chunk53EEWALQcjs.validateDateTimeFormat; exports.validateIPv4 = _chunkLXFRQLH4cjs.validateIPv4; exports.validateIPv6 = _chunkLXFRQLH4cjs.validateIPv6; exports.validateIdType = _chunkJZEF5Q3Wcjs.validateIdType; exports.validateLatitude = _chunkFEL432I2cjs.validateLatitude; exports.validateLongitude = _chunkFEL432I2cjs.validateLongitude; exports.validateNewResidentId = _chunkUCPKW43Kcjs.validateNewResidentId; exports.validateOldResidentId = _chunkUCPKW43Kcjs.validateOldResidentId; exports.validateTaiwanBankAccount = _chunkQQWX3ICKcjs.validateTaiwanBankAccount; exports.validateTaiwanBusinessId = _chunkIWR3H7IHcjs.validateTaiwanBusinessId; exports.validateTaiwanFax = _chunkBZSPJJYTcjs.validateTaiwanFax; exports.validateTaiwanInvoice = _chunkV2KKGSKQcjs.validateTaiwanInvoice; exports.validateTaiwanLicensePlate = _chunkTPXRQT2Hcjs.validateTaiwanLicensePlate; exports.validateTaiwanMobile = _chunkAYCXAJRAcjs.validateTaiwanMobile; exports.validateTaiwanNationalId = _chunkUCPKW43Kcjs.validateTaiwanNationalId; exports.validateTaiwanPassport = _chunk5ZMTAI4Gcjs.validateTaiwanPassport; exports.validateTaiwanPostalCode = _chunkFP4O2ICMcjs.validateTaiwanPostalCode; exports.validateTaiwanTel = _chunkVKBNKPFOcjs.validateTaiwanTel; exports.validateTimeFormat = _chunkEDTNS2XLcjs.validateTimeFormat;
+exports.DATETIME_PATTERNS = _chunk53EEWALQcjs.DATETIME_PATTERNS; exports.ID_PATTERNS = _chunkJZEF5Q3Wcjs.ID_PATTERNS; exports.TAIWAN_BANK_CODES = _chunkQQWX3ICKcjs.TAIWAN_BANK_CODES; exports.TIME_PATTERNS = _chunkEDTNS2XLcjs.TIME_PATTERNS; exports.VALID_3_DIGIT_PREFIXES = _chunkFP4O2ICMcjs.VALID_3_DIGIT_PREFIXES; exports.boolean = _chunkLNWEJED7cjs.boolean; exports.color = _chunkA2GAEU4Ocjs.color; exports.coordinate = _chunkFEL432I2cjs.coordinate; exports.creditCard = _chunkZCX22PY4cjs.creditCard; exports.date = _chunk4AQB4RSUcjs.date; exports.datetime = _chunk53EEWALQcjs.datetime; exports.detectCardType = _chunkZCX22PY4cjs.detectCardType; exports.detectIdType = _chunkJZEF5Q3Wcjs.detectIdType; exports.email = _chunkH25N5GP6cjs.email; exports.file = _chunkKIUO2HIRcjs.file; exports.getLocale = _chunkQ7TUNJD4cjs.getLocale; exports.id = _chunkJZEF5Q3Wcjs.id; exports.ip = _chunkLXFRQLH4cjs.ip; exports.manyOf = _chunk5U5ERV2Pcjs.manyOf; exports.normalizeDateTimeValue = _chunk53EEWALQcjs.normalizeDateTimeValue; exports.normalizeTime = _chunkEDTNS2XLcjs.normalizeTime; exports.number = _chunkG747FHUZcjs.number; exports.oneOf = _chunk5NBWPAHCcjs.oneOf; exports.parseDateTimeValue = _chunk53EEWALQcjs.parseDateTimeValue; exports.parseTimeToMinutes = _chunkEDTNS2XLcjs.parseTimeToMinutes; exports.password = _chunkQ24GYUTOcjs.password; exports.setLocale = _chunkQ7TUNJD4cjs.setLocale; exports.text = _chunkHZ2WESSLcjs.text; exports.time = _chunkEDTNS2XLcjs.time; exports.twBankAccount = _chunkQQWX3ICKcjs.twBankAccount; exports.twBusinessId = _chunkIWR3H7IHcjs.twBusinessId; exports.twFax = _chunkBZSPJJYTcjs.twFax; exports.twInvoice = _chunkV2KKGSKQcjs.twInvoice; exports.twLicensePlate = _chunkTPXRQT2Hcjs.twLicensePlate; exports.twMobile = _chunkAYCXAJRAcjs.twMobile; exports.twNationalId = _chunkUCPKW43Kcjs.twNationalId; exports.twPassport = _chunk5ZMTAI4Gcjs.twPassport; exports.twPostalCode = _chunkFP4O2ICMcjs.twPostalCode; exports.twTel = _chunkVKBNKPFOcjs.twTel; exports.url = _chunkTDEXEIHHcjs.url; exports.validate3DigitPostalCode = _chunkFP4O2ICMcjs.validate3DigitPostalCode; exports.validate5DigitPostalCode = _chunkFP4O2ICMcjs.validate5DigitPostalCode; exports.validate6DigitPostalCode = _chunkFP4O2ICMcjs.validate6DigitPostalCode; exports.validateCitizenId = _chunkUCPKW43Kcjs.validateCitizenId; exports.validateColor = _chunkA2GAEU4Ocjs.validateColor; exports.validateCreditCard = _chunkZCX22PY4cjs.validateCreditCard; exports.validateDateTimeFormat = _chunk53EEWALQcjs.validateDateTimeFormat; exports.validateIPv4 = _chunkLXFRQLH4cjs.validateIPv4; exports.validateIPv6 = _chunkLXFRQLH4cjs.validateIPv6; exports.validateIdType = _chunkJZEF5Q3Wcjs.validateIdType; exports.validateLatitude = _chunkFEL432I2cjs.validateLatitude; exports.validateLongitude = _chunkFEL432I2cjs.validateLongitude; exports.validateNewResidentId = _chunkUCPKW43Kcjs.validateNewResidentId; exports.validateOldResidentId = _chunkUCPKW43Kcjs.validateOldResidentId; exports.validateTaiwanBankAccount = _chunkQQWX3ICKcjs.validateTaiwanBankAccount; exports.validateTaiwanBusinessId = _chunkIWR3H7IHcjs.validateTaiwanBusinessId; exports.validateTaiwanFax = _chunkBZSPJJYTcjs.validateTaiwanFax; exports.validateTaiwanInvoice = _chunkV2KKGSKQcjs.validateTaiwanInvoice; exports.validateTaiwanLicensePlate = _chunkTPXRQT2Hcjs.validateTaiwanLicensePlate; exports.validateTaiwanMobile = _chunkAYCXAJRAcjs.validateTaiwanMobile; exports.validateTaiwanNationalId = _chunkUCPKW43Kcjs.validateTaiwanNationalId; exports.validateTaiwanPassport = _chunk5ZMTAI4Gcjs.validateTaiwanPassport; exports.validateTaiwanPostalCode = _chunkFP4O2ICMcjs.validateTaiwanPostalCode; exports.validateTaiwanTel = _chunkVKBNKPFOcjs.validateTaiwanTel; exports.validateTimeFormat = _chunkEDTNS2XLcjs.validateTimeFormat;

package/dist/index.js

@@ -60,7 +60,7 @@ import {
 } from "./chunk-3QLUXIY2.js";
 import {
   oneOf
-} from "./chunk-3ZF5JO3F.js";
+} from "./chunk-YG6YHVAE.js";
 import {
   password
 } from "./chunk-NWQSOSNF.js";
@@ -114,7 +114,7 @@ import {
 } from "./chunk-H6STFX4I.js";
 import {
   manyOf
-} from "./chunk-7X3XPK6A.js";
+} from "./chunk-S4OJGXWC.js";
 import {
   getLocale,
   setLocale

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hy_ong/zod-kit",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "A comprehensive TypeScript library providing pre-built Zod validation schemas with full internationalization support for common data types and Taiwan-specific formats",
   "keywords": [
     "zod",

package/src/validators/common/many-of.ts

@@ -4,8 +4,10 @@
  * Provides multi-select validation that restricts input to an array of values
  * from a predefined set, with min/max selection, duplicate control, and transformation.
  *
+ * Avoids z.preprocess() to preserve z.input types for React Hook Form compatibility.
+ *
  * @author Ong Hoe Yuan
- * @version 0.2.2
+ * @version 0.2.5
  */
 
 import { z, ZodType } from "zod"
@@ -34,11 +36,11 @@ export type ManyOfMessages = {
  * Configuration options for manyOf validation
  *
  * @template IsRequired - Whether the field is required (affects return type)
- * @template T - The type of allowed values
+ * @template V - The tuple type of allowed values, preserving literal types
  *
  * @interface ManyOfOptions
- * @property {T[]} values - Array of allowed values
- * @property {T[] | null} [defaultValue] - Default value when input is empty
+ * @property {V} values - Array of allowed values
+ * @property {V[number][] | 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
@@ -46,14 +48,14 @@ export type ManyOfMessages = {
  * @property {Function} [transform] - Custom transformation function applied to each value
  * @property {Record<Locale, ManyOfMessages>} [i18n] - Custom error messages for different locales
  */
-export type ManyOfOptions<IsRequired extends boolean = true, T extends string | number = string | number> = {
-  values: T[]
-  defaultValue?: IsRequired extends true ? T[] : T[] | null
+export 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: T[]) => T[]
+  transform?: (value: V[number][]) => V[number][]
   i18n?: Partial<Record<Locale, Partial<ManyOfMessages>>>
 }
 
@@ -61,18 +63,22 @@ export type ManyOfOptions<IsRequired extends boolean = true, T extends string |
  * Type alias for manyOf validation schema based on required flag
  *
  * @template IsRequired - Whether the field is required
- * @template T - The type of allowed values
+ * @template V - The tuple type of allowed values
  */
-export type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodType<T[]> : ZodType<T[] | null>
+export type ManyOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true
+  ? ZodType<V[number][], V[number][] | "" | null | undefined>
+  : ZodType<V[number][] | null, V[number][] | "" | null | undefined>
 
 /**
  * Creates a Zod schema for multi-select validation that restricts values to a predefined set
  *
+ * Avoids z.preprocess() to preserve z.input types for React Hook Form compatibility.
+ *
  * @template IsRequired - Whether the field is required (affects return type)
- * @template T - The type of allowed values (string | number)
+ * @template V - The tuple type of allowed values (inferred via const type parameter)
  * @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
+ * @param {ManyOfOptions<IsRequired, V>} options - Configuration options (values is required)
+ * @returns {ManyOfSchema<IsRequired, V>} Zod schema for manyOf validation
  *
  * @example
  * ```typescript
@@ -110,13 +116,14 @@ export type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends tru
  * itemsSchema.parse([1, 1, 2]) // ✓ [1, 1, 2]
  * ```
  */
-export function manyOf<IsRequired extends boolean = false, T extends string | number = string | number>(
+export function manyOf<IsRequired extends boolean = false, const V extends readonly (string | number)[] = readonly (string | number)[]>(
   required?: IsRequired,
-  options?: Omit<ManyOfOptions<IsRequired, T>, "required">,
-): ManyOfSchema<IsRequired, T> {
-  const { values = [] as unknown as T[], defaultValue = null, min, max, allowDuplicates = false, caseSensitive = true, transform, i18n } = options ?? {}
+  options?: Omit<ManyOfOptions<IsRequired, V>, "required">,
+): ManyOfSchema<IsRequired, V> {
+  const { values = [] as unknown as V, defaultValue = null, min, max, allowDuplicates = false, caseSensitive = true, transform, i18n } = options ?? {}
 
   const isRequired = required ?? (false as IsRequired)
+  const valuesArr = values as readonly (string | number)[]
 
   const getMessage = (key: keyof ManyOfMessages, params?: Record<string, any>) => {
     if (i18n) {
@@ -132,15 +139,15 @@ export function manyOf<IsRequired extends boolean = false, T extends string | nu
 
   const normalizeItem = (item: unknown): unknown => {
     // Coerce number strings to numbers when values contains numbers
-    const hasNumbers = values.some((v) => typeof v === "number")
+    const hasNumbers = valuesArr.some((v) => typeof v === "number")
     if (hasNumbers && typeof item === "string" && !isNaN(Number(item)) && item.trim() !== "") {
       const numVal = Number(item)
-      if ((values as number[]).includes(numVal)) return numVal
+      if ((valuesArr as readonly number[]).includes(numVal)) return numVal
     }
 
     // Case-insensitive normalization
     if (!caseSensitive && typeof item === "string") {
-      const match = values.find((v) => typeof v === "string" && v.toLowerCase() === item.toLowerCase())
+      const match = valuesArr.find((v) => typeof v === "string" && v.toLowerCase() === item.toLowerCase())
       if (match !== undefined) return match
       return item
     }
@@ -148,72 +155,70 @@ export function manyOf<IsRequired extends boolean = false, T extends string | nu
     return item
   }
 
-  const preprocessFn = (val: unknown) => {
-    if (val === null || val === undefined || val === "") {
-      return defaultValue
-    }
-
-    if (!Array.isArray(val)) {
-      // Accept single value and wrap in array
-      return [normalizeItem(val)]
-    }
-
-    return val.map(normalizeItem)
-  }
-
-  const baseSchema = z.preprocess(preprocessFn, z.any())
-
-  const schema = baseSchema.superRefine((val, ctx) => {
-    if (val === null) {
-      if (isRequired) {
-        ctx.addIssue({ code: "custom", message: getMessage("required") })
+  // Build an array schema that validates + normalizes items, then applies superRefine for constraints
+  const arraySchema = z
+    .array(z.any())
+    .transform((arr) => arr.map(normalizeItem))
+    .superRefine((val, ctx) => {
+      // Check each item is in the allowed values
+      for (const item of val) {
+        if (!(valuesArr as readonly (string | number)[]).includes(item as string | number)) {
+          ctx.addIssue({
+            code: "custom",
+            message: getMessage("invalid", { values: valuesArr.join(", ") }),
+          })
+          return
+        }
       }
-      return
-    }
 
-    if (!Array.isArray(val)) {
-      ctx.addIssue({ code: "custom", message: getMessage("invalid", { values: values.join(", ") }) })
-      return
-    }
+      // Duplicate check
+      if (!allowDuplicates) {
+        const seen = new Set()
+        for (const item of val) {
+          if (seen.has(item)) {
+            ctx.addIssue({ code: "custom", message: getMessage("duplicate") })
+            return
+          }
+          seen.add(item)
+        }
+      }
 
-    // Check each item is in the allowed values
-    for (const item of val) {
-      if (!values.includes(item as T)) {
-        ctx.addIssue({
-          code: "custom",
-          message: getMessage("invalid", { values: values.join(", ") }),
-        })
+      // Min/max selection count
+      if (min !== undefined && val.length < min) {
+        ctx.addIssue({ code: "custom", message: getMessage("minSelect", { min }) })
         return
       }
-    }
 
-    // Duplicate check
-    if (!allowDuplicates) {
-      const seen = new Set()
-      for (const item of val) {
-        if (seen.has(item)) {
-          ctx.addIssue({ code: "custom", message: getMessage("duplicate") })
-          return
-        }
-        seen.add(item)
+      if (max !== undefined && val.length > max) {
+        ctx.addIssue({ code: "custom", message: getMessage("maxSelect", { max }) })
+        return
       }
-    }
-
-    // Min/max selection count
-    if (min !== undefined && val.length < min) {
-      ctx.addIssue({ code: "custom", message: getMessage("minSelect", { min }) })
-      return
-    }
+    })
+    .transform((val) => {
+      if (!transform) return val as V[number][]
+      return transform(val as V[number][])
+    })
+
+  // Single value → wrap in array
+  const singleToArray = z.union([z.string(), z.number()]).transform((v) => [normalizeItem(v)])
+    .pipe(arraySchema)
+
+  // Handle required vs optional
+  const fallback = defaultValue as V[number][] | null
+
+  if (isRequired && fallback === null) {
+    // Required, no default: empty values should fail with "required" message
+    const emptyRejectSchema = z
+      .union([z.literal("" as const), z.null(), z.undefined()])
+      .refine(() => false, { message: getMessage("required") })
+
+    return z.union([arraySchema, singleToArray, emptyRejectSchema]) as unknown as ManyOfSchema<IsRequired, V>
+  }
 
-    if (max !== undefined && val.length > max) {
-      ctx.addIssue({ code: "custom", message: getMessage("maxSelect", { max }) })
-      return
-    }
-  })
-  .transform((val) => {
-    if (val === null || !Array.isArray(val) || !transform) return val
-    return transform(val as T[])
-  })
+  // Optional or has default: empty values → fallback
+  const emptySchema = z
+    .union([z.literal("" as const), z.null(), z.undefined()])
+    .transform(() => fallback)
 
-  return schema as unknown as ManyOfSchema<IsRequired, T>
+  return z.union([arraySchema, singleToArray, emptySchema]) as unknown as ManyOfSchema<IsRequired, V>
 }

package/src/validators/common/one-of.ts

@@ -4,8 +4,11 @@
  * Provides single-select validation that restricts input to a predefined set of allowed values,
  * with support for case-insensitive matching, default values, and transformation.
  *
+ * Uses z.enum() internally to preserve literal type inference for both z.input and z.output,
+ * making it compatible with React Hook Form resolvers and other type-aware form libraries.
+ *
  * @author Ong Hoe Yuan
- * @version 0.2.2
+ * @version 0.2.5
  */
 
 import { z, ZodType } from "zod"
@@ -28,20 +31,20 @@ export type OneOfMessages = {
  * Configuration options for oneOf validation
  *
  * @template IsRequired - Whether the field is required (affects return type)
- * @template T - The type of allowed values
+ * @template V - The tuple type of allowed values, preserving literal types
  *
  * @interface OneOfOptions
- * @property {T[]} values - Array of allowed values
- * @property {T | null} [defaultValue] - Default value when input is empty
+ * @property {V} values - Array of allowed values
+ * @property {V[number] | 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
  */
-export type OneOfOptions<IsRequired extends boolean = true, T extends string | number = string | number> = {
-  values: T[]
-  defaultValue?: IsRequired extends true ? T : T | null
+export 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: T) => T
+  transform?: (value: V[number]) => V[number]
   i18n?: Partial<Record<Locale, Partial<OneOfMessages>>>
 }
 
@@ -49,18 +52,23 @@ export type OneOfOptions<IsRequired extends boolean = true, T extends string | n
  * Type alias for oneOf validation schema based on required flag
  *
  * @template IsRequired - Whether the field is required
- * @template T - The type of allowed values
+ * @template V - The tuple type of allowed values
  */
-export type OneOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodType<T> : ZodType<T | null>
+export type OneOfSchema<IsRequired extends boolean, V extends readonly (string | number)[]> = IsRequired extends true
+  ? ZodType<V[number], V[number] | "" | null | undefined>
+  : ZodType<V[number] | null, V[number] | "" | null | undefined>
 
 /**
  * Creates a Zod schema for single-select validation that restricts values to a predefined set
  *
+ * Uses z.enum() internally to preserve both z.input and z.output literal types,
+ * ensuring compatibility with React Hook Form and other type-aware form libraries.
+ *
  * @template IsRequired - Whether the field is required (affects return type)
- * @template T - The type of allowed values (string | number)
+ * @template V - The tuple type of allowed values (inferred via const type parameter)
  * @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
+ * @param {OneOfOptions<IsRequired, V>} options - Configuration options (values is required)
+ * @returns {OneOfSchema<IsRequired, V>} Zod schema for oneOf validation
  *
  * @example
  * ```typescript
@@ -69,7 +77,7 @@ export type OneOfSchema<IsRequired extends boolean, T> = IsRequired extends true
  * roleSchema.parse("admin") // ✓ "admin"
  * roleSchema.parse(null)    // ✓ null
  *
- * // Required
+ * // Required — z.input and z.output are both "active" | "inactive" | "pending"
  * const statusSchema = oneOf(true, { values: ["active", "inactive", "pending"] })
  * statusSchema.parse("active") // ✓ "active"
  * statusSchema.parse(null)     // ✗ Required
@@ -103,13 +111,15 @@ export type OneOfSchema<IsRequired extends boolean, T> = IsRequired extends true
  * sizeSchema.parse("m") // ✓ "M"
  * ```
  */
-export function oneOf<IsRequired extends boolean = false, T extends string | number = string | number>(
+export function oneOf<IsRequired extends boolean = false, const V extends readonly (string | number)[] = readonly (string | number)[]>(
   required?: IsRequired,
-  options?: Omit<OneOfOptions<IsRequired, T>, "required">,
-): OneOfSchema<IsRequired, T> {
-  const { values = [] as unknown as T[], defaultValue = null, caseSensitive = true, transform, i18n } = options ?? {}
+  options?: Omit<OneOfOptions<IsRequired, V>, "required">,
+): OneOfSchema<IsRequired, V> {
+  const { values = [] as unknown as V, defaultValue = null, caseSensitive = true, transform, i18n } = options ?? {}
 
   const isRequired = required ?? (false as IsRequired)
+  const valuesArr = values as readonly (string | number)[]
+  const isAllStrings = valuesArr.every((v) => typeof v === "string")
 
   const getMessage = (key: keyof OneOfMessages, params?: Record<string, any>) => {
     if (i18n) {
@@ -123,50 +133,82 @@ export function oneOf<IsRequired extends boolean = false, T extends string | num
     return t(`common.oneOf.${key}`, params)
   }
 
-  const preprocessFn = (val: unknown) => {
-    if (val === "" || val === null || val === undefined) {
-      return defaultValue
-    }
+  const isEmpty = (v: unknown) => v === "" || v === null || v === undefined
 
-    // Coerce number strings to numbers when values contains numbers
-    const hasNumbers = values.some((v) => typeof v === "number")
-    if (hasNumbers && typeof val === "string" && !isNaN(Number(val)) && val.trim() !== "") {
-      const numVal = Number(val)
-      if ((values as number[]).includes(numVal)) return numVal
-    }
+  // Build the value-matching schema using z.enum() or z.union(z.literal())
+  let valueSchema: ZodType
+  if (isAllStrings && valuesArr.length > 0) {
+    valueSchema = z.enum(valuesArr as unknown as readonly [string, ...string[]], {
+      error: (issue) => {
+        if (isEmpty(issue.input)) return getMessage("required")
+        return getMessage("invalid", { values: valuesArr.join(", ") })
+      },
+    })
+  } else if (valuesArr.length >= 2) {
+    const literals = valuesArr.map((v) => z.literal(v))
+    valueSchema = z.union(literals as unknown as readonly [ZodType, ZodType, ...ZodType[]], {
+      error: () => getMessage("invalid", { values: valuesArr.join(", ") }),
+    })
+  } else if (valuesArr.length === 1) {
+    valueSchema = z.literal(valuesArr[0])
+  } else {
+    valueSchema = z.never()
+  }
 
-    // Case-insensitive normalization for string values
-    if (!caseSensitive && typeof val === "string") {
-      const match = values.find((v) => typeof v === "string" && v.toLowerCase() === val.toLowerCase())
-      if (match !== undefined) return match
-      return val
-    }
+  // Case-insensitive: pipe through a string normalizer
+  if (!caseSensitive) {
+    valueSchema = z
+      .string()
+      .transform((v) => {
+        const match = valuesArr.find((val) => typeof val === "string" && val.toLowerCase() === v.toLowerCase())
+        return (match ?? v) as string
+      })
+      .pipe(valueSchema as ZodType<any, any>)
+  }
 
-    return val
+  // User transform (applied after validation)
+  if (transform) {
+    valueSchema = valueSchema.transform((v) => transform(v as V[number]))
   }
 
-  const baseSchema = z.preprocess(preprocessFn, z.any())
+  // Handle required vs optional
+  const fallback = defaultValue as V[number] | null
+  const emptySchema = z
+    .union([z.literal("" as const), z.null(), z.undefined()])
+    .transform(() => fallback)
 
-  const schema = baseSchema
-    .superRefine((val, ctx) => {
-      if (val === null) {
-        if (isRequired) {
-          ctx.addIssue({ code: "custom", message: getMessage("required") })
-        }
-        return
-      }
+  if (isRequired && fallback === null) {
+    // Required, no default: empty values should fail with "required" message
+    const emptyRejectSchema = z
+      .union([z.literal("" as const), z.null(), z.undefined()])
+      .refine(() => false, { message: getMessage("required") })
 
-      if (!values.includes(val as T)) {
-        ctx.addIssue({
-          code: "custom",
-          message: getMessage("invalid", { values: values.join(", ") }),
+    // For numeric values from forms (string "3" → number 3)
+    if (!isAllStrings) {
+      const numCoerceSchema = z
+        .string()
+        .transform((v) => {
+          const n = Number(v)
+          return isNaN(n) ? v : n
         })
-      }
-    })
-    .transform((val) => {
-      if (val === null || !transform) return val
-      return transform(val as T)
-    })
+        .pipe(valueSchema as ZodType<any, any>)
+      return z.union([valueSchema, numCoerceSchema, emptyRejectSchema]) as unknown as OneOfSchema<IsRequired, V>
+    }
+
+    return z.union([valueSchema, emptyRejectSchema]) as unknown as OneOfSchema<IsRequired, V>
+  }
+
+  // Required with default or optional: empty values → fallback
+  if (!isAllStrings) {
+    const numCoerceSchema = z
+      .string()
+      .transform((v) => {
+        const n = Number(v)
+        return isNaN(n) ? v : n
+      })
+      .pipe(valueSchema as ZodType<any, any>)
+    return z.union([valueSchema, numCoerceSchema, emptySchema]) as unknown as OneOfSchema<IsRequired, V>
+  }
 
-  return schema as unknown as OneOfSchema<IsRequired, T>
+  return z.union([valueSchema, emptySchema]) as unknown as OneOfSchema<IsRequired, V>
 }