mosaic-server/dev.catbit.mosaic.server.builder.tile.builders.system/SystemBroadcastListener

SystemBroadcastListener

fun TileSchemaBuilderScope.SystemBroadcastListener(id: String = randomId(), events: EventSchemaBuilderScope.() -> Unit = {}, style: StyleSchemaBuilderScope.() -> Unit = {}, searchableTerms: List<String>? = null, visibility: TileSchema.Visibility = visible(), tiles: TileSchemaBuilderScope.() -> Unit)

Renders tiles and, while they are on screen, subscribes to the app-wide system broadcast channel — the tile that lets host-app signals (push notifications, connectivity changes, anything the client publishes on that channel) drive server-declared event flows. The subscription lives only as long as the tile is composed; while it is off screen, broadcasts are not observed. Children are hosted in a Box carrying style and visibility, so they are stacked rather than emitted into the parent's scope. Dispatches onSystemBroadcast(broadcastId) for each broadcast received, carrying the broadcast payload as the event's incoming data, so events can be wired per broadcast.

Parameters

Unique identifier of the tile. Defaults to a random id.

events

Events owned by this tile, wired to its triggers (e.g. onSystemBroadcast).

style

Layout/appearance modifiers applied to the wrapping Box (size, padding, background, etc).

searchableTerms

Terms used by an ancestor's search/filter to decide whether this tile matches. Defaults to none.

visibility

Whether the tile is shown, hidden but occupies space, or removed from layout. Defaults to visible.

tiles

Child tiles rendered while the broadcast channel is subscribed to.