@hy_ong/zod-kit 0.2.2 → 0.2.3

package/dist/taiwan/postal-code.js

@@ -5,8 +5,8 @@ import {
   validate5DigitPostalCode,
   validate6DigitPostalCode,
   validateTaiwanPostalCode
-} from "../chunk-H2XTEM4M.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-D55YFP5R.js";
+import "../chunk-POIDES2L.js";
 export {
   VALID_3_DIGIT_PREFIXES,
   twPostalCode,

package/dist/taiwan/tel.cjs

@@ -1,9 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkVB2KV2ZMcjs = require('../chunk-VB2KV2ZM.cjs');
-require('../chunk-UCOXAZJF.cjs');
+var _chunkVKBNKPFOcjs = require('../chunk-VKBNKPFO.cjs');
+require('../chunk-Q7TUNJD4.cjs');
 
 
 
-exports.twTel = _chunkVB2KV2ZMcjs.twTel; exports.validateTaiwanTel = _chunkVB2KV2ZMcjs.validateTaiwanTel;
+exports.twTel = _chunkVKBNKPFOcjs.twTel; exports.validateTaiwanTel = _chunkVKBNKPFOcjs.validateTaiwanTel;

package/dist/taiwan/tel.js

@@ -1,8 +1,8 @@
 import {
   twTel,
   validateTaiwanTel
-} from "../chunk-UQZKFAFX.js";
-import "../chunk-6AAP4LPF.js";
+} from "../chunk-TRQMRHFM.js";
+import "../chunk-POIDES2L.js";
 export {
   twTel,
   validateTaiwanTel

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hy_ong/zod-kit",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "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",
@@ -91,11 +91,21 @@
       "import": "./dist/common/ip.js",
       "require": "./dist/common/ip.cjs"
     },
+    "./common/many-of": {
+      "types": "./dist/common/many-of.d.ts",
+      "import": "./dist/common/many-of.js",
+      "require": "./dist/common/many-of.cjs"
+    },
     "./common/number": {
       "types": "./dist/common/number.d.ts",
       "import": "./dist/common/number.js",
       "require": "./dist/common/number.cjs"
     },
+    "./common/one-of": {
+      "types": "./dist/common/one-of.d.ts",
+      "import": "./dist/common/one-of.js",
+      "require": "./dist/common/one-of.cjs"
+    },
     "./common/password": {
       "types": "./dist/common/password.d.ts",
       "import": "./dist/common/password.js",

package/src/i18n/locales/en-GB.json

@@ -17,6 +17,13 @@
       "businessOnly": "Only business email addresses are allowed",
       "noDisposable": "Disposable email addresses are not allowed"
     },
+    "manyOf": {
+      "required": "Required",
+      "invalid": "Must be from: ${values}",
+      "minSelect": "Must select at least ${min} item(s)",
+      "maxSelect": "Must select at most ${max} item(s)",
+      "duplicate": "Duplicate values are not allowed"
+    },
     "url": {
       "required": "Required",
       "invalid": "Invalid URL format",
@@ -68,6 +75,10 @@
       "finite": "Must be a finite number",
       "precision": "Must have at most ${precision} decimal places"
     },
+    "oneOf": {
+      "required": "Required",
+      "invalid": "Must be one of: ${values}"
+    },
     "id": {
       "required": "Required",
       "invalid": "Invalid ID format",

package/src/i18n/locales/en-US.json

@@ -17,6 +17,13 @@
       "businessOnly": "Only business email addresses are allowed",
       "noDisposable": "Disposable email addresses are not allowed"
     },
+    "manyOf": {
+      "required": "Required",
+      "invalid": "Must be from: ${values}",
+      "minSelect": "Must select at least ${min} item(s)",
+      "maxSelect": "Must select at most ${max} item(s)",
+      "duplicate": "Duplicate values are not allowed"
+    },
     "url": {
       "required": "Required",
       "invalid": "Invalid URL format",
@@ -68,6 +75,10 @@
       "finite": "Must be a finite number",
       "precision": "Must have at most ${precision} decimal places"
     },
+    "oneOf": {
+      "required": "Required",
+      "invalid": "Must be one of: ${values}"
+    },
     "id": {
       "required": "Required",
       "invalid": "Invalid ID format",

package/src/i18n/locales/id-ID.json

@@ -17,6 +17,13 @@
       "businessOnly": "Hanya alamat email bisnis yang diizinkan",
       "noDisposable": "Alamat email sekali pakai tidak diizinkan"
     },
+    "manyOf": {
+      "required": "Wajib diisi",
+      "invalid": "Harus dari: ${values}",
+      "minSelect": "Harus memilih minimal ${min} item",
+      "maxSelect": "Harus memilih maksimal ${max} item",
+      "duplicate": "Nilai duplikat tidak diperbolehkan"
+    },
     "url": {
       "required": "Wajib diisi",
       "invalid": "Format URL tidak valid",
@@ -68,6 +75,10 @@
       "finite": "Harus berupa angka terhingga",
       "precision": "Harus memiliki maksimal ${precision} tempat desimal"
     },
+    "oneOf": {
+      "required": "Wajib diisi",
+      "invalid": "Harus salah satu dari: ${values}"
+    },
     "id": {
       "required": "Wajib diisi",
       "invalid": "Format ID tidak valid",

package/src/i18n/locales/ja-JP.json

@@ -17,6 +17,13 @@
       "businessOnly": "ビジネスメールアドレスのみ使用可能です",
       "noDisposable": "使い捨てメールアドレスは使用できません"
     },
+    "manyOf": {
+      "required": "必須項目です",
+      "invalid": "次のいずれかである必要があります：${values}",
+      "minSelect": "${min}個以上選択してください",
+      "maxSelect": "${max}個以下で選択してください",
+      "duplicate": "重複した値は許可されていません"
+    },
     "url": {
       "required": "必須項目です",
       "invalid": "無効なURL形式です",
@@ -68,6 +75,10 @@
       "finite": "有限の数である必要があります",
       "precision": "小数点以下は ${precision} 桁以内である必要があります"
     },
+    "oneOf": {
+      "required": "必須項目です",
+      "invalid": "次のいずれかである必要があります：${values}"
+    },
     "id": {
       "required": "必須項目です",
       "invalid": "無効なID形式です",

package/src/i18n/locales/ko-KR.json

@@ -17,6 +17,13 @@
       "businessOnly": "비즈니스 이메일 주소만 허용됩니다",
       "noDisposable": "일회용 이메일 주소는 허용되지 않습니다"
     },
+    "manyOf": {
+      "required": "필수 항목입니다",
+      "invalid": "다음 중 하나여야 합니다: ${values}",
+      "minSelect": "최소 ${min}개를 선택해야 합니다",
+      "maxSelect": "최대 ${max}개까지 선택할 수 있습니다",
+      "duplicate": "중복된 값은 허용되지 않습니다"
+    },
     "url": {
       "required": "필수 항목입니다",
       "invalid": "유효하지 않은 URL 형식입니다",
@@ -68,6 +75,10 @@
       "finite": "유한한 수여야 합니다",
       "precision": "소수점 이하 ${precision}자리 이내여야 합니다"
     },
+    "oneOf": {
+      "required": "필수 항목입니다",
+      "invalid": "다음 중 하나여야 합니다: ${values}"
+    },
     "id": {
       "required": "필수 항목입니다",
       "invalid": "유효하지 않은 ID 형식입니다",

package/src/i18n/locales/ms-MY.json

@@ -17,6 +17,13 @@
       "businessOnly": "Hanya alamat e-mel perniagaan dibenarkan",
       "noDisposable": "Alamat e-mel pakai buang tidak dibenarkan"
     },
+    "manyOf": {
+      "required": "Diperlukan",
+      "invalid": "Mesti daripada: ${values}",
+      "minSelect": "Mesti pilih sekurang-kurangnya ${min} item",
+      "maxSelect": "Mesti pilih paling banyak ${max} item",
+      "duplicate": "Nilai pendua tidak dibenarkan"
+    },
     "url": {
       "required": "Wajib diisi",
       "invalid": "Format URL tidak sah",
@@ -68,6 +75,10 @@
       "finite": "Mesti nombor terhingga",
       "precision": "Mesti tidak melebihi ${precision} tempat perpuluhan"
     },
+    "oneOf": {
+      "required": "Diperlukan",
+      "invalid": "Mesti salah satu daripada: ${values}"
+    },
     "id": {
       "required": "Wajib diisi",
       "invalid": "Format ID tidak sah",

package/src/i18n/locales/th-TH.json

@@ -17,6 +17,13 @@
       "businessOnly": "อนุญาตเฉพาะอีเมลธุรกิจเท่านั้น",
       "noDisposable": "ไม่อนุญาตอีเมลแบบใช้แล้วทิ้ง"
     },
+    "manyOf": {
+      "required": "จำเป็น",
+      "invalid": "ต้องเป็นหนึ่งใน: ${values}",
+      "minSelect": "ต้องเลือกอย่างน้อย ${min} รายการ",
+      "maxSelect": "เลือกได้มากสุด ${max} รายการ",
+      "duplicate": "ไม่อนุญาตให้มีค่าซ้ำ"
+    },
     "url": {
       "required": "จำเป็นต้องกรอก",
       "invalid": "รูปแบบ URL ไม่ถูกต้อง",
@@ -68,6 +75,10 @@
       "finite": "ต้องเป็นจำนวนจำกัด",
       "precision": "ต้องมีทศนิยมไม่เกิน ${precision} ตำแหน่ง"
     },
+    "oneOf": {
+      "required": "จำเป็น",
+      "invalid": "ต้องเป็นหนึ่งใน: ${values}"
+    },
     "id": {
       "required": "จำเป็นต้องกรอก",
       "invalid": "รูปแบบ ID ไม่ถูกต้อง",

package/src/i18n/locales/vi-VN.json

@@ -17,6 +17,13 @@
       "businessOnly": "Chỉ cho phép địa chỉ email doanh nghiệp",
       "noDisposable": "Không cho phép địa chỉ email dùng một lần"
     },
+    "manyOf": {
+      "required": "Bắt buộc",
+      "invalid": "Phải thuộc: ${values}",
+      "minSelect": "Phải chọn ít nhất ${min} mục",
+      "maxSelect": "Chỉ được chọn tối đa ${max} mục",
+      "duplicate": "Không được phép có giá trị trùng lặp"
+    },
     "url": {
       "required": "Bắt buộc",
       "invalid": "Định dạng URL không hợp lệ",
@@ -68,6 +75,10 @@
       "finite": "Phải là số hữu hạn",
       "precision": "Phải có tối đa ${precision} chữ số thập phân"
     },
+    "oneOf": {
+      "required": "Bắt buộc",
+      "invalid": "Phải là một trong: ${values}"
+    },
     "id": {
       "required": "Bắt buộc",
       "invalid": "Định dạng ID không hợp lệ",

package/src/i18n/locales/zh-CN.json

@@ -17,6 +17,13 @@
       "businessOnly": "仅允许企业邮箱地址",
       "noDisposable": "不允许使用临时邮箱地址"
     },
+    "manyOf": {
+      "required": "必填",
+      "invalid": "必须为以下值之一：${values}",
+      "minSelect": "至少需选择 ${min} 项",
+      "maxSelect": "最多只能选择 ${max} 项",
+      "duplicate": "不允许重复的值"
+    },
     "url": {
       "required": "必填",
       "invalid": "无效的 URL 格式",
@@ -68,6 +75,10 @@
       "finite": "必须为有限数字",
       "precision": "小数位数不可超过 ${precision} 位"
     },
+    "oneOf": {
+      "required": "必填",
+      "invalid": "必须为以下其中一个值：${values}"
+    },
     "id": {
       "required": "必填",
       "invalid": "无效的 ID 格式",

package/src/i18n/locales/zh-TW.json

@@ -17,6 +17,13 @@
       "businessOnly": "僅允許企業郵箱地址",
       "noDisposable": "不允許使用臨時郵箱地址"
     },
+    "manyOf": {
+      "required": "必填",
+      "invalid": "必須為以下值之一：${values}",
+      "minSelect": "至少需選擇 ${min} 項",
+      "maxSelect": "最多只能選擇 ${max} 項",
+      "duplicate": "不允許重複的值"
+    },
     "url": {
       "required": "必填",
       "invalid": "無效的 URL 格式",
@@ -68,6 +75,10 @@
       "finite": "必須為有限數字",
       "precision": "小數位數不可超過 ${precision} 位"
     },
+    "oneOf": {
+      "required": "必填",
+      "invalid": "必須為以下其中一個值：${values}"
+    },
     "id": {
       "required": "必填",
       "invalid": "無效的 ID 格式",

package/src/index.ts

@@ -7,8 +7,10 @@ export * from "./validators/common/datetime"
 export * from "./validators/common/email"
 export * from "./validators/common/file"
 export * from "./validators/common/id"
+export * from "./validators/common/many-of"
 export * from "./validators/common/ip"
 export * from "./validators/common/number"
+export * from "./validators/common/one-of"
 export * from "./validators/common/password"
 export * from "./validators/common/text"
 export * from "./validators/common/time"

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

@@ -0,0 +1,219 @@
+/**
+ * @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
+ */
+
+import { z, ZodType } from "zod"
+import { t } from "../../i18n"
+import { getLocale, type Locale } from "../../config"
+
+/**
+ * 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
+ */
+export 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
+ */
+export type ManyOfOptions<IsRequired extends boolean = true, T extends string | number = string | number> = {
+  values: T[]
+  defaultValue?: IsRequired extends true ? T[] : T[] | null
+  min?: number
+  max?: number
+  allowDuplicates?: boolean
+  caseSensitive?: boolean
+  transform?: (value: T[]) => T[]
+  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
+ */
+export type ManyOfSchema<IsRequired extends boolean, T> = IsRequired extends true ? ZodType<T[]> : ZodType<T[] | 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]
+ * ```
+ */
+export function manyOf<IsRequired extends boolean = false, T extends string | number = 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 ?? {}
+
+  const isRequired = required ?? (false as IsRequired)
+
+  const getMessage = (key: keyof ManyOfMessages, params?: Record<string, any>) => {
+    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.manyOf.${key}`, params)
+  }
+
+  const normalizeItem = (item: unknown): unknown => {
+    // Coerce number strings to numbers when values contains numbers
+    const hasNumbers = values.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
+    }
+
+    // Case-insensitive normalization
+    if (!caseSensitive && typeof item === "string") {
+      const match = values.find((v) => typeof v === "string" && v.toLowerCase() === item.toLowerCase())
+      if (match !== undefined) return match
+      return item
+    }
+
+    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") })
+      }
+      return
+    }
+
+    if (!Array.isArray(val)) {
+      ctx.addIssue({ code: "custom", message: getMessage("invalid", { values: values.join(", ") }) })
+      return
+    }
+
+    // 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(", ") }),
+        })
+        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)
+      }
+    }
+
+    // Min/max selection count
+    if (min !== undefined && val.length < min) {
+      ctx.addIssue({ code: "custom", message: getMessage("minSelect", { min }) })
+      return
+    }
+
+    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[])
+  })
+
+  return schema as unknown as ManyOfSchema<IsRequired, T>
+}