@cube-dev/ui-kit 0.117.0 → 0.118.0

package/dist/components/overlays/Notifications/NotificationCard.d.ts

@@ -24,13 +24,15 @@ interface NotificationCardProps {
    * nothing, but actions with `closeOnPress` (default) can still close
    * the notification.
    */
-  isDismissible?: boolean;
+  isDismissable?: boolean;
   /** When false the card drops its shadow (e.g. inside a list). Default: true. */
   elevated?: boolean;
   /** Notification id */
   notificationId?: Key;
   /** Called when the notification is dismissed */
   onDismiss?: (id: Key, reason: DismissReason) => void;
+  /** Called when a dismissed notification should be restored (async action returned false) */
+  onRestore?: (id: Key) => void;
   /** Suffix content (e.g. timestamp) */
   suffix?: ReactNode;
 }
@@ -45,10 +47,11 @@ declare function NotificationCard({
   description,
   icon: providedIcon,
   actions,
-  isDismissible,
+  isDismissable,
   elevated,
   notificationId,
   onDismiss,
+  onRestore,
   suffix
 }: NotificationCardProps): react_jsx_runtime0.JSX.Element;
 //#endregion

package/dist/components/overlays/Notifications/NotificationCard.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { tasty } from "../../../tasty/tasty.js";
 import { Block } from "../../Block.js";
 import { ItemActionProvider } from "../../actions/ItemActionContext.js";
@@ -56,10 +56,10 @@ function AutoDismissButton() {
 *
 * The dismiss provider is always rendered when `hasDismissContext` is true,
 * so any action with `closeOnPress` can close the notification — regardless
-* of `isDismissible`. The `showAutoDismiss` flag only controls the
+* of `isDismissable`. The `showAutoDismiss` flag only controls the
 * auto-appended "Dismiss" button.
 */
-function ActionsSection({ actions, theme, showAutoDismiss, hasDismissContext, notificationId, onDismiss }) {
+function ActionsSection({ actions, theme, showAutoDismiss, hasDismissContext, notificationId, onDismiss, onRestore }) {
 	const actionsContent = /* @__PURE__ */ jsxs(Space, {
 		placeSelf: "end",
 		placeContent: "end",
@@ -73,6 +73,7 @@ function ActionsSection({ actions, theme, showAutoDismiss, hasDismissContext, no
 		children: hasDismissContext ? /* @__PURE__ */ jsx(NotificationDismissProvider, {
 			notificationId,
 			onDismiss,
+			onRestore,
 			children: wrappedContent
 		}) : wrappedContent
 	});
@@ -81,10 +82,10 @@ function ActionsSection({ actions, theme, showAutoDismiss, hasDismissContext, no
 * Shared presentational card used by both overlay NotificationItem
 * and PersistentNotificationListItem.
 */
-function NotificationCard({ qa = "Notification", theme, title, description, icon: providedIcon, actions, isDismissible = true, elevated = true, notificationId, onDismiss, suffix }) {
+function NotificationCard({ qa = "Notification", theme, title, description, icon: providedIcon, actions, isDismissable = true, elevated = true, notificationId, onDismiss, onRestore, suffix }) {
 	const icon = getThemeIcon(theme, providedIcon);
 	const hasDismissContext = notificationId != null && onDismiss != null;
-	const showAutoDismiss = isDismissible && hasDismissContext;
+	const showAutoDismiss = isDismissable && hasDismissContext;
 	const hasActions = !!(actions || showAutoDismiss);
 	return /* @__PURE__ */ jsx(StyledItem, {
 		qa,
@@ -101,7 +102,8 @@ function NotificationCard({ qa = "Notification", theme, title, description, icon
 				showAutoDismiss,
 				hasDismissContext,
 				notificationId,
-				onDismiss
+				onDismiss,
+				onRestore
 			})]
 		}) : void 0,
 		suffix,

package/dist/components/overlays/Notifications/NotificationCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationCard.js","names":["Item"],"sources":["../../../../src/components/overlays/Notifications/NotificationCard.tsx"],"sourcesContent":["import { Key, ReactNode, useContext, useRef } from 'react';\n\nimport { tasty } from '../../../tasty';\nimport { ItemActionProvider } from '../../actions/ItemActionContext';\nimport { Block } from '../../Block';\nimport { Item } from '../../content/Item/Item';\nimport { Flex } from '../../layout/Flex';\nimport { Space } from '../../layout/Space';\nimport { getThemeIcon } from '../Toast/useToast';\n\nimport {\n  DismissActionDetectedContext,\n  NotificationAction,\n  NotificationDismissProvider,\n} from './NotificationAction';\n\nimport type { DismissReason, NotificationType } from './types';\n\n// ─── Styled Components ──────────────────────────────────────────────\n\nconst StyledItem = tasty(Item, {\n  styles: {\n    width: {\n      '': 'max min((100vw - 4x), 50x)',\n      flat: '100%',\n    },\n    shadow: {\n      '': '$shadow',\n      flat: false,\n    },\n    radius: {\n      '': '1cr',\n      flat: '0',\n    },\n    transition: 'theme, inset',\n\n    Description: {\n      preset: 't4',\n    },\n  },\n});\n\n// ─── Dismiss Action Detection ────────────────────────────────────────\n\n/**\n * Provides a ref via context that NotificationAction children write to\n * during render when `isDismiss` is set. The ref is reset each render.\n */\nfunction DismissActionDetector({ children }: { children: ReactNode }) {\n  const ref = useRef(false);\n\n  // Reset each render so detection is fresh\n  ref.current = false;\n\n  return (\n    <DismissActionDetectedContext.Provider value={ref}>\n      {children}\n    </DismissActionDetectedContext.Provider>\n  );\n}\n\n/**\n * Renders the default \"Dismiss\" button only if no sibling NotificationAction\n * has `isDismiss` set. Reads from DismissActionDetectedContext ref which is\n * populated by actions that rendered before this component (left-to-right order).\n */\nfunction AutoDismissButton() {\n  const dismissDetectedRef = useContext(DismissActionDetectedContext);\n\n  if (dismissDetectedRef?.current) return null;\n\n  return <NotificationAction isDismiss>Dismiss</NotificationAction>;\n}\n\n// ─── ActionsSection ─────────────────────────────────────────────────\n\ninterface ActionsSectionProps {\n  actions?: ReactNode;\n  theme?: NotificationType;\n  /**\n   * Whether to show the auto-appended \"Dismiss\" button.\n   * Controlled by `isDismissible` on the notification.\n   *\n   * When false, no default \"Dismiss\" button is rendered, but actions with\n   * `closeOnPress` (default `true`) can still close the notification via\n   * the dismiss context.\n   */\n  showAutoDismiss: boolean;\n  /** Whether the dismiss context is available (notificationId + onDismiss present) */\n  hasDismissContext: boolean;\n  notificationId?: Key;\n  onDismiss?: (id: Key, reason: DismissReason) => void;\n}\n\n/**\n * Extracted sub-component for the actions area of a notification card.\n *\n * The dismiss provider is always rendered when `hasDismissContext` is true,\n * so any action with `closeOnPress` can close the notification — regardless\n * of `isDismissible`. The `showAutoDismiss` flag only controls the\n * auto-appended \"Dismiss\" button.\n */\nfunction ActionsSection({\n  actions,\n  theme,\n  showAutoDismiss,\n  hasDismissContext,\n  notificationId,\n  onDismiss,\n}: ActionsSectionProps) {\n  const actionsContent = (\n    <Space placeSelf=\"end\" placeContent=\"end\" flexGrow={1}>\n      {actions}\n      {showAutoDismiss && <AutoDismissButton />}\n    </Space>\n  );\n\n  const wrappedContent = showAutoDismiss ? (\n    <DismissActionDetector>{actionsContent}</DismissActionDetector>\n  ) : (\n    actionsContent\n  );\n\n  return (\n    <ItemActionProvider type=\"card\" theme={theme}>\n      {hasDismissContext ? (\n        <NotificationDismissProvider\n          notificationId={notificationId!}\n          onDismiss={onDismiss!}\n        >\n          {wrappedContent}\n        </NotificationDismissProvider>\n      ) : (\n        wrappedContent\n      )}\n    </ItemActionProvider>\n  );\n}\n\n// ─── NotificationCard ────────────────────────────────────────────────\n\nexport interface NotificationCardProps {\n  qa?: string;\n  /** Notification theme */\n  theme?: NotificationType;\n  /** Primary text */\n  title?: ReactNode;\n  /** Secondary text */\n  description?: ReactNode;\n  /** Custom icon override (theme default used if omitted) */\n  icon?: ReactNode;\n  /** Action buttons rendered below description */\n  actions?: ReactNode;\n  /**\n   * Whether the notification shows the default dismiss UI (auto-appended\n   * \"Dismiss\" button and Escape key). Default: true.\n   *\n   * When false, no default \"Dismiss\" button is rendered and Escape does\n   * nothing, but actions with `closeOnPress` (default) can still close\n   * the notification.\n   */\n  isDismissible?: boolean;\n  /** When false the card drops its shadow (e.g. inside a list). Default: true. */\n  elevated?: boolean;\n  /** Notification id */\n  notificationId?: Key;\n  /** Called when the notification is dismissed */\n  onDismiss?: (id: Key, reason: DismissReason) => void;\n  /** Suffix content (e.g. timestamp) */\n  suffix?: ReactNode;\n}\n\n/**\n * Shared presentational card used by both overlay NotificationItem\n * and PersistentNotificationListItem.\n */\nexport function NotificationCard({\n  qa = 'Notification',\n  theme,\n  title,\n  description,\n  icon: providedIcon,\n  actions,\n  isDismissible = true,\n  elevated = true,\n  notificationId,\n  onDismiss,\n  suffix,\n}: NotificationCardProps) {\n  const icon = getThemeIcon(theme, providedIcon);\n\n  const hasDismissContext = notificationId != null && onDismiss != null;\n  const showAutoDismiss = isDismissible && hasDismissContext;\n  const hasActions = !!(actions || showAutoDismiss);\n\n  const descriptionContent: ReactNode =\n    description || hasActions ? (\n      <Flex flow=\"row wrap\" gap=\"0.5x 1x\" placeItems=\"center stretch\">\n        {description && <Block>{description}</Block>}\n        {hasActions && (\n          <ActionsSection\n            actions={actions}\n            theme={theme}\n            showAutoDismiss={showAutoDismiss}\n            hasDismissContext={hasDismissContext}\n            notificationId={notificationId}\n            onDismiss={onDismiss}\n          />\n        )}\n      </Flex>\n    ) : undefined;\n\n  return (\n    <StyledItem\n      qa={qa}\n      type=\"card\"\n      theme={theme}\n      icon={icon}\n      description={descriptionContent}\n      suffix={suffix}\n      mods={{ flat: !elevated }}\n      styles={!elevated ? { border: '0' } : undefined}\n    >\n      {title}\n    </StyledItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,MAAM,aAAa,MAAMA,OAAM,EAC7B,QAAQ;CACN,OAAO;EACL,IAAI;EACJ,MAAM;EACP;CACD,QAAQ;EACN,IAAI;EACJ,MAAM;EACP;CACD,QAAQ;EACN,IAAI;EACJ,MAAM;EACP;CACD,YAAY;CAEZ,aAAa,EACX,QAAQ,MACT;CACF,EACF,CAAC;;;;;AAQF,SAAS,sBAAsB,EAAE,YAAqC;CACpE,MAAM,MAAM,OAAO,MAAM;AAGzB,KAAI,UAAU;AAEd,QACE,oBAAC,6BAA6B;EAAS,OAAO;EAC3C;GACqC;;;;;;;AAS5C,SAAS,oBAAoB;AAG3B,KAF2B,WAAW,6BAA6B,EAE3C,QAAS,QAAO;AAExC,QAAO,oBAAC;EAAmB;YAAU;GAA4B;;;;;;;;;;AA+BnE,SAAS,eAAe,EACtB,SACA,OACA,iBACA,mBACA,gBACA,aACsB;CACtB,MAAM,iBACJ,qBAAC;EAAM,WAAU;EAAM,cAAa;EAAM,UAAU;aACjD,SACA,mBAAmB,oBAAC,sBAAoB;GACnC;CAGV,MAAM,iBAAiB,kBACrB,oBAAC,mCAAuB,iBAAuC,GAE/D;AAGF,QACE,oBAAC;EAAmB,MAAK;EAAc;YACpC,oBACC,oBAAC;GACiB;GACL;aAEV;IAC2B,GAE9B;GAEiB;;;;;;AAyCzB,SAAgB,iBAAiB,EAC/B,KAAK,gBACL,OACA,OACA,aACA,MAAM,cACN,SACA,gBAAgB,MAChB,WAAW,MACX,gBACA,WACA,UACwB;CACxB,MAAM,OAAO,aAAa,OAAO,aAAa;CAE9C,MAAM,oBAAoB,kBAAkB,QAAQ,aAAa;CACjE,MAAM,kBAAkB,iBAAiB;CACzC,MAAM,aAAa,CAAC,EAAE,WAAW;AAmBjC,QACE,oBAAC;EACK;EACJ,MAAK;EACE;EACD;EACN,aAtBF,eAAe,aACb,qBAAC;GAAK,MAAK;GAAW,KAAI;GAAU,YAAW;cAC5C,eAAe,oBAAC,mBAAO,cAAoB,EAC3C,cACC,oBAAC;IACU;IACF;IACU;IACE;IACH;IACL;KACX;IAEC,GACL;EASM;EACR,MAAM,EAAE,MAAM,CAAC,UAAU;EACzB,QAAQ,CAAC,WAAW,EAAE,QAAQ,KAAK,GAAG;YAErC;GACU"}
+{"version":3,"file":"NotificationCard.js","names":["Item"],"sources":["../../../../src/components/overlays/Notifications/NotificationCard.tsx"],"sourcesContent":["import { Key, ReactNode, useContext, useRef } from 'react';\n\nimport { tasty } from '../../../tasty';\nimport { ItemActionProvider } from '../../actions/ItemActionContext';\nimport { Block } from '../../Block';\nimport { Item } from '../../content/Item/Item';\nimport { Flex } from '../../layout/Flex';\nimport { Space } from '../../layout/Space';\nimport { getThemeIcon } from '../Toast/useToast';\n\nimport {\n  DismissActionDetectedContext,\n  NotificationAction,\n  NotificationDismissProvider,\n} from './NotificationAction';\n\nimport type { DismissReason, NotificationType } from './types';\n\n// ─── Styled Components ──────────────────────────────────────────────\n\nconst StyledItem = tasty(Item, {\n  styles: {\n    width: {\n      '': 'max min((100vw - 4x), 50x)',\n      flat: '100%',\n    },\n    shadow: {\n      '': '$shadow',\n      flat: false,\n    },\n    radius: {\n      '': '1cr',\n      flat: '0',\n    },\n    transition: 'theme, inset',\n\n    Description: {\n      preset: 't4',\n    },\n  },\n});\n\n// ─── Dismiss Action Detection ────────────────────────────────────────\n\n/**\n * Provides a ref via context that NotificationAction children write to\n * during render when `isDismiss` is set. The ref is reset each render.\n */\nfunction DismissActionDetector({ children }: { children: ReactNode }) {\n  const ref = useRef(false);\n\n  // Reset each render so detection is fresh\n  ref.current = false;\n\n  return (\n    <DismissActionDetectedContext.Provider value={ref}>\n      {children}\n    </DismissActionDetectedContext.Provider>\n  );\n}\n\n/**\n * Renders the default \"Dismiss\" button only if no sibling NotificationAction\n * has `isDismiss` set. Reads from DismissActionDetectedContext ref which is\n * populated by actions that rendered before this component (left-to-right order).\n */\nfunction AutoDismissButton() {\n  const dismissDetectedRef = useContext(DismissActionDetectedContext);\n\n  if (dismissDetectedRef?.current) return null;\n\n  return <NotificationAction isDismiss>Dismiss</NotificationAction>;\n}\n\n// ─── ActionsSection ─────────────────────────────────────────────────\n\ninterface ActionsSectionProps {\n  actions?: ReactNode;\n  theme?: NotificationType;\n  /**\n   * Whether to show the auto-appended \"Dismiss\" button.\n   * Controlled by `isDismissable` on the notification.\n   *\n   * When false, no default \"Dismiss\" button is rendered, but actions with\n   * `closeOnPress` (default `true`) can still close the notification via\n   * the dismiss context.\n   */\n  showAutoDismiss: boolean;\n  /** Whether the dismiss context is available (notificationId + onDismiss present) */\n  hasDismissContext: boolean;\n  notificationId?: Key;\n  onDismiss?: (id: Key, reason: DismissReason) => void;\n  onRestore?: (id: Key) => void;\n}\n\n/**\n * Extracted sub-component for the actions area of a notification card.\n *\n * The dismiss provider is always rendered when `hasDismissContext` is true,\n * so any action with `closeOnPress` can close the notification — regardless\n * of `isDismissable`. The `showAutoDismiss` flag only controls the\n * auto-appended \"Dismiss\" button.\n */\nfunction ActionsSection({\n  actions,\n  theme,\n  showAutoDismiss,\n  hasDismissContext,\n  notificationId,\n  onDismiss,\n  onRestore,\n}: ActionsSectionProps) {\n  const actionsContent = (\n    <Space placeSelf=\"end\" placeContent=\"end\" flexGrow={1}>\n      {actions}\n      {showAutoDismiss && <AutoDismissButton />}\n    </Space>\n  );\n\n  const wrappedContent = showAutoDismiss ? (\n    <DismissActionDetector>{actionsContent}</DismissActionDetector>\n  ) : (\n    actionsContent\n  );\n\n  return (\n    <ItemActionProvider type=\"card\" theme={theme}>\n      {hasDismissContext ? (\n        <NotificationDismissProvider\n          notificationId={notificationId!}\n          onDismiss={onDismiss!}\n          onRestore={onRestore}\n        >\n          {wrappedContent}\n        </NotificationDismissProvider>\n      ) : (\n        wrappedContent\n      )}\n    </ItemActionProvider>\n  );\n}\n\n// ─── NotificationCard ────────────────────────────────────────────────\n\nexport interface NotificationCardProps {\n  qa?: string;\n  /** Notification theme */\n  theme?: NotificationType;\n  /** Primary text */\n  title?: ReactNode;\n  /** Secondary text */\n  description?: ReactNode;\n  /** Custom icon override (theme default used if omitted) */\n  icon?: ReactNode;\n  /** Action buttons rendered below description */\n  actions?: ReactNode;\n  /**\n   * Whether the notification shows the default dismiss UI (auto-appended\n   * \"Dismiss\" button and Escape key). Default: true.\n   *\n   * When false, no default \"Dismiss\" button is rendered and Escape does\n   * nothing, but actions with `closeOnPress` (default) can still close\n   * the notification.\n   */\n  isDismissable?: boolean;\n  /** When false the card drops its shadow (e.g. inside a list). Default: true. */\n  elevated?: boolean;\n  /** Notification id */\n  notificationId?: Key;\n  /** Called when the notification is dismissed */\n  onDismiss?: (id: Key, reason: DismissReason) => void;\n  /** Called when a dismissed notification should be restored (async action returned false) */\n  onRestore?: (id: Key) => void;\n  /** Suffix content (e.g. timestamp) */\n  suffix?: ReactNode;\n}\n\n/**\n * Shared presentational card used by both overlay NotificationItem\n * and PersistentNotificationListItem.\n */\nexport function NotificationCard({\n  qa = 'Notification',\n  theme,\n  title,\n  description,\n  icon: providedIcon,\n  actions,\n  isDismissable = true,\n  elevated = true,\n  notificationId,\n  onDismiss,\n  onRestore,\n  suffix,\n}: NotificationCardProps) {\n  const icon = getThemeIcon(theme, providedIcon);\n\n  const hasDismissContext = notificationId != null && onDismiss != null;\n  const showAutoDismiss = isDismissable && hasDismissContext;\n  const hasActions = !!(actions || showAutoDismiss);\n\n  const descriptionContent: ReactNode =\n    description || hasActions ? (\n      <Flex flow=\"row wrap\" gap=\"0.5x 1x\" placeItems=\"center stretch\">\n        {description && <Block>{description}</Block>}\n        {hasActions && (\n          <ActionsSection\n            actions={actions}\n            theme={theme}\n            showAutoDismiss={showAutoDismiss}\n            hasDismissContext={hasDismissContext}\n            notificationId={notificationId}\n            onDismiss={onDismiss}\n            onRestore={onRestore}\n          />\n        )}\n      </Flex>\n    ) : undefined;\n\n  return (\n    <StyledItem\n      qa={qa}\n      type=\"card\"\n      theme={theme}\n      icon={icon}\n      description={descriptionContent}\n      suffix={suffix}\n      mods={{ flat: !elevated }}\n      styles={!elevated ? { border: '0' } : undefined}\n    >\n      {title}\n    </StyledItem>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,MAAM,aAAa,MAAMA,OAAM,EAC7B,QAAQ;CACN,OAAO;EACL,IAAI;EACJ,MAAM;EACP;CACD,QAAQ;EACN,IAAI;EACJ,MAAM;EACP;CACD,QAAQ;EACN,IAAI;EACJ,MAAM;EACP;CACD,YAAY;CAEZ,aAAa,EACX,QAAQ,MACT;CACF,EACF,CAAC;;;;;AAQF,SAAS,sBAAsB,EAAE,YAAqC;CACpE,MAAM,MAAM,OAAO,MAAM;AAGzB,KAAI,UAAU;AAEd,QACE,oBAAC,6BAA6B;EAAS,OAAO;EAC3C;GACqC;;;;;;;AAS5C,SAAS,oBAAoB;AAG3B,KAF2B,WAAW,6BAA6B,EAE3C,QAAS,QAAO;AAExC,QAAO,oBAAC;EAAmB;YAAU;GAA4B;;;;;;;;;;AAgCnE,SAAS,eAAe,EACtB,SACA,OACA,iBACA,mBACA,gBACA,WACA,aACsB;CACtB,MAAM,iBACJ,qBAAC;EAAM,WAAU;EAAM,cAAa;EAAM,UAAU;aACjD,SACA,mBAAmB,oBAAC,sBAAoB;GACnC;CAGV,MAAM,iBAAiB,kBACrB,oBAAC,mCAAuB,iBAAuC,GAE/D;AAGF,QACE,oBAAC;EAAmB,MAAK;EAAc;YACpC,oBACC,oBAAC;GACiB;GACL;GACA;aAEV;IAC2B,GAE9B;GAEiB;;;;;;AA2CzB,SAAgB,iBAAiB,EAC/B,KAAK,gBACL,OACA,OACA,aACA,MAAM,cACN,SACA,gBAAgB,MAChB,WAAW,MACX,gBACA,WACA,WACA,UACwB;CACxB,MAAM,OAAO,aAAa,OAAO,aAAa;CAE9C,MAAM,oBAAoB,kBAAkB,QAAQ,aAAa;CACjE,MAAM,kBAAkB,iBAAiB;CACzC,MAAM,aAAa,CAAC,EAAE,WAAW;AAoBjC,QACE,oBAAC;EACK;EACJ,MAAK;EACE;EACD;EACN,aAvBF,eAAe,aACb,qBAAC;GAAK,MAAK;GAAW,KAAI;GAAU,YAAW;cAC5C,eAAe,oBAAC,mBAAO,cAAoB,EAC3C,cACC,oBAAC;IACU;IACF;IACU;IACE;IACH;IACL;IACA;KACX;IAEC,GACL;EASM;EACR,MAAM,EAAE,MAAM,CAAC,UAAU;EACzB,QAAQ,CAAC,WAAW,EAAE,QAAQ,KAAK,GAAG;YAErC;GACU"}

package/dist/components/overlays/Notifications/NotificationContext.d.ts

@@ -1,7 +1,5 @@
 
-import "./types.js";
 import { ToastContextValue } from "../Toast/types.js";
-import "react";
 
 //#region src/components/overlays/Notifications/NotificationContext.d.ts
 declare function useToastContext(): ToastContextValue;

package/dist/components/overlays/Notifications/NotificationContext.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { createContext, useContext } from "react";
 
 //#region src/components/overlays/Notifications/NotificationContext.ts

package/dist/components/overlays/Notifications/NotificationItem.d.ts

@@ -7,10 +7,12 @@ import * as react_jsx_runtime0 from "react/jsx-runtime";
 interface NotificationItemProps {
   notification: InternalNotification;
   onDismiss: (id: Key, reason: DismissReason) => void;
+  onRestore?: (id: Key) => void;
 }
 declare function NotificationItem({
   notification,
-  onDismiss
+  onDismiss,
+  onRestore
 }: NotificationItemProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { NotificationItem, NotificationItemProps };

package/dist/components/overlays/Notifications/NotificationItem.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { tasty } from "../../../tasty/tasty.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { NotificationCard } from "./NotificationCard.js";
@@ -34,11 +34,11 @@ const NotificationItemWrapper = tasty({
 	"aria-relevant": "additions text",
 	styles: { outline: { "": "none" } }
 });
-function NotificationItem({ notification, onDismiss }) {
-	const { theme, title, description, icon, actions, isDismissible = true, id, internalId } = notification;
+function NotificationItem({ notification, onDismiss, onRestore }) {
+	const { theme, title, description, icon, actions, isDismissable = true, id, internalId } = notification;
 	const notificationId = id ?? internalId;
 	const handleKeyDown = useEvent((e) => {
-		if (e.key === "Escape" && isDismissible) {
+		if (e.key === "Escape" && isDismissable) {
 			e.stopPropagation();
 			onDismiss(notificationId, "close");
 		}
@@ -54,9 +54,10 @@ function NotificationItem({ notification, onDismiss }) {
 			description,
 			icon,
 			actions,
-			isDismissible,
+			isDismissable,
 			notificationId,
-			onDismiss
+			onDismiss,
+			onRestore
 		})
 	});
 }

package/dist/components/overlays/Notifications/NotificationItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationItem.js","names":[],"sources":["../../../../src/components/overlays/Notifications/NotificationItem.tsx"],"sourcesContent":["import { Key, KeyboardEvent } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { tasty } from '../../../tasty';\n\nimport { NotificationCard } from './NotificationCard';\n\nimport type {\n  DismissReason,\n  InternalNotification,\n  NotificationType,\n} from './types';\n\n// ─── ARIA Helpers ────────────────────────────────────────────────────\n\nfunction getAriaRole(theme?: NotificationType): 'alert' | 'status' {\n  if (theme === 'danger' || theme === 'warning') {\n    return 'alert';\n  }\n\n  return 'status';\n}\n\nfunction getAriaLive(theme?: NotificationType): 'assertive' | 'polite' {\n  if (theme === 'danger' || theme === 'warning') {\n    return 'assertive';\n  }\n\n  return 'polite';\n}\n\n// ─── Styled Wrapper ──────────────────────────────────────────────────\n\n/**\n * Wrapper element for overlay notification items.\n *\n * Accessibility attributes are set as static defaults:\n * - `tabIndex={0}`: Makes the notification focusable via keyboard, allowing\n *   users to Tab to it and press Escape to dismiss.\n * - `aria-atomic=\"true\"`: Ensures screen readers announce the entire notification\n *   when content changes (not just the diff).\n * - `aria-relevant=\"additions text\"`: Announces when new content is added or\n *   text changes, but not when elements are removed (e.g., during exit animation).\n *\n * The `role` and `aria-live` are set dynamically per-instance based on theme\n * (see `getAriaRole` and `getAriaLive` above).\n */\nconst NotificationItemWrapper = tasty({\n  as: 'div',\n  tabIndex: 0,\n  'aria-atomic': 'true',\n  'aria-relevant': 'additions text',\n  styles: {\n    outline: {\n      '': 'none',\n    },\n  },\n});\n\n// ─── NotificationItem Component ─────────────────────────────────────\n\nexport interface NotificationItemProps {\n  notification: InternalNotification;\n  onDismiss: (id: Key, reason: DismissReason) => void;\n}\n\nexport function NotificationItem({\n  notification,\n  onDismiss,\n}: NotificationItemProps) {\n  const {\n    theme,\n    title,\n    description,\n    icon,\n    actions,\n    isDismissible = true,\n    id,\n    internalId,\n  } = notification;\n\n  const notificationId = id ?? internalId;\n\n  const handleKeyDown = useEvent((e: KeyboardEvent) => {\n    if (e.key === 'Escape' && isDismissible) {\n      e.stopPropagation();\n      onDismiss(notificationId, 'close');\n    }\n  });\n\n  return (\n    <NotificationItemWrapper\n      role={getAriaRole(theme)}\n      aria-live={getAriaLive(theme)}\n      onKeyDown={handleKeyDown}\n    >\n      <NotificationCard\n        qa=\"Notification\"\n        theme={theme}\n        title={title}\n        description={description}\n        icon={icon}\n        actions={actions}\n        isDismissible={isDismissible}\n        notificationId={notificationId}\n        onDismiss={onDismiss}\n      />\n    </NotificationItemWrapper>\n  );\n}\n"],"mappings":";;;;;;;AAeA,SAAS,YAAY,OAA8C;AACjE,KAAI,UAAU,YAAY,UAAU,UAClC,QAAO;AAGT,QAAO;;AAGT,SAAS,YAAY,OAAkD;AACrE,KAAI,UAAU,YAAY,UAAU,UAClC,QAAO;AAGT,QAAO;;;;;;;;;;;;;;;;AAmBT,MAAM,0BAA0B,MAAM;CACpC,IAAI;CACJ,UAAU;CACV,eAAe;CACf,iBAAiB;CACjB,QAAQ,EACN,SAAS,EACP,IAAI,QACL,EACF;CACF,CAAC;AASF,SAAgB,iBAAiB,EAC/B,cACA,aACwB;CACxB,MAAM,EACJ,OACA,OACA,aACA,MACA,SACA,gBAAgB,MAChB,IACA,eACE;CAEJ,MAAM,iBAAiB,MAAM;CAE7B,MAAM,gBAAgB,UAAU,MAAqB;AACnD,MAAI,EAAE,QAAQ,YAAY,eAAe;AACvC,KAAE,iBAAiB;AACnB,aAAU,gBAAgB,QAAQ;;GAEpC;AAEF,QACE,oBAAC;EACC,MAAM,YAAY,MAAM;EACxB,aAAW,YAAY,MAAM;EAC7B,WAAW;YAEX,oBAAC;GACC,IAAG;GACI;GACA;GACM;GACP;GACG;GACM;GACC;GACL;IACX;GACsB"}
+{"version":3,"file":"NotificationItem.js","names":[],"sources":["../../../../src/components/overlays/Notifications/NotificationItem.tsx"],"sourcesContent":["import { Key, KeyboardEvent } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { tasty } from '../../../tasty';\n\nimport { NotificationCard } from './NotificationCard';\n\nimport type {\n  DismissReason,\n  InternalNotification,\n  NotificationType,\n} from './types';\n\n// ─── ARIA Helpers ────────────────────────────────────────────────────\n\nfunction getAriaRole(theme?: NotificationType): 'alert' | 'status' {\n  if (theme === 'danger' || theme === 'warning') {\n    return 'alert';\n  }\n\n  return 'status';\n}\n\nfunction getAriaLive(theme?: NotificationType): 'assertive' | 'polite' {\n  if (theme === 'danger' || theme === 'warning') {\n    return 'assertive';\n  }\n\n  return 'polite';\n}\n\n// ─── Styled Wrapper ──────────────────────────────────────────────────\n\n/**\n * Wrapper element for overlay notification items.\n *\n * Accessibility attributes are set as static defaults:\n * - `tabIndex={0}`: Makes the notification focusable via keyboard, allowing\n *   users to Tab to it and press Escape to dismiss.\n * - `aria-atomic=\"true\"`: Ensures screen readers announce the entire notification\n *   when content changes (not just the diff).\n * - `aria-relevant=\"additions text\"`: Announces when new content is added or\n *   text changes, but not when elements are removed (e.g., during exit animation).\n *\n * The `role` and `aria-live` are set dynamically per-instance based on theme\n * (see `getAriaRole` and `getAriaLive` above).\n */\nconst NotificationItemWrapper = tasty({\n  as: 'div',\n  tabIndex: 0,\n  'aria-atomic': 'true',\n  'aria-relevant': 'additions text',\n  styles: {\n    outline: {\n      '': 'none',\n    },\n  },\n});\n\n// ─── NotificationItem Component ─────────────────────────────────────\n\nexport interface NotificationItemProps {\n  notification: InternalNotification;\n  onDismiss: (id: Key, reason: DismissReason) => void;\n  onRestore?: (id: Key) => void;\n}\n\nexport function NotificationItem({\n  notification,\n  onDismiss,\n  onRestore,\n}: NotificationItemProps) {\n  const {\n    theme,\n    title,\n    description,\n    icon,\n    actions,\n    isDismissable = true,\n    id,\n    internalId,\n  } = notification;\n\n  const notificationId = id ?? internalId;\n\n  const handleKeyDown = useEvent((e: KeyboardEvent) => {\n    if (e.key === 'Escape' && isDismissable) {\n      e.stopPropagation();\n      onDismiss(notificationId, 'close');\n    }\n  });\n\n  return (\n    <NotificationItemWrapper\n      role={getAriaRole(theme)}\n      aria-live={getAriaLive(theme)}\n      onKeyDown={handleKeyDown}\n    >\n      <NotificationCard\n        qa=\"Notification\"\n        theme={theme}\n        title={title}\n        description={description}\n        icon={icon}\n        actions={actions}\n        isDismissable={isDismissable}\n        notificationId={notificationId}\n        onDismiss={onDismiss}\n        onRestore={onRestore}\n      />\n    </NotificationItemWrapper>\n  );\n}\n"],"mappings":";;;;;;;AAeA,SAAS,YAAY,OAA8C;AACjE,KAAI,UAAU,YAAY,UAAU,UAClC,QAAO;AAGT,QAAO;;AAGT,SAAS,YAAY,OAAkD;AACrE,KAAI,UAAU,YAAY,UAAU,UAClC,QAAO;AAGT,QAAO;;;;;;;;;;;;;;;;AAmBT,MAAM,0BAA0B,MAAM;CACpC,IAAI;CACJ,UAAU;CACV,eAAe;CACf,iBAAiB;CACjB,QAAQ,EACN,SAAS,EACP,IAAI,QACL,EACF;CACF,CAAC;AAUF,SAAgB,iBAAiB,EAC/B,cACA,WACA,aACwB;CACxB,MAAM,EACJ,OACA,OACA,aACA,MACA,SACA,gBAAgB,MAChB,IACA,eACE;CAEJ,MAAM,iBAAiB,MAAM;CAE7B,MAAM,gBAAgB,UAAU,MAAqB;AACnD,MAAI,EAAE,QAAQ,YAAY,eAAe;AACvC,KAAE,iBAAiB;AACnB,aAAU,gBAAgB,QAAQ;;GAEpC;AAEF,QACE,oBAAC;EACC,MAAM,YAAY,MAAM;EACxB,aAAW,YAAY,MAAM;EAC7B,WAAW;YAEX,oBAAC;GACC,IAAG;GACI;GACA;GACM;GACP;GACG;GACM;GACC;GACL;GACA;IACX;GACsB"}

package/dist/components/overlays/Notifications/OverlayContainer.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { tasty } from "../../../tasty/tasty.js";
 import { useLayoutEffect as useLayoutEffect$1 } from "../../../utils/react/useLayoutEffect.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
@@ -19,7 +19,7 @@ const OverlayContainerElement = tasty({ styles: {
 	top: "2x",
 	left: "50%",
 	transform: "translateX(-50%)",
-	zIndex: 1e4,
+	zIndex: 100,
 	padding: "1x",
 	height: "0",
 	pointerEvents: "none"
@@ -208,7 +208,7 @@ function useCollapseState(canCollapse, allItems, itemRefs, onPauseChange) {
 		containerRef
 	};
 }
-function OverlayContainer({ toasts, notifications, onToastExitComplete, onNotificationExitComplete, onNotificationDismiss, onPauseChange }) {
+function OverlayContainer({ toasts, notifications, onToastExitComplete, onNotificationExitComplete, onNotificationDismiss, onNotificationRestore, onPauseChange }) {
 	const allItems = useMemo(() => {
 		const items = [...toasts.map((t) => ({
 			kind: "toast",
@@ -295,7 +295,8 @@ function OverlayContainer({ toasts, notifications, onToastExitComplete, onNotifi
 						actions: item.data.actions
 					}) : /* @__PURE__ */ jsx(NotificationItem, {
 						notification: item.data,
-						onDismiss: handleNotificationDismiss
+						onDismiss: handleNotificationDismiss,
+						onRestore: onNotificationRestore
 					})
 				})
 			}, itemId);

package/dist/components/overlays/Notifications/OverlayContainer.js.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayContainer.js","names":[],"sources":["../../../../src/components/overlays/Notifications/OverlayContainer.tsx"],"sourcesContent":["import {\n  FocusEvent,\n  Key,\n  RefObject,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { tasty } from '../../../tasty';\nimport { useLayoutEffect } from '../../../utils/react/useLayoutEffect';\nimport { DisplayTransition } from '../../helpers/DisplayTransition/DisplayTransition';\nimport { Portal } from '../../portal';\nimport { ToastItem } from '../Toast/ToastItem';\n\nimport { NotificationItem } from './NotificationItem';\n\nimport type { InternalToast } from '../Toast/types';\nimport type { DismissReason, InternalNotification } from './types';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst COLLAPSE_VISIBLE_HEIGHT = 10;\nconst CONTAINER_OFFSET = 16;\nconst ITEM_GAP = 8;\nconst DEFAULT_ITEM_HEIGHT = 56;\n\n// ─── Styled Elements ─────────────────────────────────────────────────\n\nconst OverlayContainerElement = tasty({\n  styles: {\n    position: 'fixed',\n    top: '2x',\n    left: '50%',\n    transform: 'translateX(-50%)',\n    zIndex: 10000,\n    padding: '1x',\n    height: '0',\n    pointerEvents: 'none',\n  },\n});\n\nconst OverlayItemWrapper = tasty({\n  styles: {\n    position: 'absolute',\n    top: '0',\n    left: '50%',\n    transform: {\n      '': 'translateX(-50%) translateY(-50%)',\n      'isMeasured & isShown': 'translateX(-50%) translateY(0)',\n    },\n    width: 'max-content 50x',\n    pointerEvents: 'auto',\n    transition: {\n      '': 'opacity $transition ease-in, transform $transition ease-in',\n      isMeasured:\n        'top $transition ease-in, opacity $transition ease-in, transform $transition ease-in',\n    },\n    opacity: {\n      '': 0,\n      isShown: 1,\n    },\n  },\n});\n\n// ─── Unified Item Type ───────────────────────────────────────────────\n\ntype OverlayItem =\n  | { kind: 'toast'; data: InternalToast }\n  | { kind: 'notification'; data: InternalNotification };\n\nfunction getItemId(item: OverlayItem): string {\n  return item.data.internalId;\n}\n\nfunction isItemExiting(item: OverlayItem): boolean {\n  return item.data.isExiting === true;\n}\n\nfunction getItemCreatedAt(item: OverlayItem): number {\n  return item.data.createdAt;\n}\n\n// ─── useItemPositions Hook ───────────────────────────────────────────\n\ninterface ItemPositionsResult {\n  heights: Record<string, number>;\n  /** Set of item IDs that have been measured AND painted at their correct position. */\n  settledIds: Set<string>;\n  positions: Map<string, number>;\n  lastPositionsRef: ReturnType<typeof useRef<Map<string, number>>>;\n  itemRefs: ReturnType<typeof useRef<Map<string, HTMLDivElement>>>;\n  createRefCallback: (\n    itemId: string,\n    displayRef: (el: HTMLElement | null) => void,\n  ) => (el: HTMLDivElement | null) => void;\n}\n\n/**\n * Manages height measurement, position calculation, and ref tracking\n * for overlay items. Extracted from OverlayContainer for readability.\n */\nfunction useItemPositions(visibleItems: OverlayItem[]): ItemPositionsResult {\n  const [heights, setHeights] = useState<Record<string, number>>({});\n  const itemRefs = useRef<Map<string, HTMLDivElement>>(new Map());\n  const lastPositionsRef = useRef<Map<string, number>>(new Map());\n\n  // Items that have been measured AND painted at their correct position.\n  // Lags one frame behind `heights` so the browser paints the item at\n  // its final `top` before the CSS `top` transition is enabled.\n  const [settledIds, setSettledIds] = useState<Set<string>>(new Set());\n  const rafRef = useRef<number | null>(null);\n\n  // Measure heights using layout effect to avoid visible layout shifts.\n  // Runs every render but bails early if nothing changed.\n  useLayoutEffect(() => {\n    const newHeights: Record<string, number> = {};\n    let hasChanges = false;\n\n    itemRefs.current.forEach((el, id) => {\n      const height = el.offsetHeight || DEFAULT_ITEM_HEIGHT;\n      newHeights[id] = height;\n\n      if (heights[id] !== height) {\n        hasChanges = true;\n      }\n    });\n\n    for (const id of Object.keys(heights)) {\n      if (!itemRefs.current.has(id)) {\n        hasChanges = true;\n      }\n    }\n\n    if (hasChanges) {\n      setHeights(newHeights);\n    }\n  });\n\n  // After heights change, schedule settledIds update for the next frame.\n  // This ensures the item is painted at its correct position (with no top\n  // transition) before we enable the transition.\n  useEffect(() => {\n    const heightKeys = Object.keys(heights);\n    const newIds = heightKeys.filter((id) => !settledIds.has(id));\n    const hasStaleIds =\n      settledIds.size > 0 && [...settledIds].some((id) => !(id in heights));\n\n    if (newIds.length === 0 && !hasStaleIds) return;\n\n    if (rafRef.current != null) {\n      cancelAnimationFrame(rafRef.current);\n    }\n\n    // For pruning-only updates (no new items), apply synchronously since\n    // there's no need to wait for a paint frame.\n    if (newIds.length === 0 && hasStaleIds) {\n      setSettledIds((prev) => new Set(heightKeys.filter((id) => prev.has(id))));\n      return;\n    }\n\n    rafRef.current = requestAnimationFrame(() => {\n      rafRef.current = null;\n      setSettledIds((prev) => {\n        const next = new Set<string>();\n\n        // Only keep IDs that still exist in heights (prune removed items)\n        for (const id of heightKeys) {\n          if (prev.has(id)) {\n            next.add(id);\n          }\n        }\n\n        for (const id of newIds) {\n          next.add(id);\n        }\n\n        return next;\n      });\n    });\n\n    return () => {\n      if (rafRef.current != null) {\n        cancelAnimationFrame(rafRef.current);\n        rafRef.current = null;\n      }\n    };\n  }, [heights]);\n\n  const createRefCallback = useCallback(\n    (itemId: string, displayRef: (el: HTMLElement | null) => void) =>\n      (el: HTMLDivElement | null) => {\n        displayRef(el);\n\n        if (el) {\n          itemRefs.current.set(itemId, el);\n        } else {\n          itemRefs.current.delete(itemId);\n        }\n      },\n    [],\n  );\n\n  const positions = useMemo(() => {\n    const posMap = new Map<string, number>();\n    let currentTop = 0;\n\n    for (const item of visibleItems) {\n      const id = getItemId(item);\n      posMap.set(id, currentTop);\n      const height = heights[id] ?? DEFAULT_ITEM_HEIGHT;\n      currentTop += height + ITEM_GAP;\n    }\n\n    return posMap;\n  }, [visibleItems, heights]);\n\n  useEffect(() => {\n    positions.forEach((pos, id) => {\n      lastPositionsRef.current.set(id, pos);\n    });\n  }, [positions]);\n\n  return {\n    heights,\n    settledIds,\n    positions,\n    lastPositionsRef,\n    itemRefs,\n    createRefCallback,\n  };\n}\n\n// ─── useCollapseState Hook ───────────────────────────────────────────\n\ninterface CollapseStateResult {\n  isCollapsed: boolean;\n  handleMouseEnter: () => void;\n  handleMouseLeave: () => void;\n  handleFocus: () => void;\n  handleBlur: (e: FocusEvent) => void;\n  containerRef: RefObject<HTMLDivElement | null>;\n}\n\n/**\n * Manages collapse/expand behavior and pause state for the overlay container.\n * Extracted from OverlayContainer for readability.\n */\nfunction useCollapseState(\n  canCollapse: boolean,\n  allItems: OverlayItem[],\n  itemRefs: ReturnType<typeof useRef<Map<string, HTMLDivElement>>>,\n  onPauseChange: (paused: boolean) => void,\n): CollapseStateResult {\n  const [isCollapsed, setIsCollapsed] = useState(false);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const boundsRef = useRef<DOMRect | null>(null);\n\n  const updateBounds = useCallback(() => {\n    const refs = itemRefs.current;\n\n    if (!refs || refs.size === 0) {\n      boundsRef.current = null;\n      return;\n    }\n\n    let minX = Infinity,\n      minY = Infinity,\n      maxX = -Infinity,\n      maxY = -Infinity;\n\n    refs.forEach((el) => {\n      const rect = el.getBoundingClientRect();\n      minX = Math.min(minX, rect.left);\n      minY = Math.min(minY, rect.top);\n      maxX = Math.max(maxX, rect.right);\n      maxY = Math.max(maxY, rect.bottom);\n    });\n\n    if (typeof DOMRect !== 'undefined') {\n      boundsRef.current = new DOMRect(minX, minY, maxX - minX, maxY - minY);\n    } else {\n      boundsRef.current = {\n        x: minX,\n        y: minY,\n        width: maxX - minX,\n        height: maxY - minY,\n        top: minY,\n        right: maxX,\n        bottom: maxY,\n        left: minX,\n        toJSON: () => ({}),\n      } as DOMRect;\n    }\n  }, [itemRefs]);\n\n  // Track mouse for collapse — expand when mouse leaves bounds\n  useEffect(() => {\n    if (!isCollapsed) return;\n\n    const handleMouseMove = (e: MouseEvent) => {\n      const bounds = boundsRef.current;\n\n      if (!bounds) {\n        setIsCollapsed(false);\n        onPauseChange(false);\n        return;\n      }\n\n      const padding = 20;\n      const isInBounds =\n        e.clientX >= bounds.left - padding &&\n        e.clientX <= bounds.right + padding &&\n        e.clientY >= bounds.top - padding &&\n        e.clientY <= bounds.bottom + padding;\n\n      if (!isInBounds) {\n        setIsCollapsed(false);\n        onPauseChange(false);\n      }\n    };\n\n    window.addEventListener('mousemove', handleMouseMove);\n    return () => window.removeEventListener('mousemove', handleMouseMove);\n  }, [isCollapsed, onPauseChange]);\n\n  // Update bounds when items change\n  useEffect(() => {\n    updateBounds();\n  }, [allItems, updateBounds]);\n\n  const handleMouseEnter = useCallback(() => {\n    updateBounds();\n    onPauseChange(true);\n\n    if (canCollapse) {\n      setIsCollapsed(true);\n    }\n  }, [updateBounds, canCollapse, onPauseChange]);\n\n  const handleMouseLeave = useCallback(() => {\n    if (!isCollapsed) {\n      onPauseChange(false);\n    }\n  }, [isCollapsed, onPauseChange]);\n\n  const handleFocus = useCallback(() => {\n    onPauseChange(true);\n  }, [onPauseChange]);\n\n  const handleBlur = useCallback(\n    (e: FocusEvent) => {\n      if (\n        containerRef.current &&\n        !containerRef.current.contains(e.relatedTarget as Node)\n      ) {\n        onPauseChange(false);\n      }\n    },\n    [onPauseChange],\n  );\n\n  return {\n    isCollapsed,\n    handleMouseEnter,\n    handleMouseLeave,\n    handleFocus,\n    handleBlur,\n    containerRef,\n  };\n}\n\n// ─── Overlay Container ───────────────────────────────────────────────\n//\n// INTENTIONAL: Position calculations are done manually (absolute positioning + JS\n// height tracking) rather than relying on CSS flexbox/grid layout. This is\n// deliberate — the container mixes enter/exit animations, collapse behavior, and\n// heterogeneous item sizes (toasts vs notifications) which require per-item\n// position control. CSS-only solutions (e.g., flex column with gap) break when\n// items exit asynchronously or when collapse transforms need to be computed per-item.\n\nexport interface OverlayContainerProps {\n  toasts: InternalToast[];\n  notifications: InternalNotification[];\n  onToastExitComplete: (internalId: string) => void;\n  onNotificationExitComplete: (internalId: string) => void;\n  onNotificationDismiss: (id: Key, reason: DismissReason) => void;\n  onPauseChange: (paused: boolean) => void;\n}\n\nexport function OverlayContainer({\n  toasts,\n  notifications,\n  onToastExitComplete,\n  onNotificationExitComplete,\n  onNotificationDismiss,\n  onPauseChange,\n}: OverlayContainerProps) {\n  // Merge toasts and notifications into a single ordered list\n  const allItems: OverlayItem[] = useMemo(() => {\n    const items: OverlayItem[] = [\n      ...toasts.map((t): OverlayItem => ({ kind: 'toast', data: t })),\n      ...notifications.map(\n        (n): OverlayItem => ({ kind: 'notification', data: n }),\n      ),\n    ];\n\n    // Sort by createdAt ascending (oldest first = bottom of stack, newest last = top)\n    items.sort((a, b) => getItemCreatedAt(a) - getItemCreatedAt(b));\n\n    return items;\n  }, [toasts, notifications]);\n\n  const visibleItems = useMemo(\n    () => allItems.filter((item) => !isItemExiting(item)),\n    [allItems],\n  );\n  const hasNotifications = notifications.some((n) => !n.isExiting);\n  const hasActionableToasts = toasts.some((t) => !t.isExiting && t.actions);\n  const canCollapse = !hasNotifications && !hasActionableToasts;\n\n  const {\n    heights,\n    settledIds,\n    positions,\n    lastPositionsRef,\n    itemRefs,\n    createRefCallback,\n  } = useItemPositions(visibleItems);\n\n  const {\n    isCollapsed,\n    handleMouseEnter,\n    handleMouseLeave,\n    handleFocus,\n    handleBlur,\n    containerRef,\n  } = useCollapseState(canCollapse, allItems, itemRefs, onPauseChange);\n\n  // ─── Callbacks ─────────────────────────────────────────────────────\n\n  // When the user dismisses a notification they were hovering, the element\n  // is removed from the DOM so mouseLeave never fires. Explicitly unpause\n  // so remaining notifications' timers resume.\n  const handleNotificationDismiss = useEvent(\n    (id: Key, reason: DismissReason) => {\n      onNotificationDismiss(id, reason);\n      onPauseChange(false);\n    },\n  );\n\n  const handleExitComplete = useEvent((item: OverlayItem) => {\n    const id = getItemId(item);\n    lastPositionsRef.current?.delete(id);\n\n    if (item.kind === 'toast') {\n      onToastExitComplete(item.data.internalId);\n    } else {\n      onNotificationExitComplete(item.data.internalId);\n    }\n  });\n\n  // useCallback (not useEvent) because this is called during render.\n  // useEvent defers the ref update to useLayoutEffect, so during render\n  // it would still read the previous closure's positions/heights.\n  const getItemStyle = useCallback(\n    (item: OverlayItem, index: number, total: number) => {\n      const id = getItemId(item);\n      const baseTop =\n        positions.get(id) ?? lastPositionsRef.current?.get(id) ?? 0;\n      const height = heights[id] ?? DEFAULT_ITEM_HEIGHT;\n\n      if (!isCollapsed || !canCollapse) {\n        return { top: `${baseTop}px` };\n      }\n\n      const isNewest = index === total - 1;\n      const collapsedTop = COLLAPSE_VISIBLE_HEIGHT - CONTAINER_OFFSET - height;\n\n      return {\n        top: `${collapsedTop}px`,\n        zIndex: index,\n        opacity: isNewest ? 1 : 0,\n        pointerEvents: 'none' as const,\n      };\n    },\n    [isCollapsed, canCollapse, positions, heights, lastPositionsRef],\n  );\n\n  // Build a visibleIndex lookup map to avoid O(n²) findIndex inside render loop\n  const visibleIndexMap = useMemo(() => {\n    const map = new Map<string, number>();\n\n    visibleItems.forEach((item, index) => {\n      map.set(getItemId(item), index);\n    });\n\n    return map;\n  }, [visibleItems]);\n\n  if (allItems.length === 0) return null;\n\n  return (\n    <Portal>\n      <OverlayContainerElement\n        ref={containerRef}\n        onFocus={handleFocus}\n        onBlur={handleBlur}\n      >\n        {allItems.map((item) => {\n          const itemId = getItemId(item);\n          const visibleIndex = visibleIndexMap.get(itemId) ?? 0;\n          const isExiting = isItemExiting(item);\n\n          return (\n            <DisplayTransition\n              key={itemId}\n              animateOnMount\n              isShown={!isExiting}\n              onRest={(transition) => {\n                if (transition === 'exit') {\n                  handleExitComplete(item);\n                }\n              }}\n            >\n              {({ isShown, ref }) => (\n                <OverlayItemWrapper\n                  ref={createRefCallback(itemId, ref)}\n                  mods={{ isShown, isMeasured: settledIds.has(itemId) }}\n                  style={getItemStyle(item, visibleIndex, visibleItems.length)}\n                  onMouseEnter={handleMouseEnter}\n                  onMouseLeave={handleMouseLeave}\n                >\n                  {item.kind === 'toast' ? (\n                    <ToastItem\n                      {...item.data.itemProps}\n                      title={item.data.title}\n                      description={item.data.description}\n                      theme={item.data.theme}\n                      icon={item.data.icon}\n                      isLoading={item.data.isLoading}\n                      actions={item.data.actions}\n                    />\n                  ) : (\n                    <NotificationItem\n                      notification={item.data}\n                      onDismiss={handleNotificationDismiss}\n                    />\n                  )}\n                </OverlayItemWrapper>\n              )}\n            </DisplayTransition>\n          );\n        })}\n      </OverlayContainerElement>\n    </Portal>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"OverlayContainer.js","names":[],"sources":["../../../../src/components/overlays/Notifications/OverlayContainer.tsx"],"sourcesContent":["import {\n  FocusEvent,\n  Key,\n  RefObject,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { tasty } from '../../../tasty';\nimport { useLayoutEffect } from '../../../utils/react/useLayoutEffect';\nimport { DisplayTransition } from '../../helpers/DisplayTransition/DisplayTransition';\nimport { Portal } from '../../portal';\nimport { ToastItem } from '../Toast/ToastItem';\n\nimport { NotificationItem } from './NotificationItem';\n\nimport type { InternalToast } from '../Toast/types';\nimport type { DismissReason, InternalNotification } from './types';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst COLLAPSE_VISIBLE_HEIGHT = 10;\nconst CONTAINER_OFFSET = 16;\nconst ITEM_GAP = 8;\nconst DEFAULT_ITEM_HEIGHT = 56;\n\n// ─── Styled Elements ─────────────────────────────────────────────────\n\nconst OverlayContainerElement = tasty({\n  styles: {\n    position: 'fixed',\n    top: '2x',\n    left: '50%',\n    transform: 'translateX(-50%)',\n    zIndex: 100,\n    padding: '1x',\n    height: '0',\n    pointerEvents: 'none',\n  },\n});\n\nconst OverlayItemWrapper = tasty({\n  styles: {\n    position: 'absolute',\n    top: '0',\n    left: '50%',\n    transform: {\n      '': 'translateX(-50%) translateY(-50%)',\n      'isMeasured & isShown': 'translateX(-50%) translateY(0)',\n    },\n    width: 'max-content 50x',\n    pointerEvents: 'auto',\n    transition: {\n      '': 'opacity $transition ease-in, transform $transition ease-in',\n      isMeasured:\n        'top $transition ease-in, opacity $transition ease-in, transform $transition ease-in',\n    },\n    opacity: {\n      '': 0,\n      isShown: 1,\n    },\n  },\n});\n\n// ─── Unified Item Type ───────────────────────────────────────────────\n\ntype OverlayItem =\n  | { kind: 'toast'; data: InternalToast }\n  | { kind: 'notification'; data: InternalNotification };\n\nfunction getItemId(item: OverlayItem): string {\n  return item.data.internalId;\n}\n\nfunction isItemExiting(item: OverlayItem): boolean {\n  return item.data.isExiting === true;\n}\n\nfunction getItemCreatedAt(item: OverlayItem): number {\n  return item.data.createdAt;\n}\n\n// ─── useItemPositions Hook ───────────────────────────────────────────\n\ninterface ItemPositionsResult {\n  heights: Record<string, number>;\n  /** Set of item IDs that have been measured AND painted at their correct position. */\n  settledIds: Set<string>;\n  positions: Map<string, number>;\n  lastPositionsRef: ReturnType<typeof useRef<Map<string, number>>>;\n  itemRefs: ReturnType<typeof useRef<Map<string, HTMLDivElement>>>;\n  createRefCallback: (\n    itemId: string,\n    displayRef: (el: HTMLElement | null) => void,\n  ) => (el: HTMLDivElement | null) => void;\n}\n\n/**\n * Manages height measurement, position calculation, and ref tracking\n * for overlay items. Extracted from OverlayContainer for readability.\n */\nfunction useItemPositions(visibleItems: OverlayItem[]): ItemPositionsResult {\n  const [heights, setHeights] = useState<Record<string, number>>({});\n  const itemRefs = useRef<Map<string, HTMLDivElement>>(new Map());\n  const lastPositionsRef = useRef<Map<string, number>>(new Map());\n\n  // Items that have been measured AND painted at their correct position.\n  // Lags one frame behind `heights` so the browser paints the item at\n  // its final `top` before the CSS `top` transition is enabled.\n  const [settledIds, setSettledIds] = useState<Set<string>>(new Set());\n  const rafRef = useRef<number | null>(null);\n\n  // Measure heights using layout effect to avoid visible layout shifts.\n  // Runs every render but bails early if nothing changed.\n  useLayoutEffect(() => {\n    const newHeights: Record<string, number> = {};\n    let hasChanges = false;\n\n    itemRefs.current.forEach((el, id) => {\n      const height = el.offsetHeight || DEFAULT_ITEM_HEIGHT;\n      newHeights[id] = height;\n\n      if (heights[id] !== height) {\n        hasChanges = true;\n      }\n    });\n\n    for (const id of Object.keys(heights)) {\n      if (!itemRefs.current.has(id)) {\n        hasChanges = true;\n      }\n    }\n\n    if (hasChanges) {\n      setHeights(newHeights);\n    }\n  });\n\n  // After heights change, schedule settledIds update for the next frame.\n  // This ensures the item is painted at its correct position (with no top\n  // transition) before we enable the transition.\n  useEffect(() => {\n    const heightKeys = Object.keys(heights);\n    const newIds = heightKeys.filter((id) => !settledIds.has(id));\n    const hasStaleIds =\n      settledIds.size > 0 && [...settledIds].some((id) => !(id in heights));\n\n    if (newIds.length === 0 && !hasStaleIds) return;\n\n    if (rafRef.current != null) {\n      cancelAnimationFrame(rafRef.current);\n    }\n\n    // For pruning-only updates (no new items), apply synchronously since\n    // there's no need to wait for a paint frame.\n    if (newIds.length === 0 && hasStaleIds) {\n      setSettledIds((prev) => new Set(heightKeys.filter((id) => prev.has(id))));\n      return;\n    }\n\n    rafRef.current = requestAnimationFrame(() => {\n      rafRef.current = null;\n      setSettledIds((prev) => {\n        const next = new Set<string>();\n\n        // Only keep IDs that still exist in heights (prune removed items)\n        for (const id of heightKeys) {\n          if (prev.has(id)) {\n            next.add(id);\n          }\n        }\n\n        for (const id of newIds) {\n          next.add(id);\n        }\n\n        return next;\n      });\n    });\n\n    return () => {\n      if (rafRef.current != null) {\n        cancelAnimationFrame(rafRef.current);\n        rafRef.current = null;\n      }\n    };\n  }, [heights]);\n\n  const createRefCallback = useCallback(\n    (itemId: string, displayRef: (el: HTMLElement | null) => void) =>\n      (el: HTMLDivElement | null) => {\n        displayRef(el);\n\n        if (el) {\n          itemRefs.current.set(itemId, el);\n        } else {\n          itemRefs.current.delete(itemId);\n        }\n      },\n    [],\n  );\n\n  const positions = useMemo(() => {\n    const posMap = new Map<string, number>();\n    let currentTop = 0;\n\n    for (const item of visibleItems) {\n      const id = getItemId(item);\n      posMap.set(id, currentTop);\n      const height = heights[id] ?? DEFAULT_ITEM_HEIGHT;\n      currentTop += height + ITEM_GAP;\n    }\n\n    return posMap;\n  }, [visibleItems, heights]);\n\n  useEffect(() => {\n    positions.forEach((pos, id) => {\n      lastPositionsRef.current.set(id, pos);\n    });\n  }, [positions]);\n\n  return {\n    heights,\n    settledIds,\n    positions,\n    lastPositionsRef,\n    itemRefs,\n    createRefCallback,\n  };\n}\n\n// ─── useCollapseState Hook ───────────────────────────────────────────\n\ninterface CollapseStateResult {\n  isCollapsed: boolean;\n  handleMouseEnter: () => void;\n  handleMouseLeave: () => void;\n  handleFocus: () => void;\n  handleBlur: (e: FocusEvent) => void;\n  containerRef: RefObject<HTMLDivElement | null>;\n}\n\n/**\n * Manages collapse/expand behavior and pause state for the overlay container.\n * Extracted from OverlayContainer for readability.\n */\nfunction useCollapseState(\n  canCollapse: boolean,\n  allItems: OverlayItem[],\n  itemRefs: ReturnType<typeof useRef<Map<string, HTMLDivElement>>>,\n  onPauseChange: (paused: boolean) => void,\n): CollapseStateResult {\n  const [isCollapsed, setIsCollapsed] = useState(false);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const boundsRef = useRef<DOMRect | null>(null);\n\n  const updateBounds = useCallback(() => {\n    const refs = itemRefs.current;\n\n    if (!refs || refs.size === 0) {\n      boundsRef.current = null;\n      return;\n    }\n\n    let minX = Infinity,\n      minY = Infinity,\n      maxX = -Infinity,\n      maxY = -Infinity;\n\n    refs.forEach((el) => {\n      const rect = el.getBoundingClientRect();\n      minX = Math.min(minX, rect.left);\n      minY = Math.min(minY, rect.top);\n      maxX = Math.max(maxX, rect.right);\n      maxY = Math.max(maxY, rect.bottom);\n    });\n\n    if (typeof DOMRect !== 'undefined') {\n      boundsRef.current = new DOMRect(minX, minY, maxX - minX, maxY - minY);\n    } else {\n      boundsRef.current = {\n        x: minX,\n        y: minY,\n        width: maxX - minX,\n        height: maxY - minY,\n        top: minY,\n        right: maxX,\n        bottom: maxY,\n        left: minX,\n        toJSON: () => ({}),\n      } as DOMRect;\n    }\n  }, [itemRefs]);\n\n  // Track mouse for collapse — expand when mouse leaves bounds\n  useEffect(() => {\n    if (!isCollapsed) return;\n\n    const handleMouseMove = (e: MouseEvent) => {\n      const bounds = boundsRef.current;\n\n      if (!bounds) {\n        setIsCollapsed(false);\n        onPauseChange(false);\n        return;\n      }\n\n      const padding = 20;\n      const isInBounds =\n        e.clientX >= bounds.left - padding &&\n        e.clientX <= bounds.right + padding &&\n        e.clientY >= bounds.top - padding &&\n        e.clientY <= bounds.bottom + padding;\n\n      if (!isInBounds) {\n        setIsCollapsed(false);\n        onPauseChange(false);\n      }\n    };\n\n    window.addEventListener('mousemove', handleMouseMove);\n    return () => window.removeEventListener('mousemove', handleMouseMove);\n  }, [isCollapsed, onPauseChange]);\n\n  // Update bounds when items change\n  useEffect(() => {\n    updateBounds();\n  }, [allItems, updateBounds]);\n\n  const handleMouseEnter = useCallback(() => {\n    updateBounds();\n    onPauseChange(true);\n\n    if (canCollapse) {\n      setIsCollapsed(true);\n    }\n  }, [updateBounds, canCollapse, onPauseChange]);\n\n  const handleMouseLeave = useCallback(() => {\n    if (!isCollapsed) {\n      onPauseChange(false);\n    }\n  }, [isCollapsed, onPauseChange]);\n\n  const handleFocus = useCallback(() => {\n    onPauseChange(true);\n  }, [onPauseChange]);\n\n  const handleBlur = useCallback(\n    (e: FocusEvent) => {\n      if (\n        containerRef.current &&\n        !containerRef.current.contains(e.relatedTarget as Node)\n      ) {\n        onPauseChange(false);\n      }\n    },\n    [onPauseChange],\n  );\n\n  return {\n    isCollapsed,\n    handleMouseEnter,\n    handleMouseLeave,\n    handleFocus,\n    handleBlur,\n    containerRef,\n  };\n}\n\n// ─── Overlay Container ───────────────────────────────────────────────\n//\n// INTENTIONAL: Position calculations are done manually (absolute positioning + JS\n// height tracking) rather than relying on CSS flexbox/grid layout. This is\n// deliberate — the container mixes enter/exit animations, collapse behavior, and\n// heterogeneous item sizes (toasts vs notifications) which require per-item\n// position control. CSS-only solutions (e.g., flex column with gap) break when\n// items exit asynchronously or when collapse transforms need to be computed per-item.\n\nexport interface OverlayContainerProps {\n  toasts: InternalToast[];\n  notifications: InternalNotification[];\n  onToastExitComplete: (internalId: string) => void;\n  onNotificationExitComplete: (internalId: string) => void;\n  onNotificationDismiss: (id: Key, reason: DismissReason) => void;\n  onNotificationRestore: (id: Key) => void;\n  onPauseChange: (paused: boolean) => void;\n}\n\nexport function OverlayContainer({\n  toasts,\n  notifications,\n  onToastExitComplete,\n  onNotificationExitComplete,\n  onNotificationDismiss,\n  onNotificationRestore,\n  onPauseChange,\n}: OverlayContainerProps) {\n  // Merge toasts and notifications into a single ordered list\n  const allItems: OverlayItem[] = useMemo(() => {\n    const items: OverlayItem[] = [\n      ...toasts.map((t): OverlayItem => ({ kind: 'toast', data: t })),\n      ...notifications.map(\n        (n): OverlayItem => ({ kind: 'notification', data: n }),\n      ),\n    ];\n\n    // Sort by createdAt ascending (oldest first = bottom of stack, newest last = top)\n    items.sort((a, b) => getItemCreatedAt(a) - getItemCreatedAt(b));\n\n    return items;\n  }, [toasts, notifications]);\n\n  const visibleItems = useMemo(\n    () => allItems.filter((item) => !isItemExiting(item)),\n    [allItems],\n  );\n  const hasNotifications = notifications.some((n) => !n.isExiting);\n  const hasActionableToasts = toasts.some((t) => !t.isExiting && t.actions);\n  const canCollapse = !hasNotifications && !hasActionableToasts;\n\n  const {\n    heights,\n    settledIds,\n    positions,\n    lastPositionsRef,\n    itemRefs,\n    createRefCallback,\n  } = useItemPositions(visibleItems);\n\n  const {\n    isCollapsed,\n    handleMouseEnter,\n    handleMouseLeave,\n    handleFocus,\n    handleBlur,\n    containerRef,\n  } = useCollapseState(canCollapse, allItems, itemRefs, onPauseChange);\n\n  // ─── Callbacks ─────────────────────────────────────────────────────\n\n  // When the user dismisses a notification they were hovering, the element\n  // is removed from the DOM so mouseLeave never fires. Explicitly unpause\n  // so remaining notifications' timers resume.\n  const handleNotificationDismiss = useEvent(\n    (id: Key, reason: DismissReason) => {\n      onNotificationDismiss(id, reason);\n      onPauseChange(false);\n    },\n  );\n\n  const handleExitComplete = useEvent((item: OverlayItem) => {\n    const id = getItemId(item);\n    lastPositionsRef.current?.delete(id);\n\n    if (item.kind === 'toast') {\n      onToastExitComplete(item.data.internalId);\n    } else {\n      onNotificationExitComplete(item.data.internalId);\n    }\n  });\n\n  // useCallback (not useEvent) because this is called during render.\n  // useEvent defers the ref update to useLayoutEffect, so during render\n  // it would still read the previous closure's positions/heights.\n  const getItemStyle = useCallback(\n    (item: OverlayItem, index: number, total: number) => {\n      const id = getItemId(item);\n      const baseTop =\n        positions.get(id) ?? lastPositionsRef.current?.get(id) ?? 0;\n      const height = heights[id] ?? DEFAULT_ITEM_HEIGHT;\n\n      if (!isCollapsed || !canCollapse) {\n        return { top: `${baseTop}px` };\n      }\n\n      const isNewest = index === total - 1;\n      const collapsedTop = COLLAPSE_VISIBLE_HEIGHT - CONTAINER_OFFSET - height;\n\n      return {\n        top: `${collapsedTop}px`,\n        zIndex: index,\n        opacity: isNewest ? 1 : 0,\n        pointerEvents: 'none' as const,\n      };\n    },\n    [isCollapsed, canCollapse, positions, heights, lastPositionsRef],\n  );\n\n  // Build a visibleIndex lookup map to avoid O(n²) findIndex inside render loop\n  const visibleIndexMap = useMemo(() => {\n    const map = new Map<string, number>();\n\n    visibleItems.forEach((item, index) => {\n      map.set(getItemId(item), index);\n    });\n\n    return map;\n  }, [visibleItems]);\n\n  if (allItems.length === 0) return null;\n\n  return (\n    <Portal>\n      <OverlayContainerElement\n        ref={containerRef}\n        onFocus={handleFocus}\n        onBlur={handleBlur}\n      >\n        {allItems.map((item) => {\n          const itemId = getItemId(item);\n          const visibleIndex = visibleIndexMap.get(itemId) ?? 0;\n          const isExiting = isItemExiting(item);\n\n          return (\n            <DisplayTransition\n              key={itemId}\n              animateOnMount\n              isShown={!isExiting}\n              onRest={(transition) => {\n                if (transition === 'exit') {\n                  handleExitComplete(item);\n                }\n              }}\n            >\n              {({ isShown, ref }) => (\n                <OverlayItemWrapper\n                  ref={createRefCallback(itemId, ref)}\n                  mods={{ isShown, isMeasured: settledIds.has(itemId) }}\n                  style={getItemStyle(item, visibleIndex, visibleItems.length)}\n                  onMouseEnter={handleMouseEnter}\n                  onMouseLeave={handleMouseLeave}\n                >\n                  {item.kind === 'toast' ? (\n                    <ToastItem\n                      {...item.data.itemProps}\n                      title={item.data.title}\n                      description={item.data.description}\n                      theme={item.data.theme}\n                      icon={item.data.icon}\n                      isLoading={item.data.isLoading}\n                      actions={item.data.actions}\n                    />\n                  ) : (\n                    <NotificationItem\n                      notification={item.data}\n                      onDismiss={handleNotificationDismiss}\n                      onRestore={onNotificationRestore}\n                    />\n                  )}\n                </OverlayItemWrapper>\n              )}\n            </DisplayTransition>\n          );\n        })}\n      </OverlayContainerElement>\n    </Portal>\n  );\n}\n"],"mappings":"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"}

package/dist/components/overlays/Notifications/OverlayProvider.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { NotificationContext, PersistentNotificationsContext, ToastContext, useNotificationContext, useToastContext } from "./NotificationContext.js";
 import { OverlayContainer } from "./OverlayContainer.js";
 import { useNotificationState } from "./use-notification-state.js";
@@ -56,6 +56,7 @@ function OverlayProvider({ children, maxPersistentNotifications = DEFAULT_MAX_PE
 					onToastExitComplete: toast.finalizeToastRemoval,
 					onNotificationExitComplete: notification.finalizeNotificationRemoval,
 					onNotificationDismiss: notification.removeNotification,
+					onNotificationRestore: notification.restoreNotification,
 					onPauseChange: timers.handlePauseChange
 				})]
 			})

package/dist/components/overlays/Notifications/OverlayProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayProvider.js","names":[],"sources":["../../../../src/components/overlays/Notifications/OverlayProvider.tsx"],"sourcesContent":["import { useMemo, useRef } from 'react';\n\nimport {\n  NotificationContext,\n  PersistentNotificationsContext,\n  ToastContext,\n} from './NotificationContext';\nimport { OverlayContainer } from './OverlayContainer';\nimport { useNotificationState } from './use-notification-state';\nimport { useOverlayTimers } from './use-overlay-timers';\nimport { usePersistentState } from './use-persistent-state';\nimport { useToastState } from './use-toast-state';\n\nimport type { ToastContextValue } from '../Toast/types';\nimport type {\n  InternalNotificationContextValue,\n  OverlayProviderProps,\n  PersistentNotificationsContextValue,\n} from './types';\nimport type { OverlayTimers } from './use-overlay-timers';\n\n// ─── Re-export context hooks for consumers ───────────────────────────\n\nexport { useToastContext, useNotificationContext } from './NotificationContext';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst DEFAULT_MAX_PERSISTENT = 200;\n\n// ─── OverlayProvider ─────────────────────────────────────────────────\n\nexport function OverlayProvider({\n  children,\n  maxPersistentNotifications = DEFAULT_MAX_PERSISTENT,\n}: OverlayProviderProps) {\n  // Shared ref that breaks the circular dependency between state hooks and timers.\n  // State hooks need timer methods (start/clear), timer hooks need remove methods.\n  // All consumers access the ref only inside useEvent/callbacks (never during\n  // render), so it is guaranteed to be populated before first use.\n  const timersRef = useRef<OverlayTimers>(null!);\n\n  // 1. Persistent state (no dependencies on other hooks)\n  const persistent = usePersistentState(maxPersistentNotifications);\n\n  // 2. Toast state — accesses timers through the shared ref\n  const toast = useToastState(timersRef);\n\n  // 3. Notification state — accesses timers through the shared ref\n  const notification = useNotificationState(timersRef, persistent);\n\n  // 4. Create timers and populate the ref\n  const timers = useOverlayTimers({\n    toastsRef: toast.toastsRef,\n    notificationsRef: notification.notificationsRef,\n    removeToast: toast.removeToast,\n    removeNotification: notification.removeNotification,\n  });\n\n  timersRef.current = timers;\n\n  // ─── Context Values ───────────────────────────────────────────────\n\n  // Only include actually-changing values in deps. All useEvent-based\n  // callbacks are referentially stable and omitted.\n  const toastContextValue = useMemo<ToastContextValue>(\n    () => ({\n      addToast: toast.addToast,\n      removeToast: toast.removeToast,\n      updateToast: toast.updateToast,\n      toasts: toast.toasts,\n    }),\n    [toast.toasts],\n  );\n\n  const notificationContextValue = useMemo<InternalNotificationContextValue>(\n    () => ({\n      addNotification: notification.addNotification,\n      removeNotification: notification.removeNotification,\n      updateNotification: notification.updateNotification,\n      notifications: notification.notifications,\n      addPersistentItem: persistent.addPersistentItem,\n      removePersistentItem: persistent.removePersistentItem,\n      removePersistentItemsByOwner: persistent.removePersistentItemsByOwner,\n      removeByOwner: notification.removeByOwner,\n    }),\n    [notification.notifications],\n  );\n\n  const persistentContextValue = useMemo<PersistentNotificationsContextValue>(\n    () => ({\n      persistentItems: persistent.persistentItems,\n      removePersistentItem: persistent.removePersistentItem,\n      clearPersistentItems: persistent.clearPersistentItems,\n      markAllAsRead: persistent.markAllAsRead,\n    }),\n    [persistent.persistentItems],\n  );\n\n  return (\n    <ToastContext.Provider value={toastContextValue}>\n      <NotificationContext.Provider value={notificationContextValue}>\n        <PersistentNotificationsContext.Provider value={persistentContextValue}>\n          {children}\n          <OverlayContainer\n            toasts={toast.toasts}\n            notifications={notification.notifications}\n            onToastExitComplete={toast.finalizeToastRemoval}\n            onNotificationExitComplete={\n              notification.finalizeNotificationRemoval\n            }\n            onNotificationDismiss={notification.removeNotification}\n            onPauseChange={timers.handlePauseChange}\n          />\n        </PersistentNotificationsContext.Provider>\n      </NotificationContext.Provider>\n    </ToastContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;AA2BA,MAAM,yBAAyB;AAI/B,SAAgB,gBAAgB,EAC9B,UACA,6BAA6B,0BACN;CAKvB,MAAM,YAAY,OAAsB,KAAM;CAG9C,MAAM,aAAa,mBAAmB,2BAA2B;CAGjE,MAAM,QAAQ,cAAc,UAAU;CAGtC,MAAM,eAAe,qBAAqB,WAAW,WAAW;CAGhE,MAAM,SAAS,iBAAiB;EAC9B,WAAW,MAAM;EACjB,kBAAkB,aAAa;EAC/B,aAAa,MAAM;EACnB,oBAAoB,aAAa;EAClC,CAAC;AAEF,WAAU,UAAU;CAMpB,MAAM,oBAAoB,eACjB;EACL,UAAU,MAAM;EAChB,aAAa,MAAM;EACnB,aAAa,MAAM;EACnB,QAAQ,MAAM;EACf,GACD,CAAC,MAAM,OAAO,CACf;CAED,MAAM,2BAA2B,eACxB;EACL,iBAAiB,aAAa;EAC9B,oBAAoB,aAAa;EACjC,oBAAoB,aAAa;EACjC,eAAe,aAAa;EAC5B,mBAAmB,WAAW;EAC9B,sBAAsB,WAAW;EACjC,8BAA8B,WAAW;EACzC,eAAe,aAAa;EAC7B,GACD,CAAC,aAAa,cAAc,CAC7B;CAED,MAAM,yBAAyB,eACtB;EACL,iBAAiB,WAAW;EAC5B,sBAAsB,WAAW;EACjC,sBAAsB,WAAW;EACjC,eAAe,WAAW;EAC3B,GACD,CAAC,WAAW,gBAAgB,CAC7B;AAED,QACE,oBAAC,aAAa;EAAS,OAAO;YAC5B,oBAAC,oBAAoB;GAAS,OAAO;aACnC,qBAAC,+BAA+B;IAAS,OAAO;eAC7C,UACD,oBAAC;KACC,QAAQ,MAAM;KACd,eAAe,aAAa;KAC5B,qBAAqB,MAAM;KAC3B,4BACE,aAAa;KAEf,uBAAuB,aAAa;KACpC,eAAe,OAAO;MACtB;KACsC;IACb;GACT"}
+{"version":3,"file":"OverlayProvider.js","names":[],"sources":["../../../../src/components/overlays/Notifications/OverlayProvider.tsx"],"sourcesContent":["import { useMemo, useRef } from 'react';\n\nimport {\n  NotificationContext,\n  PersistentNotificationsContext,\n  ToastContext,\n} from './NotificationContext';\nimport { OverlayContainer } from './OverlayContainer';\nimport { useNotificationState } from './use-notification-state';\nimport { useOverlayTimers } from './use-overlay-timers';\nimport { usePersistentState } from './use-persistent-state';\nimport { useToastState } from './use-toast-state';\n\nimport type { ToastContextValue } from '../Toast/types';\nimport type {\n  InternalNotificationContextValue,\n  OverlayProviderProps,\n  PersistentNotificationsContextValue,\n} from './types';\nimport type { OverlayTimers } from './use-overlay-timers';\n\n// ─── Re-export context hooks for consumers ───────────────────────────\n\nexport { useToastContext, useNotificationContext } from './NotificationContext';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst DEFAULT_MAX_PERSISTENT = 200;\n\n// ─── OverlayProvider ─────────────────────────────────────────────────\n\nexport function OverlayProvider({\n  children,\n  maxPersistentNotifications = DEFAULT_MAX_PERSISTENT,\n}: OverlayProviderProps) {\n  // Shared ref that breaks the circular dependency between state hooks and timers.\n  // State hooks need timer methods (start/clear), timer hooks need remove methods.\n  // All consumers access the ref only inside useEvent/callbacks (never during\n  // render), so it is guaranteed to be populated before first use.\n  const timersRef = useRef<OverlayTimers>(null!);\n\n  // 1. Persistent state (no dependencies on other hooks)\n  const persistent = usePersistentState(maxPersistentNotifications);\n\n  // 2. Toast state — accesses timers through the shared ref\n  const toast = useToastState(timersRef);\n\n  // 3. Notification state — accesses timers through the shared ref\n  const notification = useNotificationState(timersRef, persistent);\n\n  // 4. Create timers and populate the ref\n  const timers = useOverlayTimers({\n    toastsRef: toast.toastsRef,\n    notificationsRef: notification.notificationsRef,\n    removeToast: toast.removeToast,\n    removeNotification: notification.removeNotification,\n  });\n\n  timersRef.current = timers;\n\n  // ─── Context Values ───────────────────────────────────────────────\n\n  // Only include actually-changing values in deps. All useEvent-based\n  // callbacks are referentially stable and omitted.\n  const toastContextValue = useMemo<ToastContextValue>(\n    () => ({\n      addToast: toast.addToast,\n      removeToast: toast.removeToast,\n      updateToast: toast.updateToast,\n      toasts: toast.toasts,\n    }),\n    [toast.toasts],\n  );\n\n  const notificationContextValue = useMemo<InternalNotificationContextValue>(\n    () => ({\n      addNotification: notification.addNotification,\n      removeNotification: notification.removeNotification,\n      updateNotification: notification.updateNotification,\n      notifications: notification.notifications,\n      addPersistentItem: persistent.addPersistentItem,\n      removePersistentItem: persistent.removePersistentItem,\n      removePersistentItemsByOwner: persistent.removePersistentItemsByOwner,\n      removeByOwner: notification.removeByOwner,\n    }),\n    [notification.notifications],\n  );\n\n  const persistentContextValue = useMemo<PersistentNotificationsContextValue>(\n    () => ({\n      persistentItems: persistent.persistentItems,\n      removePersistentItem: persistent.removePersistentItem,\n      clearPersistentItems: persistent.clearPersistentItems,\n      markAllAsRead: persistent.markAllAsRead,\n    }),\n    [persistent.persistentItems],\n  );\n\n  return (\n    <ToastContext.Provider value={toastContextValue}>\n      <NotificationContext.Provider value={notificationContextValue}>\n        <PersistentNotificationsContext.Provider value={persistentContextValue}>\n          {children}\n          <OverlayContainer\n            toasts={toast.toasts}\n            notifications={notification.notifications}\n            onToastExitComplete={toast.finalizeToastRemoval}\n            onNotificationExitComplete={\n              notification.finalizeNotificationRemoval\n            }\n            onNotificationDismiss={notification.removeNotification}\n            onNotificationRestore={notification.restoreNotification}\n            onPauseChange={timers.handlePauseChange}\n          />\n        </PersistentNotificationsContext.Provider>\n      </NotificationContext.Provider>\n    </ToastContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;AA2BA,MAAM,yBAAyB;AAI/B,SAAgB,gBAAgB,EAC9B,UACA,6BAA6B,0BACN;CAKvB,MAAM,YAAY,OAAsB,KAAM;CAG9C,MAAM,aAAa,mBAAmB,2BAA2B;CAGjE,MAAM,QAAQ,cAAc,UAAU;CAGtC,MAAM,eAAe,qBAAqB,WAAW,WAAW;CAGhE,MAAM,SAAS,iBAAiB;EAC9B,WAAW,MAAM;EACjB,kBAAkB,aAAa;EAC/B,aAAa,MAAM;EACnB,oBAAoB,aAAa;EAClC,CAAC;AAEF,WAAU,UAAU;CAMpB,MAAM,oBAAoB,eACjB;EACL,UAAU,MAAM;EAChB,aAAa,MAAM;EACnB,aAAa,MAAM;EACnB,QAAQ,MAAM;EACf,GACD,CAAC,MAAM,OAAO,CACf;CAED,MAAM,2BAA2B,eACxB;EACL,iBAAiB,aAAa;EAC9B,oBAAoB,aAAa;EACjC,oBAAoB,aAAa;EACjC,eAAe,aAAa;EAC5B,mBAAmB,WAAW;EAC9B,sBAAsB,WAAW;EACjC,8BAA8B,WAAW;EACzC,eAAe,aAAa;EAC7B,GACD,CAAC,aAAa,cAAc,CAC7B;CAED,MAAM,yBAAyB,eACtB;EACL,iBAAiB,WAAW;EAC5B,sBAAsB,WAAW;EACjC,sBAAsB,WAAW;EACjC,eAAe,WAAW;EAC3B,GACD,CAAC,WAAW,gBAAgB,CAC7B;AAED,QACE,oBAAC,aAAa;EAAS,OAAO;YAC5B,oBAAC,oBAAoB;GAAS,OAAO;aACnC,qBAAC,+BAA+B;IAAS,OAAO;eAC7C,UACD,oBAAC;KACC,QAAQ,MAAM;KACd,eAAe,aAAa;KAC5B,qBAAqB,MAAM;KAC3B,4BACE,aAAa;KAEf,uBAAuB,aAAa;KACpC,uBAAuB,aAAa;KACpC,eAAe,OAAO;MACtB;KACsC;IACb;GACT"}

package/dist/components/overlays/Notifications/PersistentNotificationsList.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { tasty } from "../../../tasty/tasty.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { _Text } from "../../content/Text.js";
@@ -106,7 +106,7 @@ function PersistentNotificationListItem({ item, onDismiss }) {
 			description: item.description,
 			icon: item.icon,
 			actions: item.actions,
-			isDismissible: !!onDismiss,
+			isDismissable: !!onDismiss,
 			elevated: false,
 			notificationId: item.id,
 			suffix,

package/dist/components/overlays/Notifications/PersistentNotificationsList.js.map

@@ -1 +1 @@
-{"version":3,"file":"PersistentNotificationsList.js","names":["Text"],"sources":["../../../../src/components/overlays/Notifications/PersistentNotificationsList.tsx"],"sourcesContent":["import { Fragment, Key, useContext, useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { tasty } from '../../../tasty';\nimport { Divider } from '../../content/Divider';\nimport { Text } from '../../content/Text';\n\nimport { formatRelativeTime } from './format-relative-time';\nimport { NotificationActionInterceptorContext } from './NotificationAction';\nimport { NotificationCard } from './NotificationCard';\nimport { usePersistentNotifications } from './use-persistent-notifications';\n\nimport type {\n  DismissReason,\n  PersistentNotificationItem,\n  PersistentNotificationsListProps,\n} from './types';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst MARK_READ_DELAY = 2000;\n/** Interval (ms) at which relative timestamps refresh while the list is mounted. */\nconst TIMESTAMP_REFRESH_INTERVAL = 10_000;\n\n// ─── Styled Components ──────────────────────────────────────────────\n\nconst ListContainer = tasty({\n  qa: 'PersistentNotificationsList',\n  role: 'log',\n  'aria-label': 'Notifications',\n  styles: {\n    display: 'flex',\n    flow: 'column',\n  },\n});\n\nconst EmptyStateContainer = tasty({\n  styles: {\n    display: 'flex',\n    placeItems: 'center',\n    placeContent: 'center',\n    padding: '4x',\n    color: '#dark.5',\n    preset: 't3',\n  },\n});\n\n// ─── PersistentNotificationsList Component ───────────────────────────\n\n/**\n * Standardized rendering for archived/persistent notifications.\n * Always reads items from the notification context.\n * Composable with app-specific shells (popover, dialog, page section).\n *\n * Marks all items as read after being visible for 2 seconds.\n * Relative timestamps refresh every 10 seconds while the list is mounted.\n *\n * Items are always dismissible. Dismissing an item removes it from the\n * persistent list and marks its ID as \"fully dismissed\" — subsequent triggers\n * with the same ID will be completely ignored (no overlay, no re-archival).\n *\n * @example\n * ```tsx\n * <PersistentNotificationsList emptyState=\"No notifications\" />\n * ```\n */\nexport function PersistentNotificationsList({\n  onDismissItem,\n  onAction,\n  emptyState,\n}: PersistentNotificationsListProps) {\n  const { items, remove, markAllAsRead } = usePersistentNotifications();\n\n  // Default dismiss handler removes the item from the persistent list (which\n  // also marks the id as \"fully dismissed\" so it won't reappear).\n  // If a consumer provides `onDismissItem`, it is called *after* the built-in removal.\n  const handleDismiss = useEvent((item: PersistentNotificationItem) => {\n    remove(item.id);\n    onDismissItem?.(item);\n  });\n  const markReadTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Tick counter that increments every TIMESTAMP_REFRESH_INTERVAL to force\n  // re-render so relative timestamps (e.g. \"5 min ago\") stay up to date.\n  const [, setTick] = useState(0);\n\n  useEffect(() => {\n    if (items.length === 0) return;\n\n    const interval = setInterval(() => {\n      setTick((t) => t + 1);\n    }, TIMESTAMP_REFRESH_INTERVAL);\n\n    return () => clearInterval(interval);\n  }, [items.length]);\n\n  // Mark all persistent notifications as read after a 2s delay.\n  // Re-starts the timer whenever items change (e.g. new unread items arrive\n  // while the list is already visible).\n  useEffect(() => {\n    const hasUnread = items.some((i) => !i.isRead);\n\n    if (!hasUnread) return;\n\n    markReadTimerRef.current = setTimeout(() => {\n      markAllAsRead();\n    }, MARK_READ_DELAY);\n\n    return () => {\n      if (markReadTimerRef.current) {\n        clearTimeout(markReadTimerRef.current);\n        markReadTimerRef.current = null;\n      }\n    };\n  }, [markAllAsRead, items]);\n\n  if (items.length === 0) {\n    return (\n      <ListContainer>\n        <EmptyStateContainer>\n          {emptyState ?? 'No notifications'}\n        </EmptyStateContainer>\n      </ListContainer>\n    );\n  }\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={onAction ?? null}>\n      <ListContainer>\n        {items.map((item, index) => (\n          <Fragment key={String(item.id)}>\n            {index > 0 && <Divider />}\n            <PersistentNotificationListItem\n              item={item}\n              onDismiss={handleDismiss}\n            />\n          </Fragment>\n        ))}\n      </ListContainer>\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n\n// ─── List Item ───────────────────────────────────────────────────────\n\ninterface PersistentNotificationListItemProps {\n  item: PersistentNotificationItem;\n  onDismiss?: (item: PersistentNotificationItem) => void;\n}\n\nfunction PersistentNotificationListItem({\n  item,\n  onDismiss,\n}: PersistentNotificationListItemProps) {\n  const suffix = (\n    <Text opacity={0.5} preset=\"c2\">\n      {formatRelativeTime(item.createdAt)}\n    </Text>\n  );\n\n  // useEvent keeps the callback stable across re-renders regardless of\n  // item reference changes (avoids unnecessary NotificationCard re-renders).\n  const handleDismiss = useEvent((_id: Key, _reason: DismissReason) => {\n    onDismiss?.(item);\n  });\n\n  const parentInterceptor = useContext(NotificationActionInterceptorContext);\n\n  // Chains with the list-level interceptor (e.g. closing the parent popover).\n  // Dismissal itself is handled by NotificationAction via the dismiss context\n  // to avoid double-firing onDismiss.\n  const handleItemAction = useEvent(() => {\n    parentInterceptor?.();\n  });\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={handleItemAction}>\n      <NotificationCard\n        qa=\"PersistentNotificationItem\"\n        theme={item.theme}\n        title={item.title}\n        description={item.description}\n        icon={item.icon}\n        actions={item.actions}\n        isDismissible={!!onDismiss}\n        elevated={false}\n        notificationId={item.id}\n        suffix={suffix}\n        onDismiss={onDismiss ? handleDismiss : undefined}\n      />\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,MAAM,kBAAkB;;AAExB,MAAM,6BAA6B;AAInC,MAAM,gBAAgB,MAAM;CAC1B,IAAI;CACJ,MAAM;CACN,cAAc;CACd,QAAQ;EACN,SAAS;EACT,MAAM;EACP;CACF,CAAC;AAEF,MAAM,sBAAsB,MAAM,EAChC,QAAQ;CACN,SAAS;CACT,YAAY;CACZ,cAAc;CACd,SAAS;CACT,OAAO;CACP,QAAQ;CACT,EACF,CAAC;;;;;;;;;;;;;;;;;;AAqBF,SAAgB,4BAA4B,EAC1C,eACA,UACA,cACmC;CACnC,MAAM,EAAE,OAAO,QAAQ,kBAAkB,4BAA4B;CAKrE,MAAM,gBAAgB,UAAU,SAAqC;AACnE,SAAO,KAAK,GAAG;AACf,kBAAgB,KAAK;GACrB;CACF,MAAM,mBAAmB,OAA6C,KAAK;CAI3E,MAAM,GAAG,WAAW,SAAS,EAAE;AAE/B,iBAAgB;AACd,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,WAAW,kBAAkB;AACjC,YAAS,MAAM,IAAI,EAAE;KACpB,2BAA2B;AAE9B,eAAa,cAAc,SAAS;IACnC,CAAC,MAAM,OAAO,CAAC;AAKlB,iBAAgB;AAGd,MAAI,CAFc,MAAM,MAAM,MAAM,CAAC,EAAE,OAAO,CAE9B;AAEhB,mBAAiB,UAAU,iBAAiB;AAC1C,kBAAe;KACd,gBAAgB;AAEnB,eAAa;AACX,OAAI,iBAAiB,SAAS;AAC5B,iBAAa,iBAAiB,QAAQ;AACtC,qBAAiB,UAAU;;;IAG9B,CAAC,eAAe,MAAM,CAAC;AAE1B,KAAI,MAAM,WAAW,EACnB,QACE,oBAAC,2BACC,oBAAC,iCACE,cAAc,qBACK,GACR;AAIpB,QACE,oBAAC,qCAAqC;EAAS,OAAO,YAAY;YAChE,oBAAC,2BACE,MAAM,KAAK,MAAM,UAChB,qBAAC,uBACE,QAAQ,KAAK,oBAAC,YAAU,EACzB,oBAAC;GACO;GACN,WAAW;IACX,KALW,OAAO,KAAK,GAAG,CAMnB,CACX,GACY;GAC8B;;AAWpD,SAAS,+BAA+B,EACtC,MACA,aACsC;CACtC,MAAM,SACJ,oBAACA;EAAK,SAAS;EAAK,QAAO;YACxB,mBAAmB,KAAK,UAAU;GAC9B;CAKT,MAAM,gBAAgB,UAAU,KAAU,YAA2B;AACnE,cAAY,KAAK;GACjB;CAEF,MAAM,oBAAoB,WAAW,qCAAqC;CAK1E,MAAM,mBAAmB,eAAe;AACtC,uBAAqB;GACrB;AAEF,QACE,oBAAC,qCAAqC;EAAS,OAAO;YACpD,oBAAC;GACC,IAAG;GACH,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,MAAM,KAAK;GACX,SAAS,KAAK;GACd,eAAe,CAAC,CAAC;GACjB,UAAU;GACV,gBAAgB,KAAK;GACb;GACR,WAAW,YAAY,gBAAgB;IACvC;GAC4C"}
+{"version":3,"file":"PersistentNotificationsList.js","names":["Text"],"sources":["../../../../src/components/overlays/Notifications/PersistentNotificationsList.tsx"],"sourcesContent":["import { Fragment, Key, useContext, useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { tasty } from '../../../tasty';\nimport { Divider } from '../../content/Divider';\nimport { Text } from '../../content/Text';\n\nimport { formatRelativeTime } from './format-relative-time';\nimport { NotificationActionInterceptorContext } from './NotificationAction';\nimport { NotificationCard } from './NotificationCard';\nimport { usePersistentNotifications } from './use-persistent-notifications';\n\nimport type {\n  DismissReason,\n  PersistentNotificationItem,\n  PersistentNotificationsListProps,\n} from './types';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst MARK_READ_DELAY = 2000;\n/** Interval (ms) at which relative timestamps refresh while the list is mounted. */\nconst TIMESTAMP_REFRESH_INTERVAL = 10_000;\n\n// ─── Styled Components ──────────────────────────────────────────────\n\nconst ListContainer = tasty({\n  qa: 'PersistentNotificationsList',\n  role: 'log',\n  'aria-label': 'Notifications',\n  styles: {\n    display: 'flex',\n    flow: 'column',\n  },\n});\n\nconst EmptyStateContainer = tasty({\n  styles: {\n    display: 'flex',\n    placeItems: 'center',\n    placeContent: 'center',\n    padding: '4x',\n    color: '#dark.5',\n    preset: 't3',\n  },\n});\n\n// ─── PersistentNotificationsList Component ───────────────────────────\n\n/**\n * Standardized rendering for archived/persistent notifications.\n * Always reads items from the notification context.\n * Composable with app-specific shells (popover, dialog, page section).\n *\n * Marks all items as read after being visible for 2 seconds.\n * Relative timestamps refresh every 10 seconds while the list is mounted.\n *\n * Items are always dismissible. Dismissing an item removes it from the\n * persistent list and marks its ID as \"fully dismissed\" — subsequent triggers\n * with the same ID will be completely ignored (no overlay, no re-archival).\n *\n * @example\n * ```tsx\n * <PersistentNotificationsList emptyState=\"No notifications\" />\n * ```\n */\nexport function PersistentNotificationsList({\n  onDismissItem,\n  onAction,\n  emptyState,\n}: PersistentNotificationsListProps) {\n  const { items, remove, markAllAsRead } = usePersistentNotifications();\n\n  // Default dismiss handler removes the item from the persistent list (which\n  // also marks the id as \"fully dismissed\" so it won't reappear).\n  // If a consumer provides `onDismissItem`, it is called *after* the built-in removal.\n  const handleDismiss = useEvent((item: PersistentNotificationItem) => {\n    remove(item.id);\n    onDismissItem?.(item);\n  });\n  const markReadTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Tick counter that increments every TIMESTAMP_REFRESH_INTERVAL to force\n  // re-render so relative timestamps (e.g. \"5 min ago\") stay up to date.\n  const [, setTick] = useState(0);\n\n  useEffect(() => {\n    if (items.length === 0) return;\n\n    const interval = setInterval(() => {\n      setTick((t) => t + 1);\n    }, TIMESTAMP_REFRESH_INTERVAL);\n\n    return () => clearInterval(interval);\n  }, [items.length]);\n\n  // Mark all persistent notifications as read after a 2s delay.\n  // Re-starts the timer whenever items change (e.g. new unread items arrive\n  // while the list is already visible).\n  useEffect(() => {\n    const hasUnread = items.some((i) => !i.isRead);\n\n    if (!hasUnread) return;\n\n    markReadTimerRef.current = setTimeout(() => {\n      markAllAsRead();\n    }, MARK_READ_DELAY);\n\n    return () => {\n      if (markReadTimerRef.current) {\n        clearTimeout(markReadTimerRef.current);\n        markReadTimerRef.current = null;\n      }\n    };\n  }, [markAllAsRead, items]);\n\n  if (items.length === 0) {\n    return (\n      <ListContainer>\n        <EmptyStateContainer>\n          {emptyState ?? 'No notifications'}\n        </EmptyStateContainer>\n      </ListContainer>\n    );\n  }\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={onAction ?? null}>\n      <ListContainer>\n        {items.map((item, index) => (\n          <Fragment key={String(item.id)}>\n            {index > 0 && <Divider />}\n            <PersistentNotificationListItem\n              item={item}\n              onDismiss={handleDismiss}\n            />\n          </Fragment>\n        ))}\n      </ListContainer>\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n\n// ─── List Item ───────────────────────────────────────────────────────\n\ninterface PersistentNotificationListItemProps {\n  item: PersistentNotificationItem;\n  onDismiss?: (item: PersistentNotificationItem) => void;\n}\n\nfunction PersistentNotificationListItem({\n  item,\n  onDismiss,\n}: PersistentNotificationListItemProps) {\n  const suffix = (\n    <Text opacity={0.5} preset=\"c2\">\n      {formatRelativeTime(item.createdAt)}\n    </Text>\n  );\n\n  // useEvent keeps the callback stable across re-renders regardless of\n  // item reference changes (avoids unnecessary NotificationCard re-renders).\n  const handleDismiss = useEvent((_id: Key, _reason: DismissReason) => {\n    onDismiss?.(item);\n  });\n\n  const parentInterceptor = useContext(NotificationActionInterceptorContext);\n\n  // Chains with the list-level interceptor (e.g. closing the parent popover).\n  // Dismissal itself is handled by NotificationAction via the dismiss context\n  // to avoid double-firing onDismiss.\n  const handleItemAction = useEvent(() => {\n    parentInterceptor?.();\n  });\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={handleItemAction}>\n      <NotificationCard\n        qa=\"PersistentNotificationItem\"\n        theme={item.theme}\n        title={item.title}\n        description={item.description}\n        icon={item.icon}\n        actions={item.actions}\n        isDismissable={!!onDismiss}\n        elevated={false}\n        notificationId={item.id}\n        suffix={suffix}\n        onDismiss={onDismiss ? handleDismiss : undefined}\n      />\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,MAAM,kBAAkB;;AAExB,MAAM,6BAA6B;AAInC,MAAM,gBAAgB,MAAM;CAC1B,IAAI;CACJ,MAAM;CACN,cAAc;CACd,QAAQ;EACN,SAAS;EACT,MAAM;EACP;CACF,CAAC;AAEF,MAAM,sBAAsB,MAAM,EAChC,QAAQ;CACN,SAAS;CACT,YAAY;CACZ,cAAc;CACd,SAAS;CACT,OAAO;CACP,QAAQ;CACT,EACF,CAAC;;;;;;;;;;;;;;;;;;AAqBF,SAAgB,4BAA4B,EAC1C,eACA,UACA,cACmC;CACnC,MAAM,EAAE,OAAO,QAAQ,kBAAkB,4BAA4B;CAKrE,MAAM,gBAAgB,UAAU,SAAqC;AACnE,SAAO,KAAK,GAAG;AACf,kBAAgB,KAAK;GACrB;CACF,MAAM,mBAAmB,OAA6C,KAAK;CAI3E,MAAM,GAAG,WAAW,SAAS,EAAE;AAE/B,iBAAgB;AACd,MAAI,MAAM,WAAW,EAAG;EAExB,MAAM,WAAW,kBAAkB;AACjC,YAAS,MAAM,IAAI,EAAE;KACpB,2BAA2B;AAE9B,eAAa,cAAc,SAAS;IACnC,CAAC,MAAM,OAAO,CAAC;AAKlB,iBAAgB;AAGd,MAAI,CAFc,MAAM,MAAM,MAAM,CAAC,EAAE,OAAO,CAE9B;AAEhB,mBAAiB,UAAU,iBAAiB;AAC1C,kBAAe;KACd,gBAAgB;AAEnB,eAAa;AACX,OAAI,iBAAiB,SAAS;AAC5B,iBAAa,iBAAiB,QAAQ;AACtC,qBAAiB,UAAU;;;IAG9B,CAAC,eAAe,MAAM,CAAC;AAE1B,KAAI,MAAM,WAAW,EACnB,QACE,oBAAC,2BACC,oBAAC,iCACE,cAAc,qBACK,GACR;AAIpB,QACE,oBAAC,qCAAqC;EAAS,OAAO,YAAY;YAChE,oBAAC,2BACE,MAAM,KAAK,MAAM,UAChB,qBAAC,uBACE,QAAQ,KAAK,oBAAC,YAAU,EACzB,oBAAC;GACO;GACN,WAAW;IACX,KALW,OAAO,KAAK,GAAG,CAMnB,CACX,GACY;GAC8B;;AAWpD,SAAS,+BAA+B,EACtC,MACA,aACsC;CACtC,MAAM,SACJ,oBAACA;EAAK,SAAS;EAAK,QAAO;YACxB,mBAAmB,KAAK,UAAU;GAC9B;CAKT,MAAM,gBAAgB,UAAU,KAAU,YAA2B;AACnE,cAAY,KAAK;GACjB;CAEF,MAAM,oBAAoB,WAAW,qCAAqC;CAK1E,MAAM,mBAAmB,eAAe;AACtC,uBAAqB;GACrB;AAEF,QACE,oBAAC,qCAAqC;EAAS,OAAO;YACpD,oBAAC;GACC,IAAG;GACH,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,MAAM,KAAK;GACX,SAAS,KAAK;GACd,eAAe,CAAC,CAAC;GACjB,UAAU;GACV,gBAAgB,KAAK;GACb;GACR,WAAW,YAAY,gBAAgB;IACvC;GAC4C"}

package/dist/components/overlays/Notifications/dismissed-storage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 //#region src/components/overlays/Notifications/dismissed-storage.ts
 const STORAGE_KEY = "cube-ui-dismissed-notifications";
 const TTL_MS = 864e5;

package/dist/components/overlays/Notifications/format-relative-time.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 //#region src/components/overlays/Notifications/format-relative-time.ts
 /**
 * Lightweight relative time formatter.

package/dist/components/overlays/Notifications/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { useToastContext } from "./NotificationContext.js";
 import { NotificationAction } from "./NotificationAction.js";
 import { NotificationCard } from "./NotificationCard.js";

package/dist/components/overlays/Notifications/types.d.ts

@@ -16,7 +16,7 @@ interface OverlayNotificationOptions extends NotificationBaseOptions {
    * Action buttons rendered below the notification description.
    * A default "Dismiss" button is auto-appended unless any action has
    * `isDismiss` set (detected automatically via context).
-   * When omitted, only the default "Dismiss" button is shown (if `isDismissible`).
+   * When omitted, only the default "Dismiss" button is shown (if `isDismissable`).
    */
   actions?: ReactNode;
   /**
@@ -29,7 +29,7 @@ interface OverlayNotificationOptions extends NotificationBaseOptions {
    *
    * Default: true
    */
-  isDismissible?: boolean;
+  isDismissable?: boolean;
   /**
    * Duration in ms before auto-dismiss.
    * Default: 3000ms (non-persistent) or 5000ms (persistent).
@@ -101,6 +101,8 @@ interface InternalNotification extends OverlayNotificationOptions {
   createdAt: number;
   updatedAt: number;
   isExiting?: boolean;
+  /** Reason for the most recent dismiss, used to undo persistent side effects on restore. */
+  lastDismissReason?: DismissReason;
   ownerId?: string;
 }
 interface PersistentNotificationItem {

package/dist/components/overlays/Notifications/use-notification-state.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.118.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useRef, useState } from "react";
 
@@ -6,6 +6,8 @@ import { useRef, useState } from "react";
 const DEFAULT_NOTIFICATION_DURATION = 3e3;
 const DEFAULT_PERSISTENT_NOTIFICATION_DURATION = 5e3;
 const MAX_NOTIFICATIONS = 5;
+const MAX_DISMISS_SNAPSHOTS = 50;
+const SNAPSHOT_TTL_MS = 300 * 1e3;
 function getDuration(notif) {
 	if (notif.duration === null) return null;
 	if (notif.duration !== void 0) return notif.duration;
@@ -26,6 +28,7 @@ function useNotificationState(timersRef, persistent) {
 	const notificationsRef = useRef(notifications);
 	notificationsRef.current = notifications;
 	const idCounter = useRef(0);
+	const dismissSnapshotsRef = useRef(/* @__PURE__ */ new Map());
 	/**
 	* Evict the oldest active notification to make room for a new one.
 	* Clears its timer and moves it to the persistent list if applicable.
@@ -54,6 +57,15 @@ function useNotificationState(timersRef, persistent) {
 		const notif = findNotification(notificationsRef.current, id);
 		if (!notif || notif.isExiting) return;
 		timersRef.current?.clearNotificationTimer(notif.internalId);
+		dismissSnapshotsRef.current.set(String(notif.id ?? notif.internalId), {
+			...notif,
+			lastDismissReason: reason
+		});
+		while (dismissSnapshotsRef.current.size > MAX_DISMISS_SNAPSHOTS) {
+			const oldest = dismissSnapshotsRef.current.keys().next().value;
+			if (oldest != null) dismissSnapshotsRef.current.delete(oldest);
+			else break;
+		}
 		if (notif.persistent) {
 			if (reason === "close" || reason === "timeout") persistent.addPersistentItem({
 				id: notif.id ?? notif.internalId,
@@ -74,11 +86,44 @@ function useNotificationState(timersRef, persistent) {
 		}
 		setNotifications((prev) => prev.map((n) => matchesNotificationId(n, id) ? {
 			...n,
-			isExiting: true
+			isExiting: true,
+			lastDismissReason: reason
 		} : n));
 	});
+	const restoreNotification = useEvent((id) => {
+		const idStr = String(id);
+		const snapshot = dismissSnapshotsRef.current.get(idStr);
+		if (!snapshot) return;
+		dismissSnapshotsRef.current.delete(idStr);
+		if (snapshot.persistent && snapshot.lastDismissReason) {
+			const persistentId = snapshot.id ?? snapshot.internalId;
+			if (snapshot.lastDismissReason === "close" || snapshot.lastDismissReason === "timeout") persistent.removePersistentItemSilently(persistentId);
+			else if (snapshot.lastDismissReason === "action") persistent.undoFullyDismissedId(persistentId);
+		}
+		const duration = getDuration(snapshot);
+		if (duration != null && duration > 0) timersRef.current?.startNotificationTimer(snapshot.internalId, snapshot.id ?? snapshot.internalId, duration);
+		if (findNotification(notificationsRef.current, id)) setNotifications((prev) => prev.map((n) => matchesNotificationId(n, id) ? {
+			...n,
+			isExiting: false,
+			lastDismissReason: void 0
+		} : n));
+		else {
+			const restored = {
+				...snapshot,
+				isExiting: false,
+				lastDismissReason: void 0
+			};
+			setNotifications((prev) => [...prev, restored]);
+		}
+	});
 	const finalizeNotificationRemoval = useEvent((internalId) => {
 		setNotifications((prev) => prev.filter((n) => n.internalId !== internalId));
+		setTimeout(() => {
+			for (const [key, snap] of dismissSnapshotsRef.current) if (snap.internalId === internalId) {
+				dismissSnapshotsRef.current.delete(key);
+				break;
+			}
+		}, SNAPSHOT_TTL_MS);
 	});
 	return {
 		notifications,
@@ -152,6 +197,7 @@ function useNotificationState(timersRef, persistent) {
 			return id;
 		}),
 		removeNotification,
+		restoreNotification,
 		updateNotification: useEvent((id, options) => {
 			setNotifications((prev) => prev.map((n) => matchesNotificationId(n, id) ? {
 				...n,