@hy_ong/zod-kit 0.0.5 → 0.1.0

package/dist/index.cjs

@@ -30,24 +30,39 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DATETIME_PATTERNS: () => DATETIME_PATTERNS,
   ID_PATTERNS: () => ID_PATTERNS,
+  TIME_PATTERNS: () => TIME_PATTERNS,
+  VALID_3_DIGIT_PREFIXES: () => VALID_3_DIGIT_PREFIXES,
   boolean: () => boolean,
   businessId: () => businessId,
   date: () => date,
+  datetime: () => datetime,
   detectIdType: () => detectIdType,
   email: () => email,
   fax: () => fax,
+  file: () => file,
   getLocale: () => getLocale,
   id: () => id,
   mobile: () => mobile,
   nationalId: () => nationalId,
+  normalizeDateTimeValue: () => normalizeDateTimeValue,
+  normalizeTime: () => normalizeTime,
   number: () => number,
+  parseDateTimeValue: () => parseDateTimeValue,
+  parseTimeToMinutes: () => parseTimeToMinutes,
   password: () => password,
+  postalCode: () => postalCode,
   setLocale: () => setLocale,
   tel: () => tel,
   text: () => text,
+  time: () => time,
   url: () => url,
+  validate3DigitPostalCode: () => validate3DigitPostalCode,
+  validate5DigitPostalCode: () => validate5DigitPostalCode,
+  validate6DigitPostalCode: () => validate6DigitPostalCode,
   validateCitizenId: () => validateCitizenId,
+  validateDateTimeFormat: () => validateDateTimeFormat,
   validateIdType: () => validateIdType,
   validateNewResidentId: () => validateNewResidentId,
   validateOldResidentId: () => validateOldResidentId,
@@ -55,7 +70,9 @@ __export(index_exports, {
   validateTaiwanFax: () => validateTaiwanFax,
   validateTaiwanMobile: () => validateTaiwanMobile,
   validateTaiwanNationalId: () => validateTaiwanNationalId,
-  validateTaiwanTel: () => validateTaiwanTel
+  validateTaiwanPostalCode: () => validateTaiwanPostalCode,
+  validateTaiwanTel: () => validateTaiwanTel,
+  validateTimeFormat: () => validateTimeFormat
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -177,6 +194,56 @@ var zh_TW_default = {
       notToday: "\u4E0D\u5F97\u70BA\u4ECA\u5929",
       weekday: "\u5FC5\u9808\u70BA\u5DE5\u4F5C\u65E5\uFF08\u9031\u4E00\u81F3\u9031\u4E94\uFF09",
       weekend: "\u5FC5\u9808\u70BA\u9031\u672B\uFF08\u9031\u516D\u81F3\u9031\u65E5\uFF09"
+    },
+    time: {
+      required: "\u5FC5\u586B",
+      invalid: "\u7121\u6548\u7684\u6642\u9593\u683C\u5F0F",
+      format: "\u5FC5\u9808\u70BA ${format} \u683C\u5F0F",
+      min: "\u6642\u9593\u4E0D\u5F97\u65E9\u65BC ${min}",
+      max: "\u6642\u9593\u4E0D\u5F97\u665A\u65BC ${max}",
+      hour: "\u5C0F\u6642\u5FC5\u9808\u4ECB\u65BC ${minHour} \u8207 ${maxHour} \u4E4B\u9593",
+      minute: "\u5206\u9418\u5FC5\u9808\u70BA ${minuteStep} \u5206\u9418\u9593\u9694",
+      second: "\u79D2\u6578\u5FC5\u9808\u70BA ${secondStep} \u79D2\u9593\u9694",
+      includes: "\u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      excludes: "\u4E0D\u5F97\u5305\u542B\u300C${excludes}\u300D",
+      customRegex: "\u7121\u6548\u7684\u6642\u9593\u683C\u5F0F",
+      notInWhitelist: "\u6642\u9593\u4E0D\u5728\u5141\u8A31\u6E05\u55AE\u4E2D"
+    },
+    datetime: {
+      required: "\u5FC5\u586B",
+      invalid: "\u7121\u6548\u7684\u65E5\u671F\u6642\u9593\u683C\u5F0F",
+      format: "\u5FC5\u9808\u70BA ${format} \u683C\u5F0F",
+      min: "\u65E5\u671F\u6642\u9593\u4E0D\u5F97\u65E9\u65BC ${min}",
+      max: "\u65E5\u671F\u6642\u9593\u4E0D\u5F97\u665A\u65BC ${max}",
+      hour: "\u5C0F\u6642\u5FC5\u9808\u4ECB\u65BC ${minHour} \u8207 ${maxHour} \u4E4B\u9593",
+      minute: "\u5206\u9418\u5FC5\u9808\u70BA ${minuteStep} \u5206\u9418\u9593\u9694",
+      includes: "\u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      excludes: "\u4E0D\u5F97\u5305\u542B\u300C${excludes}\u300D",
+      past: "\u5FC5\u9808\u70BA\u904E\u53BB\u7684\u65E5\u671F\u6642\u9593",
+      future: "\u5FC5\u9808\u70BA\u672A\u4F86\u7684\u65E5\u671F\u6642\u9593",
+      today: "\u5FC5\u9808\u70BA\u4ECA\u5929",
+      notToday: "\u4E0D\u5F97\u70BA\u4ECA\u5929",
+      weekday: "\u5FC5\u9808\u70BA\u5DE5\u4F5C\u65E5\uFF08\u9031\u4E00\u81F3\u9031\u4E94\uFF09",
+      weekend: "\u5FC5\u9808\u70BA\u9031\u672B\uFF08\u9031\u516D\u81F3\u9031\u65E5\uFF09",
+      customRegex: "\u7121\u6548\u7684\u65E5\u671F\u6642\u9593\u683C\u5F0F",
+      notInWhitelist: "\u65E5\u671F\u6642\u9593\u4E0D\u5728\u5141\u8A31\u6E05\u55AE\u4E2D"
+    },
+    file: {
+      required: "\u5FC5\u586B",
+      invalid: "\u7121\u6548\u7684\u6A94\u6848\u683C\u5F0F",
+      size: "\u6A94\u6848\u5927\u5C0F\u4E0D\u5F97\u8D85\u904E ${size}",
+      minSize: "\u6A94\u6848\u5927\u5C0F\u81F3\u5C11 ${minSize}",
+      maxSize: "\u6A94\u6848\u5927\u5C0F\u4E0D\u5F97\u8D85\u904E ${maxSize}",
+      type: "\u6A94\u6848\u985E\u578B\u5FC5\u9808\u70BA\uFF1A${type}",
+      extension: "\u526F\u6A94\u540D\u5FC5\u9808\u70BA\uFF1A${extension}",
+      extensionBlacklist: "\u4E0D\u5141\u8A31\u4F7F\u7528\u526F\u6A94\u540D ${extension}",
+      name: "\u6A94\u6848\u540D\u7A31\u5FC5\u9808\u7B26\u5408\u683C\u5F0F ${pattern}",
+      nameBlacklist: "\u6A94\u6848\u540D\u7A31\u4E0D\u5F97\u7B26\u5408\u683C\u5F0F ${pattern}",
+      imageOnly: "\u50C5\u5141\u8A31\u5716\u7247\u6A94\u6848",
+      documentOnly: "\u50C5\u5141\u8A31\u6587\u4EF6\u6A94\u6848",
+      videoOnly: "\u50C5\u5141\u8A31\u5F71\u7247\u6A94\u6848",
+      audioOnly: "\u50C5\u5141\u8A31\u97F3\u8A0A\u6A94\u6848",
+      archiveOnly: "\u50C5\u5141\u8A31\u58D3\u7E2E\u6A94\u6848"
     }
   },
   taiwan: {
@@ -202,6 +269,18 @@ var zh_TW_default = {
       required: "\u5FC5\u586B",
       invalid: "\u7121\u6548\u7684\u50B3\u771F\u865F\u78BC\u683C\u5F0F",
       notInWhitelist: "\u4E0D\u5728\u5141\u8A31\u7684\u50B3\u771F\u865F\u78BC\u6E05\u55AE\u4E2D"
+    },
+    postalCode: {
+      required: "\u5FC5\u586B",
+      invalid: "\u7121\u6548\u7684\u90F5\u905E\u5340\u865F",
+      invalidFormat: "\u90F5\u905E\u5340\u865F\u683C\u5F0F\u932F\u8AA4",
+      invalidRange: "\u90F5\u905E\u5340\u865F\u8D85\u51FA\u6709\u6548\u7BC4\u570D",
+      legacy5DigitWarning: "5 \u78BC\u90F5\u905E\u5340\u865F\u70BA\u820A\u5F0F\u683C\u5F0F\uFF0C\u5EFA\u8B70\u4F7F\u7528 6 \u78BC\u683C\u5F0F",
+      format3Only: "\u50C5\u5141\u8A31 3 \u78BC\u90F5\u905E\u5340\u865F",
+      format5Only: "\u50C5\u5141\u8A31 5 \u78BC\u90F5\u905E\u5340\u865F",
+      format6Only: "\u50C5\u5141\u8A31 6 \u78BC\u90F5\u905E\u5340\u865F",
+      invalidSuffix: "\u7121\u6548\u7684\u90F5\u905E\u5340\u865F\u5F8C\u78BC - 5 \u78BC\u683C\u5F0F\u9808\u70BA 01-99\uFF0C6 \u78BC\u683C\u5F0F\u9808\u70BA 001-999",
+      deprecated5Digit: "5 \u78BC\u90F5\u905E\u5340\u865F\u5DF2\u68C4\u7528\u4E14\u4E0D\u518D\u652F\u63F4"
     }
   }
 };
@@ -321,6 +400,56 @@ var en_default = {
       notToday: "Date must not be today",
       weekday: "Date must be a weekday (Monday-Friday)",
       weekend: "Date must be a weekend (Saturday-Sunday)"
+    },
+    time: {
+      required: "Required",
+      invalid: "Invalid time format",
+      format: "Must be in ${format} format",
+      min: "Time must be after ${min}",
+      max: "Time must be before ${max}",
+      hour: "Hour must be between ${minHour} and ${maxHour}",
+      minute: "Minutes must be in ${minuteStep}-minute intervals",
+      second: "Seconds must be in ${secondStep}-second intervals",
+      includes: "Must include ${includes}",
+      excludes: "Must not contain ${excludes}",
+      customRegex: "Invalid time format",
+      notInWhitelist: "Time is not in the allowed list"
+    },
+    datetime: {
+      required: "Required",
+      invalid: "Invalid datetime format",
+      format: "Must be in ${format} format",
+      min: "DateTime must be after ${min}",
+      max: "DateTime must be before ${max}",
+      hour: "Hour must be between ${minHour} and ${maxHour}",
+      minute: "Minutes must be in ${minuteStep}-minute intervals",
+      includes: "Must include ${includes}",
+      excludes: "Must not contain ${excludes}",
+      past: "DateTime must be in the past",
+      future: "DateTime must be in the future",
+      today: "DateTime must be today",
+      notToday: "DateTime must not be today",
+      weekday: "DateTime must be a weekday (Monday-Friday)",
+      weekend: "DateTime must be a weekend (Saturday-Sunday)",
+      customRegex: "Invalid datetime format",
+      notInWhitelist: "DateTime is not in the allowed list"
+    },
+    file: {
+      required: "Required",
+      invalid: "Invalid file format",
+      size: "File size must not exceed ${size}",
+      minSize: "File size must be at least ${minSize}",
+      maxSize: "File size must not exceed ${maxSize}",
+      type: "File type must be one of: ${type}",
+      extension: "File extension must be one of: ${extension}",
+      extensionBlacklist: "File extension ${extension} is not allowed",
+      name: "File name must match pattern ${pattern}",
+      nameBlacklist: "File name must not match pattern ${pattern}",
+      imageOnly: "Only image files are allowed",
+      documentOnly: "Only document files are allowed",
+      videoOnly: "Only video files are allowed",
+      audioOnly: "Only audio files are allowed",
+      archiveOnly: "Only archive files are allowed"
     }
   },
   taiwan: {
@@ -346,6 +475,18 @@ var en_default = {
       required: "Required",
       invalid: "Invalid Taiwan fax format",
       notInWhitelist: "Not in allowed fax list"
+    },
+    postalCode: {
+      required: "Required",
+      invalid: "Invalid Taiwan postal code",
+      invalidFormat: "Invalid postal code format",
+      invalidRange: "Postal code is outside valid range",
+      legacy5DigitWarning: "5-digit postal codes are legacy format, consider using 6-digit format",
+      format3Only: "Only 3-digit postal codes are allowed",
+      format5Only: "Only 5-digit postal codes are allowed",
+      format6Only: "Only 6-digit postal codes are allowed",
+      invalidSuffix: "Invalid postal code suffix - must be 01-99 for 5-digit or 001-999 for 6-digit codes",
+      deprecated5Digit: "5-digit postal codes are deprecated and no longer supported"
     }
   }
 };
@@ -374,9 +515,8 @@ function getNestedValue(obj, path) {
 }
 
 // src/validators/common/boolean.ts
-function boolean(options) {
+function boolean(required, options) {
   const {
-    required = true,
     defaultValue = null,
     shouldBe,
     truthyValues = [true, "true", 1, "1", "yes", "on"],
@@ -385,6 +525,7 @@ function boolean(options) {
     transform,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -416,7 +557,7 @@ function boolean(options) {
     },
     import_zod.z.union([import_zod.z.literal(true), import_zod.z.literal(false), import_zod.z.literal(null)])
   );
-  if (required && defaultValue === null) {
+  if (isRequired && defaultValue === null) {
     result = result.refine((val) => val !== null, { message: getMessage("required") });
   }
   if (shouldBe === true) {
@@ -448,9 +589,8 @@ import_dayjs.default.extend(import_isSameOrBefore.default);
 import_dayjs.default.extend(import_customParseFormat.default);
 import_dayjs.default.extend(import_isToday.default);
 import_dayjs.default.extend(import_weekday.default);
-function date(options) {
+function date(required, options) {
   const {
-    required = true,
     min,
     max,
     format = "YYYY-MM-DD",
@@ -466,7 +606,8 @@ function date(options) {
     defaultValue = null,
     i18n
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -488,10 +629,10 @@ function date(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod2.z.preprocess(preprocessFn, import_zod2.z.string()) : import_zod2.z.preprocess(preprocessFn, import_zod2.z.string().nullable());
+  const baseSchema = isRequired ? import_zod2.z.preprocess(preprocessFn, import_zod2.z.string()) : import_zod2.z.preprocess(preprocessFn, import_zod2.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
       throw new import_zod2.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val !== null && !(0, import_dayjs.default)(val, format, true).isValid()) {
@@ -540,11 +681,280 @@ function date(options) {
   return schema;
 }
 
-// src/validators/common/email.ts
+// src/validators/common/datetime.ts
 var import_zod3 = require("zod");
-function email(options) {
+var import_dayjs2 = __toESM(require("dayjs"), 1);
+var import_customParseFormat2 = __toESM(require("dayjs/plugin/customParseFormat"), 1);
+var import_isSameOrAfter2 = __toESM(require("dayjs/plugin/isSameOrAfter"), 1);
+var import_isSameOrBefore2 = __toESM(require("dayjs/plugin/isSameOrBefore"), 1);
+var import_isToday2 = __toESM(require("dayjs/plugin/isToday"), 1);
+var import_weekday2 = __toESM(require("dayjs/plugin/weekday"), 1);
+var import_timezone = __toESM(require("dayjs/plugin/timezone"), 1);
+var import_utc = __toESM(require("dayjs/plugin/utc"), 1);
+import_dayjs2.default.extend(import_isSameOrAfter2.default);
+import_dayjs2.default.extend(import_isSameOrBefore2.default);
+import_dayjs2.default.extend(import_customParseFormat2.default);
+import_dayjs2.default.extend(import_isToday2.default);
+import_dayjs2.default.extend(import_weekday2.default);
+import_dayjs2.default.extend(import_timezone.default);
+import_dayjs2.default.extend(import_utc.default);
+var DATETIME_PATTERNS = {
+  "YYYY-MM-DD HH:mm": /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/,
+  "YYYY-MM-DD HH:mm:ss": /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/,
+  "YYYY-MM-DD hh:mm A": /^\d{4}-\d{2}-\d{2} \d{1,2}:\d{2} (AM|PM)$/i,
+  "YYYY-MM-DD hh:mm:ss A": /^\d{4}-\d{2}-\d{2} \d{1,2}:\d{2}:\d{2} (AM|PM)$/i,
+  "DD/MM/YYYY HH:mm": /^\d{1,2}\/\d{1,2}\/\d{4} \d{2}:\d{2}$/,
+  "DD/MM/YYYY HH:mm:ss": /^\d{1,2}\/\d{1,2}\/\d{4} \d{2}:\d{2}:\d{2}$/,
+  "DD/MM/YYYY hh:mm A": /^\d{1,2}\/\d{1,2}\/\d{4} \d{1,2}:\d{2} (AM|PM)$/i,
+  "MM/DD/YYYY HH:mm": /^\d{1,2}\/\d{1,2}\/\d{4} \d{2}:\d{2}$/,
+  "MM/DD/YYYY hh:mm A": /^\d{1,2}\/\d{1,2}\/\d{4} \d{1,2}:\d{2} (AM|PM)$/i,
+  "YYYY/MM/DD HH:mm": /^\d{4}\/\d{2}\/\d{2} \d{2}:\d{2}$/,
+  "DD-MM-YYYY HH:mm": /^\d{1,2}-\d{1,2}-\d{4} \d{2}:\d{2}$/,
+  "MM-DD-YYYY HH:mm": /^\d{1,2}-\d{1,2}-\d{4} \d{2}:\d{2}$/,
+  ISO: /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?$/,
+  RFC: /^[A-Za-z]{3}, \d{1,2} [A-Za-z]{3} \d{4} \d{2}:\d{2}:\d{2} [A-Z]{3}$/,
+  UNIX: /^\d{10}$/
+};
+var validateDateTimeFormat = (value, format) => {
+  const pattern = DATETIME_PATTERNS[format];
+  if (!pattern.test(value.trim())) {
+    return false;
+  }
+  const parsed = parseDateTimeValue(value, format);
+  return parsed !== null;
+};
+var parseDateTimeValue = (value, format, timezone2) => {
+  try {
+    const cleanValue = value.trim();
+    let parsed;
+    switch (format) {
+      case "ISO":
+        parsed = (0, import_dayjs2.default)(cleanValue);
+        break;
+      case "RFC":
+        parsed = (0, import_dayjs2.default)(cleanValue);
+        break;
+      case "UNIX":
+        parsed = import_dayjs2.default.unix(parseInt(cleanValue, 10));
+        break;
+      default:
+        parsed = (0, import_dayjs2.default)(cleanValue, format, true);
+        break;
+    }
+    if (!parsed.isValid()) {
+      return null;
+    }
+    if (timezone2) {
+      parsed = parsed.tz(timezone2);
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+};
+var normalizeDateTimeValue = (value, format, timezone2) => {
+  const parsed = parseDateTimeValue(value, format, timezone2);
+  if (!parsed) return null;
+  switch (format) {
+    case "ISO":
+      return parsed.toISOString();
+    case "RFC":
+      return parsed.format("ddd, DD MMM YYYY HH:mm:ss [GMT]");
+    case "UNIX":
+      return parsed.unix().toString();
+    default:
+      return parsed.format(format);
+  }
+};
+function datetime(required, options) {
+  const {
+    format = "YYYY-MM-DD HH:mm",
+    min,
+    max,
+    minHour,
+    maxHour,
+    allowedHours,
+    minuteStep,
+    timezone: timezone2,
+    includes,
+    excludes,
+    regex,
+    trimMode = "trim",
+    casing = "none",
+    mustBePast,
+    mustBeFuture,
+    mustBeToday,
+    mustNotBeToday,
+    weekdaysOnly,
+    weekendsOnly,
+    whitelist,
+    whitelistOnly = false,
+    transform,
+    defaultValue,
+    i18n
+  } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
+  const getMessage = (key, params) => {
+    if (i18n) {
+      const currentLocale2 = getLocale();
+      const customMessages = i18n[currentLocale2];
+      if (customMessages && customMessages[key]) {
+        const template = customMessages[key];
+        return template.replace(/\$\{(\w+)}/g, (_, k) => params?.[k] ?? "");
+      }
+    }
+    return t(`common.datetime.${key}`, params);
+  };
+  const preprocessFn = (val) => {
+    if (val === null || val === void 0) {
+      return actualDefaultValue;
+    }
+    let processed = String(val);
+    switch (trimMode) {
+      case "trim":
+        processed = processed.trim();
+        break;
+      case "trimStart":
+        processed = processed.trimStart();
+        break;
+      case "trimEnd":
+        processed = processed.trimEnd();
+        break;
+      case "none":
+        break;
+    }
+    if (processed === "") {
+      if (whitelist && whitelist.includes("")) {
+        return "";
+      }
+      if (!isRequired) {
+        return actualDefaultValue;
+      }
+      return actualDefaultValue;
+    }
+    switch (casing) {
+      case "upper":
+        processed = processed.toUpperCase();
+        break;
+      case "lower":
+        processed = processed.toLowerCase();
+        break;
+      case "none":
+        break;
+    }
+    if (transform) {
+      processed = transform(processed);
+    }
+    return processed;
+  };
+  const baseSchema = isRequired ? import_zod3.z.preprocess(preprocessFn, import_zod3.z.string()) : import_zod3.z.preprocess(preprocessFn, import_zod3.z.string().nullable());
+  const schema = baseSchema.refine((val) => {
+    if (val === null) return true;
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    }
+    if (val === null) return true;
+    if (!isRequired && val === "") return true;
+    if (whitelist && whitelist.length > 0) {
+      if (whitelist.includes(val)) {
+        return true;
+      }
+      if (whitelistOnly) {
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
+      }
+    }
+    if (regex) {
+      if (!regex.test(val)) {
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("customRegex"), path: [] }]);
+      }
+    } else {
+      if (!validateDateTimeFormat(val, format)) {
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("format", { format }), path: [] }]);
+      }
+    }
+    if (includes && !val.includes(includes)) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+    }
+    if (excludes) {
+      const excludeList = Array.isArray(excludes) ? excludes : [excludes];
+      for (const exclude of excludeList) {
+        if (val.includes(exclude)) {
+          throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
+        }
+      }
+    }
+    if (regex) {
+      return true;
+    }
+    const parsed = parseDateTimeValue(val, format, timezone2);
+    if (!parsed) {
+      const pattern = DATETIME_PATTERNS[format];
+      if (!pattern.test(val.trim())) {
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("format", { format }), path: [] }]);
+      } else {
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      }
+    }
+    const hour = parsed.hour();
+    if (minHour !== void 0 && hour < minHour) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("hour", { minHour, maxHour: maxHour ?? 23 }), path: [] }]);
+    }
+    if (maxHour !== void 0 && hour > maxHour) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("hour", { minHour: minHour ?? 0, maxHour }), path: [] }]);
+    }
+    if (allowedHours && allowedHours.length > 0) {
+      if (!allowedHours.includes(hour)) {
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("hour", { allowedHours: allowedHours.join(", ") }), path: [] }]);
+      }
+    }
+    const minute = parsed.minute();
+    if (minuteStep !== void 0 && minute % minuteStep !== 0) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("minute", { minuteStep }), path: [] }]);
+    }
+    if (min) {
+      const minParsed = typeof min === "string" ? parseDateTimeValue(min, format, timezone2) : (0, import_dayjs2.default)(min);
+      if (minParsed && parsed.isBefore(minParsed)) {
+        const minFormatted = typeof min === "string" ? min : minParsed.format(format);
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("min", { min: minFormatted }), path: [] }]);
+      }
+    }
+    if (max) {
+      const maxParsed = typeof max === "string" ? parseDateTimeValue(max, format, timezone2) : (0, import_dayjs2.default)(max);
+      if (maxParsed && parsed.isAfter(maxParsed)) {
+        const maxFormatted = typeof max === "string" ? max : maxParsed.format(format);
+        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("max", { max: maxFormatted }), path: [] }]);
+      }
+    }
+    const now = timezone2 ? (0, import_dayjs2.default)().tz(timezone2) : (0, import_dayjs2.default)();
+    if (mustBePast && !parsed.isBefore(now)) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("past"), path: [] }]);
+    }
+    if (mustBeFuture && !parsed.isAfter(now)) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("future"), path: [] }]);
+    }
+    if (mustBeToday && !parsed.isSame(now, "day")) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("today"), path: [] }]);
+    }
+    if (mustNotBeToday && parsed.isSame(now, "day")) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("notToday"), path: [] }]);
+    }
+    const dayOfWeek = parsed.day();
+    if (weekdaysOnly && (dayOfWeek === 0 || dayOfWeek === 6)) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("weekday"), path: [] }]);
+    }
+    if (weekendsOnly && dayOfWeek !== 0 && dayOfWeek !== 6) {
+      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("weekend"), path: [] }]);
+    }
+    return true;
+  });
+  return schema;
+}
+
+// src/validators/common/email.ts
+var import_zod4 = require("zod");
+function email(required, options) {
   const {
-    required = true,
     domain,
     domainBlacklist,
     minLength,
@@ -559,6 +969,7 @@ function email(options) {
     defaultValue,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -573,7 +984,7 @@ function email(options) {
   const disposableDomains = ["10minutemail.com", "tempmail.org", "guerrillamail.com", "mailinator.com", "yopmail.com", "temp-mail.org", "throwaway.email", "getnada.com", "maildrop.cc"];
   const freeEmailDomains = ["gmail.com", "yahoo.com", "hotmail.com", "outlook.com", "icloud.com", "aol.com", "protonmail.com", "zoho.com"];
   const actualDefaultValue = defaultValue ?? null;
-  const baseSchema = import_zod3.z.preprocess(
+  const baseSchema = import_zod4.z.preprocess(
     (val) => {
       if (val === "" || val === null || val === void 0) {
         return actualDefaultValue;
@@ -587,36 +998,36 @@ function email(options) {
       }
       return processed;
     },
-    import_zod3.z.union([import_zod3.z.string().email(), import_zod3.z.null()])
+    import_zod4.z.union([import_zod4.z.string().email(), import_zod4.z.null()])
   );
   const schema = baseSchema.refine((val) => {
-    if (required && val === null) {
-      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && val === null) {
+      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
     if (typeof val !== "string") {
-      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     if (minLength !== void 0 && val.length < minLength) {
-      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("minLength", { minLength }), path: [] }]);
+      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("minLength", { minLength }), path: [] }]);
     }
     if (maxLength !== void 0 && val.length > maxLength) {
-      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("maxLength", { maxLength }), path: [] }]);
+      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("maxLength", { maxLength }), path: [] }]);
     }
     if (includes !== void 0 && !val.includes(includes)) {
-      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
     }
     if (excludes !== void 0) {
       const excludeList = Array.isArray(excludes) ? excludes : [excludes];
       for (const exclude of excludeList) {
         if (val.includes(exclude)) {
-          throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("includes", { includes: exclude }), path: [] }]);
+          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("includes", { includes: exclude }), path: [] }]);
         }
       }
     }
     const emailDomain = val.split("@")[1]?.toLowerCase();
     if (!emailDomain) {
-      throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     if (businessOnly) {
       const isFreeProvider = freeEmailDomains.some((freeDomain) => {
@@ -626,7 +1037,7 @@ function email(options) {
         return emailDomain === freeDomain;
       });
       if (isFreeProvider) {
-        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("businessOnly"), path: [] }]);
+        throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("businessOnly"), path: [] }]);
       }
     }
     if (domainBlacklist && domainBlacklist.length > 0) {
@@ -638,7 +1049,7 @@ function email(options) {
         return emailDomain === lowerDomain;
       });
       if (isBlacklisted) {
-        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("domainBlacklist", { domain: emailDomain }), path: [] }]);
+        throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("domainBlacklist", { domain: emailDomain }), path: [] }]);
       }
     }
     if (domain !== void 0) {
@@ -651,7 +1062,7 @@ function email(options) {
         return emailDomain === lowerDomain;
       });
       if (!isAllowed) {
-        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("domain", { domain: Array.isArray(domain) ? domain.join(", ") : domain }), path: [] }]);
+        throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("domain", { domain: Array.isArray(domain) ? domain.join(", ") : domain }), path: [] }]);
       }
     }
     if (noDisposable) {
@@ -662,7 +1073,7 @@ function email(options) {
         return emailDomain === disposableDomain;
       });
       if (isDisposable) {
-        throw new import_zod3.z.ZodError([{ code: "custom", message: getMessage("noDisposable"), path: [] }]);
+        throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("noDisposable"), path: [] }]);
       }
     }
     return true;
@@ -670,8 +1081,179 @@ function email(options) {
   return schema;
 }
 
+// src/validators/common/file.ts
+var import_zod5 = require("zod");
+function file(required, options) {
+  const {
+    maxSize,
+    minSize,
+    type,
+    typeBlacklist,
+    extension,
+    extensionBlacklist,
+    namePattern,
+    nameBlacklist,
+    imageOnly = false,
+    documentOnly = false,
+    videoOnly = false,
+    audioOnly = false,
+    archiveOnly = false,
+    caseSensitive = false,
+    transform,
+    defaultValue,
+    i18n
+  } = options ?? {};
+  const isRequired = required ?? false;
+  const getMessage = (key, params) => {
+    if (i18n) {
+      const currentLocale2 = getLocale();
+      const customMessages = i18n[currentLocale2];
+      if (customMessages && customMessages[key]) {
+        const template = customMessages[key];
+        return template.replace(/\$\{(\w+)}/g, (_, k) => params?.[k] ?? "");
+      }
+    }
+    return t(`common.file.${key}`, params);
+  };
+  const imageTypes = ["image/jpeg", "image/jpg", "image/png", "image/gif", "image/webp", "image/svg+xml", "image/bmp", "image/tiff"];
+  const documentTypes = [
+    "application/pdf",
+    "application/msword",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    "application/vnd.ms-excel",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    "application/vnd.ms-powerpoint",
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    "text/plain",
+    "text/csv"
+  ];
+  const videoTypes = ["video/mp4", "video/mpeg", "video/quicktime", "video/x-msvideo", "video/x-ms-wmv", "video/webm", "video/ogg"];
+  const audioTypes = ["audio/mpeg", "audio/wav", "audio/ogg", "audio/aac", "audio/webm", "audio/mp3", "audio/x-wav"];
+  const archiveTypes = ["application/zip", "application/x-rar-compressed", "application/x-7z-compressed", "application/x-tar", "application/gzip"];
+  const actualDefaultValue = defaultValue ?? null;
+  const baseSchema = import_zod5.z.preprocess(
+    (val) => {
+      if (val === "" || val === null || val === void 0) {
+        return actualDefaultValue;
+      }
+      if (!(val instanceof File)) {
+        return val;
+      }
+      let processed = val;
+      if (transform) {
+        processed = transform(processed);
+      }
+      return processed;
+    },
+    import_zod5.z.union([import_zod5.z.instanceof(File).refine(() => true, { message: getMessage("invalid") }), import_zod5.z.null()])
+  );
+  const schema = baseSchema.refine((val) => required === false || val !== null, {
+    message: getMessage("required")
+  }).refine((val) => val === null || val instanceof File, {
+    message: getMessage("invalid")
+  }).refine((val) => val === null || minSize === void 0 || val.size >= minSize, {
+    message: getMessage("minSize", { minSize: formatFileSize(minSize || 0) })
+  }).refine((val) => val === null || maxSize === void 0 || val.size <= maxSize, {
+    message: getMessage("maxSize", { maxSize: formatFileSize(maxSize || 0) })
+  }).refine((val) => val === null || !imageOnly || imageTypes.includes(val.type), {
+    message: getMessage("imageOnly")
+  }).refine((val) => val === null || !documentOnly || documentTypes.includes(val.type), {
+    message: getMessage("documentOnly")
+  }).refine((val) => val === null || !videoOnly || videoTypes.includes(val.type), {
+    message: getMessage("videoOnly")
+  }).refine((val) => val === null || !audioOnly || audioTypes.includes(val.type), {
+    message: getMessage("audioOnly")
+  }).refine((val) => val === null || !archiveOnly || archiveTypes.includes(val.type), {
+    message: getMessage("archiveOnly")
+  }).refine(
+    (val) => {
+      if (val === null || !typeBlacklist || typeBlacklist.length === 0) return true;
+      return !typeBlacklist.includes(val.type);
+    },
+    {
+      message: getMessage("type", { type: typeBlacklist?.join(", ") || "" })
+    }
+  ).refine(
+    (val) => {
+      if (val === null || type === void 0) return true;
+      const allowedTypes = Array.isArray(type) ? type : [type];
+      return allowedTypes.includes(val.type);
+    },
+    {
+      message: getMessage("type", { type: Array.isArray(type) ? type.join(", ") : type || "" })
+    }
+  ).refine(
+    (val) => {
+      if (val === null || extensionBlacklist === void 0 || extensionBlacklist.length === 0) return true;
+      const fileExtension = getFileExtension(val.name, caseSensitive);
+      const normalizedBlacklist = extensionBlacklist.map((ext) => normalizeExtension(ext, caseSensitive));
+      return !normalizedBlacklist.includes(fileExtension);
+    },
+    {
+      message: getMessage("extensionBlacklist", { extension: extensionBlacklist?.join(", ") || "" })
+    }
+  ).refine(
+    (val) => {
+      if (val === null || extension === void 0) return true;
+      const fileName = val.name;
+      const fileExtension = getFileExtension(fileName, caseSensitive);
+      const allowedExtensions = Array.isArray(extension) ? extension : [extension];
+      const normalizedExtensions = allowedExtensions.map((ext) => normalizeExtension(ext, caseSensitive));
+      return normalizedExtensions.includes(fileExtension);
+    },
+    {
+      message: getMessage("extension", { extension: Array.isArray(extension) ? extension.join(", ") : extension || "" })
+    }
+  ).refine(
+    (val) => {
+      if (val === null || namePattern === void 0) return true;
+      const pattern = typeof namePattern === "string" ? new RegExp(namePattern) : namePattern;
+      return pattern.test(val.name);
+    },
+    {
+      message: getMessage("name", { pattern: namePattern?.toString() || "" })
+    }
+  ).refine(
+    (val) => {
+      if (val === null || nameBlacklist === void 0) return true;
+      const blacklistPatterns = Array.isArray(nameBlacklist) ? nameBlacklist : [nameBlacklist];
+      for (const blacklistPattern of blacklistPatterns) {
+        const pattern = typeof blacklistPattern === "string" ? new RegExp(blacklistPattern) : blacklistPattern;
+        if (pattern.test(val.name)) {
+          return false;
+        }
+      }
+      return true;
+    },
+    {
+      message: getMessage("nameBlacklist", { pattern: "" })
+    }
+  );
+  return schema;
+}
+function getFileExtension(fileName, caseSensitive) {
+  const lastDotIndex = fileName.lastIndexOf(".");
+  if (lastDotIndex === -1) return "";
+  const extension = fileName.substring(lastDotIndex);
+  return caseSensitive ? extension : extension.toLowerCase();
+}
+function normalizeExtension(extension, caseSensitive) {
+  const normalized = extension.startsWith(".") ? extension : `.${extension}`;
+  return caseSensitive ? normalized : normalized.toLowerCase();
+}
+function formatFileSize(bytes) {
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  let size = bytes;
+  let unitIndex = 0;
+  while (size >= 1024 && unitIndex < units.length - 1) {
+    size /= 1024;
+    unitIndex++;
+  }
+  return `${Math.round(size * 100) / 100} ${units[unitIndex]}`;
+}
+
 // src/validators/common/id.ts
-var import_zod4 = require("zod");
+var import_zod6 = require("zod");
 var ID_PATTERNS = {
   numeric: /^\d+$/,
   uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
@@ -708,9 +1290,8 @@ var validateIdType = (value, type) => {
   const pattern = ID_PATTERNS[type];
   return pattern ? pattern.test(value) : false;
 };
-function id(options) {
+function id(required, options) {
   const {
-    required = true,
     type = "auto",
     minLength,
     maxLength,
@@ -725,7 +1306,8 @@ function id(options) {
     defaultValue,
     i18n
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -747,23 +1329,23 @@ function id(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod4.z.preprocess(preprocessFn, import_zod4.z.string()) : import_zod4.z.preprocess(preprocessFn, import_zod4.z.string().nullable());
+  const baseSchema = isRequired ? import_zod6.z.preprocess(preprocessFn, import_zod6.z.string()) : import_zod6.z.preprocess(preprocessFn, import_zod6.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     const comparisonVal = !caseSensitive ? val.toLowerCase() : val;
     if (val !== null && minLength !== void 0 && val.length < minLength) {
-      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("minLength", { minLength }), path: [] }]);
+      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("minLength", { minLength }), path: [] }]);
     }
     if (val !== null && maxLength !== void 0 && val.length > maxLength) {
-      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("maxLength", { maxLength }), path: [] }]);
+      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("maxLength", { maxLength }), path: [] }]);
     }
     const hasContentValidations = customRegex !== void 0 || startsWith !== void 0 || endsWith !== void 0 || includes !== void 0 || excludes !== void 0;
     if (val !== null && customRegex !== void 0) {
       if (!customRegex.test(val)) {
-        throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("customFormat"), path: [] }]);
+        throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("customFormat"), path: [] }]);
       }
     } else if (val !== null && !hasContentValidations) {
       let isValidId;
@@ -771,17 +1353,17 @@ function id(options) {
         isValidId = allowedTypes.some((allowedType) => validateIdType(val, allowedType));
         if (!isValidId) {
           const typeNames = allowedTypes.join(", ");
-          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("invalid") + ` (allowed types: ${typeNames})`, path: [] }]);
+          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("invalid") + ` (allowed types: ${typeNames})`, path: [] }]);
         }
       } else if (type !== "auto") {
         isValidId = validateIdType(val, type);
         if (!isValidId) {
-          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage(type) || getMessage("invalid"), path: [] }]);
+          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage(type) || getMessage("invalid"), path: [] }]);
         }
       } else {
         isValidId = detectIdType(val) !== null;
         if (!isValidId) {
-          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
         }
       }
     } else if (val !== null && hasContentValidations && type !== "auto" && !customRegex) {
@@ -789,11 +1371,11 @@ function id(options) {
         const isValidType = allowedTypes.some((allowedType) => validateIdType(val, allowedType));
         if (!isValidType) {
           const typeNames = allowedTypes.join(", ");
-          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("invalid") + ` (allowed types: ${typeNames})`, path: [] }]);
+          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("invalid") + ` (allowed types: ${typeNames})`, path: [] }]);
         }
       } else {
         if (!validateIdType(val, type)) {
-          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage(type) || getMessage("invalid"), path: [] }]);
+          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage(type) || getMessage("invalid"), path: [] }]);
         }
       }
     }
@@ -801,20 +1383,20 @@ function id(options) {
     const searchEndsWith = !caseSensitive && endsWith ? endsWith.toLowerCase() : endsWith;
     const searchIncludes = !caseSensitive && includes ? includes.toLowerCase() : includes;
     if (val !== null && startsWith !== void 0 && !comparisonVal.startsWith(searchStartsWith)) {
-      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("startsWith", { startsWith }), path: [] }]);
+      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("startsWith", { startsWith }), path: [] }]);
     }
     if (val !== null && endsWith !== void 0 && !comparisonVal.endsWith(searchEndsWith)) {
-      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("endsWith", { endsWith }), path: [] }]);
+      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("endsWith", { endsWith }), path: [] }]);
     }
     if (val !== null && includes !== void 0 && !comparisonVal.includes(searchIncludes)) {
-      throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
     }
     if (val !== null && excludes !== void 0) {
       const excludeList = Array.isArray(excludes) ? excludes : [excludes];
       for (const exclude of excludeList) {
         const searchExclude = !caseSensitive ? exclude.toLowerCase() : exclude;
         if (comparisonVal.includes(searchExclude)) {
-          throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
+          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
         }
       }
     }
@@ -831,10 +1413,9 @@ function id(options) {
 }
 
 // src/validators/common/number.ts
-var import_zod5 = require("zod");
-function number(options) {
+var import_zod7 = require("zod");
+function number(required, options) {
   const {
-    required = true,
     min,
     max,
     defaultValue,
@@ -850,6 +1431,7 @@ function number(options) {
     parseCommas = false,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -862,7 +1444,7 @@ function number(options) {
     return t(`common.number.${key}`, params);
   };
   const actualDefaultValue = defaultValue ?? null;
-  const schema = import_zod5.z.preprocess(
+  const schema = import_zod7.z.preprocess(
     (val) => {
       if (val === "" || val === void 0 || val === null) {
         return actualDefaultValue;
@@ -889,58 +1471,58 @@ function number(options) {
       }
       return val;
     },
-    import_zod5.z.union([import_zod5.z.number(), import_zod5.z.null(), import_zod5.z.nan(), import_zod5.z.custom((val) => val === Infinity || val === -Infinity)])
+    import_zod7.z.union([import_zod7.z.number(), import_zod7.z.null(), import_zod7.z.nan(), import_zod7.z.custom((val) => val === Infinity || val === -Infinity)])
   ).refine((val) => {
-    if (required && val === null) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && val === null) {
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
     if (typeof val === "number" && isNaN(val)) {
       if (type === "integer") {
-        throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("integer"), path: [] }]);
+        throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("integer"), path: [] }]);
       } else if (type === "float") {
-        throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("float"), path: [] }]);
+        throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("float"), path: [] }]);
       } else {
-        throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+        throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
       }
     }
     if (typeof val !== "number") {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     if (finite && !Number.isFinite(val)) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("finite"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("finite"), path: [] }]);
     }
     if (type === "integer" && !Number.isInteger(val)) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("integer"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("integer"), path: [] }]);
     }
     if (type === "float" && Number.isInteger(val)) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("float"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("float"), path: [] }]);
     }
     if (positive && val <= 0) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("positive"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("positive"), path: [] }]);
     }
     if (negative && val >= 0) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("negative"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("negative"), path: [] }]);
     }
     if (nonNegative && val < 0) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("nonNegative"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("nonNegative"), path: [] }]);
     }
     if (nonPositive && val > 0) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("nonPositive"), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("nonPositive"), path: [] }]);
     }
     if (min !== void 0 && val < min) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
     }
     if (max !== void 0 && val > max) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
     }
     if (multipleOf !== void 0 && val % multipleOf !== 0) {
-      throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("multipleOf", { multipleOf }), path: [] }]);
+      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("multipleOf", { multipleOf }), path: [] }]);
     }
     if (precision !== void 0) {
       const decimalPlaces = (val.toString().split(".")[1] || "").length;
       if (decimalPlaces > precision) {
-        throw new import_zod5.z.ZodError([{ code: "custom", message: getMessage("precision", { precision }), path: [] }]);
+        throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("precision", { precision }), path: [] }]);
       }
     }
     return true;
@@ -949,7 +1531,7 @@ function number(options) {
 }
 
 // src/validators/common/password.ts
-var import_zod6 = require("zod");
+var import_zod8 = require("zod");
 var COMMON_PASSWORDS = [
   "password",
   "123456",
@@ -984,9 +1566,8 @@ var calculatePasswordStrength = (password2) => {
   if (score <= 6) return "strong";
   return "very-strong";
 };
-function password(options) {
+function password(required, options) {
   const {
-    required = true,
     min,
     max,
     uppercase,
@@ -1004,7 +1585,8 @@ function password(options) {
     defaultValue,
     i18n
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1026,38 +1608,38 @@ function password(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod6.z.preprocess(preprocessFn, import_zod6.z.string()) : import_zod6.z.preprocess(preprocessFn, import_zod6.z.string().nullable());
+  const baseSchema = isRequired ? import_zod8.z.preprocess(preprocessFn, import_zod8.z.string()) : import_zod8.z.preprocess(preprocessFn, import_zod8.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val !== null && min !== void 0 && val.length < min) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
     }
     if (val !== null && max !== void 0 && val.length > max) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
     }
     if (val !== null && uppercase && !/[A-Z]/.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("uppercase"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("uppercase"), path: [] }]);
     }
     if (val !== null && lowercase && !/[a-z]/.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("lowercase"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("lowercase"), path: [] }]);
     }
     if (val !== null && digits && !/[0-9]/.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("digits"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("digits"), path: [] }]);
     }
     if (val !== null && special && !/[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("special"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("special"), path: [] }]);
     }
     if (val !== null && noRepeating && /(.)\1{2,}/.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("noRepeating"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("noRepeating"), path: [] }]);
     }
     if (val !== null && noSequential && /(?:abc|bcd|cde|def|efg|fgh|ghi|hij|ijk|jkl|klm|lmn|mno|nop|opq|pqr|qrs|rst|stu|tuv|uvw|vwx|wxy|xyz|012|123|234|345|456|567|678|789)/i.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("noSequential"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("noSequential"), path: [] }]);
     }
     if (val !== null && noCommonWords && COMMON_PASSWORDS.some((common) => val.toLowerCase().includes(common.toLowerCase()))) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("noCommonWords"), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("noCommonWords"), path: [] }]);
     }
     if (val !== null && minStrength) {
       const strength = calculatePasswordStrength(val);
@@ -1065,22 +1647,22 @@ function password(options) {
       const currentLevel = strengthLevels.indexOf(strength);
       const requiredLevel = strengthLevels.indexOf(minStrength);
       if (currentLevel < requiredLevel) {
-        throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("minStrength", { minStrength }), path: [] }]);
+        throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("minStrength", { minStrength }), path: [] }]);
       }
     }
     if (val !== null && includes !== void 0 && !val.includes(includes)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
     }
     if (val !== null && excludes !== void 0) {
       const excludeList = Array.isArray(excludes) ? excludes : [excludes];
       for (const exclude of excludeList) {
         if (val.includes(exclude)) {
-          throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
+          throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
         }
       }
     }
     if (val !== null && regex !== void 0 && !regex.test(val)) {
-      throw new import_zod6.z.ZodError([{ code: "custom", message: getMessage("invalid", { regex }), path: [] }]);
+      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("invalid", { regex }), path: [] }]);
     }
     return true;
   });
@@ -1088,10 +1670,11 @@ function password(options) {
 }
 
 // src/validators/common/text.ts
-var import_zod7 = require("zod");
-function text(options) {
-  const { required = true, minLength, maxLength, startsWith, endsWith, includes, excludes, regex, trimMode = "trim", casing = "none", transform, notEmpty, defaultValue, i18n } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+var import_zod9 = require("zod");
+function text(required, options) {
+  const { minLength, maxLength, startsWith, endsWith, includes, excludes, regex, trimMode = "trim", casing = "none", transform, notEmpty, defaultValue, i18n } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1139,40 +1722,272 @@ function text(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod7.z.preprocess(preprocessFn, import_zod7.z.string()) : import_zod7.z.preprocess(preprocessFn, import_zod7.z.string().nullable());
+  const baseSchema = isRequired ? import_zod9.z.preprocess(preprocessFn, import_zod9.z.string()) : import_zod9.z.preprocess(preprocessFn, import_zod9.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (notEmpty && val !== null && val.trim() === "") {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("notEmpty"), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("notEmpty"), path: [] }]);
     }
     if (val !== null && minLength !== void 0 && val.length < minLength) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("minLength", { minLength }), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("minLength", { minLength }), path: [] }]);
     }
     if (val !== null && maxLength !== void 0 && val.length > maxLength) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("maxLength", { maxLength }), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("maxLength", { maxLength }), path: [] }]);
     }
     if (val !== null && startsWith !== void 0 && !val.startsWith(startsWith)) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("startsWith", { startsWith }), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("startsWith", { startsWith }), path: [] }]);
     }
     if (val !== null && endsWith !== void 0 && !val.endsWith(endsWith)) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("endsWith", { endsWith }), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("endsWith", { endsWith }), path: [] }]);
     }
     if (val !== null && includes !== void 0 && !val.includes(includes)) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
     }
     if (val !== null && excludes !== void 0) {
       const excludeList = Array.isArray(excludes) ? excludes : [excludes];
       for (const exclude of excludeList) {
         if (val.includes(exclude)) {
-          throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
+          throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
         }
       }
     }
     if (val !== null && regex !== void 0 && !regex.test(val)) {
-      throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("invalid", { regex }), path: [] }]);
+      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("invalid", { regex }), path: [] }]);
+    }
+    return true;
+  });
+  return schema;
+}
+
+// src/validators/common/time.ts
+var import_zod10 = require("zod");
+var TIME_PATTERNS = {
+  "HH:mm": /^([01]?[0-9]|2[0-3]):[0-5][0-9]$/,
+  "HH:mm:ss": /^([01]?[0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]$/,
+  "hh:mm A": /^(0?[1-9]|1[0-2]):[0-5][0-9]\s?(AM|PM)$/i,
+  "hh:mm:ss A": /^(0?[1-9]|1[0-2]):[0-5][0-9]:[0-5][0-9]\s?(AM|PM)$/i,
+  "H:mm": /^([0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/,
+  "h:mm A": /^([1-9]|1[0-2]):[0-5][0-9]\s?(AM|PM)$/i
+};
+var parseTimeToMinutes = (timeStr, format) => {
+  const cleanTime = timeStr.trim();
+  try {
+    if (format.includes("A")) {
+      const match = cleanTime.match(/^(\d{1,2}):(\d{2})(?::(\d{2}))?\s?(AM|PM)$/i);
+      if (!match) return null;
+      const [, hourStr, minuteStr, , period] = match;
+      let hour = parseInt(hourStr, 10);
+      const minute = parseInt(minuteStr, 10);
+      if (hour < 1 || hour > 12 || minute < 0 || minute > 59) {
+        return null;
+      }
+      if (period.toUpperCase() === "PM" && hour !== 12) {
+        hour += 12;
+      } else if (period.toUpperCase() === "AM" && hour === 12) {
+        hour = 0;
+      }
+      return hour * 60 + minute;
+    } else {
+      const match = cleanTime.match(/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/);
+      if (!match) return null;
+      const [, hourStr, minuteStr] = match;
+      const hour = parseInt(hourStr, 10);
+      const minute = parseInt(minuteStr, 10);
+      if (hour < 0 || hour > 23 || minute < 0 || minute > 59) {
+        return null;
+      }
+      return hour * 60 + minute;
+    }
+  } catch {
+    return null;
+  }
+};
+var validateTimeFormat = (value, format) => {
+  const pattern = TIME_PATTERNS[format];
+  return pattern.test(value.trim());
+};
+var normalizeTime = (timeStr, format) => {
+  const cleanTime = timeStr.trim();
+  if (format.includes("A")) {
+    const match = cleanTime.match(/^(\d{1,2}):(\d{2})(?::(\d{2}))?\s?(AM|PM)$/i);
+    if (!match) return null;
+    const [, hourStr, minuteStr, secondStr = "00", period] = match;
+    let hour = parseInt(hourStr, 10);
+    const minute = parseInt(minuteStr, 10);
+    const second = parseInt(secondStr, 10);
+    if (period.toUpperCase() === "PM" && hour !== 12) {
+      hour += 12;
+    } else if (period.toUpperCase() === "AM" && hour === 12) {
+      hour = 0;
+    }
+    return format.includes("ss") ? `${hour.toString().padStart(2, "0")}:${minute.toString().padStart(2, "0")}:${second.toString().padStart(2, "0")}` : `${hour.toString().padStart(2, "0")}:${minute.toString().padStart(2, "0")}`;
+  }
+  if (format === "H:mm") {
+    const match = cleanTime.match(/^(\d{1,2}):(\d{2})$/);
+    if (!match) return null;
+    const [, hourStr, minuteStr] = match;
+    return `${hourStr.padStart(2, "0")}:${minuteStr}`;
+  }
+  return cleanTime;
+};
+function time(required, options) {
+  const {
+    format = "HH:mm",
+    min,
+    max,
+    minHour,
+    maxHour,
+    allowedHours,
+    minuteStep,
+    secondStep,
+    includes,
+    excludes,
+    regex,
+    trimMode = "trim",
+    casing = "none",
+    whitelist,
+    whitelistOnly = false,
+    transform,
+    defaultValue,
+    i18n
+  } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
+  const getMessage = (key, params) => {
+    if (i18n) {
+      const currentLocale2 = getLocale();
+      const customMessages = i18n[currentLocale2];
+      if (customMessages && customMessages[key]) {
+        const template = customMessages[key];
+        return template.replace(/\$\{(\w+)}/g, (_, k) => params?.[k] ?? "");
+      }
+    }
+    return t(`common.time.${key}`, params);
+  };
+  const preprocessFn = (val) => {
+    if (val === null || val === void 0) {
+      return actualDefaultValue;
+    }
+    let processed = String(val);
+    switch (trimMode) {
+      case "trim":
+        processed = processed.trim();
+        break;
+      case "trimStart":
+        processed = processed.trimStart();
+        break;
+      case "trimEnd":
+        processed = processed.trimEnd();
+        break;
+      case "none":
+        break;
+    }
+    if (processed === "") {
+      if (whitelist && whitelist.includes("")) {
+        return "";
+      }
+      if (!isRequired) {
+        return actualDefaultValue;
+      }
+      return actualDefaultValue;
+    }
+    switch (casing) {
+      case "upper":
+        processed = processed.toUpperCase();
+        break;
+      case "lower":
+        processed = processed.toLowerCase();
+        break;
+      case "none":
+        break;
+    }
+    if (transform) {
+      processed = transform(processed);
+    }
+    return processed;
+  };
+  const baseSchema = isRequired ? import_zod10.z.preprocess(preprocessFn, import_zod10.z.string()) : import_zod10.z.preprocess(preprocessFn, import_zod10.z.string().nullable());
+  const schema = baseSchema.refine((val) => {
+    if (val === null) return true;
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    }
+    if (val === null) return true;
+    if (!isRequired && val === "") return true;
+    if (whitelist && whitelist.length > 0) {
+      if (whitelist.includes(val)) {
+        return true;
+      }
+      if (whitelistOnly) {
+        throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
+      }
+    }
+    if (regex) {
+      if (!regex.test(val)) {
+        throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("customRegex"), path: [] }]);
+      }
+    } else {
+      if (!validateTimeFormat(val, format)) {
+        throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("format", { format }), path: [] }]);
+      }
+    }
+    if (includes && !val.includes(includes)) {
+      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+    }
+    if (excludes) {
+      const excludeList = Array.isArray(excludes) ? excludes : [excludes];
+      for (const exclude of excludeList) {
+        if (val.includes(exclude)) {
+          throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
+        }
+      }
+    }
+    if (regex) {
+      return true;
+    }
+    const timeMinutes = parseTimeToMinutes(val, format);
+    if (timeMinutes === null) {
+      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+    }
+    const hour = Math.floor(timeMinutes / 60);
+    if (minHour !== void 0 && hour < minHour) {
+      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("hour", { minHour, maxHour: maxHour ?? 23 }), path: [] }]);
+    }
+    if (maxHour !== void 0 && hour > maxHour) {
+      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("hour", { minHour: minHour ?? 0, maxHour }), path: [] }]);
+    }
+    if (allowedHours && allowedHours.length > 0) {
+      if (!allowedHours.includes(hour)) {
+        throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("hour", { allowedHours: allowedHours.join(", ") }), path: [] }]);
+      }
+    }
+    const minute = timeMinutes % 60;
+    if (minuteStep !== void 0 && minute % minuteStep !== 0) {
+      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("minute", { minuteStep }), path: [] }]);
+    }
+    if (secondStep !== void 0 && format.includes("ss")) {
+      const secondMatch = val.match(/:(\d{2})$/);
+      if (secondMatch) {
+        const seconds = parseInt(secondMatch[1], 10);
+        if (seconds % secondStep !== 0) {
+          throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("second", { secondStep }), path: [] }]);
+        }
+      }
+    }
+    if (min) {
+      const minMinutes = parseTimeToMinutes(min, format);
+      if (minMinutes !== null && timeMinutes < minMinutes) {
+        throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
+      }
+    }
+    if (max) {
+      const maxMinutes = parseTimeToMinutes(max, format);
+      if (maxMinutes !== null && timeMinutes > maxMinutes) {
+        throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
+      }
     }
     return true;
   });
@@ -1180,10 +1995,9 @@ function text(options) {
 }
 
 // src/validators/common/url.ts
-var import_zod8 = require("zod");
-function url(options) {
+var import_zod11 = require("zod");
+function url(required, options) {
   const {
-    required = true,
     min,
     max,
     includes,
@@ -1205,7 +2019,8 @@ function url(options) {
     defaultValue = null,
     i18n
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1227,77 +2042,77 @@ function url(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod8.z.preprocess(preprocessFn, import_zod8.z.string()) : import_zod8.z.preprocess(preprocessFn, import_zod8.z.string().nullable());
+  const baseSchema = isRequired ? import_zod11.z.preprocess(preprocessFn, import_zod11.z.string()) : import_zod11.z.preprocess(preprocessFn, import_zod11.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     let urlObj;
     try {
       urlObj = new URL(val);
     } catch {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     if (val !== null && min !== void 0 && val.length < min) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("min", { min }), path: [] }]);
     }
     if (val !== null && max !== void 0 && val.length > max) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("max", { max }), path: [] }]);
     }
     if (val !== null && includes !== void 0 && !val.includes(includes)) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("includes", { includes }), path: [] }]);
     }
     if (val !== null && excludes !== void 0) {
       const excludeList = Array.isArray(excludes) ? excludes : [excludes];
       for (const exclude of excludeList) {
         if (val.includes(exclude)) {
-          throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
+          throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("excludes", { excludes: exclude }), path: [] }]);
         }
       }
     }
     if (protocols && !protocols.includes(urlObj.protocol.slice(0, -1))) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("protocol", { protocols: protocols.join(", ") }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("protocol", { protocols: protocols.join(", ") }), path: [] }]);
     }
     const hostname = urlObj.hostname.toLowerCase();
     if (allowedDomains && !allowedDomains.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`))) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("domain", { domains: allowedDomains.join(", ") }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("domain", { domains: allowedDomains.join(", ") }), path: [] }]);
     }
     if (blockedDomains && blockedDomains.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`))) {
       const blockedDomain = blockedDomains.find((domain) => hostname === domain || hostname.endsWith(`.${domain}`));
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("domainBlacklist", { domain: blockedDomain }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("domainBlacklist", { domain: blockedDomain }), path: [] }]);
     }
     const port = urlObj.port ? parseInt(urlObj.port) : urlObj.protocol === "https:" ? 443 : 80;
     if (allowedPorts && !allowedPorts.includes(port)) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("port", { ports: allowedPorts.join(", ") }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("port", { ports: allowedPorts.join(", ") }), path: [] }]);
     }
     if (blockedPorts && blockedPorts.includes(port)) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("port", { port }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("port", { port }), path: [] }]);
     }
     if (pathStartsWith && !urlObj.pathname.startsWith(pathStartsWith)) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("pathStartsWith", { path: pathStartsWith }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("pathStartsWith", { path: pathStartsWith }), path: [] }]);
     }
     if (pathEndsWith && !urlObj.pathname.endsWith(pathEndsWith)) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("pathEndsWith", { path: pathEndsWith }), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("pathEndsWith", { path: pathEndsWith }), path: [] }]);
     }
     if (mustHaveQuery && !urlObj.search) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("hasQuery"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("hasQuery"), path: [] }]);
     }
     if (mustNotHaveQuery && urlObj.search) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("noQuery"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("noQuery"), path: [] }]);
     }
     if (mustHaveFragment && !urlObj.hash) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("hasFragment"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("hasFragment"), path: [] }]);
     }
     if (mustNotHaveFragment && urlObj.hash) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("noFragment"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("noFragment"), path: [] }]);
     }
     const isLocalhost = hostname === "localhost" || hostname === "127.0.0.1" || hostname.startsWith("192.168.") || hostname.startsWith("10.") || hostname.match(/^172\.(1[6-9]|2[0-9]|3[0-1])\./);
     if (blockLocalhost && isLocalhost) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("noLocalhost"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("noLocalhost"), path: [] }]);
     }
     if (!allowLocalhost && isLocalhost) {
-      throw new import_zod8.z.ZodError([{ code: "custom", message: getMessage("localhost"), path: [] }]);
+      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("localhost"), path: [] }]);
     }
     return true;
   });
@@ -1305,7 +2120,7 @@ function url(options) {
 }
 
 // src/validators/taiwan/business-id.ts
-var import_zod9 = require("zod");
+var import_zod12 = require("zod");
 var validateTaiwanBusinessId = (value) => {
   if (!/^\d{8}$/.test(value)) {
     return false;
@@ -1337,14 +2152,14 @@ var validateTaiwanBusinessId = (value) => {
   }
   return false;
 };
-function businessId(options) {
+function businessId(required, options) {
   const {
-    required = true,
     transform,
     defaultValue,
     i18n
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1369,16 +2184,16 @@ function businessId(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod9.z.preprocess(preprocessFn, import_zod9.z.string()) : import_zod9.z.preprocess(preprocessFn, import_zod9.z.string().nullable());
+  const baseSchema = isRequired ? import_zod12.z.preprocess(preprocessFn, import_zod12.z.string()) : import_zod12.z.preprocess(preprocessFn, import_zod12.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod12.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
-    if (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (!validateTaiwanBusinessId(val)) {
-      throw new import_zod9.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod12.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     return true;
   });
@@ -1386,7 +2201,7 @@ function businessId(options) {
 }
 
 // src/validators/taiwan/national-id.ts
-var import_zod10 = require("zod");
+var import_zod13 = require("zod");
 var CITY_CODES = {
   "A": 10,
   "B": 11,
@@ -1483,16 +2298,16 @@ var validateTaiwanNationalId = (value, type = "both", allowOldResident = true) =
       return false;
   }
 };
-function nationalId(options) {
+function nationalId(required, options) {
   const {
-    required = true,
     type = "both",
     allowOldResident = true,
     transform,
     defaultValue,
     i18n
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1517,16 +2332,16 @@ function nationalId(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod10.z.preprocess(preprocessFn, import_zod10.z.string()) : import_zod10.z.preprocess(preprocessFn, import_zod10.z.string().nullable());
+  const baseSchema = isRequired ? import_zod13.z.preprocess(preprocessFn, import_zod13.z.string()) : import_zod13.z.preprocess(preprocessFn, import_zod13.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod13.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
-    if (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (!validateTaiwanNationalId(val, type, allowOldResident)) {
-      throw new import_zod10.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod13.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     return true;
   });
@@ -1534,13 +2349,14 @@ function nationalId(options) {
 }
 
 // src/validators/taiwan/mobile.ts
-var import_zod11 = require("zod");
+var import_zod14 = require("zod");
 var validateTaiwanMobile = (value) => {
   return /^09[0-9]\d{7}$/.test(value);
 };
-function mobile(options) {
-  const { required = true, whitelist, transform, defaultValue, i18n } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+function mobile(required, options) {
+  const { whitelist, transform, defaultValue, i18n } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1561,7 +2377,7 @@ function mobile(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -1571,22 +2387,698 @@ function mobile(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod11.z.preprocess(preprocessFn, import_zod11.z.string()) : import_zod11.z.preprocess(preprocessFn, import_zod11.z.string().nullable());
+  const baseSchema = isRequired ? import_zod14.z.preprocess(preprocessFn, import_zod14.z.string()) : import_zod14.z.preprocess(preprocessFn, import_zod14.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod14.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
-    if (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (whitelist && whitelist.length > 0) {
       if (whitelist.includes(val)) {
         return true;
       }
-      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
+      throw new import_zod14.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
     }
     if (!validateTaiwanMobile(val)) {
-      throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod14.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+    }
+    return true;
+  });
+  return schema;
+}
+
+// src/validators/taiwan/postal-code.ts
+var import_zod15 = require("zod");
+var VALID_3_DIGIT_PREFIXES = [
+  // Taipei City (台北市) - 100-116
+  "100",
+  "103",
+  "104",
+  "105",
+  "106",
+  "108",
+  "110",
+  "111",
+  "112",
+  "114",
+  "115",
+  "116",
+  // New Taipei City (新北市) - 200-253
+  "200",
+  "201",
+  "202",
+  "203",
+  "204",
+  "205",
+  "206",
+  "207",
+  "208",
+  "220",
+  "221",
+  "222",
+  "223",
+  "224",
+  "226",
+  "227",
+  "228",
+  "231",
+  "232",
+  "233",
+  "234",
+  "235",
+  "236",
+  "237",
+  "238",
+  "239",
+  "241",
+  "242",
+  "243",
+  "244",
+  "247",
+  "248",
+  "249",
+  "251",
+  "252",
+  "253",
+  // Keelung City (基隆市) - 200-206
+  "200",
+  "201",
+  "202",
+  "203",
+  "204",
+  "205",
+  "206",
+  // Taoyuan City (桃園市) - 300-338
+  "300",
+  "302",
+  "303",
+  "304",
+  "305",
+  "306",
+  "307",
+  "308",
+  "310",
+  "311",
+  "312",
+  "313",
+  "314",
+  "315",
+  "316",
+  "317",
+  "318",
+  "320",
+  "324",
+  "325",
+  "326",
+  "327",
+  "328",
+  "330",
+  "333",
+  "334",
+  "335",
+  "336",
+  "337",
+  "338",
+  // Hsinchu County (新竹縣) - 300-315
+  "300",
+  "302",
+  "303",
+  "304",
+  "305",
+  "306",
+  "307",
+  "308",
+  "310",
+  "311",
+  "312",
+  "313",
+  "314",
+  "315",
+  // Hsinchu City (新竹市) - 300
+  "300",
+  // Miaoli County (苗栗縣) - 350-369
+  "350",
+  "351",
+  "352",
+  "353",
+  "354",
+  "356",
+  "357",
+  "358",
+  "360",
+  "361",
+  "362",
+  "363",
+  "364",
+  "365",
+  "366",
+  "367",
+  "368",
+  "369",
+  // Taichung City (台中市) - 400-439
+  "400",
+  "401",
+  "402",
+  "403",
+  "404",
+  "406",
+  "407",
+  "408",
+  "411",
+  "412",
+  "413",
+  "414",
+  "420",
+  "421",
+  "422",
+  "423",
+  "424",
+  "426",
+  "427",
+  "428",
+  "429",
+  "432",
+  "433",
+  "434",
+  "435",
+  "436",
+  "437",
+  "438",
+  "439",
+  // Changhua County (彰化縣) - 500-530
+  "500",
+  "502",
+  "503",
+  "504",
+  "505",
+  "506",
+  "507",
+  "508",
+  "509",
+  "510",
+  "511",
+  "512",
+  "513",
+  "514",
+  "515",
+  "516",
+  "520",
+  "521",
+  "522",
+  "523",
+  "524",
+  "525",
+  "526",
+  "527",
+  "528",
+  "530",
+  // Nantou County (南投縣) - 540-558
+  "540",
+  "541",
+  "542",
+  "544",
+  "545",
+  "546",
+  "551",
+  "552",
+  "553",
+  "555",
+  "556",
+  "557",
+  "558",
+  // Yunlin County (雲林縣) - 630-655
+  "630",
+  "631",
+  "632",
+  "633",
+  "634",
+  "635",
+  "636",
+  "637",
+  "638",
+  "640",
+  "643",
+  "646",
+  "647",
+  "648",
+  "649",
+  "651",
+  "652",
+  "653",
+  "654",
+  "655",
+  // Chiayi County (嘉義縣) - 600-625
+  "600",
+  "602",
+  "603",
+  "604",
+  "605",
+  "606",
+  "607",
+  "608",
+  "611",
+  "612",
+  "613",
+  "614",
+  "615",
+  "616",
+  "621",
+  "622",
+  "623",
+  "624",
+  "625",
+  // Chiayi City (嘉義市) - 600
+  "600",
+  // Tainan City (台南市) - 700-745
+  "700",
+  "701",
+  "702",
+  "704",
+  "708",
+  "709",
+  "710",
+  "711",
+  "712",
+  "713",
+  "714",
+  "715",
+  "716",
+  "717",
+  "718",
+  "719",
+  "720",
+  "721",
+  "722",
+  "723",
+  "724",
+  "725",
+  "726",
+  "727",
+  "730",
+  "731",
+  "732",
+  "733",
+  "734",
+  "735",
+  "736",
+  "737",
+  "741",
+  "742",
+  "743",
+  "744",
+  "745",
+  // Kaohsiung City (高雄市) - 800-852
+  "800",
+  "801",
+  "802",
+  "803",
+  "804",
+  "805",
+  "806",
+  "807",
+  "811",
+  "812",
+  "813",
+  "814",
+  "815",
+  "820",
+  "821",
+  "822",
+  "823",
+  "824",
+  "825",
+  "826",
+  "827",
+  "828",
+  "829",
+  "830",
+  "831",
+  "832",
+  "833",
+  "840",
+  "842",
+  "843",
+  "844",
+  "845",
+  "846",
+  "847",
+  "848",
+  "849",
+  "851",
+  "852",
+  // Pingtung County (屏東縣) - 900-947
+  "900",
+  "901",
+  "902",
+  "903",
+  "904",
+  "905",
+  "906",
+  "907",
+  "908",
+  "909",
+  "911",
+  "912",
+  "913",
+  "920",
+  "921",
+  "922",
+  "923",
+  "924",
+  "925",
+  "926",
+  "927",
+  "928",
+  "929",
+  "931",
+  "932",
+  "940",
+  "941",
+  "942",
+  "943",
+  "944",
+  "945",
+  "946",
+  "947",
+  // Yilan County (宜蘭縣) - 260-269
+  "260",
+  "261",
+  "262",
+  "263",
+  "264",
+  "265",
+  "266",
+  "267",
+  "268",
+  "269",
+  // Hualien County (花蓮縣) - 970-983
+  "970",
+  "971",
+  "972",
+  "973",
+  "974",
+  "975",
+  "976",
+  "977",
+  "978",
+  "979",
+  "981",
+  "982",
+  "983",
+  // Taitung County (台東縣) - 950-966
+  "950",
+  "951",
+  "952",
+  "953",
+  "954",
+  "955",
+  "956",
+  "957",
+  "958",
+  "959",
+  "961",
+  "962",
+  "963",
+  "964",
+  "965",
+  "966",
+  // Penghu County (澎湖縣) - 880-885
+  "880",
+  "881",
+  "882",
+  "883",
+  "884",
+  "885",
+  // Kinmen County (金門縣) - 890-896
+  "890",
+  "891",
+  "892",
+  "893",
+  "894",
+  "895",
+  "896",
+  // Lienchiang County (連江縣/馬祖) - 209-212
+  "209",
+  "210",
+  "211",
+  "212"
+];
+var POSTAL_CODE_RANGES = {
+  // Major cities with extensive postal networks
+  "100": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Zhongzheng
+  "103": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Datong
+  "104": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Zhongshan
+  "105": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Songshan
+  "106": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Da'an
+  "108": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Wanhua
+  "110": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Xinyi
+  "111": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Shilin
+  "112": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Beitou
+  "114": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Neihu
+  "115": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Nangang
+  "116": { range5: [1, 99], range6: [1, 999] },
+  // Taipei City - Wenshan
+  // New Taipei City major areas
+  "220": { range5: [1, 99], range6: [1, 999] },
+  // Banqiao
+  "221": { range5: [1, 99], range6: [1, 999] },
+  // Xizhi
+  "222": { range5: [1, 99], range6: [1, 999] },
+  // Shenkeng
+  "223": { range5: [1, 99], range6: [1, 999] },
+  // Shiding
+  "224": { range5: [1, 99], range6: [1, 999] },
+  // Ruifang
+  // Taoyuan City
+  "320": { range5: [1, 99], range6: [1, 999] },
+  // Zhongli
+  "324": { range5: [1, 99], range6: [1, 999] },
+  // Pingzhen
+  "330": { range5: [1, 99], range6: [1, 999] },
+  // Taoyuan
+  // Taichung City
+  "400": { range5: [1, 99], range6: [1, 999] },
+  // Central District
+  "401": { range5: [1, 99], range6: [1, 999] },
+  // East District
+  "402": { range5: [1, 99], range6: [1, 999] },
+  // South District
+  "403": { range5: [1, 99], range6: [1, 999] },
+  // West District
+  "404": { range5: [1, 99], range6: [1, 999] },
+  // North District
+  // Tainan City
+  "700": { range5: [1, 99], range6: [1, 999] },
+  // Central District
+  "701": { range5: [1, 99], range6: [1, 999] },
+  // East District
+  "702": { range5: [1, 99], range6: [1, 999] },
+  // South District
+  // Kaohsiung City
+  "800": { range5: [1, 99], range6: [1, 999] },
+  // Xinxing
+  "801": { range5: [1, 99], range6: [1, 999] },
+  // Qianjin
+  "802": { range5: [1, 99], range6: [1, 999] },
+  // Lingya
+  "803": { range5: [1, 99], range6: [1, 999] },
+  // Yancheng
+  // Smaller areas with more limited ranges
+  "880": { range5: [1, 50], range6: [1, 500] },
+  // Penghu (smaller population)
+  "890": { range5: [1, 30], range6: [1, 300] },
+  // Kinmen (smaller population)
+  "209": { range5: [1, 20], range6: [1, 200] }
+  // Lienchiang/Matsu (smallest population)
+};
+var getPostalCodeRanges = (prefix) => {
+  return POSTAL_CODE_RANGES[prefix] || {
+    range5: [1, 99],
+    // Default range for 5-digit
+    range6: [1, 999]
+    // Default range for 6-digit
+  };
+};
+var validate3DigitPostalCode = (value, strictValidation = true, allowedPrefixes, blockedPrefixes) => {
+  if (!/^\d{3}$/.test(value)) {
+    return false;
+  }
+  if (blockedPrefixes && blockedPrefixes.includes(value)) {
+    return false;
+  }
+  if (allowedPrefixes) {
+    return allowedPrefixes.includes(value);
+  }
+  if (strictValidation) {
+    return VALID_3_DIGIT_PREFIXES.includes(value);
+  }
+  const num = parseInt(value, 10);
+  return num >= 100 && num <= 999;
+};
+var validate5DigitPostalCode = (value, strictValidation = true, strictSuffixValidation = false, allowedPrefixes, blockedPrefixes) => {
+  if (!/^\d{5}$/.test(value)) {
+    return false;
+  }
+  const prefix = value.substring(0, 3);
+  const suffix = value.substring(3, 5);
+  if (!validate3DigitPostalCode(prefix, strictValidation, allowedPrefixes, blockedPrefixes)) {
+    return false;
+  }
+  if (strictSuffixValidation) {
+    const suffixNum = parseInt(suffix, 10);
+    const ranges = getPostalCodeRanges(prefix);
+    if (suffixNum < ranges.range5[0] || suffixNum > ranges.range5[1]) {
+      return false;
+    }
+  }
+  return true;
+};
+var validate6DigitPostalCode = (value, strictValidation = true, strictSuffixValidation = false, allowedPrefixes, blockedPrefixes) => {
+  if (!/^\d{6}$/.test(value)) {
+    return false;
+  }
+  const prefix = value.substring(0, 3);
+  const suffix = value.substring(3, 6);
+  if (!validate3DigitPostalCode(prefix, strictValidation, allowedPrefixes, blockedPrefixes)) {
+    return false;
+  }
+  if (strictSuffixValidation) {
+    const suffixNum = parseInt(suffix, 10);
+    const ranges = getPostalCodeRanges(prefix);
+    if (suffixNum < ranges.range6[0] || suffixNum > ranges.range6[1]) {
+      return false;
+    }
+  }
+  return true;
+};
+var validateTaiwanPostalCode = (value, format = "3+6", strictValidation = true, strictSuffixValidation = false, allowDashes = true, allowedPrefixes, blockedPrefixes) => {
+  if (!value || typeof value !== "string") {
+    return false;
+  }
+  const cleanValue = allowDashes ? value.replace(/[-\s]/g, "") : value;
+  if (!allowDashes && /[-\s]/.test(value)) {
+    return false;
+  }
+  switch (format) {
+    case "3":
+      return cleanValue.length === 3 && validate3DigitPostalCode(cleanValue, strictValidation, allowedPrefixes, blockedPrefixes);
+    case "5":
+      return cleanValue.length === 5 && validate5DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes);
+    case "6":
+      return cleanValue.length === 6 && validate6DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes);
+    case "3+5":
+      return cleanValue.length === 3 && validate3DigitPostalCode(cleanValue, strictValidation, allowedPrefixes, blockedPrefixes) || cleanValue.length === 5 && validate5DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes);
+    case "3+6":
+      return cleanValue.length === 3 && validate3DigitPostalCode(cleanValue, strictValidation, allowedPrefixes, blockedPrefixes) || cleanValue.length === 6 && validate6DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes);
+    case "5+6":
+      return cleanValue.length === 5 && validate5DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes) || cleanValue.length === 6 && validate6DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes);
+    case "all":
+      return cleanValue.length === 3 && validate3DigitPostalCode(cleanValue, strictValidation, allowedPrefixes, blockedPrefixes) || cleanValue.length === 5 && validate5DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes) || cleanValue.length === 6 && validate6DigitPostalCode(cleanValue, strictValidation, strictSuffixValidation, allowedPrefixes, blockedPrefixes);
+    default:
+      return false;
+  }
+};
+function postalCode(required, options) {
+  const {
+    format = "3+6",
+    strictValidation = true,
+    allowDashes = true,
+    warn5Digit = true,
+    allowedPrefixes,
+    blockedPrefixes,
+    transform,
+    defaultValue,
+    i18n,
+    strictSuffixValidation = false,
+    deprecate5Digit = false
+  } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
+  const getMessage = (key, params) => {
+    if (i18n) {
+      const currentLocale2 = getLocale();
+      const customMessages = i18n[currentLocale2];
+      if (customMessages && customMessages[key]) {
+        const template = customMessages[key];
+        return template.replace(/\$\{(\w+)}/g, (_, k) => params?.[k] ?? "");
+      }
+    }
+    return t(`taiwan.postalCode.${key}`, params);
+  };
+  const preprocessFn = (val) => {
+    if (val === "" || val === null || val === void 0) {
+      return actualDefaultValue;
+    }
+    let processed = String(val).trim();
+    if (allowDashes) {
+      processed = processed.replace(/[-\s]/g, "");
+    }
+    if (processed === "" && !required) {
+      return null;
+    }
+    if (transform) {
+      processed = transform(processed);
+    }
+    return processed;
+  };
+  const baseSchema = isRequired ? import_zod15.z.preprocess(preprocessFn, import_zod15.z.string()) : import_zod15.z.preprocess(preprocessFn, import_zod15.z.string().nullable());
+  const schema = baseSchema.refine((val) => {
+    if (val === null) return true;
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    }
+    if (val === null) return true;
+    if (!isRequired && val === "") return true;
+    const cleanValue = val.replace(/[-\s]/g, "");
+    if (format === "3" && cleanValue.length !== 3) {
+      throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("format3Only"), path: [] }]);
+    }
+    if (format === "5" && cleanValue.length !== 5) {
+      throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("format5Only"), path: [] }]);
+    }
+    if (format === "6" && cleanValue.length !== 6) {
+      throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("format6Only"), path: [] }]);
+    }
+    if (deprecate5Digit && cleanValue.length === 5) {
+      throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("deprecated5Digit"), path: [] }]);
+    }
+    if (strictSuffixValidation) {
+      if (cleanValue.length === 5) {
+        const prefix = cleanValue.substring(0, 3);
+        const suffix = cleanValue.substring(3, 5);
+        const suffixNum = parseInt(suffix, 10);
+        const ranges = getPostalCodeRanges(prefix);
+        if (suffixNum < ranges.range5[0] || suffixNum > ranges.range5[1]) {
+          throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("invalidSuffix"), path: [] }]);
+        }
+      } else if (cleanValue.length === 6) {
+        const prefix = cleanValue.substring(0, 3);
+        const suffix = cleanValue.substring(3, 6);
+        const suffixNum = parseInt(suffix, 10);
+        const ranges = getPostalCodeRanges(prefix);
+        if (suffixNum < ranges.range6[0] || suffixNum > ranges.range6[1]) {
+          throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("invalidSuffix"), path: [] }]);
+        }
+      }
+    }
+    if (!validateTaiwanPostalCode(val, format, strictValidation, strictSuffixValidation, allowDashes, allowedPrefixes, blockedPrefixes)) {
+      throw new import_zod15.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+    }
+    if (warn5Digit && cleanValue.length === 5 && format !== "5" && !deprecate5Digit) {
+      console.warn(getMessage("legacy5DigitWarning"));
     }
     return true;
   });
@@ -1594,7 +3086,7 @@ function mobile(options) {
 }
 
 // src/validators/taiwan/tel.ts
-var import_zod12 = require("zod");
+var import_zod16 = require("zod");
 var validateTaiwanTel = (value) => {
   const cleanValue = value.replace(/[-\s]/g, "");
   if (!/^0\d{7,10}$/.test(cleanValue)) {
@@ -1635,9 +3127,10 @@ var validateTaiwanTel = (value) => {
   }
   return false;
 };
-function tel(options) {
-  const { required = true, whitelist, transform, defaultValue, i18n } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+function tel(required, options) {
+  const { whitelist, transform, defaultValue, i18n } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1658,7 +3151,7 @@ function tel(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -1668,22 +3161,22 @@ function tel(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod12.z.preprocess(preprocessFn, import_zod12.z.string()) : import_zod12.z.preprocess(preprocessFn, import_zod12.z.string().nullable());
+  const baseSchema = isRequired ? import_zod16.z.preprocess(preprocessFn, import_zod16.z.string()) : import_zod16.z.preprocess(preprocessFn, import_zod16.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod12.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod16.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
-    if (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (whitelist && whitelist.length > 0) {
       if (whitelist.includes(val)) {
         return true;
       }
-      throw new import_zod12.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
+      throw new import_zod16.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
     }
     if (!validateTaiwanTel(val)) {
-      throw new import_zod12.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod16.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     return true;
   });
@@ -1691,7 +3184,7 @@ function tel(options) {
 }
 
 // src/validators/taiwan/fax.ts
-var import_zod13 = require("zod");
+var import_zod17 = require("zod");
 var validateTaiwanFax = (value) => {
   const cleanValue = value.replace(/[-\s]/g, "");
   if (!/^0\d{7,10}$/.test(cleanValue)) {
@@ -1732,9 +3225,10 @@ var validateTaiwanFax = (value) => {
   }
   return false;
 };
-function fax(options) {
-  const { required = true, whitelist, transform, defaultValue, i18n } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+function fax(required, options) {
+  const { whitelist, transform, defaultValue, i18n } = options ?? {};
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1755,7 +3249,7 @@ function fax(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -1765,22 +3259,22 @@ function fax(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod13.z.preprocess(preprocessFn, import_zod13.z.string()) : import_zod13.z.preprocess(preprocessFn, import_zod13.z.string().nullable());
+  const baseSchema = isRequired ? import_zod17.z.preprocess(preprocessFn, import_zod17.z.string()) : import_zod17.z.preprocess(preprocessFn, import_zod17.z.string().nullable());
   const schema = baseSchema.refine((val) => {
     if (val === null) return true;
-    if (required && (val === "" || val === "null" || val === "undefined")) {
-      throw new import_zod13.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
+      throw new import_zod17.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
-    if (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (whitelist && whitelist.length > 0) {
       if (whitelist.includes(val)) {
         return true;
       }
-      throw new import_zod13.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
+      throw new import_zod17.z.ZodError([{ code: "custom", message: getMessage("notInWhitelist"), path: [] }]);
     }
     if (!validateTaiwanFax(val)) {
-      throw new import_zod13.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
+      throw new import_zod17.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
     return true;
   });
@@ -1788,24 +3282,39 @@ function fax(options) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DATETIME_PATTERNS,
   ID_PATTERNS,
+  TIME_PATTERNS,
+  VALID_3_DIGIT_PREFIXES,
   boolean,
   businessId,
   date,
+  datetime,
   detectIdType,
   email,
   fax,
+  file,
   getLocale,
   id,
   mobile,
   nationalId,
+  normalizeDateTimeValue,
+  normalizeTime,
   number,
+  parseDateTimeValue,
+  parseTimeToMinutes,
   password,
+  postalCode,
   setLocale,
   tel,
   text,
+  time,
   url,
+  validate3DigitPostalCode,
+  validate5DigitPostalCode,
+  validate6DigitPostalCode,
   validateCitizenId,
+  validateDateTimeFormat,
   validateIdType,
   validateNewResidentId,
   validateOldResidentId,
@@ -1813,5 +3322,7 @@ function fax(options) {
   validateTaiwanFax,
   validateTaiwanMobile,
   validateTaiwanNationalId,
-  validateTaiwanTel
+  validateTaiwanPostalCode,
+  validateTaiwanTel,
+  validateTimeFormat
 });