Fix <FilterLiveForm> compatibility with react-hook-form 7.55.0, part 2

[slax57]

Problem

Despite #10657, 2 issues are still present when using RHF version >= 7.55.0:

• Last filter can not be removed if multiple filters added #10695
• A bug occurs when using enterprise component DatagridAG: Applying a filter from ag-grid, then leaving the page and coming back to it, then clearing all filters with the 'Remove all filters' button => brings back the filter added previously via ag-grid

Closes #10695

Solution

It turns out the fix brought by #10657 was not enough.
In a nutshell, this fix made it so that the filter form is not reset if changed values only affect fields that are not part of the form. But the form was still initialized with defaultValues equal to the filterValues, so external values could still leak into the form state.
Part of the solution is then to remove the form defaultValues, and rely only on the useEffect to (selectively) apply them.

Other part of the solution was to remove the formChangesPending ref, as it turns out this workaround no longer works with RHF v7.55.0 onwards, because they tend to call the useWatch callback multiple times, even for fields whose value has not changed.
Instead, properly managing the form state and only resetting when values known to the form are modified (i.e. part 1 of the fix above) seems to be enough to avoid re-applying old values.

How To Test

2 new stories were added:

• http://localhost:9010/?path=/story/ra-core-form-filterliveform--multiple-filter-live-form-overlapping
• http://localhost:9010/?path=/story/ra-core-form-filterliveform--with-external-changes

Also, #10695 can be reproduced in story http://localhost:9010/?path=/story/ra-ui-materialui-list-filter-filterbutton--basic

Unit tests were added to cover all known issues.

=> Hence, to test the fix, I recommend:

1. Playing around with the added stories (the unit tests are already run by the CI)
2. Then, update RHF to its latest version by running yarn up react-hook-form, run the unit tests (make test-unit), the E2E tests (make test-e2e), and then play with the added stories (make storybook)

Note: You will notice that some tests not related to filters are failing when using RHF v7.56.1, which is something we'll need to address in a future PR, but all tests related to filters should pass with this PR.

Additional Checks

• The PR targets master for a bugfix or a documentation fix, or next for a feature
• The PR includes unit tests (if not possible, describe why)
• The PR includes one or several stories (if not possible, describe why)
• The documentation is up to date

Also, please make sure to read the contributing guidelines.

[slax57]

Some E2E tests are failing, back to WIP

[slax57]

Fixed, back to RFR!

[djhi]

This looks good but maybe we should update react-hook-form to its latest version?

[slax57]

I agree but we should do that on next. Besides, as I said, some other tests are failing which we'll need to investigate (soon).