Controls — ControlWidget

The interactive tiles a user can place in Control Center, on the Lock Screen, and assign to the Action Button (iOS 18+). A Control is a ControlWidget living in your widget extension, built on WidgetKit + App Intents. The deep API reference — both configuration kinds, button vs. toggle, the value provider, the backing intents, refreshing, extension setup, and pitfalls — lives in references/guide.md. This file is the decision and discipline layer: read it first, open the guide for specifics.

Dials

Set these explicitly at the start; they change what "correct" means.