fix: preserve parsed value identity across hooks by franky47 · Pull Request #1549 · 47ng/nuqs

franky47 · 2026-08-15T16:44:32Z

Summary

preserve parsed object identity when query state is shared across hooks or remounted
support equivalent parser factories created during render without redundant updates
avoid extra render-count and cross-route reconciliation commits
keep the client, minimal, and server bundles within their configured limits

Stacked on #1482; review only the five commits on top of ref/single-store.

vercel · 2026-08-15T16:44:40Z

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

Project	Deployment	Actions	Updated
nuqs	Ready	Preview	Sep 3, 2026 11:11am UTC

coderabbitai · 2026-08-15T16:44:45Z

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: aa7e7155-7200-42cb-bfd6-b53d81967a2a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

pkg-pr-new · 2026-08-15T16:45:05Z

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

commit: 38fc3e4

github-actions · 2026-08-15T20:51:45Z

Bundle size

	Base	PR	Δ
✅ Client	5.97 kB	5.90 kB	⬇️ -71 B
✅ Client (minimal tree-shaken)	4.41 kB	4.16 kB	⬇️ -262 B
✅ Server	3.64 kB	3.43 kB	⬇️ -221 B

Brotli-compressed. Limits are set in the size-limit config in packages/nuqs/package.json.

parseAsIsoDateTime returns a new Date object on every render, even when neither the query string nor the instant it encodes has changed. The existing referential-equality suite covers default values and parseAsJson objects but not a value parsed from the URL, so this gap is untested. Three failing cases, in the existing describe block: - a Date read from an unchanged URL loses referential equality across re-renders of a single mounted hook - the same across remounts - the consequence: a remounted subscriber that reports its parsed value upward re-keys itself indefinitely (53 renders and climbing, with no writes to the URL and no change of value) Measured with parseAsIsoDateTime, which ships eq: compareDates, so the parser's own equality function is not consulted on this path.

…tack-pr1549-20260902

…ue-1531-pr1482 # Conflicts: # packages/nuqs/src/lib/parse-cache.client.ts # packages/nuqs/src/lib/queues/throttle.ts # packages/nuqs/src/useQueryStates.ts

franky47 added this to the 🪵 Backlog milestone Aug 15, 2026

franky47 added bug Something isn't working feature/useQueryStates AI slop PR generated by AI, needs some cleanup before merging labels Aug 15, 2026

vercel Bot deployed to Preview August 15, 2026 20:51

View deployment

vercel Bot had a problem deploying to Preview August 20, 2026 10:23 Failure

vercel Bot deployed to Preview August 20, 2026 10:39

View deployment

vercel Bot deployed to Preview August 20, 2026 10:50

View deployment

franky47 force-pushed the repro/issue-1531-pr1482 branch from 2173529 to 4890c8e Compare August 26, 2026 09:01

vercel Bot deployed to Preview August 26, 2026 09:02

View deployment

franky47 force-pushed the repro/issue-1531-pr1482 branch from 4890c8e to 7de9dd0 Compare August 30, 2026 09:17

vercel Bot deployed to Preview August 30, 2026 09:19

View deployment

vercel Bot deployed to Preview August 30, 2026 10:02

View deployment

vercel Bot deployed to Preview August 30, 2026 10:12

View deployment

Gjdoalfnrxu and others added 12 commits September 3, 2026 00:06

fix: preserve parsed value identity across hook writes

a9d236a

perf: reduce structural sharing bundle cost

03efee9

fix: preserve inline parser identity

9ece2f4

fix: avoid redundant query state renders

052b988

fix: preserve query state in Cache Components

1d72ba5

perf: trim default value application

c603c0c

perf: keep minimal bundle below limit

6307156

perf: keep rebased bundle below limits

73603da

perf: combine bundle size reductions

44a1f65

perf: refine bundle size reductions

a6d41d2

test: strengthen queue regression coverage

ef27ca6

franky47 added 3 commits September 3, 2026 00:06

fix: preserve published value identity across parsers

72649f5

fix: share parse publications across copies

16de20e

test: adapt debounce tests to resolver aborts

b6fb640

franky47 mentioned this pull request Sep 2, 2026

chore: compare mutation test files #1576

Merged

Merge remote-tracking branch 'origin/ref/single-store' into agent/res…

bfb2de0

…tack-pr1549-20260902

franky47 force-pushed the repro/issue-1531-pr1482 branch from a80deb0 to bfb2de0 Compare September 3, 2026 07:46

vercel Bot deployed to Preview September 3, 2026 07:47

View deployment

franky47 mentioned this pull request Sep 3, 2026

perf: reduce the client bundle at the top of the single-store stack #1578

Closed

franky47 added 6 commits September 3, 2026 13:07

Merge remote-tracking branch 'origin/ref/single-store' into repro/iss…

2357538

…ue-1531-pr1482 # Conflicts: # packages/nuqs/src/lib/parse-cache.client.ts # packages/nuqs/src/lib/queues/throttle.ts # packages/nuqs/src/useQueryStates.ts

fix: re-parse a restored query after its key left the URL

077de20

fix: keep parse cache publication versions unique and stable

8bae064

ref: keep the raw value records read-only

56b3641

ref: name the warn code subset

0360526

test: drop the stale Date comments

38fc3e4

vercel Bot deployed to Preview September 3, 2026 11:11

View deployment

franky47 removed this from the 🪵 Backlog milestone Sep 3, 2026

franky47 added the 🧟 zombieland Closed PRs to be reopened later label Sep 17, 2026

franky47 closed this Sep 17, 2026

Navigation Menu

Repository navigation

fix: preserve parsed value identity across hooks - #1549

fix: preserve parsed value identity across hooks#1549
franky47 wants to merge 22 commits into
ref/single-storefrom
repro/issue-1531-pr1482

franky47 commented Aug 15, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Aug 15, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Aug 15, 2026 •

edited

Loading

Review skipped

Uh oh!

pkg-pr-new Bot commented Aug 15, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 15, 2026 •

edited

Loading

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

franky47 commented Aug 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

vercel Bot commented Aug 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Aug 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

pkg-pr-new Bot commented Aug 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle size

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

franky47 commented Aug 15, 2026 •

edited

Loading

vercel Bot commented Aug 15, 2026 •

edited

Loading

coderabbitai Bot commented Aug 15, 2026 •

edited

Loading

pkg-pr-new Bot commented Aug 15, 2026 •

edited

Loading

github-actions Bot commented Aug 15, 2026 •

edited

Loading