Add ExtraWindowEventListener interface

[zoontek]

Summary:

This PR introduces a ExtraWindowEventListener interface that allows native modules to be notified when new windows are created or destroyed (e.g. Modal dialogs).

Third-party libraries can implement it, or emit window events through ReactContext.onExtraWindowCreate / ReactContext.onExtraWindowDestroy.

This opens the door for libraries like expo-navigation-bar to build a proper NavigationBar module that stays in sync across all windows (including modals).

Related issue

• Navigation bar ignoring the navigationBarTranslucent prop / Modal doesn't cover the navigation bar zoontek/react-native-navigation-bar#4

Changelog:

[ANDROID] [ADDED] - Add ExtraWindowEventListener interface to allow native modules to react to window creation / destruction (e.g. Modal dialogs)

Test Plan

Follow #56059 test plan

[meta-codesync]

@alanleedev has imported this pull request. If you are a Meta employee, you can view this in D94871845.

[vitalNohj]

This would be huge for me to fix current production issues with the new Android policy to enforce edge to edge.

[cortinico]

Can you write some tests for this newly created API?

[cortinico]

Also do we need an iOS equivalent?

[zoontek]

@cortinico The main goal of this change is to allow updating the system UI style and visibility in modals (and other registered dialogs / activities), and it's not an issue on iOS.

[github-actions]

Warning

JavaScript API change detected

This PR commits an update to ReactNativeApi.d.ts, indicating a change to React Native's public JavaScript API.

• Please include a clear changelog message.
• This change will be subject to additional review.

This change was flagged as: POTENTIALLY_BREAKING

[cortinico]

Review automatically exported from Phabricator review in Meta.

[cortinico]

Review automatically exported from Phabricator review in Meta.

[meta-codesync]

@alanleedev merged this pull request in 58fec1f.

[react-native-bot]

This pull request was successfully merged by @zoontek in 58fec1f

^{When will my fix make it into a release? | How to file a pick request?}