Feat: useSearchParams supports functional updates like React.useState

[promet99]

What this PR does

This PR modifies setSearchParams to support functional updates, just like setState of React.useState.
setSearchParams can take a function of type ((prev: URLSearchParams) => URLSearchParamsInit) as an input.
When given a function of aforementioned type, setSearchParams will provide current searchParams to the given function, and its returned value will be set as searchParams.

Why this PR is made

1. Current react-router documentation makes an analogy between useState and useSearchParams. Adding this to minor feature will further accommodate the analogy.
2. I personally have seen&used this feature being implemented in several different codebases. It proved to be useful.
3. Only one small logic and several lines of code are added, so this change will keep react-router slim.

What can be further done

This change can also be implemented to react-router-dom package too.
Not having used react-router-dom package before, I have excluded it from this PR.

Etc

Feature, test, and documentation are all included.

[brophdawg11]

Hey @promet99! It looks like this has some conflicts with the 6.4.0 work that was just merged down into dev - would you mind taking a look at those?

[ryanflorence]

Looks good, @brophdawg11 let's get this over the finish line.

[brophdawg11]

Thank you for the PR @promet99! I'm going to merge this to an interim branch so I can fix up the conflicts and handle the react-router-native side of things, and then I'll PR the interim branch to dev with both sets of changes 👍

[promet99]

@

Thank you for the PR @promet99! I'm going to merge this to an interim branch so I can fix up the conflicts and handle the react-router-native side of things, and then I'll PR the interim branch to dev with both sets of changes 👍

Thanks a lot!