@apexnative/navigation 1.0.0-alpha.1 → 1.0.0-alpha.11

package/android/src/main/java/dev/apexnative/navigation/react/events/EventContract.kt

@@ -0,0 +1,226 @@
+// Made by scripts/contract.mjs from the event types of src/interfaces/: change them and run the script again.
+
+package dev.apexnative.navigation.react.events
+
+/**
+ * The names of the events `ANN.<Name>` ([EVENT]) and the keys of their payloads, as the types of `src/interfaces/` give
+ * them; what each field means is its JSDoc there. The object types a field holds have keys of their own. The sender
+ * and the builders of payloads take every name and key from here: `EventContract.CommandCompleted.COMMAND_ID`. The
+ * events and fields only iOS sends are not here.
+ */
+internal object EventContract {
+    /** `ANN.AppLaunched`. */
+    object AppLaunched {
+        const val EVENT = "ANN.AppLaunched"
+    }
+
+    /** `ANN.ArrangementChanged`. */
+    object ArrangementChanged {
+        const val EVENT = "ANN.ArrangementChanged"
+        const val COMPONENT_ID = "componentId"
+        const val PLACEMENT = "placement"
+        const val LAYOUT = "layout"
+        const val FRONT = "front"
+        const val HIDDEN = "hidden"
+    }
+
+    /** `ANN.BottomTabLongPressed`. */
+    object BottomTabLongPressed {
+        const val EVENT = "ANN.BottomTabLongPressed"
+        const val SELECTED_TAB_INDEX = "selectedTabIndex"
+        const val BOTTOM_TABS_ID = "bottomTabsId"
+    }
+
+    /** `ANN.BottomTabPressed`. */
+    object BottomTabPressed {
+        const val EVENT = "ANN.BottomTabPressed"
+        const val TAB_INDEX = "tabIndex"
+        const val BOTTOM_TABS_ID = "bottomTabsId"
+        /** Optional. */
+        const val SCREEN_ID = "screenId"
+        const val WAS_SELECTED = "wasSelected"
+    }
+
+    /** `ANN.BottomTabSelected`. */
+    object BottomTabSelected {
+        const val EVENT = "ANN.BottomTabSelected"
+        const val SELECTED_TAB_INDEX = "selectedTabIndex"
+        const val UNSELECTED_TAB_INDEX = "unselectedTabIndex"
+        const val BOTTOM_TABS_ID = "bottomTabsId"
+    }
+
+    /** `ANN.CommandCompleted`. */
+    object CommandCompleted {
+        const val EVENT = "ANN.CommandCompleted"
+        const val COMMAND_NAME = "commandName"
+        const val COMMAND_ID = "commandId"
+        const val COMPLETION_TIME = "completionTime"
+    }
+
+    /** `ANN.ComponentDidAppear`. */
+    object ComponentDidAppear {
+        const val EVENT = "ANN.ComponentDidAppear"
+        const val COMPONENT_ID = "componentId"
+        const val COMPONENT_NAME = "componentName"
+        const val COMPONENT_TYPE = "componentType"
+    }
+
+    /** `ANN.ComponentDidDisappear`. */
+    object ComponentDidDisappear {
+        const val EVENT = "ANN.ComponentDidDisappear"
+        const val COMPONENT_ID = "componentId"
+        const val COMPONENT_NAME = "componentName"
+        const val COMPONENT_TYPE = "componentType"
+    }
+
+    /** `ANN.ComponentWillAppear`. */
+    object ComponentWillAppear {
+        const val EVENT = "ANN.ComponentWillAppear"
+        const val COMPONENT_ID = "componentId"
+        const val COMPONENT_NAME = "componentName"
+        const val COMPONENT_TYPE = "componentType"
+    }
+
+    /** `ANN.HingeChanged`. */
+    object HingeChanged {
+        const val EVENT = "ANN.HingeChanged"
+        /** Optional. */
+        const val STATE = "state"
+        /** Optional. */
+        const val ANGLE = "angle"
+    }
+
+    /** `ANN.ModalAttemptedToDismiss`. */
+    object ModalAttemptedToDismiss {
+        const val EVENT = "ANN.ModalAttemptedToDismiss"
+        const val COMPONENT_ID = "componentId"
+    }
+
+    /** `ANN.ModalDismissed`. */
+    object ModalDismissed {
+        const val EVENT = "ANN.ModalDismissed"
+        const val COMPONENT_ID = "componentId"
+        const val COMPONENT_NAME = "componentName"
+        const val MODALS_DISMISSED = "modalsDismissed"
+    }
+
+    /** `ANN.NativeScreenCall`. */
+    object NativeScreenCall {
+        const val EVENT = "ANN.NativeScreenCall"
+        const val COMPONENT_ID = "componentId"
+        const val CALL_ID = "callId"
+        const val KIND = "kind"
+        const val NAME = "name"
+        const val ARGS = "args"
+    }
+
+    /** `ANN.NativeScreenReleased`. */
+    object NativeScreenReleased {
+        const val EVENT = "ANN.NativeScreenReleased"
+        const val COMPONENT_ID = "componentId"
+    }
+
+    /** `ANN.NavigationButtonPressed`. */
+    object NavigationButtonPressed {
+        const val EVENT = "ANN.NavigationButtonPressed"
+        const val COMPONENT_ID = "componentId"
+        const val BUTTON_ID = "buttonId"
+    }
+
+    /** `ANN.NavigationStateChanged`. */
+    object NavigationStateChanged {
+        const val EVENT = "ANN.NavigationStateChanged"
+        const val SCREEN = "screen"
+        const val TAB = "tab"
+    }
+
+    /** The object of `ANN.NavigationStateChanged.screen`. */
+    object NavigationStateChangedScreen {
+        const val ID = "id"
+        const val NAME = "name"
+    }
+
+    /** `ANN.ScreenInsetsChanged`. */
+    object ScreenInsetsChanged {
+        const val EVENT = "ANN.ScreenInsetsChanged"
+        const val COMPONENT_ID = "componentId"
+        const val TOP = "top"
+        const val RIGHT = "right"
+        const val BOTTOM = "bottom"
+        const val LEFT = "left"
+    }
+
+    /** `ANN.ScreenPopped`. */
+    object ScreenPopped {
+        const val EVENT = "ANN.ScreenPopped"
+        const val COMPONENT_ID = "componentId"
+    }
+
+    /** The object of `ANN.ScreenRegionsChanged.division`. */
+    object ScreenRegionRect {
+        const val X = "x"
+        const val Y = "y"
+        const val WIDTH = "width"
+        const val HEIGHT = "height"
+    }
+
+    /** `ANN.ScreenRegionsChanged`. */
+    object ScreenRegionsChanged {
+        const val EVENT = "ANN.ScreenRegionsChanged"
+        const val COMPONENT_ID = "componentId"
+        const val DIVISION = "division"
+        const val OCCLUSION = "occlusion"
+    }
+
+    /** `ANN.SearchBarCancelPressed`. */
+    object SearchBarCancelPressed {
+        const val EVENT = "ANN.SearchBarCancelPressed"
+        const val COMPONENT_ID = "componentId"
+    }
+
+    /** `ANN.SearchBarSubmitted`. */
+    object SearchBarSubmitted {
+        const val EVENT = "ANN.SearchBarSubmitted"
+        const val COMPONENT_ID = "componentId"
+        const val TEXT = "text"
+        /** Optional. */
+        const val SCOPE = "scope"
+    }
+
+    /** `ANN.SearchBarUpdated`. */
+    object SearchBarUpdated {
+        const val EVENT = "ANN.SearchBarUpdated"
+        const val COMPONENT_ID = "componentId"
+        const val TEXT = "text"
+        const val IS_FOCUSED = "isFocused"
+        /** Optional. */
+        const val SCOPE = "scope"
+    }
+
+    /** `ANN.SearchSuggestionPicked`. */
+    object SearchSuggestionPicked {
+        const val EVENT = "ANN.SearchSuggestionPicked"
+        const val COMPONENT_ID = "componentId"
+        const val SUGGESTION_ID = "suggestionId"
+    }
+
+    /** `ANN.SheetDetentChanged`. */
+    object SheetDetentChanged {
+        const val EVENT = "ANN.SheetDetentChanged"
+        const val COMPONENT_ID = "componentId"
+        const val DETENT = "detent"
+    }
+
+    /** `ANN.SlotDestroyed`. */
+    object SlotDestroyed {
+        const val EVENT = "ANN.SlotDestroyed"
+        const val COMPONENT_ID = "componentId"
+    }
+
+    /** `ANN.SplitViewColumnsStacked`. */
+    object SplitViewColumnsStacked {
+        const val EVENT = "ANN.SplitViewColumnsStacked"
+        const val COMPONENT_ID = "componentId"
+        const val STACKED = "stacked"
+    }
+}

package/android/src/main/java/dev/apexnative/navigation/react/events/EventEmitter.kt

@@ -6,155 +6,184 @@ import com.facebook.react.bridge.ReactContext
 import com.facebook.react.bridge.WritableMap
 import dev.apexnative.navigation.NavigationApplication
 import dev.apexnative.navigation.nativescreen.NativeScreenCalls
+import dev.apexnative.navigation.react.ReloadCoordinator
 import dev.apexnative.navigation.utils.NavigationLog
 import org.json.JSONArray
 
 /**
  * Sends the events `ANN.<Name>` to the JavaScript of [reactContext] through React Native's device event emitter, in
  * the order they are sent: sent from the main thread only. Without a context, or when its React instance is gone, an
- * event is dropped with one line in the log. The names and the fields are the contract. The core sends through
- * [current]; modules keep making their own.
+ * event is dropped with one line in the log. The names and the keys come from [EventContract], made from the types of
+ * `src/interfaces/`.
+ *
+ * An emitter belongs to one JavaScript, as on iOS (`ANNEventEmitter`): it takes the number of the JavaScript
+ * ([generation], `ReloadCoordinator`) when it is made and drops every event silently once that number moved. React
+ * Native keeps one context across a reload (bridgeless), so without it an event of a screen of the JavaScript that
+ * went would reach the new one, which may have a screen with the same id. The core and its modules send through
+ * [current], or [of] with the number of the JavaScript a node was made for.
  */
-class EventEmitter(private val reactContext: ReactContext?) {
-    /** Whether an event sent now reaches JavaScript. */
+class EventEmitter @JvmOverloads constructor(
+    private val reactContext: ReactContext?,
+    /** The number of the JavaScript this emitter sends to: by default the one that runs as it is made. */
+    val generation: Int = ReloadCoordinator.generation,
+) {
+    /** Whether the JavaScript of this emitter still runs: its events go only then. Any thread. */
+    val isCurrent: Boolean
+        get() = ReloadCoordinator.isCurrent(generation)
+
+    /** Whether an event sent now reaches JavaScript: its JavaScript still runs, in a live React instance. */
     val canSend: Boolean
-        get() = reactContext?.hasActiveReactInstance() == true
+        get() = isCurrent && reactContext?.hasActiveReactInstance() == true
 
-    fun emitAppLaunched() = emit(APP_LAUNCHED, Arguments.createMap())
+    fun emitAppLaunched() = emit(EventContract.AppLaunched.EVENT, Arguments.createMap())
 
     fun emitCommandCompleted(commandName: String, commandId: String, completionTime: Long) =
-        emit(COMMAND_COMPLETED, Arguments.createMap().apply {
-            putString("commandName", commandName)
-            putString("commandId", commandId)
-            putDouble("completionTime", completionTime.toDouble())
+        emit(EventContract.CommandCompleted.EVENT, Arguments.createMap().apply {
+            putString(EventContract.CommandCompleted.COMMAND_NAME, commandName)
+            putString(EventContract.CommandCompleted.COMMAND_ID, commandId)
+            putDouble(EventContract.CommandCompleted.COMPLETION_TIME, completionTime.toDouble())
         })
 
     fun emitComponentWillAppear(componentId: String, componentName: String, type: ComponentType) =
-        emit(COMPONENT_WILL_APPEAR, component(componentId, componentName, type))
+        emit(EventContract.ComponentWillAppear.EVENT, component(componentId, componentName, type))
 
     fun emitComponentDidAppear(componentId: String, componentName: String, type: ComponentType) =
-        emit(COMPONENT_DID_APPEAR, component(componentId, componentName, type))
+        emit(EventContract.ComponentDidAppear.EVENT, component(componentId, componentName, type))
 
     fun emitComponentDidDisappear(componentId: String, componentName: String, type: ComponentType) =
-        emit(COMPONENT_DID_DISAPPEAR, component(componentId, componentName, type))
+        emit(EventContract.ComponentDidDisappear.EVENT, component(componentId, componentName, type))
 
     /** The screen the user sees (`null` for none) and the selected tab of the tabs it is in (`null` out of tabs). */
     fun emitNavigationStateChanged(screenId: String?, screenName: String?, tab: Int?) =
-        emit(NAVIGATION_STATE_CHANGED, Arguments.createMap().apply {
+        emit(EventContract.NavigationStateChanged.EVENT, Arguments.createMap().apply {
+            val keys = EventContract.NavigationStateChanged
             if (screenId == null) {
-                putNull("screen")
+                putNull(keys.SCREEN)
             } else {
-                putMap("screen", Arguments.createMap().apply {
-                    putString("id", screenId)
-                    putString("name", screenName)
+                putMap(keys.SCREEN, Arguments.createMap().apply {
+                    putString(EventContract.NavigationStateChangedScreen.ID, screenId)
+                    putString(EventContract.NavigationStateChangedScreen.NAME, screenName)
                 })
             }
-            if (tab == null) putNull("tab") else putInt("tab", tab)
+            if (tab == null) putNull(keys.TAB) else putInt(keys.TAB, tab)
         })
 
-    fun emitScreenPopped(componentId: String) = emit(SCREEN_POPPED, withId(componentId))
+    fun emitScreenPopped(componentId: String) = emit(EventContract.ScreenPopped.EVENT, withId(componentId))
 
     fun emitNavigationButtonPressed(componentId: String, buttonId: String) =
-        emit(NAVIGATION_BUTTON_PRESSED, withId(componentId).apply { putString("buttonId", buttonId) })
+        emit(EventContract.NavigationButtonPressed.EVENT, withId(componentId).apply {
+            putString(EventContract.NavigationButtonPressed.BUTTON_ID, buttonId)
+        })
 
     fun emitBottomTabSelected(selectedTabIndex: Int, unselectedTabIndex: Int, bottomTabsId: String) =
-        emit(BOTTOM_TAB_SELECTED, Arguments.createMap().apply {
-            putInt("selectedTabIndex", selectedTabIndex)
-            putInt("unselectedTabIndex", unselectedTabIndex)
-            putString("bottomTabsId", bottomTabsId)
+        emit(EventContract.BottomTabSelected.EVENT, Arguments.createMap().apply {
+            putInt(EventContract.BottomTabSelected.SELECTED_TAB_INDEX, selectedTabIndex)
+            putInt(EventContract.BottomTabSelected.UNSELECTED_TAB_INDEX, unselectedTabIndex)
+            putString(EventContract.BottomTabSelected.BOTTOM_TABS_ID, bottomTabsId)
         })
 
     fun emitBottomTabPressed(tabIndex: Int, bottomTabsId: String, screenId: String?, wasSelected: Boolean) =
-        emit(BOTTOM_TAB_PRESSED, Arguments.createMap().apply {
-            putInt("tabIndex", tabIndex)
-            putString("bottomTabsId", bottomTabsId)
-            screenId?.let { putString("screenId", it) }
-            putBoolean("wasSelected", wasSelected)
+        emit(EventContract.BottomTabPressed.EVENT, Arguments.createMap().apply {
+            putInt(EventContract.BottomTabPressed.TAB_INDEX, tabIndex)
+            putString(EventContract.BottomTabPressed.BOTTOM_TABS_ID, bottomTabsId)
+            screenId?.let { putString(EventContract.BottomTabPressed.SCREEN_ID, it) }
+            putBoolean(EventContract.BottomTabPressed.WAS_SELECTED, wasSelected)
         })
 
     fun emitBottomTabLongPressed(selectedTabIndex: Int, bottomTabsId: String) =
-        emit(BOTTOM_TAB_LONG_PRESSED, Arguments.createMap().apply {
-            putInt("selectedTabIndex", selectedTabIndex)
-            putString("bottomTabsId", bottomTabsId)
+        emit(EventContract.BottomTabLongPressed.EVENT, Arguments.createMap().apply {
+            putInt(EventContract.BottomTabLongPressed.SELECTED_TAB_INDEX, selectedTabIndex)
+            putString(EventContract.BottomTabLongPressed.BOTTOM_TABS_ID, bottomTabsId)
         })
 
     /** The id and the name (without `slot:`) of the screen the modal showed, and how many modals went. */
     fun emitModalDismissed(componentId: String, componentName: String, modalsDismissed: Int) =
-        emit(MODAL_DISMISSED, withId(componentId).apply {
-            putString("componentName", componentName)
-            putInt("modalsDismissed", modalsDismissed)
+        emit(EventContract.ModalDismissed.EVENT, withId(componentId).apply {
+            putString(EventContract.ModalDismissed.COMPONENT_NAME, componentName)
+            putInt(EventContract.ModalDismissed.MODALS_DISMISSED, modalsDismissed)
         })
 
-    fun emitModalAttemptedToDismiss(componentId: String) = emit(MODAL_ATTEMPTED_TO_DISMISS, withId(componentId))
+    fun emitModalAttemptedToDismiss(componentId: String) =
+        emit(EventContract.ModalAttemptedToDismiss.EVENT, withId(componentId))
 
     /** [detent]: `medium`, `large`, or a height in dp. */
     fun emitSheetDetentChanged(componentId: String, detent: Any) =
-        emit(SHEET_DETENT_CHANGED, withId(componentId).apply {
+        emit(EventContract.SheetDetentChanged.EVENT, withId(componentId).apply {
             when (detent) {
-                is Number -> putDouble("detent", detent.toDouble())
-                else -> putString("detent", detent.toString())
+                is Number -> putDouble(EventContract.SheetDetentChanged.DETENT, detent.toDouble())
+                else -> putString(EventContract.SheetDetentChanged.DETENT, detent.toString())
             }
         })
 
     fun emitSearchBarUpdated(componentId: String, text: String, isFocused: Boolean, scope: String?) =
-        emit(SEARCH_BAR_UPDATED, withId(componentId).apply {
-            putString("text", text)
-            putBoolean("isFocused", isFocused)
-            scope?.let { putString("scope", it) }
+        emit(EventContract.SearchBarUpdated.EVENT, withId(componentId).apply {
+            putString(EventContract.SearchBarUpdated.TEXT, text)
+            putBoolean(EventContract.SearchBarUpdated.IS_FOCUSED, isFocused)
+            scope?.let { putString(EventContract.SearchBarUpdated.SCOPE, it) }
         })
 
     fun emitSearchBarSubmitted(componentId: String, text: String, scope: String?) =
-        emit(SEARCH_BAR_SUBMITTED, withId(componentId).apply {
-            putString("text", text)
-            scope?.let { putString("scope", it) }
+        emit(EventContract.SearchBarSubmitted.EVENT, withId(componentId).apply {
+            putString(EventContract.SearchBarSubmitted.TEXT, text)
+            scope?.let { putString(EventContract.SearchBarSubmitted.SCOPE, it) }
         })
 
-    fun emitSearchBarCancelPressed(componentId: String) = emit(SEARCH_BAR_CANCEL_PRESSED, withId(componentId))
+    fun emitSearchBarCancelPressed(componentId: String) =
+        emit(EventContract.SearchBarCancelPressed.EVENT, withId(componentId))
 
     fun emitSearchSuggestionPicked(componentId: String, suggestionId: String) =
-        emit(SEARCH_SUGGESTION_PICKED, withId(componentId).apply { putString("suggestionId", suggestionId) })
+        emit(EventContract.SearchSuggestionPicked.EVENT, withId(componentId).apply {
+            putString(EventContract.SearchSuggestionPicked.SUGGESTION_ID, suggestionId)
+        })
 
     fun emitSplitViewColumnsStacked(componentId: String, stacked: Boolean) =
-        emit(SPLIT_VIEW_COLUMNS_STACKED, withId(componentId).apply { putBoolean("stacked", stacked) })
+        emit(EventContract.SplitViewColumnsStacked.EVENT, withId(componentId).apply {
+            putBoolean(EventContract.SplitViewColumnsStacked.STACKED, stacked)
+        })
 
-    fun emitSlotDestroyed(componentId: String) = emit(SLOT_DESTROYED, withId(componentId))
+    fun emitSlotDestroyed(componentId: String) = emit(EventContract.SlotDestroyed.EVENT, withId(componentId))
 
     /** [insets]: `{ top, right, bottom, left }`. */
     fun emitScreenInsetsChanged(componentId: String, insets: WritableMap) =
-        emit(SCREEN_INSETS_CHANGED, withId(componentId).apply { merge(insets) })
+        emit(EventContract.ScreenInsetsChanged.EVENT, withId(componentId).apply { merge(insets) })
 
     /** [regions]: `{ division, occlusion }`. */
     fun emitScreenRegionsChanged(componentId: String, regions: WritableMap) =
-        emit(SCREEN_REGIONS_CHANGED, withId(componentId).apply { merge(regions) })
+        emit(EventContract.ScreenRegionsChanged.EVENT, withId(componentId).apply { merge(regions) })
 
     /** [state]: `{ placement, layout, front, hidden }`. */
     fun emitArrangementChanged(componentId: String, state: WritableMap) =
-        emit(ARRANGEMENT_CHANGED, withId(componentId).apply { merge(state) })
+        emit(EventContract.ArrangementChanged.EVENT, withId(componentId).apply { merge(state) })
 
     /** [value]: `{ state, angle? }`, or `{}` without a hinge. */
-    fun emitHingeChanged(value: WritableMap) = emit(HINGE_CHANGED, value)
+    fun emitHingeChanged(value: WritableMap) = emit(EventContract.HingeChanged.EVENT, value)
 
     /** [kind]: `function` or `command`; [arguments] as JSON, which JavaScript gets as `args`. */
     fun emitNativeScreenCall(componentId: String, callId: String, kind: String, name: String, arguments: JSONArray) =
-        emit(NATIVE_SCREEN_CALL, withId(componentId).apply {
-            putString("callId", callId)
-            putString("kind", kind)
-            putString("name", name)
-            putArray("args", NativeScreenCalls.toArguments(arguments))
+        emit(EventContract.NativeScreenCall.EVENT, withId(componentId).apply {
+            putString(EventContract.NativeScreenCall.CALL_ID, callId)
+            putString(EventContract.NativeScreenCall.KIND, kind)
+            putString(EventContract.NativeScreenCall.NAME, name)
+            putArray(EventContract.NativeScreenCall.ARGS, NativeScreenCalls.toArguments(arguments))
         })
 
-    fun emitNativeScreenReleased(componentId: String) = emit(NATIVE_SCREEN_RELEASED, withId(componentId))
+    fun emitNativeScreenReleased(componentId: String) =
+        emit(EventContract.NativeScreenReleased.EVENT, withId(componentId))
 
+    // The three appearance events have the same keys.
     private fun component(componentId: String, componentName: String, type: ComponentType): WritableMap =
         withId(componentId).apply {
-            putString("componentName", componentName)
-            putString("componentType", type.jsName)
+            putString(EventContract.ComponentDidAppear.COMPONENT_NAME, componentName)
+            putString(EventContract.ComponentDidAppear.COMPONENT_TYPE, type.jsName)
         }
 
+    // The events of a screen carry its id under the same key.
     private fun withId(componentId: String): WritableMap =
-        Arguments.createMap().apply { putString("componentId", componentId) }
+        Arguments.createMap().apply { putString(EventContract.ScreenPopped.COMPONENT_ID, componentId) }
 
     private fun emit(name: String, data: WritableMap) {
+        // The JavaScript of this emitter went: the new one never had its screens.
+        if (!isCurrent) return
         val context = reactContext
         if (context == null || !context.hasActiveReactInstance()) {
             Log.w(NavigationLog.TAG, "Could not send event $name. React context is null!")
@@ -164,36 +193,48 @@ class EventEmitter(private val reactContext: ReactContext?) {
     }
 
     companion object {
-        /** The sender to the JavaScript that runs now: the React context of the app's `ReactGateway`. */
+        /**
+         * The sender to the JavaScript that runs now: the React context of the app's `ReactGateway`. It goes silent
+         * once that JavaScript goes (a reload): one kept for later sends nothing to the next.
+         */
         @JvmStatic
-        fun current(): EventEmitter =
-            EventEmitter(NavigationApplication.instanceOrNull?.reactGatewayOrNull?.currentReactContext)
-
-        const val APP_LAUNCHED = "ANN.AppLaunched"
-        const val COMMAND_COMPLETED = "ANN.CommandCompleted"
-        const val COMPONENT_WILL_APPEAR = "ANN.ComponentWillAppear"
-        const val COMPONENT_DID_APPEAR = "ANN.ComponentDidAppear"
-        const val COMPONENT_DID_DISAPPEAR = "ANN.ComponentDidDisappear"
-        const val NAVIGATION_STATE_CHANGED = "ANN.NavigationStateChanged"
-        const val SCREEN_POPPED = "ANN.ScreenPopped"
-        const val NAVIGATION_BUTTON_PRESSED = "ANN.NavigationButtonPressed"
-        const val BOTTOM_TAB_SELECTED = "ANN.BottomTabSelected"
-        const val BOTTOM_TAB_PRESSED = "ANN.BottomTabPressed"
-        const val BOTTOM_TAB_LONG_PRESSED = "ANN.BottomTabLongPressed"
-        const val MODAL_DISMISSED = "ANN.ModalDismissed"
-        const val MODAL_ATTEMPTED_TO_DISMISS = "ANN.ModalAttemptedToDismiss"
-        const val SHEET_DETENT_CHANGED = "ANN.SheetDetentChanged"
-        const val SEARCH_BAR_UPDATED = "ANN.SearchBarUpdated"
-        const val SEARCH_BAR_SUBMITTED = "ANN.SearchBarSubmitted"
-        const val SEARCH_BAR_CANCEL_PRESSED = "ANN.SearchBarCancelPressed"
-        const val SEARCH_SUGGESTION_PICKED = "ANN.SearchSuggestionPicked"
-        const val SPLIT_VIEW_COLUMNS_STACKED = "ANN.SplitViewColumnsStacked"
-        const val SLOT_DESTROYED = "ANN.SlotDestroyed"
-        const val SCREEN_INSETS_CHANGED = "ANN.ScreenInsetsChanged"
-        const val SCREEN_REGIONS_CHANGED = "ANN.ScreenRegionsChanged"
-        const val ARRANGEMENT_CHANGED = "ANN.ArrangementChanged"
-        const val HINGE_CHANGED = "ANN.HingeChanged"
-        const val NATIVE_SCREEN_CALL = "ANN.NativeScreenCall"
-        const val NATIVE_SCREEN_RELEASED = "ANN.NativeScreenReleased"
+        fun current(): EventEmitter = of(ReloadCoordinator.generation)
+
+        /**
+         * The sender to the JavaScript [generation] (a node's `jsGeneration`): the React context of the app's
+         * `ReactGateway` while that JavaScript runs, silent once it went, so an event of a screen made for the
+         * JavaScript that went never reaches the new one.
+         */
+        internal fun of(generation: Int): EventEmitter =
+            EventEmitter(NavigationApplication.instanceOrNull?.reactGatewayOrNull?.currentReactContext, generation)
+
+        // The names of the events, for modules outside the library; inside it, [EventContract] has them with their
+        // keys.
+        const val APP_LAUNCHED = EventContract.AppLaunched.EVENT
+        const val COMMAND_COMPLETED = EventContract.CommandCompleted.EVENT
+        const val COMPONENT_WILL_APPEAR = EventContract.ComponentWillAppear.EVENT
+        const val COMPONENT_DID_APPEAR = EventContract.ComponentDidAppear.EVENT
+        const val COMPONENT_DID_DISAPPEAR = EventContract.ComponentDidDisappear.EVENT
+        const val NAVIGATION_STATE_CHANGED = EventContract.NavigationStateChanged.EVENT
+        const val SCREEN_POPPED = EventContract.ScreenPopped.EVENT
+        const val NAVIGATION_BUTTON_PRESSED = EventContract.NavigationButtonPressed.EVENT
+        const val BOTTOM_TAB_SELECTED = EventContract.BottomTabSelected.EVENT
+        const val BOTTOM_TAB_PRESSED = EventContract.BottomTabPressed.EVENT
+        const val BOTTOM_TAB_LONG_PRESSED = EventContract.BottomTabLongPressed.EVENT
+        const val MODAL_DISMISSED = EventContract.ModalDismissed.EVENT
+        const val MODAL_ATTEMPTED_TO_DISMISS = EventContract.ModalAttemptedToDismiss.EVENT
+        const val SHEET_DETENT_CHANGED = EventContract.SheetDetentChanged.EVENT
+        const val SEARCH_BAR_UPDATED = EventContract.SearchBarUpdated.EVENT
+        const val SEARCH_BAR_SUBMITTED = EventContract.SearchBarSubmitted.EVENT
+        const val SEARCH_BAR_CANCEL_PRESSED = EventContract.SearchBarCancelPressed.EVENT
+        const val SEARCH_SUGGESTION_PICKED = EventContract.SearchSuggestionPicked.EVENT
+        const val SPLIT_VIEW_COLUMNS_STACKED = EventContract.SplitViewColumnsStacked.EVENT
+        const val SLOT_DESTROYED = EventContract.SlotDestroyed.EVENT
+        const val SCREEN_INSETS_CHANGED = EventContract.ScreenInsetsChanged.EVENT
+        const val SCREEN_REGIONS_CHANGED = EventContract.ScreenRegionsChanged.EVENT
+        const val ARRANGEMENT_CHANGED = EventContract.ArrangementChanged.EVENT
+        const val HINGE_CHANGED = EventContract.HingeChanged.EVENT
+        const val NATIVE_SCREEN_CALL = EventContract.NativeScreenCall.EVENT
+        const val NATIVE_SCREEN_RELEASED = EventContract.NativeScreenReleased.EVENT
     }
 }