Apply when adding or modifying Flutter accessibility (a11y) in a design system or reusable component library — Semantics widget properties, MergeSemantics, ExcludeSemantics, SemanticsRole, focus management, screen reader announcements (one-shot vs live regions), and accessibility testing (meetsGuideline, tester.semantics.find, custom widget semantics). Use whenever building a new component, exposing a11y parameters (tooltip / autofocus / semanticLabel) on a public API, or wiring Semantics inside a reusable widget. Also applies to debugging "TalkBack focus / announcement / role is wrong" issues by dumping the semantics tree.
2026-07-06