Skip to main content

HVAC components

Climate control UI for multi-zone cabins: temperature, fan, modes, seat heat / vent, and visibility-critical actions (defrost).

Purpose​

  • Fast, low-distraction adjustment of climate.
  • Clear zone ownership (driver / passenger / rear).
  • Keep defrost and visibility actions available and obvious.

Component set​

ComponentRoleSafety classStatus
ClimateTileZone temp / fan / seat heatConvenienceAlpha Views · Experimental Compose — spec
HvacZonePanelTemp + fan for a zoneConveniencePlanned
HvacTempStepperLarge ± temperatureConveniencePlanned (folded into ClimateTile for now)
HvacFanControlFan level / autoConveniencePlanned (folded into ClimateTile for now)
HvacModeSelectorFace / foot / bi-level / etc.ConveniencePlanned
HvacSeatClimateHeat / vent levelsConveniencePlanned (folded into ClimateTile for now)
HvacDefrostControlsFront/rear defrostSafety-critical (visibility)Planned
HvacSyncToggleSync zonesConveniencePlanned
HvacPeekSystem bar shortcutConvenienceAlpha (System Bar slot)

States​

  • Auto vs manual
  • Sync on/off
  • Seat climate levels
  • Defrost active
  • HVAC power off (still show how to power on with large target)
  • Signal unavailable per zone

Compliance​

ConcernRule
DrivingHvacAdjust on ClimateTile is Block while Moving / Restricted / Unknown (fail-closed). System bar HvacPeek stays limited Allow (restriction-states)
UXLarge steppers; generous spacing (ux)
SafetyDefrost always reachable; not behind setup (safety)
GlanceNumeric temp tabular; zone labels short

Token dependencies​

  • cabin.color.semantic.climate
  • cabin.component.climateTile.*
  • Touch minima tokens

Compose API (Experimental — ClimateTile)​

@Composable
fun CabinClimateTile(
state: CabinClimateTileState,
onAction: (CabinClimateTileAction) -> Unit,
modifier: Modifier = Modifier,
)

Views API (Alpha — ClimateTile)​

class CabinClimateTileView : /* … */ {
fun bind(state: CabinClimateTileState)
fun setOnActionListener(listener: ((CabinClimateTileAction) -> Unit)?)
fun setCompliance(host: CabinComplianceHost?)
}

Planned (later)​

// Planned
@Composable
fun HvacZonePanel(
zone: HvacZoneUiState,
onChange: (HvacZoneAction) -> Unit,
modifier: Modifier = Modifier,
)

@Composable
fun HvacDefrostControls(
state: DefrostUiState,
onChange: (DefrostAction) -> Unit,
modifier: Modifier = Modifier,
)

Parity notes​

Zone models and ClimateTile Signal honesty must match across stacks. Animation of temp changes should respect driving motion budgets on both stacks.

Acceptance criteria​

  • ClimateTile dual-stack with RE fail-closed while Moving
  • Unavailable zone signals handled (no invented values)
  • Defrost classified and always available (later)
  • Sync behavior documented (later)
  • Compose/Views parity for temp/fan/seat heat