@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.
- package/CHANGELOG.md +10 -0
- package/README.md +21 -4
- package/dist/{StatusBarNotificationBell-yryWdwyX.js → StatusBarNotificationBell-7Izs_msz.js} +4083 -4058
- package/dist/StatusBarNotificationBell-BJiORN4s.cjs +50 -0
- package/dist/_internal/contract/notification.d.cts +4 -3
- package/dist/_internal/contract/notification.d.ts +4 -3
- package/dist/index.cjs +1 -1
- package/dist/index.js +153 -152
- package/dist/notifications/NotificationItem.d.cts +3 -3
- package/dist/notifications/NotificationItem.d.ts +3 -3
- package/dist/notifications/StatusBarNotificationBell.d.cts +18 -6
- package/dist/notifications/StatusBarNotificationBell.d.ts +18 -6
- package/dist/notifications/dismissableToastIds.d.cts +2 -1
- package/dist/notifications/dismissableToastIds.d.ts +2 -1
- package/dist/notifications/index.cjs +1 -1
- package/dist/notifications/index.js +41 -40
- package/dist/notifications/nativeEngine.d.cts +50 -13
- package/dist/notifications/nativeEngine.d.ts +50 -13
- package/dist/notifications/notificationCardServices.d.cts +2 -1
- package/dist/notifications/notificationCardServices.d.ts +2 -1
- package/dist/notifications/notificationCommands.d.cts +3 -3
- package/dist/notifications/notificationCommands.d.ts +3 -3
- package/dist/notifications/notificationService.d.cts +10 -1
- package/dist/notifications/notificationService.d.ts +10 -1
- package/dist/server/{StatusBarNotificationBell-DdAdsduo.js → StatusBarNotificationBell-D8Jt3PXI.js} +3885 -3860
- package/dist/server/StatusBarNotificationBell-LJHLMT9F.cjs +49 -0
- package/dist/server/index.cjs +1 -1
- package/dist/server/index.js +138 -137
- package/dist/server/notifications/index.cjs +1 -1
- package/dist/server/notifications/index.js +41 -40
- package/dist/solid/notifications/NotificationHost.jsx +1 -11
- package/dist/solid/notifications/StatusBarNotificationBell.jsx +14 -17
- package/dist/solid/notifications/nativeEngine.js +51 -11
- package/dist/solid/notifications/notificationService.js +2 -0
- package/dist/style.css +1 -1
- package/dist/ui.css +1 -1
- package/package.json +1 -1
- package/dist/StatusBarNotificationBell-CJ3HuhRu.cjs +0 -50
- 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
|
|
18
|
-
* ends it. A controller over another stack — a native overlay's bridge, a preview
|
|
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
|
|
18
|
-
* ends it. A controller over another stack — a native overlay's bridge, a preview
|
|
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
|
|
5
|
-
*
|
|
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
|
|
18
|
-
*
|
|
19
|
-
*
|
|
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
|
|
5
|
-
*
|
|
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
|
|
18
|
-
*
|
|
19
|
-
*
|
|
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-
|
|
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
|
|
2
|
-
import { d as
|
|
3
|
-
import { n as
|
|
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
|
-
|
|
6
|
-
|
|
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
|
-
|
|
19
|
-
|
|
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
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
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
|
|
42
|
-
M as
|
|
43
|
-
U as
|
|
44
|
-
W as
|
|
45
|
-
L as
|
|
46
|
-
V as
|
|
47
|
-
Y as
|
|
48
|
-
w as
|
|
49
|
-
B as
|
|
50
|
-
Q as
|
|
51
|
-
J as
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
q as
|
|
55
|
-
z as
|
|
56
|
-
G as
|
|
57
|
-
X as
|
|
58
|
-
Z as
|
|
59
|
-
$ as
|
|
60
|
-
ii as
|
|
61
|
-
ei as
|
|
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
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
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
|
|
75
|
-
* the notification center, its handles still `open`, until the progress ends (the card is
|
|
76
|
-
* with its outcome, newest, unless a silencing setting ends it then), an issue under its id is
|
|
77
|
-
* closes it. Only a running card is ever hidden ({@link isProgressRunning}), and only a mounted
|
|
78
|
-
* (`NotificationsCenter`, `NotificationPanel`)
|
|
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` —
|
|
139
|
-
* ({@link NativeNotificationEngineDependencies.
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
*
|
|
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`)
|
|
197
|
-
* ({@link NativeNotificationEngine.dismiss}). A
|
|
198
|
-
* the preview runtime's cards) has no operation
|
|
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
|
|
75
|
-
* the notification center, its handles still `open`, until the progress ends (the card is
|
|
76
|
-
* with its outcome, newest, unless a silencing setting ends it then), an issue under its id is
|
|
77
|
-
* closes it. Only a running card is ever hidden ({@link isProgressRunning}), and only a mounted
|
|
78
|
-
* (`NotificationsCenter`, `NotificationPanel`)
|
|
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` —
|
|
139
|
-
* ({@link NativeNotificationEngineDependencies.
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
*
|
|
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`)
|
|
197
|
-
* ({@link NativeNotificationEngine.dismiss}). A
|
|
198
|
-
* the preview runtime's cards) has no operation
|
|
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,
|
|
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,
|
|
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
|
|
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
|
|
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 {
|