Add focusPrependedElements prop to useFocusZone, FilteredActionList, and SelectPanel

[kelsey-myers]

Part of https://github.com/github/primer/issues/6299

This PR adds support for the focusPrependedElements option through the component chain, in preparation for its upcoming release in @primer/behaviors. This allows SelectPanel consumers to enable focus navigation to elements that are dynamically prepended to the list container

Changelog

New

• Added focusPrependedElements prop to useFocusZone hook
• Added focusPrependedElements prop to FilteredActionList component
• Added focusPrependedElements prop to SelectPanel component

Changed

• Bumped @primer/behaviors to v1.9.1

Rollout strategy

• Patch release
• Minor release
• Major release; if selected, include a written rollout or migration plan
• None; if selected, include a brief description as to why

Testing & Reviewing

This PR adds optional props that pass through to @primer/behaviors focusZone(). The new focusPrependedElements option in @primer/behaviors is not yet released, so this will be tested once that PR is merged

Merge checklist

• Added/updated tests
• Added/updated documentation
• Added/updated previews (Storybook)
• Changes are SSR compatible
• Tested in Chrome
• Tested in Firefox
• Tested in Safari
• Tested in Edge
• (GitHub staff only) Integration tests pass at github/github (Learn more about how to run integration tests)

[changeset-bot]

🦋 Changeset detected

Latest commit: 635cc18

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

This PR includes changesets to release 1 package

Name	Type
@primer/react	Patch

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

[github-actions]

👋 Hi, this pull request contains changes to the source code that github/github-ui depends on. If you are GitHub staff, test these changes with github/github-ui using the integration workflow. Or, apply the integration-tests: skipped manually label to skip these checks.

[TylerJDev]

LGTM! Thanks for the PRs!

We could bump @primer/behaviors to v1.9.1 here too if you wanted, though I'm more than happy to make a separate PR for this 😄

[kelsey-myers]

LGTM! Thanks for the PRs!

We could bump @primer/behaviors to v1.9.1 here too if you wanted, though I'm more than happy to make a separate PR for this 😄

Done, thanks! 1e52623

[Copilot]

Pull request overview

This PR adds support for the focusPrependedElements option throughout the component chain to support an upcoming feature in @primer/behaviors v1.9.1. This enables SelectPanel consumers to allow focus navigation to elements that are dynamically prepended to list containers.

Key changes:

• Added focusPrependedElements prop to useFocusZone hook interface
• Threaded the prop through FilteredActionList and SelectPanel components
• Updated @primer/behaviors dependency from v1.9.0 to v1.9.1

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/react/src/hooks/useFocusZone.ts	Added focusPrependedElements boolean prop to FocusZoneHookSettings interface
packages/react/src/FilteredActionList/FilteredActionList.tsx	Added focusPrependedElements prop to component interface and passed it to useFocusZone
packages/react/src/SelectPanel/SelectPanel.tsx	Added focusPrependedElements prop to component interface and forwarded it to FilteredActionList
packages/react/package.json	Bumped @primer/behaviors from ^1.9.0 to ^1.9.1
package-lock.json	Updated lockfile with new @primer/behaviors version and integrity hash
.changeset/green-dryers-flow.md	Added changeset entry documenting the new feature as a patch release

[primer-integration]

👋 Hi from github/github-ui! Your integration PR is ready: https://github.com/github/github-ui/pull/9825

[primer-integration]

🔬 github-ui Integration Test Results

Check	Status	Details
CI	✅ Passed	View run
Projects (Memex)	✅ Passed	View run
VRT	✅ Passed	View run

✨ All checks passed! Your integration PR is ready for review.