RecoveryCard
A reusable error-state card: an errorContainer message box plus one full-width recovery action. Generalizes the compass warning/recovery pattern so any feature can present context plus a single corrective action (request a permission, open Bluetooth/Wi-Fi/app settings, etc.).
Parameters
the user-facing explanation of what is wrong.
the recovery button label.
invoked when the recovery button is tapped.
optional leading icon for the recovery button.
optional dismiss handler; when non-null a trailing close (×) button is shown so the user can retire a card that can't otherwise be cleared (e.g. a firmware recovery that persistently fails on an unflashable bootloader). Omit for cards that must not be dismissable, such as missing-permission prompts.
accessibility label for the dismiss button.