feat: focustrap: export focus trap and add new hook props

[dkilgore-eightfold]

SUMMARY:

• Adds FocusTrap and useFocusTrap to exports
• Adds three new FocusTrap props to extend support for complex multi-dimensional async content implementations:

• firstFocusableSelector
• lastFocusableSelector
• skipFocusableSelectorsFromIndex

• Adds new renderContentAlways prop with a default value of true for backwards compatibility to Dialog, Modal and Panel as well as the above FocusTrap props.
• Adds unit tests
• Updates stories

panelFocusTrapFixup.mp4

JIRA TASK (Eightfold Employees Only):

ENG-69361

CHANGE TYPE:

• Bugfix Pull Request
• Feature Pull Request

TEST COVERAGE:

• Tests for this change already exist
• I have added unittests for this change

TEST PLAN:

Pull the PR branch and run yarn and yarn storybook. Verify the Panel, Dialog and Modal stories behave as expected.

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit 6ee693e:

Sandbox	Source
React	Configuration
Vanilla	Configuration

[codecov]

Codecov Report

Attention: 4 lines in your changes are missing coverage. Please review.

Files	Coverage Δ
src/components/Dialog/BaseDialog/BaseDialog.tsx	97.91% <100.00%> (+0.13%)	⬆️
src/components/Panel/Panel.tsx	82.88% <100.00%> (+1.40%)	⬆️
src/shared/FocusTrap/FocusTrap.tsx	80.00% <100.00%> (ø)
src/shared/FocusTrap/hooks/useFocusTrap.ts	80.76% <60.00%> (-3.68%)	⬇️

... and 1 file with indirect coverage changes

📢 Thoughts on this report? Let us know!.