mosaic-client/dev.catbit.mosaic.client.ui.sdui.foundation.tiles.holder/BuilderScope

BuilderScope

class BuilderScope(tileHolderBuilderManager: TileHolderBuilderManager, eventHolderBuilderManager: EventHolderBuilderManager, serializer: MosaicSerializer, koinScope: Scope)

Scope handed as the extension receiver to every dev.catbit.mosaic.client.ui.sdui.foundation.tiles.holder.tile.TileHolderBuilder.build and dev.catbit.mosaic.client.ui.sdui.foundation.tiles.holder.event.EventHolderBuilder.build call — the toolbox a HolderBuilder uses to turn a TileSchema/EventSchema into its live Holder counterpart.

Its central job is letting a builder recurse into its own children without needing a reference to the app-wide TileHolderBuilderManager/EventHolderBuilderManager directly — buildTileHolder/ buildEventHolder (and their list-oriented buildEventHolders/buildTileHolders extensions) look up the right builder for each child schema's own concrete class and build it, which is how a container tile's children, or an event's own nested events, end up as fully-built holders too. It also exposes decode/decodeOrNull (for a builder that needs to interpret an opaque AnySerializable field as a concrete type) and the same Koin get/getOrNull/logError/log helpers available elsewhere in the framework.

One BuilderScope instance is created per screen (owned by that screen's TilesManager) and reused for every holder built while that screen is alive.

Constructors

BuilderScope

constructor(tileHolderBuilderManager: TileHolderBuilderManager, eventHolderBuilderManager: EventHolderBuilderManager, serializer: MosaicSerializer, koinScope: Scope)

Functions

build

open override fun BuilderScope.build(eventSchema: CheckForReceivedDataEventSchema): CheckForReceivedDataEventHolder

open override fun BuilderScope.build(eventSchema: EvaluateDataEventSchema): EvaluateDataEventHolder

open override fun BuilderScope.build(eventSchema: GetDataEventSchema): GetDataEventHolder

open override fun BuilderScope.build(eventSchema: ProcessDataEventSchema): ProcessDataEventHolder

open override fun BuilderScope.build(eventSchema: RemoveDataEventSchema): RemoveDataEventHolder

open override fun BuilderScope.build(eventSchema: SendDataEventSchema): SendDataEventHolder

open override fun BuilderScope.build(eventSchema: TransformDataEventSchema): TransformDataEventHolder

open override fun BuilderScope.build(eventSchema: UpdateDataEventSchema): UpdateDataEventHolder

open override fun BuilderScope.build(eventSchema: CancelEventsEventSchema): CancelEventsEventHolder

open override fun BuilderScope.build(eventSchema: RunCancellableEventsEventSchema): RunCancellableEventsEventHolder

open override fun BuilderScope.build(eventSchema: RunEventsEventSchema): RunEventsEventHolder

open override fun BuilderScope.build(eventSchema: TriggerEventEventSchema): TriggerEventEventHolder

open override fun BuilderScope.build(eventSchema: UpdateEventsEventSchema): UpdateEventsEventHolder

open override fun BuilderScope.build(eventSchema: DeleteFileEventSchema): DeleteFileEventHolder

open override fun BuilderScope.build(eventSchema: GetFileEventSchema): GetFileEventHolder

open override fun BuilderScope.build(eventSchema: OpenFilePickerEventSchema): OpenFilePickerEventHolder

open override fun BuilderScope.build(eventSchema: SaveFileEventSchema): SaveFileEventHolder

open override fun BuilderScope.build(eventSchema: GetImageFromGalleryEventSchema): GetImageFromGalleryEventHolder

open override fun BuilderScope.build(eventSchema: TakePictureEventSchema): TakePictureEventHolder

open override fun BuilderScope.build(eventSchema: ToggleMenuEventSchema): ToggleMenuEventHolder

open override fun BuilderScope.build(eventSchema: NavigateEventSchema): NavigateEventHolder

open override fun BuilderScope.build(eventSchema: NavigateClearingStackEventSchema): NavigateClearingStackEventHolder

open override fun BuilderScope.build(eventSchema: NavigateUpEventSchema): NavigateUpEventHolder

open override fun BuilderScope.build(eventSchema: DownloadFileEventSchema): DownloadFileEventHolder

open override fun BuilderScope.build(eventSchema: DownloadFileToDiskEventSchema): DownloadFileToDiskEventHolder

open override fun BuilderScope.build(eventSchema: DownloadFileToMemoryEventSchema): DownloadFileToMemoryEventHolder

open override fun BuilderScope.build(eventSchema: SendNetworkRequestEventSchema): SendNetworkRequestEventHolder

open override fun BuilderScope.build(eventSchema: SetIncomingDataToNetworkParamsHolderBodyEventSchema): SetIncomingDataToNetworkParamsHolderBodyEventHolder

open override fun BuilderScope.build(eventSchema: SetIncomingDataToNetworkParamsHolderHeadersEventSchema): SetIncomingDataToNetworkParamsHolderHeadersEventHolder

open override fun BuilderScope.build(eventSchema: SetIncomingDataToNetworkParamsHolderQueryParametersEventSchema): SetIncomingDataToNetworkParamsHolderQueryParametersEventHolder

open override fun BuilderScope.build(eventSchema: SetIncomingDataToNetworkParamsHolderUrlEventSchema): SetIncomingDataToNetworkParamsHolderUrlEventHolder

open override fun BuilderScope.build(eventSchema: UploadFileEventSchema): UploadFileEventHolder

open override fun BuilderScope.build(eventSchema: DismissBottomSheetEventSchema): DismissBottomSheetEventHolder

open override fun BuilderScope.build(eventSchema: DisplayBottomSheetEventSchema): DisplayBottomSheetEventHolder

open override fun BuilderScope.build(eventSchema: DismissDialogEventSchema): DismissDialogEventHolder

open override fun BuilderScope.build(eventSchema: DisplayDialogEventSchema): DisplayDialogEventHolder

open override fun BuilderScope.build(eventSchema: DismissModalBottomSheetEventSchema): DismissModalBottomSheetEventHolder

open override fun BuilderScope.build(eventSchema: DisplayModalBottomSheetEventSchema): DisplayModalBottomSheetEventHolder

open override fun BuilderScope.build(eventSchema: DismissNavigationDrawerEventSchema): DismissNavigationDrawerEventHolder

open override fun BuilderScope.build(eventSchema: DisplayNavigationDrawerEventSchema): DisplayNavigationDrawerEventHolder

open override fun BuilderScope.build(eventSchema: DismissSnackbarEventSchema): DismissSnackbarEventHolder

open override fun BuilderScope.build(eventSchema: DisplaySnackbarEventSchema): DisplaySnackbarEventHolder

open override fun BuilderScope.build(eventSchema: TogglePopupEventSchema): TogglePopupEventHolder

open override fun BuilderScope.build(eventSchema: StopRefreshingEventSchema): StopRefreshingEventHolder

open override fun BuilderScope.build(eventSchema: ChangeScreenStateEventSchema): ChangeScreenStateEventHolder

open override fun BuilderScope.build(eventSchema: GetScreenEventSchema): GetScreenEventHolder

open override fun BuilderScope.build(eventSchema: RefreshScreenEventSchema): RefreshScreenEventHolder

open override fun BuilderScope.build(eventSchema: ScrollColumnTileEventSchema): ScrollColumnTileEventHolder

open override fun BuilderScope.build(eventSchema: ScrollPagerTileEventSchema): ScrollPagerTileEventHolder

open override fun BuilderScope.build(eventSchema: ScrollRowTileEventSchema): ScrollRowTileEventHolder

open override fun BuilderScope.build(eventSchema: RequestPermissionEventSchema): RequestPermissionEventHolder

open override fun BuilderScope.build(eventSchema: BroadcastToSystemEventSchema): BroadcastToSystemEventHolder

open override fun BuilderScope.build(eventSchema: CheckIfHasInternetConnectionEventSchema): CheckIfHasInternetConnectionEventHolder

open override fun BuilderScope.build(eventSchema: DropCachesEventSchema): DropCachesEventHolder

open override fun BuilderScope.build(eventSchema: OpenExternalLinkEventSchema): OpenExternalLinkEventHolder

open override fun BuilderScope.build(eventSchema: ResetThemeEventSchema): ResetThemeEventHolder

open override fun BuilderScope.build(eventSchema: SetThemeEventSchema): SetThemeEventHolder

open override fun BuilderScope.build(eventSchema: AddTilesEventSchema): AddTilesEventHolder

open override fun BuilderScope.build(eventSchema: CheckIfTileContainsChildrenEventSchema): CheckIfTileContainsChildrenEventHolder

open override fun BuilderScope.build(eventSchema: GetTileChildrenCountEventSchema): GetTileChildrenCountEventHolder

open override fun BuilderScope.build(eventSchema: ReloadLazyTilesEventSchema): ReloadLazyTilesEventHolder

open override fun BuilderScope.build(eventSchema: RemoveTilesEventSchema): RemoveTilesEventHolder

open override fun BuilderScope.build(eventSchema: ReplaceTilesEventSchema): ReplaceTilesEventHolder

open override fun BuilderScope.build(eventSchema: UpdateTilesEventSchema): UpdateTilesEventHolder

open override fun BuilderScope.build(eventSchema: WipeTilesEventSchema): WipeTilesEventHolder

open override fun BuilderScope.build(eventSchema: StartCountdownTimerEventSchema): StartCountdownTimerEventHolder

open override fun BuilderScope.build(eventSchema: StartTimeLoopEventSchema): StartTimeLoopEventHolder

Builds a fresh E from eventSchema.

open override fun BuilderScope.build(tileModel: BottomAppBarTileSchema): BottomAppBarTileHolder

open override fun BuilderScope.build(tileModel: TopAppBarTileSchema): TopAppBarTileHolder

open override fun BuilderScope.build(tileModel: BadgeTileSchema): BadgeTileHolder

open override fun BuilderScope.build(tileModel: ButtonTileSchema): ButtonTileHolder

open override fun BuilderScope.build(tileModel: FloatingActionButtonTileSchema): FloatingActionButtonTileHolder

open override fun BuilderScope.build(tileModel: IconButtonTileSchema): IconButtonTileHolder

open override fun BuilderScope.build(tileModel: AssistChipTileSchema): AssistChipTileHolder

open override fun BuilderScope.build(tileModel: FilterChipTileSchema): FilterChipTileHolder

open override fun BuilderScope.build(tileModel: InputChipTileSchema): InputChipTileHolder

open override fun BuilderScope.build(tileModel: SuggestionChipTileSchema): SuggestionChipTileHolder

open override fun BuilderScope.build(tileModel: AdaptiveVisibilityTileSchema): AdaptiveVisibilityTileHolder

open override fun BuilderScope.build(tileModel: BoxTileSchema): BoxTileHolder

open override fun BuilderScope.build(tileModel: CardTileSchema): CardTileHolder

open override fun BuilderScope.build(tileModel: CarouselTileSchema): CarouselTileHolder

open override fun BuilderScope.build(tileModel: ColumnTileSchema): ColumnTileHolder

open override fun BuilderScope.build(tileModel: FlexBoxTileSchema): FlexBoxTileHolder

open override fun BuilderScope.build(tileModel: FlowRowTileSchema): FlowRowTileHolder

open override fun BuilderScope.build(tileModel: GridTileSchema): GridTileHolder

open override fun BuilderScope.build(tileModel: LazyColumnTileSchema): LazyColumnTileHolder

open override fun BuilderScope.build(tileModel: LazyRowTileSchema): LazyRowTileHolder

open override fun BuilderScope.build(tileModel: LazyTilesTileSchema): LazyTilesTileHolder

open override fun BuilderScope.build(tileModel: PagerTileSchema): PagerTileHolder

open override fun BuilderScope.build(tileModel: PullToRefreshTileSchema): PullToRefreshTileHolder

open override fun BuilderScope.build(tileModel: RowTileSchema): RowTileHolder

open override fun BuilderScope.build(tileModel: SelectionContainerTileSchema): SelectionContainerTileHolder

open override fun BuilderScope.build(tileModel: ShimmerTileSchema): ShimmerTileHolder

open override fun BuilderScope.build(tileModel: AsyncImageTileSchema): AsyncImageTileHolder

open override fun BuilderScope.build(tileModel: IconTileSchema): IconTileHolder

open override fun BuilderScope.build(tileModel: ImageTileSchema): ImageTileHolder

open override fun BuilderScope.build(tileModel: CheckboxTileSchema): CheckboxTileHolder

open override fun BuilderScope.build(tileModel: DatePickerTileSchema): DatePickerTileHolder

open override fun BuilderScope.build(tileModel: DropdownListTileSchema): DropdownListTileHolder

open override fun BuilderScope.build(tileModel: RadioButtonTileSchema): RadioButtonTileHolder

open override fun BuilderScope.build(tileModel: SwitchTileSchema): SwitchTileHolder

open override fun BuilderScope.build(tileModel: TextFieldTileSchema): TextFieldTileHolder

open override fun BuilderScope.build(tileModel: TimePickerTileSchema): TimePickerTileHolder

open override fun BuilderScope.build(tileModel: ScreenTileSchema): ScreenTileHolder

open override fun BuilderScope.build(tileModel: MenuTileSchema): MenuTileHolder

open override fun BuilderScope.build(tileModel: NavigationBarTileSchema): NavigationBarTileHolder

open override fun BuilderScope.build(tileModel: NavigationRailTileSchema): NavigationRailTileHolder

open override fun BuilderScope.build(tileModel: NestedNavigationGraphTileSchema): NestedNavigationGraphTileHolder

open override fun BuilderScope.build(tileModel: TabsTileSchema): TabsTileHolder

open override fun BuilderScope.build(tileModel: PopupTileSchema): PopupTileHolder

open override fun BuilderScope.build(tileModel: CircularProgressIndicatorTileSchema): CircularProgressIndicatorTileHolder

open override fun BuilderScope.build(tileModel: LinearProgressIndicatorTileSchema): LinearProgressIndicatorTileHolder

open override fun BuilderScope.build(tileModel: SearchBarTileSchema): SearchBarTileHolder

open override fun BuilderScope.build(tileModel: SystemBroadcastListenerTileSchema): SystemBroadcastListenerTileHolder

open override fun BuilderScope.build(tileModel: SimpleTextTileSchema): SimpleTextTileHolder

open override fun BuilderScope.build(tileModel: TooltipTileSchema): TooltipTileHolder

Builds a fresh H from tileModel.

buildEventHolder

fun buildEventHolder(eventSchema: EventSchema): EventHolder<*>

Looks up the dev.catbit.mosaic.client.ui.sdui.foundation.tiles.holder.event.EventHolderBuilder registered for eventSchema's own concrete class and builds it.

buildEventHolders

fun List<EventSchema>?.buildEventHolders(): MutableList<EventHolder<*>>

Builds a holder for every entry in this list via buildEventHolder — the standard way a TileHolderBuilder/EventHolderBuilder turns its own schema's events field into the events constructor argument of the Holder it's building.

buildTileHolder

fun buildTileHolder(tileSchema: TileSchema): TileHolder<*>

Looks up the dev.catbit.mosaic.client.ui.sdui.foundation.tiles.holder.tile.TileHolderBuilder registered for tileSchema's own concrete class and builds it.

buildTileHolders

fun List<TileSchema>?.buildTileHolders(): MutableList<TileHolder<*>>

Builds a holder for every entry in this list via buildTileHolder — the standard way a container tile's TileHolderBuilder turns its own schema's tiles field into the tiles constructor argument of the TileHolder it's building.

decode

inline fun <T : Any> decode(data: Any): T

Decodes data as T via the framework's MosaicSerializer, using T's own generated KSerializer — for a builder that needs to interpret an opaque AnySerializable field (already a raw JSON-shaped value, not a JSON string) as a concrete type.

fun <T> decode(strategy: KSerializer<T>, data: Any): T

Non-reified overload of decode, for a caller supplying its own KSerializer rather than relying on T's generated one.

decodeOrNull

inline fun <T : Any> decodeOrNull(data: Any?): T?

Same as decode, but returns null instead of throwing when data is null or doesn't match T's expected shape.

fun <T> decodeOrNull(strategy: KSerializer<T>, data: Any?): T?

Non-reified overload of decodeOrNull.

get

inline fun <T : Any> get(qualifier: Qualifier? = null, noinline parameters: ParametersDefinition? = null): T

Resolves an instance of T from the app's Koin scope — the way a HolderBuilder reaches a dependency it needs at construction time.

fun <T : Any> get(clazz: KClass<T>, qualifier: Qualifier? = null, parameters: ParametersDefinition? = null): T

Non-reified overload of get.

getOrNull

inline fun <T : Any> getOrNull(qualifier: Qualifier? = null, noinline parameters: ParametersDefinition? = null): T?

Same as get, but returns null instead of throwing when no binding is registered for T.

fun <T : Any> getOrNull(clazz: KClass<T>, qualifier: Qualifier? = null, parameters: ParametersDefinition? = null): T?

Non-reified overload of getOrNull.

log

fun log(level: Level, msg: String)

Logs msg at level via the app's MosaicLogger.

logError

fun logError(tag: String = "MosaicCommonError", throwable: Throwable)

Logs throwable at error level via the app's MosaicLogger, prefixed with tag.