Decide about replace or push state inside callback

[dt-mkuster]

Problem Description

Currently, with the setSearchParams API, I cannot dynamically decide whether to replace or push a history entry based on the difference between the previous state and the new state.

For example:

setSearchParams((prev) => {
  // I want to decide here based on the prev and the new state
}, { replace: true });

The replace option is passed outside the callback, making it impossible to compute dynamically based on changes between prev and next.

Proposed Solution
Allow the replace option to be decided dynamically, either by:

Allowing the callback to return both next and replace:

setSearchParams((prev) => {
  const next = new URLSearchParams(prev);
  next.set('filter', 'newFilter');
  const replace = prev.get('filter') === next.get('filter');
  return { next, replace };
});

Making replace a callback that receives prev and next:

setSearchParams((prev) => {
  const next = new URLSearchParams(prev);
  next.set('filter', 'newFilter');
  return next;
}, { replace: (prev, next) => prev.get('filter') === next.get('filter') });

Why This Matters
This would simplify handling cases like:

Replacing history for incremental updates (e.g., typing in an input).
Pushing history for significant changes (e.g., dropdown selection).
Let me know if you'd like more details!