@hy_ong/zod-kit 0.2.3 → 0.2.5

package/dist/chunk-5NBWPAHC.cjs

@@ -0,0 +1,77 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkQ7TUNJD4cjs = require('./chunk-Q7TUNJD4.cjs');
+
+// src/validators/common/one-of.ts
+var _zod = require('zod');
+function oneOf(required, options) {
+  const { values = [], defaultValue = null, caseSensitive = true, transform, i18n } = _nullishCoalesce(options, () => ( {}));
+  const isRequired = _nullishCoalesce(required, () => ( false));
+  const valuesArr = values;
+  const isAllStrings = valuesArr.every((v) => typeof v === "string");
+  const getMessage = (key, params) => {
+    if (i18n) {
+      const currentLocale = _chunkQ7TUNJD4cjs.getLocale.call(void 0, );
+      const customMessages = i18n[currentLocale];
+      if (customMessages && customMessages[key]) {
+        const template = customMessages[key];
+        return template.replace(/\$\{(\w+)}/g, (_, k) => _nullishCoalesce(_optionalChain([params, 'optionalAccess', _2 => _2[k]]), () => ( "")));
+      }
+    }
+    return _chunkQ7TUNJD4cjs.t.call(void 0, `common.oneOf.${key}`, params);
+  };
+  const isEmpty = (v) => v === "" || v === null || v === void 0;
+  let valueSchema;
+  if (isAllStrings && valuesArr.length > 0) {
+    valueSchema = _zod.z.enum(valuesArr, {
+      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) => _zod.z.literal(v));
+    valueSchema = _zod.z.union(literals, {
+      error: () => getMessage("invalid", { values: valuesArr.join(", ") })
+    });
+  } else if (valuesArr.length === 1) {
+    valueSchema = _zod.z.literal(valuesArr[0]);
+  } else {
+    valueSchema = _zod.z.never();
+  }
+  if (!caseSensitive) {
+    valueSchema = _zod.z.string().transform((v) => {
+      const match = valuesArr.find((val) => typeof val === "string" && val.toLowerCase() === v.toLowerCase());
+      return _nullishCoalesce(match, () => ( v));
+    }).pipe(valueSchema);
+  }
+  if (transform) {
+    valueSchema = valueSchema.transform((v) => transform(v));
+  }
+  const fallback = defaultValue;
+  const emptySchema = _zod.z.union([_zod.z.literal(""), _zod.z.null(), _zod.z.undefined()]).transform(() => fallback);
+  if (isRequired && fallback === null) {
+    const emptyRejectSchema = _zod.z.union([_zod.z.literal(""), _zod.z.null(), _zod.z.undefined()]).refine(() => false, { message: getMessage("required") });
+    if (!isAllStrings) {
+      const numCoerceSchema = _zod.z.string().transform((v) => {
+        const n = Number(v);
+        return isNaN(n) ? v : n;
+      }).pipe(valueSchema);
+      return _zod.z.union([valueSchema, numCoerceSchema, emptyRejectSchema]);
+    }
+    return _zod.z.union([valueSchema, emptyRejectSchema]);
+  }
+  if (!isAllStrings) {
+    const numCoerceSchema = _zod.z.string().transform((v) => {
+      const n = Number(v);
+      return isNaN(n) ? v : n;
+    }).pipe(valueSchema);
+    return _zod.z.union([valueSchema, numCoerceSchema, emptySchema]);
+  }
+  return _zod.z.union([valueSchema, emptySchema]);
+}
+
+
+
+exports.oneOf = oneOf;

package/dist/{chunk-BZWQPSHO.cjs → chunk-5U5ERV2P.cjs}

@@ -8,6 +8,7 @@ var _zod = require('zod');
 function manyOf(required, options) {
   const { values = [], defaultValue = null, min, max, allowDuplicates = false, caseSensitive = true, transform, i18n } = _nullishCoalesce(options, () => ( {}));
   const isRequired = _nullishCoalesce(required, () => ( false));
+  const valuesArr = values;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale = _chunkQ7TUNJD4cjs.getLocale.call(void 0, );
@@ -20,44 +21,24 @@ function manyOf(required, options) {
     return _chunkQ7TUNJD4cjs.t.call(void 0, `common.manyOf.${key}`, params);
   };
   const normalizeItem = (item) => {
-    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.includes(numVal)) return numVal;
+      if (valuesArr.includes(numVal)) return numVal;
     }
     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 !== void 0) return match;
       return item;
     }
     return item;
   };
-  const preprocessFn = (val) => {
-    if (val === null || val === void 0 || val === "") {
-      return defaultValue;
-    }
-    if (!Array.isArray(val)) {
-      return [normalizeItem(val)];
-    }
-    return val.map(normalizeItem);
-  };
-  const baseSchema = _zod.z.preprocess(preprocessFn, _zod.z.any());
-  const schema = baseSchema.superRefine((val, ctx) => {
-    if (val === null) {
-      if (isRequired) {
-        ctx.addIssue({ code: "custom", message: getMessage("required") });
-      }
-      return;
-    }
-    if (!Array.isArray(val)) {
-      ctx.addIssue({ code: "custom", message: getMessage("invalid", { values: values.join(", ") }) });
-      return;
-    }
+  const arraySchema = _zod.z.array(_zod.z.any()).transform((arr) => arr.map(normalizeItem)).superRefine((val, ctx) => {
     for (const item of val) {
-      if (!values.includes(item)) {
+      if (!valuesArr.includes(item)) {
         ctx.addIssue({
           code: "custom",
-          message: getMessage("invalid", { values: values.join(", ") })
+          message: getMessage("invalid", { values: valuesArr.join(", ") })
         });
         return;
       }
@@ -81,10 +62,17 @@ function manyOf(required, options) {
       return;
     }
   }).transform((val) => {
-    if (val === null || !Array.isArray(val) || !transform) return val;
+    if (!transform) return val;
     return transform(val);
   });
-  return schema;
+  const singleToArray = _zod.z.union([_zod.z.string(), _zod.z.number()]).transform((v) => [normalizeItem(v)]).pipe(arraySchema);
+  const fallback = defaultValue;
+  if (isRequired && fallback === null) {
+    const emptyRejectSchema = _zod.z.union([_zod.z.literal(""), _zod.z.null(), _zod.z.undefined()]).refine(() => false, { message: getMessage("required") });
+    return _zod.z.union([arraySchema, singleToArray, emptyRejectSchema]);
+  }
+  const emptySchema = _zod.z.union([_zod.z.literal(""), _zod.z.null(), _zod.z.undefined()]).transform(() => fallback);
+  return _zod.z.union([arraySchema, singleToArray, emptySchema]);
 }
 
 

package/dist/{chunk-7X3XPK6A.js → chunk-S4OJGXWC.js}

@@ -8,6 +8,7 @@ import { z } from "zod";
 function manyOf(required, options) {
   const { values = [], defaultValue = null, min, max, allowDuplicates = false, caseSensitive = true, transform, i18n } = options ?? {};
   const isRequired = required ?? false;
+  const valuesArr = values;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale = getLocale();
@@ -20,44 +21,24 @@ function manyOf(required, options) {
     return t(`common.manyOf.${key}`, params);
   };
   const normalizeItem = (item) => {
-    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.includes(numVal)) return numVal;
+      if (valuesArr.includes(numVal)) return numVal;
     }
     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 !== void 0) return match;
       return item;
     }
     return item;
   };
-  const preprocessFn = (val) => {
-    if (val === null || val === void 0 || val === "") {
-      return defaultValue;
-    }
-    if (!Array.isArray(val)) {
-      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") });
-      }
-      return;
-    }
-    if (!Array.isArray(val)) {
-      ctx.addIssue({ code: "custom", message: getMessage("invalid", { values: values.join(", ") }) });
-      return;
-    }
+  const arraySchema = z.array(z.any()).transform((arr) => arr.map(normalizeItem)).superRefine((val, ctx) => {
     for (const item of val) {
-      if (!values.includes(item)) {
+      if (!valuesArr.includes(item)) {
         ctx.addIssue({
           code: "custom",
-          message: getMessage("invalid", { values: values.join(", ") })
+          message: getMessage("invalid", { values: valuesArr.join(", ") })
         });
         return;
       }
@@ -81,10 +62,17 @@ function manyOf(required, options) {
       return;
     }
   }).transform((val) => {
-    if (val === null || !Array.isArray(val) || !transform) return val;
+    if (!transform) return val;
     return transform(val);
   });
-  return schema;
+  const singleToArray = z.union([z.string(), z.number()]).transform((v) => [normalizeItem(v)]).pipe(arraySchema);
+  const fallback = defaultValue;
+  if (isRequired && fallback === null) {
+    const emptyRejectSchema = z.union([z.literal(""), z.null(), z.undefined()]).refine(() => false, { message: getMessage("required") });
+    return z.union([arraySchema, singleToArray, emptyRejectSchema]);
+  }
+  const emptySchema = z.union([z.literal(""), z.null(), z.undefined()]).transform(() => fallback);
+  return z.union([arraySchema, singleToArray, emptySchema]);
 }
 
 export {

package/dist/chunk-YG6YHVAE.js

@@ -0,0 +1,77 @@
+import {
+  getLocale,
+  t
+} from "./chunk-POIDES2L.js";
+
+// src/validators/common/one-of.ts
+import { z } from "zod";
+function oneOf(required, options) {
+  const { values = [], defaultValue = null, caseSensitive = true, transform, i18n } = options ?? {};
+  const isRequired = required ?? false;
+  const valuesArr = values;
+  const isAllStrings = valuesArr.every((v) => typeof v === "string");
+  const getMessage = (key, params) => {
+    if (i18n) {
+      const currentLocale = getLocale();
+      const customMessages = i18n[currentLocale];
+      if (customMessages && customMessages[key]) {
+        const template = customMessages[key];
+        return template.replace(/\$\{(\w+)}/g, (_, k) => params?.[k] ?? "");
+      }
+    }
+    return t(`common.oneOf.${key}`, params);
+  };
+  const isEmpty = (v) => v === "" || v === null || v === void 0;
+  let valueSchema;
+  if (isAllStrings && valuesArr.length > 0) {
+    valueSchema = z.enum(valuesArr, {
+      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, {
+      error: () => getMessage("invalid", { values: valuesArr.join(", ") })
+    });
+  } else if (valuesArr.length === 1) {
+    valueSchema = z.literal(valuesArr[0]);
+  } else {
+    valueSchema = z.never();
+  }
+  if (!caseSensitive) {
+    valueSchema = z.string().transform((v) => {
+      const match = valuesArr.find((val) => typeof val === "string" && val.toLowerCase() === v.toLowerCase());
+      return match ?? v;
+    }).pipe(valueSchema);
+  }
+  if (transform) {
+    valueSchema = valueSchema.transform((v) => transform(v));
+  }
+  const fallback = defaultValue;
+  const emptySchema = z.union([z.literal(""), z.null(), z.undefined()]).transform(() => fallback);
+  if (isRequired && fallback === null) {
+    const emptyRejectSchema = z.union([z.literal(""), z.null(), z.undefined()]).refine(() => false, { message: getMessage("required") });
+    if (!isAllStrings) {
+      const numCoerceSchema = z.string().transform((v) => {
+        const n = Number(v);
+        return isNaN(n) ? v : n;
+      }).pipe(valueSchema);
+      return z.union([valueSchema, numCoerceSchema, emptyRejectSchema]);
+    }
+    return z.union([valueSchema, emptyRejectSchema]);
+  }
+  if (!isAllStrings) {
+    const numCoerceSchema = z.string().transform((v) => {
+      const n = Number(v);
+      return isNaN(n) ? v : n;
+    }).pipe(valueSchema);
+    return z.union([valueSchema, numCoerceSchema, emptySchema]);
+  }
+  return z.union([valueSchema, emptySchema]);
+}
+
+export {
+  oneOf
+};

package/dist/common/many-of.cjs

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

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

@@ -7,8 +7,10 @@ import { L as Locale } from '../config-CABSSvAp.cjs';
  * 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
  */
 
 /**
@@ -32,11 +34,11 @@ 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
@@ -44,31 +46,33 @@ type ManyOfMessages = {
  * @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, T extends string | number = string | number> = {
-    values: T[];
-    defaultValue?: IsRequired extends true ? T[] : T[] | null;
+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>>>;
 };
 /**
  * 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
  */
-type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodType<T[]> : ZodType<T[] | null>;
+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
@@ -106,6 +110,6 @@ type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? Zod
  * itemsSchema.parse([1, 1, 2]) // ✓ [1, 1, 2]
  * ```
  */
-declare function manyOf<IsRequired extends boolean = false, T extends string | number = string | number>(required?: IsRequired, options?: Omit<ManyOfOptions<IsRequired, T>, "required">): ManyOfSchema<IsRequired, T>;
+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

@@ -7,8 +7,10 @@ import { L as Locale } from '../config-CABSSvAp.js';
  * 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
  */
 
 /**
@@ -32,11 +34,11 @@ 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
@@ -44,31 +46,33 @@ type ManyOfMessages = {
  * @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, T extends string | number = string | number> = {
-    values: T[];
-    defaultValue?: IsRequired extends true ? T[] : T[] | null;
+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>>>;
 };
 /**
  * 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
  */
-type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodType<T[]> : ZodType<T[] | null>;
+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
@@ -106,6 +110,6 @@ type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? Zod
  * itemsSchema.parse([1, 1, 2]) // ✓ [1, 1, 2]
  * ```
  */
-declare function manyOf<IsRequired extends boolean = false, T extends string | number = string | number>(required?: IsRequired, options?: Omit<ManyOfOptions<IsRequired, T>, "required">): ManyOfSchema<IsRequired, T>;
+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

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

package/dist/common/one-of.cjs

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

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

@@ -7,8 +7,11 @@ import { L as Locale } from '../config-CABSSvAp.cjs';
  * 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 };