@hy_ong/zod-kit 0.0.6 → 0.1.0

package/.claude/settings.local.json

@@ -20,7 +20,10 @@
       "WebFetch(domain:foundi.tw)",
       "WebFetch(domain:data.gov.tw)",
       "WebFetch(domain:gist.github.com)",
-      "WebFetch(domain:zip5.5432.tw)"
+      "WebFetch(domain:zip5.5432.tw)",
+      "Bash(npm install:*)",
+      "Bash(find:*)",
+      "Bash(python3:*)"
     ],
     "deny": [],
     "ask": []

package/dist/index.cjs

@@ -515,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"],
@@ -526,6 +525,7 @@ function boolean(options) {
     transform,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -557,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) {
@@ -589,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",
@@ -607,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();
@@ -629,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()) {
@@ -766,9 +766,8 @@ var normalizeDateTimeValue = (value, format, timezone2) => {
       return parsed.format(format);
   }
 };
-function datetime(options) {
+function datetime(required, options) {
   const {
-    required = true,
     format = "YYYY-MM-DD HH:mm",
     min,
     max,
@@ -794,7 +793,8 @@ function datetime(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();
@@ -828,7 +828,7 @@ function datetime(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -848,14 +848,14 @@ function datetime(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod3.z.preprocess(preprocessFn, import_zod3.z.string()) : import_zod3.z.preprocess(preprocessFn, import_zod3.z.string().nullable());
+  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 (required && (val === "" || val === "null" || val === "undefined")) {
+    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 (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (whitelist && whitelist.length > 0) {
       if (whitelist.includes(val)) {
         return true;
@@ -953,9 +953,8 @@ function datetime(options) {
 
 // src/validators/common/email.ts
 var import_zod4 = require("zod");
-function email(options) {
+function email(required, options) {
   const {
-    required = true,
     domain,
     domainBlacklist,
     minLength,
@@ -970,6 +969,7 @@ function email(options) {
     defaultValue,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1001,7 +1001,7 @@ function email(options) {
     import_zod4.z.union([import_zod4.z.string().email(), import_zod4.z.null()])
   );
   const schema = baseSchema.refine((val) => {
-    if (required && val === null) {
+    if (isRequired && val === null) {
       throw new import_zod4.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
@@ -1083,9 +1083,8 @@ function email(options) {
 
 // src/validators/common/file.ts
 var import_zod5 = require("zod");
-function file(options) {
+function file(required, options) {
   const {
-    required = true,
     maxSize,
     minSize,
     type,
@@ -1104,6 +1103,7 @@ function file(options) {
     defaultValue,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1290,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,
@@ -1307,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();
@@ -1329,10 +1329,10 @@ function id(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_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")) {
+    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;
@@ -1414,9 +1414,8 @@ function id(options) {
 
 // src/validators/common/number.ts
 var import_zod7 = require("zod");
-function number(options) {
+function number(required, options) {
   const {
-    required = true,
     min,
     max,
     defaultValue,
@@ -1432,6 +1431,7 @@ function number(options) {
     parseCommas = false,
     i18n
   } = options ?? {};
+  const isRequired = required ?? false;
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -1473,7 +1473,7 @@ function number(options) {
     },
     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) {
+    if (isRequired && val === null) {
       throw new import_zod7.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     if (val === null) return true;
@@ -1566,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,
@@ -1586,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();
@@ -1608,10 +1608,10 @@ function password(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_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")) {
+    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) {
@@ -1671,9 +1671,10 @@ function password(options) {
 
 // src/validators/common/text.ts
 var import_zod9 = 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);
+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();
@@ -1721,10 +1722,10 @@ function text(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_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")) {
+    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() === "") {
@@ -1832,9 +1833,8 @@ var normalizeTime = (timeStr, format) => {
   }
   return cleanTime;
 };
-function time(options) {
+function time(required, options) {
   const {
-    required = true,
     format = "HH:mm",
     min,
     max,
@@ -1854,7 +1854,8 @@ function time(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();
@@ -1888,7 +1889,7 @@ function time(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -1908,14 +1909,14 @@ function time(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_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 (required && (val === "" || val === "null" || val === "undefined")) {
+    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 (!required && val === "") return true;
+    if (!isRequired && val === "") return true;
     if (whitelist && whitelist.length > 0) {
       if (whitelist.includes(val)) {
         return true;
@@ -1995,9 +1996,8 @@ function time(options) {
 
 // src/validators/common/url.ts
 var import_zod11 = require("zod");
-function url(options) {
+function url(required, options) {
   const {
-    required = true,
     min,
     max,
     includes,
@@ -2019,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();
@@ -2041,10 +2042,10 @@ function url(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_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")) {
+    if (isRequired && (val === "" || val === "null" || val === "undefined")) {
       throw new import_zod11.z.ZodError([{ code: "custom", message: getMessage("required"), path: [] }]);
     }
     let urlObj;
@@ -2151,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();
@@ -2183,14 +2184,14 @@ function businessId(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_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")) {
+    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_zod12.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
@@ -2297,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();
@@ -2331,14 +2332,14 @@ function nationalId(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_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")) {
+    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_zod13.z.ZodError([{ code: "custom", message: getMessage("invalid"), path: [] }]);
     }
@@ -2352,9 +2353,10 @@ 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();
@@ -2375,7 +2377,7 @@ function mobile(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -2385,14 +2387,14 @@ function mobile(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod14.z.preprocess(preprocessFn, import_zod14.z.string()) : import_zod14.z.preprocess(preprocessFn, import_zod14.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")) {
+    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;
@@ -2989,9 +2991,8 @@ var validateTaiwanPostalCode = (value, format = "3+6", strictValidation = true,
       return false;
   }
 };
-function postalCode(options) {
+function postalCode(required, options) {
   const {
-    required = true,
     format = "3+6",
     strictValidation = true,
     allowDashes = true,
@@ -3004,7 +3005,8 @@ function postalCode(options) {
     strictSuffixValidation = false,
     deprecate5Digit = false
   } = options ?? {};
-  const actualDefaultValue = defaultValue ?? (required ? "" : null);
+  const isRequired = required ?? false;
+  const actualDefaultValue = defaultValue ?? (isRequired ? "" : null);
   const getMessage = (key, params) => {
     if (i18n) {
       const currentLocale2 = getLocale();
@@ -3032,14 +3034,14 @@ function postalCode(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod15.z.preprocess(preprocessFn, import_zod15.z.string()) : import_zod15.z.preprocess(preprocessFn, import_zod15.z.string().nullable());
+  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 (required && (val === "" || val === "null" || val === "undefined")) {
+    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 (!required && val === "") 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: [] }]);
@@ -3125,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();
@@ -3148,7 +3151,7 @@ function tel(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -3158,14 +3161,14 @@ function tel(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod16.z.preprocess(preprocessFn, import_zod16.z.string()) : import_zod16.z.preprocess(preprocessFn, import_zod16.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")) {
+    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;
@@ -3222,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();
@@ -3245,7 +3249,7 @@ function fax(options) {
       if (whitelist && whitelist.includes("")) {
         return "";
       }
-      if (!required) {
+      if (!isRequired) {
         return actualDefaultValue;
       }
       return actualDefaultValue;
@@ -3255,14 +3259,14 @@ function fax(options) {
     }
     return processed;
   };
-  const baseSchema = required ? import_zod17.z.preprocess(preprocessFn, import_zod17.z.string()) : import_zod17.z.preprocess(preprocessFn, import_zod17.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")) {
+    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;