@hy_ong/zod-kit 0.2.0 → 0.2.2

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

@@ -75,6 +75,14 @@
       "maxLength": "ต้องไม่เกิน ${maxLength} ตัวอักษร",
       "numeric": "ต้องเป็น ID ตัวเลข",
       "uuid": "ต้องเป็น UUID ที่ถูกต้อง",
+      "uuidv1": "ต้องเป็น UUID v1 ที่ถูกต้อง",
+      "uuidv2": "ต้องเป็น UUID v2 ที่ถูกต้อง",
+      "uuidv3": "ต้องเป็น UUID v3 ที่ถูกต้อง",
+      "uuidv4": "ต้องเป็น UUID v4 ที่ถูกต้อง",
+      "uuidv5": "ต้องเป็น UUID v5 ที่ถูกต้อง",
+      "uuidv6": "ต้องเป็น UUID v6 ที่ถูกต้อง",
+      "uuidv7": "ต้องเป็น UUID v7 ที่ถูกต้อง",
+      "uuidv8": "ต้องเป็น UUID v8 ที่ถูกต้อง",
       "objectId": "ต้องเป็น MongoDB ObjectId ที่ถูกต้อง",
       "nanoid": "ต้องเป็น Nano ID ที่ถูกต้อง",
       "snowflake": "ต้องเป็น Snowflake ID ที่ถูกต้อง",
@@ -162,6 +170,31 @@
       "videoOnly": "อนุญาตเฉพาะไฟล์วิดีโอ",
       "audioOnly": "อนุญาตเฉพาะไฟล์เสียง",
       "archiveOnly": "อนุญาตเฉพาะไฟล์บีบอัด"
+    },
+    "creditCard": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "หมายเลขบัตรเครดิตไม่ถูกต้อง",
+      "notInWhitelist": "หมายเลขบัตรเครดิตไม่อยู่ในรายการที่อนุญาต"
+    },
+    "ip": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "ที่อยู่ IP ไม่ถูกต้อง",
+      "notIPv4": "ต้องเป็นที่อยู่ IPv4 ที่ถูกต้อง",
+      "notIPv6": "ต้องเป็นที่อยู่ IPv6 ที่ถูกต้อง",
+      "notInWhitelist": "ที่อยู่ IP ไม่อยู่ในรายการที่อนุญาต"
+    },
+    "color": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "รูปแบบสีไม่ถูกต้อง",
+      "notHex": "ต้องเป็นสี hex ที่ถูกต้อง",
+      "notRgb": "ต้องเป็นสี RGB ที่ถูกต้อง",
+      "notHsl": "ต้องเป็นสี HSL ที่ถูกต้อง"
+    },
+    "coordinate": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "พิกัดไม่ถูกต้อง",
+      "invalidLatitude": "ละติจูดต้องอยู่ระหว่าง -90 ถึง 90",
+      "invalidLongitude": "ลองจิจูดต้องอยู่ระหว่าง -180 ถึง 180"
     }
   },
   "taiwan": {
@@ -199,6 +232,24 @@
       "format6Only": "อนุญาตเฉพาะรหัสไปรษณีย์ 6 หลัก",
       "invalidSuffix": "ส่วนท้ายรหัสไปรษณีย์ไม่ถูกต้อง - 5 หลักต้องเป็น 01-99 หรือ 6 หลักต้องเป็น 001-999",
       "deprecated5Digit": "รหัสไปรษณีย์ 5 หลักถูกยกเลิกและไม่รองรับอีกต่อไป"
+    },
+    "invoice": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "หมายเลขใบกำกับภาษีไต้หวันไม่ถูกต้อง"
+    },
+    "licensePlate": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "หมายเลขทะเบียนรถไต้หวันไม่ถูกต้อง"
+    },
+    "bankAccount": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "บัญชีธนาคารไต้หวันไม่ถูกต้อง",
+      "invalidBankCode": "รหัสธนาคารไม่ถูกต้อง",
+      "invalidAccountNumber": "หมายเลขบัญชีไม่ถูกต้อง"
+    },
+    "passport": {
+      "required": "จำเป็นต้องกรอก",
+      "invalid": "หมายเลขหนังสือเดินทางไต้หวันไม่ถูกต้อง"
     }
   }
 }

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

@@ -75,6 +75,14 @@
       "maxLength": "Phải có tối đa ${maxLength} ký tự",
       "numeric": "Phải là ID dạng số",
       "uuid": "Phải là UUID hợp lệ",
+      "uuidv1": "Phải là UUID v1 hợp lệ",
+      "uuidv2": "Phải là UUID v2 hợp lệ",
+      "uuidv3": "Phải là UUID v3 hợp lệ",
+      "uuidv4": "Phải là UUID v4 hợp lệ",
+      "uuidv5": "Phải là UUID v5 hợp lệ",
+      "uuidv6": "Phải là UUID v6 hợp lệ",
+      "uuidv7": "Phải là UUID v7 hợp lệ",
+      "uuidv8": "Phải là UUID v8 hợp lệ",
       "objectId": "Phải là MongoDB ObjectId hợp lệ",
       "nanoid": "Phải là Nano ID hợp lệ",
       "snowflake": "Phải là Snowflake ID hợp lệ",
@@ -162,6 +170,31 @@
       "videoOnly": "Chỉ cho phép tệp video",
       "audioOnly": "Chỉ cho phép tệp âm thanh",
       "archiveOnly": "Chỉ cho phép tệp nén"
+    },
+    "creditCard": {
+      "required": "Bắt buộc",
+      "invalid": "Số thẻ tín dụng không hợp lệ",
+      "notInWhitelist": "Số thẻ tín dụng không nằm trong danh sách cho phép"
+    },
+    "ip": {
+      "required": "Bắt buộc",
+      "invalid": "Địa chỉ IP không hợp lệ",
+      "notIPv4": "Phải là địa chỉ IPv4 hợp lệ",
+      "notIPv6": "Phải là địa chỉ IPv6 hợp lệ",
+      "notInWhitelist": "Địa chỉ IP không nằm trong danh sách cho phép"
+    },
+    "color": {
+      "required": "Bắt buộc",
+      "invalid": "Định dạng màu không hợp lệ",
+      "notHex": "Phải là màu hex hợp lệ",
+      "notRgb": "Phải là màu RGB hợp lệ",
+      "notHsl": "Phải là màu HSL hợp lệ"
+    },
+    "coordinate": {
+      "required": "Bắt buộc",
+      "invalid": "Tọa độ không hợp lệ",
+      "invalidLatitude": "Vĩ độ phải từ -90 đến 90",
+      "invalidLongitude": "Kinh độ phải từ -180 đến 180"
     }
   },
   "taiwan": {
@@ -199,6 +232,24 @@
       "format6Only": "Chỉ cho phép mã bưu chính 6 chữ số",
       "invalidSuffix": "Hậu tố mã bưu chính không hợp lệ - 5 chữ số phải là 01-99 hoặc 6 chữ số phải là 001-999",
       "deprecated5Digit": "Mã bưu chính 5 chữ số đã ngừng sử dụng và không còn được hỗ trợ"
+    },
+    "invoice": {
+      "required": "Bắt buộc",
+      "invalid": "Số hóa đơn thống nhất Đài Loan không hợp lệ"
+    },
+    "licensePlate": {
+      "required": "Bắt buộc",
+      "invalid": "Số biển số xe Đài Loan không hợp lệ"
+    },
+    "bankAccount": {
+      "required": "Bắt buộc",
+      "invalid": "Tài khoản ngân hàng Đài Loan không hợp lệ",
+      "invalidBankCode": "Mã ngân hàng không hợp lệ",
+      "invalidAccountNumber": "Số tài khoản không hợp lệ"
+    },
+    "passport": {
+      "required": "Bắt buộc",
+      "invalid": "Số hộ chiếu Đài Loan không hợp lệ"
     }
   }
 }

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

@@ -75,6 +75,14 @@
       "maxLength": "长度最多 ${maxLength} 个字符",
       "numeric": "必须为数字 ID",
       "uuid": "必须为有效的 UUID",
+      "uuidv1": "必须为有效的 UUID v1",
+      "uuidv2": "必须为有效的 UUID v2",
+      "uuidv3": "必须为有效的 UUID v3",
+      "uuidv4": "必须为有效的 UUID v4",
+      "uuidv5": "必须为有效的 UUID v5",
+      "uuidv6": "必须为有效的 UUID v6",
+      "uuidv7": "必须为有效的 UUID v7",
+      "uuidv8": "必须为有效的 UUID v8",
       "objectId": "必须为有效的 MongoDB ObjectId",
       "nanoid": "必须为有效的 Nano ID",
       "snowflake": "必须为有效的 Snowflake ID",
@@ -162,6 +170,31 @@
       "videoOnly": "仅允许视频文件",
       "audioOnly": "仅允许音频文件",
       "archiveOnly": "仅允许压缩文件"
+    },
+    "creditCard": {
+      "required": "必填",
+      "invalid": "无效的信用卡号码",
+      "notInWhitelist": "信用卡号码不在允许的列表中"
+    },
+    "ip": {
+      "required": "必填",
+      "invalid": "无效的 IP 地址",
+      "notIPv4": "必须为有效的 IPv4 地址",
+      "notIPv6": "必须为有效的 IPv6 地址",
+      "notInWhitelist": "IP 地址不在允许的列表中"
+    },
+    "color": {
+      "required": "必填",
+      "invalid": "无效的颜色格式",
+      "notHex": "必须为有效的十六进制颜色",
+      "notRgb": "必须为有效的 RGB 颜色",
+      "notHsl": "必须为有效的 HSL 颜色"
+    },
+    "coordinate": {
+      "required": "必填",
+      "invalid": "无效的坐标",
+      "invalidLatitude": "纬度必须介于 -90 与 90 之间",
+      "invalidLongitude": "经度必须介于 -180 与 180 之间"
     }
   },
   "taiwan": {
@@ -199,6 +232,24 @@
       "format6Only": "仅允许 6 位邮政编码",
       "invalidSuffix": "无效的邮政编码后缀 - 5 位格式须为 01-99，6 位格式须为 001-999",
       "deprecated5Digit": "5 位邮政编码已弃用且不再支持"
+    },
+    "invoice": {
+      "required": "必填",
+      "invalid": "无效的统一发票号码"
+    },
+    "licensePlate": {
+      "required": "必填",
+      "invalid": "无效的车牌号码"
+    },
+    "bankAccount": {
+      "required": "必填",
+      "invalid": "无效的银行账号",
+      "invalidBankCode": "无效的银行代码",
+      "invalidAccountNumber": "无效的账号号码"
+    },
+    "passport": {
+      "required": "必填",
+      "invalid": "无效的护照号码"
     }
   }
 }

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

@@ -75,6 +75,14 @@
       "maxLength": "長度最多 ${maxLength} 字元",
       "numeric": "必須為數字 ID",
       "uuid": "必須為有效的 UUID",
+      "uuidv1": "必須為有效的 UUID v1",
+      "uuidv2": "必須為有效的 UUID v2",
+      "uuidv3": "必須為有效的 UUID v3",
+      "uuidv4": "必須為有效的 UUID v4",
+      "uuidv5": "必須為有效的 UUID v5",
+      "uuidv6": "必須為有效的 UUID v6",
+      "uuidv7": "必須為有效的 UUID v7",
+      "uuidv8": "必須為有效的 UUID v8",
       "objectId": "必須為有效的 MongoDB ObjectId",
       "nanoid": "必須為有效的 Nano ID",
       "snowflake": "必須為有效的 Snowflake ID",
@@ -162,6 +170,31 @@
       "videoOnly": "僅允許影片檔案",
       "audioOnly": "僅允許音訊檔案",
       "archiveOnly": "僅允許壓縮檔案"
+    },
+    "creditCard": {
+      "required": "必填",
+      "invalid": "無效的信用卡號碼",
+      "notInWhitelist": "信用卡號碼不在允許的清單中"
+    },
+    "ip": {
+      "required": "必填",
+      "invalid": "無效的 IP 位址",
+      "notIPv4": "必須為有效的 IPv4 位址",
+      "notIPv6": "必須為有效的 IPv6 位址",
+      "notInWhitelist": "IP 位址不在允許的清單中"
+    },
+    "color": {
+      "required": "必填",
+      "invalid": "無效的顏色格式",
+      "notHex": "必須為有效的十六進位顏色",
+      "notRgb": "必須為有效的 RGB 顏色",
+      "notHsl": "必須為有效的 HSL 顏色"
+    },
+    "coordinate": {
+      "required": "必填",
+      "invalid": "無效的座標",
+      "invalidLatitude": "緯度必須介於 -90 與 90 之間",
+      "invalidLongitude": "經度必須介於 -180 與 180 之間"
     }
   },
   "taiwan": {
@@ -199,6 +232,24 @@
       "format6Only": "僅允許 6 碼郵遞區號",
       "invalidSuffix": "無效的郵遞區號後碼 - 5 碼格式須為 01-99，6 碼格式須為 001-999",
       "deprecated5Digit": "5 碼郵遞區號已棄用且不再支援"
+    },
+    "invoice": {
+      "required": "必填",
+      "invalid": "無效的統一發票號碼"
+    },
+    "licensePlate": {
+      "required": "必填",
+      "invalid": "無效的車牌號碼"
+    },
+    "bankAccount": {
+      "required": "必填",
+      "invalid": "無效的銀行帳號",
+      "invalidBankCode": "無效的銀行代碼",
+      "invalidAccountNumber": "無效的帳號號碼"
+    },
+    "passport": {
+      "required": "必填",
+      "invalid": "無效的護照號碼"
     }
   }
 }

package/src/index.ts

@@ -1,18 +1,26 @@
 export * from "./validators/common/boolean"
+export * from "./validators/common/color"
+export * from "./validators/common/coordinate"
+export * from "./validators/common/credit-card"
 export * from "./validators/common/date"
 export * from "./validators/common/datetime"
 export * from "./validators/common/email"
 export * from "./validators/common/file"
 export * from "./validators/common/id"
+export * from "./validators/common/ip"
 export * from "./validators/common/number"
 export * from "./validators/common/password"
 export * from "./validators/common/text"
 export * from "./validators/common/time"
 export * from "./validators/common/url"
+export * from "./validators/taiwan/bank-account"
 export * from "./validators/taiwan/business-id"
-export * from "./validators/taiwan/national-id"
+export * from "./validators/taiwan/fax"
+export * from "./validators/taiwan/invoice"
+export * from "./validators/taiwan/license-plate"
 export * from "./validators/taiwan/mobile"
+export * from "./validators/taiwan/national-id"
+export * from "./validators/taiwan/passport"
 export * from "./validators/taiwan/postal-code"
 export * from "./validators/taiwan/tel"
-export * from "./validators/taiwan/fax"
 export * from "./config"

package/src/validators/common/color.ts

@@ -0,0 +1,192 @@
+import { z, ZodNullable, ZodString } from "zod"
+import { t } from "../../i18n"
+import { getLocale, type Locale } from "../../config"
+
+export type ColorFormat = "hex" | "rgb" | "hsl" | "any"
+
+export type ColorMessages = {
+  required?: string
+  invalid?: string
+  notHex?: string
+  notRgb?: string
+  notHsl?: string
+}
+
+export type ColorOptions<IsRequired extends boolean = true> = {
+  format?: ColorFormat | ColorFormat[]
+  allowAlpha?: boolean
+  transform?: (value: string) => string
+  defaultValue?: IsRequired extends true ? string : string | null
+  i18n?: Partial<Record<Locale, Partial<ColorMessages>>>
+}
+
+export type ColorSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>
+
+const HEX_RGB = /^#[0-9a-f]{3}$/i
+const HEX_RRGGBB = /^#[0-9a-f]{6}$/i
+const HEX_RRGGBBAA = /^#[0-9a-f]{8}$/i
+
+function isValidByte(n: number): boolean {
+  return Number.isInteger(n) && n >= 0 && n <= 255
+}
+
+function isValidAlpha(n: number): boolean {
+  return n >= 0 && n <= 1
+}
+
+function isValidHue(n: number): boolean {
+  return n >= 0 && n <= 360
+}
+
+function isValidPercentage(n: number): boolean {
+  return n >= 0 && n <= 100
+}
+
+function validateHex(value: string, allowAlpha: boolean): boolean {
+  if (HEX_RGB.test(value) || HEX_RRGGBB.test(value)) return true
+  if (allowAlpha && HEX_RRGGBBAA.test(value)) return true
+  return false
+}
+
+function validateRgb(value: string, allowAlpha: boolean): boolean {
+  const rgbaMatch = value.match(/^rgba?\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*(?:,\s*(-?\d+(?:\.\d+)?))?\s*\)$/)
+  if (!rgbaMatch) return false
+
+  const r = Number(rgbaMatch[1])
+  const g = Number(rgbaMatch[2])
+  const b = Number(rgbaMatch[3])
+  const a = rgbaMatch[4] !== undefined ? Number(rgbaMatch[4]) : undefined
+
+  if (!isValidByte(r) || !isValidByte(g) || !isValidByte(b)) return false
+
+  if (a !== undefined) {
+    if (!allowAlpha) return false
+    if (!isValidAlpha(a)) return false
+  }
+
+  // If function name is "rgba", alpha must be present
+  if (value.startsWith("rgba(") && a === undefined) return false
+  // If function name is "rgb", alpha must not be present
+  if (value.startsWith("rgb(") && a !== undefined) return false
+
+  return true
+}
+
+function validateHsl(value: string, allowAlpha: boolean): boolean {
+  const hslaMatch = value.match(/^hsla?\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)%\s*,\s*(-?\d+(?:\.\d+)?)%\s*(?:,\s*(-?\d+(?:\.\d+)?))?\s*\)$/)
+  if (!hslaMatch) return false
+
+  const h = Number(hslaMatch[1])
+  const s = Number(hslaMatch[2])
+  const l = Number(hslaMatch[3])
+  const a = hslaMatch[4] !== undefined ? Number(hslaMatch[4]) : undefined
+
+  if (!isValidHue(h) || !isValidPercentage(s) || !isValidPercentage(l)) return false
+
+  if (a !== undefined) {
+    if (!allowAlpha) return false
+    if (!isValidAlpha(a)) return false
+  }
+
+  // If function name is "hsla", alpha must be present
+  if (value.startsWith("hsla(") && a === undefined) return false
+  // If function name is "hsl", alpha must not be present
+  if (value.startsWith("hsl(") && a !== undefined) return false
+
+  return true
+}
+
+function validateColor(value: string, formats: ColorFormat[], allowAlpha: boolean): { valid: boolean; failedFormat?: ColorFormat } {
+  const hasAny = formats.includes("any")
+
+  if (hasAny) {
+    if (validateHex(value, allowAlpha)) return { valid: true }
+    if (validateRgb(value, allowAlpha)) return { valid: true }
+    if (validateHsl(value, allowAlpha)) return { valid: true }
+    return { valid: false }
+  }
+
+  for (const format of formats) {
+    if (format === "hex" && validateHex(value, allowAlpha)) return { valid: true }
+    if (format === "rgb" && validateRgb(value, allowAlpha)) return { valid: true }
+    if (format === "hsl" && validateHsl(value, allowAlpha)) return { valid: true }
+  }
+
+  if (formats.length === 1) {
+    return { valid: false, failedFormat: formats[0] }
+  }
+
+  return { valid: false }
+}
+
+export function color<IsRequired extends boolean = false>(required?: IsRequired, options?: Omit<ColorOptions<IsRequired>, "required">): ColorSchema<IsRequired> {
+  const { format = "any", allowAlpha = true, transform, defaultValue, i18n } = options ?? {}
+
+  const isRequired = required ?? (false as IsRequired)
+
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null)
+
+  const formats: ColorFormat[] = Array.isArray(format) ? format : [format]
+
+  const getMessage = (key: keyof ColorMessages, 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.color.${key}`, params)
+  }
+
+  const preprocessFn = (val: unknown) => {
+    if (val === "" || val === null || val === undefined) {
+      return actualDefaultValue
+    }
+
+    let processed = String(val).trim()
+
+    if (processed === "" && !required) {
+      return null
+    }
+
+    if (transform) {
+      processed = transform(processed)
+    }
+
+    return processed
+  }
+
+  const baseSchema = isRequired ? z.preprocess(preprocessFn, z.string()) : z.preprocess(preprocessFn, z.string().nullable())
+
+  const schema = baseSchema.superRefine((val, ctx) => {
+    if (val === null) return
+
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      ctx.addIssue({ code: "custom", message: getMessage("required") })
+      return
+    }
+
+    if (!isRequired && val === "") return
+
+    const result = validateColor(val, formats, allowAlpha)
+
+    if (!result.valid) {
+      const formatMessageMap: Record<ColorFormat, keyof ColorMessages> = {
+        hex: "notHex",
+        rgb: "notRgb",
+        hsl: "notHsl",
+        any: "invalid",
+      }
+
+      const messageKey = result.failedFormat ? formatMessageMap[result.failedFormat] : "invalid"
+      ctx.addIssue({ code: "custom", message: getMessage(messageKey) })
+      return
+    }
+  })
+
+  return schema as unknown as ColorSchema<IsRequired>
+}
+
+export { validateColor }

package/src/validators/common/coordinate.ts

@@ -0,0 +1,159 @@
+import { z, ZodNullable, ZodString } from "zod"
+import { t } from "../../i18n"
+import { getLocale, type Locale } from "../../config"
+
+export type CoordinateType = "latitude" | "longitude" | "pair"
+
+export type CoordinateMessages = {
+  required?: string
+  invalid?: string
+  invalidLatitude?: string
+  invalidLongitude?: string
+}
+
+export type CoordinateOptions<IsRequired extends boolean = true> = {
+  type?: CoordinateType
+  precision?: number
+  transform?: (value: string) => string
+  defaultValue?: IsRequired extends true ? string : string | null
+  i18n?: Partial<Record<Locale, Partial<CoordinateMessages>>>
+}
+
+export type CoordinateSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>
+
+export function validateLatitude(value: number): boolean {
+  return Number.isFinite(value) && value >= -90 && value <= 90
+}
+
+export function validateLongitude(value: number): boolean {
+  return Number.isFinite(value) && value >= -180 && value <= 180
+}
+
+function validatePrecision(value: number, precision: number): boolean {
+  const decimalPart = value.toString().split(".")[1]
+  if (!decimalPart) return true
+  return decimalPart.length <= precision
+}
+
+export function coordinate<IsRequired extends boolean = false>(
+  required?: IsRequired,
+  options?: Omit<CoordinateOptions<IsRequired>, "required">,
+): CoordinateSchema<IsRequired> {
+  const { type = "pair", precision, transform, defaultValue, i18n } = options ?? {}
+
+  const isRequired = required ?? (false as IsRequired)
+
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null)
+
+  const getMessage = (key: keyof CoordinateMessages, 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.coordinate.${key}`, params)
+  }
+
+  const preprocessFn = (val: unknown) => {
+    if (val === "" || val === null || val === undefined) {
+      return actualDefaultValue
+    }
+
+    let processed = String(val).trim()
+
+    if (processed === "" && !required) {
+      return null
+    }
+
+    if (transform) {
+      processed = transform(processed)
+    }
+
+    return processed
+  }
+
+  const baseSchema = isRequired ? z.preprocess(preprocessFn, z.string()) : z.preprocess(preprocessFn, z.string().nullable())
+
+  const schema = baseSchema.superRefine((val, ctx) => {
+    if (val === null) return
+
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      ctx.addIssue({ code: "custom", message: getMessage("required") })
+      return
+    }
+
+    if (!isRequired && val === "") return
+
+    if (type === "pair") {
+      const parts = val.split(",")
+      if (parts.length !== 2) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalid") })
+        return
+      }
+
+      const lat = Number(parts[0].trim())
+      const lng = Number(parts[1].trim())
+
+      if (isNaN(lat) || isNaN(lng)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalid") })
+        return
+      }
+
+      if (!validateLatitude(lat)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalidLatitude") })
+        return
+      }
+
+      if (!validateLongitude(lng)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalidLongitude") })
+        return
+      }
+
+      if (precision !== undefined) {
+        if (!validatePrecision(lat, precision) || !validatePrecision(lng, precision)) {
+          ctx.addIssue({ code: "custom", message: getMessage("invalid") })
+          return
+        }
+      }
+    } else if (type === "latitude") {
+      const num = Number(val)
+
+      if (isNaN(num)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalidLatitude") })
+        return
+      }
+
+      if (!validateLatitude(num)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalidLatitude") })
+        return
+      }
+
+      if (precision !== undefined && !validatePrecision(num, precision)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalid") })
+        return
+      }
+    } else if (type === "longitude") {
+      const num = Number(val)
+
+      if (isNaN(num)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalidLongitude") })
+        return
+      }
+
+      if (!validateLongitude(num)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalidLongitude") })
+        return
+      }
+
+      if (precision !== undefined && !validatePrecision(num, precision)) {
+        ctx.addIssue({ code: "custom", message: getMessage("invalid") })
+        return
+      }
+    }
+  })
+
+  return schema as unknown as CoordinateSchema<IsRequired>
+}