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

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

@@ -1,3 +1,5 @@
+// Made by scripts/contract.mjs from src/interfaces/contract/errors.json: change that file and run the script again.
+
 package dev.apexnative.navigation.react
 
 /**
@@ -6,116 +8,129 @@ package dev.apexnative.navigation.react
  * <command>:`.
  */
 internal object ErrorTexts {
-    fun screenNotShown(id: String) = "the screen '$id' is not shown"
+    // Where the screen is.
+
+    fun screenNotShown(componentId: String) = "the screen '$componentId' is not shown"
 
-    fun notInStack(id: String) = "the screen '$id' is not in a stack"
+    fun notInStack(componentId: String) = "the screen '$componentId' is not in a stack"
 
-    fun firstScreenOfStack(id: String) = "the screen '$id' is the first screen of its stack"
+    fun firstScreenOfStack(componentId: String) = "the screen '$componentId' is the first screen of its stack"
 
-    fun notInThisStack(id: String) = "the screen '$id' is not in this stack"
+    fun notInThisStack(componentId: String) = "the screen '$componentId' is not in this stack"
 
-    fun notInModal(id: String) = "the screen '$id' is not in a modal"
+    fun notInModal(componentId: String) = "the screen '$componentId' is not in a modal"
 
-    fun notInOverlay(id: String) = "the screen '$id' is not in an overlay"
+    fun notInOverlay(componentId: String) = "the screen '$componentId' is not in an overlay"
 
-    fun notInSplitView(id: String) = "the screen '$id' is not in a split view"
+    fun notInSplitView(componentId: String) = "the screen '$componentId' is not in a split view"
 
-    fun neitherSplitViewNorStack(id: String) = "the screen '$id' is neither in a split view nor in a stack"
+    fun neitherSplitViewNorStack(componentId: String) =
+        "the screen '$componentId' is neither in a split view nor in a stack"
 
-    fun noSuchColumn(id: String, column: String) = "the split view of the screen '$id' has no '$column' column"
+    fun noSuchColumn(componentId: String, column: String) =
+        "the split view of the screen '$componentId' has no '$column' column"
 
-    fun columnIsStack(id: String, column: String) =
-        "the '$column' column of the split view of the screen '$id' is a stack: it takes a screen, not a stack"
+    fun columnIsStack(componentId: String, column: String) =
+        "the '$column' column of the split view of the screen '$componentId' is a stack: it takes a screen, not a stack"
 
-    fun columnNotStack(id: String, column: String) =
-        "the '$column' column of the split view of the screen '$id' is not a stack"
+    fun columnNotStack(componentId: String, column: String) =
+        "the '$column' column of the split view of the screen '$componentId' is not a stack"
 
-    fun noScreensForStack(id: String) = "there are no screens to put in the stack of the screen '$id'"
+    fun noScreensForStack(componentId: String) = "there are no screens to put in the stack of the screen '$componentId'"
 
-    fun alreadyShown(id: String) = "the screen '$id' shows already: an id goes to one screen"
+    fun alreadyShown(componentId: String) = "the screen '$componentId' shows already: an id goes to one screen"
 
-    fun setRootReplaced(id: String) =
-        "setRoot was replaced by a newer setRoot before the root '$id' finished showing"
+    // Root, modals, the app.
 
-    fun rootDestroyed(id: String) = "the root '$id' was destroyed before it showed"
+    fun setRootReplaced(rootId: String) =
+        "setRoot was replaced by a newer setRoot before the root '$rootId' finished showing"
 
-    fun modalWithoutRoot(id: String) = "the modal '$id' can't be dismissed: there is no root under it"
+    fun rootDestroyed(rootId: String) = "the root '$rootId' was destroyed before it showed"
+
+    fun modalWithoutRoot(componentId: String) = "the modal '$componentId' can't be dismissed: there is no root under it"
 
     fun nowhereToShow() = "the navigation has nowhere to show screens: the app has no activity or window"
 
+    // Native screens.
+
     fun nativeScreenNotRegistered(name: String) = "no native screen is registered as '$name'"
 
     fun nativeScreenNotCreated(name: String) =
         "the native screen '$name' could not be created: its creator returned nothing"
 
-    fun unknownNodeType(type: String) = "the layout has a node of unknown type '$type'"
+    /** The error of a call of a native screen whose JavaScript reloaded before it answered. */
+    fun nativeCallReloaded(name: String, componentId: String) =
+        "JavaScript reloaded before the call '$name' of the screen '$componentId' was answered"
 
-    fun nodeWithoutId(type: String) = "the layout has a node of type '$type' without an id"
+    /** The error of a call of a native screen while no JavaScript can answer it. */
+    fun nativeCallNotRunning(name: String, componentId: String) =
+        "the navigation is not running: the call '$name' of the screen '$componentId' can't be answered"
 
-    fun sideMenuChild(id: String, type: String) =
-        "the side menu '$id' has a child of type '$type': it takes SideMenuLeft, SideMenuCenter and SideMenuRight"
+    // The layout.
 
-    fun stackTakesScreens(id: String, type: String) = "the stack '$id' takes screens, not a '$type'"
+    fun unknownNodeType(type: String) = "the layout has a node of unknown type '$type'"
 
-    fun emptyStack(id: String) = "the stack '$id' has no screens"
+    fun nodeWithoutId(type: String) = "the layout has a node of type '$type' without an id"
 
-    fun emptyTabs(id: String) = "the tabs '$id' have no tabs"
+    fun sideMenuChild(menuId: String, type: String) =
+        "the side menu '$menuId' has a child of type '$type': it takes SideMenuLeft, SideMenuCenter and SideMenuRight"
 
-    fun tooManyTabs(id: String, count: Int) = "the tabs '$id' have $count tabs: Android shows at most 5"
+    fun stackTakesScreens(stackId: String, type: String) = "the stack '$stackId' takes screens, not a '$type'"
 
-    fun splitViewColumns(id: String) = "the split view '$id' needs its primary and its secondary column"
+    fun emptyStack(stackId: String) = "the stack '$stackId' has no screens"
 
-    fun pairUnsupported(id: String) = "the pair '$id' needs iOS 27.1 and an app built with its SDK"
+    fun emptyTabs(tabsId: String) = "the tabs '$tabsId' have no tabs"
 
-    fun pairNeedsTwoScreens(id: String) = "the pair '$id' needs two screens: its primary and its secondary"
+    /** Only Android checks it: its tab bar shows at most 5 tabs. */
+    fun tooManyTabs(tabsId: String, count: Int) = "the tabs '$tabsId' have $count tabs: Android shows at most 5"
 
-    fun unreadableOption(path: String, id: String) =
-        "the option '$path' of the screen '$id' has a value the navigation can't read"
+    fun splitViewColumns(splitViewId: String) =
+        "the split view '$splitViewId' needs its primary and its secondary column"
 
-    /** `setDefaultOptions` with a value it can't read; the default options before stay. */
-    fun unreadableDefaultOption(path: String) =
-        "the option '$path' of the default options has a value the navigation can't read"
+    /** Only iOS checks it: Android has pairs on every version. */
+    fun pairUnsupported(pairId: String) = "the pair '$pairId' needs iOS 27.1 and an app built with its SDK"
 
-    fun previewGone(id: String) = "the preview '$id' went without being opened"
+    fun pairNeedsTwoScreens(pairId: String) = "the pair '$pairId' needs two screens: its primary and its secondary"
 
-    /** Any other failure: [what] the command could not do, with its screen, and [reason]. */
-    fun couldNot(what: String, reason: String) = "could not $what: $reason"
+    fun nodeWithoutName(type: String, nodeId: String) = "the layout has a node '$nodeId' of type '$type' without a name"
 
-    fun nativeCallReloaded(name: String, id: String) =
-        "JavaScript reloaded before the call '$name' of the screen '$id' was answered"
+    fun rootMissing() = "the layout of setRoot has no root"
 
-    fun nativeCallNotRunning(name: String, id: String) =
-        "the navigation is not running: the call '$name' of the screen '$id' can't be answered"
+    fun tabsInTabs(tabsId: String) = "the tabs '$tabsId' have a tab of type 'BottomTabs': tabs don't go inside tabs"
 
-    /** `mergeOptions` without a navigation activity; written to the log, `mergeOptions` has no promise. */
-    fun mergeOptionsNoActivity() = nowhereToShow()
+    fun sideMenuSides(menuId: String) =
+        "the side menu '$menuId' takes one SideMenuCenter and at most one SideMenuLeft and one SideMenuRight"
 
-    /** A command whose area the native core doesn't do yet. */
-    fun notDoneYet(method: String) = "could not run '$method': the native core doesn't do it yet"
+    fun sideChildCount(sideId: String, menuId: String) =
+        "the side '$sideId' of the side menu '$menuId' needs exactly one child"
 
-    // The other cases of the layout checks: the same style.
+    fun sideMenuInSide(menuId: String) =
+        "the side menu '$menuId' has a side menu in a side: a side menu doesn't go inside a side menu"
 
-    fun nodeWithoutName(type: String, id: String) = "the layout has a node '$id' of type '$type' without a name"
+    fun sideOutsideMenu(nodeId: String, type: String) =
+        "the layout has a node '$nodeId' of type '$type' outside a side menu"
 
-    fun rootMissing() = "the layout of setRoot has no root"
+    fun splitViewInColumn(splitViewId: String) =
+        "the split view '$splitViewId' has a column of type 'SplitView': a split view doesn't go inside a split view"
 
-    fun tabsInTabs(id: String) = "the tabs '$id' have a tab of type 'BottomTabs': tabs don't go inside tabs"
+    fun idGivenTwice(nodeId: String) = "the layout gives the id '$nodeId' to two nodes"
 
-    fun sideMenuSides(id: String) =
-        "the side menu '$id' takes one SideMenuCenter and at most one SideMenuLeft and one SideMenuRight"
+    // Options, previews, any other failure.
 
-    fun sideChildCount(sideId: String, menuId: String) =
-        "the side '$sideId' of the side menu '$menuId' needs exactly one child"
+    fun unreadableOption(path: String, componentId: String) =
+        "the option '$path' of the screen '$componentId' has a value the navigation can't read"
 
-    fun sideMenuInSide(menuId: String) =
-        "the side menu '$menuId' has a side menu in a side: a side menu doesn't go inside a side menu"
+    /** An unreadable value of `setDefaultOptions`: the default options belong to no screen. */
+    fun unreadableDefaultOption(path: String) =
+        "the option '$path' of the default options has a value the navigation can't read"
 
-    fun sideOutsideMenu(id: String, type: String) = "the layout has a node '$id' of type '$type' outside a side menu"
+    fun previewGone(previewId: String) = "the preview '$previewId' went without being opened"
 
-    fun splitViewInColumn(id: String) =
-        "the split view '$id' has a column of type 'SplitView': a split view doesn't go inside a split view"
+    /** Any other failure: what could not be done and why, `could not <what>: <reason>`. */
+    fun couldNot(what: String, reason: String) = "could not $what: $reason"
 
-    fun idGivenTwice(id: String) = "the layout gives the id '$id' to two nodes"
+    /** A command whose part of the native core is not written yet. */
+    fun notDoneYet(method: String) = "could not run '$method': the native core doesn't do it yet"
 
     /** The reason of [couldNot] for an exception: its message, else the name of its class. */
     fun reasonOf(e: Throwable): String =

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

@@ -12,6 +12,7 @@ import androidx.lifecycle.LifecycleOwner
 import com.facebook.react.ReactApplication
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
+import dev.apexnative.navigation.react.events.EventContract
 import dev.apexnative.navigation.react.events.EventEmitter
 import dev.apexnative.navigation.utils.WindowFolds
 import java.lang.ref.WeakReference
@@ -148,7 +149,7 @@ internal object Hinge {
 
     private fun toMap(value: Value?): WritableMap = Arguments.createMap().apply {
         if (value == null) return@apply
-        putString("state", value.state)
-        value.angle?.let { putDouble("angle", it.toDouble()) }
+        putString(EventContract.HingeChanged.STATE, value.state)
+        value.angle?.let { putDouble(EventContract.HingeChanged.ANGLE, it.toDouble()) }
     }
 }

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

@@ -73,7 +73,7 @@ internal class OptionsCommands(
         prepare = { OptionsReader.read(options, context()) },
     ) { read ->
         if (!runner.hasActivity()) {
-            runner.logFailure(MERGE_OPTIONS, ErrorTexts.mergeOptionsNoActivity())
+            runner.logFailure(MERGE_OPTIONS, ErrorTexts.nowhereToShow())
             return@runVoid
         }
         val node = findNode(componentId) ?: return@runVoid

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

@@ -4,6 +4,7 @@ import android.content.Context
 import com.facebook.react.ReactApplication
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
+import dev.apexnative.navigation.react.events.EventContract
 import dev.apexnative.navigation.react.events.EventEmitter
 import java.util.concurrent.ConcurrentHashMap
 
@@ -61,9 +62,9 @@ object ScreenInsets {
     }
 
     private fun toMap(value: Insets): WritableMap = Arguments.createMap().apply {
-        putDouble("top", value.top)
-        putDouble("right", value.right)
-        putDouble("bottom", value.bottom)
-        putDouble("left", value.left)
+        putDouble(EventContract.ScreenInsetsChanged.TOP, value.top)
+        putDouble(EventContract.ScreenInsetsChanged.RIGHT, value.right)
+        putDouble(EventContract.ScreenInsetsChanged.BOTTOM, value.bottom)
+        putDouble(EventContract.ScreenInsetsChanged.LEFT, value.left)
     }
 }

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

@@ -7,6 +7,7 @@ import com.facebook.react.ReactApplication
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableArray
 import com.facebook.react.bridge.WritableMap
+import dev.apexnative.navigation.react.events.EventContract
 import dev.apexnative.navigation.react.events.EventEmitter
 import dev.apexnative.navigation.utils.WindowFolds
 import java.util.concurrent.ConcurrentHashMap
@@ -70,17 +71,17 @@ internal object ScreenRegions {
     }
 
     private fun toMap(value: Regions): WritableMap = Arguments.createMap().apply {
-        putArray("division", toArray(value.division))
-        putArray("occlusion", toArray(value.occlusion))
+        putArray(EventContract.ScreenRegionsChanged.DIVISION, toArray(value.division))
+        putArray(EventContract.ScreenRegionsChanged.OCCLUSION, toArray(value.occlusion))
     }
 
     private fun toArray(regions: List<Region>): WritableArray = Arguments.createArray().apply {
         for (region in regions) {
             pushMap(Arguments.createMap().apply {
-                putDouble("x", region.x)
-                putDouble("y", region.y)
-                putDouble("width", region.width)
-                putDouble("height", region.height)
+                putDouble(EventContract.ScreenRegionRect.X, region.x)
+                putDouble(EventContract.ScreenRegionRect.Y, region.y)
+                putDouble(EventContract.ScreenRegionRect.WIDTH, region.width)
+                putDouble(EventContract.ScreenRegionRect.HEIGHT, region.height)
             })
         }
     }

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

@@ -210,43 +210,18 @@ internal object AppearanceDispatcher {
     // A transition whose caller sends the state itself ends: the DidDisappears it sends ask for no update.
     private var holdsState = false
 
-    // A side menu's drawer jumps open: the appearances that start in it send no WillAppear.
-    private var skipsWillAppear = false
-
     // The native screens that told JavaScript they went: once per node.
     private val released: MutableSet<ViewController<*>> = Collections.newSetFromMap(WeakHashMap())
 
     // Appearance of a record.
 
-    /**
-     * The record starts to appear: WillAppear, now when it is ready, else held. Only once per appearance; none inside
-     * [withoutWillAppear].
-     */
+    /** The record starts to appear: WillAppear, now when it is ready, else held. Only once per appearance. */
     fun willAppear(record: ScreenAppearance) {
         if (record.phase != Phase.Hidden) return
         record.phase = Phase.Appearing
-        if (skipsWillAppear) {
-            record.skippedWill = true
-            return
-        }
         if (record.isReady) send(record, Event.WillAppear) else hold(record, Event.WillAppear)
     }
 
-    /**
-     * Runs [block], in which the appearances that start send no WillAppear: their DidAppear is their first event, and
-     * their DidDisappear goes only once that DidAppear went. A side menu's drawer that opens without animation does so
-     * on Android; the screens' options and the components of their bars go as at any appearance.
-     */
-    fun withoutWillAppear(block: () -> Unit) {
-        val outer = skipsWillAppear
-        skipsWillAppear = true
-        try {
-            block()
-        } finally {
-            skipsWillAppear = outer
-        }
-    }
-
     /**
      * The record has appeared: DidAppear, after a WillAppear (asked now when it wasn't), now when nothing is held and
      * it is ready, else held behind what is held. Only once per appearance.
@@ -261,19 +236,12 @@ internal object AppearanceDispatcher {
     /**
      * The record has disappeared. Nothing when it didn't appear. When its WillAppear is still held, JavaScript never
      * heard it appear: what is held goes away and nothing is sent. Otherwise a held DidAppear goes away and
-     * DidDisappear is sent: a swipe that was cancelled gives WillAppear, then DidDisappear. An appearance without its
-     * WillAppear ([withoutWillAppear]) appeared once its DidAppear went.
+     * DidDisappear is sent: a swipe that was cancelled gives WillAppear, then DidDisappear.
      */
     fun didDisappear(record: ScreenAppearance) {
         if (record.phase == Phase.Hidden) return
-        val wasShown = record.phase == Phase.Shown
         record.phase = Phase.Hidden
-        val appeared = if (record.skippedWill) {
-            wasShown && Event.DidAppear !in record.held
-        } else {
-            Event.WillAppear !in record.held
-        }
-        record.skippedWill = false
+        val appeared = Event.WillAppear !in record.held
         record.held.clear()
         cancelLimit(record)
         // What waited for its DidAppear goes now: none will be sent for this appearance.

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"
+    }
+}