From ea00033f3429ce867d97d5b6499cdd4156640a7c Mon Sep 17 00:00:00 2001
From: Robert Snow <rsnow@adobe.com>
Date: Thu, 25 Sep 2025 06:51:58 +1000
Subject: [PATCH 1/2] chore: add docs for actionbutton pending (#8912)

---
 packages/dev/s2-docs/pages/s2/ActionBar.mdx   |  2 +-
 .../dev/s2-docs/pages/s2/ActionButton.mdx     | 32 ++++++++++++++++++-
 2 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/packages/dev/s2-docs/pages/s2/ActionBar.mdx b/packages/dev/s2-docs/pages/s2/ActionBar.mdx
index 2a17d877d85..55d85b65022 100644
--- a/packages/dev/s2-docs/pages/s2/ActionBar.mdx
+++ b/packages/dev/s2-docs/pages/s2/ActionBar.mdx
@@ -25,7 +25,7 @@ let rows = [
 
 function Example(props) {
   return (
-    <TableView 
+    <TableView
       aria-label="Table with action bar"
       selectionMode="multiple"
       defaultSelectedKeys={[2]}
diff --git a/packages/dev/s2-docs/pages/s2/ActionButton.mdx b/packages/dev/s2-docs/pages/s2/ActionButton.mdx
index cb6183c3b9b..f00f600b345 100644
--- a/packages/dev/s2-docs/pages/s2/ActionButton.mdx
+++ b/packages/dev/s2-docs/pages/s2/ActionButton.mdx
@@ -11,7 +11,7 @@ import docs from 'docs:@react-spectrum/s2';
 <VisualExample
   component={ActionButton}
   docs={docs.exports.ActionButton}
-  props={['children', 'size', 'staticColor', 'isQuiet', 'isDisabled']}
+  props={['children', 'size', 'staticColor', 'isQuiet', 'isDisabled', 'isPending']}
   initialProps={{children: 'Action'}}
   slots={{icon: true, avatar: true, badge: true}}
   importSource="@react-spectrum/s2"
@@ -39,6 +39,36 @@ function Example() {
 }
 ```
 
+## Pending
+
+Use the `isPending` prop to display a pending state. Pending buttons remain focusable, but are otherwise disabled. After a 1 second delay, an indeterminate spinner will be displayed in place of the button label and icon.
+
+```tsx render
+"use client";
+import {ActionButton} from '@react-spectrum/s2';
+import {useState} from 'react';
+
+function PendingButton() {
+  let [isPending, setPending] = useState(false);
+
+  return (
+    <ActionButton
+      variant="primary"
+      ///- begin highlight -///
+      isPending={isPending}
+      ///- end highlight -///
+      onPress={() => {
+        setPending(true);
+        setTimeout(() => {
+          setPending(false);
+        }, 5000);
+      }}>
+      Save
+    </ActionButton>
+  );
+}
+```
+
 ## API
 
 ```tsx links={{ActionButton: '#actionbutton', Avatar: 'Avatar.html'}}

From b1877715342e30154596362588781ecf075529f2 Mon Sep 17 00:00:00 2001
From: Reid Barber <reid@reidbarber.com>
Date: Wed, 24 Sep 2025 17:19:30 -0500
Subject: [PATCH 2/2] docs: clarify toast close button placement (#8923)

---
 packages/react-aria-components/docs/Toast.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/react-aria-components/docs/Toast.mdx b/packages/react-aria-components/docs/Toast.mdx
index 605fde5f6a9..5da7451da69 100644
--- a/packages/react-aria-components/docs/Toast.mdx
+++ b/packages/react-aria-components/docs/Toast.mdx
@@ -184,7 +184,7 @@ There is no built in way to display toast notifications in HTML. `<ToastRegion>`
 
 <Anatomy role="img" aria-label="Toast anatomy diagram, showing the toast's title and close button within the toast region." />
 
-A `<ToastRegion>` is an [ARIA landmark region](https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/) labeled "Notifications" by default. A `<ToastRegion>` accepts a function to render one or more visible toasts, in chronological order. When the limit is reached, additional toasts are queued until the user dismisses one. Each `<Toast>` is a non-modal ARIA [alertdialog](https://www.w3.org/WAI/ARIA/apg/patterns/alertdialog/), containing the content of the notification and a close button.
+A `<ToastRegion>` is an [ARIA landmark region](https://www.w3.org/WAI/ARIA/apg/practices/landmark-regions/) labeled "Notifications" by default. A `<ToastRegion>` accepts a function to render one or more visible toasts, in chronological order. When the limit is reached, additional toasts are queued until the user dismisses one. Each `<Toast>` is a non-modal ARIA [alertdialog](https://www.w3.org/WAI/ARIA/apg/patterns/alertdialog/), containing the content of the notification and a close button. The toast's content gets announced by screen readers when the toast appears, so it is recommended to render the close button as a sibling of `<ToastContent>` instead of inside it, but this is not a requirement.
 
 Landmark regions including the toast container can be navigated using the keyboard by pressing the <Keyboard>F6</Keyboard> key to move forward, and the <Keyboard>Shift</Keyboard> + <Keyboard>F6</Keyboard> key to move backward. This provides an easy way for keyboard users to jump to the toasts from anywhere in the app. When the last toast is closed, keyboard focus is restored.