core-ui/org.meshtastic.core.ui.viewmodel

Package-level declarations

Types

enum ConnectionStatus : Enum<ConnectionStatus>

Derived, UI-friendly summary of the device connection lifecycle. Combines ServiceRepository.connectionState with the ServiceRepository.RECONNECTING_PROGRESS_TEXT handshake-recovery signal and expected-restart state. Configuration health is modeled separately so region, lockdown, and managed-mode policy cannot leak into the connection label.

ConnectionsViewModel

class ConnectionsViewModel(radioConfigRepository: RadioConfigRepository, serviceRepository: ServiceRepository, nodeRepository: NodeRepository, nodeManager: NodeManager, nodeRestartTracker: NodeRestartTracker, uiPrefs: UiPrefs, deviceHardwareRepository: DeviceHardwareRepository, firmwareReleaseRepository: FirmwareReleaseRepository, radioPrefs: RadioPrefs, notificationManager: NotificationManager) : ViewModel

UiState

sealed interface UiState<out T>

Lightweight tri-state wrapper for UI data. Prefer this over bare nullable initial values when the UI needs to distinguish "still loading" from "genuinely empty."

UIViewModel

class UIViewModel(nodeDB: NodeRepository, serviceRepository: ServiceRepository, radioController: RadioController, lockdownCoordinator: LockdownCoordinator, radioInterfaceService: RadioInterfaceService, meshLogRepository: MeshLogRepository, firmwareReleaseRepository: FirmwareReleaseRepository, eventFirmwareRepository: EventFirmwareRepository, firmwareUpdateStatusRepository: FirmwareUpdateStatusRepository, uiPrefs: UiPrefs, notificationManager: NotificationManager, packetRepository: PacketRepository, val alertManager: AlertManager, val snackbarManager: SnackbarManager, nodeRestartTracker: NodeRestartTracker) : ViewModel

Shared base for the application-level ViewModel.

Functions

asUiState

context(viewModel: ViewModel)
fun <T> Flow<T>.asUiState(stopTimeout: Duration = 5.seconds): StateFlow<UiState<T>>

Wraps this Flow into a StateFlow<UiState<T>>, emitting UiState.Loading until the first value, then UiState.Content for each emission. Upstream errors are caught and mapped to UiState.Error.

dataOrNull

fun <T> UiState<T>.dataOrNull(): T?

Returns the Content data, or null if this state is Loading or Error.

errorEventFlow

fun errorEventFlow(): MutableSharedFlow<UiText>

Creates and returns a MutableSharedFlow intended for one-shot error events. Expose as Flow via kotlinx.coroutines.flow.asFlow in the ViewModel (hiding hot-flow semantics), and collect in the UI to show snackbars or toasts.

safeLaunch

context(viewModel: ViewModel)
fun safeLaunch(context: CoroutineContext = EmptyCoroutineContext, errorEvents: MutableSharedFlow<UiText>? = null, tag: String? = null, block: suspend CoroutineScope.() -> Unit): Job

Launches a coroutine in viewModelScope that catches all exceptions except CancellationException. Non-cancellation errors are logged and emitted to errorEvents (if provided) for one-shot UI consumption (e.g. snackbar / toast).

stateInWhileSubscribed

context(viewModel: ViewModel)
fun <T> Flow<T>.stateInWhileSubscribed(initialValue: T, stopTimeout: Duration = 5.seconds): StateFlow<T>

Extension for converting a Flow to a StateFlow in a ViewModel context.