When Velite was first created, Zod v3 did not support metadata, which prevented us from providing an elegant way to inject additional data.
During that time, we attempted to collaborate with the Zod team and even submitted a PR. However, due to the author’s roadmap, that PR was not merged. As a result, we decided to apply a custom modification to Zod v3 within Velite.

We are pleased to see that Zod v4 has officially introduced metadata support along with many other new features. Since Zod v4 has been stable for quite some time, we believe it is now the right moment to consider migrating Velite to Zod v4.

Many thanks to the Zod author and contributors for their continued efforts and great work!