Package-level declarations

The trigger a child event uses when it's meant to run unconditionally as part of a plain fan-out (RunEvents, RunCancellableEvents) rather than being matched against a real outcome — those two events run their own events list unconditionally regardless of what trigger each child declares, so inline() documents that intent at the call site instead of implying a real condition like onSuccess() would.

Fires on AsyncImage when Coil fails to load the image — can fire more than once over the tile's lifetime, including on every reload triggered by model changing.

Fires on AsyncImage when Coil enters its loading state — can fire more than once over the tile's lifetime, including on every reload triggered by model changing.

Fires on AsyncImage when the image is decoded and drawn — can fire more than once over the tile's lifetime, including on every reload triggered by model changing.

Fires when the user dismisses/cancels an interactive platform flow without completing it — OpenFilePicker/TakePicture/GetImageFromGallery (no choice made) and DownloadFile (the platform save dialog cancelled), instead of the matching onFailure().

Fires on Checkbox/Switch/FilterChip/InputChip on every toggle, always — after onCheck()/onUncheck(), whichever applies.

Fires on Checkbox/Switch/FilterChip/InputChip when it becomes checked/selected — followed, on the same tap, by the generic onCheckChanged().

Fires when an interactive tile is tapped — the single most common trigger in the catalog, declared on nearly every clickable tile (Button, IconButton, chips, Card, containers with a declared click handler, etc.).

Fires repeatedly on StartCountdownTimer, once per tick, carrying the remaining value as incoming data.

Fires alongside onSuccess() on CheckForReceivedData when a value exists under the requested dataKey, carrying that value as incoming data.

Fires on DatePicker whenever the dialog closes — after confirming, on cancel, or on dismiss.

Fires on DatePicker when the field is pressed while the dialog is closed.

Fires on DatePicker when the confirm button is pressed, carrying the picked ISO date string (yyyy-MM-dd) as incoming data.

Fires once, the first time the declaring tile enters composition — implemented by every built-in container/interactive tile via TileRenderingScope.OnDisplayEffect() (extensions/TileRenderingScopeExtensions.kt), keyed on the tile's own id so it doesn't re-fire on plain recomposition.

Fires alongside onFailure() when DownloadFile/DownloadFileToDisk/DownloadFileToMemory fails (not user cancellation — see onCancelled()), carrying the causing Throwable as incoming data.

Fires alongside onSuccess() when DownloadFile/DownloadFileToDisk/DownloadFileToMemory finishes writing successfully.

Fires repeatedly on DownloadFile/DownloadFileToDisk/DownloadFileToMemory as the download progresses, carrying progress as incoming data.

Fires on DropdownList whenever the menu closes — after picking an item, tapping the anchor while open, or dismissing by tapping outside.

Fires on DropdownList when an item is picked, carrying the picked option's id as incoming data.

Fires on DropdownList when its anchor is tapped while the menu is closed.

Fires when ListFiles finds the requested directory but it holds no files. No data is passed downstream.

The generic failure outcome, fired by nearly every event in the catalog when its work doesn't succeed. Often carries the causing Throwable/parsed error body as incoming data — see the matching event's own catalog entry for exactly what.

Fires on AdaptiveVisibility on first composition and every height change, when its heightVisibility condition is not satisfied.

Fires on AdaptiveVisibility on first composition and every height change, when its heightVisibility condition is satisfied.

Fires when DownloadFileToDisk fails because the device has no free storage left to hold the file, carrying the causing Throwable as incoming data. Replaces onDownloadFailure() and onFailure() for that failure — neither of them fires — and the partially written file is deleted before it fires.

Fires on TextField when the IME action button is pressed and keyboardOptions.imeAction is Done.

Fires on TextField when the IME action button is pressed and keyboardOptions.imeAction is Go.

Fires on TextField when the IME action button is pressed and keyboardOptions.imeAction is Next.

Fires on TextField when the IME action button is pressed and keyboardOptions.imeAction is Previous.

Fires on TextField when the IME action button is pressed and keyboardOptions.imeAction is Search.

Fires on TextField when the IME action button is pressed and keyboardOptions.imeAction is Send.

Fires on TextField when leadingIcon is tapped — only when clickableLeadingIcon is true (defaults to false, unlike trailingIcon's default).

Fires on LazyTiles when its network fetch or response decoding fails, carrying the causing Throwable as incoming data.

Fires on LazyTiles right before its network fetch begins.

Fires on LazyTiles when its network fetch succeeds and the response was decoded into a tile list.

Fires when an interactive tile is long-pressed — only made interactive for long-press when this trigger is actually declared on the tile (e.g. Box/Column/Row only get a long-press handler installed if something listens for it).

Fires on Menu when the item whose id equals itemId is tapped.

Fires on NavigationBar when the item whose id equals itemId is tapped.

Fires on NestedNavigationGraph whenever an entry is displayed — including the start destination, and again every time navigation returns to that entry — carrying the entry's own screenId.

Fires on NavigationRail when the item whose id equals itemId is tapped.

Fires on SendNetworkRequest/UploadFile instead of onFailure() when a child is wired to the exact non-2xx HTTP status code the response came back with.

Fires on SendNetworkRequest/UploadFile instead of onSuccess() when a child is wired to the exact HTTP status code the response came back with.

Fires on Pager/Carousel when the current page/item settles on a new one — once per matching direction per change, so wiring several directions runs several chains for the same page change. The initial page doesn't fire this. Carries the new page/item index (an Int) as incomingData — a mixed-content template like "Page: <||>" resolves against it directly.

Fires on the screen itself (a screen-level trigger, not tied to any one tile) when the screen's lifecycle pauses — the client's internal ScreenTileRenderer wires this to Compose's LifecycleResumeEffect/onPauseOrDispose.

Fires on RequestPermission when the platform wants a rationale shown to the user before asking again — real in practice only on Android, per its own runtime-permission APIs; other platforms only ever produce onPermissionsAcquired()/onPermissionsDenied().

Fires alongside onSuccess() on RequestPermission when every requested permission was granted.

Fires alongside onFailure() on RequestPermission when at least one requested permission was denied.

Fires on PullToRefresh when the user completes a pull gesture — the trigger to hook the real refresh work to.

Fires on SearchBar on every keystroke where the query text actually changes, carrying the new query as incoming data.

Fires on SearchBar when the query is cleared.

Fires on the screen itself (a screen-level trigger, not tied to any one tile) when the screen's lifecycle resumes — the client's internal ScreenTileRenderer wires this to Compose's LifecycleResumeEffect.

Fires on the screen itself (a screen-level trigger, not tied to any one tile) when the screen enters composition — the client's internal ScreenTileRenderer wires this to Compose's onStartOrDispose.

Fires on the screen itself (a screen-level trigger, not tied to any one tile) when the screen leaves composition — the client's internal ScreenTileRenderer wires this to Compose's onStopOrDispose.

Fires on Column/Row (when scrollable = true) and LazyColumn/LazyRow whenever the scroll direction changes — not on every scroll delta. Column/LazyColumn only ever produce ScrollDirection.Top/ScrollDirection.Bottom; Row/LazyRow only ever produce ScrollDirection.Start/ScrollDirection.End.

Fires on LazyColumn/LazyRow when the scroll position comes within scrollThreshold items of the end of the list — the infinite-scroll pagination signal, guarded by Int.ThresholdReachedEffect so it doesn't re-fire until the list actually grows past its last fired count — or, after a failed page shrinks the list back down, past whatever smaller count it shrank to.

Fires on SearchBar when the search action is submitted (e.g. the keyboard's search IME action).

Fires on RadioButton only for the radio button that becomes selected — the ones that lose selection within the same groupId fire nothing.

Fires when a snackbar shown via DisplaySnackbar has its action button pressed — fires later, asynchronously, well after DisplaySnackbar's own onSuccess() (which only confirms the show broadcast was sent).

Fires when a snackbar shown via DisplaySnackbar goes away without its action button being pressed — fires later, asynchronously, well after DisplaySnackbar's own onSuccess().

Fires on an event right before its real (typically async/network) work begins — lets a child react to "the operation started" separately from its eventual outcome (e.g. showing a loading spinner). Declared by most networking and data-reading events (SendNetworkRequest, UploadFile, GetData, GetScreen/RefreshScreen, the download events).

The generic success outcome, fired by nearly every event in the catalog when its work succeeds. Often carries the produced value as incoming data — see the matching event's own catalog entry for exactly what.

Fires on SystemBroadcastListener when a value is published on the app-wide system broadcast channel under broadcastId (via BroadcastToSystem), carrying the published value as incoming data.

Fires on Tabs when the tab whose id equals itemId is tapped.

Fires on TextField on every keystroke where the text actually changes vs. its current value, carrying the new text as incoming data.

Fires on StartCountdownTimer when the countdown reaches zero.

Fires repeatedly on StartTimeLoop, once per tick.

Fires on TimePicker whenever the dialog closes — after confirming, on cancel, or on dismiss.

Fires on TimePicker when the field is pressed while the dialog is closed.

Fires on TimePicker when the confirm button is pressed, carrying the picked ISO time string (HH:mm) as incoming data.

Fires on TextField when trailingIcon is tapped — only when clickableTrailingIcon is true (defaults to true, matching the common "clear button" pattern).

Fires on Checkbox/Switch/FilterChip/InputChip when it becomes unchecked/unselected — followed, on the same tap, by the generic onCheckChanged().

Fires repeatedly on UploadFile as the upload progresses, carrying progress as incoming data.

Fires on AdaptiveVisibility on first composition and every width change, when its widthVisibility condition is not satisfied.

Fires on AdaptiveVisibility on first composition and every width change, when its widthVisibility condition is satisfied.