Nextjs page router import error

[spotsccc]

Context

What's your version of nuqs?
2.5.2

What framework are you using?

✅/Next.js (pages router)

Which version of your framework are you using?
15.1.5

Description

When using nuqs in a Next.js project with Pages Router (/pages/...), importing hooks like useQueryState causes a crash in development mode:

Error: require() of ES Module /node_modules/nuqs/dist/index.js from /.next/server/pages/... not supported.
Instead change the require of index.js to a dynamic import() which is available in all

There is no errors in production build

[franky47]

What is your version of Node.js?

I'd suggest using 20.19.0 or higher (24 is entering LTS in a month, FYI), which contains better ESM/CJS interoperability.

[franky47]

I can't reproduce it with a fresh create-next-app install, even with Node.js 20.10 (ie: before require(esm)).

If you have a minimal reproduction example I could take a look at, that would help.