RecoveryCard
A reusable recovery card: a message box plus one full-width corrective 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
whether this reads as an error or as an offer; see RecoveryTone.
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.