Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

spec(AST-086): FR13 announces content revealed outside React on the owner's next render (#8325)

Cindy Zhang47c4cbf193c7
diff --git a/docs/specs/AST-086-status-announcements/spec.md b/docs/specs/AST-086-status-announcements/spec.md
index 3f90139264..44385aa21a 100644
--- a/docs/specs/AST-086-status-announcements/spec.md
+++ b/docs/specs/AST-086-status-announcements/spec.md
@@ -7,7 +7,7 @@ authority: current
archive_reason: null
superseded_by: null
approved_by: cixzhang
-approved_at: 2026-10-23
+approved_at: 2026-10-24
phase: accepted
owners: [cixzhang]
affects_architecture: [architecture:react-component-runtime]
@@ -122,7 +122,8 @@ announcement channel.
rendered text, or its accessible name when it renders no text, leaving out
`aria-hidden` content. It stays silent for text present during page load
(except as FR11 provides for announcement-only messages), announces once per later appearance or text change, and re-arms when
- the element is hidden. During a server render it announces nothing and adds no
+ the element is hidden. An appearance its owner does not re-render for is
+ announced on the owner's next render (FR13). During a server render it announces nothing and adds no
live role, and a server-renderable adopter stays server-renderable and passes
the server-safe component boundary check. Any mechanism that satisfies this is
valid; `architecture:react-component-runtime` INV10 places it.
@@ -131,8 +132,12 @@ announcement channel.
rerender, dependency change, and StrictMode replay, does no work while the
element is hidden, and leaves nothing behind after unmount. Action
announcements, such as a result count from a query handler or FR8 busy
- starts, keep their own owner. `architecture:react-component-runtime` INV10
- owns where this work lives.
+ starts, keep their own owner. Content revealed without a re-render of its
+ owner, such as when an ancestor's `hidden` attribute is removed outside
+ React, is announced on the owner's next render, and nothing watches for the
+ reveal while the content is hidden (`architecture:react-component-runtime`
+ INV5, INV10). `architecture:react-component-runtime` INV10 owns where this
+ work lives.
- **FR14 — Owners inside an open modal deliver inside it.** While the
shared channel is not exposed inside native modals (Platform support), a
message its owner would otherwise send through the shared channel — an FR2
@@ -307,7 +312,7 @@ announcement channel.
| FR14 | Hook tests and an accessibility-tree check with an Astryx modal open | Owner outside any modal, inside an open non-modal dialog, inside an open modal (polite and assertive, repeat of the same words, empty message), busy start inside a modal, busy start inside a native modal an app renders without Astryx, alone and opened inside an Astryx Dialog; a modal sheet's row toggle in a real engine, app code calling `useAnnounce` inside a Dialog, CommandPalette result count and Lightbox position message while each is open, a message followed by closing its Dialog before it is exposed (inside another open modal and on the page), a message pending when a CommandPalette opened over a Dialog closes, app code calling `useAnnounce` outside the Dialog it renders (body-level channel) | A channel message from inside an open modal that reaches only the body-level channel, an FR14 container mounted holding its text, a second FR14 container of one urgency in one dialog, an FR14 container the engine's accessibility tree omits, a dropped message of two written before the first is exposed, an empty message that leaves text in the modal's FR14 container, an app `useAnnounce` message from inside an Astryx modal that reaches only the body-level channel, a CommandPalette or Lightbox message about its open modal that reaches only the body-level channel, a message lost when its modal closes before it is exposed, or a pending message handed to a channel still inert after the close, a busy start inside an app-rendered native modal that reaches only the body-level channel, or one inside an app-rendered native modal nested in an Astryx Dialog that is delivered to the Dialog's FR14 container fails |
| FR11, FR12 | Helper and component tests | EmptyState present at page load, server-rendered, inserted later, text changed, hidden and shown again, brought in by a client-rendered route change, inside a chat log, empty Selector panel open at page load, server-rendered message inserted by client navigation, message inserted after first render but before the document finishes loading (silent) | Announcing at page load or during a server render (other than an announcement-only message), missing a later insertion or a server-rendered message inserted by client navigation, a client-rendered route change, or an empty Selector panel at page load, repeating one occasion, or also using the channel inside a live container fails |
| FR12 (server) | Server-safe component boundary check plus a server render of each adopter | EmptyState rendered on the server and hydrated | An adopter that fails the boundary check, or emits an announcement or live role from a server render, fails |
-| FR13 | Helper StrictMode, hide/show, and unmount tests on each adopter | EmptyState, Spinner, ChatComposer status bar, ChatTypingIndicator | A duplicate announcement under StrictMode, work while hidden, or a resource left after unmount fails |
+| FR13 | Helper StrictMode, hide/show, and unmount tests on each adopter | EmptyState, Spinner, ChatComposer status bar, ChatTypingIndicator; an ancestor's `hidden` attribute removed outside React | A duplicate announcement under StrictMode, work while hidden, or a resource left after unmount fails; revealed content not announced on the owner's next render, or an observer, listener, or timer running while the content is hidden, fails |
| FR6 (AT) | Recommended `spec:AST-009` real-AT follow-up | Toast, busy Switch, chat notice | Missing, repeated, or out-of-order speech fails |
## Decision log