zod 3.25.68-beta.1 → 3.25.68

package/README.md

@@ -58,7 +58,7 @@
 Zod is a TypeScript-first validation library. Define a schema and parse some data with it. You'll get back a strongly typed, validated result.
 
 ```ts
-import { z } from "zod/v4";
+import * as z from "zod/v4";
 
 const User = z.object({
   name: z.string(),
@@ -104,7 +104,7 @@ npm install zod
 Before you can do anything else, you need to define a schema. For the purposes of this guide, we'll use a simple object schema.
 
 ```ts
-import { z } from "zod/v4";
+import * as z from "zod/v4";
 
 const Player = z.object({
   username: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zod",
-  "version": "3.25.68-beta.1",
+  "version": "3.25.68",
   "type": "module",
   "author": "Colin McDonnell <zod@colinhacks.com>",
   "description": "TypeScript-first schema declaration and validation library with static type inference",

package/v3/ZodError.cjs

@@ -40,6 +40,7 @@ class ZodError extends Error {
         };
         const actualProto = new.target.prototype;
         if (Object.setPrototypeOf) {
+            // eslint-disable-next-line ban/ban
             Object.setPrototypeOf(this, actualProto);
         }
         else {
@@ -76,6 +77,13 @@ class ZodError extends Error {
                         const terminal = i === issue.path.length - 1;
                         if (!terminal) {
                             curr[el] = curr[el] || { _errors: [] };
+                            // if (typeof el === "string") {
+                            //   curr[el] = curr[el] || { _errors: [] };
+                            // } else if (typeof el === "number") {
+                            //   const errorArray: any = [];
+                            //   errorArray._errors = [];
+                            //   curr[el] = curr[el] || errorArray;
+                            // }
                         }
                         else {
                             curr[el] = curr[el] || { _errors: [] };

package/v3/ZodError.js

@@ -36,6 +36,7 @@ export class ZodError extends Error {
         };
         const actualProto = new.target.prototype;
         if (Object.setPrototypeOf) {
+            // eslint-disable-next-line ban/ban
             Object.setPrototypeOf(this, actualProto);
         }
         else {
@@ -72,6 +73,13 @@ export class ZodError extends Error {
                         const terminal = i === issue.path.length - 1;
                         if (!terminal) {
                             curr[el] = curr[el] || { _errors: [] };
+                            // if (typeof el === "string") {
+                            //   curr[el] = curr[el] || { _errors: [] };
+                            // } else if (typeof el === "number") {
+                            //   const errorArray: any = [];
+                            //   errorArray._errors = [];
+                            //   curr[el] = curr[el] || errorArray;
+                            // }
                         }
                         else {
                             curr[el] = curr[el] || { _errors: [] };

package/v3/helpers/errorUtil.cjs

@@ -4,5 +4,6 @@ exports.errorUtil = void 0;
 var errorUtil;
 (function (errorUtil) {
     errorUtil.errToObj = (message) => typeof message === "string" ? { message } : message || {};
+    // biome-ignore lint:
     errorUtil.toString = (message) => typeof message === "string" ? message : message?.message;
 })(errorUtil || (exports.errorUtil = errorUtil = {}));

package/v3/helpers/errorUtil.js

@@ -1,5 +1,6 @@
 export var errorUtil;
 (function (errorUtil) {
     errorUtil.errToObj = (message) => typeof message === "string" ? { message } : message || {};
+    // biome-ignore lint:
     errorUtil.toString = (message) => typeof message === "string" ? message : message?.message;
 })(errorUtil || (errorUtil = {}));

package/v3/helpers/parseUtil.cjs

@@ -44,10 +44,10 @@ function addIssueToContext(ctx, issueData) {
         data: ctx.data,
         path: ctx.path,
         errorMaps: [
-            ctx.common.contextualErrorMap,
-            ctx.schemaErrorMap,
-            overrideMap,
-            overrideMap === en_js_1.default ? undefined : en_js_1.default,
+            ctx.common.contextualErrorMap, // contextual error map is first priority
+            ctx.schemaErrorMap, // then schema-bound map if available
+            overrideMap, // then global override map
+            overrideMap === en_js_1.default ? undefined : en_js_1.default, // then global default map
         ].filter((x) => !!x),
     });
     ctx.common.issues.push(issue);

package/v3/helpers/parseUtil.js

@@ -36,10 +36,10 @@ export function addIssueToContext(ctx, issueData) {
         data: ctx.data,
         path: ctx.path,
         errorMaps: [
-            ctx.common.contextualErrorMap,
-            ctx.schemaErrorMap,
-            overrideMap,
-            overrideMap === defaultErrorMap ? undefined : defaultErrorMap,
+            ctx.common.contextualErrorMap, // contextual error map is first priority
+            ctx.schemaErrorMap, // then schema-bound map if available
+            overrideMap, // then global override map
+            overrideMap === defaultErrorMap ? undefined : defaultErrorMap, // then global default map
         ].filter((x) => !!x),
     });
     ctx.common.issues.push(issue);

package/v3/helpers/util.cjs

@@ -30,8 +30,8 @@ var util;
             return obj[e];
         });
     };
-    util.objectKeys = typeof Object.keys === "function"
-        ? (obj) => Object.keys(obj)
+    util.objectKeys = typeof Object.keys === "function" // eslint-disable-line ban/ban
+        ? (obj) => Object.keys(obj) // eslint-disable-line ban/ban
         : (object) => {
             const keys = [];
             for (const key in object) {
@@ -49,7 +49,7 @@ var util;
         return undefined;
     };
     util.isInteger = typeof Number.isInteger === "function"
-        ? (val) => Number.isInteger(val)
+        ? (val) => Number.isInteger(val) // eslint-disable-line ban/ban
         : (val) => typeof val === "number" && Number.isFinite(val) && Math.floor(val) === val;
     function joinValues(array, separator = " | ") {
         return array.map((val) => (typeof val === "string" ? `'${val}'` : val)).join(separator);
@@ -67,7 +67,7 @@ var objectUtil;
     objectUtil.mergeShapes = (first, second) => {
         return {
             ...first,
-            ...second,
+            ...second, // second overwrites first
         };
     };
 })(objectUtil || (exports.objectUtil = objectUtil = {}));

package/v3/helpers/util.js

@@ -27,8 +27,8 @@ export var util;
             return obj[e];
         });
     };
-    util.objectKeys = typeof Object.keys === "function"
-        ? (obj) => Object.keys(obj)
+    util.objectKeys = typeof Object.keys === "function" // eslint-disable-line ban/ban
+        ? (obj) => Object.keys(obj) // eslint-disable-line ban/ban
         : (object) => {
             const keys = [];
             for (const key in object) {
@@ -46,7 +46,7 @@ export var util;
         return undefined;
     };
     util.isInteger = typeof Number.isInteger === "function"
-        ? (val) => Number.isInteger(val)
+        ? (val) => Number.isInteger(val) // eslint-disable-line ban/ban
         : (val) => typeof val === "number" && Number.isFinite(val) && Math.floor(val) === val;
     function joinValues(array, separator = " | ") {
         return array.map((val) => (typeof val === "string" ? `'${val}'` : val)).join(separator);
@@ -64,7 +64,7 @@ export var objectUtil;
     objectUtil.mergeShapes = (first, second) => {
         return {
             ...first,
-            ...second,
+            ...second, // second overwrites first
         };
     };
 })(objectUtil || (objectUtil = {}));

package/v3/standard-schema.d.cts

@@ -1,33 +1,102 @@
+/**
+ * The Standard Schema interface.
+ */
 export type StandardSchemaV1<Input = unknown, Output = Input> = {
+    /**
+     * The Standard Schema properties.
+     */
     readonly "~standard": StandardSchemaV1.Props<Input, Output>;
 };
 export declare namespace StandardSchemaV1 {
+    /**
+     * The Standard Schema properties interface.
+     */
     export interface Props<Input = unknown, Output = Input> {
+        /**
+         * The version number of the standard.
+         */
         readonly version: 1;
+        /**
+         * The vendor name of the schema library.
+         */
         readonly vendor: string;
+        /**
+         * Validates unknown input values.
+         */
         readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /**
+         * Inferred types associated with the schema.
+         */
         readonly types?: Types<Input, Output> | undefined;
     }
+    /**
+     * The result interface of the validate function.
+     */
     export type Result<Output> = SuccessResult<Output> | FailureResult;
+    /**
+     * The result interface if validation succeeds.
+     */
     export interface SuccessResult<Output> {
+        /**
+         * The typed output value.
+         */
         readonly value: Output;
+        /**
+         * The non-existent issues.
+         */
         readonly issues?: undefined;
     }
+    /**
+     * The result interface if validation fails.
+     */
     export interface FailureResult {
+        /**
+         * The issues of failed validation.
+         */
         readonly issues: ReadonlyArray<Issue>;
     }
+    /**
+     * The issue interface of the failure output.
+     */
     export interface Issue {
+        /**
+         * The error message of the issue.
+         */
         readonly message: string;
+        /**
+         * The path of the issue, if any.
+         */
         readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
     }
+    /**
+     * The path segment interface of the issue.
+     */
     export interface PathSegment {
+        /**
+         * The key representing a path segment.
+         */
         readonly key: PropertyKey;
     }
+    /**
+     * The Standard Schema types interface.
+     */
     export interface Types<Input = unknown, Output = Input> {
+        /**
+         * The input type of the schema.
+         */
         readonly input: Input;
+        /**
+         * The output type of the schema.
+         */
         readonly output: Output;
     }
+    /**
+     * Infers the input type of a Standard Schema.
+     */
     export type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+    /**
+     * Infers the output type of a Standard Schema.
+     */
     export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
     export {};
 }

package/v3/standard-schema.d.ts

@@ -1,33 +1,102 @@
+/**
+ * The Standard Schema interface.
+ */
 export type StandardSchemaV1<Input = unknown, Output = Input> = {
+    /**
+     * The Standard Schema properties.
+     */
     readonly "~standard": StandardSchemaV1.Props<Input, Output>;
 };
 export declare namespace StandardSchemaV1 {
+    /**
+     * The Standard Schema properties interface.
+     */
     export interface Props<Input = unknown, Output = Input> {
+        /**
+         * The version number of the standard.
+         */
         readonly version: 1;
+        /**
+         * The vendor name of the schema library.
+         */
         readonly vendor: string;
+        /**
+         * Validates unknown input values.
+         */
         readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        /**
+         * Inferred types associated with the schema.
+         */
         readonly types?: Types<Input, Output> | undefined;
     }
+    /**
+     * The result interface of the validate function.
+     */
     export type Result<Output> = SuccessResult<Output> | FailureResult;
+    /**
+     * The result interface if validation succeeds.
+     */
     export interface SuccessResult<Output> {
+        /**
+         * The typed output value.
+         */
         readonly value: Output;
+        /**
+         * The non-existent issues.
+         */
         readonly issues?: undefined;
     }
+    /**
+     * The result interface if validation fails.
+     */
     export interface FailureResult {
+        /**
+         * The issues of failed validation.
+         */
         readonly issues: ReadonlyArray<Issue>;
     }
+    /**
+     * The issue interface of the failure output.
+     */
     export interface Issue {
+        /**
+         * The error message of the issue.
+         */
         readonly message: string;
+        /**
+         * The path of the issue, if any.
+         */
         readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
     }
+    /**
+     * The path segment interface of the issue.
+     */
     export interface PathSegment {
+        /**
+         * The key representing a path segment.
+         */
         readonly key: PropertyKey;
     }
+    /**
+     * The Standard Schema types interface.
+     */
     export interface Types<Input = unknown, Output = Input> {
+        /**
+         * The input type of the schema.
+         */
         readonly input: Input;
+        /**
+         * The output type of the schema.
+         */
         readonly output: Output;
     }
+    /**
+     * Infers the input type of a Standard Schema.
+     */
     export type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+    /**
+     * Infers the output type of a Standard Schema.
+     */
     export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
     export {};
 }