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

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(source)

Shared base for the application-level ViewModel.

Contains all platform-independent state and actions (themes, alerts, connection state, firmware checks, traceroute, shared contacts, channel sets, unread counts, etc.).

Constructors

UIViewModel

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

Types

Companion

object Companion

Properties

alertManager

val alertManager: AlertManager

appIntroCompleted

val appIntroCompleted: StateFlow<Boolean>

clientNotification

val clientNotification: StateFlow<ClientNotification?>

connectionState

val connectionState: StateFlow<ConnectionState>

Canonical app-level connection state, sourced from ServiceRepository.connectionState.

currentDeviceAddressFlow

val currentDeviceAddressFlow: StateFlow<String?>

eventEdition

val eventEdition: StateFlow<EventFirmwareEdition?>

eventThemeEnabled

val eventThemeEnabled: StateFlow<Boolean>

Opt-out for applying an event edition's ambient theme (accent + typeface) app-wide.

firmwareEdition

val firmwareEdition: Flow<FirmwareEdition?>

latestStableFirmwareRelease

val latestStableFirmwareRelease: Flow<DeviceVersion>

lockdownState

val lockdownState: StateFlow<LockdownState>

lockdownTokenInfo

val lockdownTokenInfo: StateFlow<LockdownTokenInfo?>

meshActivity

val meshActivity: Flow<MeshActivity>

Emits events for mesh network send/receive activity.

myNodeInfo

val myNodeInfo: StateFlow<MyNodeInfo?>

navigationDeepLink

val navigationDeepLink: SharedFlow<List<NavKey>>

neighborInfoResponse

val neighborInfoResponse: StateFlow<String?>

nodeRestartExpected

val nodeRestartExpected: StateFlow<Boolean>

True while the connected node is expected to be mid-restart (reboot-applying config save or reboot command).

requestChannelSet

val requestChannelSet: StateFlow<ChannelSet?>

scrollToTopEventFlow

val scrollToTopEventFlow: Flow<ScrollToTopEvent>

sharedContactRequested

val sharedContactRequested: StateFlow<SharedContact?>

snackbarManager

val snackbarManager: SnackbarManager

theme

val theme: StateFlow<Int>

tracerouteResponse

val tracerouteResponse: Flow<TracerouteResponse?>

unreadMessageCount

val unreadMessageCount: StateFlow<Int>

watchdogReconnectInFlight

val watchdogReconnectInFlight: StateFlow<Boolean>

True while the handshake-stall watchdog is force-reconnecting the transport, so the UI can present the transient Disconnected window as an in-progress recovery rather than a user-visible disconnect. Same signal contract as ConnectionsViewModel.connectionStatus's RECONNECTING case.

Functions

addCloseable

expect open fun addCloseable(closeable: AutoCloseable)

expect fun addCloseable(key: String, closeable: AutoCloseable)

clearClientNotification

fun clearClientNotification(notification: ClientNotification)

clearLockdownState

fun clearLockdownState()

clearNeighborInfoResponse

fun clearNeighborInfoResponse()

clearRequestChannelUrl

fun clearRequestChannelUrl()

Clears the pending channel set import request.

clearSharedContactRequested

fun clearSharedContactRequested()

Clears the pending shared contact request.

clearTracerouteResponse

fun clearTracerouteResponse()

dismissAlert

fun dismissAlert()

emitScrollToTopEvent

fun emitScrollToTopEvent(event: ScrollToTopEvent)

getCloseable

expect fun <T : AutoCloseable> getCloseable(key: String): T?

handleDeepLink

fun handleDeepLink(uri: CommonUri, onInvalid: () -> Unit = {})

Unified handler for all Meshtastic deep links and OS intents.

onAppIntroCompleted

fun onAppIntroCompleted()

onDeepLinkHandled

fun onDeepLinkHandled()

Clears the buffered deep link once its collector has applied it to the backstack.

sendLockdownUnlock

fun sendLockdownUnlock(passphrase: String, bootTtl: Int = DEFAULT_BOOT_TTL, hourTtl: Int = 0, maxSessionSeconds: Int = 0, disable: Boolean = false)

sendLockNow

fun sendLockNow()

setDeviceAddress

fun setDeviceAddress(address: String)

setEventThemeEnabled

fun setEventThemeEnabled(enabled: Boolean)

setRequestChannelSet

fun setRequestChannelSet(channelSet: ChannelSet?)

setSharedContactRequested

fun setSharedContactRequested(contact: SharedContact?)

showAlert

fun showAlert(title: String? = null, titleRes: StringResource? = null, message: String? = null, messageRes: StringResource? = null, composableMessage: ComposableContent? = null, html: String? = null, onConfirm: () -> Unit? = {}, onDismiss: () -> Unit? = null, confirmText: String? = null, confirmTextRes: StringResource? = null, dismissText: String? = null, dismissTextRes: StringResource? = null, choices: Map<String, () -> Unit> = emptyMap())

showSnackbar

fun showSnackbar(message: String, actionLabel: String? = null, onAction: () -> Unit? = null)

tracerouteMapAvailability

fun tracerouteMapAvailability(forwardRoute: List<Int>, returnRoute: List<Int>): TracerouteMapAvailability