react-hook-form

🦭 Integrated the latest updates and fixes from Version 7

• ⚠️ Breaking change: pass input ref instead of partial (https://github.com/react-hook-form/react-hook-form/issues/12773)
• ⚠️ Breaking change: rename useFieldArray
  • id to key
  • keyName props removed for useFieldArray

const { fields, append } =useFieldArray()

// data will be part of the submission 
append({
  key: 'key',  // does not affect render key
  id: 'key',  // does not affect render key
})

field[0].key // will still be uniq id for re-render

• ⚠️ Breaking change: rename <Watch /> rename names to name
• ⚠️ Breaking change: watch call back api removed
• ⚠️ Breaking change: setValue no longer direct update useFieldArray, instead use replace api https://react-hook-form.com/docs/useform/setvalue

npm i react-hook-form@8.0.0-beta.1

⬆️ Promoted v8 from alpha to beta stability 🦭 Integrated the latest updates and fixes from Version 7

npm i react-hook-form@8.0.0-beta.0

🔬 feat: exp with react-compiler (#12309)

npm i react-hook-form@8.0.0-alpha.5

🐞 Fixes

• Fix form state select option (#13784)
• Remove duplicate default value field (#13783)
• Fix validateField skipping refs without setCustomValidity under native validation (#13782)
• Fix form-level validation using a stale validate function (#13777)
• Fix useFieldArray touched fields handling (#13776)
• Fix pending delayError timers for nested paths (#13775)
• Fix getValues extracting unmarked field array entries (#13773)
• Fix field array touched state not being re-indexed when unsubscribed (#13772)
• Fix nested delayError timers remaining when a parent validates clean (#13771)
• Fix nested delayError timers remaining after resetField() resets a parent (#13769)
• Fix stale field array root errors after an operation satisfies the validation rule (#13767)
• Fix setValue() not revalidating dependencies when shouldValidate is enabled (#13765)
• Fix stale built-in validation results after reset() during handleSubmit() (#13761)
• Fix stale form-level validation results after reset() (#13762)
• Fix validation rules removed from register options at runtime remaining active (#13758)
• Fix useController required validation not using the controlled value (#13756)
• Fix stale form-level errors remaining after successful re-validation (#13755)
• Fix useFieldArray marking the form dirty when the array default value is null (#13750)
• Fix isValid not being recomputed when the errors prop is emptied (#13748)
• Fix form-level validation running more than once per traversal (#13747)
• Fix stale built-in validation results after reset() during onChange (#13745)
• Fix stale resolver results after reset() during onChange (#13744)
• Fix setValue() not triggering field array root validation when shouldValidate is enabled (#13743)
• Fix getFieldState(name, formState) updates after reset() (#13741)
• Fix dirty state remaining for rows removed from a field array (#13739)

🧹 Refactors

• Replace rimraf cleanup with fs.rmSync (#13770)
• Reduce bundle size (#13759)

📦 Dependencies

• Add optional @types/react peer dependency (#13781)

❤️ Thank You

• Thanks to @niketchandivade, @unrevised6419, @Lucasfarg, @dfedoryshchev, @locphamnice, @Abdalluh28, @giaBaoJS, @Mohamedshawky4, @roli-lpci, @soroush5, @zigzagdev and @bluebill1049 for their contributions! 🎉

✨ Features

• Add Error Message component (#13472)
• Add the Error Message component for displaying validation errors from React Hook Form.

🐞 Fixes

• Fix stale validating state after resetField() (#13735)
• Fix errors and touched state remaining for rows removed by replace() (#13734)
• Fix stale resolver results updating form state after reset() during handleSubmit() (#13733)
• Fix nested registered errors being removed when trigger() targets their parent (#13732)
• Fix resolver-reported root errors being dropped during handleSubmit() (#13731)
• Fix parent errors being incorrectly set when trigger() targets a field with only nested resolver errors (#13730)
• Fix useWatch compute cache not being initialized with the initial output (#13728)
• Fix FileList being lost during flatten/expand and omit undefined values in jsonToFormData (#13725)
• Fix schemaErrorLookup reporting nested containers as exact-name errors (#13727)
• Fix isValidating not being recomputed after unregister() clears validating fields (#13723)
• Fix stale resolver state updates after reset() (#13722)
• Fix iterateFieldsByAction only breaking out of one loop level (#13718)
• Fix stale validation types surviving setError() overwrites (#13716)
• Fix reset() not clearing validating fields (#13714)
• Fix remove() leaking deleted values onto surviving field-array items (#13713)
• Fix the React Server build being unpublished (#13709)
• Fix validateField calling setCustomValidity once per key in validate-object mode (#13707)
• Fix useFieldArray focus behavior for checkboxes and radio buttons in appended rows (#13705)
• Fix getFieldState reading isValidating from the supplied form state (#13704)
• Fix unregister() stripping kept values from the submit payload (#13703)
• Fix useFormState not re-subscribing when control changes (#13702)
• Fix reset() keeping dirtyFields out of sync with isDirty when keepValues is enabled (#13701)
• Fix useForm not reconciling correctly when an Activity subtree is initially hidden (#13698)
• Fix cleared errors returning after the delayError timer fires (#13697)
• Fix cloneObject throwing when checking Blob with instanceof (#13694)
• Fix useFieldArray retaining stale fields after an Activity subtree reconnects (#13688)

🧹 Refactors

• Extend _isTracked to the remaining multi-key proxy/subscribe form-state checks (#13699)
• Extract _isTracked helper for proxy/subscribe form-state checks (#13690)
• Remove the unused abortEarly parameter from iterateFieldsByAction (#13689)
• Remove redundant optional chaining from clearErrors (#13696)

📝 Documentation

• Fix useWatch compute example variable names in JSDoc (#13700)

📦 Dependencies

• Bump joi from 18.2.1 to 18.2.5 (#13719)

❤️ Thank You

• Thanks to @soroush5, @bluebill1049, @Tnalxmsk, @zigzagdev, @dfedoryshchev, @Alioth-91, @giaBaoJS and @jliew for their contributions! 🎉

✨ Features

• Add shouldTouch option to trigger() ([#13671](#13671))

  setValue already supported shouldTouch; trigger() now does too. This allows you to mark field(s) as touched after manual or programmatic validation, such as validate-on-mount or multi-step form navigation, without needing a setValue workaround:

  // Mark a single field as touched after validating it
  await trigger('firstName', { shouldTouch: true });
  
  // Mark every mounted field as touched after validating the whole form
  await trigger(undefined, { shouldTouch: true });

• Add OpaqueTypes registry for opaque leaf types ([#13676](#13676))

  Recursive type helpers (Path, DeepPartial, DeepRequired, FieldErrorsImpl, etc.) previously stopped only at Primitive | BrowserNativeObject. As a result, rich third-party value types such as Dayjs and Decimal could be recursively traversed member-by-member, potentially causing TypeScript to report "Excessive complexity" diagnostics on large form types.

  You can now register a type as an opaque leaf via declaration merging:

  import type { Dayjs } from 'dayjs';
  
  declare module 'react-hook-form' {
    interface OpaqueTypes {
      dayjs: Dayjs;
    }
  }

  While the registry is empty, types remain identical to the existing behavior. This is purely opt-in.

🐞 Fixes

• Fix inconsistent behavior among useController().field.onChange()-like APIs. ([#13673](#13673))
• Fix Controller under a null parent submitting undefined instead of a value. ([#13675](#13675))
• Fix ERR_MODULE_NOT_FOUND when resolving react-hook-form due to a react-server declaration in Next.js builds. ([#13682](#13682))
• Fix useWatch never reconciling when an Activity subtree is hidden on its first render. ([#13683](#13683))
• Fix resetField not recomputing isValid for subscribe-only consumers. ([#13684](#13684))
• Fix generateWatchOutput ignoring defaultValue for an array of names. ([#13686](#13686))
• Fix useFormState never reconciling when an Activity subtree is hidden on its first render. ([#13687](#13687))

❤️ Thank You

Thanks to @giaBaoJS, @dfedoryshchev, @Alioth-91, @Masatoshi0227, @modosc, and @bluebill1049 for their contributions! 🎉

✨ Features

• Add type-safe getErrors method. (#13639, #12853)

🐞 Fixes

• Fix useWatch returning stale values when the watched name changes to null. (#13668)
• Fix unregister keepDirty behavior. (#13669)
• Fix setValues for fields registered under object or array values. (#13667)
• Fix Controller notifications for field array item roots. (#13665)
• Fix validation state checks. (#13661)
• Fix setCustomValidity with criteriaMode: 'all'. (#13655)
• Fix File, Blob, and FileList handling in flatten. (#13652)
• Fix stale errors and touched state after updating a field array item. (#13650)
• Fix stale field names leaking into persisted formState. (#13649)

🚀 Performance

• Improve createFormControl performance. (#13648)
• Improve cloneObject performance.
• Avoid unnecessary value cloning in unregister. (#13662)
• Improve performance in onChange-heavy workloads.

🧹 Chores & Refactoring

• Remove unnecessary any usage. (#13660)
• Improve TypeScript handling around checkbox values. (#13659)
• Improve UUID generation. (#13658)
• Clean up repository structure and APIs. (#13657)
• Remove unreachable revalidation logic in useFieldArray. (#13654)

Thanks to @dfedoryshchev, @zigzagdev, @official-burak, @Jaybhade, @candymask0712, and @bluebill1049 for their contributions! 🎉

✨ Improvements

• support React <Activity /> (#13633)

🐞 Fixes

• fix min/max validation being skipped for valueAsDate fields (#13646)
• fix field array root errors being lost during append, prepend, insert, and remove (#13645)
• fix stale renders recreating field array paths after field array actions (#13644)
• fix useWatch preferring form defaultValues over the hook's own defaultValue (#13635)
• fix setValue emitting duplicate values state notifications (#13637)
• fix TypeScript getFieldState error resolution for field paths (#13632)

🏗️ Chores

• remove tinybench (#13647)
• remove dead code and stale API Extractor report (#13643)

Thanks to @zigzagdev, @bluebill1049, @anshusaurav, @saulo-silva, @EduardF1, and @candymask0712 for their contributions! 🎉

✨ Improvements

• enhance <Form /> submit behavior (#13605)
• improve performance and reduce bundle size (#13591)

🐞 Fixes

• fix: values + keepDirtyValues silently corrupting arrays and freezing objects on refetch (#13628)
• fix: setValue not updating FieldArray values correctly (#13623)
• fix: FormState type definitions (#13620)
• fix: FieldArray and FormState exports (#13619)

🧪 Tests

• add Blob coverage for FieldErrors type tests (#13624)

♻️ Refactors

• extract shared ErrorNamespacePath type (#13615)

🏗️ Chores

• rename <FormStateSubscribe /> back to <FormState /> (#13602)
• bump @babel/core from 7.26.0 to 7.29.7 (#13614)

Thanks to @candymask0712, @EduardF1, @in-ch, @johnstrand, @wanxiankai, @nobu-da, and @bluebill1049 for their contributions! 🎉

⚡ Improvements

• enhance getEventValue to handle file inputs (#13289)
• type perf: improve TypeScript performance with a hard cap at 10 levels of recursive type depth (#13529)
• type perf: improve type performance (#13528)

🐞 Fixes

• fix: clear internal errors state on argument-less clearErrors() (#13613)
• fix: preserve dirtyFields reference stability (#13612)
• fix: old checkbox/radio elements polluting internal field state (#13080)
• fix(useController): re-subscribe onChange/onBlur when control changes (#13603)
• fix(types): allow validation messages to be defined even if their related value is undefined (#13287)

Thanks to @candymask0712, @wanxiankai, @bluebill1049, @EduardF1, @johnstrand, and @in-ch for their contributions! 🎉

🚀 feat: add opt-in delayError option for setValue (#13337)

setValue("firstName", "Bill", {
  delayError: 500, // delay validation error updates by 500ms
  shouldValidate: true
});

⚡ perf: improve getDirtyFields performance (#13590)

• Improved dirty field calculation, especially for larger forms and deeply nested values.

🐞 fix: expose resetDefaultValues through form context (#13598)

const { resetDefaultValues } = useFormContext();

resetDefaultValues();

🐞 fix: setValue with shouldDirty now correctly updates dirty state when the form is disabled (#13594)
🐞 fix: preserve dirtyFields boolean values for registered array fields (#13586)
🐞 fix: restore FieldArray component export (#13596)
🧪 test: migrate test suite to Playwright and improve delayError test reliability (#13589)

thanks to @candymask0712, @wanxiankai, @a-y-ibrahim, @ankit1324 & @abnud11

⚜️ feat: FieldArray component (#13394)

<FieldArray
  control={control}
  name="test"
  render={({ fields }) => null}
/>

🐞 fix #13538 useFieldArray min 1 item validation error changes its location in the errors object (#13539)
🐞 fix #13569 calling reset triggers subscribe with latest name instead of undefined (#13574)
🐞 fix(useController): reflect cleared parent object in controlled fields (#13550) (#13553)
🐞 fix(flatten): preserve Date values as leaf nodes (#13566)
🐛 fix(unset): guard against prototype keyword path traversal (#13559) (#13560)
🏸 improve setValue api with shrink value (#13576)
👝 close #13577 improve re-render with useFieldArray reset (#13578)
🐞 fix #13575 issue: clearErrors changes the name value from form.subscribe (#13579)

thanks to @DakshSinghDhami, @JSap0914, @tran-simon & @EduardF1

🧄 feat: disable useFieldArray fields (#13535)

const { fields } = useFieldArray({ disabled: true });
fields[0].disabled; // contains disabled props

🛺 perf: make rhf more performant (#13524)
🐞 fix(deepEqual): empty array and empty plain object should not be equal (#13533)

thanks to @JSap0914

🚷 feat: use field array disabled (#13520)

useFieldArray({ disabled, name: 'test' })

🐞 fix controller onChange promise (#13518)
🐞 fix: track visited pairs in deepEqual to avoid false positives with shared object references (#13515)
🐞 fix #12651 issue: field validation with shouldUseNativeValidation does not behave native like for radio groups (#13512)
🐞 fix #12754 createFormControl breaks with fast refresh in dev mode (#13511)
🐞 close #12709 #12750 StrictMode would remove field value & get mounted again (#13508)
🐞 fix #13505 issue: In v8 with React compiler, a change in formState errors does not cause child components to re-render (#13510)

thanks to @DucMinhNe & @louzhedong

🦷 update type dirtyFields typing for field arrays with undefined entries (#13492)
🐞 fix: recover Controller fields after reset without rerender (RN issue #13455) (#13497)
🐞 fix useFormState().isDirty race with async resolver in onChange mode (#13495)
🐞 fix: use reactive values prop over defaultValues when shouldUnregister is true (#13485)
🐞 fix deepEqual for empty non-plain objects (#13493)

thanks to @cyphercodes

🥡 feat: add resetDefaultValues API (#13427)

https://react-hook-form.com/docs/useform/resetdefaultvalues

const { resetDefaultValues } = useForm();

resetDefaultValues(currentValues);

🐚 harden get() against prototype-path traversal (proto / constructor / prototype) (#13479) 🐞 fix FieldArray errors overriding nested fields (#13476) 🐞 fix inconsistent reset({}) behavior requiring double-call to take effect (#13473) 🐞 fix: preserve values with shouldUnregister (#13464) 🐞 fix stale isDirty in subscribe payload after reset(..., { keepValues: true }) (#13461) 👝 save bundle size (#13468)

thanks to @puneetdixit200 & @dfedoryshchev

🐞 fix: pass options parameter through setValues to enable validation (#13457) 🐞 fix(setValues): emit whole-form change without stale name/type (#13450) 🚗 perf(setValues): thread skipClone through setFieldValue (#13448) 🚗 perf(setValues): skip redundant per-field deep clones (#13445) Revert "🐞 fix: treat NaN as empty when valueAsNumber is true in validateField (#13388)"

thanks to @philibea & @maxkostow

🪭 close #13141 improve isDirty sync with dirtyFields state (#13370) 🐞 fix isValidating reactivity when validatingFields is not subscribed (#13440) 🛺 test: fix duplicate-word typos in test descriptions (#13439) 🐞 fix #13436: errors state when using form level validation (#13437) 🐞 fix #13429 append({ obj: null }) is silently replaced by defaultValues after remove() (#13435) 🐞 fix native validation tooltip suppression caused by duplicate submit-error focus (#13432) 🐞 fix: propagate setValues updates to mounted Controller fields (#13431) 🐞 fix: rreserve reset values for conditionally mounted Controller fields with shouldUnregister 🐞 fix: useFieldArray remove leaves array with empty object when using values prop (#13422) 🐞 fix #13260: notify all matching field-array roots on nested setValue updates (#13420) 🐞 fix #13104: preserve nested resolver field-array errors in trigger() (#13419) 🐞 fix #13413: preserve formState.defaultValues when useFieldArray + watch are used together 📝 docs: fix JSDoc for IsNever, register, and getFieldState (#13410) (#13411) 🐞 fix(Watch): restore TypeScript 4 compatibility (#13409)

Big thanks to @dfedoryshchev for multiple fixes, and to @EduardF1, @in-ch and @johnstrand.

🦧 feat: improve get dirty fields prune empty fields (#13363)

+ dirtyFields: { test: [{ data: false }] }
- dirtyFields: {} // removed the empty node with false value

🎹 typescript 6.0 (#13330) 🌡️ chore: minor improvement on setValue & reset (#13366) 🐞 fix #13403: include setValues in FormProvider context value (#13404) 🐞 fix: recompute isDirty after re-registering a previously unregistered field (#13399) 🐞 fix: preserve watch updates on field array unmount fixes #13375 (#13385) 🐞 fix: prevent useWatch re-render when unrelated field validation is … (#13398)

thanks to @dfedoryshchev, @cyky & @gkarabelos

🪇 feat: setValues (#13201)

setValues((data) => {
  return {
    ...data,
    name: 'test'
  }
})

setValues(formValues);

🐞 fix: preserve previous field value when useController name changes (#13395) 🐞 fix: handle null parent when unregistering nested field (#13396) 🐞 fix: treat NaN as empty when valueAsNumber is true in validateField (#13388) 🪢 fix build to exclude test files (#13387)

thanks to @Yihao-G & @mixelburg

⚡perf: memoize submit (#13378) 🚉 perf: improve deepEqual performance (#13362) 👀 perf: skip re-render in setValue when value is unchanged (#13352) ✂️ remove unneeded flag check for shouldDirty 🚨 fix: safely access field._f during register (#13365) 🧹 close #13298: improve fieldState errors when resolver uses dot-notation string keys (#13350) 🐞 fix #13178: update state correctly in watch callback with Controller, trigger, and reset (#13180) 🐞 fix #13331: skip field array validation when mode is onBlur (#13333) 🐞 fix #13334 sDirty remains false after deletion an item with shouldDirty: true (#13357) 🐞 fix: handle nested field when parent defaultValue is null (#13348)

thanks to @Prasadzoman, @cyphercodes, @lorenzoceglia, @rizwan-rizu, @tomeelog & @ap0nia

🐞 fix: add isDirty check for numeric string keys in defaultValues (issue #13346) (#13347) 🐞 fix: prevent setValue with shouldDirty from polluting unrelated dirty fields (#13326) 🐞 fix: memoize control in HookFormControlContext to prevent render conflicts (#13272) (#13312) 🐞 fix: isNameInFieldArray should check all ancestor paths for nested field arrays (#13318) 🐞 fix: #13320 formState.isValid incorrect on Controller re-mount (#13324)

thanks to @6810779s, @candymask0712, @olagokemills, @shahmir-oscilar & @bae080311

⚓️ feat: built-in form level validate (#13195)

useForm({
  validate: async ({ formValues }: FormValidateResult) => {
    if (formValues.test1.length > formValues.test.length) {
      return {
        type: 'formError',
        message: 'something is wrong here',
      };
    }

    if (formValues.test === 'test') {
      return 'direct error message';
    }

    return true;
  },
});

🐞 fix: prevent useFieldArray from marking unrelated fields as dirty (#13299) 🐞 fix #13300 checkbox form validation ignored with native validation (#13310) 🌉 allow subscribe formState to track submit state (#13319)

thanks to @WiXSL, @BrendanC23 & @6810779s

🕵️‍♂️ fix: use DeepPartialSkipArrayKey for WatchObserver value parameter (#13278) 🧹 fix(clearErrors): emit name signal for targeted field updates (#13280)

thanks to @veeceey, @kaigritun, @pgoslatara & @seongbiny

🐞 fix #13250 issue with booleans_as_integers (#13252)

⚡ perf: memoize FormProvider context value to prevent unnecessary rerenders (#13235) 🚄 perf: separate control context to prevent unnecessary rerenders (#13234) 🐞 fix: update isValid when field disabled state changes (#13231) 👌 chore: optimize bundle size via safe terser options (#13243) (#13244)

thanks to @kamja44, @a28689604 & @newsiberian

✅ watch type improvement (#13228) 🐞 fix: prevent field array ghost elements with keepDirtyValues (#13188) 🐞 fix: improve invalid date handling in deepEqual and validation (#13230) 🐞 fix(types): handle branded types correctly in DeepPartial (#13222) 🐞 fix native validation focus issue (#13220) 🐞 change spread operator to set name with depricated names prop, then override with new name prop is supplied (#13214) 🐞 fix: prevent duplicate subscription trigger in setValue (#13206) (#13209) 👌 chore: fix lib type check include tests (#13229)

thanks to @EdwardEB, @constantly-dev & @a28689604

📏 feat: align <Watch /> API with useWatch (#13192) 🤦🏻‍♂️ chore: update @deprecated names prop on <Watch /> (#13198) 🏥 chore: safely call function methods on elements (#13190) 🪖 chore: cve-2025-67779 (#13196) 🪖 chore: cve-2025-55184 & cve-2025-55183 (#13194) 🪖 chore: CVE-2025-55182 Critical RCE vulnerabilty (#13175) 🔬 test: add regression tests for #12837 and #13136 (#13187) 🐞 fix(reset): preserve isValid state when keepIsValid option is used (#13173) 🐞 fix: ensure each createFormControl.subscribe subscription listens only to the changes it subscribes to (#12968) 🐞 fix(validation): batch isValidating state updates with validation result (#13181) 🐞 fix(createFormControl): resolve race condition between setError and setFocus (#13138) (#13169) 🧿 fix <Watch /> control prop type (#13189) 🔔 chore: clean cloneObject logic (#13179)

thanks to @PierreCrb, @a28689604, @AnuragM7666, @ap0nia, @dusan233 & @hlongc

🎧 feat: <FormStateSubscribe /> component (#13142)

import { useForm, FormStateSubscribe } from 'react-hook-form';

const App = () => {
  const { register, control } = useForm();

  return (
    <div>
      <form>
        <input {...register('foo')} />
        <input {...register('bar')} />
      </form>
      {/* re-render only when formState of `foo` changes */}
      <FormStateSubscribe
        control={control}
        name={"foo"}
        render={({errors}) => <span>{errors.foo?.message}</span>}
      />
    </div>
  );
};

🐞 fix: clear validation errors synchronously in reset() to fix Next.js 16 Server Actions issue (#13139) Revert "✨ fix(types): allow undefined value with async defaultValues in Contr…" (#13171)

thanks to @xiangnuans, @abnud11, @ntatoud & @ap0nia

🎯 feat: add exact to useController props (#13154)

useForm({
  defaultValues: {
    user: {
      name: ''
    }
  }
})

<Controller control={control} name="user" exact={false} /> // subscribe to all user object

✨ fix(types): allow undefined value with async defaultValues in Controller (#13160) 🐞 fix(types): correct PathValueImpl type inference (#13150)

thanks to @ap0nia, @Fasping & @joseph0926

⚡ perf: reduce redundant property access in getDirtyFields (#13146) 🐞 fix(createFormControl): skip setValid() during batch array updates (#13140) 🐞 fix(useForm): recompute isValid after reset when values update asynchronously (#13126) 🐞 fix(deepEqual): handle NaN comparison correctly using Object.is (#13120)

thanks to @kimtaejin3, @a28689604 & @WuMingDao

🎥 feat: make useWatch and useController to react to name change (#13070) 🐛 fix: watch() returning undefined immediately after reset() - Issue #13088 (#13091) 🐞 fix <Watch />: correct render function parameter typing (#13108)

thanks to @aspirisen, @scato3, @dusan233 & @zoldyzdk

🧿 feat: <Watch /> component (#12986)

import { useForm, Watch } from 'react-hook-form';

const App = () => {
  const { register, control } = useForm();

  return (
    <div>
      <form>
        <input {...register('foo')} />
        <input {...register('bar')} />
      </form>
      {/* re-render only when value of `foo` changes */}
      <Watch
        control={control}
        names={['foo']}
        render={([foo]) => <span>{foo}</span>}
      />
    </div>
  );
};

🐞 fix: respect parent-provided useFieldArray rules (#13082) (#13083 🐞 fix: getDirtyFields submit fields with null values when using useForm (#13079)

thanks to @tesseractjh, @Han5991 & @jonathanarnault

🚏 Support optional array fields in PathValueImpl type (#13057) 🐞 fix: preserve Controller's defaultValue with shouldUnregister prop (#13063) ✂ chore: remove unused field ids ref in useFieldArray (#13066)

thanks to @MPrieur-chaps, @gynekolog & @uk960214

🥢 feat: extract form values by form state (#12936)

getValues(undefined, { dirtyFields: true }); // return only dirty fields 
getValues(undefined, { touchedFields: true });  // return only touched fields 

🦍 feat: improve get dirty fields logic (#13049) 🐿️ chore: remove duplicated function isMessage (#13050) 🐞 fix: use field name to update isValidating fields (#13000) 🐞 fix: unregister previous field when switching conditional Controllers (#13041) 🐞 fix: only excuse trigger function when deps has a valid array (#13056)

thanks to @candymask0712, @GorkemKir, @kimtaejin3, @m2na7 & @abnud11

👨‍🔧 prevent onBlur for readOnly fields (#12971) 🐞 fix #12988 sync two defaultValues after reset with new defaultValues (#12990) 🐞 fix: do not override prototype of data in cloneObject (#12985) 🐞 fix field name type conflict in nested FieldErrors (#12972)

thanks to @candymask0712, @Adityapradh, @Ty3uK & @kichikawa57

Revert "⌨️ fix: watch return type based on defaultValue (#12896)"

🧮 feat: compute prop for useWatch subscription (#12503)

• subscribe to the entire form but only return updated value with certain condition

type FormValue = {
  test: string;
}

const watchedValue = useWatch({
  control: methods.control,
  compute: (data: FormValue) => {
    if (data.test?.length) {
      return data.test;
    }

    return '';
  },
});

• subscribe to a specific form value state

type FormValue = {
  test: string;
}

const watchedValue = useWatch({
  control: methods.control,
  name: 'test',
  compute: (data: string) => {
      return data.length > 3 ? data : '';
  },
});

👨‍🔧 trigger watch callbacks in response to value changes only (#12945) 🙏 track name with setValue subscription callbacks (#12946) ⌨️ fix: watch return type based on defaultValue (#12896) 🐞 fix #12959 subscribe with latest defaultValues #12961 🐞 fix: handle explicit "multipart/form-data" encType in Form Component (#12948) 🐞 fix(build): Remove React wildcard import to resolve ESM build issues (#12942) 🦭 chore: improve exclude patterns (#12935) 🐿️ chore: remove unused omit function (#12958)

Big thanks to @joshkel for helping with some of the subscription bugs! and also @kamja44, @mrazauskas, @codepunkt, @afontcu and @rururux

🦘 feat: reset new keepFieldsRef options keep fields reference (#12923)

// This option will skip input reference gets reset and avoid re-register input reference after reset
reset(data, { keepFieldsRef: true })

🦘 feat: reset new keepFieldsRef options keep fields reference (#12923)

// This option will skip input reference gets reset and avoid re-register input reference after reset
reset(data, { keepFieldsRef: true })

🪱 feat: support deep equality checking with circular references (#12914) 🐞 fix #12900 issue with formData reference clone (#12906) 🐞 fix #12873 issue with undefined value for submit data (#12905) 🐞 fix case when useWatch accept object variable param (#12897) 🐞 fix: typo in UseFormSubscribe and missing event type for callback data in subscribe (#12904) Revert "⌨️ rename to UseFormResetFieldOptions for type consistency" (#12907)

thanks to @aspirisen @n8pjl @SKOLZ @pushys & @candymask0712

🔧 check window.crypto undefined (#12893)

⌨️ feat: add FieldArrayPathByValue type (#12481) 📇 feat #12813 use stringToPath to prevent error at field name with quotes (#12858) 🧧 default to crypto.randomUUID in generateId (#12890) 🐞 close #12857 incorrect formControl return from useForm (#12878) 🐞 fix Initial useFieldArray fields (#12847) 🥷 chore: improve type import (#12879) 📇 chore: Added displayName to useFormContext (#11448) ✍️ chore: fix typo in assert-esm-exports.mjs (#12860)

thanks to @mastermatt, @clonemycode, @dusan233, @candymask0712, @tran-simon & @adnanalbeda

🫚 feat: root errors count in schema error lookup (#12839) 👁️ feat: focus form field for errors supplied by errors prop (#12805) ⌨️ feat: add and export options config for resetField api (#12819) 🐞 close #12707 useController focus function runtime issue (#12843) 🐞 fix: add proper types to form.subscribe (#12850) 🐞 fix: add type info for callback args in subscribe (#12859) 🔄 close #12835 revert original fix on errors empty object check (#12846)

thanks to @candymask0712, @CertainlyAria, @jkbach, @chrisgarber and @evgeniyworkbel

👀 useWatch new compute props

• subscribe to the entire form but only return updated value with certain condition

type FormValue = {
  test: string;
}

const watchedValue = useWatch({
  control: methods.control,
  compute: (data: FormValue) => {
    if (data.test?.length) {
      return data.test;
    }

    return '';
  },
});

• subscribe to a specific form value state

type FormValue = {
  test: string;
}

const watchedValue = useWatch({
  control: methods.control,
  name: 'test',
  compute: (data: string) => {
      return data.length > 3 ? data : '';
  },
});

🐞 fix: Changes setValue to skip values that are not in ownProperties to prevent infinite call stack (#12731) 🐞 fix: checkbox duplication handling in useFieldArray (#12793) 🐞 fix: make mode and reValidateMode reactive (#12803)

Revert "📭 close #12773 pass input ref instead partial (#12775)"

🐞 fix #12785 regression on default value gets overwritten by values props (#12790) 🐞 fix: use layoutEffect in useWatch for subscription similar to useForm (#12786) 🐞 fix #12772 reset form useWatch to utilize ref for defaultValue and … (#12780) 📭 close #12773 pass input ref instead partial (#12775)

🐞 fix #12761 #12762 issue with usage reset isReady formState (#12765) 🐞 fix #12763 import warning with named exports (#12764)

⏰ feat: introduce isReady state for subscription (#12568)

const { formState: { isReady }, setValue } = useForm()

useEffect(() => {
  // form subscription setup is ready
  if (isReady) setValue('test', 'value')
}, [isReady])

🌗 feat: support reactive mode and reValidateMode (#12743) 🐞 fix #12741 regression on move/swap on useFieldArray input update (#12749) 🐞 fix: use useIsomorphicLayoutEffect to address warning in SSR (#12738)

⏰ feat: introduce isReady state for subscription (#12568)

const { formState: { isReady }, setValue } = useForm()

useEffect(() => {
  // form subscription setup is ready
  if (isReady) setValue('test', 'value')
}, [isReady])

🌗 feat: support reactive mode and reValidateMode (#12743) 🐞 fix #12741 regression on move/swap on useFieldArray input update (#12749) 🐞 fix: use useIsomorphicLayoutEffect to address warning in SSR (#12738)

⚡️ createFormControl

• Allow us to start subscribing outside of the React component

const { formControl, control } = createFormControl(props)

function App() {
  const { register } = useForm({
    formControl,
  })

  return <form />
}

function Test() {
  useFormState({
    control // no longer need context api
  })
}

⚡️ subscribe

• subscribe form state update without re-render
• subscribe outside of the react component

const { formControl } = createFormControl(props)

formControl.subscribe({
  formState: { isDirty: true },
  callback: (formState) => {
    if (formState.isDirty) {
      // do something here
    }
  }
})

function App() {
  const { register } = useForm({
    formControl,
  })

  return <form />
}

🪲 fix https://github.com/react-hook-form/react-hook-form/issues/12680: Update Fieldarray Unmount Status (https://github.com/react-hook-form/react-hook-form/pull/12690) 🫡 fix: improve type inference for useFormContext (https://github.com/react-hook-form/react-hook-form/pull/12689) 👮‍♂️ feat: infer resolver output types (https://github.com/react-hook-form/react-hook-form/pull/12638) 🐞 fix(useForm): make values and defaultValues work correctly with createFormControl and useMemo (https://github.com/react-hook-form/react-hook-form/pull/12675) 🥹 close https://github.com/react-hook-form/react-hook-form/issues/12665 issue with values not populate form 🐞 fix https://github.com/react-hook-form/react-hook-form/issues/12665 regression on values over take default values 🫡 allow use of handleSubmit with native events (https://github.com/react-hook-form/react-hook-form/pull/12645) 🐞 fix https://github.com/react-hook-form/react-hook-form/issues/12631 revalidateMode issue with useFieldArray validation (https://github.com/react-hook-form/react-hook-form/pull/12646) 🦥 close https://github.com/react-hook-form/react-hook-form/issues/12634 allow components with useController hook be memoized (https://github.com/react-hook-form/react-hook-form/pull/12635) 🐞 fix https://github.com/react-hook-form/react-hook-form/issues/12580 setError in useEffect does not work when used inside the FormProvider context (https://github.com/react-hook-form/react-hook-form/pull/12642) 🛟 fix: add the condition to prevent infinite render with errors prop (https://github.com/react-hook-form/react-hook-form/pull/12622) 🐞 fix https://github.com/react-hook-form/react-hook-form/issues/12580 valid state update with onBlur mode (https://github.com/react-hook-form/react-hook-form/pull/12612) 🐞 fix https://github.com/react-hook-form/react-hook-form/issues/12572 disabled field value not get undefined in resolver (https://github.com/react-hook-form/react-hook-form/pull/12573) 🦾 feat: reference stable for useWatch defaultValue (https://github.com/react-hook-form/react-hook-form/pull/12564) ⏰ chore: remove typetest folder from build (https://github.com/react-hook-form/react-hook-form/pull/12555) 🐞 fix https://github.com/react-hook-form/react-hook-form/issues/12532 useController should unregister issue with strict mode (https://github.com/react-hook-form/react-hook-form/pull/12538) 👁️ feat: improve reference update with useWatch (https://github.com/react-hook-form/react-hook-form/pull/12537) 🦥 close https://github.com/react-hook-form/react-hook-form/issues/12531 disabled state issue with touched and dirty (https://github.com/react-hook-form/react-hook-form/pull/12536)

thanks to @jtomaszewski, @joshkel, @candymask0712, @kotarella1110, @jorisre, @jtomaszewski, @controversial and @jedahu