fix: TypeError in serializer for array with default value

[janglad]

Previously

const serialize = createSerializer({
	arr: parseAsArrayOf(parseAsString).withDefault([])
 })

would throw when serialising with { arr : null } .

TypeError: Cannot read properties of null (reading 'length')
 ❯ eq src/parsers.ts:504:13
    502|         return true // Referentially stable
    503|       }
    504|       if (a.length !== b.length) {
       |             ^
    505|         return false
    506|       }

From what I understand this should be allowed, and is indicated as such in the types. This was caused by the equality fn being called with null. This PR fixes this and adds a test to cover this case.

[vercel]

@janglad is attempting to deploy a commit to the 47ng Team on Vercel.

A member of the Team first needs to authorize it.

[franky47]

Ah, good catch, thanks! Yes it should definitely allow null values on properties to remove them.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
nuqs	Ready	Preview	Comment	Nov 4, 2025 0:04am

[pkg-pr-new]

pnpm add https://pkg.pr.new/nuqs@1197

commit: bec3404

[franky47]

I need to work on the CI part of things to follow NPM's new security directives (OIDC trusted publishing), as they will deprecate long-lived deployment tokens soon, then this should be good to go live.

Feel free to use the pkg.pr.new deployment if you want to use the hotfix in the mean time:

pnpm add https://pkg.pr.new/nuqs@bec3404

[github-actions]

🎉 This PR is included in version 2.7.3-beta.1 🎉

The release is available on:

• npm package (@beta dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[github-actions]

🎉 This PR is included in version 2.7.3 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀