feature-node/org.meshtastic.feature.node.component

Package-level declarations

Types

enum HopWindow : Enum<HopWindow>

"Last heard" windows offered above the histogram. A null hours means no time filter (all known nodes).

NodeFilterToggles

data class NodeFilterToggles(val includeUnknown: Boolean, val onToggleIncludeUnknown: () -> Unit, val excludeInfrastructure: Boolean, val onToggleExcludeInfrastructure: () -> Unit, val onlyOnline: Boolean, val onToggleOnlyOnline: () -> Unit, val onlyDirect: Boolean, val onToggleOnlyDirect: () -> Unit, val showIgnored: Boolean, val onToggleShowIgnored: () -> Unit, val ignoredNodeCount: Int, val excludeUnheard: Boolean, val onToggleExcludeUnheard: () -> Unit, val excludeMqtt: Boolean, val onToggleExcludeMqtt: () -> Unit, val onlySigned: Boolean, val onToggleOnlySigned: () -> Unit, val onlyEncrypted: Boolean, val onToggleOnlyEncrypted: () -> Unit)

sealed class NodeMenuAction

Properties

NODE_FILTER_SEARCH_BAR_INPUT_FIELD_TAG

const val NODE_FILTER_SEARCH_BAR_INPUT_FIELD_TAG: String

Tag for the collapsed node search field, so a test can target it rather than the expanded overlay's copy.

Functions

AdministrationSection

fun AdministrationSection(node: Node, metricsState: MetricsState, onAction: (NodeDetailAction) -> Unit, onFirmwareSelect: (FirmwareRelease) -> Unit, sessionStatus: SessionStatus, isEnsuringSession: Boolean, modifier: Modifier = Modifier)

fun AirQualityInfo(iaq: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

AirQualityInfoCardsPreview

fun AirQualityInfoCardsPreview()

AirQualityInfoCardsStatusPreview

fun AirQualityInfoCardsStatusPreview()

A status register setting a fault (fan, bit 4), a warning (fan speed, bit 21) and a bit this build does not name (bit

fun ChannelInfo(channel: Int, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

CompassSheetContent

fun CompassSheetContent(uiState: CompassUiState, onRequestLocationPermission: () -> Unit, onOpenLocationSettings: () -> Unit, onRequestPosition: () -> Unit, modifier: Modifier = Modifier)

CooldownIconButton

fun CooldownIconButton(onClick: () -> Unit, cooldownTimestamp: Long?, modifier: Modifier = Modifier, cooldownDuration: Long = COOL_DOWN_TIME_MS, content: @Composable () -> Unit)

CooldownOutlinedIconButton

fun CooldownOutlinedIconButton(onClick: () -> Unit, cooldownTimestamp: Long?, modifier: Modifier = Modifier, cooldownDuration: Long = COOL_DOWN_TIME_MS, content: @Composable () -> Unit)

fun DeviceActions(node: Node, ourNode: Node?, lastTracerouteTime: Long?, lastRequestNeighborsTime: Long?, availableLogs: Set<LogsType>, onAction: (NodeDetailAction) -> Unit, displayUnits: MeasurementSystem, isFahrenheit: Boolean, modifier: Modifier = Modifier, isLocal: Boolean = false, hasConversation: Boolean = false, airQualityHistory: List<Telemetry> = emptyList())

DeviceActionsLocalPreview

fun DeviceActionsLocalPreview()

DeviceActionsRemotePreview

fun DeviceActionsRemotePreview()

DeviceLinksSection

fun DeviceLinksSection(links: List<DeviceLink>, modifier: Modifier = Modifier)

Collapsible "I want one" section listing msh.to vendor/variant and marketplace links for the viewed device. Renders nothing when there are no matching links. Ported from the Meshtastic-Apple DeviceLinksSection.

fun DistanceInfo(distance: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

fun ElevationInfo(modifier: Modifier = Modifier, altitude: Int, system: MeasurementSystem, suffix: String = stringResource(Res.string.elevation_suffix), contentColor: Color = MaterialTheme.colorScheme.onSurface)

EnvironmentMetricsLightningPreview

fun EnvironmentMetricsLightningPreview()

Temperature and humidity for context, plus the AS3935 pair that shares a column.

EnvironmentMetricsPreview

fun EnvironmentMetricsPreview()

FirmwareReleaseSheetContent

fun FirmwareReleaseSheetContent(firmwareRelease: FirmwareRelease, modifier: Modifier = Modifier)

fun HardwareInfo(hwModel: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

fun hopHistogram(nodes: List<Node>, cutoffSecs: Int?): List<Int>

Counts nodes at each hop distance, as a list indexed by hop (element 0 = direct nodes). The list is contiguous from hop 0 up to the furthest hop observed, so zero-count gaps in the middle are preserved. Nodes with an unknown hop (hopsAway < 0) are excluded. When cutoffSecs is non-null, only nodes with lastHeard >= cutoffSecs are counted. Returns an empty list when nothing qualifies.

HopHistogramContentPreview

fun HopHistogramContentPreview()

HopHistogramEmptyPreview

fun HopHistogramEmptyPreview()

fun HopsInfo(hops: Int, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

fun HumidityInfo(humidity: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

fun IconInfo(icon: ImageVector, contentDescription: String, modifier: Modifier = Modifier, label: String? = null, text: String? = null, style: TextStyle = MaterialTheme.typography.labelMedium, contentColor: Color = MaterialTheme.colorScheme.onSurface, content: @Composable () -> Unit = {})

fun InfoCard(text: String, value: String, modifier: Modifier = Modifier, icon: ImageVector? = null, iconRes: DrawableResource? = null, rotateIcon: Float = 0.0f, valueColor: Color = MaterialTheme.colorScheme.onSurface)

fun LastHeardInfo(modifier: Modifier = Modifier, lastHeard: Int, showLabel: Boolean = true, contentColor: Color = MaterialTheme.colorScheme.onSurface)

LinkedCoordinatesItem

fun LinkedCoordinatesItem(node: Node, displayUnits: MeasurementSystem = MeasurementSystem.METRIC)

LocalNodeContextMenu

fun LocalNodeContextMenu(expanded: Boolean, onUpdateStatus: () -> Unit, onDismiss: () -> Unit)

A menu of its own: favoriting, muting, messaging or removing yourself is meaningless (design#115).

NodeContextMenu

fun NodeContextMenu(expanded: Boolean, node: Node, onFavorite: () -> Unit, onMute: () -> Unit, onMessage: () -> Unit, onTraceRoute: () -> Unit, onIgnore: () -> Unit, onRemove: () -> Unit, onDismiss: () -> Unit)

Shared context menu for node actions (favorite, mute, message, trace route, ignore, remove).

NodeCountSummary

fun NodeCountSummary(onlineCount: Int, shownCount: Int, totalCount: Int, modifier: Modifier = Modifier)

Node totals for the Nodes list header: how many nodes are online, how many the current filter shows, and how many are known in total.

NodeCountSummaryDefaultPreview

@Preview(name = "NodeCountSummary - default", widthDp = 360)

fun NodeCountSummaryDefaultPreview()

Default case on a narrow (compact-width) phone.

NodeCountSummaryLargeFontPreview

@Preview(name = "NodeCountSummary - font scale 2x", widthDp = 360, fontScale = 2.0)

fun NodeCountSummaryLargeFontPreview()

Accessibility text size: largest Android font scale.

NodeCountSummaryLongLocaleLargeFontPreview

@Preview(name = "NodeCountSummary - long locale font scale 2x", widthDp = 320, fontScale = 2.0)

fun NodeCountSummaryLongLocaleLargeFontPreview()

Worst case: verbose locale AND largest font scale on a narrow phone.

NodeCountSummaryLongLocalePreview

@Preview(name = "NodeCountSummary - long locale", widthDp = 320)

fun NodeCountSummaryLongLocalePreview()

Long/translated text: verbose locale on a narrow phone.

NodeCountSummaryNarrowPreview

@Preview(name = "NodeCountSummary - narrow 320dp", widthDp = 320)

fun NodeCountSummaryNarrowPreview()

Narrowest realistic phone width — labels must reflow, never ellipsize.

NodeCountSummaryWidePreview

@Preview(name = "NodeCountSummary - wide 840dp", widthDp = 840)

fun NodeCountSummaryWidePreview()

Wide/tablet layout — the labels stay on one line and the block does not stretch awkwardly.

NodeDetailsSection

fun NodeDetailsSection(node: Node, modifier: Modifier = Modifier, deviceHardware: DeviceHardware? = null, reportedTarget: String? = null, isLocal: Boolean = false, onRequestUserInfo: () -> Unit? = null)

NodeDetailsSectionPreview

fun NodeDetailsSectionPreview()

NodeDetailsSectionSignedPreview

fun NodeDetailsSectionSignedPreview()

NodeDetailsSectionWithMakerDeviceHeroPreview

fun NodeDetailsSectionWithMakerDeviceHeroPreview()

NodeFilterSearchBar

fun NodeFilterSearchBar(filterText: String, onTextChange: (String) -> Unit, currentSortOption: NodeSortOption, onSortSelect: (NodeSortOption) -> Unit, toggles: NodeFilterToggles, modifier: Modifier = Modifier, searchResults: @Composable ColumnScope.() -> Unit = {})

The node list's search field: a Material 3 MeshtasticSearchBar whose expanded surface shows the matching nodes, with the sort and filter menu as its trailing action.

NodeFilterSearchBarEmptyPreview

fun NodeFilterSearchBarEmptyPreview()

NodeFilterSearchBarWithQueryPreview

fun NodeFilterSearchBarWithQueryPreview()

NodeHopHistogramSheet

fun NodeHopHistogramSheet(nodes: List<Node>, onDismiss: () -> Unit)

Bottom sheet showing how many mesh nodes sit at each hop distance, filtered to a "last heard" HopWindow. Gives a quick sense of how busy and dispersed the local mesh is (see issue #5745).

fun NodeIdInfo(id: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

NodeItemCompactActivePreview

fun NodeItemCompactActivePreview()

NodeItemCompactAllFieldsPreview

fun NodeItemCompactAllFieldsPreview()

NodeItemCompactMinimalPreview

fun NodeItemCompactMinimalPreview()

NodeItemCompactOnlineRemotePreview

fun NodeItemCompactOnlineRemotePreview()

NodeItemCompactUnheardPreview

fun NodeItemCompactUnheardPreview()

NodeItemCompactUnknownPreview

fun NodeItemCompactUnknownPreview()

NodeItemCompleteActivePreview

fun NodeItemCompleteActivePreview()

NodeItemCompleteOnlineRemotePreview

fun NodeItemCompleteOnlineRemotePreview()

NodeItemCompletePreview

fun NodeItemCompletePreview()

NodeItemSignedPreview

fun NodeItemSignedPreview()

NodeItemUnheardPreview

fun NodeItemUnheardPreview()

NodeItemUnknownPreview

fun NodeItemUnknownPreview()

fun NodeListHelp(onDismiss: () -> Unit)

fun NotesSection(node: Node, onSaveNotes: (Int, String) -> Unit, modifier: Modifier = Modifier)

fun PaxcountInfo(pax: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

PositionInlineContentPreview

fun PositionInlineContentPreview()

fun PowerInfo(value: String, modifier: Modifier = Modifier, label: String? = null, contentColor: Color = MaterialTheme.colorScheme.onSurface)

PowerMetricsNoCurrentPreview

fun PowerMetricsNoCurrentPreview()

PowerMetricsPartialPreview

fun PowerMetricsPartialPreview()

PowerMetricsPreview

fun PowerMetricsPreview()

fun RoleInfo(role: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

SoilMoistureInfo

fun SoilMoistureInfo(moisture: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

SoilTemperatureInfo

fun SoilTemperatureInfo(temp: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

SoilWaterMetricsPreview

fun SoilWaterMetricsPreview()

TelemetricActionsSectionEmptyPreview

fun TelemetricActionsSectionEmptyPreview()

TelemetricActionsSectionLocalPreview

fun TelemetricActionsSectionLocalPreview()

TelemetricActionsSectionPreview

fun TelemetricActionsSectionPreview()

TemperatureInfo

fun TemperatureInfo(temp: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)