v4.12.7

🐛 Bug Fixes

• Handle TypedSchema.describe API crashing with future releases, now it just reports false for meta.required (1376794)
• Handle meta.required for single field schema react to changes #4738 (1376794)
• Ensure meta.required reacts to reactive form schema changes #4738 (c4415f8)

🌍 i18n

• added missing integer translation (#4674) thanks to @Bandeirex

v4.12.6

🐛 Bug Fixes

• Apply error messages again to prevent hoisted paths from being overridden 07d01fd

👕 TypeScript

• Expose Field component interface #4657
• Updated valibot dependency #4658

v4.12.5

🐛 Bug Fixes

• Make sure removePathState removes the correct path state #4643 (#4649) thanks to @bgoscinski
• Remove event arg from define field handlers for component compat #4637 (#4647)

v4.12.4

🐛 Bug Fixes

• Check if both source and target objects are POJOs before attempting to merge them (2a09a58)

v4.12.3

🐛 Bug Fixes

• use spec object instead of checking tests for determining the required status of a field on yup schemas #4598 (#4599)

🆕 Improvements

• Remove deep data mutation warning #4597 (72e4379)
• Allow path meta querying for nested fields #4575 (a18c19f)
• Expose some state on form instance (e2171f8)

v4.12.2

🐛 Bug Fixes

• Apply schema casts when submitting #4565 (b2203c8)
• defineField should respect global validateOnModelUpdate config #4567 (ec8a4d7)

v4.12.1

🐛 Bug Fixes

• resetForm not resetting unspecified fields to their original values if a partial is provided #4564 (36f6b9e)
• resetField not setting the original value of the field causing the dirty flag to not update #4564 (36f6b9e)

DX

• unref initial values when initializing the form #4563 (c1c6f39)

v4.12.0

💣 Breaking Changes

Deprecated reactive initial values #4402 (bbecc97)

Initial values can no longer be reactive since they did not serve any purpose for being so. The recommended API for setting async initial values is by explicitly calling resetForm.

🆕 defineField API #4497

This is a new function available on useForm and is meant to replace useFieldModel, defineInputBinds and defineComponentBinds by building upon and improving those APIs.

<script setup>
import { useForm } from 'vee-validate';

const { defineField, errors } = useForm({
  validationSchema: schema,
  validateOnMount: true,
});

const [email, emalProps] = defineField('email', { validateOnModelUpdate: true });
const [password, pwProps] = defineField('password', { validateOnModelUpdate: true });
</script>

<template>
  <input v-model="email" v-bind="emailProps" />
  <span>{{ errors.email }}</span>

  <input  v-model="password" v-bind="pwProps" />
  <span>{{ errors.password }}</span>
</div>
</template>

The docs have been updated to reflect using this new API instead of the deprecated ones. The old ones will continue to work till they get removed in next minor releases.

🆕 meta.required

Added support for meta.required state for Typed Schemas only.

That means if you are using toTypedSchema helper with either Yup, Zod, Valibot, or Global rules then it should be automatically done for you. This is a new experimental feature and may not work well with conditional schemas or dynamic ones.

For more info check the live demo link here.

🆕 DX improvements

• feat: add label support to defineField #4530 (f9a9584)
• feat(DX): allow getters for field arrays paths (95b701f)

🐛 Bug Fixes

• Avoid overriding paths and destroy path on remove #4476 #4557 (f688896)
• Clone values before reset #4536 (2abb896)
• Handle hoisted paths overriding one another (e370413)

v4.11.8

🐛 Bug Fixes

• (perf) Avoid triggering extra model value events #4461 (d1b5b85)

👕 TypeScript

• Allow null as a valid Form prop type #4483 (78c4668)

v4.11.7

💣 Breaking Changes

• Removed default export from the @vee-validate/rules package which caused issues for ESM importing #4470

This only affects you if you are importing all the rules.

Migration:

- import AllRules from '@vee-validate/rules';
+ import * as AllRules from '@vee-validate/rules';

👕 Types

• useSetFormValues now accepts values generic type parameters (#4475) thanks to @ivan-angjelkoski
• Exported missing internal types causing a build error #4478 (a1414f6)

🆕 New Features

• Added Joi schema support thanks to @lallenfrancisl (#4463), it was sneaked in a previous release tag but it is being announced here to acknowledge that addition.
• Valibot and Yup schemas now merge their default values with the initial form values, allowing you to use each lib's schema defaults more freely (c372718)