Add updateSearchParams function to useSearchParams hook

[itelo]

This PR:

I love the idea from https://github.com/ethanniser/next-typesafe-url/issues/84. I added the code needed, and it works as suggested in https://github.com/ethanniser/next-typesafe-url/issues/84#issuecomment-1904482503.

[] ~Yes, I have made a changeset~ Not yet; I want to make sure I'm on the right path before I finish this PR

Missing tests 👀

[ethanniser]

Thanks for this

I just got back from Europe today and have a lot this week, so gimme a couple days to review

If I forget feel free to ping me

[itelo]

@ethanniser can you take a look at this? I believe I will need to add react-testing-library to test the hook

[ethanniser]

sorry I took so long, just had a look and I like it and think it has a place

the stuff I would like to see:

• rename updateSearchParams to setSearchParams to match existing api naming
• setState style update function that provides the previous search params

  setUrlParams({foo: "bar"})
  setUrlParams((prev) => ({ foo: prev.foo + "!" }))

• either: returning the search params in a tuple to match useState api (open to discussion) or not having seachParams as a nested object- so basically previous api + updateSearchParams (would be better for backwards compat if we care about that)

  // possible options
  [searchParams, setSearchParams] = useSearchParams(Route.searchParams);
  {searchParams, setSearchParams} = useSearchParams(Route.searchParams);
  {data, isLoading, isError, error, setSearchParams} = useSearchParams(Route.searchParams);

and then will need tests + docs but overall I think this will be a good addition thanks for the contribution