@vokril/ui-solid 0.28.0 → 0.29.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/README.md +21 -4
  3. package/dist/{StatusBarNotificationBell-yryWdwyX.js → StatusBarNotificationBell-7Izs_msz.js} +4083 -4058
  4. package/dist/StatusBarNotificationBell-BJiORN4s.cjs +50 -0
  5. package/dist/_internal/contract/notification.d.cts +4 -3
  6. package/dist/_internal/contract/notification.d.ts +4 -3
  7. package/dist/index.cjs +1 -1
  8. package/dist/index.js +153 -152
  9. package/dist/notifications/NotificationItem.d.cts +3 -3
  10. package/dist/notifications/NotificationItem.d.ts +3 -3
  11. package/dist/notifications/StatusBarNotificationBell.d.cts +18 -6
  12. package/dist/notifications/StatusBarNotificationBell.d.ts +18 -6
  13. package/dist/notifications/dismissableToastIds.d.cts +2 -1
  14. package/dist/notifications/dismissableToastIds.d.ts +2 -1
  15. package/dist/notifications/index.cjs +1 -1
  16. package/dist/notifications/index.js +41 -40
  17. package/dist/notifications/nativeEngine.d.cts +50 -13
  18. package/dist/notifications/nativeEngine.d.ts +50 -13
  19. package/dist/notifications/notificationCardServices.d.cts +2 -1
  20. package/dist/notifications/notificationCardServices.d.ts +2 -1
  21. package/dist/notifications/notificationCommands.d.cts +3 -3
  22. package/dist/notifications/notificationCommands.d.ts +3 -3
  23. package/dist/notifications/notificationService.d.cts +10 -1
  24. package/dist/notifications/notificationService.d.ts +10 -1
  25. package/dist/server/{StatusBarNotificationBell-DdAdsduo.js → StatusBarNotificationBell-D8Jt3PXI.js} +3885 -3860
  26. package/dist/server/StatusBarNotificationBell-LJHLMT9F.cjs +49 -0
  27. package/dist/server/index.cjs +1 -1
  28. package/dist/server/index.js +138 -137
  29. package/dist/server/notifications/index.cjs +1 -1
  30. package/dist/server/notifications/index.js +41 -40
  31. package/dist/solid/notifications/NotificationHost.jsx +1 -11
  32. package/dist/solid/notifications/StatusBarNotificationBell.jsx +14 -17
  33. package/dist/solid/notifications/nativeEngine.js +51 -11
  34. package/dist/solid/notifications/notificationService.js +2 -0
  35. package/dist/style.css +1 -1
  36. package/dist/ui.css +1 -1
  37. package/package.json +1 -1
  38. package/dist/StatusBarNotificationBell-CJ3HuhRu.cjs +0 -50
  39. package/dist/server/StatusBarNotificationBell-Z2LmIkM1.cjs +0 -49
@@ -14,9 +14,9 @@ export interface NotificationItemController {
14
14
  * The user sent the card away — its close button, a gear-menu choice, or an action that does not keep the card and
15
15
  * left it on the stack itself (the realm's actions close their card as the program's close). The realm's controller
16
16
  * hands it to the stack's `dismiss`: the card's handles report the user's close, and a running progress only leaves
17
- * the toast stack for the notification center — unless the gear menu's choice turned its notification down, which
18
- * ends it. A controller over another stack — a native overlay's bridge, a preview — passes it on as that stack's
19
- * user close, never as the program's `close`.
17
+ * the toast stack for the notification center (or stays, where none is reachable) — unless the gear menu's choice
18
+ * turned its notification down, which ends it. A controller over another stack — a native overlay's bridge, a preview
19
+ * — passes it on as that stack's user close, never as the program's `close`.
20
20
  */
21
21
  close(id: string): void;
22
22
  setFocus(id: string, focused: boolean): void;
@@ -14,9 +14,9 @@ export interface NotificationItemController {
14
14
  * The user sent the card away — its close button, a gear-menu choice, or an action that does not keep the card and
15
15
  * left it on the stack itself (the realm's actions close their card as the program's close). The realm's controller
16
16
  * hands it to the stack's `dismiss`: the card's handles report the user's close, and a running progress only leaves
17
- * the toast stack for the notification center — unless the gear menu's choice turned its notification down, which
18
- * ends it. A controller over another stack — a native overlay's bridge, a preview — passes it on as that stack's
19
- * user close, never as the program's `close`.
17
+ * the toast stack for the notification center (or stays, where none is reachable) — unless the gear menu's choice
18
+ * turned its notification down, which ends it. A controller over another stack — a native overlay's bridge, a preview
19
+ * — passes it on as that stack's user close, never as the program's `close`.
20
20
  */
21
21
  close(id: string): void;
22
22
  setFocus(id: string, focused: boolean): void;
@@ -1,8 +1,17 @@
1
1
  export interface StatusBarNotificationBellProps {
2
+ /**
3
+ * Whether the popover's notification center is open, when the host holds that state — so the host's own code can
4
+ * open the center, as a status-bar entry of a progress that runs out of sight does (the reference's window progress
5
+ * entry runs `notifications.showList`, `workbench/services/progress/browser/progressService.ts:258-263`). The bell
6
+ * then shows what `open` says and asks for each change of its own through `onOpenChange`. Unset, the bell holds the
7
+ * state itself.
8
+ */
9
+ readonly open?: boolean | undefined;
2
10
  /**
3
11
  * The popover's notification center opened or closed — by the bell, a click outside, the center's own hide, or the
4
- * bell leaving the page while open. A host feeds it to its `NotificationHost`'s `centerOpen`, so the toast stack
5
- * hides while the popover lists the same cards: the center draws the running progress cards too.
12
+ * bell leaving the page while open; a bell whose host holds the state (`open`) asks for that change here and waits
13
+ * for `open`. A host feeds it to its `NotificationHost`'s `centerOpen`, so the toast stack hides while the popover
14
+ * lists the same cards: the center draws the running progress cards too.
6
15
  */
7
16
  readonly onOpenChange?: (open: boolean) => void;
8
17
  }
@@ -12,10 +21,13 @@ export interface StatusBarNotificationBellProps {
12
21
  * bell-off glyph while Do Not Disturb is on, hints at the progress that runs out of
13
22
  * sight, and toggles the familiar NotificationsCenter popover anchored above it. The
14
23
  * caller gates rendering (hidden on the SQL editor page, which already surfaces
15
- * notifications in the bottom dock).
24
+ * notifications in the bottom dock). A host that opens the center from its own code
25
+ * holds the popover's state (`open` with `onOpenChange`), as the kit's other popovers
26
+ * with a controlled state do (`DropdownMenu`, `Picker`).
16
27
  *
17
- * The hint reads this window's toasts: the bell registers its window for the right to
18
- * paint them (`DisplayOwner`), like the `NotificationHost` the window mounts, so it is
19
- * mounted under the root's `HostWindowProvider` too.
28
+ * The hint counts what the realm's stack keeps out of sight (`hiddenRunningProgress`),
29
+ * the definition an application's status-bar mirror of such a progress reads too, so
30
+ * the two never disagree. A card the stack shows is in sight wherever the user looks:
31
+ * the stack paints in the window that owns the display, the focused one.
20
32
  */
21
33
  export declare function StatusBarNotificationBell(props: StatusBarNotificationBellProps): import("solid-js").JSX.Element;
@@ -1,8 +1,17 @@
1
1
  export interface StatusBarNotificationBellProps {
2
+ /**
3
+ * Whether the popover's notification center is open, when the host holds that state — so the host's own code can
4
+ * open the center, as a status-bar entry of a progress that runs out of sight does (the reference's window progress
5
+ * entry runs `notifications.showList`, `workbench/services/progress/browser/progressService.ts:258-263`). The bell
6
+ * then shows what `open` says and asks for each change of its own through `onOpenChange`. Unset, the bell holds the
7
+ * state itself.
8
+ */
9
+ readonly open?: boolean | undefined;
2
10
  /**
3
11
  * The popover's notification center opened or closed — by the bell, a click outside, the center's own hide, or the
4
- * bell leaving the page while open. A host feeds it to its `NotificationHost`'s `centerOpen`, so the toast stack
5
- * hides while the popover lists the same cards: the center draws the running progress cards too.
12
+ * bell leaving the page while open; a bell whose host holds the state (`open`) asks for that change here and waits
13
+ * for `open`. A host feeds it to its `NotificationHost`'s `centerOpen`, so the toast stack hides while the popover
14
+ * lists the same cards: the center draws the running progress cards too.
6
15
  */
7
16
  readonly onOpenChange?: (open: boolean) => void;
8
17
  }
@@ -12,10 +21,13 @@ export interface StatusBarNotificationBellProps {
12
21
  * bell-off glyph while Do Not Disturb is on, hints at the progress that runs out of
13
22
  * sight, and toggles the familiar NotificationsCenter popover anchored above it. The
14
23
  * caller gates rendering (hidden on the SQL editor page, which already surfaces
15
- * notifications in the bottom dock).
24
+ * notifications in the bottom dock). A host that opens the center from its own code
25
+ * holds the popover's state (`open` with `onOpenChange`), as the kit's other popovers
26
+ * with a controlled state do (`DropdownMenu`, `Picker`).
16
27
  *
17
- * The hint reads this window's toasts: the bell registers its window for the right to
18
- * paint them (`DisplayOwner`), like the `NotificationHost` the window mounts, so it is
19
- * mounted under the root's `HostWindowProvider` too.
28
+ * The hint counts what the realm's stack keeps out of sight (`hiddenRunningProgress`),
29
+ * the definition an application's status-bar mirror of such a progress reads too, so
30
+ * the two never disagree. A card the stack shows is in sight wherever the user looks:
31
+ * the stack paints in the window that owns the display, the focused one.
20
32
  */
21
33
  export declare function StatusBarNotificationBell(props: StatusBarNotificationBellProps): import("solid-js").JSX.Element;
@@ -17,7 +17,8 @@ export interface DismissableToastCandidate {
17
17
  * the caller can send exactly those away through the stack's `dismiss(id)`.
18
18
  * A running progress among them is not closed: `dismiss` only takes it off the
19
19
  * stack and the notification center keeps it alive, as the reference's Escape
20
- * hides every toast and closes none (`notificationsToasts.ts:481-489`).
20
+ * hides every toast and closes none (`notificationsToasts.ts:481-489`) — and
21
+ * where no center is reachable, `dismiss` leaves it on the stack.
21
22
  *
22
23
  * Pure and input-immutable: it reads `items` and returns a fresh array.
23
24
  */
@@ -17,7 +17,8 @@ export interface DismissableToastCandidate {
17
17
  * the caller can send exactly those away through the stack's `dismiss(id)`.
18
18
  * A running progress among them is not closed: `dismiss` only takes it off the
19
19
  * stack and the notification center keeps it alive, as the reference's Escape
20
- * hides every toast and closes none (`notificationsToasts.ts:481-489`).
20
+ * hides every toast and closes none (`notificationsToasts.ts:481-489`) — and
21
+ * where no center is reachable, `dismiss` leaves it on the stack.
21
22
  *
22
23
  * Pure and input-immutable: it reads `items` and returns a fresh array.
23
24
  */
@@ -1 +1 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../StatusBarNotificationBell-CJ3HuhRu.cjs"),e=require("../mainRealmDom-S6teqEr4.cjs"),t=require("../useSettingsSubscription-DKjCwmRd.cjs");exports.ACCEPT_PRIMARY_ACTION_NOTIFICATION=i.ACCEPT_PRIMARY_ACTION_NOTIFICATION;exports.CLEAR_NOTIFICATION=i.CLEAR_NOTIFICATION;exports.HIDE_NOTIFICATION_TOASTS=i.HIDE_NOTIFICATION_TOASTS;exports.LogFilterBar=i.LogFilterBar;exports.NOTIFICATION_SOURCES=i.NOTIFICATION_SOURCES;exports.NOTIFICATION_SOURCE_IDS=i.NOTIFICATION_SOURCE_IDS;exports.NO_NOTIFICATION_OVERLAY=i.NO_NOTIFICATION_OVERLAY;exports.NotificationHost=i.NotificationHost;exports.NotificationItem=i.NotificationItem;exports.NotificationPanel=i.NotificationPanel;exports.NotificationService=i.NotificationService;exports.NotificationTimeline=i.NotificationTimeline;exports.NotificationsCenter=i.NotificationsCenter;exports.SEVERITY_ORDER=i.SEVERITY_ORDER;exports.SEVERITY_TONES=i.SEVERITY_TONES;exports.StatusBarNotificationBell=i.StatusBarNotificationBell;exports.appWindowNotificationOverlay=i.appWindowNotificationOverlay;exports.applyNotificationRules=i.applyNotificationRules;exports.clearCompiledRuleRegexCache=i.clearCompiledRuleRegexCache;exports.compileNotificationSearchMatcher=i.compileNotificationSearchMatcher;exports.createNativeNotificationEngine=i.createNativeNotificationEngine;exports.createNotificationPreviewRuntime=i.createNotificationPreviewRuntime;exports.decideFilter=i.decideFilter;exports.deleteWebhookUrl=i.deleteWebhookUrl;exports.deriveImplicitRemindKey=i.deriveImplicitRemindKey;exports.dismissKey=i.dismissKey;exports.dismissableToastIds=i.dismissableToastIds;exports.entryVendorMatch=i.entryVendorMatch;exports.exportTimelineAsCsv=i.exportTimelineAsCsv;exports.exportTimelineAsJson=i.exportTimelineAsJson;exports.filterNotificationTimeline=i.filterNotificationTimeline;exports.getSmtpPass=i.getSmtpPass;exports.getWebhookUrl=i.getWebhookUrl;exports.groupTimelineEntries=i.groupTimelineEntries;exports.isInQuietHours=i.isInQuietHours;exports.isKeyDismissed=i.isKeyDismissed;exports.isKeyRemindSuppressed=i.isKeyRemindSuppressed;exports.isNotificationSourceId=i.isNotificationSourceId;exports.isNotificationSticky=i.isNotificationSticky;exports.isOnToastStack=i.isOnToastStack;exports.isProgressRunning=i.isProgressRunning;exports.isSourceMuted=i.isSourceMuted;exports.isSpamDropHandle=i.isSpamDropHandle;exports.listNotificationSources=i.listNotificationSources;exports.nextQuietHoursStart=i.nextQuietHoursStart;exports.pruneOrphanWebhookSecrets=i.pruneOrphanWebhookSecrets;exports.registerFenceAliases=i.registerFenceAliases;exports.registerNotificationCommands=i.registerNotificationCommands;exports.remindLater=i.remindLater;exports.resolveCatalogPreviewPriority=i.resolveCatalogPreviewPriority;exports.resolveNotificationDuration=i.resolveNotificationDuration;exports.resolveNotificationSource=i.resolveNotificationSource;exports.resolveSeverityTone=i.resolveSeverityTone;exports.restoreAllKeys=i.restoreAllKeys;exports.restoreKey=i.restoreKey;exports.setSmtpPass=i.setSmtpPass;exports.setSourceMuted=i.setSourceMuted;exports.setWebhookUrl=i.setWebhookUrl;exports.shouldFireOsNative=i.shouldFireOsNative;exports.toTimelineActions=i.toTimelineActions;exports.unmuteAllSources=i.unmuteAllSources;exports.defineNotification=e.defineNotification;exports.defineNotificationScenario=e.defineNotificationScenario;exports.notificationSettings=t.notificationSettings;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../StatusBarNotificationBell-BJiORN4s.cjs"),e=require("../mainRealmDom-S6teqEr4.cjs"),t=require("../useSettingsSubscription-DKjCwmRd.cjs");exports.ACCEPT_PRIMARY_ACTION_NOTIFICATION=i.ACCEPT_PRIMARY_ACTION_NOTIFICATION;exports.CLEAR_NOTIFICATION=i.CLEAR_NOTIFICATION;exports.HIDE_NOTIFICATION_TOASTS=i.HIDE_NOTIFICATION_TOASTS;exports.LogFilterBar=i.LogFilterBar;exports.NOTIFICATION_SOURCES=i.NOTIFICATION_SOURCES;exports.NOTIFICATION_SOURCE_IDS=i.NOTIFICATION_SOURCE_IDS;exports.NO_NOTIFICATION_OVERLAY=i.NO_NOTIFICATION_OVERLAY;exports.NotificationHost=i.NotificationHost;exports.NotificationItem=i.NotificationItem;exports.NotificationPanel=i.NotificationPanel;exports.NotificationService=i.NotificationService;exports.NotificationTimeline=i.NotificationTimeline;exports.NotificationsCenter=i.NotificationsCenter;exports.SEVERITY_ORDER=i.SEVERITY_ORDER;exports.SEVERITY_TONES=i.SEVERITY_TONES;exports.StatusBarNotificationBell=i.StatusBarNotificationBell;exports.appWindowNotificationOverlay=i.appWindowNotificationOverlay;exports.applyNotificationRules=i.applyNotificationRules;exports.clearCompiledRuleRegexCache=i.clearCompiledRuleRegexCache;exports.compileNotificationSearchMatcher=i.compileNotificationSearchMatcher;exports.createNativeNotificationEngine=i.createNativeNotificationEngine;exports.createNotificationPreviewRuntime=i.createNotificationPreviewRuntime;exports.decideFilter=i.decideFilter;exports.deleteWebhookUrl=i.deleteWebhookUrl;exports.deriveImplicitRemindKey=i.deriveImplicitRemindKey;exports.dismissKey=i.dismissKey;exports.dismissableToastIds=i.dismissableToastIds;exports.entryVendorMatch=i.entryVendorMatch;exports.exportTimelineAsCsv=i.exportTimelineAsCsv;exports.exportTimelineAsJson=i.exportTimelineAsJson;exports.filterNotificationTimeline=i.filterNotificationTimeline;exports.getSmtpPass=i.getSmtpPass;exports.getWebhookUrl=i.getWebhookUrl;exports.groupTimelineEntries=i.groupTimelineEntries;exports.hiddenRunningProgress=i.hiddenRunningProgress;exports.isInQuietHours=i.isInQuietHours;exports.isKeyDismissed=i.isKeyDismissed;exports.isKeyRemindSuppressed=i.isKeyRemindSuppressed;exports.isNotificationSourceId=i.isNotificationSourceId;exports.isNotificationSticky=i.isNotificationSticky;exports.isOnToastStack=i.isOnToastStack;exports.isProgressRunning=i.isProgressRunning;exports.isSourceMuted=i.isSourceMuted;exports.isSpamDropHandle=i.isSpamDropHandle;exports.listNotificationSources=i.listNotificationSources;exports.nextQuietHoursStart=i.nextQuietHoursStart;exports.pruneOrphanWebhookSecrets=i.pruneOrphanWebhookSecrets;exports.registerFenceAliases=i.registerFenceAliases;exports.registerNotificationCommands=i.registerNotificationCommands;exports.remindLater=i.remindLater;exports.resolveCatalogPreviewPriority=i.resolveCatalogPreviewPriority;exports.resolveNotificationDuration=i.resolveNotificationDuration;exports.resolveNotificationSource=i.resolveNotificationSource;exports.resolveSeverityTone=i.resolveSeverityTone;exports.restoreAllKeys=i.restoreAllKeys;exports.restoreKey=i.restoreKey;exports.setSmtpPass=i.setSmtpPass;exports.setSourceMuted=i.setSourceMuted;exports.setWebhookUrl=i.setWebhookUrl;exports.shouldFireOsNative=i.shouldFireOsNative;exports.toTimelineActions=i.toTimelineActions;exports.unmuteAllSources=i.unmuteAllSources;exports.defineNotification=e.defineNotification;exports.defineNotificationScenario=e.defineNotificationScenario;exports.notificationSettings=t.notificationSettings;
@@ -1,9 +1,9 @@
1
- import { A as a, C as s, H as t, L as o, N as r, a as n, b as c, c as l, d as N, e as I, f as S, g as f, h as T, S as m, i as d, j as u, k as O, l as p, m as A, n as C, o as R, p as E, q as v, r as _, s as g, t as y, u as h, v as F, w as P, x, y as k, z as D, B as K, D as b, E as H, F as M, G as U, I as W, J as L, K as V, M as Y, O as w, P as B, Q, R as J, T as j, U as q, V as z, W as G, X, Y as Z, Z as $, _ as ii, $ as ei, a0 as ai, a1 as si, a2 as ti, a3 as oi, a4 as ri, a5 as ni, a6 as ci } from "../StatusBarNotificationBell-yryWdwyX.js";
2
- import { d as Ni, a as Ii } from "../mainRealmDom-C12lr9lm.js";
3
- import { n as fi } from "../useSettingsSubscription-DLEk4k4j.js";
1
+ import { A as s, C as a, H as t, L as o, N as r, a as n, b as c, c as l, d as N, e as I, f as S, g as f, h as T, S as d, i as m, j as u, k as O, l as p, m as A, n as C, o as R, p as g, q as E, r as v, s as _, t as y, u as h, v as F, w as P, x, y as k, z as D, B as K, D as b, E as H, F as M, G as U, I as W, J as L, K as V, M as Y, O as w, P as B, Q, R as J, T as j, U as q, V as z, W as G, X, Y as Z, Z as $, _ as ii, $ as ei, a0 as si, a1 as ai, a2 as ti, a3 as oi, a4 as ri, a5 as ni, a6 as ci, a7 as li } from "../StatusBarNotificationBell-7Izs_msz.js";
2
+ import { d as Ii, a as Si } from "../mainRealmDom-C12lr9lm.js";
3
+ import { n as Ti } from "../useSettingsSubscription-DLEk4k4j.js";
4
4
  export {
5
- a as ACCEPT_PRIMARY_ACTION_NOTIFICATION,
6
- s as CLEAR_NOTIFICATION,
5
+ s as ACCEPT_PRIMARY_ACTION_NOTIFICATION,
6
+ a as CLEAR_NOTIFICATION,
7
7
  t as HIDE_NOTIFICATION_TOASTS,
8
8
  o as LogFilterBar,
9
9
  r as NOTIFICATION_SOURCES,
@@ -15,20 +15,20 @@ export {
15
15
  S as NotificationService,
16
16
  f as NotificationTimeline,
17
17
  T as NotificationsCenter,
18
- m as SEVERITY_ORDER,
19
- d as SEVERITY_TONES,
18
+ d as SEVERITY_ORDER,
19
+ m as SEVERITY_TONES,
20
20
  u as StatusBarNotificationBell,
21
21
  O as appWindowNotificationOverlay,
22
22
  p as applyNotificationRules,
23
23
  A as clearCompiledRuleRegexCache,
24
24
  C as compileNotificationSearchMatcher,
25
25
  R as createNativeNotificationEngine,
26
- E as createNotificationPreviewRuntime,
27
- v as decideFilter,
28
- Ni as defineNotification,
29
- Ii as defineNotificationScenario,
30
- _ as deleteWebhookUrl,
31
- g as deriveImplicitRemindKey,
26
+ g as createNotificationPreviewRuntime,
27
+ E as decideFilter,
28
+ Ii as defineNotification,
29
+ Si as defineNotificationScenario,
30
+ v as deleteWebhookUrl,
31
+ _ as deriveImplicitRemindKey,
32
32
  y as dismissKey,
33
33
  h as dismissableToastIds,
34
34
  F as entryVendorMatch,
@@ -38,32 +38,33 @@ export {
38
38
  D as getSmtpPass,
39
39
  K as getWebhookUrl,
40
40
  b as groupTimelineEntries,
41
- H as isInQuietHours,
42
- M as isKeyDismissed,
43
- U as isKeyRemindSuppressed,
44
- W as isNotificationSourceId,
45
- L as isNotificationSticky,
46
- V as isOnToastStack,
47
- Y as isProgressRunning,
48
- w as isSourceMuted,
49
- B as isSpamDropHandle,
50
- Q as listNotificationSources,
51
- J as nextQuietHoursStart,
52
- fi as notificationSettings,
53
- j as pruneOrphanWebhookSecrets,
54
- q as registerFenceAliases,
55
- z as registerNotificationCommands,
56
- G as remindLater,
57
- X as resolveCatalogPreviewPriority,
58
- Z as resolveNotificationDuration,
59
- $ as resolveNotificationSource,
60
- ii as resolveSeverityTone,
61
- ei as restoreAllKeys,
41
+ H as hiddenRunningProgress,
42
+ M as isInQuietHours,
43
+ U as isKeyDismissed,
44
+ W as isKeyRemindSuppressed,
45
+ L as isNotificationSourceId,
46
+ V as isNotificationSticky,
47
+ Y as isOnToastStack,
48
+ w as isProgressRunning,
49
+ B as isSourceMuted,
50
+ Q as isSpamDropHandle,
51
+ J as listNotificationSources,
52
+ j as nextQuietHoursStart,
53
+ Ti as notificationSettings,
54
+ q as pruneOrphanWebhookSecrets,
55
+ z as registerFenceAliases,
56
+ G as registerNotificationCommands,
57
+ X as remindLater,
58
+ Z as resolveCatalogPreviewPriority,
59
+ $ as resolveNotificationDuration,
60
+ ii as resolveNotificationSource,
61
+ ei as resolveSeverityTone,
62
+ si as restoreAllKeys,
62
63
  ai as restoreKey,
63
- si as setSmtpPass,
64
- ti as setSourceMuted,
65
- oi as setWebhookUrl,
66
- ri as shouldFireOsNative,
67
- ni as toTimelineActions,
68
- ci as unmuteAllSources
64
+ ti as setSmtpPass,
65
+ oi as setSourceMuted,
66
+ ri as setWebhookUrl,
67
+ ni as shouldFireOsNative,
68
+ ci as toTimelineActions,
69
+ li as unmuteAllSources
69
70
  };
@@ -71,13 +71,24 @@ export interface NotificationItem extends NotificationInput {
71
71
  focused: boolean;
72
72
  /**
73
73
  * The card is off the toast stack while its progress runs — the user sent it away (Escape, the native overlay's
74
- * close), or a setting that silences it took it back or was on when it was issued. It lives on in
75
- * the notification center, its handles still `open`, until the progress ends (the card is back on the toast stack
76
- * with its outcome, newest, unless a silencing setting ends it then), an issue under its id is shown, or its program
77
- * closes it. Only a running card is ever hidden ({@link isProgressRunning}), and only a mounted center draws it
78
- * (`NotificationsCenter`, `NotificationPanel`): a window that mounts none has no way to the card until then.
74
+ * close) where a notification center is reachable, or a setting that silences it took it back or was on when it was
75
+ * issued. It lives on in the notification center, its handles still `open`, until the progress ends (the card is
76
+ * back on the toast stack with its outcome, newest, unless a silencing setting ends it then), an issue under its id is
77
+ * shown, or its program closes it. Only a running card is ever hidden ({@link isProgressRunning}), and only a mounted
78
+ * center draws it (`NotificationsCenter`, `NotificationPanel`). A realm that reaches none says so
79
+ * ({@link NativeNotificationEngineDependencies.centerReachable}): the user's close then leaves the card on the stack.
80
+ * A setting that silences it hides it all the same — the settings keep it off the screen, center or not —, so there
81
+ * it is out of reach until its progress ends.
79
82
  */
80
83
  hidden?: boolean;
84
+ /**
85
+ * Since when the card has been out of the user's sight on the toast stack, by the engine's clock: sent to the
86
+ * notification center ({@link hidden}), or pushed past the visible cap by newer toasts — the host paints the newest
87
+ * `maxVisibleNotifications` of the cards on the stack ({@link isOnToastStack}). A card keeps the moment it first left
88
+ * sight until the stack shows it again, which clears it. The stack records it — nothing else sets it —, the host
89
+ * paints the cards on the toast stack that have none, and {@link hiddenRunningProgress} orders by it.
90
+ */
91
+ outOfSightSince?: number;
81
92
  }
82
93
  export interface NotificationHandle {
83
94
  id: string;
@@ -116,6 +127,12 @@ export interface NativeNotificationEngineDependencies {
116
127
  * Unset, the user turns no card down.
117
128
  */
118
129
  readonly isTurnedDown?: (item: NotificationItem) => boolean;
130
+ /**
131
+ * Whether the user can reach a notification center in the realm now — where the user's close sends a running
132
+ * progress ({@link NativeNotificationEngine.dismiss}). Read at each such close: where none is reachable, the card
133
+ * stays on the toast stack. Unset, a center is reachable.
134
+ */
135
+ readonly centerReachable?: () => boolean;
119
136
  readonly now?: () => number;
120
137
  readonly setTimeout?: (callback: () => void, timeoutMs: number) => number;
121
138
  readonly clearTimeout?: (handle: number) => void;
@@ -135,11 +152,13 @@ export interface NativeNotificationEngine {
135
152
  * The user sends a card away — its close button, Escape, Delete, a gear-menu choice, the native overlay's close: the
136
153
  * card closes and its handles report `dismissed`. A card whose progress runs is not the user's to end
137
154
  * ({@link isProgressRunning}): it only leaves the toast stack and lives on in the notification center (`hidden`), its
138
- * handles still `open` — unless the user turned its notification down
139
- * ({@link NativeNotificationEngineDependencies.isTurnedDown}): the gear menu's "don't show again" and "remind me
140
- * later", on the stack's card or a center's copy, end it (`dismissed`), as the reference's "Don't Show Again" closes
141
- * its notification (`workbench/services/notification/common/notificationService.ts:207-217`) and a chosen button
142
- * expires a running progress (`notificationsViewer.ts:519-529`).
155
+ * handles still `open` — and where no center is reachable
156
+ * ({@link NativeNotificationEngineDependencies.centerReachable}) it stays where it is, since nothing could draw it
157
+ * there —, unless the user turned its notification down ({@link NativeNotificationEngineDependencies.isTurnedDown}):
158
+ * the gear menu's "don't show again" and "remind me later", on the stack's card or a center's copy, end it
159
+ * (`dismissed`), as the reference's "Don't Show Again" closes its notification
160
+ * (`workbench/services/notification/common/notificationService.ts:207-217`) and a chosen button expires a running
161
+ * progress (`notificationsViewer.ts:519-529`).
143
162
  */
144
163
  readonly dismiss: (id: string) => void;
145
164
  /**
@@ -158,6 +177,12 @@ export interface NativeNotificationEngine {
158
177
  * is answered, never taken away.
159
178
  */
160
179
  readonly reject: (id: string) => void;
180
+ /**
181
+ * The settings the engine reads changed: which cards the visible cap (`maxVisibleNotifications`) leaves out of sight
182
+ * is read again ({@link NotificationItem.outOfSightSince}), and the stack emits when that changed. The realm's
183
+ * notification service calls it on every change of the notification settings.
184
+ */
185
+ readonly refresh: () => void;
161
186
  readonly dispose: () => void;
162
187
  }
163
188
  /**
@@ -193,9 +218,10 @@ export declare function isNotificationSticky(item: Pick<NotificationItem, 'stick
193
218
  * Whether the card's progress runs — the operation behind it ends such a card, not the user and not a setting: it has
194
219
  * no close button, Delete leaves it, and Escape, any other close of the user's or a setting that silences it only
195
220
  * sends it to the notification center (reference `notificationsViewer.ts:492-495`, `notificationsCommands.ts:138-141`,
196
- * `notificationsToasts.ts:481-489` and `:143-153`). Only the user's turning its notification down ends it
197
- * ({@link NativeNotificationEngine.dismiss}). A developer preview's progress (`isolated`: the catalog's preview toast,
198
- * the preview runtime's cards) has no operation behind it and closes like any card.
221
+ * `notificationsToasts.ts:481-489` and `:143-153`) — the user's close leaves it where it is when no center is
222
+ * reachable. Only the user's turning its notification down ends it ({@link NativeNotificationEngine.dismiss}). A
223
+ * developer preview's progress (`isolated`: the catalog's preview toast, the preview runtime's cards) has no operation
224
+ * behind it and closes like any card.
199
225
  */
200
226
  export declare function isProgressRunning(item: Pick<NotificationItem, 'progress' | 'isolated'>): boolean;
201
227
  /**
@@ -203,6 +229,17 @@ export declare function isProgressRunning(item: Pick<NotificationItem, 'progress
203
229
  * the notification center. The host paints these cards, and the engine clips the same ones to the visible cap.
204
230
  */
205
231
  export declare function isOnToastStack(item: Pick<NotificationItem, 'priority' | 'hidden'>): boolean;
232
+ /**
233
+ * The running progress cards out of the user's sight on the toast stack — sent to the notification center
234
+ * ({@link NotificationItem.hidden}) or pushed past the visible cap by newer toasts —, the one that left sight last
235
+ * first ({@link NotificationItem.outOfSightSince}; of those that left at the same moment, the newest first). Pure:
236
+ * `items` is the stack as it emits them. It is the kit's one answer to "which progress runs out of sight": the status
237
+ * bar bell counts these cards, and an application that mirrors such a progress in its status bar shows the first. The
238
+ * reference does the same with a notification progress whose toast is not visible — hidden, or left out by the
239
+ * toasts' cap (`notificationsToasts.ts:675-676`, `:705`) —: it runs on as a window progress, and the window progress
240
+ * entry shows the last one hidden (`workbench/services/progress/browser/progressService.ts:339-357`, `:127`, `:147`).
241
+ */
242
+ export declare function hiddenRunningProgress(items: readonly NotificationItem[]): NotificationItem[];
206
243
  /**
207
244
  * Creates an in-memory engine — the notification service's toast stack, or a preview's isolated one.
208
245
  * There is no module engine: whoever shows toasts owns one.
@@ -71,13 +71,24 @@ export interface NotificationItem extends NotificationInput {
71
71
  focused: boolean;
72
72
  /**
73
73
  * The card is off the toast stack while its progress runs — the user sent it away (Escape, the native overlay's
74
- * close), or a setting that silences it took it back or was on when it was issued. It lives on in
75
- * the notification center, its handles still `open`, until the progress ends (the card is back on the toast stack
76
- * with its outcome, newest, unless a silencing setting ends it then), an issue under its id is shown, or its program
77
- * closes it. Only a running card is ever hidden ({@link isProgressRunning}), and only a mounted center draws it
78
- * (`NotificationsCenter`, `NotificationPanel`): a window that mounts none has no way to the card until then.
74
+ * close) where a notification center is reachable, or a setting that silences it took it back or was on when it was
75
+ * issued. It lives on in the notification center, its handles still `open`, until the progress ends (the card is
76
+ * back on the toast stack with its outcome, newest, unless a silencing setting ends it then), an issue under its id is
77
+ * shown, or its program closes it. Only a running card is ever hidden ({@link isProgressRunning}), and only a mounted
78
+ * center draws it (`NotificationsCenter`, `NotificationPanel`). A realm that reaches none says so
79
+ * ({@link NativeNotificationEngineDependencies.centerReachable}): the user's close then leaves the card on the stack.
80
+ * A setting that silences it hides it all the same — the settings keep it off the screen, center or not —, so there
81
+ * it is out of reach until its progress ends.
79
82
  */
80
83
  hidden?: boolean;
84
+ /**
85
+ * Since when the card has been out of the user's sight on the toast stack, by the engine's clock: sent to the
86
+ * notification center ({@link hidden}), or pushed past the visible cap by newer toasts — the host paints the newest
87
+ * `maxVisibleNotifications` of the cards on the stack ({@link isOnToastStack}). A card keeps the moment it first left
88
+ * sight until the stack shows it again, which clears it. The stack records it — nothing else sets it —, the host
89
+ * paints the cards on the toast stack that have none, and {@link hiddenRunningProgress} orders by it.
90
+ */
91
+ outOfSightSince?: number;
81
92
  }
82
93
  export interface NotificationHandle {
83
94
  id: string;
@@ -116,6 +127,12 @@ export interface NativeNotificationEngineDependencies {
116
127
  * Unset, the user turns no card down.
117
128
  */
118
129
  readonly isTurnedDown?: (item: NotificationItem) => boolean;
130
+ /**
131
+ * Whether the user can reach a notification center in the realm now — where the user's close sends a running
132
+ * progress ({@link NativeNotificationEngine.dismiss}). Read at each such close: where none is reachable, the card
133
+ * stays on the toast stack. Unset, a center is reachable.
134
+ */
135
+ readonly centerReachable?: () => boolean;
119
136
  readonly now?: () => number;
120
137
  readonly setTimeout?: (callback: () => void, timeoutMs: number) => number;
121
138
  readonly clearTimeout?: (handle: number) => void;
@@ -135,11 +152,13 @@ export interface NativeNotificationEngine {
135
152
  * The user sends a card away — its close button, Escape, Delete, a gear-menu choice, the native overlay's close: the
136
153
  * card closes and its handles report `dismissed`. A card whose progress runs is not the user's to end
137
154
  * ({@link isProgressRunning}): it only leaves the toast stack and lives on in the notification center (`hidden`), its
138
- * handles still `open` — unless the user turned its notification down
139
- * ({@link NativeNotificationEngineDependencies.isTurnedDown}): the gear menu's "don't show again" and "remind me
140
- * later", on the stack's card or a center's copy, end it (`dismissed`), as the reference's "Don't Show Again" closes
141
- * its notification (`workbench/services/notification/common/notificationService.ts:207-217`) and a chosen button
142
- * expires a running progress (`notificationsViewer.ts:519-529`).
155
+ * handles still `open` — and where no center is reachable
156
+ * ({@link NativeNotificationEngineDependencies.centerReachable}) it stays where it is, since nothing could draw it
157
+ * there —, unless the user turned its notification down ({@link NativeNotificationEngineDependencies.isTurnedDown}):
158
+ * the gear menu's "don't show again" and "remind me later", on the stack's card or a center's copy, end it
159
+ * (`dismissed`), as the reference's "Don't Show Again" closes its notification
160
+ * (`workbench/services/notification/common/notificationService.ts:207-217`) and a chosen button expires a running
161
+ * progress (`notificationsViewer.ts:519-529`).
143
162
  */
144
163
  readonly dismiss: (id: string) => void;
145
164
  /**
@@ -158,6 +177,12 @@ export interface NativeNotificationEngine {
158
177
  * is answered, never taken away.
159
178
  */
160
179
  readonly reject: (id: string) => void;
180
+ /**
181
+ * The settings the engine reads changed: which cards the visible cap (`maxVisibleNotifications`) leaves out of sight
182
+ * is read again ({@link NotificationItem.outOfSightSince}), and the stack emits when that changed. The realm's
183
+ * notification service calls it on every change of the notification settings.
184
+ */
185
+ readonly refresh: () => void;
161
186
  readonly dispose: () => void;
162
187
  }
163
188
  /**
@@ -193,9 +218,10 @@ export declare function isNotificationSticky(item: Pick<NotificationItem, 'stick
193
218
  * Whether the card's progress runs — the operation behind it ends such a card, not the user and not a setting: it has
194
219
  * no close button, Delete leaves it, and Escape, any other close of the user's or a setting that silences it only
195
220
  * sends it to the notification center (reference `notificationsViewer.ts:492-495`, `notificationsCommands.ts:138-141`,
196
- * `notificationsToasts.ts:481-489` and `:143-153`). Only the user's turning its notification down ends it
197
- * ({@link NativeNotificationEngine.dismiss}). A developer preview's progress (`isolated`: the catalog's preview toast,
198
- * the preview runtime's cards) has no operation behind it and closes like any card.
221
+ * `notificationsToasts.ts:481-489` and `:143-153`) — the user's close leaves it where it is when no center is
222
+ * reachable. Only the user's turning its notification down ends it ({@link NativeNotificationEngine.dismiss}). A
223
+ * developer preview's progress (`isolated`: the catalog's preview toast, the preview runtime's cards) has no operation
224
+ * behind it and closes like any card.
199
225
  */
200
226
  export declare function isProgressRunning(item: Pick<NotificationItem, 'progress' | 'isolated'>): boolean;
201
227
  /**
@@ -203,6 +229,17 @@ export declare function isProgressRunning(item: Pick<NotificationItem, 'progress
203
229
  * the notification center. The host paints these cards, and the engine clips the same ones to the visible cap.
204
230
  */
205
231
  export declare function isOnToastStack(item: Pick<NotificationItem, 'priority' | 'hidden'>): boolean;
232
+ /**
233
+ * The running progress cards out of the user's sight on the toast stack — sent to the notification center
234
+ * ({@link NotificationItem.hidden}) or pushed past the visible cap by newer toasts —, the one that left sight last
235
+ * first ({@link NotificationItem.outOfSightSince}; of those that left at the same moment, the newest first). Pure:
236
+ * `items` is the stack as it emits them. It is the kit's one answer to "which progress runs out of sight": the status
237
+ * bar bell counts these cards, and an application that mirrors such a progress in its status bar shows the first. The
238
+ * reference does the same with a notification progress whose toast is not visible — hidden, or left out by the
239
+ * toasts' cap (`notificationsToasts.ts:675-676`, `:705`) —: it runs on as a window progress, and the window progress
240
+ * entry shows the last one hidden (`workbench/services/progress/browser/progressService.ts:339-357`, `:127`, `:147`).
241
+ */
242
+ export declare function hiddenRunningProgress(items: readonly NotificationItem[]): NotificationItem[];
206
243
  /**
207
244
  * Creates an in-memory engine — the notification service's toast stack, or a preview's isolated one.
208
245
  * There is no module engine: whoever shows toasts owns one.
@@ -14,7 +14,8 @@ import type { NotificationItemController, NotificationItemShell } from './Notifi
14
14
  * notification settings, so a card's timer follows a change of the default duration at once. A card closes
15
15
  * through here only by the user's hand — its close button, a gear-menu choice, the native overlay's copy of
16
16
  * either — so it is the stack's `dismiss`: the card's handles report the user's close, and a running progress
17
- * only leaves the toast stack for the notification center, unless the gear menu's choice turned it down.
17
+ * only leaves the toast stack for the notification center (or stays, where none is reachable), unless the gear
18
+ * menu's choice turned it down.
18
19
  */
19
20
  export declare function realmCardController(host: KitHost, settings: Accessor<NotificationSettings>): NotificationItemController;
20
21
  /**
@@ -14,7 +14,8 @@ import type { NotificationItemController, NotificationItemShell } from './Notifi
14
14
  * notification settings, so a card's timer follows a change of the default duration at once. A card closes
15
15
  * through here only by the user's hand — its close button, a gear-menu choice, the native overlay's copy of
16
16
  * either — so it is the stack's `dismiss`: the card's handles report the user's close, and a running progress
17
- * only leaves the toast stack for the notification center, unless the gear menu's choice turned it down.
17
+ * only leaves the toast stack for the notification center (or stays, where none is reachable), unless the gear
18
+ * menu's choice turned it down.
18
19
  */
19
20
  export declare function realmCardController(host: KitHost, settings: Accessor<NotificationSettings>): NotificationItemController;
20
21
  /**
@@ -15,7 +15,7 @@ export declare const ACCEPT_PRIMARY_ACTION_NOTIFICATION = "notification.acceptPr
15
15
  export declare const CLEAR_NOTIFICATION = "notification.clear";
16
16
  /**
17
17
  * Hide the dismissable toasts — `Escape` while toasts are visible. A running progress is not closed: it goes to the
18
- * notification center.
18
+ * notification center, or stays on the stack where none is reachable.
19
19
  */
20
20
  export declare const HIDE_NOTIFICATION_TOASTS = "notifications.hideToasts";
21
21
  export interface NotificationCommandRegistries {
@@ -30,8 +30,8 @@ export interface NotificationCommandDeps {
30
30
  */
31
31
  readonly clearFocused: () => void;
32
32
  /**
33
- * Send every dismissable toast away — a running progress to the notification center, alive; acknowledgement-required
34
- * ones stay (#875).
33
+ * Send every dismissable toast away — a running progress to the notification center, alive, or nowhere where no
34
+ * center is reachable; acknowledgement-required ones stay (#875).
35
35
  */
36
36
  readonly hideToasts: () => void;
37
37
  }
@@ -15,7 +15,7 @@ export declare const ACCEPT_PRIMARY_ACTION_NOTIFICATION = "notification.acceptPr
15
15
  export declare const CLEAR_NOTIFICATION = "notification.clear";
16
16
  /**
17
17
  * Hide the dismissable toasts — `Escape` while toasts are visible. A running progress is not closed: it goes to the
18
- * notification center.
18
+ * notification center, or stays on the stack where none is reachable.
19
19
  */
20
20
  export declare const HIDE_NOTIFICATION_TOASTS = "notifications.hideToasts";
21
21
  export interface NotificationCommandRegistries {
@@ -30,8 +30,8 @@ export interface NotificationCommandDeps {
30
30
  */
31
31
  readonly clearFocused: () => void;
32
32
  /**
33
- * Send every dismissable toast away — a running progress to the notification center, alive; acknowledgement-required
34
- * ones stay (#875).
33
+ * Send every dismissable toast away — a running progress to the notification center, alive, or nowhere where no
34
+ * center is reachable; acknowledgement-required ones stay (#875).
35
35
  */
36
36
  readonly hideToasts: () => void;
37
37
  }
@@ -23,7 +23,7 @@ import { NotificationTimeline } from './notificationTimeline.cjs';
23
23
  import { type SourceStats } from './notificationAnalytics.cjs';
24
24
  import { type DigestFlushResult, type DigestNotSentReason, type EmailDigestMessage } from './emailDigest.cjs';
25
25
  import { type Toast } from './toast.cjs';
26
- /** The host's infrastructure the notification service works with. */
26
+ /** The host's infrastructure the notification service works with, and whether its notification center is in reach. */
27
27
  export interface NotificationServiceDependencies {
28
28
  readonly desktop: DesktopBridge;
29
29
  /** Holds the digest's SMTP password and the webhook URLs. */
@@ -35,6 +35,15 @@ export interface NotificationServiceDependencies {
35
35
  readonly errorPresenter: HostErrorPresenter;
36
36
  readonly vendorErrors: VendorErrorSource;
37
37
  readonly log: ILogger;
38
+ /**
39
+ * Whether the user can reach a notification center in the realm now — one the application shows, or a way to one
40
+ * (a status bar bell, a dock). The user's close of a running progress (Escape, the native overlay's close) sends the
41
+ * card to the center, its progress running on; where no center is reachable — an entry window, a page that shows
42
+ * neither a center nor a way to one — nothing could draw it there, so the card stays on the toast stack instead.
43
+ * Turning its notification down on the card still ends it, a finished card closes as always, and a setting that
44
+ * silences a running progress still keeps it off the screen. Read at each such close. Unset, a center is reachable.
45
+ */
46
+ readonly centerReachable?: () => boolean;
38
47
  }
39
48
  /** The realm's notifications. */
40
49
  export interface Notifications {
@@ -23,7 +23,7 @@ import { NotificationTimeline } from './notificationTimeline.js';
23
23
  import { type SourceStats } from './notificationAnalytics.js';
24
24
  import { type DigestFlushResult, type DigestNotSentReason, type EmailDigestMessage } from './emailDigest.js';
25
25
  import { type Toast } from './toast.js';
26
- /** The host's infrastructure the notification service works with. */
26
+ /** The host's infrastructure the notification service works with, and whether its notification center is in reach. */
27
27
  export interface NotificationServiceDependencies {
28
28
  readonly desktop: DesktopBridge;
29
29
  /** Holds the digest's SMTP password and the webhook URLs. */
@@ -35,6 +35,15 @@ export interface NotificationServiceDependencies {
35
35
  readonly errorPresenter: HostErrorPresenter;
36
36
  readonly vendorErrors: VendorErrorSource;
37
37
  readonly log: ILogger;
38
+ /**
39
+ * Whether the user can reach a notification center in the realm now — one the application shows, or a way to one
40
+ * (a status bar bell, a dock). The user's close of a running progress (Escape, the native overlay's close) sends the
41
+ * card to the center, its progress running on; where no center is reachable — an entry window, a page that shows
42
+ * neither a center nor a way to one — nothing could draw it there, so the card stays on the toast stack instead.
43
+ * Turning its notification down on the card still ends it, a finished card closes as always, and a setting that
44
+ * silences a running progress still keeps it off the screen. Read at each such close. Unset, a center is reachable.
45
+ */
46
+ readonly centerReachable?: () => boolean;
38
47
  }
39
48
  /** The realm's notifications. */
40
49
  export interface Notifications {