Document the ConfirmDialog focus-trap contract and caller responsibilities

[mikewheeleer]

Document the ConfirmDialog focus-trap contract and caller responsibilities

Description

src/components/ConfirmDialog.tsx traps focus, closes on Escape, and explicitly delegates focus restoration to the caller, but docs/components has no page for it. Contributors wiring new destructive flows have to read the source to learn that contract.

Requirements and context

• Repository scope: Talenttrust/Talenttrust-Frontend only.
• Document every prop in ConfirmDialogProps, including the confirmLabel/cancelLabel defaults.
• State clearly that callers must retain a trigger ref and restore focus on close, using src/components/ActionPanel.tsx as the worked example.
• Note the FOCUSABLE_SELECTORS list and what happens when the dialog contains no focusable element.

Suggested execution

• Fork the repo and create a branch
• git checkout -b docs/dialogs-confirm-dialog
• Write code in: src/components/ConfirmDialog.tsx
• Write comprehensive tests in: src/components/__tests__/ConfirmDialog.test.tsx
• Add documentation: docs/components/ConfirmDialog.md

Test and commit

• Run npm run lint, npm test, npm run build
• Cover edge cases; include test output

Example commit message

docs(dialogs): document ConfirmDialog focus and escape contract

Guidelines

• Minimum 95 percent test coverage for impacted modules
• Clear documentation
• Timeframe: 96 hours.

Community & contribution rewards

• 💬 Join the TalentTrust community on Discord: https://discord.gg/WqnGpcPx
• ⭐ This is a GrantFox OSS / Official Campaign task and may be rewarded. When your PR is merged you'll be prompted to rate the project — a 5-star rating is much appreciated.

[GBOYEE]

Hey team — I'd like to take this on (Document the ConfirmDialog focus-trap contract and caller re). I'll add the docs/examples this needs. I'll get a PR up for this as soon as I'm assigned.

[Lspnjr1]

Hello maintainers,

I’m Lspjnr1, and I’d like to be assigned to this issue. I can help document the ConfirmDialog focus-trap contract and clarify the responsibilities for callers.

• Focus management before open: explain how focus should be handled before the dialog is opened, including any required trigger or active-element behavior.
• Focus restoration after close: describe how and where focus should return once the dialog is dismissed.
• Keyboard accessibility expectations: outline the expected keyboard interactions, including tab order, escape handling, and other accessibility requirements.
• Usage patterns: provide clear examples of the recommended way to use ConfirmDialog so contributors can follow the intended implementation without introducing accessibility regressions.

[Meet-hybrid]

Can I work on this please?