Skip to content

feat: add AriaStatus and AriaAlert to stable entrypoint - #8300

Open
joshblack wants to merge 6 commits into
mainfrom
feat/add-aria-announce-helpers-to-stable
Open

feat: add AriaStatus and AriaAlert to stable entrypoint#8300
joshblack wants to merge 6 commits into
mainfrom
feat/add-aria-announce-helpers-to-stable

Conversation

@joshblack

@joshblack joshblack commented Aug 12, 2026

Copy link
Copy Markdown
Member

Closes https://github.com/github/primer/issues/6971

Promote AriaStatus and AriaAlert to stable in @primer/react. This stabilizes these components so we should pay attention to the API to see if we need to make any changes 👀

Some things that came to mind include:

  • Should delayMs debounce automatically?
  • Should we offer support for a static "message" prop so that we don't have to set up the mutation observer for reading the content from the element

Changelog

New

Changed

  • Both AriaStatus and AriaAlert are now available directly from @primer/react

Removed

Rollout strategy

  • Minor release

@changeset-bot

changeset-bot Bot commented Aug 12, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: ec481d0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@primer/react Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@github-actions github-actions Bot added the staff Author is a staff member label Aug 12, 2026
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Action required

👋 Hi, this pull request contains changes to the source code that github/github-ui depends on. If you are GitHub staff, test these changes with github/github-ui using the integration workflow. Check the integration testing docs for step-by-step instructions. Or, apply the integration-tests: skipped manually label to skip these checks.

@github-actions github-actions Bot added the integration-tests: recommended This change needs to be tested for breaking changes. See https://arc.net/l/quote/tdmpakpm label Aug 12, 2026
@github-actions
github-actions Bot requested a deployment to storybook-preview-8300 August 12, 2026 17:13 Abandoned
@github-actions
github-actions Bot temporarily deployed to storybook-preview-8300 August 12, 2026 17:23 Inactive
@joshblack joshblack added the integration-tests: skipped manually Changes in this PR do not require an integration test label Aug 24, 2026
@joshblack
joshblack marked this pull request as ready for review August 24, 2026 15:51
Copilot AI lite review requested due to automatic review settings August 24, 2026 15:51
@joshblack
joshblack requested a review from a team as a code owner August 24, 2026 15:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR promotes the AriaStatus and AriaAlert live-region components from the experimental surface to the stable @primer/react entrypoint, updating Storybook organization and adding docs metadata plus a release changeset.

Changes:

  • Re-export AriaStatus/AriaAlert (and their props types) from packages/react/src/index.ts, and update the exports snapshot accordingly.
  • Move Storybook titles for both components from Experimental/Components/* to Components/* (including Features).
  • Add docs metadata (*.docs.json) for both components and a changeset for a minor release.
Show a summary per file
File Description
packages/react/src/live-region/AriaStatus.stories.tsx Moves AriaStatus story into the stable “Components/*” namespace.
packages/react/src/live-region/AriaStatus.features.stories.tsx Moves AriaStatus feature stories into the stable “Components/*/Features” namespace.
packages/react/src/live-region/AriaStatus.docs.json Adds docs metadata for AriaStatus under the stable import path.
packages/react/src/live-region/AriaAlert.stories.tsx Moves AriaAlert story into the stable “Components/*” namespace.
packages/react/src/live-region/AriaAlert.features.stories.tsx Moves AriaAlert feature stories into the stable “Components/*/Features” namespace.
packages/react/src/live-region/AriaAlert.docs.json Adds docs metadata for AriaAlert under the stable import path.
packages/react/src/index.ts Adds stable exports for AriaStatus/AriaAlert and their prop types.
packages/react/src/tests/snapshots/exports.test.ts.snap Updates export snapshot to include the newly stable exports.
.changeset/grumpy-actors-see.md Adds a minor-release changeset for the new stable exports.

Review details

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 9/9 changed files
  • Comments generated: 3
  • Review effort level: Lite

Comment thread packages/react/src/live-region/AriaAlert.docs.json Outdated
Comment on lines +4 to +5
export {AriaStatus, AriaAlert} from './live-region'
export type {AriaStatusProps, AriaAlertProps} from './live-region'

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in ec481d0AriaAlertProps<As extends ElementType = 'div'> now matches AriaStatusProps.

Comment thread .changeset/grumpy-actors-see.md
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: joshblack <3901764+joshblack@users.noreply.github.com>
@primer

primer Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

🤖 Lint issues have been automatically fixed and committed to this PR.

@github-actions
github-actions Bot requested a deployment to storybook-preview-8300 August 25, 2026 16:19 Abandoned
@joshblack
joshblack enabled auto-merge August 25, 2026 20:20
@github-actions
github-actions Bot requested a deployment to storybook-preview-8300 August 25, 2026 20:30 Abandoned
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

integration-tests: recommended This change needs to be tested for breaking changes. See https://arc.net/l/quote/tdmpakpm integration-tests: skipped manually Changes in this PR do not require an integration test staff Author is a staff member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants