chore: Update list of supported versions

BREAKING CHANGE: Drop support for next@14.0.3

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

In `nuqs@2.x`, 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).

Author: franky47

Diff for: .github/workflows/ci-cd.yml

@@ -24,16 +24,15 @@ jobs:
         base-path: [false, '/base']
         window-history-support: [false]
         next-version:
-          - '13.4'
+          - '13.4' # App router in GA
           - '13.5'
           - '14.0.1'
           # 14.0.2 is not compatible due to a prefetch issue
-          # 14.0.3 requires the WHS flag (see below)
+          # 14.0.3 is dropped due to a bug requiring WHS + syncing against uSP,
+          #        which creates other problems under other versions of Next.js
           - '14.0.4'
           - latest # Current latest is 14.1.0
         include:
-          - next-version: '14.0.3'
-            window-history-support: true
           # 14.0.4 doesn't require the WHS flag, but supports it
           - next-version: '14.0.4'
             window-history-support: true

Diff for: packages/docs/content/docs/migrations/v2.mdx

@@ -3,6 +3,14 @@ title: Migration guide to v2
 description: How to update your code to use nuqs@2.0.0
 ---
 
+## Dropped support for `next@14.0.3`
+
+It may seem weird to drop support for a single patch version, and keep it for
+older versions, but this is due to a bug in shallow routing in Next.js 14.0.3
+that was fixed in 14.0.4, and that became hard to work around without ugly hacks.
+
+See #423 for context and a table of supported versions.
+
 ## ESM only
 
 `nuqs@2.0.0` is now an [ESM-only](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c)

Diff for: packages/nuqs/package.json

@@ -56,7 +56,7 @@
     "prepack": "./scripts/prepack.sh"
   },
   "peerDependencies": {
-    "next": ">=13.4 <14.0.2 || ^14.0.3",
+    "next": ">=13.4 <14.0.2 || ^14.0.4",
     "react": "^18.2.0"
   },
   "dependencies": {

Diff for: packages/nuqs/src/useQueryState.ts

@@ -240,19 +240,6 @@ export function useQueryState<T = string>(
     initialSearchParams?.get(key) ?? null
   )
 
-  React.useEffect(() => {
-    // This will be removed in v2 which will drop support for
-    // partially-functional shallow routing (14.0.2 and 14.0.3)
-    if (window.next?.version !== '14.0.3') {
-      return
-    }
-    const value = initialSearchParams.get(key) ?? null
-    const state = value === null ? null : safeParse(parse, value, key)
-    debug('[nuqs `%s`] syncFromUseSearchParams %O', key, state)
-    stateRef.current = state
-    setInternalState(state)
-  }, [initialSearchParams?.get(key), key])
-
   // Sync all hooks together & with external URL changes
   React.useInsertionEffect(() => {
     function updateInternalState(state: T | null) {