zod 4.1.12 → 4.1.13

package/src/v4/mini/tests/functions.test.ts

@@ -1,43 +1,5 @@
 import { expect, test } from "vitest";
-// import * as z from "zod/v4/core";
 
 test("z.function", () => {
   expect(true).toEqual(true);
 });
-
-// test("z.function", () => {
-//   const a = z.function({
-//     args: z.tuple([z.string()]),
-//     returns: z.string(),
-//   });
-
-//   const myFunc = a.implement((name: string | number) => `Hello, ${name}!`);
-
-//   expect(myFunc("world")).toEqual("Hello, world!");
-//   expect(() => myFunc(123 as any)).toThrow();
-
-//   // this won't run
-//   () => {
-//     // @ts-expect-error
-//     const r = myFunc(123);
-//     expectTypeOf(r).toEqualTypeOf<string>();
-//   };
-// });
-
-// test("z.function async", async () => {
-//   const b = z.function({
-//     args: z.tuple([z.string()]).$check(async (_) => {}),
-//     returns: z.string().$check(async (_) => {}),
-//   });
-//   const myFuncAsync = b.implementAsync(async (name) => `Hello, ${name}!`);
-
-//   expect(await myFuncAsync("world")).toEqual("Hello, world!");
-//   expect(myFuncAsync(123 as any)).rejects.toThrow();
-
-//   // this won't run
-//   () => {
-//     // @ts-expect-error
-//     const r = myFuncAsync(123);
-//     expectTypeOf(r).toEqualTypeOf<Promise<string>>();
-//   };
-// });

package/src/v4/mini/tests/index.test.ts

@@ -296,6 +296,29 @@ test("z.record", () => {
   expect(() => z.parse(c, { a: "hello", b: "world" })).toThrow();
   // extra keys
   expect(() => z.parse(c, { a: "hello", b: "world", c: "world", d: "world" })).toThrow();
+
+  // literal union keys
+  const d = z.record(z.union([z.literal("a"), z.literal(0)]), z.string());
+  type d = z.output<typeof d>;
+  expectTypeOf<d>().toEqualTypeOf<Record<"a" | 0, string>>();
+  expect(z.parse(d, { a: "hello", 0: "world" })).toEqual({
+    a: "hello",
+    0: "world",
+  });
+
+  // TypeScript enum keys
+  enum Enum {
+    A = 0,
+    B = "hi",
+  }
+
+  const e = z.record(z.enum(Enum), z.string());
+  type e = z.output<typeof e>;
+  expectTypeOf<e>().toEqualTypeOf<Record<Enum, string>>();
+  expect(z.parse(e, { [Enum.A]: "hello", [Enum.B]: "world" })).toEqual({
+    [Enum.A]: "hello",
+    [Enum.B]: "world",
+  });
 });
 
 test("z.map", () => {
@@ -789,7 +812,7 @@ test("z.stringbool", () => {
 test("z.promise", async () => {
   const a = z.promise(z.string());
   type a = z.output<typeof a>;
-  expectTypeOf<a>().toEqualTypeOf<string>();
+  expectTypeOf<a>().toEqualTypeOf<Promise<string>>();
 
   expect(await z.safeParseAsync(a, Promise.resolve("hello"))).toMatchObject({
     success: true,

package/src/v4/mini/tests/string.test.ts

@@ -241,6 +241,38 @@ test("z.ipv6", () => {
   expect(() => z.parse(a, 123)).toThrow();
 });
 
+test("z.mac", () => {
+  const a = z.mac();
+  // valid mac
+  expect(z.parse(a, "00:1A:2B:3C:4D:5E")).toEqual("00:1A:2B:3C:4D:5E");
+  // invalid mac (dash delimiter not accepted by default)
+  expect(() => z.parse(a, "01-23-45-67-89-AB")).toThrow();
+  expect(() => z.parse(a, "00:1A:2B::4D:5E")).toThrow();
+  expect(() => z.parse(a, "00:1a-2B:3c-4D:5e")).toThrow();
+  expect(() => z.parse(a, "hello")).toThrow();
+  // wrong type
+  expect(() => z.parse(a, 123)).toThrow();
+});
+
+test("z.mac with custom delimiter", () => {
+  const a = z.mac({ delimiter: ":" });
+  // valid mac with colon
+  expect(z.parse(a, "00:1A:2B:3C:4D:5E")).toEqual("00:1A:2B:3C:4D:5E");
+  // invalid mac with dash
+  expect(() => z.parse(a, "00-1A-2B-3C-4D-5E")).toThrow();
+
+  const b = z.mac({ delimiter: "-" });
+  // valid mac with dash
+  expect(z.parse(b, "00-1A-2B-3C-4D-5E")).toEqual("00-1A-2B-3C-4D-5E");
+  // invalid mac with colon
+  expect(() => z.parse(b, "00:1A:2B:3C:4D:5E")).toThrow();
+
+  const c = z.mac({ delimiter: ":" });
+  // colon-only mac
+  expect(z.parse(c, "00:1A:2B:3C:4D:5E")).toEqual("00:1A:2B:3C:4D:5E");
+  expect(() => z.parse(c, "00-1A-2B-3C-4D-5E")).toThrow();
+});
+
 test("z.base64", () => {
   const a = z.base64();
   // valid base64

package/v3/ZodError.d.cts

@@ -12,10 +12,10 @@ export type typeToFlattenedError<T, U = string> = {
 export declare const ZodIssueCode: {
     custom: "custom";
     invalid_type: "invalid_type";
-    unrecognized_keys: "unrecognized_keys";
     too_big: "too_big";
     too_small: "too_small";
     not_multiple_of: "not_multiple_of";
+    unrecognized_keys: "unrecognized_keys";
     invalid_union: "invalid_union";
     invalid_literal: "invalid_literal";
     invalid_union_discriminator: "invalid_union_discriminator";

package/v3/ZodError.d.ts

@@ -12,10 +12,10 @@ export type typeToFlattenedError<T, U = string> = {
 export declare const ZodIssueCode: {
     custom: "custom";
     invalid_type: "invalid_type";
-    unrecognized_keys: "unrecognized_keys";
     too_big: "too_big";
     too_small: "too_small";
     not_multiple_of: "not_multiple_of";
+    unrecognized_keys: "unrecognized_keys";
     invalid_union: "invalid_union";
     invalid_literal: "invalid_literal";
     invalid_union_discriminator: "invalid_union_discriminator";

package/v4/classic/checks.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toUpperCase = exports.toLowerCase = exports.trim = exports.normalize = exports.overwrite = exports.mime = exports.property = exports.endsWith = exports.startsWith = exports.includes = exports.uppercase = exports.lowercase = exports.regex = exports.length = exports.minLength = exports.maxLength = exports.size = exports.minSize = exports.maxSize = exports.multipleOf = exports.nonnegative = exports.nonpositive = exports.negative = exports.positive = exports.gte = exports.gt = exports.lte = exports.lt = void 0;
+exports.slugify = exports.toUpperCase = exports.toLowerCase = exports.trim = exports.normalize = exports.overwrite = exports.mime = exports.property = exports.endsWith = exports.startsWith = exports.includes = exports.uppercase = exports.lowercase = exports.regex = exports.length = exports.minLength = exports.maxLength = exports.size = exports.minSize = exports.maxSize = exports.multipleOf = exports.nonnegative = exports.nonpositive = exports.negative = exports.positive = exports.gte = exports.gt = exports.lte = exports.lt = void 0;
 var index_js_1 = require("../core/index.cjs");
 Object.defineProperty(exports, "lt", { enumerable: true, get: function () { return index_js_1._lt; } });
 Object.defineProperty(exports, "lte", { enumerable: true, get: function () { return index_js_1._lte; } });
@@ -30,3 +30,4 @@ Object.defineProperty(exports, "normalize", { enumerable: true, get: function ()
 Object.defineProperty(exports, "trim", { enumerable: true, get: function () { return index_js_1._trim; } });
 Object.defineProperty(exports, "toLowerCase", { enumerable: true, get: function () { return index_js_1._toLowerCase; } });
 Object.defineProperty(exports, "toUpperCase", { enumerable: true, get: function () { return index_js_1._toUpperCase; } });
+Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return index_js_1._slugify; } });

package/v4/classic/checks.d.cts

@@ -1 +1 @@
-export { _lt as lt, _lte as lte, _gt as gt, _gte as gte, _positive as positive, _negative as negative, _nonpositive as nonpositive, _nonnegative as nonnegative, _multipleOf as multipleOf, _maxSize as maxSize, _minSize as minSize, _size as size, _maxLength as maxLength, _minLength as minLength, _length as length, _regex as regex, _lowercase as lowercase, _uppercase as uppercase, _includes as includes, _startsWith as startsWith, _endsWith as endsWith, _property as property, _mime as mime, _overwrite as overwrite, _normalize as normalize, _trim as trim, _toLowerCase as toLowerCase, _toUpperCase as toUpperCase, type $RefinementCtx as RefinementCtx, } from "../core/index.cjs";
+export { _lt as lt, _lte as lte, _gt as gt, _gte as gte, _positive as positive, _negative as negative, _nonpositive as nonpositive, _nonnegative as nonnegative, _multipleOf as multipleOf, _maxSize as maxSize, _minSize as minSize, _size as size, _maxLength as maxLength, _minLength as minLength, _length as length, _regex as regex, _lowercase as lowercase, _uppercase as uppercase, _includes as includes, _startsWith as startsWith, _endsWith as endsWith, _property as property, _mime as mime, _overwrite as overwrite, _normalize as normalize, _trim as trim, _toLowerCase as toLowerCase, _toUpperCase as toUpperCase, _slugify as slugify, type $RefinementCtx as RefinementCtx, } from "../core/index.cjs";

package/v4/classic/checks.d.ts

@@ -1 +1 @@
-export { _lt as lt, _lte as lte, _gt as gt, _gte as gte, _positive as positive, _negative as negative, _nonpositive as nonpositive, _nonnegative as nonnegative, _multipleOf as multipleOf, _maxSize as maxSize, _minSize as minSize, _size as size, _maxLength as maxLength, _minLength as minLength, _length as length, _regex as regex, _lowercase as lowercase, _uppercase as uppercase, _includes as includes, _startsWith as startsWith, _endsWith as endsWith, _property as property, _mime as mime, _overwrite as overwrite, _normalize as normalize, _trim as trim, _toLowerCase as toLowerCase, _toUpperCase as toUpperCase, type $RefinementCtx as RefinementCtx, } from "../core/index.js";
+export { _lt as lt, _lte as lte, _gt as gt, _gte as gte, _positive as positive, _negative as negative, _nonpositive as nonpositive, _nonnegative as nonnegative, _multipleOf as multipleOf, _maxSize as maxSize, _minSize as minSize, _size as size, _maxLength as maxLength, _minLength as minLength, _length as length, _regex as regex, _lowercase as lowercase, _uppercase as uppercase, _includes as includes, _startsWith as startsWith, _endsWith as endsWith, _property as property, _mime as mime, _overwrite as overwrite, _normalize as normalize, _trim as trim, _toLowerCase as toLowerCase, _toUpperCase as toUpperCase, _slugify as slugify, type $RefinementCtx as RefinementCtx, } from "../core/index.js";

package/v4/classic/checks.js

@@ -1 +1 @@
-export { _lt as lt, _lte as lte, _gt as gt, _gte as gte, _positive as positive, _negative as negative, _nonpositive as nonpositive, _nonnegative as nonnegative, _multipleOf as multipleOf, _maxSize as maxSize, _minSize as minSize, _size as size, _maxLength as maxLength, _minLength as minLength, _length as length, _regex as regex, _lowercase as lowercase, _uppercase as uppercase, _includes as includes, _startsWith as startsWith, _endsWith as endsWith, _property as property, _mime as mime, _overwrite as overwrite, _normalize as normalize, _trim as trim, _toLowerCase as toLowerCase, _toUpperCase as toUpperCase, } from "../core/index.js";
+export { _lt as lt, _lte as lte, _gt as gt, _gte as gte, _positive as positive, _negative as negative, _nonpositive as nonpositive, _nonnegative as nonnegative, _multipleOf as multipleOf, _maxSize as maxSize, _minSize as minSize, _size as size, _maxLength as maxLength, _minLength as minLength, _length as length, _regex as regex, _lowercase as lowercase, _uppercase as uppercase, _includes as includes, _startsWith as startsWith, _endsWith as endsWith, _property as property, _mime as mime, _overwrite as overwrite, _normalize as normalize, _trim as trim, _toLowerCase as toLowerCase, _toUpperCase as toUpperCase, _slugify as slugify, } from "../core/index.js";

package/v4/classic/schemas.cjs

@@ -23,8 +23,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZodTransform = exports.ZodFile = exports.ZodLiteral = exports.ZodEnum = exports.ZodSet = exports.ZodMap = exports.ZodRecord = exports.ZodTuple = exports.ZodIntersection = exports.ZodDiscriminatedUnion = exports.ZodUnion = exports.ZodObject = exports.ZodArray = exports.ZodDate = exports.ZodVoid = exports.ZodNever = exports.ZodUnknown = exports.ZodAny = exports.ZodNull = exports.ZodUndefined = exports.ZodSymbol = exports.ZodBigIntFormat = exports.ZodBigInt = exports.ZodBoolean = exports.ZodNumberFormat = exports.ZodNumber = exports.ZodCustomStringFormat = exports.ZodJWT = exports.ZodE164 = exports.ZodBase64URL = exports.ZodBase64 = exports.ZodCIDRv6 = exports.ZodCIDRv4 = exports.ZodIPv6 = exports.ZodIPv4 = exports.ZodKSUID = exports.ZodXID = exports.ZodULID = exports.ZodCUID2 = exports.ZodCUID = exports.ZodNanoID = exports.ZodEmoji = exports.ZodURL = exports.ZodUUID = exports.ZodGUID = exports.ZodEmail = exports.ZodStringFormat = exports.ZodString = exports._ZodString = exports.ZodType = void 0;
-exports.stringbool = exports.ZodCustom = exports.ZodFunction = exports.ZodPromise = exports.ZodLazy = exports.ZodTemplateLiteral = exports.ZodReadonly = exports.ZodCodec = exports.ZodPipe = exports.ZodNaN = exports.ZodCatch = exports.ZodSuccess = exports.ZodNonOptional = exports.ZodPrefault = exports.ZodDefault = exports.ZodNullable = exports.ZodOptional = void 0;
+exports.ZodFile = exports.ZodLiteral = exports.ZodEnum = exports.ZodSet = exports.ZodMap = exports.ZodRecord = exports.ZodTuple = exports.ZodIntersection = exports.ZodDiscriminatedUnion = exports.ZodUnion = exports.ZodObject = exports.ZodArray = exports.ZodDate = exports.ZodVoid = exports.ZodNever = exports.ZodUnknown = exports.ZodAny = exports.ZodNull = exports.ZodUndefined = exports.ZodSymbol = exports.ZodBigIntFormat = exports.ZodBigInt = exports.ZodBoolean = exports.ZodNumberFormat = exports.ZodNumber = exports.ZodCustomStringFormat = exports.ZodJWT = exports.ZodE164 = exports.ZodBase64URL = exports.ZodBase64 = exports.ZodCIDRv6 = exports.ZodCIDRv4 = exports.ZodIPv6 = exports.ZodMAC = exports.ZodIPv4 = exports.ZodKSUID = exports.ZodXID = exports.ZodULID = exports.ZodCUID2 = exports.ZodCUID = exports.ZodNanoID = exports.ZodEmoji = exports.ZodURL = exports.ZodUUID = exports.ZodGUID = exports.ZodEmail = exports.ZodStringFormat = exports.ZodString = exports._ZodString = exports.ZodType = void 0;
+exports.stringbool = exports.meta = exports.describe = exports.ZodCustom = exports.ZodFunction = exports.ZodPromise = exports.ZodLazy = exports.ZodTemplateLiteral = exports.ZodReadonly = exports.ZodCodec = exports.ZodPipe = exports.ZodNaN = exports.ZodCatch = exports.ZodSuccess = exports.ZodNonOptional = exports.ZodPrefault = exports.ZodDefault = exports.ZodNullable = exports.ZodOptional = exports.ZodTransform = void 0;
 exports.string = string;
 exports.email = email;
 exports.guid = guid;
@@ -42,6 +42,7 @@ exports.ulid = ulid;
 exports.xid = xid;
 exports.ksuid = ksuid;
 exports.ipv4 = ipv4;
+exports.mac = mac;
 exports.ipv6 = ipv6;
 exports.cidrv4 = cidrv4;
 exports.cidrv6 = cidrv6;
@@ -223,6 +224,7 @@ exports._ZodString = core.$constructor("_ZodString", (inst, def) => {
     inst.normalize = (...args) => inst.check(checks.normalize(...args));
     inst.toLowerCase = () => inst.check(checks.toLowerCase());
     inst.toUpperCase = () => inst.check(checks.toUpperCase());
+    inst.slugify = () => inst.check(checks.slugify());
 });
 exports.ZodString = core.$constructor("ZodString", (inst, def) => {
     core.$ZodString.init(inst, def);
@@ -377,6 +379,14 @@ exports.ZodIPv4 = core.$constructor("ZodIPv4", (inst, def) => {
 function ipv4(params) {
     return core._ipv4(exports.ZodIPv4, params);
 }
+exports.ZodMAC = core.$constructor("ZodMAC", (inst, def) => {
+    // ZodStringFormat.init(inst, def);
+    core.$ZodMAC.init(inst, def);
+    exports.ZodStringFormat.init(inst, def);
+});
+function mac(params) {
+    return core._mac(exports.ZodMAC, params);
+}
 exports.ZodIPv6 = core.$constructor("ZodIPv6", (inst, def) => {
     // ZodStringFormat.init(inst, def);
     core.$ZodIPv6.init(inst, def);
@@ -1118,6 +1128,9 @@ function refine(fn, _params = {}) {
 function superRefine(fn) {
     return core._superRefine(fn);
 }
+// Re-export describe and meta from core
+exports.describe = core.describe;
+exports.meta = core.meta;
 function _instanceof(cls, params = {
     error: `Input not instance of ${cls.name}`,
 }) {

package/v4/classic/schemas.d.cts

@@ -94,6 +94,7 @@ export interface _ZodString<T extends core.$ZodStringInternals<unknown> = core.$
     normalize(form?: "NFC" | "NFD" | "NFKC" | "NFKD" | (string & {})): this;
     toLowerCase(): this;
     toUpperCase(): this;
+    slugify(): this;
 }
 /** @internal */
 export declare const _ZodString: core.$constructor<_ZodString>;
@@ -223,6 +224,11 @@ export interface ZodIPv4 extends ZodStringFormat<"ipv4"> {
 }
 export declare const ZodIPv4: core.$constructor<ZodIPv4>;
 export declare function ipv4(params?: string | core.$ZodIPv4Params): ZodIPv4;
+export interface ZodMAC extends ZodStringFormat<"mac"> {
+    _zod: core.$ZodMACInternals;
+}
+export declare const ZodMAC: core.$constructor<ZodMAC>;
+export declare function mac(params?: string | core.$ZodMACParams): ZodMAC;
 export interface ZodIPv6 extends ZodStringFormat<"ipv6"> {
     _zod: core.$ZodIPv6Internals;
 }
@@ -649,6 +655,8 @@ export declare function check<O = unknown>(fn: core.CheckFn<O>): core.$ZodCheck<
 export declare function custom<O>(fn?: (data: unknown) => unknown, _params?: string | core.$ZodCustomParams | undefined): ZodCustom<O, O>;
 export declare function refine<T>(fn: (arg: NoInfer<T>) => util.MaybeAsync<unknown>, _params?: string | core.$ZodCustomParams): core.$ZodCheck<T>;
 export declare function superRefine<T>(fn: (arg: T, payload: core.$RefinementCtx<T>) => void | Promise<void>): core.$ZodCheck<T>;
+export declare const describe: typeof core.describe;
+export declare const meta: typeof core.meta;
 type ZodInstanceOfParams = core.Params<ZodCustom, core.$ZodIssueCustom, "type" | "check" | "checks" | "fn" | "abort" | "error" | "params" | "path">;
 declare function _instanceof<T extends typeof util.Class>(cls: T, params?: ZodInstanceOfParams): ZodCustom<InstanceType<T>, InstanceType<T>>;
 export { _instanceof as instanceof };

package/v4/classic/schemas.d.ts

@@ -94,6 +94,7 @@ export interface _ZodString<T extends core.$ZodStringInternals<unknown> = core.$
     normalize(form?: "NFC" | "NFD" | "NFKC" | "NFKD" | (string & {})): this;
     toLowerCase(): this;
     toUpperCase(): this;
+    slugify(): this;
 }
 /** @internal */
 export declare const _ZodString: core.$constructor<_ZodString>;
@@ -223,6 +224,11 @@ export interface ZodIPv4 extends ZodStringFormat<"ipv4"> {
 }
 export declare const ZodIPv4: core.$constructor<ZodIPv4>;
 export declare function ipv4(params?: string | core.$ZodIPv4Params): ZodIPv4;
+export interface ZodMAC extends ZodStringFormat<"mac"> {
+    _zod: core.$ZodMACInternals;
+}
+export declare const ZodMAC: core.$constructor<ZodMAC>;
+export declare function mac(params?: string | core.$ZodMACParams): ZodMAC;
 export interface ZodIPv6 extends ZodStringFormat<"ipv6"> {
     _zod: core.$ZodIPv6Internals;
 }
@@ -649,6 +655,8 @@ export declare function check<O = unknown>(fn: core.CheckFn<O>): core.$ZodCheck<
 export declare function custom<O>(fn?: (data: unknown) => unknown, _params?: string | core.$ZodCustomParams | undefined): ZodCustom<O, O>;
 export declare function refine<T>(fn: (arg: NoInfer<T>) => util.MaybeAsync<unknown>, _params?: string | core.$ZodCustomParams): core.$ZodCheck<T>;
 export declare function superRefine<T>(fn: (arg: T, payload: core.$RefinementCtx<T>) => void | Promise<void>): core.$ZodCheck<T>;
+export declare const describe: typeof core.describe;
+export declare const meta: typeof core.meta;
 type ZodInstanceOfParams = core.Params<ZodCustom, core.$ZodIssueCustom, "type" | "check" | "checks" | "fn" | "abort" | "error" | "params" | "path">;
 declare function _instanceof<T extends typeof util.Class>(cls: T, params?: ZodInstanceOfParams): ZodCustom<InstanceType<T>, InstanceType<T>>;
 export { _instanceof as instanceof };

package/v4/classic/schemas.js

@@ -106,6 +106,7 @@ export const _ZodString = /*@__PURE__*/ core.$constructor("_ZodString", (inst, d
     inst.normalize = (...args) => inst.check(checks.normalize(...args));
     inst.toLowerCase = () => inst.check(checks.toLowerCase());
     inst.toUpperCase = () => inst.check(checks.toUpperCase());
+    inst.slugify = () => inst.check(checks.slugify());
 });
 export const ZodString = /*@__PURE__*/ core.$constructor("ZodString", (inst, def) => {
     core.$ZodString.init(inst, def);
@@ -260,6 +261,14 @@ export const ZodIPv4 = /*@__PURE__*/ core.$constructor("ZodIPv4", (inst, def) =>
 export function ipv4(params) {
     return core._ipv4(ZodIPv4, params);
 }
+export const ZodMAC = /*@__PURE__*/ core.$constructor("ZodMAC", (inst, def) => {
+    // ZodStringFormat.init(inst, def);
+    core.$ZodMAC.init(inst, def);
+    ZodStringFormat.init(inst, def);
+});
+export function mac(params) {
+    return core._mac(ZodMAC, params);
+}
 export const ZodIPv6 = /*@__PURE__*/ core.$constructor("ZodIPv6", (inst, def) => {
     // ZodStringFormat.init(inst, def);
     core.$ZodIPv6.init(inst, def);
@@ -1007,6 +1016,9 @@ export function refine(fn, _params = {}) {
 export function superRefine(fn) {
     return core._superRefine(fn);
 }
+// Re-export describe and meta from core
+export const describe = core.describe;
+export const meta = core.meta;
 function _instanceof(cls, params = {
     error: `Input not instance of ${cls.name}`,
 }) {

package/v4/core/api.cjs

@@ -42,6 +42,7 @@ exports._xid = _xid;
 exports._ksuid = _ksuid;
 exports._ipv4 = _ipv4;
 exports._ipv6 = _ipv6;
+exports._mac = _mac;
 exports._cidrv4 = _cidrv4;
 exports._cidrv6 = _cidrv6;
 exports._base64 = _base64;
@@ -109,6 +110,7 @@ exports._normalize = _normalize;
 exports._trim = _trim;
 exports._toLowerCase = _toLowerCase;
 exports._toUpperCase = _toUpperCase;
+exports._slugify = _slugify;
 exports._array = _array;
 exports._union = _union;
 exports._discriminatedUnion = _discriminatedUnion;
@@ -137,9 +139,12 @@ exports._custom = _custom;
 exports._refine = _refine;
 exports._superRefine = _superRefine;
 exports._check = _check;
+exports.describe = describe;
+exports.meta = meta;
 exports._stringbool = _stringbool;
 exports._stringFormat = _stringFormat;
 const checks = __importStar(require("./checks.cjs"));
+const registries = __importStar(require("./registries.cjs"));
 const schemas = __importStar(require("./schemas.cjs"));
 const util = __importStar(require("./util.cjs"));
 function _string(Class, params) {
@@ -302,6 +307,15 @@ function _ipv6(Class, params) {
         ...util.normalizeParams(params),
     });
 }
+function _mac(Class, params) {
+    return new Class({
+        type: "string",
+        format: "mac",
+        check: "string_format",
+        abort: false,
+        ...util.normalizeParams(params),
+    });
+}
 function _cidrv4(Class, params) {
     return new Class({
         type: "string",
@@ -742,6 +756,10 @@ function _toLowerCase() {
 function _toUpperCase() {
     return _overwrite((input) => input.toUpperCase());
 }
+// slugify
+function _slugify() {
+    return _overwrite((input) => util.slugify(input));
+}
 function _array(Class, element, params) {
     return new Class({
         type: "array",
@@ -989,6 +1007,28 @@ function _check(fn, params) {
     ch._zod.check = fn;
     return ch;
 }
+function describe(description) {
+    const ch = new checks.$ZodCheck({ check: "describe" });
+    ch._zod.onattach = [
+        (inst) => {
+            const existing = registries.globalRegistry.get(inst) ?? {};
+            registries.globalRegistry.add(inst, { ...existing, description });
+        },
+    ];
+    ch._zod.check = () => { }; // no-op check
+    return ch;
+}
+function meta(metadata) {
+    const ch = new checks.$ZodCheck({ check: "meta" });
+    ch._zod.onattach = [
+        (inst) => {
+            const existing = registries.globalRegistry.get(inst) ?? {};
+            registries.globalRegistry.add(inst, { ...existing, ...metadata });
+        },
+    ];
+    ch._zod.check = () => { }; // no-op check
+    return ch;
+}
 function _stringbool(Classes, _params) {
     const params = util.normalizeParams(_params);
     let truthyArray = params.truthy ?? ["true", "1", "yes", "on", "y", "enabled"];

package/v4/core/api.d.cts

@@ -1,6 +1,7 @@
 import * as checks from "./checks.cjs";
 import type * as core from "./core.cjs";
 import type * as errors from "./errors.cjs";
+import * as registries from "./registries.cjs";
 import * as schemas from "./schemas.cjs";
 import * as util from "./util.cjs";
 export type Params<T extends schemas.$ZodType | checks.$ZodCheck, IssueTypes extends errors.$ZodIssueBase, OmitKeys extends keyof T["_zod"]["def"] = never> = util.Flatten<Partial<util.EmptyToNever<Omit<T["_zod"]["def"], OmitKeys> & ([IssueTypes] extends [never] ? {} : {
@@ -69,6 +70,9 @@ export declare function _ipv4<T extends schemas.$ZodIPv4>(Class: util.SchemaClas
 export type $ZodIPv6Params = StringFormatParams<schemas.$ZodIPv6, "pattern" | "when" | "version">;
 export type $ZodCheckIPv6Params = CheckStringFormatParams<schemas.$ZodIPv6, "pattern" | "when" | "version">;
 export declare function _ipv6<T extends schemas.$ZodIPv6>(Class: util.SchemaClass<T>, params?: string | $ZodIPv6Params | $ZodCheckIPv6Params): T;
+export type $ZodMACParams = StringFormatParams<schemas.$ZodMAC, "pattern" | "when">;
+export type $ZodCheckMACParams = CheckStringFormatParams<schemas.$ZodMAC, "pattern" | "when">;
+export declare function _mac<T extends schemas.$ZodMAC>(Class: util.SchemaClass<T>, params?: string | $ZodMACParams | $ZodCheckMACParams): T;
 export type $ZodCIDRv4Params = StringFormatParams<schemas.$ZodCIDRv4, "pattern" | "when">;
 export type $ZodCheckCIDRv4Params = CheckStringFormatParams<schemas.$ZodCIDRv4, "pattern" | "when">;
 export declare function _cidrv4<T extends schemas.$ZodCIDRv4>(Class: util.SchemaClass<T>, params?: string | $ZodCIDRv4Params | $ZodCheckCIDRv4Params): T;
@@ -198,6 +202,7 @@ export declare function _normalize(form?: "NFC" | "NFD" | "NFKC" | "NFKD" | (str
 export declare function _trim(): checks.$ZodCheckOverwrite<string>;
 export declare function _toLowerCase(): checks.$ZodCheckOverwrite<string>;
 export declare function _toUpperCase(): checks.$ZodCheckOverwrite<string>;
+export declare function _slugify(): checks.$ZodCheckOverwrite<string>;
 export type $ZodArrayParams = TypeParams<schemas.$ZodArray, "element">;
 export declare function _array<T extends schemas.$ZodType>(Class: util.SchemaClass<schemas.$ZodArray>, element: T, params?: string | $ZodArrayParams): schemas.$ZodArray<T>;
 export type $ZodObjectParams = TypeParams<schemas.$ZodObject, "shape" | "catchall">;
@@ -277,6 +282,8 @@ export interface $RefinementCtx<T = unknown> extends schemas.ParsePayload<T> {
 }
 export declare function _superRefine<T>(fn: (arg: T, payload: $RefinementCtx<T>) => void | Promise<void>): checks.$ZodCheck<T>;
 export declare function _check<O = unknown>(fn: schemas.CheckFn<O>, params?: string | $ZodCustomParams): checks.$ZodCheck<O>;
+export declare function describe<T>(description: string): checks.$ZodCheck<T>;
+export declare function meta<T>(metadata: registries.GlobalMeta): checks.$ZodCheck<T>;
 export interface $ZodStringBoolParams extends TypeParams {
     truthy?: string[];
     falsy?: string[];

package/v4/core/api.d.ts

@@ -1,6 +1,7 @@
 import * as checks from "./checks.js";
 import type * as core from "./core.js";
 import type * as errors from "./errors.js";
+import * as registries from "./registries.js";
 import * as schemas from "./schemas.js";
 import * as util from "./util.js";
 export type Params<T extends schemas.$ZodType | checks.$ZodCheck, IssueTypes extends errors.$ZodIssueBase, OmitKeys extends keyof T["_zod"]["def"] = never> = util.Flatten<Partial<util.EmptyToNever<Omit<T["_zod"]["def"], OmitKeys> & ([IssueTypes] extends [never] ? {} : {
@@ -69,6 +70,9 @@ export declare function _ipv4<T extends schemas.$ZodIPv4>(Class: util.SchemaClas
 export type $ZodIPv6Params = StringFormatParams<schemas.$ZodIPv6, "pattern" | "when" | "version">;
 export type $ZodCheckIPv6Params = CheckStringFormatParams<schemas.$ZodIPv6, "pattern" | "when" | "version">;
 export declare function _ipv6<T extends schemas.$ZodIPv6>(Class: util.SchemaClass<T>, params?: string | $ZodIPv6Params | $ZodCheckIPv6Params): T;
+export type $ZodMACParams = StringFormatParams<schemas.$ZodMAC, "pattern" | "when">;
+export type $ZodCheckMACParams = CheckStringFormatParams<schemas.$ZodMAC, "pattern" | "when">;
+export declare function _mac<T extends schemas.$ZodMAC>(Class: util.SchemaClass<T>, params?: string | $ZodMACParams | $ZodCheckMACParams): T;
 export type $ZodCIDRv4Params = StringFormatParams<schemas.$ZodCIDRv4, "pattern" | "when">;
 export type $ZodCheckCIDRv4Params = CheckStringFormatParams<schemas.$ZodCIDRv4, "pattern" | "when">;
 export declare function _cidrv4<T extends schemas.$ZodCIDRv4>(Class: util.SchemaClass<T>, params?: string | $ZodCIDRv4Params | $ZodCheckCIDRv4Params): T;
@@ -198,6 +202,7 @@ export declare function _normalize(form?: "NFC" | "NFD" | "NFKC" | "NFKD" | (str
 export declare function _trim(): checks.$ZodCheckOverwrite<string>;
 export declare function _toLowerCase(): checks.$ZodCheckOverwrite<string>;
 export declare function _toUpperCase(): checks.$ZodCheckOverwrite<string>;
+export declare function _slugify(): checks.$ZodCheckOverwrite<string>;
 export type $ZodArrayParams = TypeParams<schemas.$ZodArray, "element">;
 export declare function _array<T extends schemas.$ZodType>(Class: util.SchemaClass<schemas.$ZodArray>, element: T, params?: string | $ZodArrayParams): schemas.$ZodArray<T>;
 export type $ZodObjectParams = TypeParams<schemas.$ZodObject, "shape" | "catchall">;
@@ -277,6 +282,8 @@ export interface $RefinementCtx<T = unknown> extends schemas.ParsePayload<T> {
 }
 export declare function _superRefine<T>(fn: (arg: T, payload: $RefinementCtx<T>) => void | Promise<void>): checks.$ZodCheck<T>;
 export declare function _check<O = unknown>(fn: schemas.CheckFn<O>, params?: string | $ZodCustomParams): checks.$ZodCheck<O>;
+export declare function describe<T>(description: string): checks.$ZodCheck<T>;
+export declare function meta<T>(metadata: registries.GlobalMeta): checks.$ZodCheck<T>;
 export interface $ZodStringBoolParams extends TypeParams {
     truthy?: string[];
     falsy?: string[];

package/v4/core/api.js

@@ -1,4 +1,5 @@
 import * as checks from "./checks.js";
+import * as registries from "./registries.js";
 import * as schemas from "./schemas.js";
 import * as util from "./util.js";
 export function _string(Class, params) {
@@ -161,6 +162,15 @@ export function _ipv6(Class, params) {
         ...util.normalizeParams(params),
     });
 }
+export function _mac(Class, params) {
+    return new Class({
+        type: "string",
+        format: "mac",
+        check: "string_format",
+        abort: false,
+        ...util.normalizeParams(params),
+    });
+}
 export function _cidrv4(Class, params) {
     return new Class({
         type: "string",
@@ -607,6 +617,10 @@ export function _toLowerCase() {
 export function _toUpperCase() {
     return _overwrite((input) => input.toUpperCase());
 }
+// slugify
+export function _slugify() {
+    return _overwrite((input) => util.slugify(input));
+}
 export function _array(Class, element, params) {
     return new Class({
         type: "array",
@@ -854,6 +868,28 @@ export function _check(fn, params) {
     ch._zod.check = fn;
     return ch;
 }
+export function describe(description) {
+    const ch = new checks.$ZodCheck({ check: "describe" });
+    ch._zod.onattach = [
+        (inst) => {
+            const existing = registries.globalRegistry.get(inst) ?? {};
+            registries.globalRegistry.add(inst, { ...existing, description });
+        },
+    ];
+    ch._zod.check = () => { }; // no-op check
+    return ch;
+}
+export function meta(metadata) {
+    const ch = new checks.$ZodCheck({ check: "meta" });
+    ch._zod.onattach = [
+        (inst) => {
+            const existing = registries.globalRegistry.get(inst) ?? {};
+            registries.globalRegistry.add(inst, { ...existing, ...metadata });
+        },
+    ];
+    ch._zod.check = () => { }; // no-op check
+    return ch;
+}
 export function _stringbool(Classes, _params) {
     const params = util.normalizeParams(_params);
     let truthyArray = params.truthy ?? ["true", "1", "yes", "on", "y", "enabled"];

package/v4/core/core.cjs

@@ -9,21 +9,30 @@ exports.NEVER = Object.freeze({
 });
 function $constructor(name, initializer, params) {
     function init(inst, def) {
-        var _a;
-        Object.defineProperty(inst, "_zod", {
-            value: inst._zod ?? {},
-            enumerable: false,
-        });
-        (_a = inst._zod).traits ?? (_a.traits = new Set());
+        if (!inst._zod) {
+            Object.defineProperty(inst, "_zod", {
+                value: {
+                    def,
+                    constr: _,
+                    traits: new Set(),
+                },
+                enumerable: false,
+            });
+        }
+        if (inst._zod.traits.has(name)) {
+            return;
+        }
         inst._zod.traits.add(name);
         initializer(inst, def);
         // support prototype modifications
-        for (const k in _.prototype) {
-            if (!(k in inst))
-                Object.defineProperty(inst, k, { value: _.prototype[k].bind(inst) });
+        const proto = _.prototype;
+        const keys = Object.keys(proto);
+        for (let i = 0; i < keys.length; i++) {
+            const k = keys[i];
+            if (!(k in inst)) {
+                inst[k] = proto[k].bind(inst);
+            }
         }
-        inst._zod.constr = _;
-        inst._zod.def = def;
     }
     // doesn't work if Parent has a constructor with arguments
     const Parent = params?.Parent ?? Object;

package/v4/core/core.js

@@ -4,21 +4,30 @@ export const NEVER = Object.freeze({
 });
 export /*@__NO_SIDE_EFFECTS__*/ function $constructor(name, initializer, params) {
     function init(inst, def) {
-        var _a;
-        Object.defineProperty(inst, "_zod", {
-            value: inst._zod ?? {},
-            enumerable: false,
-        });
-        (_a = inst._zod).traits ?? (_a.traits = new Set());
+        if (!inst._zod) {
+            Object.defineProperty(inst, "_zod", {
+                value: {
+                    def,
+                    constr: _,
+                    traits: new Set(),
+                },
+                enumerable: false,
+            });
+        }
+        if (inst._zod.traits.has(name)) {
+            return;
+        }
         inst._zod.traits.add(name);
         initializer(inst, def);
         // support prototype modifications
-        for (const k in _.prototype) {
-            if (!(k in inst))
-                Object.defineProperty(inst, k, { value: _.prototype[k].bind(inst) });
+        const proto = _.prototype;
+        const keys = Object.keys(proto);
+        for (let i = 0; i < keys.length; i++) {
+            const k = keys[i];
+            if (!(k in inst)) {
+                inst[k] = proto[k].bind(inst);
+            }
         }
-        inst._zod.constr = _;
-        inst._zod.def = def;
     }
     // doesn't work if Parent has a constructor with arguments
     const Parent = params?.Parent ?? Object;