@nxgt/material 3.99.0 → 3.100.0

package/docs/components/feedback-and-status.md

@@ -1184,6 +1184,29 @@ toasts.success({
 });
 ```
 
+**Toasts that belong to a page.** `useScopedToasts()` returns the same API as
+`toasts`, and dismisses every toast it showed when the component unmounts, so a
+toast with an « Undo » action never outlives the page that can undo. `dismiss(id)`
+forgets the id; `dismiss()` without an id takes down only this scope's toasts.
+The returned object is stable, safe in a dependency array.
+
+```tsx
+import { Button, useScopedToasts } from '@nxgt/material/components';
+
+function Archive({ undo }: { undo: () => void }) {
+  const toasts = useScopedToasts();
+  return (
+    <Button
+      onClick={() =>
+        toasts.success({ title: 'Archived', action: { label: 'Undo', onClick: undo } })
+      }
+    >
+      Archive
+    </Button>
+  );
+}
+```
+
 **An action keeps the toast open.** `toast()` itself does it, so a preset and a
 direct call behave alike: any toast with an `action` is persistent by default
 (`options.duration: Infinity`, WCAG 2.2.1: a timed toast can vanish before a

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nxgt/material",
-	"version": "3.99.0",
+	"version": "3.100.0",
 	"license": "MIT",
 	"bugs": {
 		"email": "stevegires@gmail.com"