# LiveRegion

Visually hidden ARIA live region for consumer-controlled announcements.

Use LiveRegion for one consumer-controlled status announcement. Announce state transitions or completed chunks, not each streamed token or a duplicate nested status.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `atomic` | `boolean` | prop | No | `true` | Announces the complete region when the message changes. |
| `message` | `string` | prop | No | `''` | Text that assistive technology announces. |
| `politeness` | `LiveRegionPoliteness` | prop | No | `'polite'` | Controls when assistive technology interrupts its current output. |

## Related

- [Badge](/docs/components/badge): Compact semantic or categorical label.
- [StatusDot](/docs/components/status-dot): Semantic status dot with an optional label and pulse.
- [EmptyState](/docs/components/empty-state): Empty-state message with optional art and action.