build(deps): update dependency nuqs to v2

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
nuqs (source)	1.20.0 -> 2.3.1

---

Release Notes

47ng/nuqs (nuqs)

v2.3.1

Compare Source

Bug Fixes

• Export UrlKeys type helper (#​854) (8b6d3e9)
• Maintain location.state in React Router frameworks (#​840) (39d6f4a)
• Referential stability for the state updater function (#​841) (c089be2)

Performance Improvements

• Optimise render counts (#​849) (fa63c13)

v2.3.0

Compare Source

Features

• Added react-router v7 support (#​785) (650bd65) - Thanks @​teukuamru!
• Shallow routing for everyone (#​811) (abbbb56)
• Add loader feature (#​818) (4762b04)
• Add UrlKeys type helper (#​824) (479d5ea)
• Abstract reading from location.search in adapters interface (#​800) (1635863)

Bug Fixes

• Preserve hash in React Router based adpaters (#​809) (e4154a1)
• Support ? characters in serializer base (#​821) (8951598), closes #​812 - Thanks @​ealvarezk!
• types: Export Nullable type for correctly inferring return type of createSerializer() (#​801) (ab99d7d) - Thanks @​MartinCura!

Other changes

• doc: Add Liminity.se as sponsor 💖 by @​franky47 in https://github.com/47ng/nuqs/pull/789
• chore: Run GHA on Ubuntu 24.04 by @​franky47 in https://github.com/47ng/nuqs/pull/797
• chore: React 19 by @​franky47 in https://github.com/47ng/nuqs/pull/796
• docs: Document testing nuqs based hooks by @​sebastianvitterso in https://github.com/47ng/nuqs/pull/795
• test: Move relevant e2e tests to be unit tests by @​franky47 in https://github.com/47ng/nuqs/pull/802
• test: Move e2e tests into shared library by @​franky47 in https://github.com/47ng/nuqs/pull/807
• chore: Update dependencies by @​franky47 in https://github.com/47ng/nuqs/pull/813
• chore: Enable provenance by @​franky47 in https://github.com/47ng/nuqs/pull/819
• doc: Fix link to options docs by @​blyme in https://github.com/47ng/nuqs/pull/825
• ref: Use a useEffect rather than useLayoutEffect by @​franky47 in https://github.com/47ng/nuqs/pull/828
• test: Add native HTML form test by @​franky47 in https://github.com/47ng/nuqs/pull/829
• chore: Reduce the amount of Slack notifications by @​franky47 in https://github.com/47ng/nuqs/pull/834
• ref: Enable history patching by default for React Router by @​franky47 in https://github.com/47ng/nuqs/pull/833
• chore(deps): bump actions/upload-artifact from 4.4.3 to 4.5.0 by @​dependabot in https://github.com/47ng/nuqs/pull/835

New Contributors

• @​teukuamru made their first contribution in https://github.com/47ng/nuqs/pull/785
• @​sebastianvitterso made their first contribution in https://github.com/47ng/nuqs/pull/795
• @​blyme made their first contribution in https://github.com/47ng/nuqs/pull/825

Full Changelog: 47ng/nuqs@v2.2.3...v2.3.0

v2.2.3

Compare Source

Bug Fixes

• Encode invisible ASCII control characters (#​783) (c768757) - Thanks @​WKampel!
• Protection against null useSearchParams in Next.js (#​781) (56e15a0) - Thanks @​Kamalito75!

v2.2.2

Compare Source

Bug Fixes

• Update useQueryStates state cache when syncing useSearchParams (#​776) (a504e0e) - Thanks @​tariwiencke & @​geemanjs!

v2.2.1

Compare Source

Bug Fixes

• serializer/types: Allow null value in serializer for parsers with default values (#​769) (84c5189) - Thanks @​MartinCura!

v2.2.0

Compare Source

Features

• Add testing HOC to reduce test setup verbosity (#​765) (777627e)

Bug Fixes

• Add React 19 RC in peer dep semver range (#​756) (06d6e39) - Thanks @​aeonzz!
• Support for dynamic default values in useQueryStates (#​762) (6ee72ee) - Thanks @​pdme !
• Make the testing adapter clear the URL queue (#​764) (8200add)

v2.1.2

Compare Source

Bug Fixes

• Log an error in development if URI size of 2000 characters is exceeded. (#​747) (3017660) - Thanks @​niklasbec !
• Use correct keys for state sync (#​759) (6bc229a), closes #​758 - Thanks @​hallucinogenizer !

v2.1.1

Compare Source

Bug Fixes

• adapters/next/app: wrap optimistic search params update in startTransition (#​729) (01af1ea) - Thanks @​aryasaatvik !

v2.1.0

Compare Source

Bug Fixes

• Use optimistic search params in app router (#​718) (b5c0168), closes #​714 - Thanks @​aurorascharff !

Features

• Add parseAsISODate (#​707) (107fcc1) - Thanks @​tylersayshi !
• Add support for urlKeys in cache (#​725) (b8dcc6f), closes #​720 - Thanks @​anaclumos !
• Add urlKeys & clearOnDefault support for serializer (#​720) (c701afd), closes #​715 - Thanks @​blechatellier !
• Export OnUrlUpdateFunction type for Vitest v2 (#​712) (0645c51) - Thanks @​bryanjtc !
• Export the SearchParams type in both client & server bundles (#​710) (5a926f7)

v2.0.4

Compare Source

Bug Fixes

• Read queued updates when initialising state (#​703) (caa3779), closes #​702

v2.0.3

Compare Source

Bug Fixes

• Add stub CJS exports for old ESLint plugins (#​701) (464506b), closes #​691 - Thanks @​GBvanDam & @​acocheo !

v2.0.2

Compare Source

Bug Fixes

• Make clearOnDefault: true by default (#​700) (56c223f)

v2.0.1

Compare Source

Bug Fixes

• Add back the .js extension to the pages router adapter (#​694) (cd5bec1) - Thanks @​tiagoskaneta !
• Mark framework packages as optional peer dependencies (#​697) (df9e834) - Thanks @​nezouse !

v2.0.0

Compare Source

• Announcement post: https://nuqs.47ng.com/blog/nuqs-2
• Migrations docs: https://nuqs.47ng.com/docs/migrations/v2

Bug Fixes

• parseAsJson now requires a runtime validation function (53a37d4)

chore

• Drop mirrorring to next-usequerystate (4616a7b)
• ESM only (drop CJS support) (408fd38)
• Move urlKeys into the UseQueryStatesOptions type (8950bc8)
• Remove deprecated APIs (8d2ba24), closes #​425
• Rename nuqs/parsers to nuqs/server (b6bdc66)
• Update list of supported versions (9665a93)
• Update minimum supported Next.js version (c509a99), closes vercel/next.js#61419

Features

• Add adapter for One (a56aa11)
• Add custom adapters API (unstable) (3ef698f)
• Add React Router adapter (cb30a20)
• Add Remix adapter (4ae6c81)
• Add vanilla React adapter sandbox (e603a4d)
• Introducing adapters for other frameworks (a101370), closes #​603 #​620
• Provide specialised adapters for both Next.js routers (ac95384)
• Render pretty URLs in other adapters (6618f45)

BREAKING CHANGES

• Pass in a validation function like a Zod schema parse function
  to validate at runtime and infer the type of the returned data.
• UseQueryStatesOptions is now generic over the key map
  (the object containing parser definitions you pass to useQueryStates),
  and is now a type rather than an interface.
• When using Next.js, nuqs v2 requires next@>=14.2.0.
• nuqs now requires wrapping your app
  with a NuqsAdapter, which is a context provider connecting
  your framework APIs to the hooks' internals.
• The startTransition option no longer
  automatically sets shallow: false. The Options type
  is no longer generic.
• The "use client" directive was not included
  in the client import (import {} from 'nuqs'). It has now been added,
  meaning that server-side code needs to import from nuqs/server
  to avoid errors like:

Error: Attempted to call withDefault() from the server but withDefault is on
the client. It's not possible to invoke a client function from the server, it can
only be rendered as a Component or passed to props of a Client
Component.

• Drop support for [email protected]

Due to a bug in the implementation of shallow routing (WHS),
14.0.3 required a special case for syncing
against external navigation.

In [email protected], we're cleaning this up and requiring
a version of Next.js with bug-free support for
shallow routing (with or without experimental WHS
in 14.0.4, and with stabilised WHS in 14.0.5 onwards).

• export path has been renamed. Contents are identical.

Since the /parsers export contained the server cache,
this name makes better sense and helps outline the client/server
nature of features in nuqs.

• package is now only updating on the nuqs name.

The debugging printouts no longer check for next-usequerystate, only nuqs.

• the following deprecated APIs have been removed:

• queryTypes bag of parsers -> use individual parseAsXYZ parsers
  for better tree-shakeability.
• subscribeToQueryUpdates helper -> since Next.js 14.0.5,
  useSearchParams is reactive to shallow search params updates

• drop CJS support.

Since Next has ESM support since v12, it should not really be a breaking change for most.

Big thanks to @​andreisocaciu, @​tordans, @​prasannamestha, @​Talent30, @​neefrehman, @​chbg, @​dopry, @​weisisheng, @​hugotiger, @​iuriizaporozhets, @​rikbrown, @​mateogianolio, @​timheerwagen, @​psdmsft, and @​psdewar for helping !

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
interval.so	⬜️ Ignored (Inspect)	Visit Preview		Jan 14, 2025 6:23pm

[vercel]

Deployment failed with the following error:

Resource is limited - try again in 1 hour (more than 100, code: "api-deployments-free-per-day").

[vercel]

Deployment failed with the following error:

Resource is limited - try again in 42 minutes (more than 100, code: "api-deployments-free-per-day").

[vercel]

Deployment failed with the following error:

Resource is limited - try again in 7 minutes (more than 100, code: "api-deployments-free-per-day").

[vercel]

Deployment failed with the following error:

Resource is limited - try again in 2 hours (more than 100, code: "api-deployments-free-per-day").