Fix FilterSelect jumping issue

[mcwinter07]

Why

This is a second (third?) attempt at resolving the Select / FilterSelect jump issue.

Steps to replicate (prior to this fix)

In chrome

1. Go to a page with the FilterSelect that does not have a selected value (see a somewhat janky example with the stickersheets here)
2. use keyboard navigation to open the FilterSelect
3. The view should jump up to the top of the page

Why we think this happens

This component is composed of many primitive that seek to control focus management. The suspected culprit is the React Aria listbox keyboard behavior.

We've had to try a co-opt its focus management manually but due to how it renders, seemingly its start position is above the page, causing the jump on focus.

What

I've introduced a hook that checks for a stable y position that should ensure that the focus resolve after it is a single value

[changeset-bot]

🦋 Changeset detected

Latest commit: e20b8b0

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mcwinter07]

Validated this would in survey-reporting-ui with the canary 0.0.0-canary-fix-filter-select-jump-issue-useHasStableYPosition-20250120225815, will check with the two teams that reported this to see if it works ok for them

[github-actions]

✨ Here is your branch preview! ✨

• Storybook

Last updated for commit e20b8b0: update useHasCalculatedListboxPosition hook to reduce the number of intervals

[dougmacknz]

Would it make sense, and is possible to clear the interval here as well?

[mcwinter07]

Nice spot on this, the interval was re-running constantly while the popover was open. I've updated the interval to call itself only while is position is not stable, so we're going from this:

To this: