@hy_ong/zod-kit 0.0.1 → 0.0.2

package/dist/index.cjs

@@ -0,0 +1,343 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  boolean: () => boolean,
+  email: () => email,
+  getLocale: () => getLocale,
+  integer: () => integer,
+  number: () => number,
+  password: () => password,
+  setLocale: () => setLocale,
+  text: () => text,
+  url: () => url
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/common/boolean.ts
+var import_zod = require("zod");
+
+// src/i18n/locales/zh-TW.json
+var zh_TW_default = {
+  common: {
+    boolean: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      shouldBe: {
+        true: "${label} \u5FC5\u9808\u70BA\u662F",
+        false: "${label} \u5FC5\u9808\u70BA\u5426"
+      }
+    },
+    email: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      includes: "${label} \u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      invalid: "${label} \u683C\u5F0F\u932F\u8AA4",
+      domain: "${label} \u5FC5\u9808\u70BA @${domain} \u7DB2\u57DF"
+    },
+    url: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      includes: "${label} \u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      invalid: "${label} \u683C\u5F0F\u932F\u8AA4"
+    },
+    password: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      uppercase: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u5927\u5BEB\u5B57\u6BCD",
+      lowercase: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u5C0F\u5BEB\u5B57\u6BCD",
+      digits: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u6578\u5B57",
+      special: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u7279\u6B8A\u7B26\u865F"
+    },
+    number: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u6700\u5C0F\u503C ${min}",
+      max: "${label} \u6700\u5927\u503C ${max}"
+    },
+    id: {
+      required: "\u8ACB\u9078\u64C7 ${label}",
+      invalid: "${label} \u7121\u6548"
+    },
+    integer: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u6700\u5C0F\u503C ${min}",
+      max: "${label} \u6700\u5927\u503C ${max}",
+      integer: "${label} \u5FC5\u9808\u70BA\u6574\u6578"
+    },
+    float: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      float: "${label} \u5FC5\u9808\u70BA\u6D6E\u9EDE\u6578",
+      min: "${label} \u6700\u5C0F\u503C ${min}",
+      max: "${label} \u6700\u5927\u503C ${max}"
+    },
+    text: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      startsWith: "${label} \u5FC5\u9808\u4EE5\u300C${startsWith}\u300D\u958B\u982D",
+      endsWith: "${label} \u5FC5\u9808\u4EE5\u300C${endsWith}\u300D\u7D50\u5C3E",
+      includes: "${label} \u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      invalid: "${label} \u683C\u5F0F\u932F\u8AA4"
+    }
+  }
+};
+
+// src/i18n/locales/en.json
+var en_default = {
+  common: {
+    boolean: {
+      required: "${label} is required",
+      shouldBe: {
+        true: "${label} must be True",
+        false: "${label} must be False"
+      }
+    },
+    email: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      includes: "${label} must include ${includes}",
+      invalid: "${label} is invalid format",
+      domain: "${label} must be under the domain @${domain}"
+    },
+    url: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      includes: "${label} must include ${includes}",
+      invalid: "${label} is invalid format"
+    },
+    password: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      uppercase: "${label} must include at least one uppercase letter",
+      lowercase: "${label} must include at least one lowercase letter",
+      digits: "${label} must include at least one digit",
+      special: "${label} must include at least one special character"
+    },
+    number: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min}",
+      max: "${label} must be at most ${max}"
+    },
+    integer: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min}",
+      max: "${label} must be at most ${max}",
+      integer: "${label} must be an integer"
+    },
+    float: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min}",
+      max: "${label} must be at most ${max}",
+      float: "${label} must be an float"
+    },
+    text: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      startsWith: "${label} must start with ${startsWith}",
+      endsWith: "${label} must end with ${endsWith}",
+      includes: "${label} must include ${includes}",
+      invalid: "${label} is invalid format"
+    },
+    date: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      includes: "${label} must include ${includes}",
+      format: "${label} must be in ${format} format"
+    }
+  }
+};
+
+// src/config.ts
+var currentLocale = "zh-TW";
+var setLocale = (locale) => {
+  currentLocale = locale;
+};
+var getLocale = () => currentLocale;
+
+// src/i18n/index.ts
+var dicts = {
+  "zh-TW": zh_TW_default,
+  en: en_default
+};
+var t = (key, params = {}) => {
+  const locale = getLocale();
+  const dict = dicts[locale] || {};
+  const template = getNestedValue(dict, key) ?? key;
+  return template.replace(/\$\{(\w+)}/g, (_, k) => params[k] ?? "");
+};
+function getNestedValue(obj, path) {
+  const result = path.split(".").reduce((acc, part) => acc && typeof acc === "object" ? acc[part] : void 0, obj);
+  return typeof result === "string" ? result : void 0;
+}
+
+// src/common/boolean.ts
+function boolean(options) {
+  const { required = true, label, defaultValue = null, shouldBe } = options ?? {};
+  let result = import_zod.z.preprocess(
+    (val) => {
+      if (val === "" || val === void 0 || val === null) return defaultValue;
+      if (val === "true" || val === 1 || val === "1") return true;
+      if (val === "false" || val === 0 || val === "0") return false;
+      return val;
+    },
+    import_zod.z.union([import_zod.z.literal(true), import_zod.z.literal(false), import_zod.z.literal(null)])
+  );
+  if (required && defaultValue === null) {
+    result = result.refine((val) => val !== null, { message: t("common.boolean.required", { label }) });
+  }
+  if (shouldBe === true) {
+    result = result.refine((val) => val === true, { message: t("common.boolean.shouldBe.true", { label }) });
+  } else if (shouldBe === false) {
+    result = result.refine((val) => val === false, { message: t("common.boolean.shouldBe.false", { label }) });
+  }
+  return result;
+}
+
+// src/common/email.ts
+var import_zod2 = require("zod");
+function email(options) {
+  const { required = true, label, domain, min, max, includes } = options ?? {};
+  const baseSchema = required ? import_zod2.z.preprocess(
+    (val) => val === "" || val === null || val === void 0 ? null : val,
+    import_zod2.z.email({
+      error: (issue) => {
+        if (issue.code === "invalid_type") return t("common.email.required", { label });
+        else if (issue.code === "invalid_format") return t("common.email.invalid", { label });
+        return t("common.email.invalid", { label });
+      }
+    })
+  ) : import_zod2.z.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, import_zod2.z.email({ message: t("common.email.invalid", { label }) }).nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.text.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.text.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.text.max", { label, max }) }).refine((val) => val === null || includes === void 0 || val.includes(includes), { message: t("common.text.includes", { label, includes }) }).refine(
+    (val) => {
+      if (val === null || domain === void 0) return true;
+      return val.split("@")[1]?.toLowerCase() === domain.toLowerCase();
+    },
+    { message: t("common.email.domain", { label, domain }) }
+  );
+  return schema;
+}
+
+// src/common/url.ts
+var import_zod3 = require("zod");
+function url(options) {
+  const { required = true, label, min, max, includes } = options ?? {};
+  const baseSchema = required ? import_zod3.z.preprocess(
+    (val) => val === "" || val === null || val === void 0 ? null : val,
+    import_zod3.z.url({
+      error: (issue) => {
+        if (issue.code === "invalid_type") return t("common.url.required", { label });
+        else if (issue.code === "invalid_format") return t("common.url.invalid", { label });
+        return t("common.url.invalid", { label });
+      }
+    })
+  ) : import_zod3.z.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, import_zod3.z.url({ message: t("common.url.invalid", { label }) }).nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.text.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.text.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.text.max", { label, max }) }).refine((val) => val === null || includes === void 0 || val.includes(includes), { message: t("common.text.includes", { label, includes }) });
+  return schema;
+}
+
+// src/common/text.ts
+var import_zod4 = require("zod");
+function text(options) {
+  const { required = true, label, min, max, startsWith, endsWith, includes, regex, defaultValue = null } = options ?? {};
+  const baseSchema = required ? import_zod4.z.preprocess((val) => val === "" || val === null || val === void 0 ? defaultValue : val, import_zod4.z.coerce.string().trim()) : import_zod4.z.preprocess((val) => val === "" || val === null || val === void 0 ? defaultValue : val, import_zod4.z.coerce.string().trim().nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.text.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.text.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.text.max", { label, max }) }).refine((val) => val === null || startsWith === void 0 || val.startsWith(startsWith), { message: t("common.text.startsWith", { label, startsWith }) }).refine((val) => val === null || endsWith === void 0 || val.endsWith(endsWith), { message: t("common.text.endsWith", { label, endsWith }) }).refine((val) => val === null || includes === void 0 || val.includes(includes), { message: t("common.text.includes", { label, includes }) }).refine((val) => val === null || regex === void 0 || regex.test(val), { message: t("common.text.invalid", { label, regex }) });
+  return schema;
+}
+
+// src/common/number.ts
+var import_zod5 = require("zod");
+function number(options) {
+  const { required = true, label, min, max, defaultValue } = options ?? {};
+  const schema = import_zod5.z.preprocess(
+    (val) => {
+      if (val === "" || val === void 0 || val === null) return defaultValue ?? null;
+      return typeof val === "string" ? Number(val) : val;
+    },
+    import_zod5.z.union([
+      import_zod5.z.number({
+        error: (issue) => {
+          if (issue.code === "invalid_type") return t("common.number.integer", { label });
+          return t("common.number.required", { label });
+        }
+      }),
+      import_zod5.z.null()
+    ])
+  ).refine((val) => !required || val !== null, { message: t("common.number.required", { label }) }).refine((val) => val === null || min === void 0 || val >= min, { message: t("common.number.min", { label, min }) }).refine((val) => val === null || max === void 0 || val <= max, { message: t("common.number.max", { label, max }) });
+  return schema;
+}
+
+// src/common/password.ts
+var import_zod6 = require("zod");
+function password(options) {
+  const { required = true, label, min, max, uppercase, lowercase, digits, special } = options ?? {};
+  const baseSchema = required ? import_zod6.z.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, import_zod6.z.coerce.string().trim()) : import_zod6.z.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, import_zod6.z.coerce.string().trim().nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.password.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.password.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.password.max", { label, max }) }).refine((val) => val === null || !uppercase || /[A-Z]/.test(val), { message: t("common.password.uppercase", { label }) }).refine((val) => val === null || !lowercase || /[a-z]/.test(val), { message: t("common.password.lowercase", { label }) }).refine((val) => val === null || !special || /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]+/.test(val), { message: t("common.password.special", { label }) }).refine((val) => val === null || !digits || /[0-9]/.test(val), { message: t("common.password.digits", { label }) });
+  return schema;
+}
+
+// src/common/integer.ts
+var import_zod7 = require("zod");
+function integer(options) {
+  const { required = true, label, min, max, defaultValue } = options ?? {};
+  const schema = import_zod7.z.preprocess(
+    (val) => {
+      if (val === "" || val === void 0 || val === null) return defaultValue ?? null;
+      return typeof val === "string" ? Number(val) : val;
+    },
+    import_zod7.z.union([
+      import_zod7.z.number({
+        error: (issue) => {
+          if (issue.code === "invalid_type") return t("common.integer.integer", { label });
+          return t("common.integer.required", { label });
+        }
+      }),
+      import_zod7.z.null()
+    ])
+  ).refine((val) => !required || val !== null, {
+    message: t("common.integer.required", { label })
+  }).refine((val) => val === null || Number.isInteger(val), {
+    message: t("common.integer.integer", { label })
+  }).refine((val) => val === null || min === void 0 || val >= min, {
+    message: t("common.integer.min", { label, min })
+  }).refine((val) => val === null || max === void 0 || val <= max, {
+    message: t("common.integer.max", { label, max })
+  });
+  return schema;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  boolean,
+  email,
+  getLocale,
+  integer,
+  number,
+  password,
+  setLocale,
+  text,
+  url
+});

package/dist/index.d.cts

@@ -0,0 +1,84 @@
+import { ZodBoolean, ZodNullable, ZodString, ZodNumber } from 'zod';
+
+type BooleanOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    defaultValue?: IsRequired extends true ? boolean : boolean | null;
+    shouldBe?: boolean;
+};
+type BooleanSchema<IsRequired extends boolean> = IsRequired extends true ? ZodBoolean : ZodNullable<ZodBoolean>;
+declare function boolean<IsRequired extends boolean = true>(options?: BooleanOptions<IsRequired>): BooleanSchema<IsRequired>;
+
+type EmailOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    domain?: string;
+    min?: number;
+    max?: number;
+    includes?: string;
+};
+type EmailSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function email<IsRequired extends boolean = true>(options?: EmailOptions<IsRequired>): EmailSchema<IsRequired>;
+
+type UrlOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    includes?: string;
+};
+type UrlSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function url<IsRequired extends boolean = true>(options?: UrlOptions<IsRequired>): UrlSchema<IsRequired>;
+
+type TextOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    startsWith?: string;
+    endsWith?: string;
+    includes?: string;
+    regex?: RegExp;
+    defaultValue?: IsRequired extends true ? string : string | null;
+};
+type TextSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function text<IsRequired extends boolean = true>(options?: TextOptions<IsRequired>): TextSchema<IsRequired>;
+
+type NumberOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    defaultValue?: IsRequired extends true ? number : number | null;
+};
+type NumberSchema<IsRequired extends boolean> = IsRequired extends true ? ZodNumber : ZodNullable<ZodNumber>;
+declare function number<IsRequired extends boolean = true>(options?: NumberOptions<IsRequired>): NumberSchema<IsRequired>;
+
+type PasswordOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    uppercase?: boolean;
+    lowercase?: boolean;
+    digits?: boolean;
+    special?: boolean;
+};
+type PasswordSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function password<IsRequired extends boolean = true>(options?: PasswordOptions<IsRequired>): PasswordSchema<IsRequired>;
+
+type IntegerOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    defaultValue?: IsRequired extends true ? number : number | null;
+};
+type IntegerSchema<IsRequired extends boolean> = IsRequired extends true ? ZodNumber : ZodNullable<ZodNumber>;
+declare function integer<IsRequired extends boolean = true>(options?: IntegerOptions<IsRequired>): IntegerSchema<IsRequired>;
+
+type Locale = "zh-TW" | "en";
+declare const setLocale: (locale: Locale) => void;
+declare const getLocale: () => Locale;
+
+export { type BooleanOptions, type BooleanSchema, type EmailOptions, type EmailSchema, type IntegerOptions, type IntegerSchema, type Locale, type NumberOptions, type NumberSchema, type PasswordOptions, type PasswordSchema, type TextOptions, type TextSchema, type UrlOptions, type UrlSchema, boolean, email, getLocale, integer, number, password, setLocale, text, url };

package/dist/index.d.ts

@@ -0,0 +1,84 @@
+import { ZodBoolean, ZodNullable, ZodString, ZodNumber } from 'zod';
+
+type BooleanOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    defaultValue?: IsRequired extends true ? boolean : boolean | null;
+    shouldBe?: boolean;
+};
+type BooleanSchema<IsRequired extends boolean> = IsRequired extends true ? ZodBoolean : ZodNullable<ZodBoolean>;
+declare function boolean<IsRequired extends boolean = true>(options?: BooleanOptions<IsRequired>): BooleanSchema<IsRequired>;
+
+type EmailOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    domain?: string;
+    min?: number;
+    max?: number;
+    includes?: string;
+};
+type EmailSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function email<IsRequired extends boolean = true>(options?: EmailOptions<IsRequired>): EmailSchema<IsRequired>;
+
+type UrlOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    includes?: string;
+};
+type UrlSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function url<IsRequired extends boolean = true>(options?: UrlOptions<IsRequired>): UrlSchema<IsRequired>;
+
+type TextOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    startsWith?: string;
+    endsWith?: string;
+    includes?: string;
+    regex?: RegExp;
+    defaultValue?: IsRequired extends true ? string : string | null;
+};
+type TextSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function text<IsRequired extends boolean = true>(options?: TextOptions<IsRequired>): TextSchema<IsRequired>;
+
+type NumberOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    defaultValue?: IsRequired extends true ? number : number | null;
+};
+type NumberSchema<IsRequired extends boolean> = IsRequired extends true ? ZodNumber : ZodNullable<ZodNumber>;
+declare function number<IsRequired extends boolean = true>(options?: NumberOptions<IsRequired>): NumberSchema<IsRequired>;
+
+type PasswordOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    uppercase?: boolean;
+    lowercase?: boolean;
+    digits?: boolean;
+    special?: boolean;
+};
+type PasswordSchema<IsRequired extends boolean> = IsRequired extends true ? ZodString : ZodNullable<ZodString>;
+declare function password<IsRequired extends boolean = true>(options?: PasswordOptions<IsRequired>): PasswordSchema<IsRequired>;
+
+type IntegerOptions<IsRequired extends boolean = true> = {
+    required?: IsRequired;
+    label: string;
+    min?: number;
+    max?: number;
+    defaultValue?: IsRequired extends true ? number : number | null;
+};
+type IntegerSchema<IsRequired extends boolean> = IsRequired extends true ? ZodNumber : ZodNullable<ZodNumber>;
+declare function integer<IsRequired extends boolean = true>(options?: IntegerOptions<IsRequired>): IntegerSchema<IsRequired>;
+
+type Locale = "zh-TW" | "en";
+declare const setLocale: (locale: Locale) => void;
+declare const getLocale: () => Locale;
+
+export { type BooleanOptions, type BooleanSchema, type EmailOptions, type EmailSchema, type IntegerOptions, type IntegerSchema, type Locale, type NumberOptions, type NumberSchema, type PasswordOptions, type PasswordSchema, type TextOptions, type TextSchema, type UrlOptions, type UrlSchema, boolean, email, getLocale, integer, number, password, setLocale, text, url };

package/dist/index.js

@@ -0,0 +1,308 @@
+// src/common/boolean.ts
+import { z } from "zod";
+
+// src/i18n/locales/zh-TW.json
+var zh_TW_default = {
+  common: {
+    boolean: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      shouldBe: {
+        true: "${label} \u5FC5\u9808\u70BA\u662F",
+        false: "${label} \u5FC5\u9808\u70BA\u5426"
+      }
+    },
+    email: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      includes: "${label} \u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      invalid: "${label} \u683C\u5F0F\u932F\u8AA4",
+      domain: "${label} \u5FC5\u9808\u70BA @${domain} \u7DB2\u57DF"
+    },
+    url: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      includes: "${label} \u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      invalid: "${label} \u683C\u5F0F\u932F\u8AA4"
+    },
+    password: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      uppercase: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u5927\u5BEB\u5B57\u6BCD",
+      lowercase: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u5C0F\u5BEB\u5B57\u6BCD",
+      digits: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u6578\u5B57",
+      special: "${label} \u5FC5\u9808\u5305\u542B\u81F3\u5C11\u4E00\u500B\u7279\u6B8A\u7B26\u865F"
+    },
+    number: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u6700\u5C0F\u503C ${min}",
+      max: "${label} \u6700\u5927\u503C ${max}"
+    },
+    id: {
+      required: "\u8ACB\u9078\u64C7 ${label}",
+      invalid: "${label} \u7121\u6548"
+    },
+    integer: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u6700\u5C0F\u503C ${min}",
+      max: "${label} \u6700\u5927\u503C ${max}",
+      integer: "${label} \u5FC5\u9808\u70BA\u6574\u6578"
+    },
+    float: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      float: "${label} \u5FC5\u9808\u70BA\u6D6E\u9EDE\u6578",
+      min: "${label} \u6700\u5C0F\u503C ${min}",
+      max: "${label} \u6700\u5927\u503C ${max}"
+    },
+    text: {
+      required: "\u8ACB\u8F38\u5165 ${label}",
+      min: "${label} \u9577\u5EA6\u81F3\u5C11 ${min} \u5B57\u5143",
+      max: "${label} \u9577\u5EA6\u6700\u591A ${max} \u5B57\u5143",
+      startsWith: "${label} \u5FC5\u9808\u4EE5\u300C${startsWith}\u300D\u958B\u982D",
+      endsWith: "${label} \u5FC5\u9808\u4EE5\u300C${endsWith}\u300D\u7D50\u5C3E",
+      includes: "${label} \u5FC5\u9808\u5305\u542B\u300C${includes}\u300D",
+      invalid: "${label} \u683C\u5F0F\u932F\u8AA4"
+    }
+  }
+};
+
+// src/i18n/locales/en.json
+var en_default = {
+  common: {
+    boolean: {
+      required: "${label} is required",
+      shouldBe: {
+        true: "${label} must be True",
+        false: "${label} must be False"
+      }
+    },
+    email: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      includes: "${label} must include ${includes}",
+      invalid: "${label} is invalid format",
+      domain: "${label} must be under the domain @${domain}"
+    },
+    url: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      includes: "${label} must include ${includes}",
+      invalid: "${label} is invalid format"
+    },
+    password: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      uppercase: "${label} must include at least one uppercase letter",
+      lowercase: "${label} must include at least one lowercase letter",
+      digits: "${label} must include at least one digit",
+      special: "${label} must include at least one special character"
+    },
+    number: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min}",
+      max: "${label} must be at most ${max}"
+    },
+    integer: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min}",
+      max: "${label} must be at most ${max}",
+      integer: "${label} must be an integer"
+    },
+    float: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min}",
+      max: "${label} must be at most ${max}",
+      float: "${label} must be an float"
+    },
+    text: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      startsWith: "${label} must start with ${startsWith}",
+      endsWith: "${label} must end with ${endsWith}",
+      includes: "${label} must include ${includes}",
+      invalid: "${label} is invalid format"
+    },
+    date: {
+      required: "${label} is required",
+      min: "${label} must be at least ${min} characters",
+      max: "${label} must be at most ${max} characters",
+      includes: "${label} must include ${includes}",
+      format: "${label} must be in ${format} format"
+    }
+  }
+};
+
+// src/config.ts
+var currentLocale = "zh-TW";
+var setLocale = (locale) => {
+  currentLocale = locale;
+};
+var getLocale = () => currentLocale;
+
+// src/i18n/index.ts
+var dicts = {
+  "zh-TW": zh_TW_default,
+  en: en_default
+};
+var t = (key, params = {}) => {
+  const locale = getLocale();
+  const dict = dicts[locale] || {};
+  const template = getNestedValue(dict, key) ?? key;
+  return template.replace(/\$\{(\w+)}/g, (_, k) => params[k] ?? "");
+};
+function getNestedValue(obj, path) {
+  const result = path.split(".").reduce((acc, part) => acc && typeof acc === "object" ? acc[part] : void 0, obj);
+  return typeof result === "string" ? result : void 0;
+}
+
+// src/common/boolean.ts
+function boolean(options) {
+  const { required = true, label, defaultValue = null, shouldBe } = options ?? {};
+  let result = z.preprocess(
+    (val) => {
+      if (val === "" || val === void 0 || val === null) return defaultValue;
+      if (val === "true" || val === 1 || val === "1") return true;
+      if (val === "false" || val === 0 || val === "0") return false;
+      return val;
+    },
+    z.union([z.literal(true), z.literal(false), z.literal(null)])
+  );
+  if (required && defaultValue === null) {
+    result = result.refine((val) => val !== null, { message: t("common.boolean.required", { label }) });
+  }
+  if (shouldBe === true) {
+    result = result.refine((val) => val === true, { message: t("common.boolean.shouldBe.true", { label }) });
+  } else if (shouldBe === false) {
+    result = result.refine((val) => val === false, { message: t("common.boolean.shouldBe.false", { label }) });
+  }
+  return result;
+}
+
+// src/common/email.ts
+import { z as z2 } from "zod";
+function email(options) {
+  const { required = true, label, domain, min, max, includes } = options ?? {};
+  const baseSchema = required ? z2.preprocess(
+    (val) => val === "" || val === null || val === void 0 ? null : val,
+    z2.email({
+      error: (issue) => {
+        if (issue.code === "invalid_type") return t("common.email.required", { label });
+        else if (issue.code === "invalid_format") return t("common.email.invalid", { label });
+        return t("common.email.invalid", { label });
+      }
+    })
+  ) : z2.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, z2.email({ message: t("common.email.invalid", { label }) }).nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.text.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.text.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.text.max", { label, max }) }).refine((val) => val === null || includes === void 0 || val.includes(includes), { message: t("common.text.includes", { label, includes }) }).refine(
+    (val) => {
+      if (val === null || domain === void 0) return true;
+      return val.split("@")[1]?.toLowerCase() === domain.toLowerCase();
+    },
+    { message: t("common.email.domain", { label, domain }) }
+  );
+  return schema;
+}
+
+// src/common/url.ts
+import { z as z3 } from "zod";
+function url(options) {
+  const { required = true, label, min, max, includes } = options ?? {};
+  const baseSchema = required ? z3.preprocess(
+    (val) => val === "" || val === null || val === void 0 ? null : val,
+    z3.url({
+      error: (issue) => {
+        if (issue.code === "invalid_type") return t("common.url.required", { label });
+        else if (issue.code === "invalid_format") return t("common.url.invalid", { label });
+        return t("common.url.invalid", { label });
+      }
+    })
+  ) : z3.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, z3.url({ message: t("common.url.invalid", { label }) }).nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.text.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.text.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.text.max", { label, max }) }).refine((val) => val === null || includes === void 0 || val.includes(includes), { message: t("common.text.includes", { label, includes }) });
+  return schema;
+}
+
+// src/common/text.ts
+import { z as z4 } from "zod";
+function text(options) {
+  const { required = true, label, min, max, startsWith, endsWith, includes, regex, defaultValue = null } = options ?? {};
+  const baseSchema = required ? z4.preprocess((val) => val === "" || val === null || val === void 0 ? defaultValue : val, z4.coerce.string().trim()) : z4.preprocess((val) => val === "" || val === null || val === void 0 ? defaultValue : val, z4.coerce.string().trim().nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.text.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.text.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.text.max", { label, max }) }).refine((val) => val === null || startsWith === void 0 || val.startsWith(startsWith), { message: t("common.text.startsWith", { label, startsWith }) }).refine((val) => val === null || endsWith === void 0 || val.endsWith(endsWith), { message: t("common.text.endsWith", { label, endsWith }) }).refine((val) => val === null || includes === void 0 || val.includes(includes), { message: t("common.text.includes", { label, includes }) }).refine((val) => val === null || regex === void 0 || regex.test(val), { message: t("common.text.invalid", { label, regex }) });
+  return schema;
+}
+
+// src/common/number.ts
+import { z as z5 } from "zod";
+function number(options) {
+  const { required = true, label, min, max, defaultValue } = options ?? {};
+  const schema = z5.preprocess(
+    (val) => {
+      if (val === "" || val === void 0 || val === null) return defaultValue ?? null;
+      return typeof val === "string" ? Number(val) : val;
+    },
+    z5.union([
+      z5.number({
+        error: (issue) => {
+          if (issue.code === "invalid_type") return t("common.number.integer", { label });
+          return t("common.number.required", { label });
+        }
+      }),
+      z5.null()
+    ])
+  ).refine((val) => !required || val !== null, { message: t("common.number.required", { label }) }).refine((val) => val === null || min === void 0 || val >= min, { message: t("common.number.min", { label, min }) }).refine((val) => val === null || max === void 0 || val <= max, { message: t("common.number.max", { label, max }) });
+  return schema;
+}
+
+// src/common/password.ts
+import { z as z6 } from "zod";
+function password(options) {
+  const { required = true, label, min, max, uppercase, lowercase, digits, special } = options ?? {};
+  const baseSchema = required ? z6.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, z6.coerce.string().trim()) : z6.preprocess((val) => val === "" || val === null || val === void 0 ? null : val, z6.coerce.string().trim().nullable());
+  const schema = baseSchema.refine((val) => required ? val !== "" && val !== "null" && val !== "undefined" : true, { message: t("common.password.required", { label }) }).refine((val) => val === null || min === void 0 || val.length >= min, { message: t("common.password.min", { label, min }) }).refine((val) => val === null || max === void 0 || val.length <= max, { message: t("common.password.max", { label, max }) }).refine((val) => val === null || !uppercase || /[A-Z]/.test(val), { message: t("common.password.uppercase", { label }) }).refine((val) => val === null || !lowercase || /[a-z]/.test(val), { message: t("common.password.lowercase", { label }) }).refine((val) => val === null || !special || /[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]+/.test(val), { message: t("common.password.special", { label }) }).refine((val) => val === null || !digits || /[0-9]/.test(val), { message: t("common.password.digits", { label }) });
+  return schema;
+}
+
+// src/common/integer.ts
+import { z as z7 } from "zod";
+function integer(options) {
+  const { required = true, label, min, max, defaultValue } = options ?? {};
+  const schema = z7.preprocess(
+    (val) => {
+      if (val === "" || val === void 0 || val === null) return defaultValue ?? null;
+      return typeof val === "string" ? Number(val) : val;
+    },
+    z7.union([
+      z7.number({
+        error: (issue) => {
+          if (issue.code === "invalid_type") return t("common.integer.integer", { label });
+          return t("common.integer.required", { label });
+        }
+      }),
+      z7.null()
+    ])
+  ).refine((val) => !required || val !== null, {
+    message: t("common.integer.required", { label })
+  }).refine((val) => val === null || Number.isInteger(val), {
+    message: t("common.integer.integer", { label })
+  }).refine((val) => val === null || min === void 0 || val >= min, {
+    message: t("common.integer.min", { label, min })
+  }).refine((val) => val === null || max === void 0 || val <= max, {
+    message: t("common.integer.max", { label, max })
+  });
+  return schema;
+}
+export {
+  boolean,
+  email,
+  getLocale,
+  integer,
+  number,
+  password,
+  setLocale,
+  text,
+  url
+};

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@hy_ong/zod-kit",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Zod Kit",
   "keywords": [
+    "hy_ong",
     "zod",
     "kit",
     "zod-kit"
@@ -20,8 +21,17 @@
   },
   "license": "ISC",
   "author": "Ong Hoe Yuan",
-  "type": "commonjs",
-  "main": "dist/index.js",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",
     "test": "vitest"
@@ -32,8 +42,10 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.32.0",
+    "@types/node": "^22.17.0",
     "eslint": "^9.32.0",
     "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.38.0",
     "vitest": "^3.2.4"