Async Region
Async Region base prototype
base-async-region-root is a narrow async accessibility primitive that projects governed aria-busy state and exposes the busy handle.
It owns a single busy prop (default false) that projects aria-busy and is exposed as the sole state handle:
busy=false(default) projectsaria-busy=falsebusy=trueprojectsaria-busy=true
Authored descendants and focus are preserved on prop-only transitions. The prototype declares no role, accessible name, loading timers, replacement state machine, announcements, action, event, command, or chat semantics.
For an inbox refresh, keep the draft input and Retry button inside the same Async Region and update its busy prop. Busy does not disable those controls or make the region inert. The application owns any separate decision to disable an action. Compose a Live Region for the authored update message, and clear busy when the application has finished updating that content; Async Region adds no announcement queue or delivery timer.
Current v0 Boundary
Section titled “Current v0 Boundary”base-async-region-root currently includes:
- governed aria-busy projection from the busy prop
- busy state handle exposed via
getExposes().busy - mounted prop transitions that update aria-busy and the expose handle synchronously
- authored descendant and focus preservation across prop transitions
It does not include:
- role or accessible-name projection
- loading timers or replacement state machines
- announcement behavior (compose with Live Region at the application layer)
- action, event, command, or chat semantics
Native consumer evidence
Section titled “Native consumer evidence”The authored native consumer suite checks keyboard editing, text selection, Retry activation, and retained input and Live Region payload identity through busy changes and prop removal. Its default scope is the existing Base, Shadcn, and Brutalist Web Component projections. Bootstrap and Liquid Glass are optional 0.4/WIP source samples, enabled separately; their inclusion does not establish stable family support.
Execution of this new suite remains pending. When run, it retains the actual browser fixture, bundle, observations, and screenshots so the same consumer can be used for a supported-host screen-reader session. ARIA projection and native keyboard observations do not measure spoken delivery. Actual assistive-technology behavior, other Adapters, non-Web hosts, and family visual acceptance remain separate evidence requirements. The related prototype definitions remain draft.
References
Section titled “References”- Contract: C-ASYNC-A11Y-0001
- Source: packages/prototypes/base/src/async-region
- Test: async-region.test.ts
Async Region is workspace source. There is no public proto-ui add target.
| Prop | Type | Default |
|---|---|---|
busy | boolean | false |
These props belong to Root.