feat: Added react-router v7 support

packages/nuqs/adapters/react-router/v6.d.ts

@@ -0,0 +1,7 @@
+// This file is needed for projects that have `moduleResolution` set to `node`
+// in their tsconfig.json to be able to `import {} from 'nuqs/adapters/react-router'`.
+// Other module resolutions strategies will look for the `exports` in `package.json`,
+// but with `node`, TypeScript will look for a .d.ts file with that name at the
+// root of the package.
+
+export * from '../../dist/adapters/react-router/v6'

packages/nuqs/adapters/react-router/v7.d.ts

@@ -0,0 +1,7 @@
+// This file is needed for projects that have `moduleResolution` set to `node`
+// in their tsconfig.json to be able to `import {} from 'nuqs/adapters/react-router'`.
+// Other module resolutions strategies will look for the `exports` in `package.json`,
+// but with `node`, TypeScript will look for a .d.ts file with that name at the
+// root of the package.
+
+export * from '../../dist/adapters/react-router/v7'

packages/nuqs/package.json

@@ -88,6 +88,16 @@
       "import": "./dist/adapters/react-router.js",
       "require": "./esm-only.cjs"
     },
+    "./adapters/react-router/v6": {
+      "types": "./dist/adapters/react-router/v6.d.ts",
+      "import": "./dist/adapters/react-router/v6.js",
+      "require": "./esm-only.cjs"
+    },
+    "./adapters/react-router/v7": {
+      "types": "./dist/adapters/react-router/v7.d.ts",
+      "import": "./dist/adapters/react-router/v7.js",
+      "require": "./esm-only.cjs"
+    },
     "./adapters/custom": {
       "types": "./dist/adapters/custom.d.ts",
       "import": "./dist/adapters/custom.js",
@@ -117,7 +127,8 @@
     "@remix-run/react": ">=2",
     "next": ">=14.2.0",
     "react": ">=18.2.0 || ^19.0.0-0",
-    "react-router-dom": ">=6"
+    "react-router-dom": ">=6",
+    "react-router": ">=7"
   },
   "peerDependenciesMeta": {
     "@remix-run/react": {
@@ -128,6 +139,9 @@
     },
     "react-router-dom": {
       "optional": true
+    },
+    "react-router": {
+      "optional": true
     }
   },
   "devDependencies": {

packages/nuqs/src/adapters/react-router/v6.ts

@@ -0,0 +1,26 @@
+import { useNavigate, useSearchParams } from 'react-router-dom'
+import { renderQueryString } from '../../url-encoding'
+import type { AdapterOptions } from '../defs'
+import { createAdapterProvider } from '../internal.context'
+
+function useNuqsReactRouterV6Adapter() {
+  const navigate = useNavigate()
+  const [searchParams] = useSearchParams()
+  const updateUrl = (search: URLSearchParams, options: AdapterOptions) => {
+    navigate(
+      {
+        search: renderQueryString(search)
+      },
+      {
+        replace: options.history === 'replace',
+        preventScrollReset: !options.scroll
+      }
+    )
+  }
+  return {
+    searchParams,
+    updateUrl
+  }
+}
+
+export const NuqsAdapter = createAdapterProvider(useNuqsReactRouterV6Adapter)

packages/nuqs/src/adapters/react-router/v7.ts

@@ -0,0 +1,26 @@
+import { useNavigate, useSearchParams } from 'react-router'
+import { renderQueryString } from '../../url-encoding'
+import type { AdapterOptions } from '../defs'
+import { createAdapterProvider } from '../internal.context'
+
+function useNuqsReactRouterV7Adapter() {
+  const navigate = useNavigate()
+  const [searchParams] = useSearchParams()
+  const updateUrl = (search: URLSearchParams, options: AdapterOptions) => {
+    navigate(
+      {
+        search: renderQueryString(search)
+      },
+      {
+        replace: options.history === 'replace',
+        preventScrollReset: !options.scroll
+      }
+    )
+  }
+  return {
+    searchParams,
+    updateUrl
+  }
+}
+
+export const NuqsAdapter = createAdapterProvider(useNuqsReactRouterV7Adapter)

packages/nuqs/tsup.config.ts

@@ -7,7 +7,7 @@ const commonConfig = {
   format: ['esm'],
   experimentalDts: true,
   outDir: 'dist',
-  external: ['next', 'react', '@remix-run/react', 'react-router-dom'],
+  external: ['next', 'react', '@remix-run/react', 'react-router-dom', 'react-router'],
   splitting: true,
   treeshake: true,
   tsconfig: 'tsconfig.build.json'
@@ -22,6 +22,8 @@ const entrypoints = {
     'adapters/next/pages': 'src/adapters/next/pages.ts',
     'adapters/remix': 'src/adapters/remix.ts',
     'adapters/react-router': 'src/adapters/react-router.ts',
+    'adapters/react-router/v6': 'src/adapters/react-router/v6.ts',
+    'adapters/react-router/v7': 'src/adapters/react-router/v7.ts',
     'adapters/custom': 'src/adapters/custom.ts',
     'adapters/testing': 'src/adapters/testing.ts'
   },