[select] Add finalFocus prop

[markocupic024]

Closes #3752

Followed existing patterns in code

[pkg-pr-new]

• vite-css-base-ui-example

  pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/react@3785
  

  pnpm add https://pkg.pr.new/mui/base-ui/@base-ui/utils@3785
  

commit: 16118d0

[mui-bot]

Bundle size report

Bundle	Parsed size	Gzip size
@base-ui/react	🔺+31B(+0.01%)	🔺+4B(0.00%)

Details of bundle changes

---

Check out the code infra dashboard for more information about this PR.

[greptile-apps]

Greptile Summary

This PR adds the finalFocus prop to the Select.Popup component, bringing feature parity with Menu and Dialog components. The implementation follows the established pattern used in other popup components in the codebase.

Changes:

• Added finalFocus prop to SelectPopup component that accepts boolean, ref, or function to control focus behavior when the popup closes
• Passed the prop to FloatingFocusManager as returnFocus parameter
• Added comprehensive test coverage for all prop variations (boolean, ref, function return types)
• Updated generated documentation and component reference

Implementation quality:

• Correctly follows existing patterns from MenuPopup.tsx (packages/react/src/menu/popup/MenuPopup.tsx:136)
• Type definition matches other components using InteractionType from useEnhancedClickHandler
• Test coverage is thorough and mirrors test patterns in DialogPopup.test.tsx

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The implementation follows well-established patterns from existing components (Menu and Dialog), includes comprehensive test coverage for all prop variations, and correctly integrates with the FloatingFocusManager. The changes are minimal, focused, and documentation is properly updated.
• No files require special attention

Important Files Changed

Filename	Overview
packages/react/src/select/popup/SelectPopup.tsx	Added finalFocus prop following existing patterns from Menu and Dialog components
packages/react/src/select/popup/SelectPopup.test.tsx	Comprehensive test coverage for all finalFocus prop variations
docs/reference/generated/select-popup.json	Generated documentation correctly includes finalFocus prop with proper type information
docs/src/app/(docs)/react/components/page.mdx	Documentation index updated to list finalFocus in SelectPopup props

[netlify]

✅ Deploy Preview for base-ui ready!

Name	Link
🔨 Latest commit	16118d0
🔍 Latest deploy log	https://app.netlify.com/projects/base-ui/deploys/696d5a6984c1e40008548a48
😎 Deploy Preview	https://deploy-preview-3785--base-ui.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[atomiks]

Thanks for the contribution!