Components
Cabin component inventory and taxonomy for AAOS cabin HMI. Every component is specified for Compose and Views, shares tokens, and declares compliance hooks.
Taxonomy
| Tier | Meaning | Examples |
|---|---|---|
| Primitive | Low-level building blocks | Button, IconButton, Chip, ListItem, Banner |
| Chrome | System-level frames | System bars, status bars |
| Layout | Automotive size classes and scaffolds | Adaptive scaffold, insets |
| Domain | Cabin feature surfaces | Media, EV, HVAC, vehicle controls |
| Pattern | Multi-component flows | Restricted browse, fault recovery |
| Gauges | Cluster / HUD (separate module) | Radial gauge, speedometer |
Coverage for the Experimental kit (generated scaffolds + handwritten Alpha
chrome) lives in coverage.generated.md. Inventory
source: components/cabin.components.yaml.
Primitives and domain widgets that are not the four handwritten specs are
Experimental scaffolds (@CabinScaffold): they render, expose Activate,
and honor the Restriction Engine. They are not production-complete.
Classification (safety)
Each component documents one of:
- Informational — glance status
- Convenience — comfort / media / settings
- Safety-critical — see safety-critical
Inventory map
| Area | Doc | Priority for early phases |
|---|---|---|
| System bars | system-bars.md · MVP spec | MVP (Views-first) |
| Status bars | status-bars.md · MVP spec | MVP (Views-first) |
| ClimateTile | hvac.md · spec | Layer 2 (Alpha Views / Experimental Compose) |
| MediaNowPlaying | media.md · spec | Layer 2 (Alpha Views / Experimental Compose) |
| EV / energy | ev.md | Later (EvEnergyGlance planned) |
| HVAC (full pack) | hvac.md | After ClimateTile |
| Vehicle controls | vehicle-controls.md | Later (VehicleQuickControls planned) |
| OEM extensions | extension-model.md | Continuous |
| Kit coverage (generated) | coverage.generated.md | Experimental scaffold |
Dual-stack contract template
Every component page includes (or will include at implementation):
- Purpose and placement in the cabin
- States / signals
- Compliance (driving, UX, a11y, safety class)
- Token dependencies
- Planned Compose API
- Planned Views API
- Acceptance criteria / parity notes
Planned module ownership
| Component family | Primary modules |
|---|---|
| Chrome (system/status) | cabin-views first; Compose mirrors for apps |
| Build-tree subset (dock, list, button, switch, slider, dialog, prefs, QS) | cabin-views + Compose |
| App kit (full inventory) | cabin-compose Experimental scaffolds |
| Cluster / HUD | cabin-gauges (never SystemUI) |
| Shared state / size classes | cabin-foundation |