@hy_ong/zod-kit 0.1.15 → 0.2.0

package/src/validators/common/email.ts

@@ -71,7 +71,7 @@ export type EmailOptions<IsRequired extends boolean = true> = {
   lowercase?: boolean
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, EmailMessages>
+  i18n?: Partial<Record<Locale, Partial<EmailMessages>>>
 }
 
 /**

package/src/validators/common/file.ts

@@ -92,7 +92,7 @@ export type FileOptions<IsRequired extends boolean = true> = {
   caseSensitive?: boolean
   transform?: (value: File) => File
   defaultValue?: IsRequired extends true ? File : File | null
-  i18n?: Record<Locale, FileMessages>
+  i18n?: Partial<Record<Locale, Partial<FileMessages>>>
 }
 
 /**

package/src/validators/common/id.ts

@@ -116,7 +116,7 @@ export type IdOptions<Type extends IdType | undefined = undefined> = {
   caseSensitive?: boolean
   transform?: (value: string) => string
   defaultValue?: any // Simplified to avoid complex conditional types
-  i18n?: Record<Locale, IdMessages>
+  i18n?: Partial<Record<Locale, Partial<IdMessages>>>
 }
 
 /**

package/src/validators/common/number.ts

@@ -82,7 +82,7 @@ export type NumberOptions<IsRequired extends boolean = true> = {
   finite?: boolean
   transform?: (value: number) => number
   parseCommas?: boolean // Parse "1,234" as 1234
-  i18n?: Record<Locale, NumberMessages>
+  i18n?: Partial<Record<Locale, Partial<NumberMessages>>>
 }
 
 /**

package/src/validators/common/password.ts

@@ -100,7 +100,7 @@ export type PasswordOptions<IsRequired extends boolean = true> = {
   regex?: RegExp
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, PasswordMessages>
+  i18n?: Partial<Record<Locale, Partial<PasswordMessages>>>
 }
 
 /**

package/src/validators/common/text.ts

@@ -72,7 +72,7 @@ export type TextOptions<IsRequired extends boolean = true> = {
   transform?: (value: string) => string
   notEmpty?: boolean
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TextMessages>
+  i18n?: Partial<Record<Locale, Partial<TextMessages>>>
 }
 
 /**

package/src/validators/common/time.ts

@@ -109,7 +109,7 @@ export type TimeOptions<IsRequired extends boolean = true> = {
   whitelistOnly?: boolean // If true, only allow values in whitelist (default: false)
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TimeMessages>
+  i18n?: Partial<Record<Locale, Partial<TimeMessages>>>
 }
 
 /**

package/src/validators/common/url.ts

@@ -104,7 +104,7 @@ export type UrlOptions<IsRequired extends boolean = true> = {
   blockLocalhost?: boolean
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, UrlMessages>
+  i18n?: Partial<Record<Locale, Partial<UrlMessages>>>
 }
 
 /**

package/src/validators/taiwan/business-id.ts

@@ -38,7 +38,7 @@ export type TwBusinessIdMessages = {
 export type TwBusinessIdOptions<IsRequired extends boolean = true> = {
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TwBusinessIdMessages>
+  i18n?: Partial<Record<Locale, Partial<TwBusinessIdMessages>>>
 }
 
 /**

package/src/validators/taiwan/fax.ts

@@ -42,7 +42,7 @@ export type TwFaxOptions<IsRequired extends boolean = true> = {
   whitelist?: string[]
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TwFaxMessages>
+  i18n?: Partial<Record<Locale, Partial<TwFaxMessages>>>
 }
 
 /**

package/src/validators/taiwan/mobile.ts

@@ -42,7 +42,7 @@ export type TwMobileOptions<IsRequired extends boolean = true> = {
   whitelist?: string[]
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TwMobileMessages>
+  i18n?: Partial<Record<Locale, Partial<TwMobileMessages>>>
 }
 
 /**

package/src/validators/taiwan/national-id.ts

@@ -57,7 +57,7 @@ export type TwNationalIdOptions<IsRequired extends boolean = true> = {
   allowOldResident?: boolean
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TwNationalIdMessages>
+  i18n?: Partial<Record<Locale, Partial<TwNationalIdMessages>>>
 }
 
 /**

package/src/validators/taiwan/postal-code.ts

@@ -88,7 +88,7 @@ export type TwPostalCodeOptions<IsRequired extends boolean = true> = {
   blockedPrefixes?: string[]
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TwPostalCodeMessages>
+  i18n?: Partial<Record<Locale, Partial<TwPostalCodeMessages>>>
   strictSuffixValidation?: boolean
   deprecate5Digit?: boolean
 }

package/src/validators/taiwan/tel.ts

@@ -42,7 +42,7 @@ export type TwTelOptions<IsRequired extends boolean = true> = {
   whitelist?: string[]
   transform?: (value: string) => string
   defaultValue?: IsRequired extends true ? string : string | null
-  i18n?: Record<Locale, TwTelMessages>
+  i18n?: Partial<Record<Locale, Partial<TwTelMessages>>>
 }
 
 /**

package/tests/common/boolean.test.ts

@@ -272,13 +272,13 @@ describe("boolean", () => {
   })
 
   describe("custom i18n messages", () => {
-    beforeEach(() => setLocale("en"))
+    beforeEach(() => setLocale("en-US"))
 
     it("should use custom messages when provided", () => {
       const schema = boolean(true, {
         shouldBe: true,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
             shouldBeTrue: "Custom should be true message",
           },
@@ -297,7 +297,7 @@ describe("boolean", () => {
       const schema = boolean(true, {
         shouldBe: false,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
           },
           "zh-TW": {
@@ -311,10 +311,10 @@ describe("boolean", () => {
     })
 
     it("should use correct locale for custom messages", () => {
-      setLocale("en")
+      setLocale("en-US")
       const schemaEn = boolean(true, {
         i18n: {
-          en: {
+          "en-US": {
             required: "English required",
           },
           "zh-TW": {
@@ -327,7 +327,7 @@ describe("boolean", () => {
       setLocale("zh-TW")
       const schemaZh = boolean(true, {
         i18n: {
-          en: {
+          "en-US": {
             required: "English required",
           },
           "zh-TW": {

package/tests/common/date.test.ts

@@ -159,7 +159,7 @@ describe("date", () => {
 
   describe("localization", () => {
     it("should use English error messages", () => {
-      setLocale("en")
+      setLocale("en-US")
       const schema = date(true)
 
       try {
@@ -366,12 +366,12 @@ describe("date", () => {
     it("should use custom English messages", () => {
       const schema = date(true, {
         i18n: {
-          en: { format: "Custom date format error: ${format}" },
+          "en-US": { format: "Custom date format error: ${format}" },
           "zh-TW": { format: "自定義日期格式錯誤: ${format}" },
         },
       })
 
-      setLocale("en")
+      setLocale("en-US")
       try {
         schema.parse("invalid")
       } catch (error: any) {
@@ -382,7 +382,7 @@ describe("date", () => {
     it("should use custom Chinese messages", () => {
       const schema = date(true, {
         i18n: {
-          en: { format: "Custom date format error: ${format}" },
+          "en-US": { format: "Custom date format error: ${format}" },
           "zh-TW": { format: "自定義日期格式錯誤: ${format}" },
         },
       })
@@ -398,12 +398,12 @@ describe("date", () => {
     it("should fallback to default messages when custom not provided", () => {
       const schema = date(true, {
         i18n: {
-          en: { format: "Custom format error" },
+          "en-US": { format: "Custom format error" },
           "zh-TW": { format: "自定義格式錯誤" },
         },
       })
 
-      setLocale("en")
+      setLocale("en-US")
       try {
         schema.parse("")
       } catch (error: any) {
@@ -415,7 +415,7 @@ describe("date", () => {
       const schema = date(true, {
         mustBePast: true,
         i18n: {
-          en: { past: "Date must be in the past!" },
+          "en-US": { past: "Date must be in the past!" },
           "zh-TW": { past: "日期必須在過去！" },
         },
       })
@@ -424,7 +424,7 @@ describe("date", () => {
       tomorrow.setDate(tomorrow.getDate() + 1)
       const tomorrowStr = tomorrow.toISOString().split("T")[0]
 
-      setLocale("en")
+      setLocale("en-US")
       try {
         schema.parse(tomorrowStr)
       } catch (error: any) {

package/tests/common/datetime.test.ts

@@ -3,7 +3,7 @@ import { datetime, setLocale, validateDateTimeFormat, parseDateTimeValue, normal
 import dayjs from "dayjs"
 
 describe("Taiwan datetime(true) validator", () => {
-  beforeEach(() => setLocale("en"))
+  beforeEach(() => setLocale("en-US"))
 
   describe("basic functionality", () => {
     it("should validate correct datetime formats", () => {
@@ -503,7 +503,7 @@ describe("Taiwan datetime(true) validator", () => {
 
   describe("i18n support", () => {
     it("should use English messages by default", () => {
-      setLocale("en")
+      setLocale("en-US")
       expect(() => datetime(true).parse("")).toThrow("Required")
       expect(() => datetime(true).parse("invalid")).toThrow("Must be in YYYY-MM-DD HH:mm format")
     })
@@ -517,7 +517,7 @@ describe("Taiwan datetime(true) validator", () => {
     })
 
     it("should support whitelist error messages", () => {
-      setLocale("en")
+      setLocale("en-US")
       const schema = datetime(true, {
         format: "YYYY-MM-DD HH:mm",
         whitelist: ["now"],
@@ -531,7 +531,7 @@ describe("Taiwan datetime(true) validator", () => {
       const schema = datetime(true, {
         format: "YYYY-MM-DD HH:mm",
         i18n: {
-          en: {
+          "en-US": {
             required: "DateTime is required",
             invalid: "Invalid datetime value",
           },
@@ -542,7 +542,7 @@ describe("Taiwan datetime(true) validator", () => {
         },
       })
 
-      setLocale("en")
+      setLocale("en-US")
       expect(() => schema.parse("")).toThrow("DateTime is required")
 
       setLocale("zh-TW")
@@ -555,7 +555,7 @@ describe("Taiwan datetime(true) validator", () => {
         whitelist: ["now"],
         whitelistOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             notInWhitelist: "This datetime is not allowed",
           },
           "zh-TW": {
@@ -564,7 +564,7 @@ describe("Taiwan datetime(true) validator", () => {
         },
       })
 
-      setLocale("en")
+      setLocale("en-US")
       expect(() => schema.parse("2024-03-15 14:30")).toThrow("This datetime is not allowed")
 
       setLocale("zh-TW")

package/tests/common/email.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeEach } from "vitest"
 import { email, setLocale } from "../../src"
 
 describe("email(true) features", () => {
-  beforeEach(() => setLocale("en"))
+  beforeEach(() => setLocale("en-US"))
 
   describe("multiple domain support", () => {
     it("should accept multiple allowed domains", () => {
@@ -135,7 +135,7 @@ describe("email(true) features", () => {
         domain: "company.com",
         businessOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
             domain: "Custom domain message: ${domain}",
             businessOnly: "Custom business only message",
@@ -157,7 +157,7 @@ describe("email(true) features", () => {
       const schema = email(true, {
         noDisposable: true,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
           },
           "zh-TW": {
@@ -171,11 +171,11 @@ describe("email(true) features", () => {
     })
 
     it("should use correct locale for custom messages", () => {
-      setLocale("en")
+      setLocale("en-US")
       const schemaEn = email(true, {
         businessOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             businessOnly: "English business message",
           },
           "zh-TW": {
@@ -189,7 +189,7 @@ describe("email(true) features", () => {
       const schemaZh = email(true, {
         businessOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             businessOnly: "English business message",
           },
           "zh-TW": {

package/tests/common/file.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeEach } from "vitest"
 import { file, setLocale } from "../../src"
 
 describe("file(true) features", () => {
-  beforeEach(() => setLocale("en"))
+  beforeEach(() => setLocale("en-US"))
 
   // Helper function to create mock files for testing
   const createMockFile = (name: string, size: number, type: string, content?: string): File => {
@@ -297,7 +297,7 @@ describe("file(true) features", () => {
         extension: [".pdf"],
         imageOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
             maxSize: "Custom size message: ${maxSize}",
             extension: "Custom extension message: ${extension}",
@@ -326,7 +326,7 @@ describe("file(true) features", () => {
       const schema = file(true, {
         videoOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
           },
           "zh-TW": {
@@ -342,11 +342,11 @@ describe("file(true) features", () => {
     })
 
     it("should use correct locale for custom messages", () => {
-      setLocale("en")
+      setLocale("en-US")
       const schemaEn = file(true, {
         imageOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             imageOnly: "English image message",
           },
           "zh-TW": {
@@ -361,7 +361,7 @@ describe("file(true) features", () => {
       const schemaZh = file(true, {
         imageOnly: true,
         i18n: {
-          en: {
+          "en-US": {
             imageOnly: "English image message",
           },
           "zh-TW": {

package/tests/common/id.test.ts

@@ -3,7 +3,7 @@ import { Locale, setLocale, id, detectIdType, validateIdType, ID_PATTERNS } from
 
 const locales = [
   {
-    locale: "en",
+    locale: "en-US",
     messages: {
       required: "Required",
       invalid: "Invalid ID format",
@@ -388,7 +388,7 @@ describe.each(locales)("id(true) locale: $locale", ({ locale, messages }) => {
   describe("custom i18n messages", () => {
     it("should use custom i18n messages when provided", () => {
       const customMessages = {
-        en: {
+        "en-US": {
           required: "Custom required message",
           invalid: "Custom invalid message",
           numeric: "Custom numeric message",
@@ -405,7 +405,7 @@ describe.each(locales)("id(true) locale: $locale", ({ locale, messages }) => {
         i18n: customMessages,
       })
 
-      if (locale === "en") {
+      if (locale === "en-US") {
         expect(() => schema.parse("")).toThrow("Custom required message")
         expect(() => schema.parse("abc")).toThrow("Custom numeric message")
       } else {
@@ -416,7 +416,7 @@ describe.each(locales)("id(true) locale: $locale", ({ locale, messages }) => {
 
     it("should fallback to default i18n when custom message not provided", () => {
       const customMessages = {
-        en: { required: "Custom required message" },
+        "en-US": { required: "Custom required message" },
         "zh-TW": { required: "自訂必填訊息" },
       }
 
@@ -425,7 +425,7 @@ describe.each(locales)("id(true) locale: $locale", ({ locale, messages }) => {
         i18n: customMessages,
       })
 
-      if (locale === "en") {
+      if (locale === "en-US") {
         expect(() => schema.parse("")).toThrow("Custom required message")
         expect(() => schema.parse("abc")).toThrow(messages.numeric)
       } else {

package/tests/common/number.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeEach } from "vitest"
 import { number, setLocale } from "../../src"
 
 describe("number(true) features", () => {
-  beforeEach(() => setLocale("en"))
+  beforeEach(() => setLocale("en-US"))
 
   describe("type validation", () => {
     it("should accept integers when type='integer'", () => {
@@ -133,7 +133,7 @@ describe("number(true) features", () => {
         type: "integer",
         min: 0,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
             integer: "Custom integer message",
             min: "Custom min: at least ${min}",
@@ -156,7 +156,7 @@ describe("number(true) features", () => {
         type: "integer",
         max: 10,
         i18n: {
-          en: {
+          "en-US": {
             required: "Custom required message",
           },
           "zh-TW": {
@@ -171,11 +171,11 @@ describe("number(true) features", () => {
     })
 
     it("should use correct locale for custom messages", () => {
-      setLocale("en")
+      setLocale("en-US")
       const schemaEn = number(true, {
         type: "integer",
         i18n: {
-          en: {
+          "en-US": {
             integer: "English integer message",
           },
           "zh-TW": {
@@ -189,7 +189,7 @@ describe("number(true) features", () => {
       const schemaZh = number(true, {
         type: "integer",
         i18n: {
-          en: {
+          "en-US": {
             integer: "English integer message",
           },
           "zh-TW": {

package/tests/common/password.test.ts

@@ -3,7 +3,7 @@ import { Locale, setLocale, password } from "../../src"
 
 const locales = [
   {
-    locale: "en",
+    locale: "en-US",
     messages: {
       required: "Required",
       min: "Must be at least 8 characters",
@@ -193,7 +193,7 @@ describe.each(locales)("password(true) locale: $locale", ({ locale, messages })
   describe("custom i18n messages", () => {
     it("should use custom i18n messages when provided", () => {
       const customMessages = {
-        en: {
+        "en-US": {
           required: "Custom required message",
           min: "Custom min ${min} message",
           uppercase: "Custom uppercase message",
@@ -211,7 +211,7 @@ describe.each(locales)("password(true) locale: $locale", ({ locale, messages })
         i18n: customMessages,
       })
 
-      if (locale === "en") {
+      if (locale === "en-US") {
         expect(() => schema.parse("")).toThrow("Custom required message")
         expect(() => schema.parse("short")).toThrow("Custom min 8 message")
         expect(() => schema.parse("nouppercase")).toThrow("Custom uppercase message")
@@ -224,7 +224,7 @@ describe.each(locales)("password(true) locale: $locale", ({ locale, messages })
 
     it("should fallback to default i18n when custom message not provided", () => {
       const customMessages = {
-        en: { required: "Custom required message" },
+        "en-US": { required: "Custom required message" },
         "zh-TW": { required: "自訂必填訊息" },
       }
 
@@ -233,7 +233,7 @@ describe.each(locales)("password(true) locale: $locale", ({ locale, messages })
         i18n: customMessages,
       })
 
-      if (locale === "en") {
+      if (locale === "en-US") {
         expect(() => schema.parse("")).toThrow("Custom required message")
         expect(() => schema.parse("nouppercase")).toThrow(messages.uppercase)
       } else {

package/tests/common/text.test.ts

@@ -3,7 +3,7 @@ import { Locale, setLocale, text } from "../../src"
 
 const locales = [
   {
-    locale: "en",
+    locale: "en-US",
     messages: {
       required: "Required",
       notEmpty: "Cannot be empty or whitespace only",
@@ -193,13 +193,13 @@ describe("text(true) defaultValue functionality", () => {
 })
 
 describe("text(true) custom i18n messages", () => {
-  beforeEach(() => setLocale("en"))
+  beforeEach(() => setLocale("en-US"))
 
   it("should use custom messages when provided", () => {
     const schema = text(true, {
       minLength: 5,
       i18n: {
-        en: {
+        "en-US": {
           required: "Custom required message",
           minLength: "Custom min message: at least ${minLength} chars",
         },
@@ -218,7 +218,7 @@ describe("text(true) custom i18n messages", () => {
     const schema = text(true, {
       maxLength: 3,
       i18n: {
-        en: {
+        "en-US": {
           required: "Custom required message",
         },
         "zh-TW": {
@@ -234,7 +234,7 @@ describe("text(true) custom i18n messages", () => {
   it("should use correct locale for custom messages", () => {
     const schema = text(true, {
       i18n: {
-        en: {
+        "en-US": {
           required: "English required",
         },
         "zh-TW": {
@@ -243,7 +243,7 @@ describe("text(true) custom i18n messages", () => {
       },
     })
 
-    setLocale("en")
+    setLocale("en-US")
     expect(() => schema.parse("")).toThrow("English required")
 
     setLocale("zh-TW")
@@ -252,7 +252,7 @@ describe("text(true) custom i18n messages", () => {
 })
 
 describe("text(true) complex scenarios", () => {
-  beforeEach(() => setLocale("en")) // Ensure a consistent locale for this test
+  beforeEach(() => setLocale("en-US")) // Ensure a consistent locale for this test
 
   it("should work with multiple validations", () => {
     const schema = text(true, {