Improve programmatic state management of UnderlinePanels

[ddoyle2017]

Closes #4575

Changelog

New

• Adds an optional onSelect() prop to both UnderlinePanels and UnderlinePanels.Tab. This allows users to define a function that gets called when a tab is selected.

Changed

• Updated UnderlinePanels to handle updates to tabs and panels within a useEffect() hook. This ensures that the selected tab is updated when the aria-selected attribute changes, as well as keeping prop data fresh.

Removed

• N/A

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

• [WIP] Are there other ways to test these changes outside of unit testing?
• Added unit tests verifying that the onSelect() function is called when a tab is clicked + the selected tab can be managed programmatically via updating the aria-selected prop

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: 88d19b6

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	Minor

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 depends on. If you are GitHub staff, we recommend testing these changes with github/github using the integration workflow. Thanks!

[github-actions]

size-limit report 📦

Path	Size
packages/react/dist/browser.esm.js	104.53 KB (0%)
packages/react/dist/browser.umd.js	104.91 KB (0%)

[github-actions]

👋 Hi, there are new commits since the last successful integration test. We recommend running the integration workflow once more, unless you are sure the new changes do not affect github/github. Thanks!

[francinelucca]

Looks great, thanks! Just one small comment on the UnderlinePanels.Tab story

[mperrotti]

This is great. Thank you!

[github-actions]

👋 Hi, there are new commits since the last successful integration test. We recommend running the integration workflow once more, unless you are sure the new changes do not affect github/github. Thanks!

[github-actions]

👋 Hi, there are new commits since the last successful integration test. We recommend running the integration workflow once more, unless you are sure the new changes do not affect github/github. Thanks!

[github-actions]

👋 Hi, there are new commits since the last successful integration test. We recommend running the integration workflow once more, unless you are sure the new changes do not affect github/github. Thanks!