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.mdindex 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: currentarchive_reason: nullsuperseded_by: nullapproved_by: cixzhang-approved_at: 2026-10-23+approved_at: 2026-10-24phase: acceptedowners: [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 nolive role, and a server-renderable adopter stays server-renderable and passesthe server-safe component boundary check. Any mechanism that satisfies this isvalid; `architecture:react-component-runtime` INV10 places it.@@ -131,8 +132,12 @@ announcement channel.rerender, dependency change, and StrictMode replay, does no work while theelement is hidden, and leaves nothing behind after unmount. Actionannouncements, 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 theshared channel is not exposed inside native modals (Platform support), amessage 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