@cube-dev/ui-kit 0.197.0 → 0.198.0

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

@@ -1 +1 @@
-{"version":3,"file":"PersistentNotificationsList.js","names":["tasty","Fragment","Key","useContext","useEffect","useRef","useState","useEvent","useI18n","Divider","Text","formatRelativeTime","NotificationActionInterceptorContext","NotificationCard","usePersistentNotifications","DismissReason","PersistentNotificationItem","PersistentNotificationsListProps","MARK_READ_DELAY","TIMESTAMP_REFRESH_INTERVAL","ListContainer","qa","role","styles","display","flow","EmptyStateContainer","placeItems","placeContent","padding","color","preset","PersistentNotificationsList","t0","$","_c","onDismissItem","onAction","emptyState","t","items","remove","markAllAsRead","t1","listAriaLabel","t2","item","id","handleDismiss","markReadTimerRef","now","setNow","_temp","t3","t4","length","interval","setInterval","Date","clearInterval","t5","t6","hasUnread","some","_temp2","current","setTimeout","clearTimeout","t7","t8","t9","item_0","index","String","map","t10","i","isRead","PersistentNotificationListItemProps","onDismiss","PersistentNotificationListItem","createdAt","suffix","_id","_reason","parentInterceptor","handleItemAction","undefined","actions","description","icon","theme","title"],"sources":["../../../../src/components/overlays/Notifications/PersistentNotificationsList.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\nimport { Fragment, Key, useContext, useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { useI18n } from '../../../i18n';\nimport { Divider } from '../../content/Divider';\nimport { Text } from '../../content/Text';\n\nimport { formatRelativeTime } from './format-relative-time';\nimport { NotificationActionInterceptorContext } from './NotificationAction';\nimport { NotificationCard } from './NotificationCard';\nimport { usePersistentNotifications } from './use-persistent-notifications';\n\nimport type {\n  DismissReason,\n  PersistentNotificationItem,\n  PersistentNotificationsListProps,\n} from './types';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst MARK_READ_DELAY = 2000;\n/** Interval (ms) at which relative timestamps refresh while the list is mounted. */\nconst TIMESTAMP_REFRESH_INTERVAL = 10_000;\n\n// ─── Styled Components ──────────────────────────────────────────────\n\nconst ListContainer = tasty({\n  qa: 'PersistentNotificationsList',\n  role: 'log',\n  styles: {\n    display: 'flex',\n    flow: 'column',\n  },\n});\n\nconst EmptyStateContainer = tasty({\n  styles: {\n    display: 'flex',\n    placeItems: 'center',\n    placeContent: 'center',\n    padding: '4x',\n    color: '#dark.5',\n    preset: 't3',\n  },\n});\n\n// ─── PersistentNotificationsList Component ───────────────────────────\n\n/**\n * Standardized rendering for archived/persistent notifications.\n * Always reads items from the notification context.\n * Composable with app-specific shells (popover, dialog, page section).\n *\n * Marks all items as read after being visible for 2 seconds.\n * Relative timestamps refresh every 10 seconds while the list is mounted.\n *\n * Items are always dismissible. Dismissing an item removes it from the\n * persistent list and marks its ID as \"fully dismissed\" — subsequent triggers\n * with the same ID will be completely ignored (no overlay, no re-archival).\n *\n * @example\n * ```tsx\n * <PersistentNotificationsList emptyState=\"No notifications\" />\n * ```\n */\nexport function PersistentNotificationsList({\n  onDismissItem,\n  onAction,\n  emptyState,\n}: PersistentNotificationsListProps) {\n  const { t } = useI18n();\n  const { items, remove, markAllAsRead } = usePersistentNotifications();\n  const listAriaLabel = t('notifications.ariaLabel', 'Notifications');\n\n  // Default dismiss handler removes the item from the persistent list (which\n  // also marks the id as \"fully dismissed\" so it won't reappear).\n  // If a consumer provides `onDismissItem`, it is called *after* the built-in removal.\n  const handleDismiss = useEvent((item: PersistentNotificationItem) => {\n    remove(item.id);\n    onDismissItem?.(item);\n  });\n  const markReadTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Time is a reactive input, so memoized rows also refresh their labels.\n  const [now, setNow] = useState(() => Date.now());\n\n  useEffect(() => {\n    if (items.length === 0) return;\n\n    const interval = setInterval(() => {\n      setNow(Date.now());\n    }, TIMESTAMP_REFRESH_INTERVAL);\n\n    return () => clearInterval(interval);\n  }, [items.length]);\n\n  // Mark all persistent notifications as read after a 2s delay.\n  // Re-starts the timer whenever items change (e.g. new unread items arrive\n  // while the list is already visible).\n  useEffect(() => {\n    const hasUnread = items.some((i) => !i.isRead);\n\n    if (!hasUnread) return;\n\n    markReadTimerRef.current = setTimeout(() => {\n      markAllAsRead();\n    }, MARK_READ_DELAY);\n\n    return () => {\n      if (markReadTimerRef.current) {\n        clearTimeout(markReadTimerRef.current);\n        markReadTimerRef.current = null;\n      }\n    };\n  }, [markAllAsRead, items]);\n\n  if (items.length === 0) {\n    return (\n      <ListContainer aria-label={listAriaLabel}>\n        <EmptyStateContainer>\n          {emptyState ?? t('notifications.empty', 'No notifications')}\n        </EmptyStateContainer>\n      </ListContainer>\n    );\n  }\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={onAction ?? null}>\n      <ListContainer aria-label={listAriaLabel}>\n        {items.map((item, index) => (\n          <Fragment key={String(item.id)}>\n            {index > 0 && <Divider />}\n            <PersistentNotificationListItem\n              item={item}\n              now={now}\n              onDismiss={handleDismiss}\n            />\n          </Fragment>\n        ))}\n      </ListContainer>\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n\n// ─── List Item ───────────────────────────────────────────────────────\n\ninterface PersistentNotificationListItemProps {\n  item: PersistentNotificationItem;\n  now: number;\n  onDismiss?: (item: PersistentNotificationItem) => void;\n}\n\nfunction PersistentNotificationListItem({\n  item,\n  now,\n  onDismiss,\n}: PersistentNotificationListItemProps) {\n  const { t } = useI18n();\n  const suffix = (\n    <Text opacity={0.5} preset=\"c2\">\n      {formatRelativeTime(item.createdAt, t, now)}\n    </Text>\n  );\n\n  // useEvent keeps the callback stable across re-renders regardless of\n  // item reference changes (avoids unnecessary NotificationCard re-renders).\n  const handleDismiss = useEvent((_id: Key, _reason: DismissReason) => {\n    onDismiss?.(item);\n  });\n\n  const parentInterceptor = useContext(NotificationActionInterceptorContext);\n\n  // Chains with the list-level interceptor (e.g. closing the parent popover).\n  // Dismissal itself is handled by NotificationAction via the dismiss context\n  // to avoid double-firing onDismiss.\n  const handleItemAction = useEvent(() => {\n    parentInterceptor?.();\n  });\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={handleItemAction}>\n      <NotificationCard\n        qa=\"PersistentNotificationItem\"\n        theme={item.theme}\n        title={item.title}\n        description={item.description}\n        icon={item.icon}\n        actions={item.actions}\n        isDismissable={!!onDismiss}\n        elevated={false}\n        notificationId={item.id}\n        suffix={suffix}\n        onDismiss={onDismiss ? handleDismiss : undefined}\n      />\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"PersistentNotificationsList.js","names":["tasty","Fragment","Key","useContext","useEffect","useRef","useState","useEvent","useI18n","Divider","Text","formatRelativeTime","NotificationActionInterceptorContext","NotificationCard","usePersistentNotifications","DismissReason","PersistentNotificationItem","PersistentNotificationsListProps","MARK_READ_DELAY","TIMESTAMP_REFRESH_INTERVAL","ListContainer","qa","role","styles","display","flow","EmptyStateContainer","placeItems","placeContent","padding","color","preset","PersistentNotificationsList","t0","$","_c","onDismissItem","onAction","emptyState","t","items","remove","markAllAsRead","t1","listAriaLabel","t2","item","id","handleDismiss","markReadTimerRef","now","setNow","_temp","t3","t4","length","interval","setInterval","Date","clearInterval","t5","t6","hasUnread","some","_temp2","current","setTimeout","clearTimeout","t7","t8","t9","item_0","index","String","map","t10","i","isRead","PersistentNotificationListItemProps","onDismiss","PersistentNotificationListItem","createdAt","suffix","_id","_reason","parentInterceptor","handleItemAction","undefined","actions","description","icon","theme","title","_c","Text"],"sources":["../../../../src/components/overlays/Notifications/PersistentNotificationsList.tsx"],"sourcesContent":["import { tasty } from '@tenphi/tasty';\nimport { Fragment, Key, useContext, useEffect, useRef, useState } from 'react';\n\nimport { useEvent } from '../../../_internal';\nimport { useI18n } from '../../../i18n';\nimport { Divider } from '../../content/Divider';\nimport { Text } from '../../content/Text';\n\nimport { formatRelativeTime } from './format-relative-time';\nimport { NotificationActionInterceptorContext } from './NotificationAction';\nimport { NotificationCard } from './NotificationCard';\nimport { usePersistentNotifications } from './use-persistent-notifications';\n\nimport type {\n  DismissReason,\n  PersistentNotificationItem,\n  PersistentNotificationsListProps,\n} from './types';\n\n// ─── Constants ───────────────────────────────────────────────────────\n\nconst MARK_READ_DELAY = 2000;\n/** Interval (ms) at which relative timestamps refresh while the list is mounted. */\nconst TIMESTAMP_REFRESH_INTERVAL = 10_000;\n\n// ─── Styled Components ──────────────────────────────────────────────\n\nconst ListContainer = tasty({\n  qa: 'PersistentNotificationsList',\n  role: 'log',\n  styles: {\n    display: 'flex',\n    flow: 'column',\n  },\n});\n\nconst EmptyStateContainer = tasty({\n  styles: {\n    display: 'flex',\n    placeItems: 'center',\n    placeContent: 'center',\n    padding: '4x',\n    color: '#dark.5',\n    preset: 't3',\n  },\n});\n\n// ─── PersistentNotificationsList Component ───────────────────────────\n\n/**\n * Standardized rendering for archived/persistent notifications.\n * Always reads items from the notification context.\n * Composable with app-specific shells (popover, dialog, page section).\n *\n * Marks all items as read after being visible for 2 seconds.\n * Relative timestamps refresh every 10 seconds while the list is mounted.\n *\n * Items are always dismissible. Dismissing an item removes it from the\n * persistent list and marks its ID as \"fully dismissed\" — subsequent triggers\n * with the same ID will be completely ignored (no overlay, no re-archival).\n *\n * @example\n * ```tsx\n * <PersistentNotificationsList emptyState=\"No notifications\" />\n * ```\n */\nexport function PersistentNotificationsList({\n  onDismissItem,\n  onAction,\n  emptyState,\n}: PersistentNotificationsListProps) {\n  const { t } = useI18n();\n  const { items, remove, markAllAsRead } = usePersistentNotifications();\n  const listAriaLabel = t('notifications.ariaLabel', 'Notifications');\n\n  // Default dismiss handler removes the item from the persistent list (which\n  // also marks the id as \"fully dismissed\" so it won't reappear).\n  // If a consumer provides `onDismissItem`, it is called *after* the built-in removal.\n  const handleDismiss = useEvent((item: PersistentNotificationItem) => {\n    remove(item.id);\n    onDismissItem?.(item);\n  });\n  const markReadTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  // Time is a reactive input, so memoized rows also refresh their labels.\n  const [now, setNow] = useState(() => Date.now());\n\n  useEffect(() => {\n    if (items.length === 0) return;\n\n    const interval = setInterval(() => {\n      setNow(Date.now());\n    }, TIMESTAMP_REFRESH_INTERVAL);\n\n    return () => clearInterval(interval);\n  }, [items.length]);\n\n  // Mark all persistent notifications as read after a 2s delay.\n  // Re-starts the timer whenever items change (e.g. new unread items arrive\n  // while the list is already visible).\n  useEffect(() => {\n    const hasUnread = items.some((i) => !i.isRead);\n\n    if (!hasUnread) return;\n\n    markReadTimerRef.current = setTimeout(() => {\n      markAllAsRead();\n    }, MARK_READ_DELAY);\n\n    return () => {\n      if (markReadTimerRef.current) {\n        clearTimeout(markReadTimerRef.current);\n        markReadTimerRef.current = null;\n      }\n    };\n  }, [markAllAsRead, items]);\n\n  if (items.length === 0) {\n    return (\n      <ListContainer aria-label={listAriaLabel}>\n        <EmptyStateContainer>\n          {emptyState ?? t('notifications.empty', 'No notifications')}\n        </EmptyStateContainer>\n      </ListContainer>\n    );\n  }\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={onAction ?? null}>\n      <ListContainer aria-label={listAriaLabel}>\n        {items.map((item, index) => (\n          <Fragment key={String(item.id)}>\n            {index > 0 && <Divider />}\n            <PersistentNotificationListItem\n              item={item}\n              now={now}\n              onDismiss={handleDismiss}\n            />\n          </Fragment>\n        ))}\n      </ListContainer>\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n\n// ─── List Item ───────────────────────────────────────────────────────\n\ninterface PersistentNotificationListItemProps {\n  item: PersistentNotificationItem;\n  now: number;\n  onDismiss?: (item: PersistentNotificationItem) => void;\n}\n\nfunction PersistentNotificationListItem({\n  item,\n  now,\n  onDismiss,\n}: PersistentNotificationListItemProps) {\n  const { t } = useI18n();\n  const suffix = (\n    <Text opacity={0.5} preset=\"c2\">\n      {formatRelativeTime(item.createdAt, t, now)}\n    </Text>\n  );\n\n  // useEvent keeps the callback stable across re-renders regardless of\n  // item reference changes (avoids unnecessary NotificationCard re-renders).\n  const handleDismiss = useEvent((_id: Key, _reason: DismissReason) => {\n    onDismiss?.(item);\n  });\n\n  const parentInterceptor = useContext(NotificationActionInterceptorContext);\n\n  // Chains with the list-level interceptor (e.g. closing the parent popover).\n  // Dismissal itself is handled by NotificationAction via the dismiss context\n  // to avoid double-firing onDismiss.\n  const handleItemAction = useEvent(() => {\n    parentInterceptor?.();\n  });\n\n  return (\n    <NotificationActionInterceptorContext.Provider value={handleItemAction}>\n      <NotificationCard\n        qa=\"PersistentNotificationItem\"\n        theme={item.theme}\n        title={item.title}\n        description={item.description}\n        icon={item.icon}\n        actions={item.actions}\n        isDismissable={!!onDismiss}\n        elevated={false}\n        notificationId={item.id}\n        suffix={suffix}\n        onDismiss={onDismiss ? handleDismiss : undefined}\n      />\n    </NotificationActionInterceptorContext.Provider>\n  );\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/components/overlays/Notifications/dismissed-storage.ts
 const STORAGE_KEY = "cube-ui-dismissed-notifications";
 const TTL_MS = 864e5;
@@ -37,7 +37,7 @@ function cleanupAndGetValidIds() {
 	if (changed) writeMap(map);
 	return validIds;
 }
-
 //#endregion
 export { cleanupAndGetValidIds, saveDismissedId };
+
 //# sourceMappingURL=dismissed-storage.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"dismissed-storage.js","names":["Key","STORAGE_KEY","TTL_MS","DismissedMap","Record","readMap","raw","localStorage","getItem","JSON","parse","writeMap","map","setItem","stringify","saveDismissedId","id","String","Date","now","cleanupAndGetValidIds","Set","validIds","changed","timestamp","Object","entries","add"],"sources":["../../../../src/components/overlays/Notifications/dismissed-storage.ts"],"sourcesContent":["import type { Key } from 'react';\n\nconst STORAGE_KEY = 'cube-ui-dismissed-notifications';\nconst TTL_MS = 86_400_000; // 24 hours\n\ntype DismissedMap = Record<string, number>;\n\nfunction readMap(): DismissedMap {\n  try {\n    const raw = localStorage.getItem(STORAGE_KEY);\n\n    if (!raw) return {};\n\n    return JSON.parse(raw) as DismissedMap;\n  } catch {\n    return {};\n  }\n}\n\nfunction writeMap(map: DismissedMap): void {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(map));\n  } catch {\n    // SSR, private browsing, or quota exceeded — silently ignore\n  }\n}\n\nexport function saveDismissedId(id: Key): void {\n  const map = readMap();\n\n  map[String(id)] = Date.now();\n  writeMap(map);\n}\n\n/**\n * Reads the dismissed-IDs map from localStorage, removes entries older than\n * 24 hours, writes the cleaned map back, and returns the remaining valid IDs.\n */\nexport function cleanupAndGetValidIds(): Set<string> {\n  const map = readMap();\n  const now = Date.now();\n  const validIds = new Set<string>();\n  let changed = false;\n\n  for (const [id, timestamp] of Object.entries(map)) {\n    if (now - timestamp > TTL_MS) {\n      delete map[id];\n      changed = true;\n    } else {\n      validIds.add(id);\n    }\n  }\n\n  if (changed) {\n    writeMap(map);\n  }\n\n  return validIds;\n}\n"],"mappings":";;AAEA,MAAMC,cAAc;AACpB,MAAMC,SAAS;AAIf,SAASG,UAAwB;AAC/B,KAAI;EACF,MAAMC,MAAMC,aAAaC,QAAQP,YAAY;AAE7C,MAAI,CAACK,IAAK,QAAO,EAAE;AAEnB,SAAOG,KAAKC,MAAMJ,IAAI;SAChB;AACN,SAAO,EAAE;;;AAIb,SAASK,SAASC,KAAyB;AACzC,KAAI;AACFL,eAAaM,QAAQZ,aAAaQ,KAAKK,UAAUF,IAAI,CAAC;SAChD;;AAKV,SAAgBG,gBAAgBC,IAAe;CAC7C,MAAMJ,MAAMP,SAAS;AAErBO,KAAIK,OAAOD,GAAG,IAAIE,KAAKC,KAAK;AAC5BR,UAASC,IAAI;;;;;;AAOf,SAAgBQ,wBAAqC;CACnD,MAAMR,MAAMP,SAAS;CACrB,MAAMc,MAAMD,KAAKC,KAAK;CACtB,MAAMG,2BAAW,IAAID,KAAa;CAClC,IAAIE,UAAU;AAEd,MAAK,MAAM,CAACP,IAAIQ,cAAcC,OAAOC,QAAQd,IAAI,CAC/C,KAAIO,MAAMK,YAAYtB,QAAQ;AAC5B,SAAOU,IAAII;AACXO,YAAU;OAEVD,UAASK,IAAIX,GAAG;AAIpB,KAAIO,QACFZ,UAASC,IAAI;AAGf,QAAOU"}
+{"version":3,"file":"dismissed-storage.js","names":["Key","STORAGE_KEY","TTL_MS","DismissedMap","Record","readMap","raw","localStorage","getItem","JSON","parse","writeMap","map","setItem","stringify","saveDismissedId","id","String","Date","now","cleanupAndGetValidIds","Set","validIds","changed","timestamp","Object","entries","add"],"sources":["../../../../src/components/overlays/Notifications/dismissed-storage.ts"],"sourcesContent":["import type { Key } from 'react';\n\nconst STORAGE_KEY = 'cube-ui-dismissed-notifications';\nconst TTL_MS = 86_400_000; // 24 hours\n\ntype DismissedMap = Record<string, number>;\n\nfunction readMap(): DismissedMap {\n  try {\n    const raw = localStorage.getItem(STORAGE_KEY);\n\n    if (!raw) return {};\n\n    return JSON.parse(raw) as DismissedMap;\n  } catch {\n    return {};\n  }\n}\n\nfunction writeMap(map: DismissedMap): void {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(map));\n  } catch {\n    // SSR, private browsing, or quota exceeded — silently ignore\n  }\n}\n\nexport function saveDismissedId(id: Key): void {\n  const map = readMap();\n\n  map[String(id)] = Date.now();\n  writeMap(map);\n}\n\n/**\n * Reads the dismissed-IDs map from localStorage, removes entries older than\n * 24 hours, writes the cleaned map back, and returns the remaining valid IDs.\n */\nexport function cleanupAndGetValidIds(): Set<string> {\n  const map = readMap();\n  const now = Date.now();\n  const validIds = new Set<string>();\n  let changed = false;\n\n  for (const [id, timestamp] of Object.entries(map)) {\n    if (now - timestamp > TTL_MS) {\n      delete map[id];\n      changed = true;\n    } else {\n      validIds.add(id);\n    }\n  }\n\n  if (changed) {\n    writeMap(map);\n  }\n\n  return validIds;\n}\n"],"mappings":";;AAEA,MAAMC,cAAc;AACpB,MAAMC,SAAS;AAIf,SAASG,UAAwB;CAC/B,IAAI;EACF,MAAMC,MAAMC,aAAaC,QAAQP,WAAW;EAE5C,IAAI,CAACK,KAAK,OAAO,CAAC;EAElB,OAAOG,KAAKC,MAAMJ,GAAG;CACvB,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAASK,SAASC,KAAyB;CACzC,IAAI;EACFL,aAAaM,QAAQZ,aAAaQ,KAAKK,UAAUF,GAAG,CAAC;CACvD,QAAQ,CACN;AAEJ;AAEA,SAAgBG,gBAAgBC,IAAe;CAC7C,MAAMJ,MAAMP,QAAQ;CAEpBO,IAAIK,OAAOD,EAAE,KAAKE,KAAKC,IAAI;CAC3BR,SAASC,GAAG;AACd;;;;;AAMA,SAAgBQ,wBAAqC;CACnD,MAAMR,MAAMP,QAAQ;CACpB,MAAMc,MAAMD,KAAKC,IAAI;CACrB,MAAMG,2BAAW,IAAID,IAAY;CACjC,IAAIE,UAAU;CAEd,KAAK,MAAM,CAACP,IAAIQ,cAAcC,OAAOC,QAAQd,GAAG,GAC9C,IAAIO,MAAMK,YAAYtB,QAAQ;EAC5B,OAAOU,IAAII;EACXO,UAAU;CACZ,OACED,SAASK,IAAIX,EAAE;CAInB,IAAIO,SACFZ,SAASC,GAAG;CAGd,OAAOU;AACT"}

package/dist/components/overlays/Notifications/format-relative-time.d.ts

@@ -1,6 +1,5 @@
 
 import { TFunction } from "i18next";
-
 //#region src/components/overlays/Notifications/format-relative-time.d.ts
 /**
  * Lightweight relative time formatter.
@@ -19,7 +18,6 @@ import { TFunction } from "i18next";
  * in so the string reacts to the active language. When omitted (non-component
  * callers), English defaults are used.
  */
-declare function formatRelativeTime(timestamp: number, t?: TFunction, now?: number): string;
+export declare function formatRelativeTime(timestamp: number, t?: TFunction, now?: number): string;
 //#endregion
-export { formatRelativeTime };
 //# sourceMappingURL=format-relative-time.d.ts.map

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
 //#region src/components/overlays/Notifications/format-relative-time.ts
 /**
 * Lightweight relative time formatter.
@@ -38,7 +38,7 @@ function formatRelativeTime(timestamp, t, now = Date.now()) {
 	if (diffDays < 365) return translate("relativeTime.monthsAgo", "{{count}} mo ago", diffMonths);
 	return translate("relativeTime.yearsAgo", "{{count}} y ago", Math.floor(diffDays / 365));
 }
-
 //#endregion
 export { formatRelativeTime };
+
 //# sourceMappingURL=format-relative-time.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"format-relative-time.js","names":["TFunction","formatRelativeTime","timestamp","t","now","Date","translate","key","defaultValue","count","undefined","replace","String","diffMs","diffSeconds","Math","floor","diffMinutes","diffHours","diffDays","diffWeeks","diffMonths","diffYears"],"sources":["../../../../src/components/overlays/Notifications/format-relative-time.ts"],"sourcesContent":["import type { TFunction } from 'i18next';\n\n/**\n * Lightweight relative time formatter.\n *\n * Output format (English source; localized via the `uikit` bundle's\n * `relativeTime.*` keys):\n * - `just now` (< 1 minute)\n * - `N min ago` (1–59 minutes)\n * - `N h ago` (1–23 hours)\n * - `N d ago` (1–6 days)\n * - `N w ago` (1–4 weeks)\n * - `N mo ago` (1–11 months)\n * - `N y ago` (1+ years)\n *\n * `t` is the UI Kit translation function (from `useI18n`), passed\n * in so the string reacts to the active language. When omitted (non-component\n * callers), English defaults are used.\n */\nexport function formatRelativeTime(\n  timestamp: number,\n  t?: TFunction,\n  now = Date.now(),\n): string {\n  const translate = (\n    key: string,\n    defaultValue: string,\n    count?: number,\n  ): string => {\n    if (t) {\n      return t(key, defaultValue, count != null ? { count } : undefined);\n    }\n\n    return count != null\n      ? defaultValue.replace('{{count}}', String(count))\n      : defaultValue;\n  };\n\n  const diffMs = now - timestamp;\n\n  if (diffMs < 0) {\n    return translate('relativeTime.justNow', 'just now');\n  }\n\n  const diffSeconds = Math.floor(diffMs / 1000);\n  const diffMinutes = Math.floor(diffSeconds / 60);\n  const diffHours = Math.floor(diffMinutes / 60);\n  const diffDays = Math.floor(diffHours / 24);\n\n  if (diffMinutes < 1) {\n    return translate('relativeTime.justNow', 'just now');\n  }\n\n  if (diffHours < 1) {\n    return translate('relativeTime.minAgo', '{{count}} min ago', diffMinutes);\n  }\n\n  if (diffDays < 1) {\n    return translate('relativeTime.hoursAgo', '{{count}} h ago', diffHours);\n  }\n\n  if (diffDays < 7) {\n    return translate('relativeTime.daysAgo', '{{count}} d ago', diffDays);\n  }\n\n  const diffWeeks = Math.floor(diffDays / 7);\n\n  if (diffDays < 30) {\n    return translate('relativeTime.weeksAgo', '{{count}} w ago', diffWeeks);\n  }\n\n  const diffMonths = Math.floor(diffDays / 30);\n\n  if (diffDays < 365) {\n    return translate('relativeTime.monthsAgo', '{{count}} mo ago', diffMonths);\n  }\n\n  const diffYears = Math.floor(diffDays / 365);\n\n  return translate('relativeTime.yearsAgo', '{{count}} y ago', diffYears);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,SAAgBC,mBACdC,WACAC,GACAC,MAAMC,KAAKD,KAAK,EACR;CACR,MAAME,aACJC,KACAC,cACAC,UACW;AACX,MAAIN,EACF,QAAOA,EAAEI,KAAKC,cAAcC,SAAS,OAAO,EAAEA,OAAO,GAAGC,OAAU;AAGpE,SAAOD,SAAS,OACZD,aAAaG,QAAQ,aAAaC,OAAOH,MAAM,CAAC,GAChDD;;CAGN,MAAMK,SAAST,MAAMF;AAErB,KAAIW,SAAS,EACX,QAAOP,UAAU,wBAAwB,WAAW;CAGtD,MAAMQ,cAAcC,KAAKC,MAAMH,SAAS,IAAK;CAC7C,MAAMI,cAAcF,KAAKC,MAAMF,cAAc,GAAG;CAChD,MAAMI,YAAYH,KAAKC,MAAMC,cAAc,GAAG;CAC9C,MAAME,WAAWJ,KAAKC,MAAME,YAAY,GAAG;AAE3C,KAAID,cAAc,EAChB,QAAOX,UAAU,wBAAwB,WAAW;AAGtD,KAAIY,YAAY,EACd,QAAOZ,UAAU,uBAAuB,qBAAqBW,YAAY;AAG3E,KAAIE,WAAW,EACb,QAAOb,UAAU,yBAAyB,mBAAmBY,UAAU;AAGzE,KAAIC,WAAW,EACb,QAAOb,UAAU,wBAAwB,mBAAmBa,SAAS;CAGvE,MAAMC,YAAYL,KAAKC,MAAMG,WAAW,EAAE;AAE1C,KAAIA,WAAW,GACb,QAAOb,UAAU,yBAAyB,mBAAmBc,UAAU;CAGzE,MAAMC,aAAaN,KAAKC,MAAMG,WAAW,GAAG;AAE5C,KAAIA,WAAW,IACb,QAAOb,UAAU,0BAA0B,oBAAoBe,WAAW;AAK5E,QAAOf,UAAU,yBAAyB,mBAFxBS,KAAKC,MAAMG,WAAW,IAAI,CAE2B"}
+{"version":3,"file":"format-relative-time.js","names":["TFunction","formatRelativeTime","timestamp","t","now","Date","translate","key","defaultValue","count","undefined","replace","String","diffMs","diffSeconds","Math","floor","diffMinutes","diffHours","diffDays","diffWeeks","diffMonths","diffYears"],"sources":["../../../../src/components/overlays/Notifications/format-relative-time.ts"],"sourcesContent":["import type { TFunction } from 'i18next';\n\n/**\n * Lightweight relative time formatter.\n *\n * Output format (English source; localized via the `uikit` bundle's\n * `relativeTime.*` keys):\n * - `just now` (< 1 minute)\n * - `N min ago` (1–59 minutes)\n * - `N h ago` (1–23 hours)\n * - `N d ago` (1–6 days)\n * - `N w ago` (1–4 weeks)\n * - `N mo ago` (1–11 months)\n * - `N y ago` (1+ years)\n *\n * `t` is the UI Kit translation function (from `useI18n`), passed\n * in so the string reacts to the active language. When omitted (non-component\n * callers), English defaults are used.\n */\nexport function formatRelativeTime(\n  timestamp: number,\n  t?: TFunction,\n  now = Date.now(),\n): string {\n  const translate = (\n    key: string,\n    defaultValue: string,\n    count?: number,\n  ): string => {\n    if (t) {\n      return t(key, defaultValue, count != null ? { count } : undefined);\n    }\n\n    return count != null\n      ? defaultValue.replace('{{count}}', String(count))\n      : defaultValue;\n  };\n\n  const diffMs = now - timestamp;\n\n  if (diffMs < 0) {\n    return translate('relativeTime.justNow', 'just now');\n  }\n\n  const diffSeconds = Math.floor(diffMs / 1000);\n  const diffMinutes = Math.floor(diffSeconds / 60);\n  const diffHours = Math.floor(diffMinutes / 60);\n  const diffDays = Math.floor(diffHours / 24);\n\n  if (diffMinutes < 1) {\n    return translate('relativeTime.justNow', 'just now');\n  }\n\n  if (diffHours < 1) {\n    return translate('relativeTime.minAgo', '{{count}} min ago', diffMinutes);\n  }\n\n  if (diffDays < 1) {\n    return translate('relativeTime.hoursAgo', '{{count}} h ago', diffHours);\n  }\n\n  if (diffDays < 7) {\n    return translate('relativeTime.daysAgo', '{{count}} d ago', diffDays);\n  }\n\n  const diffWeeks = Math.floor(diffDays / 7);\n\n  if (diffDays < 30) {\n    return translate('relativeTime.weeksAgo', '{{count}} w ago', diffWeeks);\n  }\n\n  const diffMonths = Math.floor(diffDays / 30);\n\n  if (diffDays < 365) {\n    return translate('relativeTime.monthsAgo', '{{count}} mo ago', diffMonths);\n  }\n\n  const diffYears = Math.floor(diffDays / 365);\n\n  return translate('relativeTime.yearsAgo', '{{count}} y ago', diffYears);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,SAAgBC,mBACdC,WACAC,GACAC,MAAMC,KAAKD,IAAI,GACP;CACR,MAAME,aACJC,KACAC,cACAC,UACW;EACX,IAAIN,GACF,OAAOA,EAAEI,KAAKC,cAAcC,SAAS,OAAO,EAAEA,MAAM,IAAIC,KAAAA,CAAS;EAGnE,OAAOD,SAAS,OACZD,aAAaG,QAAQ,aAAaC,OAAOH,KAAK,CAAC,IAC/CD;CACN;CAEA,MAAMK,SAAST,MAAMF;CAErB,IAAIW,SAAS,GACX,OAAOP,UAAU,wBAAwB,UAAU;CAGrD,MAAMQ,cAAcC,KAAKC,MAAMH,SAAS,GAAI;CAC5C,MAAMI,cAAcF,KAAKC,MAAMF,cAAc,EAAE;CAC/C,MAAMI,YAAYH,KAAKC,MAAMC,cAAc,EAAE;CAC7C,MAAME,WAAWJ,KAAKC,MAAME,YAAY,EAAE;CAE1C,IAAID,cAAc,GAChB,OAAOX,UAAU,wBAAwB,UAAU;CAGrD,IAAIY,YAAY,GACd,OAAOZ,UAAU,uBAAuB,qBAAqBW,WAAW;CAG1E,IAAIE,WAAW,GACb,OAAOb,UAAU,yBAAyB,mBAAmBY,SAAS;CAGxE,IAAIC,WAAW,GACb,OAAOb,UAAU,wBAAwB,mBAAmBa,QAAQ;CAGtE,MAAMC,YAAYL,KAAKC,MAAMG,WAAW,CAAC;CAEzC,IAAIA,WAAW,IACb,OAAOb,UAAU,yBAAyB,mBAAmBc,SAAS;CAGxE,MAAMC,aAAaN,KAAKC,MAAMG,WAAW,EAAE;CAE3C,IAAIA,WAAW,KACb,OAAOb,UAAU,0BAA0B,oBAAoBe,UAAU;CAK3E,OAAOf,UAAU,yBAAyB,mBAFxBS,KAAKC,MAAMG,WAAW,GAEqBG,CAAS;AACxE"}

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

@@ -10,7 +10,6 @@ import { OverlayProvider } from "./OverlayProvider.js";
 import { useNotifications } from "./use-notifications.js";
 import { useNotificationsCount, usePersistentNotifications } from "./use-persistent-notifications.js";
 import { formatRelativeTime } from "./format-relative-time.js";
-
 //#region src/components/overlays/Notifications/index.d.ts
 /**
  * Declarative Notification component with compound API.
@@ -34,10 +33,10 @@ import { formatRelativeTime } from "./format-relative-time.js";
  * />
  * ```
  */
-declare const Notification: typeof Notification$1 & {
+export declare const Notification: typeof Notification$1 & {
   Action: typeof NotificationAction;
 };
-type NotificationComponent = typeof Notification;
+export type NotificationComponent = typeof Notification;
 //#endregion
-export { Notification, NotificationComponent };
+export { type DismissReason, NotificationAction, type NotificationActionProps, type NotificationBaseOptions, NotificationCard, type NotificationCardProps, type NotificationHandle, NotificationItem, type NotificationItemProps, type NotificationOptions, type NotificationProps, type NotificationType, type NotificationsApi, type OverlayNotificationOptions, OverlayProvider, type OverlayProviderProps, type PersistentNotificationItem, PersistentNotificationsList, type PersistentNotificationsListProps, type StoredNotificationOptions, formatRelativeTime, useNotifications, useNotificationsCount, usePersistentNotifications };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
-import { useToastContext } from "./NotificationContext.js";
+/** @license MIT | @cube-dev/ui-kit v0.198.0 | Cube Dev Team */
+import "./NotificationContext.js";
 import { NotificationAction } from "./NotificationAction.js";
 import { NotificationCard } from "./NotificationCard.js";
 import { NotificationItem } from "./NotificationItem.js";
@@ -9,7 +9,6 @@ import { formatRelativeTime } from "./format-relative-time.js";
 import { useNotificationsCount, usePersistentNotifications } from "./use-persistent-notifications.js";
 import { PersistentNotificationsList } from "./PersistentNotificationsList.js";
 import { useNotifications } from "./use-notifications.js";
-
 //#region src/components/overlays/Notifications/index.ts
 /**
 * Declarative Notification component with compound API.
@@ -34,7 +33,7 @@ import { useNotifications } from "./use-notifications.js";
 * ```
 */
 const Notification = Object.assign(Notification$1, { Action: NotificationAction });
-
 //#endregion
-export { Notification };
+export { Notification, NotificationAction, NotificationCard, NotificationItem, OverlayProvider, PersistentNotificationsList, formatRelativeTime, useNotifications, useNotificationsCount, usePersistentNotifications };
+
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Notification","NotificationBase","NotificationAction","NotificationCard","NotificationCardProps","NotificationItem","NotificationItemProps","PersistentNotificationsList","OverlayProvider","useToastContext","useNotifications","usePersistentNotifications","useNotificationsCount","formatRelativeTime","NotificationType","DismissReason","NotificationBaseOptions","OverlayNotificationOptions","StoredNotificationOptions","NotificationOptions","NotificationActionProps","NotificationHandle","NotificationsApi","PersistentNotificationItem","PersistentNotificationsListProps","OverlayProviderProps","NotificationProps","Object","assign","Action","NotificationComponent"],"sources":["../../../../src/components/overlays/Notifications/index.ts"],"sourcesContent":["// ─── Components ──────────────────────────────────────────────────────\n\nimport { Notification as NotificationBase } from './Notification';\nimport { NotificationAction } from './NotificationAction';\n\nexport { NotificationAction } from './NotificationAction';\nexport { NotificationCard } from './NotificationCard';\nexport type { NotificationCardProps } from './NotificationCard';\nexport { NotificationItem } from './NotificationItem';\nexport type { NotificationItemProps } from './NotificationItem';\nexport { PersistentNotificationsList } from './PersistentNotificationsList';\n\n// ─── Provider ────────────────────────────────────────────────────────\n\nexport { OverlayProvider } from './OverlayProvider';\n\n// useToastContext is re-exported for Toast module backward compatibility\nexport { useToastContext } from './NotificationContext';\n\n// ─── Hooks ───────────────────────────────────────────────────────────\n\nexport { useNotifications } from './use-notifications';\nexport {\n  usePersistentNotifications,\n  useNotificationsCount,\n} from './use-persistent-notifications';\n\n// ─── Utilities ───────────────────────────────────────────────────────\n\nexport { formatRelativeTime } from './format-relative-time';\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport type {\n  NotificationType,\n  DismissReason,\n  NotificationBaseOptions,\n  OverlayNotificationOptions,\n  StoredNotificationOptions,\n  NotificationOptions,\n  NotificationActionProps,\n  NotificationHandle,\n  NotificationsApi,\n  PersistentNotificationItem,\n  PersistentNotificationsListProps,\n  OverlayProviderProps,\n  NotificationProps,\n} from './types';\n\n// ─── Compound Notification Component ─────────────────────────────────\n\n/**\n * Declarative Notification component with compound API.\n *\n * @example\n * ```tsx\n * // Declarative usage\n * <Notification\n *   id=\"release:new-version\"\n *   theme=\"warning\"\n *   title=\"New release available\"\n *   description=\"2.0.0 can be installed now.\"\n *   actions={\n *     <>\n *       <Notification.Action>Later</Notification.Action>\n *       <Notification.Action onPress={() => openUpgradeDialog()}>\n *         Upgrade\n *       </Notification.Action>\n *     </>\n *   }\n * />\n * ```\n */\nexport const Notification = Object.assign(NotificationBase, {\n  Action: NotificationAction,\n});\n\nexport type NotificationComponent = typeof Notification;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,MAAaA,eAAe2B,OAAOC,OAAO3B,gBAAkB,EAC1D4B,QAAQ3B,oBACT,CAAC"}
+{"version":3,"file":"index.js","names":["Notification","NotificationBase","NotificationAction","NotificationCard","NotificationCardProps","NotificationItem","NotificationItemProps","PersistentNotificationsList","OverlayProvider","useToastContext","useNotifications","usePersistentNotifications","useNotificationsCount","formatRelativeTime","NotificationType","DismissReason","NotificationBaseOptions","OverlayNotificationOptions","StoredNotificationOptions","NotificationOptions","NotificationActionProps","NotificationHandle","NotificationsApi","PersistentNotificationItem","PersistentNotificationsListProps","OverlayProviderProps","NotificationProps","Object","assign","Action","NotificationComponent","NotificationBase"],"sources":["../../../../src/components/overlays/Notifications/index.ts"],"sourcesContent":["// ─── Components ──────────────────────────────────────────────────────\n\nimport { Notification as NotificationBase } from './Notification';\nimport { NotificationAction } from './NotificationAction';\n\nexport { NotificationAction } from './NotificationAction';\nexport { NotificationCard } from './NotificationCard';\nexport type { NotificationCardProps } from './NotificationCard';\nexport { NotificationItem } from './NotificationItem';\nexport type { NotificationItemProps } from './NotificationItem';\nexport { PersistentNotificationsList } from './PersistentNotificationsList';\n\n// ─── Provider ────────────────────────────────────────────────────────\n\nexport { OverlayProvider } from './OverlayProvider';\n\n// useToastContext is re-exported for Toast module backward compatibility\nexport { useToastContext } from './NotificationContext';\n\n// ─── Hooks ───────────────────────────────────────────────────────────\n\nexport { useNotifications } from './use-notifications';\nexport {\n  usePersistentNotifications,\n  useNotificationsCount,\n} from './use-persistent-notifications';\n\n// ─── Utilities ───────────────────────────────────────────────────────\n\nexport { formatRelativeTime } from './format-relative-time';\n\n// ─── Types ───────────────────────────────────────────────────────────\n\nexport type {\n  NotificationType,\n  DismissReason,\n  NotificationBaseOptions,\n  OverlayNotificationOptions,\n  StoredNotificationOptions,\n  NotificationOptions,\n  NotificationActionProps,\n  NotificationHandle,\n  NotificationsApi,\n  PersistentNotificationItem,\n  PersistentNotificationsListProps,\n  OverlayProviderProps,\n  NotificationProps,\n} from './types';\n\n// ─── Compound Notification Component ─────────────────────────────────\n\n/**\n * Declarative Notification component with compound API.\n *\n * @example\n * ```tsx\n * // Declarative usage\n * <Notification\n *   id=\"release:new-version\"\n *   theme=\"warning\"\n *   title=\"New release available\"\n *   description=\"2.0.0 can be installed now.\"\n *   actions={\n *     <>\n *       <Notification.Action>Later</Notification.Action>\n *       <Notification.Action onPress={() => openUpgradeDialog()}>\n *         Upgrade\n *       </Notification.Action>\n *     </>\n *   }\n * />\n * ```\n */\nexport const Notification = Object.assign(NotificationBase, {\n  Action: NotificationAction,\n});\n\nexport type NotificationComponent = typeof Notification;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,MAAaA,eAAe2B,OAAOC,OAAO3B,gBAAkB,EAC1D4B,QAAQ3B,mBACV,CAAC"}

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.197.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.197.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":";;;;;;AAgBA,IAAIY,iBAAiB;AAErB,SAASC,kBAA0B;CACjCD,kBAAkB;CAClB,OAAO,eAAeA,eAAc,GAAIE,KAAKC,IAAI;AACnD;AAEA,SAASC,aACPC,SACsC;CACtC,OAAOA,QAAQC,SAAS;AAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgBC,mBAAqC;CACnD,MAAM,EACJC,iBACAC,oBACAC,mBACAC,sBACAC,eACAC,iCACEpB,uBAAuB;CAE3B,MAAMqB,aAAaxB,OAAeW,gBAAgB,CAAC;CACnD,MAAMc,eAAezB,OAAO,IAAI;CAChC,MAAM0B,kBAAkB1B,OAA6C,IAAI;CAGzE,MAAM6B,iBAAiB7B,OAAmC,IAAI;CAI9DE,QACE2B,eAAeC,WACb,gBAAgBD,eAAeC,WAC/BD,eAAeC,QAAQC,eAAe,QACtCF,eAAeC,QAAQE,MAAM,MAC/B;EACEC,MAAM;EACNC,KAAK,CAAC,gBAAgB,uBAAuB;EAC7CC,MAAM,CACJ,wFAAwF;CAE5F,CACF;CAEAjC,QACE2B,eAAeC,SAASd,SAAS,YAC/Ba,eAAeC,QAAQE,MAAM,MAC/B;EACEC,MAAM;EACNC,KAAK,CAAC,gBAAgB,mBAAmB;EACzCC,MAAM,CACJ,oFAAkF;CAEtF,CACF;CAIA,MAAMC,kBAAkBpC,OAAO,CAAC;CAEhC,MAAMqC,qBAAqBpC,UACxBc,YAAyE;EACxEqB,gBAAgBN,WAAW;EAC3B,MAAMjB,MAAMD,KAAKC,IAAI;EACrB,MAAMmB,KAAKjB,QAAQiB,MAAM,UAAUI,gBAAgBN,QAAO,GAAIjB;EAC9D,MAAM0B,YAAYxB,QAAQwB,aAAa1B;EAEvC,MAAM2B,iBAA6C;GACjDR;GACAS,OAAO1B,QAAQ0B;GACfC,OAAO3B,QAAQ2B;GACfC,aAAa5B,QAAQ4B;GACrBC,MAAM7B,QAAQ6B;GACdC,SAAS9B,QAAQ8B,WAAWC,KAAAA;GAC5BP;GACAQ,WAAWR;GACXS,SAASxB,WAAWM;EACtB;EAEAV,kBAAkBoB,cAAc;EAEhC,OAAO;GACLR;GACAiB,eAAe;IACb5B,qBAAqBW,EAAE;GACzB;EACF;CACF,CACF;CAIA,MAAMkB,SAASjD,UACZc,cAAqD;EAEpD,IAAI,CAACU,aAAaK,SAChB,OAAO;GACLE,IAAIjB,UAAQiB,MAAM;GAClBiB,eAAe,CAAC;EAClB;EAGFpB,eAAeC,UAAUf;EAEzB,IAAID,aAAaC,SAAO,GACtB,OAAOsB,mBAAmBtB,SAAO;EAInC,MAAMoC,iBAA6C;GACjD,GAAGpC;GACHC,MAAM;EACR;EAEA,MAAMoC,iBAAiBlC,gBACrBiC,gBACA3B,WAAWM,OACb;EAEA,OAAO;GACLE,IAAIoB;GACJH,eAAe;IACb,IAAIxB,aAAaK,SACfX,mBAAmBiC,gBAAgB,KAAK;GAE5C;EACF;CACF,CACF;CAMA,MAAMC,SAASpD,UACZc,cAAyE;EAExE,IAAI,CAACU,aAAaK,SAChB,OAAO;GACLE,IAAIjB,UAAQiB,MAAM;GAClBiB,eAAe,CAAC;EAClB;EAGFpB,eAAeC,UAAU;GAAE,GAAGf;GAASC,MAAM;EAAS;EAEtD,OAAOqB,mBAAmBtB,SAAO;CACnC,CACF;CAEA,MAAMkC,UAAUhD,UAAU+B,SAAY;EACpC,IAAI,CAACP,aAAaK,SAAS;EAE3BX,mBAAmBa,MAAI,KAAK;CAC9B,CAAC;CAIDjC,gBAAgB;EACd0B,aAAaK,UAAU;EAGvB,IAAIJ,gBAAgBI,SAAS;GAC3BwB,aAAa5B,gBAAgBI,OAAO;GACpCJ,gBAAgBI,UAAU;EAC5B;EAEA,aAAa;GACXL,aAAaK,UAAU;GAIvBJ,gBAAgBI,UAAUF,iBAAiB;IACzCN,cAAcE,WAAWM,OAAO;IAChCP,6BAA6BC,WAAWM,OAAO;GACjD,GAAG,CAAC;EACN;CACF,GAAG,CAACR,eAAeC,4BAA4B,CAAC;CAEhD,OAAO;EAAE2B;EAAQG;EAAQJ;CAAQ;AACnC"}