TL;DR

Valibot now handles complex locales and object keys more reliably, resolving issues with word count validation and schema merging.

Fixes Worth Knowing

Word count validations using words, minWords, maxWords, and notWords are now more efficient for non-primitive locales. Schema merging with intersect now correctly handles object keys that conflict with standard JavaScript object properties (like toString), preventing errors.

TL;DR

Valibot now correctly generates JSON Schema definitions even when your data keys contain special characters, improving compatibility with tools that consume JSON Schema.

Fixes Worth Knowing

Fixed an issue where JSON Schema definitions with keys containing / or ~ characters would be invalid. This ensures broader compatibility with JSON Schema (data interchange format) consumers.

TL;DR

Valibot now supports validation error messages in Uzbek, improving accessibility for users in that region.

New

• Added Uzbek (uz) translations for validation errors.

Before You Upgrade

• Ensure your project uses Valibot peer dependency version 1.4.0 or higher.

TL;DR

Valibot now supports adding descriptive metadata (like titles) to schemas and validating decimal numbers, improving schema clarity and data validation capabilities.

Breaking

• NoPipe type renamed to SchemaWithoutPipe (internal type change).
• decimal action renamed to digits (affects code using this validator).

New

• Add metadata action to associate custom data with schemas (for documentation/tooling).
• Add digits action to validate strings as integers or floats (supports numeric input).

Fixes Worth Knowing

• Improved type inference for error paths (improves error message accuracy).

TL;DR

Valibot gains new input types and parsing methods, improving flexibility when defining and validating schemas, especially for complex data structures.

Breaking

• Object schema checks are less strict (schema definition).
• _stringify utility now handles custom objects (data serialization).

New

• Added parser and safeParser methods (data parsing functions).
• Introduced new input types: ContentInput, ContentRequirement, LengthInput, SizeInput, and ValueInput (schema definition).
• Added a config method (schema configuration).

Fixes Worth Knowing

• Fixed a bug in the forward method (error handling).
• Improved compatibility with various environments by relaxing object checks.
• Corrected _stringify for modified objects.

Before You Upgrade

• Review the official migration guide at https://valibot.dev/guides/migrate-to-v0.31.0/ to understand changes to object schema validation and stringification.