core-ui/org.meshtastic.core.ui.component/PmAqiSeverity

PmAqiSeverity

enum PmAqiSeverity : Enum<PmAqiSeverity> (source)

EPA AQI severity categories for PM2.5-derived AQI (0-500), per meshtastic/design#54. Mirrors Co2Severity's ppm→severity pattern, keyed on AQI value instead.

The category name is a string resource (not a hardcoded literal like Co2Severity's) because it is rendered next to the AQI value everywhere the category is shown — the category must never be conveyed by color alone.

Entries

EPA ends the scale at 500; the range saturates instead of stopping there so an out-of-scale value still reads as the worst category rather than losing its label. aqiFromPm25 already clamps to 500, so this is defensive only.

Types

Companion

object Companion

Properties

entries

val entries: EnumEntries<PmAqiSeverity>

Returns a representation of an immutable list of all enum entries, in the order they're declared.

labelRes

@Stable

val labelRes: StringResource

name

expect val name: String

ordinal

expect val ordinal: Int

range

val range: IntRange

tones

@Stable

val tones: AqiSeverityColors.Tones

Functions

color

@Composable

fun color(): Color

The category color for the applied theme. Resolved from the surface actually in use rather than isSystemInDarkTheme(), so a user who forces light while the system is dark (or vice versa — AppTheme takes an explicit darkTheme) still gets the tone that was contrast-checked against the surface they are looking at.

colorFor

fun colorFor(darkTheme: Boolean): Color

The category color for darkTheme, legible as body text on surface and surfaceVariant in both.

valueOf

fun valueOf(value: String): PmAqiSeverity

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

values

fun values(): Array<PmAqiSeverity>

Returns an array containing the constants of this enum type, in the order they're declared.