@cube-dev/ui-kit 0.196.0 → 0.198.0

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

@@ -1,16 +1,15 @@
 
 import { Key, ReactNode } from "react";
-
 //#region src/components/overlays/Notifications/types.d.ts
-type NotificationType = 'default' | 'success' | 'danger' | 'warning' | 'note';
-interface NotificationBaseOptions {
+export type NotificationType = 'default' | 'success' | 'danger' | 'warning' | 'note';
+export interface NotificationBaseOptions {
   id?: Key;
   theme?: NotificationType;
   title?: ReactNode;
   description?: ReactNode;
   icon?: ReactNode;
 }
-interface OverlayNotificationOptions extends NotificationBaseOptions {
+export interface OverlayNotificationOptions extends NotificationBaseOptions {
   mode?: 'overlay';
   /**
    * Action buttons rendered below the notification description.
@@ -49,7 +48,7 @@ interface OverlayNotificationOptions extends NotificationBaseOptions {
    */
   persistent?: boolean;
 }
-interface StoredNotificationOptions extends NotificationBaseOptions {
+export interface StoredNotificationOptions extends NotificationBaseOptions {
   mode: 'stored';
   /** Action buttons (same ReactNode format as overlay notifications) */
   actions?: ReactNode;
@@ -60,9 +59,9 @@ interface StoredNotificationOptions extends NotificationBaseOptions {
    */
   createdAt?: number;
 }
-type NotificationOptions = OverlayNotificationOptions | StoredNotificationOptions;
-type DismissReason = 'close' | 'timeout' | 'action' | 'api';
-interface NotificationActionProps {
+export type NotificationOptions = OverlayNotificationOptions | StoredNotificationOptions;
+export type DismissReason = 'close' | 'timeout' | 'action' | 'api';
+export interface NotificationActionProps {
   /** Action label */
   children?: ReactNode;
   /**
@@ -82,11 +81,11 @@ interface NotificationActionProps {
    */
   isDismiss?: boolean;
 }
-interface NotificationHandle {
+export interface NotificationHandle {
   id: Key;
   dismiss: () => void;
 }
-interface NotificationsApi {
+export interface NotificationsApi {
   notify: (options: NotificationOptions) => NotificationHandle;
   /**
    * Shorthand for `notify({ mode: 'stored', ... })`.
@@ -96,7 +95,7 @@ interface NotificationsApi {
   record: (options: Omit<StoredNotificationOptions, 'mode'>) => NotificationHandle;
   dismiss: (id: Key) => void;
 }
-interface InternalNotification extends OverlayNotificationOptions {
+export interface InternalNotification extends OverlayNotificationOptions {
   internalId: string;
   createdAt: number;
   updatedAt: number;
@@ -105,7 +104,7 @@ interface InternalNotification extends OverlayNotificationOptions {
   lastDismissReason?: DismissReason;
   ownerId?: string;
 }
-interface PersistentNotificationItem {
+export interface PersistentNotificationItem {
   id: Key;
   theme?: NotificationType;
   title?: ReactNode;
@@ -120,18 +119,17 @@ interface PersistentNotificationItem {
   /** Owner ID for cleanup on hook/component unmount */
   ownerId?: string;
 }
-interface PersistentNotificationsListProps {
+export interface PersistentNotificationsListProps {
   onDismissItem?: (item: PersistentNotificationItem) => void;
   /** Called before any action's onPress handler fires. Useful for closing a parent popover. */
   onAction?: () => void;
   emptyState?: ReactNode;
 }
-interface OverlayProviderProps {
+export interface OverlayProviderProps {
   children: ReactNode;
   /** Maximum number of persistent notifications to keep. Default: 200 */
   maxPersistentNotifications?: number;
 }
-interface NotificationProps extends OverlayNotificationOptions {}
+export interface NotificationProps extends OverlayNotificationOptions {}
 //#endregion
-export { DismissReason, InternalNotification, NotificationActionProps, NotificationBaseOptions, NotificationHandle, NotificationOptions, NotificationProps, NotificationType, NotificationsApi, OverlayNotificationOptions, OverlayProviderProps, PersistentNotificationItem, PersistentNotificationsListProps, StoredNotificationOptions };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1,13 +1,12 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useRef, useState } from "react";
-
 //#region src/components/overlays/Notifications/use-notification-state.ts
 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;
+const SNAPSHOT_TTL_MS = 3e5;
 function getDuration(notif) {
 	if (notif.duration === null) return null;
 	if (notif.duration !== void 0) return notif.duration;
@@ -219,7 +218,7 @@ function useNotificationState(timersRef, persistent) {
 		})
 	};
 }
-
 //#endregion
 export { useNotificationState };
+
 //# sourceMappingURL=use-notification-state.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-notification-state.js","names":["Key","useRef","useState","useEvent","DismissReason","InternalNotification","OverlayNotificationOptions","PersistentNotificationItem","OverlayTimers","DEFAULT_NOTIFICATION_DURATION","DEFAULT_PERSISTENT_NOTIFICATION_DURATION","MAX_NOTIFICATIONS","MAX_DISMISS_SNAPSHOTS","SNAPSHOT_TTL_MS","PersistentCallbacks","addPersistentItem","item","removePersistentItem","id","removePersistentItemSilently","hasDismissedPersistentId","isFullyDismissedId","saveDismissedPersistentId","undoFullyDismissedId","NotificationState","notifications","notificationsRef","ReturnType","addNotification","options","ownerId","removeNotification","reason","restoreNotification","updateNotification","Partial","finalizeNotificationRemoval","internalId","removeByOwner","getDuration","notif","persistent","duration","undefined","matchesNotificationId","String","findNotification","list","find","n","useNotificationState","timersRef","setNotifications","current","idCounter","dismissSnapshotsRef","Map","evictOldest","active","filter","isExiting","length","oldest","clearNotificationTimer","theme","title","description","icon","actions","createdAt","updatedAt","isRead","set","lastDismissReason","size","keys","next","value","delete","prev","map","idStr","snapshot","get","persistentId","startNotificationTimer","stillInState","restored","setTimeout","key","snap","Date","now","existingNotif","returnId","prevTitle","prevDescription","titleChanged","descriptionChanged","activeCount","newNotification","evictedInternalId","owned"],"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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"}
+{"version":3,"file":"use-notification-state.js","names":["Key","useRef","useState","useEvent","DismissReason","InternalNotification","OverlayNotificationOptions","PersistentNotificationItem","OverlayTimers","DEFAULT_NOTIFICATION_DURATION","DEFAULT_PERSISTENT_NOTIFICATION_DURATION","MAX_NOTIFICATIONS","MAX_DISMISS_SNAPSHOTS","SNAPSHOT_TTL_MS","PersistentCallbacks","addPersistentItem","item","removePersistentItem","id","removePersistentItemSilently","hasDismissedPersistentId","isFullyDismissedId","saveDismissedPersistentId","undoFullyDismissedId","NotificationState","notifications","notificationsRef","ReturnType","addNotification","options","ownerId","removeNotification","reason","restoreNotification","updateNotification","Partial","finalizeNotificationRemoval","internalId","removeByOwner","getDuration","notif","persistent","duration","undefined","matchesNotificationId","String","findNotification","list","find","n","useNotificationState","timersRef","setNotifications","current","idCounter","dismissSnapshotsRef","Map","evictOldest","active","filter","isExiting","length","oldest","clearNotificationTimer","theme","title","description","icon","actions","createdAt","updatedAt","isRead","set","lastDismissReason","size","keys","next","value","delete","prev","map","idStr","snapshot","get","persistentId","startNotificationTimer","stillInState","restored","setTimeout","key","snap","Date","now","existingNotif","returnId","prevTitle","prevDescription","titleChanged","descriptionChanged","activeCount","newNotification","evictedInternalId","owned"],"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.d.ts

@@ -1,6 +1,5 @@
 
 import { NotificationsApi } from "./types.js";
-
 //#region src/components/overlays/Notifications/use-notifications.d.ts
 /**
  * Hook to display and manage notifications.
@@ -36,7 +35,6 @@ import { NotificationsApi } from "./types.js";
  * });
  * ```
  */
-declare function useNotifications(): NotificationsApi;
+export declare function useNotifications(): NotificationsApi;
 //#endregion
-export { useNotifications };
 //# sourceMappingURL=use-notifications.d.ts.map

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

@@ -1,9 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.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";
 import { useEffect, useRef } from "react";
-
 //#region src/components/overlays/Notifications/use-notifications.ts
 let ownerIdCounter = 0;
 function generateOwnerId() {
@@ -69,7 +68,7 @@ function useNotifications() {
 		const now = Date.now();
 		const id = options.id ?? `stored-${storedIdCounter.current}-${now}`;
 		const createdAt = options.createdAt ?? now;
-		addPersistentItem({
+		const persistentItem = {
 			id,
 			theme: options.theme,
 			title: options.title,
@@ -79,7 +78,8 @@ function useNotifications() {
 			createdAt,
 			updatedAt: createdAt,
 			ownerId: ownerIdRef.current
-		});
+		};
+		addPersistentItem(persistentItem);
 		return {
 			id,
 			dismiss: () => {
@@ -94,10 +94,11 @@ function useNotifications() {
 		};
 		lastOptionsRef.current = options_0;
 		if (isStoredMode(options_0)) return createStoredHandle(options_0);
-		const notificationId = addNotification({
+		const overlayOptions = {
 			...options_0,
 			mode: "overlay"
-		}, ownerIdRef.current);
+		};
+		const notificationId = addNotification(overlayOptions, ownerIdRef.current);
 		return {
 			id: notificationId,
 			dismiss: () => {
@@ -140,7 +141,7 @@ function useNotifications() {
 		dismiss
 	};
 }
-
 //#endregion
 export { useNotifications };
+
 //# sourceMappingURL=use-notifications.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-notifications.js","names":["Key","useEffect","useRef","useEvent","useWarn","useNotificationContext","NotificationHandle","NotificationOptions","NotificationsApi","OverlayNotificationOptions","PersistentNotificationItem","StoredNotificationOptions","ownerIdCounter","generateOwnerId","Date","now","isStoredMode","options","mode","useNotifications","addNotification","removeNotification","addPersistentItem","removePersistentItem","removeByOwner","removePersistentItemsByOwner","ownerIdRef","isMountedRef","cleanupTimerRef","ReturnType","setTimeout","lastOptionsRef","current","persistent","id","once","key","args","storedIdCounter","createStoredHandle","Omit","createdAt","persistentItem","theme","title","description","icon","actions","undefined","updatedAt","ownerId","dismiss","notify","overlayOptions","notificationId","record","clearTimeout"],"sources":["../../../../src/components/overlays/Notifications/use-notifications.ts"],"sourcesContent":["import { Key, useEffect, useRef } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { useWarn } from '../../../_internal/hooks/use-warn';\n\nimport { useNotificationContext } from './NotificationContext';\n\nimport type {\n  NotificationHandle,\n  NotificationOptions,\n  NotificationsApi,\n  OverlayNotificationOptions,\n  PersistentNotificationItem,\n  StoredNotificationOptions,\n} from './types';\n\nlet ownerIdCounter = 0;\n\nfunction generateOwnerId(): string {\n  ownerIdCounter += 1;\n  return `notif-owner-${ownerIdCounter}-${Date.now()}`;\n}\n\nfunction isStoredMode(\n  options: NotificationOptions,\n): options is StoredNotificationOptions {\n  return options.mode === 'stored';\n}\n\n/**\n * Hook to display and manage notifications.\n *\n * Each hook instance acts as an owner scope:\n * - `notify()` created from this instance attaches ownership metadata.\n * - On unmount, all attached visible overlay notifications are dismissed.\n * - On unmount, all attached persistent records are also removed.\n * - `notify()`/`dismiss()` calls from stale closures after unmount are no-ops.\n *\n * @example\n * ```tsx\n * const { notify, record, dismiss } = useNotifications();\n *\n * notify({\n *   id: 'deploy:123',\n *   theme: 'success',\n *   title: 'Deployment completed',\n *   description: 'Version 1.4.2 is live.',\n *   actions: (\n *     <>\n *       <Notification.Action onPress={() => openLogs()}>View logs</Notification.Action>\n *       <Notification.Action onPress={() => openDeployment()}>Open</Notification.Action>\n *     </>\n *   ),\n * });\n *\n * // Store directly to persistent list (no overlay)\n * record({\n *   id: 'server:alert-1',\n *   theme: 'warning',\n *   title: 'Server alert',\n * });\n * ```\n */\nexport function useNotifications(): NotificationsApi {\n  const {\n    addNotification,\n    removeNotification,\n    addPersistentItem,\n    removePersistentItem,\n    removeByOwner,\n    removePersistentItemsByOwner,\n  } = useNotificationContext();\n\n  const ownerIdRef = useRef<string>(generateOwnerId());\n  const isMountedRef = useRef(true);\n  const cleanupTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Track current options for validation\n  const lastOptionsRef = useRef<NotificationOptions | null>(null);\n\n  // ─── Validation Warnings ──────────────────────────────────────────\n\n  useWarn(\n    lastOptionsRef.current &&\n      'persistent' in lastOptionsRef.current &&\n      lastOptionsRef.current.persistent === true &&\n      lastOptionsRef.current.id == null,\n    {\n      once: false,\n      key: ['Notification', 'persistent-without-id'],\n      args: [\n        'Notification: `persistent: true` requires an explicit `id` for reliable dedupe/upsert.',\n      ],\n    },\n  );\n\n  useWarn(\n    lastOptionsRef.current?.mode === 'stored' &&\n      lastOptionsRef.current.id == null,\n    {\n      once: false,\n      key: ['Notification', 'stored-without-id'],\n      args: [\n        'Notification: `mode: \"stored\"` should have an explicit `id` for reliable upsert.',\n      ],\n    },\n  );\n\n  // ─── Helpers ─────────────────────────────────────────────────────\n\n  const storedIdCounter = useRef(0);\n\n  const createStoredHandle = useEvent(\n    (options: Omit<StoredNotificationOptions, 'mode'>): NotificationHandle => {\n      storedIdCounter.current += 1;\n      const now = Date.now();\n      const id = options.id ?? `stored-${storedIdCounter.current}-${now}`;\n      const createdAt = options.createdAt ?? now;\n\n      const persistentItem: PersistentNotificationItem = {\n        id,\n        theme: options.theme,\n        title: options.title,\n        description: options.description,\n        icon: options.icon,\n        actions: options.actions ?? undefined,\n        createdAt,\n        updatedAt: createdAt,\n        ownerId: ownerIdRef.current,\n      };\n\n      addPersistentItem(persistentItem);\n\n      return {\n        id,\n        dismiss: () => {\n          removePersistentItem(id);\n        },\n      };\n    },\n  );\n\n  // ─── API ──────────────────────────────────────────────────────────\n\n  const notify = useEvent(\n    (options: NotificationOptions): NotificationHandle => {\n      // Stale closure guard\n      if (!isMountedRef.current) {\n        return {\n          id: options.id ?? '',\n          dismiss: () => {},\n        };\n      }\n\n      lastOptionsRef.current = options;\n\n      if (isStoredMode(options)) {\n        return createStoredHandle(options);\n      }\n\n      // Overlay mode\n      const overlayOptions: OverlayNotificationOptions = {\n        ...options,\n        mode: 'overlay',\n      };\n\n      const notificationId = addNotification(\n        overlayOptions,\n        ownerIdRef.current,\n      );\n\n      return {\n        id: notificationId,\n        dismiss: () => {\n          if (isMountedRef.current) {\n            removeNotification(notificationId, 'api');\n          }\n        },\n      };\n    },\n  );\n\n  // `record()` is intentionally kept as a separate method from `notify()` to make\n  // the API more explicit: `record()` always stores directly to the persistent list\n  // (no overlay), while `notify()` defaults to overlay mode. Having both avoids\n  // the caller needing to remember to pass `mode: 'stored'` every time.\n  const record = useEvent(\n    (options: Omit<StoredNotificationOptions, 'mode'>): NotificationHandle => {\n      // Stale closure guard\n      if (!isMountedRef.current) {\n        return {\n          id: options.id ?? '',\n          dismiss: () => {},\n        };\n      }\n\n      lastOptionsRef.current = { ...options, mode: 'stored' };\n\n      return createStoredHandle(options);\n    },\n  );\n\n  const dismiss = useEvent((id: Key) => {\n    if (!isMountedRef.current) return;\n\n    removeNotification(id, 'api');\n  });\n\n  // ─── Ownership Cleanup ────────────────────────────────────────────\n\n  useEffect(() => {\n    isMountedRef.current = true;\n\n    // Cancel any pending cleanup (Strict Mode re-mount)\n    if (cleanupTimerRef.current) {\n      clearTimeout(cleanupTimerRef.current);\n      cleanupTimerRef.current = null;\n    }\n\n    return () => {\n      isMountedRef.current = false;\n\n      // Deferred cleanup — cancelled if owner re-mounts within same tick\n      // (Strict Mode / Suspense safe)\n      cleanupTimerRef.current = setTimeout(() => {\n        removeByOwner(ownerIdRef.current);\n        removePersistentItemsByOwner(ownerIdRef.current);\n      }, 0);\n    };\n  }, [removeByOwner, removePersistentItemsByOwner]);\n\n  return { notify, record, dismiss };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-notifications.js","names":["Key","useEffect","useRef","useEvent","useWarn","useNotificationContext","NotificationHandle","NotificationOptions","NotificationsApi","OverlayNotificationOptions","PersistentNotificationItem","StoredNotificationOptions","ownerIdCounter","generateOwnerId","Date","now","isStoredMode","options","mode","useNotifications","addNotification","removeNotification","addPersistentItem","removePersistentItem","removeByOwner","removePersistentItemsByOwner","ownerIdRef","isMountedRef","cleanupTimerRef","ReturnType","setTimeout","lastOptionsRef","current","persistent","id","once","key","args","storedIdCounter","createStoredHandle","Omit","createdAt","persistentItem","theme","title","description","icon","actions","undefined","updatedAt","ownerId","dismiss","notify","overlayOptions","notificationId","record","clearTimeout"],"sources":["../../../../src/components/overlays/Notifications/use-notifications.ts"],"sourcesContent":["import { Key, useEffect, useRef } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { useWarn } from '../../../_internal/hooks/use-warn';\n\nimport { useNotificationContext } from './NotificationContext';\n\nimport type {\n  NotificationHandle,\n  NotificationOptions,\n  NotificationsApi,\n  OverlayNotificationOptions,\n  PersistentNotificationItem,\n  StoredNotificationOptions,\n} from './types';\n\nlet ownerIdCounter = 0;\n\nfunction generateOwnerId(): string {\n  ownerIdCounter += 1;\n  return `notif-owner-${ownerIdCounter}-${Date.now()}`;\n}\n\nfunction isStoredMode(\n  options: NotificationOptions,\n): options is StoredNotificationOptions {\n  return options.mode === 'stored';\n}\n\n/**\n * Hook to display and manage notifications.\n *\n * Each hook instance acts as an owner scope:\n * - `notify()` created from this instance attaches ownership metadata.\n * - On unmount, all attached visible overlay notifications are dismissed.\n * - On unmount, all attached persistent records are also removed.\n * - `notify()`/`dismiss()` calls from stale closures after unmount are no-ops.\n *\n * @example\n * ```tsx\n * const { notify, record, dismiss } = useNotifications();\n *\n * notify({\n *   id: 'deploy:123',\n *   theme: 'success',\n *   title: 'Deployment completed',\n *   description: 'Version 1.4.2 is live.',\n *   actions: (\n *     <>\n *       <Notification.Action onPress={() => openLogs()}>View logs</Notification.Action>\n *       <Notification.Action onPress={() => openDeployment()}>Open</Notification.Action>\n *     </>\n *   ),\n * });\n *\n * // Store directly to persistent list (no overlay)\n * record({\n *   id: 'server:alert-1',\n *   theme: 'warning',\n *   title: 'Server alert',\n * });\n * ```\n */\nexport function useNotifications(): NotificationsApi {\n  const {\n    addNotification,\n    removeNotification,\n    addPersistentItem,\n    removePersistentItem,\n    removeByOwner,\n    removePersistentItemsByOwner,\n  } = useNotificationContext();\n\n  const ownerIdRef = useRef<string>(generateOwnerId());\n  const isMountedRef = useRef(true);\n  const cleanupTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Track current options for validation\n  const lastOptionsRef = useRef<NotificationOptions | null>(null);\n\n  // ─── Validation Warnings ──────────────────────────────────────────\n\n  useWarn(\n    lastOptionsRef.current &&\n      'persistent' in lastOptionsRef.current &&\n      lastOptionsRef.current.persistent === true &&\n      lastOptionsRef.current.id == null,\n    {\n      once: false,\n      key: ['Notification', 'persistent-without-id'],\n      args: [\n        'Notification: `persistent: true` requires an explicit `id` for reliable dedupe/upsert.',\n      ],\n    },\n  );\n\n  useWarn(\n    lastOptionsRef.current?.mode === 'stored' &&\n      lastOptionsRef.current.id == null,\n    {\n      once: false,\n      key: ['Notification', 'stored-without-id'],\n      args: [\n        'Notification: `mode: \"stored\"` should have an explicit `id` for reliable upsert.',\n      ],\n    },\n  );\n\n  // ─── Helpers ─────────────────────────────────────────────────────\n\n  const storedIdCounter = useRef(0);\n\n  const createStoredHandle = useEvent(\n    (options: Omit<StoredNotificationOptions, 'mode'>): NotificationHandle => {\n      storedIdCounter.current += 1;\n      const now = Date.now();\n      const id = options.id ?? `stored-${storedIdCounter.current}-${now}`;\n      const createdAt = options.createdAt ?? now;\n\n      const persistentItem: PersistentNotificationItem = {\n        id,\n        theme: options.theme,\n        title: options.title,\n        description: options.description,\n        icon: options.icon,\n        actions: options.actions ?? undefined,\n        createdAt,\n        updatedAt: createdAt,\n        ownerId: ownerIdRef.current,\n      };\n\n      addPersistentItem(persistentItem);\n\n      return {\n        id,\n        dismiss: () => {\n          removePersistentItem(id);\n        },\n      };\n    },\n  );\n\n  // ─── API ──────────────────────────────────────────────────────────\n\n  const notify = useEvent(\n    (options: NotificationOptions): NotificationHandle => {\n      // Stale closure guard\n      if (!isMountedRef.current) {\n        return {\n          id: options.id ?? '',\n          dismiss: () => {},\n        };\n      }\n\n      lastOptionsRef.current = options;\n\n      if (isStoredMode(options)) {\n        return createStoredHandle(options);\n      }\n\n      // Overlay mode\n      const overlayOptions: OverlayNotificationOptions = {\n        ...options,\n        mode: 'overlay',\n      };\n\n      const notificationId = addNotification(\n        overlayOptions,\n        ownerIdRef.current,\n      );\n\n      return {\n        id: notificationId,\n        dismiss: () => {\n          if (isMountedRef.current) {\n            removeNotification(notificationId, 'api');\n          }\n        },\n      };\n    },\n  );\n\n  // `record()` is intentionally kept as a separate method from `notify()` to make\n  // the API more explicit: `record()` always stores directly to the persistent list\n  // (no overlay), while `notify()` defaults to overlay mode. Having both avoids\n  // the caller needing to remember to pass `mode: 'stored'` every time.\n  const record = useEvent(\n    (options: Omit<StoredNotificationOptions, 'mode'>): NotificationHandle => {\n      // Stale closure guard\n      if (!isMountedRef.current) {\n        return {\n          id: options.id ?? '',\n          dismiss: () => {},\n        };\n      }\n\n      lastOptionsRef.current = { ...options, mode: 'stored' };\n\n      return createStoredHandle(options);\n    },\n  );\n\n  const dismiss = useEvent((id: Key) => {\n    if (!isMountedRef.current) return;\n\n    removeNotification(id, 'api');\n  });\n\n  // ─── Ownership Cleanup ────────────────────────────────────────────\n\n  useEffect(() => {\n    isMountedRef.current = true;\n\n    // Cancel any pending cleanup (Strict Mode re-mount)\n    if (cleanupTimerRef.current) {\n      clearTimeout(cleanupTimerRef.current);\n      cleanupTimerRef.current = null;\n    }\n\n    return () => {\n      isMountedRef.current = false;\n\n      // Deferred cleanup — cancelled if owner re-mounts within same tick\n      // (Strict Mode / Suspense safe)\n      cleanupTimerRef.current = setTimeout(() => {\n        removeByOwner(ownerIdRef.current);\n        removePersistentItemsByOwner(ownerIdRef.current);\n      }, 0);\n    };\n  }, [removeByOwner, removePersistentItemsByOwner]);\n\n  return { notify, record, dismiss };\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useEffect, useRef } from "react";
-
 //#region src/components/overlays/Notifications/use-overlay-timers.ts
 /**
 * Creates a start/clear/pause/resume pair for a single timer category.
@@ -127,7 +126,7 @@ function useOverlayTimers(deps) {
 		handlePauseChange
 	};
 }
-
 //#endregion
 export { useOverlayTimers };
+
 //# sourceMappingURL=use-overlay-timers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-overlay-timers.js","names":["Key","useEffect","useRef","useEvent","InternalToast","DismissReason","InternalNotification","OverlayTimers","startToastTimer","internalId","id","duration","clearToastTimer","startNotificationTimer","clearNotificationTimer","handlePauseChange","paused","OverlayTimersDeps","toastsRef","ReturnType","notificationsRef","removeToast","removeNotification","reason","TimerManager","start","clear","pauseAll","resumeAll","clearAll","createTimerManager","timersMap","Map","setTimeout","pausedMap","remaining","startedAt","isPausedRef","onTimeout","findItem","isExiting","timer","get","clearTimeout","delete","set","Date","now","current","forEach","info","elapsed","Math","max","item","has","useOverlayTimers","deps","toastTimersMap","notificationTimersMap","toastManager","notifManager","find","t","n"],"sources":["../../../../src/components/overlays/Notifications/use-overlay-timers.ts"],"sourcesContent":["import { Key, useEffect, useRef } from 'react';\n\nimport { useEvent } from '../../../_internal';\n\nimport type { InternalToast } from '../Toast/types';\nimport type { DismissReason, InternalNotification } from './types';\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport interface OverlayTimers {\n  /** Start a toast auto-dismiss timer */\n  startToastTimer: (internalId: string, id: Key, duration: number) => void;\n  /** Clear a toast timer */\n  clearToastTimer: (internalId: string) => void;\n  /** Start a notification auto-dismiss timer */\n  startNotificationTimer: (\n    internalId: string,\n    id: Key,\n    duration: number,\n  ) => void;\n  /** Clear a notification timer */\n  clearNotificationTimer: (internalId: string) => void;\n  /** Handle pause/resume of all timers (e.g. on hover/focus) */\n  handlePauseChange: (paused: boolean) => void;\n}\n\nexport interface OverlayTimersDeps {\n  /** Ref to current toasts (for resume lookup) */\n  toastsRef: ReturnType<typeof useRef<InternalToast[]>>;\n  /** Ref to current notifications (for resume lookup) */\n  notificationsRef: ReturnType<typeof useRef<InternalNotification[]>>;\n  /** Remove a toast by id */\n  removeToast: (id: Key) => void;\n  /** Remove a notification by id with reason (also invokes onDismiss callback) */\n  removeNotification: (id: Key, reason: DismissReason) => void;\n}\n\n// ─── Timer Manager Factory ───────────────────────────────────────────\n\ninterface TimerManager {\n  start: (internalId: string, id: Key, duration: number) => void;\n  clear: (internalId: string) => void;\n  pauseAll: () => void;\n  resumeAll: () => void;\n  clearAll: () => void;\n}\n\n/**\n * Creates a start/clear/pause/resume pair for a single timer category.\n * Eliminates duplication between toast and notification timer logic.\n */\nfunction createTimerManager(\n  timersMap: Map<string, ReturnType<typeof setTimeout>>,\n  pausedMap: Map<string, { remaining: number; startedAt: number }>,\n  isPausedRef: ReturnType<typeof useRef<boolean>>,\n  onTimeout: (id: Key) => void,\n  findItem: (\n    internalId: string,\n  ) => { id?: Key; internalId: string; isExiting?: boolean } | undefined,\n): TimerManager {\n  const clear = (internalId: string) => {\n    const timer = timersMap.get(internalId);\n\n    if (timer) {\n      clearTimeout(timer);\n      timersMap.delete(internalId);\n    }\n\n    pausedMap.delete(internalId);\n  };\n\n  const start = (internalId: string, id: Key, duration: number) => {\n    clear(internalId);\n\n    pausedMap.set(internalId, {\n      remaining: duration,\n      startedAt: Date.now(),\n    });\n\n    if (isPausedRef.current) {\n      return;\n    }\n\n    const timer = setTimeout(() => {\n      onTimeout(id);\n    }, duration);\n\n    timersMap.set(internalId, timer);\n  };\n\n  const pauseAll = () => {\n    timersMap.forEach((timer, internalId) => {\n      clearTimeout(timer);\n      timersMap.delete(internalId);\n\n      const info = pausedMap.get(internalId);\n\n      if (info) {\n        const elapsed = Date.now() - info.startedAt;\n        pausedMap.set(internalId, {\n          remaining: Math.max(0, info.remaining - elapsed),\n          startedAt: Date.now(),\n        });\n      }\n    });\n  };\n\n  const resumeAll = () => {\n    pausedMap.forEach((info, internalId) => {\n      const item = findItem(internalId);\n\n      if (!item || item.isExiting || timersMap.has(internalId)) return;\n\n      if (info.remaining <= 0) {\n        pausedMap.delete(internalId);\n        onTimeout(item.id ?? item.internalId);\n\n        return;\n      }\n\n      const timer = setTimeout(() => {\n        onTimeout(item.id ?? item.internalId);\n      }, info.remaining);\n\n      timersMap.set(internalId, timer);\n      pausedMap.set(internalId, {\n        remaining: info.remaining,\n        startedAt: Date.now(),\n      });\n    });\n  };\n\n  const clearAll = () => {\n    timersMap.forEach((timer) => clearTimeout(timer));\n    timersMap.clear();\n  };\n\n  return { start, clear, pauseAll, resumeAll, clearAll };\n}\n\n// ─── Hook ────────────────────────────────────────────────────────────\n\nexport function useOverlayTimers(deps: OverlayTimersDeps): OverlayTimers {\n  const { toastsRef, notificationsRef, removeToast, removeNotification } = deps;\n\n  const toastTimersMap = useRef(\n    new Map<string, ReturnType<typeof setTimeout>>(),\n  ).current;\n  const notificationTimersMap = useRef(\n    new Map<string, ReturnType<typeof setTimeout>>(),\n  ).current;\n  const isPausedRef = useRef(false);\n\n  // Shared paused-timers map. Toast and notification internalIds use distinct prefixes\n  // ('toast-' and 'notif-') so they coexist safely in a single map.\n  const pausedMap = useRef(\n    new Map<string, { remaining: number; startedAt: number }>(),\n  ).current;\n\n  const toastManager = useRef<TimerManager | null>(null);\n  const notifManager = useRef<TimerManager | null>(null);\n\n  // Lazily create managers — deps are stable (useEvent / refs), so this runs once.\n  if (!toastManager.current) {\n    toastManager.current = createTimerManager(\n      toastTimersMap,\n      pausedMap,\n      isPausedRef,\n      (id) => removeToast(id),\n      (internalId) =>\n        toastsRef.current?.find((t) => t.internalId === internalId),\n    );\n  }\n\n  if (!notifManager.current) {\n    notifManager.current = createTimerManager(\n      notificationTimersMap,\n      pausedMap,\n      isPausedRef,\n      (id) => removeNotification(id, 'timeout'),\n      (internalId) =>\n        notificationsRef.current?.find((n) => n.internalId === internalId),\n    );\n  }\n\n  // ─── Stable callbacks ──────────────────────────────────────────────\n\n  const startToastTimer = useEvent(\n    (internalId: string, id: Key, duration: number) => {\n      toastManager.current!.start(internalId, id, duration);\n    },\n  );\n\n  const clearToastTimer = useEvent((internalId: string) => {\n    toastManager.current!.clear(internalId);\n  });\n\n  const startNotificationTimer = useEvent(\n    (internalId: string, id: Key, duration: number) => {\n      notifManager.current!.start(internalId, id, duration);\n    },\n  );\n\n  const clearNotificationTimer = useEvent((internalId: string) => {\n    notifManager.current!.clear(internalId);\n  });\n\n  // ─── Pause / Resume ─────────────────────────────────────────────\n\n  const handlePauseChange = useEvent((paused: boolean) => {\n    if (paused === isPausedRef.current) return;\n\n    isPausedRef.current = paused;\n\n    if (paused) {\n      toastManager.current!.pauseAll();\n      notifManager.current!.pauseAll();\n    } else {\n      toastManager.current!.resumeAll();\n      notifManager.current!.resumeAll();\n    }\n  });\n\n  // An effect can enqueue an item while paused just before an empty-stack\n  // reset resumes timers. Retry once that item reaches the committed lookup,\n  // preserving the deadlines of timers that are already running.\n  useEffect(() => {\n    if (!isPausedRef.current) {\n      toastManager.current!.resumeAll();\n      notifManager.current!.resumeAll();\n    }\n  });\n\n  // ─── Cleanup on unmount ─────────────────────────────────────────\n\n  useEffect(() => {\n    return () => {\n      toastManager.current!.clearAll();\n      notifManager.current!.clearAll();\n      pausedMap.clear();\n    };\n  }, []);\n\n  return {\n    startToastTimer,\n    clearToastTimer,\n    startNotificationTimer,\n    clearNotificationTimer,\n    handlePauseChange,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-overlay-timers.js","names":["Key","useEffect","useRef","useEvent","InternalToast","DismissReason","InternalNotification","OverlayTimers","startToastTimer","internalId","id","duration","clearToastTimer","startNotificationTimer","clearNotificationTimer","handlePauseChange","paused","OverlayTimersDeps","toastsRef","ReturnType","notificationsRef","removeToast","removeNotification","reason","TimerManager","start","clear","pauseAll","resumeAll","clearAll","createTimerManager","timersMap","Map","setTimeout","pausedMap","remaining","startedAt","isPausedRef","onTimeout","findItem","isExiting","timer","get","clearTimeout","delete","set","Date","now","current","forEach","info","elapsed","Math","max","item","has","useOverlayTimers","deps","toastTimersMap","notificationTimersMap","toastManager","notifManager","find","t","n"],"sources":["../../../../src/components/overlays/Notifications/use-overlay-timers.ts"],"sourcesContent":["import { Key, useEffect, useRef } from 'react';\n\nimport { useEvent } from '../../../_internal';\n\nimport type { InternalToast } from '../Toast/types';\nimport type { DismissReason, InternalNotification } from './types';\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport interface OverlayTimers {\n  /** Start a toast auto-dismiss timer */\n  startToastTimer: (internalId: string, id: Key, duration: number) => void;\n  /** Clear a toast timer */\n  clearToastTimer: (internalId: string) => void;\n  /** Start a notification auto-dismiss timer */\n  startNotificationTimer: (\n    internalId: string,\n    id: Key,\n    duration: number,\n  ) => void;\n  /** Clear a notification timer */\n  clearNotificationTimer: (internalId: string) => void;\n  /** Handle pause/resume of all timers (e.g. on hover/focus) */\n  handlePauseChange: (paused: boolean) => void;\n}\n\nexport interface OverlayTimersDeps {\n  /** Ref to current toasts (for resume lookup) */\n  toastsRef: ReturnType<typeof useRef<InternalToast[]>>;\n  /** Ref to current notifications (for resume lookup) */\n  notificationsRef: ReturnType<typeof useRef<InternalNotification[]>>;\n  /** Remove a toast by id */\n  removeToast: (id: Key) => void;\n  /** Remove a notification by id with reason (also invokes onDismiss callback) */\n  removeNotification: (id: Key, reason: DismissReason) => void;\n}\n\n// ─── Timer Manager Factory ───────────────────────────────────────────\n\ninterface TimerManager {\n  start: (internalId: string, id: Key, duration: number) => void;\n  clear: (internalId: string) => void;\n  pauseAll: () => void;\n  resumeAll: () => void;\n  clearAll: () => void;\n}\n\n/**\n * Creates a start/clear/pause/resume pair for a single timer category.\n * Eliminates duplication between toast and notification timer logic.\n */\nfunction createTimerManager(\n  timersMap: Map<string, ReturnType<typeof setTimeout>>,\n  pausedMap: Map<string, { remaining: number; startedAt: number }>,\n  isPausedRef: ReturnType<typeof useRef<boolean>>,\n  onTimeout: (id: Key) => void,\n  findItem: (\n    internalId: string,\n  ) => { id?: Key; internalId: string; isExiting?: boolean } | undefined,\n): TimerManager {\n  const clear = (internalId: string) => {\n    const timer = timersMap.get(internalId);\n\n    if (timer) {\n      clearTimeout(timer);\n      timersMap.delete(internalId);\n    }\n\n    pausedMap.delete(internalId);\n  };\n\n  const start = (internalId: string, id: Key, duration: number) => {\n    clear(internalId);\n\n    pausedMap.set(internalId, {\n      remaining: duration,\n      startedAt: Date.now(),\n    });\n\n    if (isPausedRef.current) {\n      return;\n    }\n\n    const timer = setTimeout(() => {\n      onTimeout(id);\n    }, duration);\n\n    timersMap.set(internalId, timer);\n  };\n\n  const pauseAll = () => {\n    timersMap.forEach((timer, internalId) => {\n      clearTimeout(timer);\n      timersMap.delete(internalId);\n\n      const info = pausedMap.get(internalId);\n\n      if (info) {\n        const elapsed = Date.now() - info.startedAt;\n        pausedMap.set(internalId, {\n          remaining: Math.max(0, info.remaining - elapsed),\n          startedAt: Date.now(),\n        });\n      }\n    });\n  };\n\n  const resumeAll = () => {\n    pausedMap.forEach((info, internalId) => {\n      const item = findItem(internalId);\n\n      if (!item || item.isExiting || timersMap.has(internalId)) return;\n\n      if (info.remaining <= 0) {\n        pausedMap.delete(internalId);\n        onTimeout(item.id ?? item.internalId);\n\n        return;\n      }\n\n      const timer = setTimeout(() => {\n        onTimeout(item.id ?? item.internalId);\n      }, info.remaining);\n\n      timersMap.set(internalId, timer);\n      pausedMap.set(internalId, {\n        remaining: info.remaining,\n        startedAt: Date.now(),\n      });\n    });\n  };\n\n  const clearAll = () => {\n    timersMap.forEach((timer) => clearTimeout(timer));\n    timersMap.clear();\n  };\n\n  return { start, clear, pauseAll, resumeAll, clearAll };\n}\n\n// ─── Hook ────────────────────────────────────────────────────────────\n\nexport function useOverlayTimers(deps: OverlayTimersDeps): OverlayTimers {\n  const { toastsRef, notificationsRef, removeToast, removeNotification } = deps;\n\n  const toastTimersMap = useRef(\n    new Map<string, ReturnType<typeof setTimeout>>(),\n  ).current;\n  const notificationTimersMap = useRef(\n    new Map<string, ReturnType<typeof setTimeout>>(),\n  ).current;\n  const isPausedRef = useRef(false);\n\n  // Shared paused-timers map. Toast and notification internalIds use distinct prefixes\n  // ('toast-' and 'notif-') so they coexist safely in a single map.\n  const pausedMap = useRef(\n    new Map<string, { remaining: number; startedAt: number }>(),\n  ).current;\n\n  const toastManager = useRef<TimerManager | null>(null);\n  const notifManager = useRef<TimerManager | null>(null);\n\n  // Lazily create managers — deps are stable (useEvent / refs), so this runs once.\n  if (!toastManager.current) {\n    toastManager.current = createTimerManager(\n      toastTimersMap,\n      pausedMap,\n      isPausedRef,\n      (id) => removeToast(id),\n      (internalId) =>\n        toastsRef.current?.find((t) => t.internalId === internalId),\n    );\n  }\n\n  if (!notifManager.current) {\n    notifManager.current = createTimerManager(\n      notificationTimersMap,\n      pausedMap,\n      isPausedRef,\n      (id) => removeNotification(id, 'timeout'),\n      (internalId) =>\n        notificationsRef.current?.find((n) => n.internalId === internalId),\n    );\n  }\n\n  // ─── Stable callbacks ──────────────────────────────────────────────\n\n  const startToastTimer = useEvent(\n    (internalId: string, id: Key, duration: number) => {\n      toastManager.current!.start(internalId, id, duration);\n    },\n  );\n\n  const clearToastTimer = useEvent((internalId: string) => {\n    toastManager.current!.clear(internalId);\n  });\n\n  const startNotificationTimer = useEvent(\n    (internalId: string, id: Key, duration: number) => {\n      notifManager.current!.start(internalId, id, duration);\n    },\n  );\n\n  const clearNotificationTimer = useEvent((internalId: string) => {\n    notifManager.current!.clear(internalId);\n  });\n\n  // ─── Pause / Resume ─────────────────────────────────────────────\n\n  const handlePauseChange = useEvent((paused: boolean) => {\n    if (paused === isPausedRef.current) return;\n\n    isPausedRef.current = paused;\n\n    if (paused) {\n      toastManager.current!.pauseAll();\n      notifManager.current!.pauseAll();\n    } else {\n      toastManager.current!.resumeAll();\n      notifManager.current!.resumeAll();\n    }\n  });\n\n  // An effect can enqueue an item while paused just before an empty-stack\n  // reset resumes timers. Retry once that item reaches the committed lookup,\n  // preserving the deadlines of timers that are already running.\n  useEffect(() => {\n    if (!isPausedRef.current) {\n      toastManager.current!.resumeAll();\n      notifManager.current!.resumeAll();\n    }\n  });\n\n  // ─── Cleanup on unmount ─────────────────────────────────────────\n\n  useEffect(() => {\n    return () => {\n      toastManager.current!.clearAll();\n      notifManager.current!.clearAll();\n      pausedMap.clear();\n    };\n  }, []);\n\n  return {\n    startToastTimer,\n    clearToastTimer,\n    startNotificationTimer,\n    clearNotificationTimer,\n    handlePauseChange,\n  };\n}\n"],"mappings":"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"}

package/dist/components/overlays/Notifications/use-persistent-notifications.d.ts

@@ -1,7 +1,6 @@
 
 import { PersistentNotificationItem } from "./types.js";
 import { Key } from "react";
-
 //#region src/components/overlays/Notifications/use-persistent-notifications.d.ts
 /**
  * Hook to access the persistent notifications list.
@@ -26,7 +25,7 @@ import { Key } from "react";
  * );
  * ```
  */
-declare function usePersistentNotifications(): {
+export declare function usePersistentNotifications(): {
   items: PersistentNotificationItem[];
   count: number;
   remove: (id: Key) => void;
@@ -45,10 +44,9 @@ declare function usePersistentNotifications(): {
  * return <Badge count={unread} />;
  * ```
  */
-declare function useNotificationsCount(): {
+export declare function useNotificationsCount(): {
   total: number;
   unread: number;
 };
 //#endregion
-export { useNotificationsCount, usePersistentNotifications };
 //# sourceMappingURL=use-persistent-notifications.d.ts.map

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

@@ -1,7 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { usePersistentNotificationsContext } from "./NotificationContext.js";
 import { c } from "react/compiler-runtime";
-
 //#region src/components/overlays/Notifications/use-persistent-notifications.ts
 /**
 * Hook to access the persistent notifications list.
@@ -83,7 +82,7 @@ function useNotificationsCount() {
 function _temp(i) {
 	return !i.isRead;
 }
-
 //#endregion
 export { useNotificationsCount, usePersistentNotifications };
+
 //# sourceMappingURL=use-persistent-notifications.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-persistent-notifications.js","names":["Key","usePersistentNotificationsContext","PersistentNotificationItem","usePersistentNotifications","$","_c","persistentItems","removePersistentItem","clearPersistentItems","markAllAsRead","t0","items","count","length","remove","clear","useNotificationsCount","t1","filter","_temp","t2","total","unread","i","isRead"],"sources":["../../../../src/components/overlays/Notifications/use-persistent-notifications.ts"],"sourcesContent":["import { Key } from 'react';\n\nimport { usePersistentNotificationsContext } from './NotificationContext';\n\nimport type { PersistentNotificationItem } from './types';\n\n/**\n * Hook to access the persistent notifications list.\n *\n * Items are ordered newest first (by `createdAt`, descending).\n *\n * @example\n * ```tsx\n * const { items, count, remove, clear } = usePersistentNotifications();\n *\n * return (\n *   <div>\n *     <span>Notifications ({count})</span>\n *     {items.map(item => (\n *       <div key={item.id}>\n *         {item.title}\n *         <button onClick={() => remove(item.id)}>Remove</button>\n *       </div>\n *     ))}\n *     <button onClick={clear}>Clear all</button>\n *   </div>\n * );\n * ```\n */\nexport function usePersistentNotifications(): {\n  items: PersistentNotificationItem[];\n  count: number;\n  remove: (id: Key) => void;\n  clear: () => void;\n  markAllAsRead: () => void;\n} {\n  const {\n    persistentItems,\n    removePersistentItem,\n    clearPersistentItems,\n    markAllAsRead,\n  } = usePersistentNotificationsContext();\n\n  return {\n    items: persistentItems,\n    count: persistentItems.length,\n    remove: removePersistentItem,\n    clear: clearPersistentItems,\n    markAllAsRead,\n  };\n}\n\n/**\n * Hook to get total and unread counts for persistent notifications.\n *\n * - `total` — number of items in the persistent list.\n * - `unread` — items that haven't been seen in `PersistentNotificationsList` yet.\n *\n * @example\n * ```tsx\n * const { total, unread } = useNotificationsCount();\n * return <Badge count={unread} />;\n * ```\n */\nexport function useNotificationsCount(): { total: number; unread: number } {\n  const { persistentItems } = usePersistentNotificationsContext();\n\n  return {\n    total: persistentItems.length,\n    unread: persistentItems.filter((i) => !i.isRead).length,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAOG,6BAAA;CAAA,MAAAC,IAAAC,EAAA,EAAA;CAOL,MAAA,EAAAC,iBAAAC,sBAAAC,sBAAAC,kBAKIR,mCAAmC;CAAC,IAAAS;AAAA,KAAAN,EAAA,OAAAI,wBAAAJ,EAAA,OAAAK,iBAAAL,EAAA,OAAAE,mBAAAF,EAAA,OAAAG,sBAAA;AAEjCG,OAAA;GAAAC,OACEL;GAAeM,OACfN,gBAAeO;GAAOC,QACrBP;GAAoBQ,OACrBP;GAAoBC;GAE5B;AAAAL,IAAA,KAAAI;AAAAJ,IAAA,KAAAK;AAAAL,IAAA,KAAAE;AAAAF,IAAA,KAAAG;AAAAH,IAAA,KAAAM;OAAAA,MAAAN,EAAA;AAAA,QANMM;;;;;;;;;;;;;;AAqBT,SAAOM,wBAAA;CAAA,MAAAZ,IAAAC,EAAA,EAAA;CACL,MAAA,EAAAC,oBAA4BL,mCAAmC;CAGtD,MAAAS,KAAAJ,gBAAeO;CAAO,IAAAI;AAAA,KAAAb,EAAA,OAAAE,iBAAA;AACrBW,OAAAX,gBAAeY,OAAQC,MAAiB;AAAAf,IAAA,KAAAE;AAAAF,IAAA,KAAAa;OAAAA,MAAAb,EAAA;CAAA,IAAAgB;AAAA,KAAAhB,EAAA,OAAAE,gBAAAO,UAAAT,EAAA,OAAAa,GAAAJ,QAAA;AAF3CO,OAAA;GAAAC,OACEX;GAAsBY,QACrBL,GAAwCJ;GACjD;AAAAT,IAAA,KAAAE,gBAAAO;AAAAT,IAAA,KAAAa,GAAAJ;AAAAT,IAAA,KAAAgB;OAAAA,MAAAhB,EAAA;AAAA,QAHMgB;;AAHF,SAAAD,MAAAI,GAAA;AAAA,QAKmC,CAACA,EAACC"}
+{"version":3,"file":"use-persistent-notifications.js","names":["Key","usePersistentNotificationsContext","PersistentNotificationItem","usePersistentNotifications","$","_c","persistentItems","removePersistentItem","clearPersistentItems","markAllAsRead","t0","items","count","length","remove","clear","useNotificationsCount","t1","filter","_temp","t2","total","unread","i","isRead","_c"],"sources":["../../../../src/components/overlays/Notifications/use-persistent-notifications.ts"],"sourcesContent":["import { Key } from 'react';\n\nimport { usePersistentNotificationsContext } from './NotificationContext';\n\nimport type { PersistentNotificationItem } from './types';\n\n/**\n * Hook to access the persistent notifications list.\n *\n * Items are ordered newest first (by `createdAt`, descending).\n *\n * @example\n * ```tsx\n * const { items, count, remove, clear } = usePersistentNotifications();\n *\n * return (\n *   <div>\n *     <span>Notifications ({count})</span>\n *     {items.map(item => (\n *       <div key={item.id}>\n *         {item.title}\n *         <button onClick={() => remove(item.id)}>Remove</button>\n *       </div>\n *     ))}\n *     <button onClick={clear}>Clear all</button>\n *   </div>\n * );\n * ```\n */\nexport function usePersistentNotifications(): {\n  items: PersistentNotificationItem[];\n  count: number;\n  remove: (id: Key) => void;\n  clear: () => void;\n  markAllAsRead: () => void;\n} {\n  const {\n    persistentItems,\n    removePersistentItem,\n    clearPersistentItems,\n    markAllAsRead,\n  } = usePersistentNotificationsContext();\n\n  return {\n    items: persistentItems,\n    count: persistentItems.length,\n    remove: removePersistentItem,\n    clear: clearPersistentItems,\n    markAllAsRead,\n  };\n}\n\n/**\n * Hook to get total and unread counts for persistent notifications.\n *\n * - `total` — number of items in the persistent list.\n * - `unread` — items that haven't been seen in `PersistentNotificationsList` yet.\n *\n * @example\n * ```tsx\n * const { total, unread } = useNotificationsCount();\n * return <Badge count={unread} />;\n * ```\n */\nexport function useNotificationsCount(): { total: number; unread: number } {\n  const { persistentItems } = usePersistentNotificationsContext();\n\n  return {\n    total: persistentItems.length,\n    unread: persistentItems.filter((i) => !i.isRead).length,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,SAAOG,6BAAA;CAAA,MAAAC,IAAAC,EAAA,CAAA;CAOL,MAAA,EAAAC,iBAAAC,sBAAAC,sBAAAC,kBAKIR,kCAAkC;CAAE,IAAAS;CAAA,IAAAN,EAAA,OAAAI,wBAAAJ,EAAA,OAAAK,iBAAAL,EAAA,OAAAE,mBAAAF,EAAA,OAAAG,sBAAA;EAEjCG,KAAA;GAAAC,OACEL;GAAeM,OACfN,gBAAeO;GAAOC,QACrBP;GAAoBQ,OACrBP;GAAoBC;EAE7B;EAACL,EAAA,KAAAI;EAAAJ,EAAA,KAAAK;EAAAL,EAAA,KAAAE;EAAAF,EAAA,KAAAG;EAAAH,EAAA,KAAAM;CAAA,OAAAA,KAAAN,EAAA;CAAA,OANMM;AAMN;;;;;;;;;;;;;AAeH,SAAOM,wBAAA;CAAA,MAAAZ,IAAAC,EAAA,CAAA;CACL,MAAA,EAAAC,oBAA4BL,kCAAkC;CAGrD,MAAAS,KAAAJ,gBAAeO;CAAO,IAAAI;CAAA,IAAAb,EAAA,OAAAE,iBAAA;EACrBW,KAAAX,gBAAeY,OAAQC,KAAgB;EAACf,EAAA,KAAAE;EAAAF,EAAA,KAAAa;CAAA,OAAAA,KAAAb,EAAA;CAAA,IAAAgB;CAAA,IAAAhB,EAAA,OAAAE,gBAAAO,UAAAT,EAAA,OAAAa,GAAAJ,QAAA;EAF3CO,KAAA;GAAAC,OACEX;GAAsBY,QACrBL,GAAwCJ;EAClD;EAACT,EAAA,KAAAE,gBAAAO;EAAAT,EAAA,KAAAa,GAAAJ;EAAAT,EAAA,KAAAgB;CAAA,OAAAA,KAAAhB,EAAA;CAAA,OAHMgB;AAGN;AANI,SAAAD,MAAAI,GAAA;CAAA,OAKmC,CAACA,EAACC;AAAO"}

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

@@ -1,9 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.196.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { cleanupAndGetValidIds, saveDismissedId } from "./dismissed-storage.js";
 import { c } from "react/compiler-runtime";
 import { useRef, useState } from "react";
-
 //#region src/components/overlays/Notifications/use-persistent-state.ts
 function usePersistentState(maxItems) {
 	const $ = c(26);
@@ -174,7 +173,7 @@ function _temp2(i_2) {
 function _temp(a, b) {
 	return b.createdAt - a.createdAt;
 }
-
 //#endregion
 export { usePersistentState };
+
 //# sourceMappingURL=use-persistent-state.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-persistent-state.js","names":["Key","useRef","useState","useEvent","cleanupAndGetValidIds","saveDismissedId","PersistentNotificationItem","PersistentState","persistentItems","addPersistentItem","item","removePersistentItem","id","removePersistentItemsByOwner","ownerId","clearPersistentItems","markAllAsRead","hasDismissedPersistentId","isFullyDismissedId","saveDismissedPersistentId","undoFullyDismissedId","removePersistentItemSilently","usePersistentState","maxItems","$","_c","t0","Symbol","for","setPersistentItems","dismissedPersistentIdsRef","current","t1","Set","fullyDismissedIdsRef","t2","has","String","add","prev","existingIndex","findIndex","i","newItems","isRead","length","slice","sort","_temp","t3","prev_0","filter","i_0","t4","prev_1","i_1","t5","t6","_temp4","t7","id_0","t8","id_1","t9","id_2","t10","id_3","delete","t11","id_4","prev_3","i_4","t12","prev_2","hasUnread","some","_temp2","map","_temp3","i_3","i_2","a","b","createdAt"],"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":"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"}
+{"version":3,"file":"use-persistent-state.js","names":["Key","useRef","useState","useEvent","cleanupAndGetValidIds","saveDismissedId","PersistentNotificationItem","PersistentState","persistentItems","addPersistentItem","item","removePersistentItem","id","removePersistentItemsByOwner","ownerId","clearPersistentItems","markAllAsRead","hasDismissedPersistentId","isFullyDismissedId","saveDismissedPersistentId","undoFullyDismissedId","removePersistentItemSilently","usePersistentState","maxItems","$","_c","t0","Symbol","for","setPersistentItems","dismissedPersistentIdsRef","current","t1","Set","fullyDismissedIdsRef","t2","has","String","add","prev","existingIndex","findIndex","i","newItems","isRead","length","slice","sort","_temp","t3","prev_0","filter","i_0","t4","prev_1","i_1","t5","t6","_temp4","t7","id_0","t8","id_1","t9","id_2","t10","id_3","delete","t11","id_4","prev_3","i_4","t12","prev_2","hasUnread","some","_temp2","map","_temp3","i_3","i_2","a","b","createdAt","_c"],"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":"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"}