v5.2.2

Compare Source

v5.2.1

Compare Source

Bug Fixes

• discriminated union for zod v4 mini (#​784) (49a0d7b)
• zod v4 peer deps (#​798) (2d28e6a)
• zod: fix output type for Zod 4 resolver (#​801) (bc09647)

v5.2.0

Compare Source

Features

• ajv: add ajv-formats for ajvResolver (#​797) (f040039)

v5.1.1

Compare Source

Bug Fixes

• zod peer dep issue (#​780) (79cd8b2)

v5.1.0

Compare Source

Features

• support Zod 4, Zod v4 mini, and retains compatibility with Zod v3. (#​777) (8d083bd)

v5.0.1

Compare Source

Bug Fixes

• relax version constraint for react-hook-form 7.55.0 → ^7.55.0 (#​758) (6e88393)

v5.0.0

Compare Source

Features

• infer input/output types from schema (#​753) (6124c59)

BREAKING CHANGES

• Requires react-hook-form@​7.55.0 or higher

Before
Prior to V5, some projects used manual types like

useForm<FormValues>();

After
With V5, the correct approach is:

useForm<Input, Context, Output>();
useForm<FormInputValues, Context, FormOutputValues>();

This update enables distinct outputs when utilizing features like transform from validation libraries.

ℹ️ The best approach is to let the types be inferred from your schema, rather than manually defining them.

v4.1.3

Compare Source

Bug Fixes

• escape square brackets in field name regex pattern (#​752) (50dd4ad)

v4.1.2

Compare Source

Bug Fixes

• standard-schema: move @​standard-schema/utils to dependencies (#​748) (ded1746)

v4.1.1

Compare Source

Bug Fixes

• standard-schema: Propertly handle object path segments (#​746) (8ffada0)

v4.1.0

Compare Source

Features

• automatically infer values from schema (#​739) (caaff8d)

v4.0.0

Compare Source

Bug Fixes

• add support for names option (#​713) (985c48d)
• arktypeResolver: resolve type error when schema is defined from an ArkType scope (#​732) (3233667)
• handle raw: true option to pass form submission values correctly (#​733) (7807f95)
• validateFieldsNatively: handle undefined object when reading 'refs' (#​734) (3da2054)

Features

• ajv: Keep original validation type while using errorMessage (#​728) (5030a59)
• effectResolver: returns either all errors or only the first one based on criteriaMode (#​737) (12d7d8e)
• standard-schema: add standard-schema resolver (#​738) (b75a95a)

BREAKING CHANGES

• ajv: The AJV Resolver now unwraps the errorMessage object to return the original error types. This update may introduce breaking changes to your projects.

v3.10.0

Compare Source

Features

• update to effect 3.10 (#​729) (10aca41)

v3.9.1

Compare Source

Bug Fixes

• Valibot peer dependency to support dist-tags (#​723) (3ab415e)

v3.9.0

Compare Source

Features

• fluentvalidation-ts: add fluentvalidation-ts resolver (#​702) (5fc1e63)

import { useForm } from 'react-hook-form';
import { fluentValidationResolver } from '@​hookform/resolvers/fluentvalidation-ts';
import { Validator } from 'fluentvalidation-ts';

class FormDataValidator extends Validator<FormData> {
  constructor() {
    super();

    this.ruleFor('username')
      .notEmpty()
      .withMessage('username is a required field');
    this.ruleFor('password')
      .notEmpty()
      .withMessage('password is a required field');
  }
}

const App = () => {
  const { register, handleSubmit } = useForm({
    resolver: fluentValidationResolver(new FormDataValidator()),
  });

  return (
    <form onSubmit={handleSubmit((d) => console.log(d))}>
      <input {...register('username')} />
      {errors.username && <span role="alert">{errors.username.message}</span>}
      <input {...register('password')} />
      {errors.password && <span role="alert">{errors.password.message}</span>}
      <button type="submit">submit</button>
    </form>
  );
};

v3.8.0

Compare Source

Features

• add typeschema resolver (#​699) (18e423f), closes #​693
• typeboxResolver: make TypeBox resolver work with compiled schema (#​674) (e8e0f80)

v3.7.0

Compare Source

Bug Fixes

• zodResolver: cannot read properties of undefined (reading 'length') (a3e50c6)
• chore: update valibot dependency to version >=0.33.0 (#​695)

Features

• add VineJS resolver (#​677) (c0d528b)

import { useForm } from 'react-hook-form';
import { vineResolver } from '@​hookform/resolvers/vine';
import vine from '@​vinejs/vine';

const schema = vine.compile(
  vine.object({
    username: vine.string().minLength(1),
    password: vine.string().minLength(1),
  }),
);

const App = () => {
  const { register, handleSubmit } = useForm({
    resolver: vineResolver(schema),
  });

  return (
    <form onSubmit={handleSubmit((d) => console.log(d))}>
      <input {...register('username')} />
      {errors.username && <span role="alert">{errors.username.message}</span>}
      <input {...register('password')} />
      {errors.password && <span role="alert">{errors.password.message}</span>}
      <button type="submit">submit</button>
    </form>
  );
};

v3.6.0

Compare Source

Features

• upgrade and migrate Valibot to v0.31.0 (#​688) (bdd5ef5)

v3.5.0

Compare Source

Features

• migrate arktype resolver to v2 (#​686) (c53864f)

v3.4.2

Compare Source

Bug Fixes

• move back to in-build set and remove lodash.set (#​685) (5754c47)

v3.4.1

Compare Source

Bug Fixes

• migrate set to lodash.set package (#​684) (bdc1f1f)

v3.4.0

Compare Source

Features

• effect-ts resolver (#​676) (9ba2f89)

v3.3.4

Compare Source

Bug Fixes

• error handling for array errors with root error (1bfc6ab)

v3.3.3

Compare Source

Bug Fixes

• valibotResolver: infinite loop (#​655) (6f1b139)

v3.3.2

Compare Source

Bug Fixes

• CVE by upgrading zod dependency (#​633) (1baed6e)

v3.3.1

Compare Source

Bug Fixes

• yup: fix ts error (#​625) (918d72f)

v3.3.0

Compare Source

Bug Fixes

• class-validator: return instance unless rawValues is set (#​617) (4882173)
• yup: lazy schema (#​619) (c1d5433)

Features

• add support for root errors for field array (#​621) (5f1a622)
• pass field names and a context as arguments to a Vest suite (#​584) (3519701)
• valibot: add more tests, support of criteriaMode and reduce size (#​620) (a9d319d)

v3.2.0

Compare Source

Features

• valibot: Add valibot resolver (#​602) (2185330)

v3.1.1

Compare Source

BREAKING CHANGES

Bug Fixes

• Yup resolver: schema type error (#​563) (420e862), closes #​549

You don't need to explicitly provide the type when using the useForm function because it automatically infers the types from the Yup schema.

Before

const schema = Yup.shape({ name: string });

const { register } = useForm<{name: string}>({ resolver: yupResolver(schema) });

After

const schema = Yup.shape({ name: string });

const { register } = useForm({ resolver: yupResolver(schema) });

v3.1.0

Compare Source

Features

• arktype: add arktype resolver (#​542) (d2d6fec)

v3.0.1

Compare Source

Bug Fixes

• typebox: errors iteration (#​537) (4a65f85)

v3.0.0

Compare Source

BREAKING CHANGES

• Yup resolver require Yup v1
• rename rawValues option to raw
• classValidationResolver: schema options now includes validator and transformer options
• Please note that ajv and ajv-errors need to be installed separately, as they are not bundled with resolvers

Before:

schemaOptions?: ValidatorOptions,

After:

schemaOptions?: {
    validator?: ValidatorOptions;
    transformer?: ClassTransformOptions;
  }

Bug Fixes

• module resolution NodeNext (#​527) (503d973)
• resolvers fails silently (#​528) (6677e0e)

Features

• add option to keep raw values (f22d57c)
• classValidationResolver: add transform and validator options (#​524) (2749bd9)
• yupResolver: add support Yup v1 (#​520) (f3da212)
• typeboxResolver: add TypeBox resolver (#​526) (6a31c92)

import { useForm } from 'react-hook-form';
import { typeboxResolver } from '@​hookform/resolvers/typebox';
import { Type } from '@​sinclair/typebox';

const schema = Type.Object({
  username: Type.String({ minLength: 1 }),
  password: Type.String({ minLength: 1 }),
});

const App = () => {
  const { register, handleSubmit } = useForm({
    resolver: typeboxResolver(schema),
  });

  return (
    <form onSubmit={handleSubmit((d) => console.log(d))}>
      <input {...register('username')} />
      <input type="password" {...register('password')} />
      <input type="submit" />
    </form>
  );
};

Performance Improvements

• ajvResolver: reduce bundle size (#​523) (fc00379)