feat: Add Shadow DOM support for useOverlay and improve event handling

[ritz078]

Followup of #6046

This PR fixes an issue in useOverlay where shouldCloseOnInteractOutside always received the shadow root parent element as the argument whenever an element inside the shadow root was clicked.

✅ Pull Request Checklist:

• Included link to corresponding React Spectrum GitHub Issue.
• Added/updated unit tests and storybook for this change (for new code or code which already has tests).
• Filled out test instructions.
• Updated documentation (if it already exists for this component).
• Looked at the Accessibility Practices for this feature - Aria Practices

📝 Test Instructions:

🧢 Your Project:

Nutrient (formerly PSPDFKit)