@cube-dev/ui-kit 0.117.0 → 0.119.0

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.119.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.119.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,

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

@@ -1 +1 @@
-{"version":3,"file":"use-notification-state.js","names":[],"sources":["../../../../src/components/overlays/Notifications/use-notification-state.ts"],"sourcesContent":["import { Key, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\n\nimport type {\n  DismissReason,\n  InternalNotification,\n  OverlayNotificationOptions,\n  PersistentNotificationItem,\n} from './types';\nimport type { OverlayTimers } from './use-overlay-timers';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst DEFAULT_NOTIFICATION_DURATION = 3000;\nconst DEFAULT_PERSISTENT_NOTIFICATION_DURATION = 5000;\nconst MAX_NOTIFICATIONS = 5;\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport interface PersistentCallbacks {\n  addPersistentItem: (item: PersistentNotificationItem) => void;\n  removePersistentItem: (id: Key) => void;\n  hasDismissedPersistentId: (id: Key) => boolean;\n  isFullyDismissedId: (id: Key) => boolean;\n  saveDismissedPersistentId: (id: Key) => void;\n}\n\nexport interface NotificationState {\n  notifications: InternalNotification[];\n  notificationsRef: ReturnType<typeof useRef<InternalNotification[]>>;\n  addNotification: (\n    options: OverlayNotificationOptions,\n    ownerId?: string,\n  ) => Key;\n  removeNotification: (id: Key, reason?: DismissReason) => void;\n  updateNotification: (\n    id: Key,\n    options: Partial<OverlayNotificationOptions>,\n  ) => void;\n  finalizeNotificationRemoval: (internalId: string) => void;\n  removeByOwner: (ownerId: string) => void;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────\n\nfunction getDuration(\n  notif: OverlayNotificationOptions & { persistent?: boolean },\n): number | null {\n  if (notif.duration === null) return null;\n  if (notif.duration !== undefined) return notif.duration;\n  return notif.persistent\n    ? DEFAULT_PERSISTENT_NOTIFICATION_DURATION\n    : DEFAULT_NOTIFICATION_DURATION;\n}\n\nfunction matchesNotificationId(item: InternalNotification, id: Key): boolean {\n  return item.id === id || item.internalId === String(id);\n}\n\nfunction findNotification(\n  list: InternalNotification[],\n  id: Key,\n): InternalNotification | undefined {\n  return list.find((n) => matchesNotificationId(n, id));\n}\n\n// ─── Hook ────────────────────────────────────────────────────────────\n\n/**\n * @param timersRef - Ref to the shared OverlayTimers instance. Accessed only\n *   inside callbacks (never during render), so it is guaranteed to be populated.\n */\nexport function useNotificationState(\n  timersRef: ReturnType<typeof useRef<OverlayTimers>>,\n  persistent: PersistentCallbacks,\n): NotificationState {\n  const [notifications, setNotifications] = useState<InternalNotification[]>(\n    [],\n  );\n  const notificationsRef = useRef(notifications);\n  notificationsRef.current = notifications;\n\n  const idCounter = useRef(0);\n\n  // ─── Evict Helper ──────────────────────────────────────────────\n\n  /**\n   * Evict the oldest active notification to make room for a new one.\n   * Clears its timer and moves it to the persistent list if applicable.\n   * Must be called OUTSIDE setState updaters (StrictMode-safe).\n   */\n  const evictOldest = useEvent((): string | null => {\n    const active = notificationsRef.current.filter((n) => !n.isExiting);\n\n    if (active.length === 0) return null;\n\n    // Oldest by createdAt (active list preserves insertion order)\n    const oldest = active[0];\n\n    timersRef.current?.clearNotificationTimer(oldest.internalId);\n\n    // Eviction counts as a timeout dismissal — move to persistent list if applicable\n    if (oldest.persistent) {\n      persistent.addPersistentItem({\n        id: oldest.id ?? oldest.internalId,\n        theme: oldest.theme,\n        title: oldest.title,\n        description: oldest.description,\n        icon: oldest.icon,\n        actions: oldest.actions,\n        createdAt: oldest.createdAt,\n        updatedAt: oldest.updatedAt,\n        isRead: false,\n        ownerId: oldest.ownerId,\n      });\n    }\n\n    return oldest.internalId;\n  });\n\n  // ─── Remove ─────────────────────────────────────────────────────\n\n  const removeNotification = useEvent(\n    (id: Key, reason: DismissReason = 'api') => {\n      // Read from ref (synchronous) to perform side effects OUTSIDE the updater.\n      // This prevents double-fire in StrictMode and avoids calling setState\n      // (addPersistentItem) inside another setState updater.\n      const notif = findNotification(notificationsRef.current, id);\n\n      if (!notif || notif.isExiting) return;\n\n      timersRef.current?.clearNotificationTimer(notif.internalId);\n\n      if (notif.persistent) {\n        if (reason === 'close' || reason === 'timeout') {\n          // Dismiss button, Escape, or auto-dismiss timeout — move to persistent list.\n          // If the same id is triggered again, it skips the overlay and updates the\n          // persistent list directly.\n          persistent.addPersistentItem({\n            id: notif.id ?? notif.internalId,\n            theme: notif.theme,\n            title: notif.title,\n            description: notif.description,\n            icon: notif.icon,\n            actions: notif.actions,\n            createdAt: notif.createdAt,\n            updatedAt: notif.updatedAt,\n            isRead: true,\n            ownerId: notif.ownerId,\n          });\n        } else if (reason === 'action') {\n          // User clicked a regular action (not dismiss) — fully dismiss the\n          // notification so it never reappears (overlay or persistent list).\n          persistent.saveDismissedPersistentId(notif.id ?? notif.internalId);\n          persistent.removePersistentItem(notif.id ?? notif.internalId);\n        }\n        // reason === 'api' — programmatic cleanup (e.g. component unmount).\n        // No persistence, no full-dismiss tracking.\n      }\n\n      setNotifications((prev) =>\n        prev.map((n) =>\n          matchesNotificationId(n, id) ? { ...n, isExiting: true } : n,\n        ),\n      );\n    },\n  );\n\n  // ─── Finalize ──────────────────────────────────────────────────\n\n  const finalizeNotificationRemoval = useEvent((internalId: string) => {\n    setNotifications((prev) => prev.filter((n) => n.internalId !== internalId));\n  });\n\n  // ─── Add ────────────────────────────────────────────────────────\n\n  const addNotification = useEvent(\n    (options: OverlayNotificationOptions, ownerId?: string): Key => {\n      idCounter.current += 1;\n      const internalId = `notif-${idCounter.current}-${Date.now()}`;\n      const now = Date.now();\n      const id = options.id ?? internalId;\n\n      // If the user explicitly removed this notification from the persistent\n      // list, completely ignore it — no overlay, no persistent storage.\n      if (options.id != null && persistent.isFullyDismissedId(options.id)) {\n        return id;\n      }\n\n      // If this persistent id was previously dismissed to the persistent list,\n      // skip the overlay and update the persistent item directly.\n      if (\n        options.persistent &&\n        options.id != null &&\n        persistent.hasDismissedPersistentId(options.id)\n      ) {\n        persistent.addPersistentItem({\n          id,\n          theme: options.theme,\n          title: options.title,\n          description: options.description,\n          icon: options.icon,\n          actions: options.actions,\n          createdAt: now,\n          updatedAt: now,\n          isRead: false,\n          ownerId,\n        });\n\n        return id;\n      }\n\n      // Check for existing notification with same id via the ref (synchronous read).\n      const existingNotif =\n        options.id != null\n          ? notificationsRef.current.find(\n              (n) => n.id === options.id && !n.isExiting,\n            )\n          : undefined;\n\n      if (existingNotif) {\n        // In-place update of an existing notification\n        const returnId = existingNotif.id ?? existingNotif.internalId;\n\n        const prevTitle = existingNotif.title;\n        const prevDescription = existingNotif.description;\n\n        // Timer reset on string title/description change\n        const titleChanged =\n          typeof options.title === 'string' &&\n          typeof prevTitle === 'string' &&\n          options.title !== prevTitle;\n        const descriptionChanged =\n          typeof options.description === 'string' &&\n          typeof prevDescription === 'string' &&\n          options.description !== prevDescription;\n\n        if (titleChanged || descriptionChanged) {\n          const duration = getDuration(options);\n\n          if (duration != null && duration > 0) {\n            timersRef.current?.startNotificationTimer(\n              existingNotif.internalId,\n              existingNotif.id ?? existingNotif.internalId,\n              duration,\n            );\n          }\n        }\n\n        setNotifications((prev) =>\n          prev.map((n) => {\n            if (n.internalId === existingNotif.internalId) {\n              return {\n                ...n,\n                ...options,\n                internalId: n.internalId,\n                createdAt: n.createdAt,\n                updatedAt: now,\n                ownerId: ownerId ?? n.ownerId,\n              };\n            }\n            return n;\n          }),\n        );\n\n        return returnId;\n      }\n\n      // New notification — always show immediately, evicting the oldest if at cap.\n      // Read from ref (synchronous) to perform side effects OUTSIDE the updater.\n      const activeCount = notificationsRef.current.filter(\n        (n) => !n.isExiting,\n      ).length;\n\n      const newNotification: InternalNotification = {\n        ...options,\n        id,\n        internalId,\n        createdAt: now,\n        updatedAt: now,\n        ownerId,\n      };\n\n      // Evict oldest if at cap (side effects outside updater)\n      let evictedInternalId: string | null = null;\n\n      if (activeCount >= MAX_NOTIFICATIONS) {\n        evictedInternalId = evictOldest();\n      }\n\n      // Start timer for the new notification\n      const duration = getDuration(options);\n\n      if (duration != null && duration > 0) {\n        timersRef.current?.startNotificationTimer(internalId, id, duration);\n      }\n\n      setNotifications((prev) => {\n        let next = prev;\n\n        if (evictedInternalId) {\n          next = next.map((n) =>\n            n.internalId === evictedInternalId ? { ...n, isExiting: true } : n,\n          );\n        }\n\n        return [...next, newNotification];\n      });\n\n      return id;\n    },\n  );\n\n  // ─── Update ─────────────────────────────────────────────────────\n\n  const updateNotification = useEvent(\n    (id: Key, options: Partial<OverlayNotificationOptions>) => {\n      setNotifications((prev) =>\n        prev.map((n) =>\n          matchesNotificationId(n, id)\n            ? { ...n, ...options, updatedAt: Date.now() }\n            : n,\n        ),\n      );\n    },\n  );\n\n  // ─── Owner Cleanup ──────────────────────────────────────────────\n\n  const removeByOwner = useEvent((ownerId: string) => {\n    // Clear timers outside the updater (StrictMode-safe).\n    const owned = notificationsRef.current.filter(\n      (n) => n.ownerId === ownerId && !n.isExiting,\n    );\n\n    for (const n of owned) {\n      timersRef.current?.clearNotificationTimer(n.internalId);\n    }\n\n    setNotifications((prev) =>\n      prev.map((n) => {\n        if (n.ownerId === ownerId && !n.isExiting) {\n          return { ...n, isExiting: true };\n        }\n        return n;\n      }),\n    );\n  });\n\n  return {\n    notifications,\n    notificationsRef,\n    addNotification,\n    removeNotification,\n    updateNotification,\n    finalizeNotificationRemoval,\n    removeByOwner,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-notification-state.js","names":[],"sources":["../../../../src/components/overlays/Notifications/use-notification-state.ts"],"sourcesContent":["import { Key, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\n\nimport type {\n  DismissReason,\n  InternalNotification,\n  OverlayNotificationOptions,\n  PersistentNotificationItem,\n} from './types';\nimport type { OverlayTimers } from './use-overlay-timers';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst DEFAULT_NOTIFICATION_DURATION = 3000;\nconst DEFAULT_PERSISTENT_NOTIFICATION_DURATION = 5000;\nconst MAX_NOTIFICATIONS = 5;\nconst MAX_DISMISS_SNAPSHOTS = 50;\nconst SNAPSHOT_TTL_MS = 5 * 60 * 1000;\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport interface PersistentCallbacks {\n  addPersistentItem: (item: PersistentNotificationItem) => void;\n  removePersistentItem: (id: Key) => void;\n  removePersistentItemSilently: (id: Key) => void;\n  hasDismissedPersistentId: (id: Key) => boolean;\n  isFullyDismissedId: (id: Key) => boolean;\n  saveDismissedPersistentId: (id: Key) => void;\n  undoFullyDismissedId: (id: Key) => void;\n}\n\nexport interface NotificationState {\n  notifications: InternalNotification[];\n  notificationsRef: ReturnType<typeof useRef<InternalNotification[]>>;\n  addNotification: (\n    options: OverlayNotificationOptions,\n    ownerId?: string,\n  ) => Key;\n  removeNotification: (id: Key, reason?: DismissReason) => void;\n  restoreNotification: (id: Key) => void;\n  updateNotification: (\n    id: Key,\n    options: Partial<OverlayNotificationOptions>,\n  ) => void;\n  finalizeNotificationRemoval: (internalId: string) => void;\n  removeByOwner: (ownerId: string) => void;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────\n\nfunction getDuration(\n  notif: OverlayNotificationOptions & { persistent?: boolean },\n): number | null {\n  if (notif.duration === null) return null;\n  if (notif.duration !== undefined) return notif.duration;\n  return notif.persistent\n    ? DEFAULT_PERSISTENT_NOTIFICATION_DURATION\n    : DEFAULT_NOTIFICATION_DURATION;\n}\n\nfunction matchesNotificationId(item: InternalNotification, id: Key): boolean {\n  return item.id === id || item.internalId === String(id);\n}\n\nfunction findNotification(\n  list: InternalNotification[],\n  id: Key,\n): InternalNotification | undefined {\n  return list.find((n) => matchesNotificationId(n, id));\n}\n\n// ─── Hook ────────────────────────────────────────────────────────────\n\n/**\n * @param timersRef - Ref to the shared OverlayTimers instance. Accessed only\n *   inside callbacks (never during render), so it is guaranteed to be populated.\n */\nexport function useNotificationState(\n  timersRef: ReturnType<typeof useRef<OverlayTimers>>,\n  persistent: PersistentCallbacks,\n): NotificationState {\n  const [notifications, setNotifications] = useState<InternalNotification[]>(\n    [],\n  );\n  const notificationsRef = useRef(notifications);\n  notificationsRef.current = notifications;\n\n  const idCounter = useRef(0);\n\n  // Snapshots of dismissed notifications, keyed by notification id (string).\n  // Saved at dismiss time so restoreNotification can re-add the notification\n  // even after finalizeNotificationRemoval has removed it from state.\n  const dismissSnapshotsRef = useRef<Map<string, InternalNotification>>(\n    new Map(),\n  );\n\n  // ─── Evict Helper ──────────────────────────────────────────────\n\n  /**\n   * Evict the oldest active notification to make room for a new one.\n   * Clears its timer and moves it to the persistent list if applicable.\n   * Must be called OUTSIDE setState updaters (StrictMode-safe).\n   */\n  const evictOldest = useEvent((): string | null => {\n    const active = notificationsRef.current.filter((n) => !n.isExiting);\n\n    if (active.length === 0) return null;\n\n    // Oldest by createdAt (active list preserves insertion order)\n    const oldest = active[0];\n\n    timersRef.current?.clearNotificationTimer(oldest.internalId);\n\n    // Eviction counts as a timeout dismissal — move to persistent list if applicable\n    if (oldest.persistent) {\n      persistent.addPersistentItem({\n        id: oldest.id ?? oldest.internalId,\n        theme: oldest.theme,\n        title: oldest.title,\n        description: oldest.description,\n        icon: oldest.icon,\n        actions: oldest.actions,\n        createdAt: oldest.createdAt,\n        updatedAt: oldest.updatedAt,\n        isRead: false,\n        ownerId: oldest.ownerId,\n      });\n    }\n\n    return oldest.internalId;\n  });\n\n  // ─── Remove ─────────────────────────────────────────────────────\n\n  const removeNotification = useEvent(\n    (id: Key, reason: DismissReason = 'api') => {\n      // Read from ref (synchronous) to perform side effects OUTSIDE the updater.\n      // This prevents double-fire in StrictMode and avoids calling setState\n      // (addPersistentItem) inside another setState updater.\n      const notif = findNotification(notificationsRef.current, id);\n\n      if (!notif || notif.isExiting) return;\n\n      timersRef.current?.clearNotificationTimer(notif.internalId);\n\n      // Snapshot the notification for potential restore after finalization.\n      dismissSnapshotsRef.current.set(String(notif.id ?? notif.internalId), {\n        ...notif,\n        lastDismissReason: reason,\n      });\n\n      // Prevent unbounded growth of dismiss snapshots.\n      while (dismissSnapshotsRef.current.size > MAX_DISMISS_SNAPSHOTS) {\n        const oldest = dismissSnapshotsRef.current.keys().next().value;\n\n        if (oldest != null) {\n          dismissSnapshotsRef.current.delete(oldest);\n        } else {\n          break;\n        }\n      }\n\n      if (notif.persistent) {\n        if (reason === 'close' || reason === 'timeout') {\n          // Dismiss button, Escape, or auto-dismiss timeout — move to persistent list.\n          // If the same id is triggered again, it skips the overlay and updates the\n          // persistent list directly.\n          persistent.addPersistentItem({\n            id: notif.id ?? notif.internalId,\n            theme: notif.theme,\n            title: notif.title,\n            description: notif.description,\n            icon: notif.icon,\n            actions: notif.actions,\n            createdAt: notif.createdAt,\n            updatedAt: notif.updatedAt,\n            isRead: true,\n            ownerId: notif.ownerId,\n          });\n        } else if (reason === 'action') {\n          // User clicked a regular action (not dismiss) — fully dismiss the\n          // notification so it never reappears (overlay or persistent list).\n          persistent.saveDismissedPersistentId(notif.id ?? notif.internalId);\n          persistent.removePersistentItem(notif.id ?? notif.internalId);\n        }\n        // reason === 'api' — programmatic cleanup (e.g. component unmount).\n        // No persistence, no full-dismiss tracking.\n      }\n\n      setNotifications((prev) =>\n        prev.map((n) =>\n          matchesNotificationId(n, id)\n            ? { ...n, isExiting: true, lastDismissReason: reason }\n            : n,\n        ),\n      );\n    },\n  );\n\n  // ─── Restore ──────────────────────────────────────────────────\n\n  const restoreNotification = useEvent((id: Key) => {\n    const idStr = String(id);\n    const snapshot = dismissSnapshotsRef.current.get(idStr);\n\n    if (!snapshot) return;\n\n    dismissSnapshotsRef.current.delete(idStr);\n\n    // Undo persistent side effects based on how the notification was dismissed.\n    if (snapshot.persistent && snapshot.lastDismissReason) {\n      const persistentId = snapshot.id ?? snapshot.internalId;\n\n      if (\n        snapshot.lastDismissReason === 'close' ||\n        snapshot.lastDismissReason === 'timeout'\n      ) {\n        persistent.removePersistentItemSilently(persistentId);\n      } else if (snapshot.lastDismissReason === 'action') {\n        persistent.undoFullyDismissedId(persistentId);\n      }\n    }\n\n    // Restart the auto-dismiss timer.\n    const duration = getDuration(snapshot);\n\n    if (duration != null && duration > 0) {\n      timersRef.current?.startNotificationTimer(\n        snapshot.internalId,\n        snapshot.id ?? snapshot.internalId,\n        duration,\n      );\n    }\n\n    const stillInState = findNotification(notificationsRef.current, id);\n\n    if (stillInState) {\n      // Exit animation hasn't completed yet — cancel it.\n      setNotifications((prev) =>\n        prev.map((n) =>\n          matchesNotificationId(n, id)\n            ? { ...n, isExiting: false, lastDismissReason: undefined }\n            : n,\n        ),\n      );\n    } else {\n      // Notification was already finalized (removed from state) — re-add it.\n      const restored: InternalNotification = {\n        ...snapshot,\n        isExiting: false,\n        lastDismissReason: undefined,\n      };\n\n      setNotifications((prev) => [...prev, restored]);\n    }\n  });\n\n  // ─── Finalize ──────────────────────────────────────────────────\n\n  const finalizeNotificationRemoval = useEvent((internalId: string) => {\n    setNotifications((prev) => prev.filter((n) => n.internalId !== internalId));\n\n    // Deferred cleanup of the dismiss snapshot. Kept briefly so async action\n    // callbacks can still call restoreNotification after the exit animation.\n    setTimeout(() => {\n      for (const [key, snap] of dismissSnapshotsRef.current) {\n        if (snap.internalId === internalId) {\n          dismissSnapshotsRef.current.delete(key);\n          break;\n        }\n      }\n    }, SNAPSHOT_TTL_MS);\n  });\n\n  // ─── Add ────────────────────────────────────────────────────────\n\n  const addNotification = useEvent(\n    (options: OverlayNotificationOptions, ownerId?: string): Key => {\n      idCounter.current += 1;\n      const internalId = `notif-${idCounter.current}-${Date.now()}`;\n      const now = Date.now();\n      const id = options.id ?? internalId;\n\n      // If the user explicitly removed this notification from the persistent\n      // list, completely ignore it — no overlay, no persistent storage.\n      if (options.id != null && persistent.isFullyDismissedId(options.id)) {\n        return id;\n      }\n\n      // If this persistent id was previously dismissed to the persistent list,\n      // skip the overlay and update the persistent item directly.\n      if (\n        options.persistent &&\n        options.id != null &&\n        persistent.hasDismissedPersistentId(options.id)\n      ) {\n        persistent.addPersistentItem({\n          id,\n          theme: options.theme,\n          title: options.title,\n          description: options.description,\n          icon: options.icon,\n          actions: options.actions,\n          createdAt: now,\n          updatedAt: now,\n          isRead: false,\n          ownerId,\n        });\n\n        return id;\n      }\n\n      // Check for existing notification with same id via the ref (synchronous read).\n      const existingNotif =\n        options.id != null\n          ? notificationsRef.current.find(\n              (n) => n.id === options.id && !n.isExiting,\n            )\n          : undefined;\n\n      if (existingNotif) {\n        // In-place update of an existing notification\n        const returnId = existingNotif.id ?? existingNotif.internalId;\n\n        const prevTitle = existingNotif.title;\n        const prevDescription = existingNotif.description;\n\n        // Timer reset on string title/description change\n        const titleChanged =\n          typeof options.title === 'string' &&\n          typeof prevTitle === 'string' &&\n          options.title !== prevTitle;\n        const descriptionChanged =\n          typeof options.description === 'string' &&\n          typeof prevDescription === 'string' &&\n          options.description !== prevDescription;\n\n        if (titleChanged || descriptionChanged) {\n          const duration = getDuration(options);\n\n          if (duration != null && duration > 0) {\n            timersRef.current?.startNotificationTimer(\n              existingNotif.internalId,\n              existingNotif.id ?? existingNotif.internalId,\n              duration,\n            );\n          }\n        }\n\n        setNotifications((prev) =>\n          prev.map((n) => {\n            if (n.internalId === existingNotif.internalId) {\n              return {\n                ...n,\n                ...options,\n                internalId: n.internalId,\n                createdAt: n.createdAt,\n                updatedAt: now,\n                ownerId: ownerId ?? n.ownerId,\n              };\n            }\n            return n;\n          }),\n        );\n\n        return returnId;\n      }\n\n      // New notification — always show immediately, evicting the oldest if at cap.\n      // Read from ref (synchronous) to perform side effects OUTSIDE the updater.\n      const activeCount = notificationsRef.current.filter(\n        (n) => !n.isExiting,\n      ).length;\n\n      const newNotification: InternalNotification = {\n        ...options,\n        id,\n        internalId,\n        createdAt: now,\n        updatedAt: now,\n        ownerId,\n      };\n\n      // Evict oldest if at cap (side effects outside updater)\n      let evictedInternalId: string | null = null;\n\n      if (activeCount >= MAX_NOTIFICATIONS) {\n        evictedInternalId = evictOldest();\n      }\n\n      // Start timer for the new notification\n      const duration = getDuration(options);\n\n      if (duration != null && duration > 0) {\n        timersRef.current?.startNotificationTimer(internalId, id, duration);\n      }\n\n      setNotifications((prev) => {\n        let next = prev;\n\n        if (evictedInternalId) {\n          next = next.map((n) =>\n            n.internalId === evictedInternalId ? { ...n, isExiting: true } : n,\n          );\n        }\n\n        return [...next, newNotification];\n      });\n\n      return id;\n    },\n  );\n\n  // ─── Update ─────────────────────────────────────────────────────\n\n  const updateNotification = useEvent(\n    (id: Key, options: Partial<OverlayNotificationOptions>) => {\n      setNotifications((prev) =>\n        prev.map((n) =>\n          matchesNotificationId(n, id)\n            ? { ...n, ...options, updatedAt: Date.now() }\n            : n,\n        ),\n      );\n    },\n  );\n\n  // ─── Owner Cleanup ──────────────────────────────────────────────\n\n  const removeByOwner = useEvent((ownerId: string) => {\n    // Clear timers outside the updater (StrictMode-safe).\n    const owned = notificationsRef.current.filter(\n      (n) => n.ownerId === ownerId && !n.isExiting,\n    );\n\n    for (const n of owned) {\n      timersRef.current?.clearNotificationTimer(n.internalId);\n    }\n\n    setNotifications((prev) =>\n      prev.map((n) => {\n        if (n.ownerId === ownerId && !n.isExiting) {\n          return { ...n, isExiting: true };\n        }\n        return n;\n      }),\n    );\n  });\n\n  return {\n    notifications,\n    notificationsRef,\n    addNotification,\n    removeNotification,\n    restoreNotification,\n    updateNotification,\n    finalizeNotificationRemoval,\n    removeByOwner,\n  };\n}\n"],"mappings":"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"}

package/dist/components/overlays/Notifications/use-notifications.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useWarn } from "../../../_internal/hooks/use-warn.js";
 import { useNotificationContext } from "./NotificationContext.js";

package/dist/components/overlays/Notifications/use-overlay-timers.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useEffect, useRef } from "react";
 

package/dist/components/overlays/Notifications/use-persistent-notifications.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
 import { usePersistentNotificationsContext } from "./NotificationContext.js";
 import { useMemo } from "react";
 

package/dist/components/overlays/Notifications/use-persistent-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.119.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { cleanupAndGetValidIds, saveDismissedId } from "./dismissed-storage.js";
 import { useRef, useState } from "react";
@@ -62,6 +62,13 @@ function usePersistentState(maxItems) {
 		saveDismissedPersistentId: useEvent((id) => {
 			dismissedPersistentIdsRef.current.add(String(id));
 			saveDismissedId(id);
+		}),
+		undoFullyDismissedId: useEvent((id) => {
+			fullyDismissedIdsRef.current.delete(String(id));
+		}),
+		removePersistentItemSilently: useEvent((id) => {
+			dismissedPersistentIdsRef.current.delete(String(id));
+			setPersistentItems((prev) => prev.filter((i) => i.id !== id));
 		})
 	};
 }

package/dist/components/overlays/Notifications/use-persistent-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-persistent-state.js","names":[],"sources":["../../../../src/components/overlays/Notifications/use-persistent-state.ts"],"sourcesContent":["import { Key, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\n\nimport { cleanupAndGetValidIds, saveDismissedId } from './dismissed-storage';\n\nimport type { PersistentNotificationItem } from './types';\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport interface PersistentState {\n  persistentItems: PersistentNotificationItem[];\n  addPersistentItem: (item: PersistentNotificationItem) => void;\n  removePersistentItem: (id: Key) => void;\n  removePersistentItemsByOwner: (ownerId: string) => void;\n  clearPersistentItems: () => void;\n  markAllAsRead: () => void;\n  /**\n   * Returns true if the given id was previously moved to the persistent list\n   * and has NOT been explicitly removed from it (i.e. still archived, or was\n   * auto-dismissed but not yet user-dismissed from the persistent list).\n   */\n  hasDismissedPersistentId: (id: Key) => boolean;\n  /**\n   * Returns true if the given id was explicitly removed from the persistent\n   * list by the user. Such notifications should be completely ignored on\n   * subsequent triggers (no overlay, no persistent storage).\n   */\n  isFullyDismissedId: (id: Key) => boolean;\n  /**\n   * Marks an id as dismissed in both the in-memory set and localStorage.\n   * Used for `'action'` dismissals that go through `removePersistentItem`\n   * instead of `addPersistentItem`.\n   */\n  saveDismissedPersistentId: (id: Key) => void;\n}\n\n// ─── Hook ────────────────────────────────────────────────────────────\n\nexport function usePersistentState(maxItems: number): PersistentState {\n  const [persistentItems, setPersistentItems] = useState<\n    PersistentNotificationItem[]\n  >([]);\n\n  // Tracks IDs that have been moved to the persistent list at least once.\n  // Used to skip the overlay when the same id reappears.\n  // Lazy-initialized from localStorage so dismissed IDs survive page reloads.\n  const dismissedPersistentIdsRef = useRef<Set<string> | null>(null);\n  if (dismissedPersistentIdsRef.current === null) {\n    dismissedPersistentIdsRef.current = cleanupAndGetValidIds();\n  }\n\n  // Tracks IDs that were explicitly removed from the persistent list by the\n  // user. These should be completely ignored on subsequent triggers.\n  const fullyDismissedIdsRef = useRef<Set<string>>(new Set());\n\n  const addPersistentItem = useEvent((item: PersistentNotificationItem) => {\n    // If the user already dismissed this item from the persistent list, don't re-add it.\n    if (fullyDismissedIdsRef.current.has(String(item.id))) return;\n\n    dismissedPersistentIdsRef.current!.add(String(item.id));\n    saveDismissedId(item.id);\n\n    setPersistentItems((prev) => {\n      // Upsert by id\n      const existingIndex = prev.findIndex((i) => i.id === item.id);\n      let newItems: PersistentNotificationItem[];\n\n      if (existingIndex !== -1) {\n        newItems = [...prev];\n        // Updated items are marked unread again\n        newItems[existingIndex] = {\n          ...newItems[existingIndex],\n          ...item,\n          isRead: false,\n        };\n      } else {\n        newItems = [{ ...item, isRead: item.isRead ?? false }, ...prev];\n      }\n\n      // Enforce max cap\n      if (newItems.length > maxItems) {\n        newItems = newItems.slice(0, maxItems);\n      }\n\n      // Sort newest first\n      newItems.sort((a, b) => b.createdAt - a.createdAt);\n\n      return newItems;\n    });\n  });\n\n  const removePersistentItem = useEvent((id: Key) => {\n    fullyDismissedIdsRef.current.add(String(id));\n    setPersistentItems((prev) => prev.filter((i) => i.id !== id));\n  });\n\n  const removePersistentItemsByOwner = useEvent((ownerId: string) => {\n    setPersistentItems((prev) => prev.filter((i) => i.ownerId !== ownerId));\n  });\n\n  const clearPersistentItems = useEvent(() => {\n    setPersistentItems([]);\n  });\n\n  const markAllAsRead = useEvent(() => {\n    setPersistentItems((prev) => {\n      const hasUnread = prev.some((i) => !i.isRead);\n\n      if (!hasUnread) return prev;\n\n      return prev.map((i) => (i.isRead ? i : { ...i, isRead: true }));\n    });\n  });\n\n  const hasDismissedPersistentId = useEvent((id: Key): boolean => {\n    return dismissedPersistentIdsRef.current!.has(String(id));\n  });\n\n  const isFullyDismissedId = useEvent((id: Key): boolean => {\n    return fullyDismissedIdsRef.current.has(String(id));\n  });\n\n  const saveDismissedPersistentId = useEvent((id: Key): void => {\n    dismissedPersistentIdsRef.current!.add(String(id));\n    saveDismissedId(id);\n  });\n\n  return {\n    persistentItems,\n    addPersistentItem,\n    removePersistentItem,\n    removePersistentItemsByOwner,\n    clearPersistentItems,\n    markAllAsRead,\n    hasDismissedPersistentId,\n    isFullyDismissedId,\n    saveDismissedPersistentId,\n  };\n}\n"],"mappings":";;;;;;AAuCA,SAAgB,mBAAmB,UAAmC;CACpE,MAAM,CAAC,iBAAiB,sBAAsB,SAE5C,EAAE,CAAC;CAKL,MAAM,4BAA4B,OAA2B,KAAK;AAClE,KAAI,0BAA0B,YAAY,KACxC,2BAA0B,UAAU,uBAAuB;CAK7D,MAAM,uBAAuB,uBAAoB,IAAI,KAAK,CAAC;AA0E3D,QAAO;EACL;EACA,mBA1EwB,UAAU,SAAqC;AAEvE,OAAI,qBAAqB,QAAQ,IAAI,OAAO,KAAK,GAAG,CAAC,CAAE;AAEvD,6BAA0B,QAAS,IAAI,OAAO,KAAK,GAAG,CAAC;AACvD,mBAAgB,KAAK,GAAG;AAExB,uBAAoB,SAAS;IAE3B,MAAM,gBAAgB,KAAK,WAAW,MAAM,EAAE,OAAO,KAAK,GAAG;IAC7D,IAAI;AAEJ,QAAI,kBAAkB,IAAI;AACxB,gBAAW,CAAC,GAAG,KAAK;AAEpB,cAAS,iBAAiB;MACxB,GAAG,SAAS;MACZ,GAAG;MACH,QAAQ;MACT;UAED,YAAW,CAAC;KAAE,GAAG;KAAM,QAAQ,KAAK,UAAU;KAAO,EAAE,GAAG,KAAK;AAIjE,QAAI,SAAS,SAAS,SACpB,YAAW,SAAS,MAAM,GAAG,SAAS;AAIxC,aAAS,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,UAAU;AAElD,WAAO;KACP;IACF;EAyCA,sBAvC2B,UAAU,OAAY;AACjD,wBAAqB,QAAQ,IAAI,OAAO,GAAG,CAAC;AAC5C,uBAAoB,SAAS,KAAK,QAAQ,MAAM,EAAE,OAAO,GAAG,CAAC;IAC7D;EAqCA,8BAnCmC,UAAU,YAAoB;AACjE,uBAAoB,SAAS,KAAK,QAAQ,MAAM,EAAE,YAAY,QAAQ,CAAC;IACvE;EAkCA,sBAhC2B,eAAe;AAC1C,sBAAmB,EAAE,CAAC;IACtB;EA+BA,eA7BoB,eAAe;AACnC,uBAAoB,SAAS;AAG3B,QAAI,CAFc,KAAK,MAAM,MAAM,CAAC,EAAE,OAAO,CAE7B,QAAO;AAEvB,WAAO,KAAK,KAAK,MAAO,EAAE,SAAS,IAAI;KAAE,GAAG;KAAG,QAAQ;KAAM,CAAE;KAC/D;IACF;EAsBA,0BApB+B,UAAU,OAAqB;AAC9D,UAAO,0BAA0B,QAAS,IAAI,OAAO,GAAG,CAAC;IACzD;EAmBA,oBAjByB,UAAU,OAAqB;AACxD,UAAO,qBAAqB,QAAQ,IAAI,OAAO,GAAG,CAAC;IACnD;EAgBA,2BAdgC,UAAU,OAAkB;AAC5D,6BAA0B,QAAS,IAAI,OAAO,GAAG,CAAC;AAClD,mBAAgB,GAAG;IACnB;EAYD"}
+{"version":3,"file":"use-persistent-state.js","names":[],"sources":["../../../../src/components/overlays/Notifications/use-persistent-state.ts"],"sourcesContent":["import { Key, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\n\nimport { cleanupAndGetValidIds, saveDismissedId } from './dismissed-storage';\n\nimport type { PersistentNotificationItem } from './types';\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport interface PersistentState {\n  persistentItems: PersistentNotificationItem[];\n  addPersistentItem: (item: PersistentNotificationItem) => void;\n  removePersistentItem: (id: Key) => void;\n  removePersistentItemsByOwner: (ownerId: string) => void;\n  clearPersistentItems: () => void;\n  markAllAsRead: () => void;\n  /**\n   * Returns true if the given id was previously moved to the persistent list\n   * and has NOT been explicitly removed from it (i.e. still archived, or was\n   * auto-dismissed but not yet user-dismissed from the persistent list).\n   */\n  hasDismissedPersistentId: (id: Key) => boolean;\n  /**\n   * Returns true if the given id was explicitly removed from the persistent\n   * list by the user. Such notifications should be completely ignored on\n   * subsequent triggers (no overlay, no persistent storage).\n   */\n  isFullyDismissedId: (id: Key) => boolean;\n  /**\n   * Marks an id as dismissed in both the in-memory set and localStorage.\n   * Used for `'action'` dismissals that go through `removePersistentItem`\n   * instead of `addPersistentItem`.\n   */\n  saveDismissedPersistentId: (id: Key) => void;\n  /**\n   * Removes an id from the fully-dismissed set.\n   * Used to undo an `'action'` dismissal when the async action is cancelled.\n   */\n  undoFullyDismissedId: (id: Key) => void;\n  /**\n   * Removes an item from the persistent list without marking it as fully dismissed.\n   * Used to undo a `'close'` dismissal that moved the notification to persistent.\n   */\n  removePersistentItemSilently: (id: Key) => void;\n}\n\n// ─── Hook ────────────────────────────────────────────────────────────\n\nexport function usePersistentState(maxItems: number): PersistentState {\n  const [persistentItems, setPersistentItems] = useState<\n    PersistentNotificationItem[]\n  >([]);\n\n  // Tracks IDs that have been moved to the persistent list at least once.\n  // Used to skip the overlay when the same id reappears.\n  // Lazy-initialized from localStorage so dismissed IDs survive page reloads.\n  const dismissedPersistentIdsRef = useRef<Set<string> | null>(null);\n  if (dismissedPersistentIdsRef.current === null) {\n    dismissedPersistentIdsRef.current = cleanupAndGetValidIds();\n  }\n\n  // Tracks IDs that were explicitly removed from the persistent list by the\n  // user. These should be completely ignored on subsequent triggers.\n  const fullyDismissedIdsRef = useRef<Set<string>>(new Set());\n\n  const addPersistentItem = useEvent((item: PersistentNotificationItem) => {\n    // If the user already dismissed this item from the persistent list, don't re-add it.\n    if (fullyDismissedIdsRef.current.has(String(item.id))) return;\n\n    dismissedPersistentIdsRef.current!.add(String(item.id));\n    saveDismissedId(item.id);\n\n    setPersistentItems((prev) => {\n      // Upsert by id\n      const existingIndex = prev.findIndex((i) => i.id === item.id);\n      let newItems: PersistentNotificationItem[];\n\n      if (existingIndex !== -1) {\n        newItems = [...prev];\n        // Updated items are marked unread again\n        newItems[existingIndex] = {\n          ...newItems[existingIndex],\n          ...item,\n          isRead: false,\n        };\n      } else {\n        newItems = [{ ...item, isRead: item.isRead ?? false }, ...prev];\n      }\n\n      // Enforce max cap\n      if (newItems.length > maxItems) {\n        newItems = newItems.slice(0, maxItems);\n      }\n\n      // Sort newest first\n      newItems.sort((a, b) => b.createdAt - a.createdAt);\n\n      return newItems;\n    });\n  });\n\n  const removePersistentItem = useEvent((id: Key) => {\n    fullyDismissedIdsRef.current.add(String(id));\n    setPersistentItems((prev) => prev.filter((i) => i.id !== id));\n  });\n\n  const removePersistentItemsByOwner = useEvent((ownerId: string) => {\n    setPersistentItems((prev) => prev.filter((i) => i.ownerId !== ownerId));\n  });\n\n  const clearPersistentItems = useEvent(() => {\n    setPersistentItems([]);\n  });\n\n  const markAllAsRead = useEvent(() => {\n    setPersistentItems((prev) => {\n      const hasUnread = prev.some((i) => !i.isRead);\n\n      if (!hasUnread) return prev;\n\n      return prev.map((i) => (i.isRead ? i : { ...i, isRead: true }));\n    });\n  });\n\n  const hasDismissedPersistentId = useEvent((id: Key): boolean => {\n    return dismissedPersistentIdsRef.current!.has(String(id));\n  });\n\n  const isFullyDismissedId = useEvent((id: Key): boolean => {\n    return fullyDismissedIdsRef.current.has(String(id));\n  });\n\n  const saveDismissedPersistentId = useEvent((id: Key): void => {\n    dismissedPersistentIdsRef.current!.add(String(id));\n    saveDismissedId(id);\n  });\n\n  const undoFullyDismissedId = useEvent((id: Key): void => {\n    fullyDismissedIdsRef.current.delete(String(id));\n  });\n\n  const removePersistentItemSilently = useEvent((id: Key): void => {\n    dismissedPersistentIdsRef.current!.delete(String(id));\n    setPersistentItems((prev) => prev.filter((i) => i.id !== id));\n  });\n\n  return {\n    persistentItems,\n    addPersistentItem,\n    removePersistentItem,\n    removePersistentItemsByOwner,\n    clearPersistentItems,\n    markAllAsRead,\n    hasDismissedPersistentId,\n    isFullyDismissedId,\n    saveDismissedPersistentId,\n    undoFullyDismissedId,\n    removePersistentItemSilently,\n  };\n}\n"],"mappings":";;;;;;AAiDA,SAAgB,mBAAmB,UAAmC;CACpE,MAAM,CAAC,iBAAiB,sBAAsB,SAE5C,EAAE,CAAC;CAKL,MAAM,4BAA4B,OAA2B,KAAK;AAClE,KAAI,0BAA0B,YAAY,KACxC,2BAA0B,UAAU,uBAAuB;CAK7D,MAAM,uBAAuB,uBAAoB,IAAI,KAAK,CAAC;AAmF3D,QAAO;EACL;EACA,mBAnFwB,UAAU,SAAqC;AAEvE,OAAI,qBAAqB,QAAQ,IAAI,OAAO,KAAK,GAAG,CAAC,CAAE;AAEvD,6BAA0B,QAAS,IAAI,OAAO,KAAK,GAAG,CAAC;AACvD,mBAAgB,KAAK,GAAG;AAExB,uBAAoB,SAAS;IAE3B,MAAM,gBAAgB,KAAK,WAAW,MAAM,EAAE,OAAO,KAAK,GAAG;IAC7D,IAAI;AAEJ,QAAI,kBAAkB,IAAI;AACxB,gBAAW,CAAC,GAAG,KAAK;AAEpB,cAAS,iBAAiB;MACxB,GAAG,SAAS;MACZ,GAAG;MACH,QAAQ;MACT;UAED,YAAW,CAAC;KAAE,GAAG;KAAM,QAAQ,KAAK,UAAU;KAAO,EAAE,GAAG,KAAK;AAIjE,QAAI,SAAS,SAAS,SACpB,YAAW,SAAS,MAAM,GAAG,SAAS;AAIxC,aAAS,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,UAAU;AAElD,WAAO;KACP;IACF;EAkDA,sBAhD2B,UAAU,OAAY;AACjD,wBAAqB,QAAQ,IAAI,OAAO,GAAG,CAAC;AAC5C,uBAAoB,SAAS,KAAK,QAAQ,MAAM,EAAE,OAAO,GAAG,CAAC;IAC7D;EA8CA,8BA5CmC,UAAU,YAAoB;AACjE,uBAAoB,SAAS,KAAK,QAAQ,MAAM,EAAE,YAAY,QAAQ,CAAC;IACvE;EA2CA,sBAzC2B,eAAe;AAC1C,sBAAmB,EAAE,CAAC;IACtB;EAwCA,eAtCoB,eAAe;AACnC,uBAAoB,SAAS;AAG3B,QAAI,CAFc,KAAK,MAAM,MAAM,CAAC,EAAE,OAAO,CAE7B,QAAO;AAEvB,WAAO,KAAK,KAAK,MAAO,EAAE,SAAS,IAAI;KAAE,GAAG;KAAG,QAAQ;KAAM,CAAE;KAC/D;IACF;EA+BA,0BA7B+B,UAAU,OAAqB;AAC9D,UAAO,0BAA0B,QAAS,IAAI,OAAO,GAAG,CAAC;IACzD;EA4BA,oBA1ByB,UAAU,OAAqB;AACxD,UAAO,qBAAqB,QAAQ,IAAI,OAAO,GAAG,CAAC;IACnD;EAyBA,2BAvBgC,UAAU,OAAkB;AAC5D,6BAA0B,QAAS,IAAI,OAAO,GAAG,CAAC;AAClD,mBAAgB,GAAG;IACnB;EAqBA,sBAnB2B,UAAU,OAAkB;AACvD,wBAAqB,QAAQ,OAAO,OAAO,GAAG,CAAC;IAC/C;EAkBA,8BAhBmC,UAAU,OAAkB;AAC/D,6BAA0B,QAAS,OAAO,OAAO,GAAG,CAAC;AACrD,uBAAoB,SAAS,KAAK,QAAQ,MAAM,EAAE,OAAO,GAAG,CAAC;IAC7D;EAcD"}

package/dist/components/overlays/Notifications/use-toast-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.119.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useRef, useState } from "react";
 

package/dist/components/overlays/Toast/ToastItem.js

@@ -1,7 +1,7 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
-import { tasty } from "../../../tasty/tasty.js";
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
 import { _Item } from "../../content/Item/Item.js";
 import { getThemeIcon } from "./useToast.js";
+import { tasty } from "@tenphi/tasty";
 import { forwardRef } from "react";
 import { jsx } from "react/jsx-runtime";
 

package/dist/components/overlays/Toast/ToastItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToastItem.js","names":["Item"],"sources":["../../../../src/components/overlays/Toast/ToastItem.tsx"],"sourcesContent":["import { forwardRef, ReactNode } from 'react';\n\nimport { tasty } from '../../../tasty';\nimport { CubeItemProps, Item } from '../../content/Item/Item';\n\nimport { getThemeIcon } from './useToast';\n\nimport type { ToastType } from './types';\n\nexport interface ToastItemProps\n  extends Partial<Omit<CubeItemProps, 'type' | 'icon'>> {\n  /** Primary content (→ Item children). Also supports description-only for migration. */\n  title?: ReactNode;\n  /** Secondary content (or primary if no title/children) */\n  description?: ReactNode;\n  /** Visual theme */\n  theme?: ToastType;\n  /** Whether the toast is in loading state */\n  isLoading?: boolean;\n  /** Icon to display (resolved ReactNode, not a dynamic icon function) */\n  icon?: ReactNode;\n}\n\nconst StyledItem = tasty(Item, {\n  styles: {\n    shadow: '$shadow',\n    transition: 'theme, inset',\n    pointerEvents: {\n      '': 'none',\n      'has-actions': 'auto',\n    },\n\n    Description: {\n      preset: 't4',\n    },\n  },\n});\n\nexport const ToastItem = forwardRef<HTMLElement, ToastItemProps>(\n  function ToastItem(props, ref) {\n    const {\n      title,\n      description,\n      theme,\n      isLoading,\n      icon: providedIcon,\n      children,\n      qa,\n      ...itemProps\n    } = props;\n\n    const icon = getThemeIcon(theme, providedIcon, isLoading);\n\n    // If only description provided (no title/children), use description as primary content\n    const primaryContent = children ?? title ?? description;\n    const secondaryContent = children || title ? description : undefined;\n\n    return (\n      <StyledItem\n        ref={ref}\n        qa={qa ?? 'Toast'}\n        type=\"card\"\n        theme={theme}\n        icon={icon}\n        isLoading={isLoading}\n        isDisabled={false}\n        description={secondaryContent}\n        {...itemProps}\n      >\n        {primaryContent}\n      </StyledItem>\n    );\n  },\n);\n"],"mappings":";;;;;;;;AAuBA,MAAM,aAAa,MAAMA,OAAM,EAC7B,QAAQ;CACN,QAAQ;CACR,YAAY;CACZ,eAAe;EACb,IAAI;EACJ,eAAe;EAChB;CAED,aAAa,EACX,QAAQ,MACT;CACF,EACF,CAAC;AAEF,MAAa,YAAY,WACvB,SAAS,UAAU,OAAO,KAAK;CAC7B,MAAM,EACJ,OACA,aACA,OACA,WACA,MAAM,cACN,UACA,IACA,GAAG,cACD;CAEJ,MAAM,OAAO,aAAa,OAAO,cAAc,UAAU;CAGzD,MAAM,iBAAiB,YAAY,SAAS;AAG5C,QACE,oBAAC;EACM;EACL,IAAI,MAAM;EACV,MAAK;EACE;EACD;EACK;EACX,YAAY;EACZ,aAXqB,YAAY,QAAQ,cAAc;EAYvD,GAAI;YAEH;GACU;EAGlB"}
+{"version":3,"file":"ToastItem.js","names":["Item"],"sources":["../../../../src/components/overlays/Toast/ToastItem.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\nimport { forwardRef, ReactNode } from 'react';\n\nimport { CubeItemProps, Item } from '../../content/Item/Item';\n\nimport { getThemeIcon } from './useToast';\n\nimport type { ToastType } from './types';\n\nexport interface ToastItemProps\n  extends Partial<Omit<CubeItemProps, 'type' | 'icon'>> {\n  /** Primary content (→ Item children). Also supports description-only for migration. */\n  title?: ReactNode;\n  /** Secondary content (or primary if no title/children) */\n  description?: ReactNode;\n  /** Visual theme */\n  theme?: ToastType;\n  /** Whether the toast is in loading state */\n  isLoading?: boolean;\n  /** Icon to display (resolved ReactNode, not a dynamic icon function) */\n  icon?: ReactNode;\n}\n\nconst StyledItem = tasty(Item, {\n  styles: {\n    shadow: '$shadow',\n    transition: 'theme, inset',\n    pointerEvents: {\n      '': 'none',\n      'has-actions': 'auto',\n    },\n\n    Description: {\n      preset: 't4',\n    },\n  },\n});\n\nexport const ToastItem = forwardRef<HTMLElement, ToastItemProps>(\n  function ToastItem(props, ref) {\n    const {\n      title,\n      description,\n      theme,\n      isLoading,\n      icon: providedIcon,\n      children,\n      qa,\n      ...itemProps\n    } = props;\n\n    const icon = getThemeIcon(theme, providedIcon, isLoading);\n\n    // If only description provided (no title/children), use description as primary content\n    const primaryContent = children ?? title ?? description;\n    const secondaryContent = children || title ? description : undefined;\n\n    return (\n      <StyledItem\n        ref={ref}\n        qa={qa ?? 'Toast'}\n        type=\"card\"\n        theme={theme}\n        icon={icon}\n        isLoading={isLoading}\n        isDisabled={false}\n        description={secondaryContent}\n        {...itemProps}\n      >\n        {primaryContent}\n      </StyledItem>\n    );\n  },\n);\n"],"mappings":";;;;;;;;AAuBA,MAAM,aAAa,MAAMA,OAAM,EAC7B,QAAQ;CACN,QAAQ;CACR,YAAY;CACZ,eAAe;EACb,IAAI;EACJ,eAAe;EAChB;CAED,aAAa,EACX,QAAQ,MACT;CACF,EACF,CAAC;AAEF,MAAa,YAAY,WACvB,SAAS,UAAU,OAAO,KAAK;CAC7B,MAAM,EACJ,OACA,aACA,OACA,WACA,MAAM,cACN,UACA,IACA,GAAG,cACD;CAEJ,MAAM,OAAO,aAAa,OAAO,cAAc,UAAU;CAGzD,MAAM,iBAAiB,YAAY,SAAS;AAG5C,QACE,oBAAC;EACM;EACL,IAAI,MAAM;EACV,MAAK;EACE;EACD;EACK;EACX,YAAY;EACZ,aAXqB,YAAY,QAAQ,cAAc;EAYvD,GAAI;YAEH;GACU;EAGlB"}

package/dist/components/overlays/Toast/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.119.0 | Cube Dev Team */
 import { useToastContext } from "../Notifications/NotificationContext.js";
 import { useProgressToast } from "./useProgressToast.js";
 import { getThemeIcon, useToast } from "./useToast.js";

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

@@ -29,6 +29,8 @@ interface ToastData {
 interface ProgressToastOptions extends Omit<ToastData, 'duration'> {
   /** Whether the toast is in loading state */
   isLoading: boolean;
+  /** When true, a "Hide" action is shown during loading so the user can dismiss the toast temporarily. */
+  isDismissable?: boolean;
 }
 /**
  * Empty value that indicates no toast should be shown.

package/dist/components/overlays/Toast/useProgressToast.js

@@ -1,8 +1,11 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
+import { useEvent } from "../../../_internal/hooks/use-event.js";
+import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
 import { useToastContext } from "../Notifications/NotificationContext.js";
 import { useEffect, useRef } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
-//#region src/components/overlays/Toast/useProgressToast.ts
+//#region src/components/overlays/Toast/useProgressToast.tsx
 const RESULT_DURATION = 3e3;
 /**
 * Check if the options represent an "empty" value (null, undefined, false, or empty object).
@@ -44,13 +47,14 @@ function getStringValue(value) {
 * ```
 */
 function useProgressToast(options) {
-	const { addToast, removeToast } = useToastContext();
+	const { addToast, removeToast, updateToast } = useToastContext();
 	const toastIdRef = useRef(null);
 	const wasLoadingRef = useRef(null);
 	const hideTimerRef = useRef(null);
 	const isFirstRenderRef = useRef(true);
 	const optionsRef = useRef(options);
 	const hasBeenLoadingRef = useRef(false);
+	const hiddenByUserRef = useRef(false);
 	const prevThemeRef = useRef(void 0);
 	const prevTitleRef = useRef(void 0);
 	const prevDescriptionRef = useRef(void 0);
@@ -63,9 +67,17 @@ function useProgressToast(options) {
 	};
 	const isEmpty = isEmptyOptions(options);
 	const isLoading = isEmpty ? false : options.isLoading;
+	const isDismissable = isEmpty ? false : !!options.isDismissable;
 	const currentTheme = isEmpty ? void 0 : options.theme;
 	const currentTitle = isEmpty ? void 0 : getStringValue(options.title);
 	const currentDescription = isEmpty ? void 0 : getStringValue(options.description);
+	const handleHide = useEvent(() => {
+		if (toastIdRef.current != null) {
+			removeToast(toastIdRef.current);
+			toastIdRef.current = null;
+		}
+		hiddenByUserRef.current = true;
+	});
 	useEffect(() => {
 		const wasLoading = wasLoadingRef.current;
 		const isFirstRender = isFirstRenderRef.current;
@@ -77,6 +89,7 @@ function useProgressToast(options) {
 				toastIdRef.current = null;
 			}
 			hasBeenLoadingRef.current = false;
+			hiddenByUserRef.current = false;
 			wasLoadingRef.current = null;
 			isFirstRenderRef.current = false;
 			prevThemeRef.current = void 0;
@@ -84,18 +97,31 @@ function useProgressToast(options) {
 			prevDescriptionRef.current = void 0;
 			return;
 		}
-		const { isLoading: currentIsLoading, ...currentToastData } = currentOptions;
+		const { isLoading: currentIsLoading, isDismissable: _isDismissable, ...currentToastData } = currentOptions;
 		const themeChanged = currentTheme !== prevThemeRef.current;
 		const titleChanged = currentTitle !== prevTitleRef.current;
 		const descriptionChanged = currentDescription !== prevDescriptionRef.current;
 		const dataChanged = themeChanged || titleChanged || descriptionChanged;
+		const hideAction = isDismissable && currentIsLoading ? /* @__PURE__ */ jsx(ItemAction, {
+			type: "secondary",
+			onPress: handleHide,
+			children: "Hide"
+		}) : null;
+		const mergedActions = hideAction ? /* @__PURE__ */ jsxs(Fragment$1, { children: [currentToastData.actions, hideAction] }) : currentToastData.actions;
+		const toastData = {
+			title: void 0,
+			description: void 0,
+			theme: void 0,
+			icon: void 0,
+			itemProps: void 0,
+			...currentToastData,
+			actions: mergedActions,
+			isLoading: currentIsLoading,
+			duration: null
+		};
 		const showToast = () => {
-			if (toastIdRef.current != null) removeToast(toastIdRef.current);
-			toastIdRef.current = addToast({
-				...currentToastData,
-				isLoading: currentIsLoading,
-				duration: null
-			}, true);
+			if (toastIdRef.current != null) updateToast(toastIdRef.current, toastData);
+			else toastIdRef.current = addToast(toastData, true);
 		};
 		const showToastWithTimer = () => {
 			showToast();
@@ -109,24 +135,23 @@ function useProgressToast(options) {
 		if (currentIsLoading) {
 			hasBeenLoadingRef.current = true;
 			clearHideTimer();
-			if (toastIdRef.current == null) showToast();
+			if (hiddenByUserRef.current) {} else if (toastIdRef.current == null) showToast();
 			else if (dataChanged) showToast();
 		} else if (wasLoading === true && !currentIsLoading) {
+			hiddenByUserRef.current = false;
 			clearHideTimer();
 			if (currentTitle) showToastWithTimer();
 			else if (toastIdRef.current != null) {
 				removeToast(toastIdRef.current);
 				toastIdRef.current = null;
 			}
-		} else if (!currentIsLoading && !isFirstRender && hasBeenLoadingRef.current && dataChanged) {
-			if (currentTitle) {
-				clearHideTimer();
-				showToastWithTimer();
-			} else if (toastIdRef.current != null) {
-				clearHideTimer();
-				removeToast(toastIdRef.current);
-				toastIdRef.current = null;
-			}
+		} else if (!currentIsLoading && !isFirstRender && hasBeenLoadingRef.current && dataChanged && toastIdRef.current != null) if (currentTitle) {
+			clearHideTimer();
+			showToastWithTimer();
+		} else {
+			clearHideTimer();
+			removeToast(toastIdRef.current);
+			toastIdRef.current = null;
 		}
 		wasLoadingRef.current = currentIsLoading;
 		isFirstRenderRef.current = false;
@@ -136,11 +161,14 @@ function useProgressToast(options) {
 	}, [
 		isEmpty,
 		isLoading,
+		isDismissable,
 		currentTheme,
 		currentTitle,
 		currentDescription,
 		addToast,
-		removeToast
+		removeToast,
+		updateToast,
+		handleHide
 	]);
 	useEffect(() => {
 		return () => {

package/dist/components/overlays/Toast/useProgressToast.js.map

@@ -1 +1 @@
-{"version":3,"file":"useProgressToast.js","names":[],"sources":["../../../../src/components/overlays/Toast/useProgressToast.ts"],"sourcesContent":["import { Key, useEffect, useRef } from 'react';\n\nimport { useToastContext } from './ToastProvider';\n\nimport type { ProgressToastEmpty, ProgressToastOptions } from './types';\n\nconst RESULT_DURATION = 3000;\n\n/**\n * Check if the options represent an \"empty\" value (null, undefined, false, or empty object).\n * When empty, the hook should immediately remove any existing toast.\n */\nfunction isEmptyOptions(\n  options: ProgressToastOptions | ProgressToastEmpty,\n): options is ProgressToastEmpty {\n  if (options == null || options === false) return true;\n  if (typeof options === 'object' && Object.keys(options).length === 0)\n    return true;\n  return false;\n}\n\n// Get string value for comparison (only strings are compared for re-show logic)\nfunction getStringValue(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\n/**\n * Hook to display a progress toast that persists while loading.\n *\n * @example\n * ```tsx\n * useProgressToast(\n *   isLoading\n *     ? { isLoading: true, title: 'Saving...', icon: <Spinner /> }\n *     : { isLoading: false, title: 'Saved!', icon: <IconCheck />, theme: 'success' }\n * );\n *\n * // Or with error handling:\n * useProgressToast(\n *   isLoading\n *     ? { isLoading: true, title: 'Saving...', icon: <Spinner /> }\n *     : isError\n *       ? { isLoading: false, title: 'Error', description: errorMessage, theme: 'danger' }\n *       : { isLoading: false, title: 'Saved!', theme: 'success' }\n * );\n *\n * // Pass empty value to immediately remove any existing toast:\n * useProgressToast(shouldShow ? { isLoading: true, title: 'Loading...' } : null);\n *\n * // Or call with no argument to dismiss:\n * useProgressToast();\n * ```\n */\nexport function useProgressToast(\n  options?: ProgressToastOptions | ProgressToastEmpty,\n): void {\n  const { addToast, removeToast } = useToastContext();\n\n  const toastIdRef = useRef<Key | null>(null);\n  const wasLoadingRef = useRef<boolean | null>(null);\n  const hideTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const isFirstRenderRef = useRef(true);\n  const optionsRef = useRef(options);\n  const hasBeenLoadingRef = useRef(false);\n\n  // Track previous string values for re-show comparison\n  const prevThemeRef = useRef<string | undefined>(undefined);\n  const prevTitleRef = useRef<string | undefined>(undefined);\n  const prevDescriptionRef = useRef<string | undefined>(undefined);\n\n  // Always update optionsRef to latest\n  optionsRef.current = options;\n\n  // Clear any pending hide timer\n  const clearHideTimer = () => {\n    if (hideTimerRef.current) {\n      clearTimeout(hideTimerRef.current);\n      hideTimerRef.current = null;\n    }\n  };\n\n  // Check if current options are empty\n  const isEmpty = isEmptyOptions(options);\n\n  // Extract values only when options are not empty\n  const isLoading = isEmpty ? false : options.isLoading;\n  const currentTheme = isEmpty ? undefined : options.theme;\n  const currentTitle = isEmpty ? undefined : getStringValue(options.title);\n  const currentDescription = isEmpty\n    ? undefined\n    : getStringValue(options.description);\n\n  useEffect(() => {\n    const wasLoading = wasLoadingRef.current;\n    const isFirstRender = isFirstRenderRef.current;\n    const currentOptions = optionsRef.current;\n    const currentIsEmpty = isEmptyOptions(currentOptions);\n\n    // Handle empty options - immediately remove any existing toast\n    if (currentIsEmpty) {\n      clearHideTimer();\n\n      if (toastIdRef.current != null) {\n        removeToast(toastIdRef.current);\n        toastIdRef.current = null;\n      }\n\n      // Reset loading gate so the next cycle requires isLoading again\n      hasBeenLoadingRef.current = false;\n      wasLoadingRef.current = null;\n      isFirstRenderRef.current = false;\n      prevThemeRef.current = undefined;\n      prevTitleRef.current = undefined;\n      prevDescriptionRef.current = undefined;\n      return;\n    }\n\n    // From here, we know options is a valid ProgressToastOptions\n    const { isLoading: currentIsLoading, ...currentToastData } = currentOptions;\n\n    // Check if meaningful data changed (only string values)\n    const themeChanged = currentTheme !== prevThemeRef.current;\n    const titleChanged = currentTitle !== prevTitleRef.current;\n    const descriptionChanged =\n      currentDescription !== prevDescriptionRef.current;\n    const dataChanged = themeChanged || titleChanged || descriptionChanged;\n\n    // Helper to create a new toast (removes old one first if exists)\n    const showToast = () => {\n      // Remove existing toast if any\n      if (toastIdRef.current != null) {\n        removeToast(toastIdRef.current);\n      }\n\n      // Create new toast with fresh data\n      // Icon auto-resolved by ToastItem based on theme/isLoading\n      toastIdRef.current = addToast(\n        {\n          ...currentToastData,\n          isLoading: currentIsLoading,\n          duration: null, // Persistent - we control removal\n        },\n        true, // isProgress = true\n      );\n    };\n\n    // Helper to show toast and schedule removal\n    const showToastWithTimer = () => {\n      showToast();\n\n      // Schedule removal after result duration\n      hideTimerRef.current = setTimeout(() => {\n        if (toastIdRef.current != null) {\n          removeToast(toastIdRef.current);\n          toastIdRef.current = null;\n        }\n      }, RESULT_DURATION);\n    };\n\n    if (currentIsLoading) {\n      // Starting or continuing loading\n      hasBeenLoadingRef.current = true;\n      clearHideTimer();\n\n      if (toastIdRef.current == null) {\n        // Create new toast\n        showToast();\n      } else if (dataChanged) {\n        // Toast exists but data changed (e.g., switching back to loading from another state)\n        showToast();\n      }\n    } else if (wasLoading === true && !currentIsLoading) {\n      // Transitioning from loading to not loading\n      clearHideTimer();\n\n      if (currentTitle) {\n        // Show result toast with timer\n        showToastWithTimer();\n      } else {\n        // No content - just remove the loading toast immediately\n        if (toastIdRef.current != null) {\n          removeToast(toastIdRef.current);\n          toastIdRef.current = null;\n        }\n      }\n    } else if (\n      !currentIsLoading &&\n      !isFirstRender &&\n      hasBeenLoadingRef.current &&\n      dataChanged\n    ) {\n      // Not loading, data changed after a loading cycle - update or re-show toast\n      if (currentTitle) {\n        clearHideTimer();\n        showToastWithTimer();\n      } else if (toastIdRef.current != null) {\n        clearHideTimer();\n        removeToast(toastIdRef.current);\n        toastIdRef.current = null;\n      }\n    }\n\n    // Update refs for next comparison\n    wasLoadingRef.current = currentIsLoading;\n    isFirstRenderRef.current = false;\n    prevThemeRef.current = currentTheme;\n    prevTitleRef.current = currentTitle;\n    prevDescriptionRef.current = currentDescription;\n  }, [\n    isEmpty,\n    isLoading,\n    currentTheme,\n    currentTitle,\n    currentDescription,\n    addToast,\n    removeToast,\n  ]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      clearHideTimer();\n\n      if (toastIdRef.current != null) {\n        removeToast(toastIdRef.current);\n        toastIdRef.current = null;\n      }\n    };\n  }, [removeToast]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"useProgressToast.js","names":[],"sources":["../../../../src/components/overlays/Toast/useProgressToast.tsx"],"sourcesContent":["import { Key, useEffect, useRef } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { ItemAction } from '../../actions/ItemAction/ItemAction';\n\nimport { useToastContext } from './ToastProvider';\n\nimport type {\n  ProgressToastEmpty,\n  ProgressToastOptions,\n  ToastData,\n} from './types';\n\nconst RESULT_DURATION = 3000;\n\n/**\n * Check if the options represent an \"empty\" value (null, undefined, false, or empty object).\n * When empty, the hook should immediately remove any existing toast.\n */\nfunction isEmptyOptions(\n  options: ProgressToastOptions | ProgressToastEmpty,\n): options is ProgressToastEmpty {\n  if (options == null || options === false) return true;\n  if (typeof options === 'object' && Object.keys(options).length === 0)\n    return true;\n  return false;\n}\n\n// Get string value for comparison (only strings are compared for re-show logic)\nfunction getStringValue(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\n/**\n * Hook to display a progress toast that persists while loading.\n *\n * @example\n * ```tsx\n * useProgressToast(\n *   isLoading\n *     ? { isLoading: true, title: 'Saving...', icon: <Spinner /> }\n *     : { isLoading: false, title: 'Saved!', icon: <IconCheck />, theme: 'success' }\n * );\n *\n * // Or with error handling:\n * useProgressToast(\n *   isLoading\n *     ? { isLoading: true, title: 'Saving...', icon: <Spinner /> }\n *     : isError\n *       ? { isLoading: false, title: 'Error', description: errorMessage, theme: 'danger' }\n *       : { isLoading: false, title: 'Saved!', theme: 'success' }\n * );\n *\n * // Pass empty value to immediately remove any existing toast:\n * useProgressToast(shouldShow ? { isLoading: true, title: 'Loading...' } : null);\n *\n * // Or call with no argument to dismiss:\n * useProgressToast();\n * ```\n */\nexport function useProgressToast(\n  options?: ProgressToastOptions | ProgressToastEmpty,\n): void {\n  const { addToast, removeToast, updateToast } = useToastContext();\n\n  const toastIdRef = useRef<Key | null>(null);\n  const wasLoadingRef = useRef<boolean | null>(null);\n  const hideTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const isFirstRenderRef = useRef(true);\n  const optionsRef = useRef(options);\n  const hasBeenLoadingRef = useRef(false);\n  const hiddenByUserRef = useRef(false);\n\n  // Track previous string values for re-show comparison\n  const prevThemeRef = useRef<string | undefined>(undefined);\n  const prevTitleRef = useRef<string | undefined>(undefined);\n  const prevDescriptionRef = useRef<string | undefined>(undefined);\n\n  // Always update optionsRef to latest\n  optionsRef.current = options;\n\n  // Clear any pending hide timer\n  const clearHideTimer = () => {\n    if (hideTimerRef.current) {\n      clearTimeout(hideTimerRef.current);\n      hideTimerRef.current = null;\n    }\n  };\n\n  // Check if current options are empty\n  const isEmpty = isEmptyOptions(options);\n\n  // Extract values only when options are not empty\n  const isLoading = isEmpty ? false : options.isLoading;\n  const isDismissable = isEmpty ? false : !!options.isDismissable;\n  const currentTheme = isEmpty ? undefined : options.theme;\n  const currentTitle = isEmpty ? undefined : getStringValue(options.title);\n  const currentDescription = isEmpty\n    ? undefined\n    : getStringValue(options.description);\n\n  const handleHide = useEvent(() => {\n    if (toastIdRef.current != null) {\n      removeToast(toastIdRef.current);\n      toastIdRef.current = null;\n    }\n\n    hiddenByUserRef.current = true;\n  });\n\n  useEffect(() => {\n    const wasLoading = wasLoadingRef.current;\n    const isFirstRender = isFirstRenderRef.current;\n    const currentOptions = optionsRef.current;\n    const currentIsEmpty = isEmptyOptions(currentOptions);\n\n    // Handle empty options - immediately remove any existing toast\n    if (currentIsEmpty) {\n      clearHideTimer();\n\n      if (toastIdRef.current != null) {\n        removeToast(toastIdRef.current);\n        toastIdRef.current = null;\n      }\n\n      // Reset loading gate so the next cycle requires isLoading again\n      hasBeenLoadingRef.current = false;\n      hiddenByUserRef.current = false;\n      wasLoadingRef.current = null;\n      isFirstRenderRef.current = false;\n      prevThemeRef.current = undefined;\n      prevTitleRef.current = undefined;\n      prevDescriptionRef.current = undefined;\n      return;\n    }\n\n    // From here, we know options is a valid ProgressToastOptions\n    const {\n      isLoading: currentIsLoading,\n      isDismissable: _isDismissable,\n      ...currentToastData\n    } = currentOptions;\n\n    // Check if meaningful data changed (only string values)\n    const themeChanged = currentTheme !== prevThemeRef.current;\n    const titleChanged = currentTitle !== prevTitleRef.current;\n    const descriptionChanged =\n      currentDescription !== prevDescriptionRef.current;\n    const dataChanged = themeChanged || titleChanged || descriptionChanged;\n\n    const hideAction =\n      isDismissable && currentIsLoading ? (\n        <ItemAction type=\"secondary\" onPress={handleHide}>\n          Hide\n        </ItemAction>\n      ) : null;\n\n    const mergedActions = hideAction ? (\n      <>\n        {currentToastData.actions}\n        {hideAction}\n      </>\n    ) : (\n      currentToastData.actions\n    );\n\n    const toastData: ToastData = {\n      title: undefined,\n      description: undefined,\n      theme: undefined,\n      icon: undefined,\n      itemProps: undefined,\n      ...currentToastData,\n      actions: mergedActions,\n      isLoading: currentIsLoading,\n      duration: null,\n    };\n\n    // Show a new toast or update an existing one in-place (no exit/enter animation).\n    const showToast = () => {\n      if (toastIdRef.current != null) {\n        updateToast(toastIdRef.current, toastData);\n      } else {\n        toastIdRef.current = addToast(toastData, true);\n      }\n    };\n\n    // Show/update toast and schedule removal after RESULT_DURATION.\n    const showToastWithTimer = () => {\n      showToast();\n\n      hideTimerRef.current = setTimeout(() => {\n        if (toastIdRef.current != null) {\n          removeToast(toastIdRef.current);\n          toastIdRef.current = null;\n        }\n      }, RESULT_DURATION);\n    };\n\n    if (currentIsLoading) {\n      // Starting or continuing loading\n      hasBeenLoadingRef.current = true;\n      clearHideTimer();\n\n      if (hiddenByUserRef.current) {\n        // User dismissed the loading toast; don't re-show during this loading cycle.\n      } else if (toastIdRef.current == null) {\n        // Create new toast\n        showToast();\n      } else if (dataChanged) {\n        // Toast exists but data changed (e.g., switching back to loading from another state)\n        showToast();\n      }\n    } else if (wasLoading === true && !currentIsLoading) {\n      // Transitioning from loading to not loading\n      hiddenByUserRef.current = false;\n      clearHideTimer();\n\n      if (currentTitle) {\n        // Show result toast with timer\n        showToastWithTimer();\n      } else {\n        // No content - just remove the loading toast immediately\n        if (toastIdRef.current != null) {\n          removeToast(toastIdRef.current);\n          toastIdRef.current = null;\n        }\n      }\n    } else if (\n      !currentIsLoading &&\n      !isFirstRender &&\n      hasBeenLoadingRef.current &&\n      dataChanged &&\n      toastIdRef.current != null\n    ) {\n      // Not loading, data changed while toast is still visible — update it.\n      if (currentTitle) {\n        clearHideTimer();\n        showToastWithTimer();\n      } else {\n        clearHideTimer();\n        removeToast(toastIdRef.current);\n        toastIdRef.current = null;\n      }\n    }\n\n    // Update refs for next comparison\n    wasLoadingRef.current = currentIsLoading;\n    isFirstRenderRef.current = false;\n    prevThemeRef.current = currentTheme;\n    prevTitleRef.current = currentTitle;\n    prevDescriptionRef.current = currentDescription;\n  }, [\n    isEmpty,\n    isLoading,\n    isDismissable,\n    currentTheme,\n    currentTitle,\n    currentDescription,\n    addToast,\n    removeToast,\n    updateToast,\n    handleHide,\n  ]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    return () => {\n      clearHideTimer();\n\n      if (toastIdRef.current != null) {\n        removeToast(toastIdRef.current);\n        toastIdRef.current = null;\n      }\n    };\n  }, [removeToast]);\n}\n"],"mappings":"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"}

package/dist/components/overlays/Toast/useToast.js

@@ -1,12 +1,12 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
 import { CheckIcon } from "../../../icons/CheckIcon.js";
 import { DangerIcon } from "../../../icons/DangerIcon.js";
 import { InfoCircleIcon } from "../../../icons/InfoCircleIcon.js";
 import { WarningIcon } from "../../../icons/WarningIcon.js";
 import { useToastContext } from "../Notifications/NotificationContext.js";
 import { isValidElement, useMemo } from "react";
-import { isFragment } from "react-is";
 import { jsx } from "react/jsx-runtime";
+import { isFragment } from "react-is";
 
 //#region src/components/overlays/Toast/useToast.tsx
 const THEME_ICONS = {

package/dist/components/overlays/Tooltip/Tooltip.d.ts

@@ -1,8 +1,6 @@
 
-import { Styles } from "../../../tasty/styles/types.js";
-import { BaseProps, ContainerStyleProps } from "../../../tasty/types.js";
-import "../../../tasty/index.js";
 import { PlacementAxis } from "../../../shared/index.js";
+import { BaseProps, ContainerStyleProps, Styles } from "@tenphi/tasty";
 import * as react from "react";
 import { AriaTooltipProps } from "react-aria";
 import { DOMRefValue } from "@react-types/shared";

package/dist/components/overlays/Tooltip/Tooltip.js

@@ -1,11 +1,9 @@
-/** @license MIT | @cube-dev/ui-kit v0.117.0 | Cube Dev Team */
-import { extractStyles } from "../../../tasty/utils/styles.js";
-import { CONTAINER_STYLES } from "../../../tasty/styles/list.js";
-import { tasty } from "../../../tasty/tasty.js";
+/** @license MIT | @cube-dev/ui-kit v0.119.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../../../utils/react/useLayoutEffect.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { mergeRefs } from "../../../utils/react/useCombinedRefs.js";
 import { TooltipContext } from "./context.js";
+import { CONTAINER_STYLES, extractStyles, tasty } from "@tenphi/tasty";
 import { forwardRef, useContext, useImperativeHandle, useMemo, useRef } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useTooltip } from "react-aria";