Accessibility
Each component page has Keyboard and Accessibility sections, and quotes the accessibility section of its spec. The rules all components share:
- Real semantics. Buttons are buttons; switches are
role=switch; menus arerole=menu; selects follow the combobox and listbox pattern; trees arerole=tree. - Names that say the state. “Stop generating”, “Running cargo test, 12 seconds”, “Coder, thinking”.
- Calm announcements. State changes go through polite live regions with throttling; only failures and approvals that block the user are assertive. Streamed tokens are never announced one by one.
- Not colour alone. Status and risk always carry text or shape too.
- Focus is never lost. Loading buttons keep focus; disabled controls with a reason stay focusable and explain why.
- Reduced motion is honoured everywhere (see Motion).