mosaic-core/dev.catbit.mosaic.core.data.schemas.event.events.navigation/NavigateClearingStackEventSchema

NavigateClearingStackEventSchema

@Serializable

@SerialName(value = "NavigateClearingStack")

data class NavigateClearingStackEventSchema(val id: String, val trigger: EventTrigger, val events: SerializableImmutableList<EventSchema>?, val destination: String, val navigatorId: String, val launchSingleTop: Boolean = true, val data: Map<String, AnySerializable>?) : EventSchema

Navigates the graph registered under navigatorId to destination, clearing the whole back stack so the destination becomes the only entry — the usual move after login or logout.

Navigation data: the destination receives the event's incomingData merged with data, with data winning on key collision. Only map-shaped incomingData contributes, and null values are dropped from both — navigation arguments are never null.

launchSingleTop (default true) avoids stacking a second copy when the destination is already the current entry.

incomingData consumed: merged into the destination's navigation data when it is a map.

Triggers fired:

OnSuccessEventTrigger — when the navigation was performed. No data is passed downstream.
OnFailureEventTrigger — when no navigator is registered under navigatorId, or the navigator refused the navigation; no data is passed and the error is logged.

Constructors

NavigateClearingStackEventSchema

constructor(id: String, trigger: EventTrigger, events: SerializableImmutableList<EventSchema>?, destination: String, navigatorId: String, launchSingleTop: Boolean = true, data: Map<String, AnySerializable>?)

Properties

data

@SerialName(value = "data")

val data: Map<String, AnySerializable>?

destination

@SerialName(value = "destination")

val destination: String

events

@SerialName(value = "events")

open override val events: SerializableImmutableList<EventSchema>?

This event's own children — each declaring, via its own trigger, which of this event's outgoing triggers runs it. null when this event declares no children.

@SerialName(value = "id")

open override val id: String

Unique identifier — how TriggerEvent/UpdateEvents address this event by id. Defaults to a random id when omitted from the DSL.

launchSingleTop

@SerialName(value = "launchSingleTop")

val launchSingleTop: Boolean

navigatorId

@SerialName(value = "navigatorId")

val navigatorId: String

trigger

@SerialName(value = "trigger")

open override val trigger: EventTrigger

The condition that must occur for this event to run — matched by structural equality (data class/data object equality) against whatever trigger value fired, never by any kind of subscription or listener registry.