Zod

This release introduces improvements to mini treeshaking and documents the deprecation of the 'message' symbol.

This release introduces patternProperties support for looseRecord and improves documentation, while removing the .refine() method from ZodMiniType and dropping ISO time in fromJSONSchema.

Version 4.3.3 release containing a single commit update.

Version 4.3.2 is a maintenance release that removes the Juno integration and refines strictObject validation within intersections.

This release introduces support for non-overwriting extends when using refinements, improving how configurations or schemas are merged.

Zod 4.x introduces major features including JSON Schema to Zod conversion, exclusive unions (xor), exact optional properties, and improved intersection logic for strict objects.

Version 4.2.1 is a maintenance release containing a single commit.

This release introduces native JSON Schema interoperability with z.fromJSONSchema() and .toJSONSchema(), alongside new schema types like z.xor() and z.looseRecord().

Zod v4.1.13 introduces MAC address validation, z.meta/z.describe, and significant performance optimizations for initialization. It also addresses several edge-case bugs in records, tuples, and localization.

Version 4.1.12 focuses on bug fixes for ZodError flattening, internal error type refactoring, and significant updates to the ecosystem documentation.

Version 4.1.11 is a maintenance release identified by commit 2bed4b3.

Version 4.1.10 is a patch release that addresses a bug in shape caching.

This release updates the zshy dependency and publishes zod version 4.1.9.

Version 4.1.8 is a maintenance release that switches an internal implementation back to using WeakMap.

Release 4.1.7 focuses on expanding locale support (Lithuanian, Georgian), fixing CIDRv6 validation logic, and ensuring array defaults are shallow-cloned. It also includes significant documentation improvements and ecosystem updates.

Version 4.1.5 updates the z.function() type signature to allow array inputs and includes documentation updates.

Version 4.1.4 is a patch release focusing on fixing OpenAPI 3.0 schema generation for null values in tuples and updating installation documentation.

Version 4.1.3 focuses on fixing JSON Schema generation bugs for OpenAPI 3.0 and Draft-7, while also removing the stringToBoolean utility.

Release 4.1.2 focuses on fixing OpenAPI 3.0 schema generation for record tuples and improving codec documentation.

Version 4.1.1 introduces new methods and image support, alongside documentation improvements and a sidebar cleanup for codecs.

Zod 4.1 introduces Codecs for bi-directional data transformation and .safeExtend() for type-safe object extensions that preserve refinements. It also adds a new z.hash() validator and strongly-typed decode/encode methods.

Version 4.0.17 introduces a new blog feature and includes a fix for issue #5073.

Version 4.0.16 introduces a new discriminator generic and includes several bug fixes related to keyof enum returns, POJO cloning during defaulting, and documentation site navigation.

Version 4.0.15 addresses recursive initialization errors in the check() method and refines TypeScript type definitions by removing redundant Required wrappers.

Version 4.0.14 introduces JSON Schema draft-04 support, improves tuple recursive inference, and resolves an infinite loop bug in defineLazy.

Version 4.0.13 addresses a bug related to the interaction between optional types and pipe operator syntax.

Version 4.0.12 focuses on documentation improvements, including the addition of LLM-readable text files and new guides for JWT and property validation.

This release introduces the Yoruba (yo) locale, updates the Zod dependency to version 4.0.11, and includes minor documentation fixes.

Release v4.0.10 focuses on documentation improvements for v3 and v4, including the addition of the Zod Playground and various minor bug fixes.

Version 4.0.9 is a maintenance release containing a single commit (PR #4970).

This release includes a bug fix for issue #4961.

Version 4.0.7 fixes a bug in ZodPipe where parsing would continue even after validation issues were identified.

Zod v4.0.6 introduces new Icelandic, Bulgarian, and Danish translations, fixes literal escaping bugs, and refines the catch input type. It also updates documentation for RFC 9562 and provides resources for Zod 3 to Zod 4 migration.

Version 4.0.5 introduces support for pipe syntax within discriminated unions, resolving issue #4856.

This release introduces a ZodFirstPartyTypeKind stub to resolve module resolution errors encountered when using zod-to-json-schema.

This release removes the global File interface and fixes JSR provenance issues across versions 4.0.2 and 4.0.3.

Zod 4.0.0 is officially released on npm, promoting the stable v4 subpaths to the primary package exports with no code changes from the latest 3.25.x release.

Version 3.25.76 is a maintenance release focusing on internal cleanup of the $ZodRegistry and documentation corrections for error formatting.

This release addresses a bug in the toJSONSchema function specifically regarding the handling of undefined types.

Version 3.25.74 introduces support for partial records.

Version 3.25.73 is a maintenance release containing a single commit (1021d3c).

Version 3.25.72 introduces Esperanto locale support and includes bug fixes for schema optionality and symbol re-exports.

This release updates the project structure by moving the source code into a dedicated /src directory.

Version 3.25.70 focuses on documentation updates, including a new ecosystem listing on the homepage and the addition of svelte-jsonschema-form to integrations.

Version 3.25.69 introduces an 'exact' field to size-related validation issues and includes internal improvements to the release workflow and default value handling.

Release 3.25.68 introduces z.stringFormat(), removes the 'example' and 'examples' properties, and updates internal dependencies and documentation regarding treeshaking.

Version 3.25.67 introduces a generic $ZodLiteralDef for better type handling and resolves a race condition bug.

This release updates the default behavior of ZodObject to $strip and includes documentation improvements and minor bug fixes for the website.

Version 3.25.65 introduces catchall support for zod-mini, removes deprecated chalk types, and includes minor documentation fixes for template literals.

This maintenance release focuses on bug fixes for the $strip utility and mime pathing, while improving environment compatibility by safely checking for stack trace APIs.

Version 3.25.63 introduces improved ISO date parsing with support for hours-only offsets and updates the husky development dependency to v9.

Release 3.25.62 focuses on refining JSON schema types by removing 'undefined' from their definitions.

Version 3.25.61 introduces looser signatures for index signature shapes and includes minor test fixes.

No release notes provided.

This release focuses on internal code refactoring, formatting fixes, and enhancements to JSON Schema typing.

This release introduces Pashto locale support, improves Japanese translations, and enhances type safety for the .meta() function. It also expands the ecosystem documentation with Zod Sockets and SvelteKit Superforms.

Version 3.25.57 introduces support for ReadonlyArrays in z.literal and includes several bug fixes related to error instances and type checks.

This release consists of a single commit updating the version to 3.25.56.

Version 3.25.55 is a maintenance release containing a single commit.

This maintenance release addresses a cross-realm object validation bug and resolves a TypeScript-related generic assignability issue.

Version 3.25.53 introduces internal updates to the zod mini implementation.

Version 3.25.52 includes a fix for JSON handling and introduces a new test case for deferred self-recursion.

Version 3.25.51 focuses on internal standardization of string formats and improvements to documentation and generic type testing.

This release focuses on improving error reporting by flattening deep error structures and ensuring inclusive boundary reporting for length validation.

This release updates z.custom to treat validation issues as fatal and includes several documentation fixes and minor feature enhancements for regex and enums.

Version 3.25.48 is a maintenance release that removes a debugging console statement from the ZodDiscriminatedUnion internal logic.

Version 3.25.47 is a maintenance release that addresses a bug related to excessively deep processing or recursion.

Version 3.25.46 focuses on improving error clarity for discriminated unions and fixing a specific bug related to branded types in records.

Version 3.25.45 focuses on bug fixes for JSONSchema enum generation and resolving ZodType assignability issues.

Version 3.25.44 focuses on improving type safety and stability by refining input/output depth handling and broadening metadata type definitions.

This release focuses on fixing type inference within the ZodMiniType check method and improving declaration file stability, while also introducing the Express Zod API to the ecosystem.

Version 3.25.42 introduces improvements to Next.js tree shaking to optimize build performance and bundle size.

Version 3.25.41 is a maintenance release focusing on portability fixes and documentation updates regarding nullability.

This release focuses on improving JSON Schema generation for File types and intersections, specifically targeting better compatibility with OpenAPI standards.

Version 3.25.39 introduces support for array-based function inputs.

Version 3.25.38 is a minor update that includes the addition of new tests.

Version 3.25.37 introduces improvements to type inference within the z.function implementation and adds a major version section to the documentation.

Version 3.25.36 introduces support for arbitrary strings in JWT algorithm specifications.

Version 3.25.35 improves discriminated union handling, fixes the isPlainObject utility, and removes default values from JSON Schemas for transforming schemas.

Release 3.25.34 focuses on refining type inference for preprocessing, optimizing transform execution, and fixing documentation typos.

This release introduces support for Khmer, Swedish, Dutch, and Traditional Chinese locales alongside several documentation improvements and minor bug fixes for schema shape validation.

This release introduces support for multiple string patterns in JSON Schema generation and fixes issues related to default and prefault object handling.

Version 3.25.31 introduces support for custom messages in stringbool validation and includes internal improvements to the isObject utility.

Version 3.25.30 introduces support for v4/mini paths, improves web URL documentation, and fixes typing for z.instanceof.

This release introduces the unwrap method for ZodArray and standardizes URL behavior while fixing bugs related to string validation parameters and build warnings.

Version 3.25.28 focuses on improving ZodFunction typing, fixing package distribution exports, and correcting documentation typos.

Version 3.25.27 introduces the .value property to ZodLiteral and implements the override keyword for internal class consistency.

This release includes a fix for the .register methods and updates the documentation to replace z.min and z.max references.

This release introduces stricter schema validation for output objects by defaulting 'additionalProperties' to false and includes new documentation for Zod Core parsing.

This release focuses on improving environment compatibility, specifically for the Hermes engine and older bundlers, while resolving minor bugs and error naming issues.

Version 3.25.23 is a patch release that fixes incorrect JSON Schema identifiers.

Version 3.25.22 focuses on documentation corrections for safeParse and repository maintenance, including the removal of src and test directories from the published package.

This release focuses on fixing input types for custom validators and introducing z.core, alongside improved documentation for error mapping.

This release introduces a global fallback for the File object to improve handling when specific implementations are unavailable.

Version 3.25.18 is a maintenance release with no specific features or fixes detailed in the commit log.

Version 3.25.17 introduces a tshy-style build system and fixes issues related to locale wildcard resolution and type definition compatibility.

This release includes a bug fix for wildcard handling.

Version 3.25.15 release consisting of two maintenance commits.

Version 3.25.14 focuses on CI/CD improvements, including the introduction of canary releases and fixes for build processes and ESM compatibility.

Version 3.25.13 is a maintenance release containing a single commit.