final-form

New Features

• Added destroyOnUnregister config flag to blow away field values when a field is unmounted. Defaults to false. #133

🤦‍♂️

Burned through a few versions because NPM was acting wonky. I wouldn't necessarily trust v4.7.1 or v4.7.2, even though the only thing that changed was the version number.

Typing Fixes

• Fixed problem with exported configKeys value. Only used internally to interact with react-final-form.

New Features

• New keepDirtyOnReinitialize config flag #130 https://github.com/final-form/react-final-form/issues/246

Bug Fixes

• Fixed a bug in hadValidationErrors that was reporting true when there were no errors. #121 #123 #126

New API

• New form.isValidationPaused() API needed to fix a bug in 🏁 React Final Form. #119

Bug fixes

• Improved performance by halting notifications when validation is paused, such as when many fields are being registered on first render. #118

Type Fixes

• Type signature was wrong for reset() on both Flow and Typescript. #114

v4.5.0 was broken. 😳

Features

• New hasSubmitErrors and hasValidationErrors boolean flags added to FormState to make it easier to ascertain why invalid === true. #108 #80 #81 https://github.com/final-form/react-final-form/issues/89
• initialValues can now be passed to reset to avoid having to do reset(); initialize(values); #100 #98 #99
• Dropped use of Symbol in favor of unique strings. This removes the need for polyfills for older browsers. #109 #106
• Babel loose mode trimmed some bytes off the bundle size. #112
• Dropped for-of syntax to trim further bytes off the bundle size. #111

Bug Fixes

• Submit errors are now resolved from the Promise returned by submit() #107 #78
• Field-level validation errors are now cleared when the last field with that name is unregistered. #110 #101
• Fields were not all getting marked as touched when a submission failed with submit errors. #113 https://github.com/final-form/react-final-form/issues/186

Bug Fixes

• Fixed very annoying bug where clearing one field-level validation error would erase them all. #94 #75

New Features

• New way to set an error on an array of fields. #92

import { ARRAY_ERROR } from 'final-form'

...

errors.items = []
errors.items[ARRAY_ERROR] = 'You need some items'

• New form.getFieldState(fieldName) API to inquire about the state of a given field. #93 #91

Bug Fixes

• Added semaphore to schedule notifications after all notifications are complete #90 https://github.com/final-form/final-form-calculate/issues/8

New Features

• Added a new setConfig function to allow realtime updating of config values #87 final-form/react-final-form#128

Flow Fixes

• Fixed exported flow types #89 final-form/react-final-form#142

Bug Fixes

• Reset submit state (e.g. submitFailed, etc.) when form.reset() is called. #84 #72
• Await async validation before submission #83 #82

New Features

• You can now pauseValidation() and resumeValidation() to have finer control over when the automatic validation is run. #74 #73

Bug Fixes

• Fixed bug where setting an array value to undefined was removing it from the array. #69 https://github.com/final-form/react-final-form/issues/133

Flow Fixes

• Sealed subscription flow types. #71 #67

New Features

• Added touched and visited objects to subscribable form state. #70 https://github.com/final-form/react-final-form/issues/132

Typescript fixes

• Ensure mutators is defined to avoid bad strongly typed developer casting experience #68

For some reason v4.0.2 did not have the changes it was supposed to have... 🤷‍♂️

Typescript fixes

• Fixed some broken types #66 #65

Typescript Fixes

• Added typescript regression tests and fixed some minor type errors #61

Bug Fixes

• submitFailed is now true if the submission failed because of sync validation errors. #64 #63

⚠️ BREAKING CHANGE ⚠️

It's fairly minor, but when you register a field now, rather than provide a field-level validation function, now you must provide a function that returns the validation function. The migration is pretty trivial:

v3.x.x

form.registerField(
  'firstName',
  fieldState => { // do something with field state },
  fieldSubscription,
  {
    validate: value => { // return error }
  }
)

v4.x.x

form.registerField(
  'firstName',
  fieldState => { // do something with field state },
  fieldSubscription,
  {
    validate: () => value => { // return error }
//            ^^^^^--- ADD THIS 👀
  }
)