@vokril/ui-solid 0.29.0 → 0.31.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 +71 -0
- package/README.md +27 -0
- package/dist/{AttributeGrid-eND8YDby.cjs → AttributeGrid-Ch1k9v5j.cjs} +1 -1
- package/dist/{AttributeGrid-CASILa4u.js → AttributeGrid-DqFd4gBm.js} +3 -3
- package/dist/Button-4meERfnv.js +300 -0
- package/dist/Button-OyZHrl-t.cjs +1 -0
- package/dist/CommandPalette-CxYZUJtN.cjs +2 -0
- package/dist/{CommandPalette-Cj618AOz.js → CommandPalette-DwOp8y1-.js} +1467 -1466
- package/dist/{CopyButton-B5gS2ft3.cjs → CopyButton-16QNPgz6.cjs} +1 -1
- package/dist/{CopyButton-g-WSiBDZ.js → CopyButton-BVS49lMS.js} +1 -1
- package/dist/{DateRangePicker-CJD9ADgB.js → DateRangePicker-8QvydugY.js} +4 -4
- package/dist/{DateRangePicker-Frc0HVxp.cjs → DateRangePicker-DI-06xWY.cjs} +1 -1
- package/dist/{GuidedTour-B6q7lYhn.cjs → GuidedTour-DUQwdW8n.cjs} +1 -1
- package/dist/{GuidedTour-CFCvRJN4.js → GuidedTour-DXMmHn0o.js} +2 -2
- package/dist/{HostPortal-CXGUUhP8.js → HostPortal-Ba3MD9CG.js} +1 -1
- package/dist/HostPortal-CpWsArs6.cjs +1 -0
- package/dist/{IconPicker-DYqNi5ud.js → IconPicker-D1G8HK92.js} +3 -3
- package/dist/{IconPicker-CIbJb1ei.cjs → IconPicker-Q-ZDtNkd.cjs} +1 -1
- package/dist/Input-Brp5EDhg.cjs +1 -0
- package/dist/Input-CZi8KEfm.js +374 -0
- package/dist/Modal-CBi7Wd2V.cjs +1 -0
- package/dist/Modal-iyY1HUtr.js +588 -0
- package/dist/{PageSkeleton-BPbb28-H.cjs → PageSkeleton-B_-4fz1q.cjs} +1 -1
- package/dist/{PageSkeleton-CLnJO6uD.js → PageSkeleton-zNyjLPlk.js} +3 -3
- package/dist/{Popover-Cttb6NYT.js → Popover-DVi179wu.js} +4 -3
- package/dist/Popover-DXrczbt9.cjs +1 -0
- package/dist/{SearchableSelect-BvCm4enQ.js → SearchableSelect-DtHbWJhR.js} +34 -33
- package/dist/SearchableSelect-yLVqCGFo.cjs +1 -0
- package/dist/StatusBarNotificationBell-DQs5g1K6.cjs +50 -0
- package/dist/{StatusBarNotificationBell-7Izs_msz.js → StatusBarNotificationBell-ZTEhZFmJ.js} +4279 -4002
- package/dist/{Stepper-D9i1Xclm.js → Stepper-CyRgzWlR.js} +1 -1
- package/dist/{Stepper-Ci5JpLbS.cjs → Stepper-u2ZsE5oP.cjs} +1 -1
- package/dist/{Textarea-CeAGf08O.cjs → Textarea-DASNQNoi.cjs} +1 -1
- package/dist/{Textarea-B5QqqKnI.js → Textarea-szHXQahi.js} +1 -1
- package/dist/{TimeSeriesChart-DOwi2lJs.js → TimeSeriesChart-D7lIqolp.js} +1 -1
- package/dist/{TimeSeriesChart-huvheefm.cjs → TimeSeriesChart-DGzM9B--.cjs} +1 -1
- package/dist/{ToggleButton-CFM8P3JY.js → ToggleButton-B22PsCqo.js} +61 -60
- package/dist/ToggleButton-DWslrIBN.cjs +1 -0
- package/dist/_internal/contract/notification.d.cts +9 -0
- package/dist/_internal/contract/notification.d.ts +9 -0
- package/dist/_internal/contract/notificationCatalog.d.cts +2 -0
- package/dist/_internal/contract/notificationCatalog.d.ts +2 -0
- package/dist/_internal/platform/settings/settingsTypes.d.cts +0 -8
- package/dist/_internal/platform/settings/settingsTypes.d.ts +0 -8
- package/dist/anchoredLayout-CBjQ1etD.cjs +1 -0
- package/dist/anchoredLayout-E0mqCWxk.js +233 -0
- package/dist/appThemeDerivation-BylmT80v.cjs +1 -0
- package/dist/{appThemeDerivation-CKoSe4KP.js → appThemeDerivation-DBAOkGl7.js} +260 -231
- package/dist/base.css +2 -2
- package/dist/charts/index.cjs +1 -1
- package/dist/charts/index.js +1 -1
- package/dist/context/DesktopContextMenuContext.d.cts +8 -1
- package/dist/context/DesktopContextMenuContext.d.ts +8 -1
- package/dist/createDialogShellFocus-CQ0VNC2g.cjs +1 -0
- package/dist/{createDialogShellFocus-B4piXDU4.js → createDialogShellFocus-DbiQmLgb.js} +9 -9
- package/dist/createResizableSidebar-COlpGQ7H.cjs +1 -0
- package/dist/createResizableSidebar-cmCKTIg_.js +504 -0
- package/dist/desktop/index.cjs +1 -1
- package/dist/desktop/index.js +3 -3
- package/dist/dialogFocusRestore-BhxVTSiP.js +10 -0
- package/dist/dialogFocusRestore-DP5b1bDo.cjs +1 -0
- package/dist/feedback/index.cjs +1 -1
- package/dist/feedback/index.js +3 -3
- package/dist/forms/Input.d.cts +20 -0
- package/dist/forms/Input.d.ts +20 -0
- package/dist/forms/InputMessage.d.cts +19 -0
- package/dist/forms/InputMessage.d.ts +19 -0
- package/dist/forms/index.cjs +1 -1
- package/dist/forms/index.js +9 -9
- package/dist/grid/index.cjs +1 -1
- package/dist/grid/index.js +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.js +547 -541
- package/dist/layout/index.cjs +1 -1
- package/dist/layout/index.js +2 -2
- package/dist/layout/resizeCarry.d.cts +17 -0
- package/dist/layout/resizeCarry.d.ts +17 -0
- package/dist/mainRealmDom-B215swW-.js +166 -0
- package/dist/mainRealmDom-BYGSE-fo.cjs +1 -0
- package/dist/nativeTitleHold-A9jUISgQ.js +170 -0
- package/dist/nativeTitleHold-B7Ou-W9b.cjs +1 -0
- package/dist/navigation/index.cjs +1 -1
- package/dist/navigation/index.js +1 -1
- package/dist/notifications/NotificationItem.d.cts +9 -0
- package/dist/notifications/NotificationItem.d.ts +9 -0
- package/dist/notifications/NotificationsCenter.d.cts +18 -0
- package/dist/notifications/NotificationsCenter.d.ts +18 -0
- package/dist/notifications/RunningProgressCards.d.cts +3 -0
- package/dist/notifications/RunningProgressCards.d.ts +3 -0
- package/dist/notifications/fireNotification.d.cts +35 -16
- package/dist/notifications/fireNotification.d.ts +35 -16
- package/dist/notifications/index.cjs +1 -1
- package/dist/notifications/index.d.cts +1 -0
- package/dist/notifications/index.d.ts +1 -0
- package/dist/notifications/index.js +55 -52
- package/dist/notifications/nativeEngine.d.cts +4 -3
- package/dist/notifications/nativeEngine.d.ts +4 -3
- package/dist/notifications/notificationEntryList.d.cts +91 -0
- package/dist/notifications/notificationEntryList.d.ts +91 -0
- package/dist/notifications/notificationService.d.cts +23 -2
- package/dist/notifications/notificationService.d.ts +23 -2
- package/dist/notifications/toast.d.cts +3 -0
- package/dist/notifications/toast.d.ts +3 -0
- package/dist/notifications/toastCorner.d.cts +8 -0
- package/dist/notifications/toastCorner.d.ts +8 -0
- package/dist/notifications/toastFilterPolicy.d.cts +33 -1
- package/dist/notifications/toastFilterPolicy.d.ts +33 -1
- package/dist/overlay/Modal.d.cts +6 -0
- package/dist/overlay/Modal.d.ts +6 -0
- package/dist/overlay/backgroundInert.d.cts +6 -2
- package/dist/overlay/backgroundInert.d.ts +6 -2
- package/dist/overlay/command-palette/CommandPalette.d.cts +12 -0
- package/dist/overlay/command-palette/CommandPalette.d.ts +12 -0
- package/dist/overlay/index.cjs +1 -1
- package/dist/overlay/index.js +70 -68
- package/dist/overlay/nativeTitleHold.d.cts +24 -0
- package/dist/overlay/nativeTitleHold.d.ts +24 -0
- package/dist/ownerAnimationFrame-DzFcMSmn.js +19 -0
- package/dist/ownerAnimationFrame-T6jf6qYC.cjs +1 -0
- package/dist/server/{AttributeGrid-CMi-UtWb.js → AttributeGrid-Bpjlauuz.js} +2 -2
- package/dist/server/{AttributeGrid-B7sb3btp.cjs → AttributeGrid-DNYdKb8J.cjs} +1 -1
- package/dist/server/CommandPalette-BuVxnqBG.cjs +1 -0
- package/dist/server/{CommandPalette-CozogFlk.js → CommandPalette-Dn3NKXPM.js} +1095 -1069
- package/dist/server/{DateRangePicker-KLZzyuPJ.cjs → DateRangePicker-BFzNjaME.cjs} +1 -1
- package/dist/server/{DateRangePicker-C35q8BTw.js → DateRangePicker-CnYkTgXX.js} +3 -3
- package/dist/server/{GuidedTour-DmLbBttx.js → GuidedTour-BZardPYW.js} +1 -1
- package/dist/server/{GuidedTour-DfV0yzqh.cjs → GuidedTour-yhdZk2SU.cjs} +1 -1
- package/dist/server/{HostPortal-CXGUUhP8.js → HostPortal-C4IrAeWN.js} +1 -1
- package/dist/server/HostPortal-D5ECrJvn.cjs +1 -0
- package/dist/server/{IconPicker-B1soopAp.cjs → IconPicker-C5lAN9pX.cjs} +1 -1
- package/dist/server/{IconPicker-B4aXspLw.js → IconPicker-DDWgB7sm.js} +3 -3
- package/dist/server/Input-AdF-i0O8.js +245 -0
- package/dist/server/Input-XF9Jr0G9.cjs +1 -0
- package/dist/server/{Modal-BheFQLs1.js → Modal-C5dzgcRW.js} +102 -97
- package/dist/server/{Modal-BswxV8Pn.cjs → Modal-nAhBS1L9.cjs} +1 -1
- package/dist/server/Popover-C5avmGWz.cjs +1 -0
- package/dist/server/{Popover-Cg28aPUZ.js → Popover-H3AAYZI0.js} +57 -57
- package/dist/server/{SearchableSelect-09ECcDlB.cjs → SearchableSelect-CZrXDKfC.cjs} +1 -1
- package/dist/server/{SearchableSelect-vjhS4c-H.js → SearchableSelect-DMqed5Er.js} +1 -1
- package/dist/server/StatusBarNotificationBell-CGcMdT4h.cjs +49 -0
- package/dist/server/{StatusBarNotificationBell-D8Jt3PXI.js → StatusBarNotificationBell-DW2l5O9B.js} +4216 -3949
- package/dist/server/{Stepper-DxNrskdq.cjs → Stepper-CpapA_WH.cjs} +1 -1
- package/dist/server/{Stepper-n5f9r-ye.js → Stepper-gGA7JwjV.js} +1 -1
- package/dist/server/{Textarea-BQf2lL59.cjs → Textarea-Bh5LVrBn.cjs} +1 -1
- package/dist/server/{Textarea-BTH48NET.js → Textarea-DVkfGkP0.js} +1 -1
- package/dist/server/{ToggleButton-TE3Xf2yD.cjs → ToggleButton-CA9T-OsI.cjs} +1 -1
- package/dist/server/{ToggleButton-FywO2CCI.js → ToggleButton-CBNKajZa.js} +4 -4
- package/dist/server/{VpTrash-Dlq8o6Uv.js → VpTrash-CZMWCIpF.js} +84 -70
- package/dist/server/VpTrash-DiczWhwm.cjs +1 -0
- package/dist/server/appThemeDerivation-BylmT80v.cjs +1 -0
- package/dist/server/{appThemeDerivation-CKoSe4KP.js → appThemeDerivation-DBAOkGl7.js} +260 -231
- package/dist/server/{createDialogShellFocus-BiBAZOCI.cjs → createDialogShellFocus-CDaLuPg8.cjs} +1 -1
- package/dist/server/{createDialogShellFocus-BFo8awdj.js → createDialogShellFocus-LGDBOVnr.js} +6 -6
- package/dist/server/{createResizableSidebar-BImbKlLe.js → createResizableSidebar-Dvu7iEk1.js} +1 -1
- package/dist/server/{createResizableSidebar-GFgZIj-5.cjs → createResizableSidebar-v40ZOb-Q.cjs} +1 -1
- package/dist/server/desktop/index.cjs +1 -1
- package/dist/server/desktop/index.js +3 -3
- package/dist/server/dialogFocusRestore-BhxVTSiP.js +10 -0
- package/dist/server/dialogFocusRestore-DP5b1bDo.cjs +1 -0
- package/dist/server/forms/index.cjs +1 -1
- package/dist/server/forms/index.js +7 -7
- package/dist/server/grid/index.cjs +1 -1
- package/dist/server/grid/index.js +1 -1
- package/dist/server/{index-UIjsx3oJ.js → index-BEARfm54.js} +3604 -3617
- package/dist/server/index-C6rYfWCJ.cjs +1 -0
- package/dist/server/index.cjs +1 -1
- package/dist/server/index.js +502 -497
- package/dist/server/layout/index.cjs +1 -1
- package/dist/server/layout/index.js +2 -2
- package/dist/server/navigation/index.cjs +1 -1
- package/dist/server/navigation/index.js +1 -1
- package/dist/server/notifications/index.cjs +1 -1
- package/dist/server/notifications/index.js +55 -52
- package/dist/server/overlay/index.cjs +1 -1
- package/dist/server/overlay/index.js +54 -53
- package/dist/server/tokens/index.cjs +1 -1
- package/dist/server/tokens/index.js +30 -28
- package/dist/solid/feedback/Badge.jsx +3 -14
- package/dist/solid/forms/Button.jsx +3 -14
- package/dist/solid/forms/Input.jsx +31 -5
- package/dist/solid/forms/Input.module.css.js +1 -0
- package/dist/solid/forms/InputMessage.jsx +86 -0
- package/dist/solid/forms/PressableSurface.jsx +3 -14
- package/dist/solid/layout/ResizeHandle.jsx +11 -1
- package/dist/solid/layout/resizeCarry.js +31 -0
- package/dist/solid/notifications/NotificationHost.jsx +5 -18
- package/dist/solid/notifications/NotificationItem.jsx +5 -5
- package/dist/solid/notifications/NotificationPanel.jsx +14 -4
- package/dist/solid/notifications/NotificationsCenter.jsx +70 -12
- package/dist/solid/notifications/RunningProgressCards.jsx +1 -1
- package/dist/solid/notifications/StatusBarNotificationBell.jsx +8 -3
- package/dist/solid/notifications/catalogAdapter.js +1 -0
- package/dist/solid/notifications/fireNotification.js +21 -16
- package/dist/solid/notifications/index.js +1 -0
- package/dist/solid/notifications/notificationEntryList.js +168 -0
- package/dist/solid/notifications/notificationService.js +20 -4
- package/dist/solid/notifications/toast.js +54 -7
- package/dist/solid/notifications/toastCorner.js +3 -0
- package/dist/solid/notifications/toastFilterPolicy.js +12 -0
- package/dist/solid/overlay/Drawer.jsx +2 -1
- package/dist/solid/overlay/Modal.jsx +42 -4
- package/dist/solid/overlay/command-palette/CommandPalette.jsx +4 -4
- package/dist/solid/overlay/context-menu/DesktopContextMenu.jsx +8 -7
- package/dist/solid/overlay/nativeTitleHold.js +33 -0
- package/dist/solid/overlay/tooltipDirective.js +3 -11
- package/dist/solid/tokens/index.js +1 -0
- package/dist/solid/tokens/palette/paletteContract.js +27 -0
- package/dist/style.css +2 -2
- package/dist/theme.css +1 -1
- package/dist/tokens/index.cjs +1 -1
- package/dist/tokens/index.d.cts +1 -0
- package/dist/tokens/index.d.ts +1 -0
- package/dist/tokens/index.js +30 -28
- package/dist/tokens/palette/paletteContract.d.cts +17 -0
- package/dist/tokens/palette/paletteContract.d.ts +17 -0
- package/dist/tokens/tokens.css +1 -1
- package/dist/ui.css +1 -1
- package/package.json +1 -1
- package/dist/Button-Bb68ymNP.cjs +0 -1
- package/dist/Button-D-T0tyGF.js +0 -305
- package/dist/CommandPalette-5FQRgPG9.cjs +0 -2
- package/dist/HostPortal-CgJwxt-f.cjs +0 -1
- package/dist/Input-CZruORyy.cjs +0 -1
- package/dist/Input-DkPhsdfk.js +0 -227
- package/dist/Modal-CY6ePolt.cjs +0 -1
- package/dist/Modal-NzZzHSwb.js +0 -559
- package/dist/Popover-CWrR51eG.cjs +0 -1
- package/dist/SearchableSelect-CVqdVMOC.cjs +0 -1
- package/dist/StatusBarNotificationBell-BJiORN4s.cjs +0 -50
- package/dist/ToggleButton-BFWh1_o5.cjs +0 -1
- package/dist/anchoredLayout-Dstwa5OH.cjs +0 -1
- package/dist/anchoredLayout-FC-qv8xm.js +0 -250
- package/dist/appThemeDerivation-Be_oKljl.cjs +0 -1
- package/dist/createDialogShellFocus-CJaw9-B9.cjs +0 -1
- package/dist/createResizableSidebar-BDUlX9-G.js +0 -472
- package/dist/createResizableSidebar-BVJBU2kP.cjs +0 -1
- package/dist/dialogFocusRestore--dH59ER2.js +0 -35
- package/dist/dialogFocusRestore-CL-ExfAA.cjs +0 -1
- package/dist/mainRealmDom-C12lr9lm.js +0 -171
- package/dist/mainRealmDom-S6teqEr4.cjs +0 -1
- package/dist/server/CommandPalette-DQK6N98N.cjs +0 -1
- package/dist/server/HostPortal-CgJwxt-f.cjs +0 -1
- package/dist/server/Input-CjvD8w18.cjs +0 -1
- package/dist/server/Input-DaEN2JJd.js +0 -127
- package/dist/server/Popover-BsxIKBbl.cjs +0 -1
- package/dist/server/StatusBarNotificationBell-LJHLMT9F.cjs +0 -49
- package/dist/server/VpTrash-D49oUUJh.cjs +0 -1
- package/dist/server/appThemeDerivation-Be_oKljl.cjs +0 -1
- package/dist/server/dialogFocusRestore--dH59ER2.js +0 -35
- package/dist/server/dialogFocusRestore-CL-ExfAA.cjs +0 -1
- package/dist/server/index-2mQPVEDR.cjs +0 -1
- package/dist/tooltipCoordinator-BzxEyKhA.js +0 -144
- package/dist/tooltipCoordinator-DslqMlsI.cjs +0 -1
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
* service, passed in as {@link NotificationSinks}.
|
|
16
16
|
*/
|
|
17
17
|
import type { OsNotifyOptions } from '../_internal/app/platform/electronBridge.js';
|
|
18
|
-
import { type FilterDecision } from './toastFilterPolicy.js';
|
|
18
|
+
import { type FilterDecision, type NotificationFilter } from './toastFilterPolicy.js';
|
|
19
19
|
import type { NotificationAudio } from './notificationAudio.js';
|
|
20
20
|
import type { WebhookDelivery } from './webhookDelivery.js';
|
|
21
21
|
import type { EmailDigest } from './emailDigest.js';
|
|
@@ -34,31 +34,50 @@ export interface NotificationSinks {
|
|
|
34
34
|
/** The OS notification centre (fire-and-forget; the in-app toast is shown regardless). */
|
|
35
35
|
readonly osNotify: (options: OsNotifyOptions) => void;
|
|
36
36
|
}
|
|
37
|
+
/** The keys an issue names its notification by — the user's choices on its cards are kept on them. */
|
|
38
|
+
export interface IssueKeys {
|
|
39
|
+
/** "Don't show again" (`ToastCommonOptions.dontShowAgainKey`). */
|
|
40
|
+
readonly dontShowAgainKey: string | undefined;
|
|
41
|
+
/** The issuer's key for "remind me later" (`ToastCommonOptions.remindKey`). */
|
|
42
|
+
readonly remindKey: string | undefined;
|
|
43
|
+
}
|
|
44
|
+
/** One issue as its filter decision reads it. */
|
|
45
|
+
export interface IssueDecisionInput extends IssueKeys {
|
|
46
|
+
readonly source: NotificationSourceId;
|
|
47
|
+
readonly title: string;
|
|
48
|
+
readonly severity: NotificationSeverity;
|
|
49
|
+
readonly priority: NotificationPriority;
|
|
50
|
+
/** The caller's `recordTimeline`; `false` always wins. */
|
|
51
|
+
readonly recordTimeline: boolean | undefined;
|
|
52
|
+
/** The realm's run-time filter at the issue (`Notifications.getFilter`). */
|
|
53
|
+
readonly filter: NotificationFilter;
|
|
54
|
+
}
|
|
37
55
|
/**
|
|
38
56
|
* The filter decision with its gates computed: the pure policy takes the suppression answers as
|
|
39
|
-
* precomputed booleans, and they are asked here, in one place.
|
|
57
|
+
* precomputed booleans, and they are asked here, in one place. The run-time filter decides through the
|
|
58
|
+
* priority ({@link filteredPriority}).
|
|
40
59
|
*/
|
|
41
|
-
export declare function decideFilter(
|
|
60
|
+
export declare function decideFilter(issue: IssueDecisionInput): FilterDecision;
|
|
42
61
|
/**
|
|
43
|
-
* Whether the user turned a notification of
|
|
44
|
-
* Unlike a setting that silences, the choice rejects the notification itself, its record too (the decision's
|
|
45
|
-
* rejections): a progress gets no card, not even one in the notification center.
|
|
62
|
+
* Whether the user turned a notification of these keys and this text down on a card — "don't show again", "remind me
|
|
63
|
+
* later". Unlike a setting that silences, the choice rejects the notification itself, its record too (the decision's
|
|
64
|
+
* explicit rejections): a progress gets no card, not even one in the notification center.
|
|
46
65
|
*/
|
|
47
|
-
export declare function turnedDownOnCard(source: string, title: string,
|
|
66
|
+
export declare function turnedDownOnCard(source: string, title: string, keys: IssueKeys): boolean;
|
|
48
67
|
/**
|
|
49
68
|
* Whether the user turned a shown card's notification down — the keys its gear menu writes (`NotificationItem`):
|
|
50
|
-
* "don't show again" on its `neverShowAgainKey`, "remind me later" on
|
|
51
|
-
*
|
|
52
|
-
* the user closes under such a choice instead of sending it to the notification center
|
|
69
|
+
* "don't show again" on its `neverShowAgainKey`, "remind me later" on the card's remind key ({@link cardRemindKey}).
|
|
70
|
+
* The engine ends a running card the user closes under such a choice instead of sending it to the notification center
|
|
53
71
|
* (`NativeNotificationEngineDependencies.isTurnedDown`).
|
|
54
72
|
*/
|
|
55
73
|
export declare function turnedDownCard(item: Pick<NotificationInput, 'neverShowAgainKey' | 'remindKey' | 'source' | 'title'>): boolean;
|
|
56
74
|
/**
|
|
57
|
-
* Whether the notification settings now keep a card of this source and
|
|
58
|
-
* without the per-key choices
|
|
59
|
-
* running progress too ({@link turnedDownCard}) —, and an issue they turn
|
|
75
|
+
* Whether the notification settings — and the realm's run-time filter — now keep a card of this source, severity and
|
|
76
|
+
* priority off the screen: an issue's decision without the per-key choices. "Don't show again" and "remind me later"
|
|
77
|
+
* are made on the card, which they close — a running progress too ({@link turnedDownCard}) —, and an issue they turn
|
|
78
|
+
* down is {@link turnedDownOnCard}.
|
|
60
79
|
*/
|
|
61
|
-
export declare function silencedBySettings(source: string, priority: NotificationPriority): boolean;
|
|
80
|
+
export declare function silencedBySettings(source: string, severity: NotificationSeverity, priority: NotificationPriority, filter: NotificationFilter): boolean;
|
|
62
81
|
/**
|
|
63
82
|
* A card's buttons as the engine takes them — `primary` first, then `others` in declaration order. A click is counted
|
|
64
83
|
* for the source; unless the action keeps the card (`expireOnAction: false`) the card then closes, as the program's
|
|
@@ -68,9 +87,9 @@ export declare function nativeActionsOf(sinks: NotificationSinks, primary: Toast
|
|
|
68
87
|
/**
|
|
69
88
|
* A card's presentation from a verb's options — one mapping for the message verbs and the progress, so a progress no
|
|
70
89
|
* longer drops what its catalog payload carries and the catalog preview paints: the body, markdown, icon,
|
|
71
|
-
* announcement, page, duration
|
|
90
|
+
* announcement, page, duration, "don't show again" key and the issuer's remind key.
|
|
72
91
|
*/
|
|
73
|
-
export declare function cardPresentation(options: ToastCommonOptions): Pick<NotificationInput, 'body' | 'markdown' | 'durationMs' | 'neverShowAgainKey' | 'icon' | 'announce' | 'defaultRoute'>;
|
|
92
|
+
export declare function cardPresentation(options: ToastCommonOptions): Pick<NotificationInput, 'body' | 'markdown' | 'durationMs' | 'neverShowAgainKey' | 'remindKey' | 'icon' | 'announce' | 'defaultRoute'>;
|
|
74
93
|
export interface FireOptions {
|
|
75
94
|
severity: NotificationSeverity;
|
|
76
95
|
title: string;
|
|
@@ -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-DQs5g1K6.cjs"),e=require("../mainRealmDom-BYGSE-fo.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.cardRemindKey=i.cardRemindKey;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.filteredPriority=i.filteredPriority;exports.focusFirstNotificationEntry=i.focusFirstNotificationEntry;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;
|
|
@@ -32,4 +32,5 @@ export { NotificationItem, type NotificationItemController, type NotificationIte
|
|
|
32
32
|
export type { NotificationItem as NotificationItemModel } from './nativeEngine.cjs';
|
|
33
33
|
export { NotificationPanel, type NotificationPanelProps } from './NotificationPanel.cjs';
|
|
34
34
|
export { NotificationsCenter } from './NotificationsCenter.cjs';
|
|
35
|
+
export { focusFirstNotificationEntry } from './notificationEntryList.cjs';
|
|
35
36
|
export { StatusBarNotificationBell, type StatusBarNotificationBellProps, } from './StatusBarNotificationBell.cjs';
|
|
@@ -32,4 +32,5 @@ export { NotificationItem, type NotificationItemController, type NotificationIte
|
|
|
32
32
|
export type { NotificationItem as NotificationItemModel } from './nativeEngine.js';
|
|
33
33
|
export { NotificationPanel, type NotificationPanelProps } from './NotificationPanel.js';
|
|
34
34
|
export { NotificationsCenter } from './NotificationsCenter.js';
|
|
35
|
+
export { focusFirstNotificationEntry } from './notificationEntryList.js';
|
|
35
36
|
export { StatusBarNotificationBell, type StatusBarNotificationBellProps, } from './StatusBarNotificationBell.js';
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { A as
|
|
2
|
-
import { d as
|
|
3
|
-
import { n as
|
|
1
|
+
import { A as e, 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 f, f as d, g as I, h as S, S as T, i as m, j as u, k as O, l as p, m as R, n as A, o as C, p as y, q as E, r as g, s as v, t as _, u as h, v as F, w as P, x, y as K, z as k, B as D, 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 ai, a0 as ei, a1 as si, a2 as ti, a3 as oi, a4 as ri, a5 as ni, a6 as ci, a7 as li, a8 as Ni, a9 as fi, aa as di } from "../StatusBarNotificationBell-ZTEhZFmJ.js";
|
|
2
|
+
import { d as Si, a as Ti } from "../mainRealmDom-B215swW-.js";
|
|
3
|
+
import { n as ui } from "../useSettingsSubscription-DLEk4k4j.js";
|
|
4
4
|
export {
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
e as ACCEPT_PRIMARY_ACTION_NOTIFICATION,
|
|
6
|
+
s as CLEAR_NOTIFICATION,
|
|
7
7
|
t as HIDE_NOTIFICATION_TOASTS,
|
|
8
8
|
o as LogFilterBar,
|
|
9
9
|
r as NOTIFICATION_SOURCES,
|
|
@@ -11,60 +11,63 @@ export {
|
|
|
11
11
|
c as NO_NOTIFICATION_OVERLAY,
|
|
12
12
|
l as NotificationHost,
|
|
13
13
|
N as NotificationItem,
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
14
|
+
f as NotificationPanel,
|
|
15
|
+
d as NotificationService,
|
|
16
|
+
I as NotificationTimeline,
|
|
17
|
+
S as NotificationsCenter,
|
|
18
|
+
T as SEVERITY_ORDER,
|
|
19
19
|
m as SEVERITY_TONES,
|
|
20
20
|
u as StatusBarNotificationBell,
|
|
21
21
|
O as appWindowNotificationOverlay,
|
|
22
22
|
p as applyNotificationRules,
|
|
23
|
+
R as cardRemindKey,
|
|
23
24
|
A as clearCompiledRuleRegexCache,
|
|
24
25
|
C as compileNotificationSearchMatcher,
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
26
|
+
y as createNativeNotificationEngine,
|
|
27
|
+
E as createNotificationPreviewRuntime,
|
|
28
|
+
g as decideFilter,
|
|
29
|
+
Si as defineNotification,
|
|
30
|
+
Ti as defineNotificationScenario,
|
|
30
31
|
v as deleteWebhookUrl,
|
|
31
32
|
_ as deriveImplicitRemindKey,
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
33
|
+
h as dismissKey,
|
|
34
|
+
F as dismissableToastIds,
|
|
35
|
+
P as entryVendorMatch,
|
|
36
|
+
x as exportTimelineAsCsv,
|
|
37
|
+
K as exportTimelineAsJson,
|
|
37
38
|
k as filterNotificationTimeline,
|
|
38
|
-
D as
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
ei as
|
|
62
|
-
si as
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
39
|
+
D as filteredPriority,
|
|
40
|
+
b as focusFirstNotificationEntry,
|
|
41
|
+
H as getSmtpPass,
|
|
42
|
+
M as getWebhookUrl,
|
|
43
|
+
U as groupTimelineEntries,
|
|
44
|
+
W as hiddenRunningProgress,
|
|
45
|
+
L as isInQuietHours,
|
|
46
|
+
V as isKeyDismissed,
|
|
47
|
+
Y as isKeyRemindSuppressed,
|
|
48
|
+
w as isNotificationSourceId,
|
|
49
|
+
B as isNotificationSticky,
|
|
50
|
+
Q as isOnToastStack,
|
|
51
|
+
J as isProgressRunning,
|
|
52
|
+
j as isSourceMuted,
|
|
53
|
+
q as isSpamDropHandle,
|
|
54
|
+
z as listNotificationSources,
|
|
55
|
+
G as nextQuietHoursStart,
|
|
56
|
+
ui as notificationSettings,
|
|
57
|
+
X as pruneOrphanWebhookSecrets,
|
|
58
|
+
Z as registerFenceAliases,
|
|
59
|
+
$ as registerNotificationCommands,
|
|
60
|
+
ii as remindLater,
|
|
61
|
+
ai as resolveCatalogPreviewPriority,
|
|
62
|
+
ei as resolveNotificationDuration,
|
|
63
|
+
si as resolveNotificationSource,
|
|
64
|
+
ti as resolveSeverityTone,
|
|
65
|
+
oi as restoreAllKeys,
|
|
66
|
+
ri as restoreKey,
|
|
67
|
+
ni as setSmtpPass,
|
|
68
|
+
ci as setSourceMuted,
|
|
69
|
+
li as setWebhookUrl,
|
|
70
|
+
Ni as shouldFireOsNative,
|
|
71
|
+
fi as toTimelineActions,
|
|
72
|
+
di as unmuteAllSources
|
|
70
73
|
};
|
|
@@ -46,9 +46,10 @@ export interface NotificationInput extends NotificationInputBase {
|
|
|
46
46
|
/** When set, the gear menu offers a "Don't show again" toggle keyed by this id. */
|
|
47
47
|
neverShowAgainKey?: string;
|
|
48
48
|
/**
|
|
49
|
-
* The key "remind me later" on this card silences
|
|
50
|
-
*
|
|
51
|
-
*
|
|
49
|
+
* The key "remind me later" on this card silences — it wins over `neverShowAgainKey` (`cardRemindKey`). The issuer's
|
|
50
|
+
* key (`ToastCommonOptions.remindKey`) sets it; so does a verb whose card's title moves away from the text it was
|
|
51
|
+
* issued with (a progress's `update`), with its "don't show again" key, else the key of that text, so the menu
|
|
52
|
+
* silences the next issue the decision checks. Unset, the card keys on `neverShowAgainKey`, else on its title.
|
|
52
53
|
*/
|
|
53
54
|
remindKey?: string;
|
|
54
55
|
progress?: NotificationProgress;
|
|
@@ -46,9 +46,10 @@ export interface NotificationInput extends NotificationInputBase {
|
|
|
46
46
|
/** When set, the gear menu offers a "Don't show again" toggle keyed by this id. */
|
|
47
47
|
neverShowAgainKey?: string;
|
|
48
48
|
/**
|
|
49
|
-
* The key "remind me later" on this card silences
|
|
50
|
-
*
|
|
51
|
-
*
|
|
49
|
+
* The key "remind me later" on this card silences — it wins over `neverShowAgainKey` (`cardRemindKey`). The issuer's
|
|
50
|
+
* key (`ToastCommonOptions.remindKey`) sets it; so does a verb whose card's title moves away from the text it was
|
|
51
|
+
* issued with (a progress's `update`), with its "don't show again" key, else the key of that text, so the menu
|
|
52
|
+
* silences the next issue the decision checks. Unset, the card keys on `neverShowAgainKey`, else on its title.
|
|
52
53
|
*/
|
|
53
54
|
remindKey?: string;
|
|
54
55
|
progress?: NotificationProgress;
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import type { NotificationTimelineEntry } from './notificationTimeline.cjs';
|
|
2
|
+
/** The mark of an entry of a notification center or panel, spread on the entry's element. */
|
|
3
|
+
export declare const notificationEntryMark: {
|
|
4
|
+
readonly "data-notification-entry": "";
|
|
5
|
+
};
|
|
6
|
+
/**
|
|
7
|
+
* Moves the focus to the first entry of the notification center or panel drawn under `root` — a running progress
|
|
8
|
+
* card, else the newest record —, as the reference's center does when it is shown. Whether the entry now holds the
|
|
9
|
+
* focus: `false` when `root` lists no entry, or when the one it lists could not take the focus (an inert or hidden
|
|
10
|
+
* subtree); the caller then focuses what it shows instead (the reference focuses its empty list).
|
|
11
|
+
*/
|
|
12
|
+
export declare function focusFirstNotificationEntry(root: ParentNode, options?: FocusOptions): boolean;
|
|
13
|
+
/**
|
|
14
|
+
* What Page Up and Page Down do on a surface — the one row of the key table that differs between them:
|
|
15
|
+
* - `'ends'`, the toast stack: the first and the last toast, as Home and End — the reference binds its first-toast and
|
|
16
|
+
* last-toast commands to Page Up and Page Down, with Home and End as their second keys
|
|
17
|
+
* (`workbench/browser/parts/notifications/notificationsCommands.ts:248-270`);
|
|
18
|
+
* - a function, a scrolled list: the entry a page away from `current` toward `direction`, read from the list's
|
|
19
|
+
* geometry ({@link notificationListPageStep}), as the reference's list pages (`listCommands.ts:143-167`).
|
|
20
|
+
*/
|
|
21
|
+
export type NotificationListPaging = 'ends' | ((current: number | null, direction: -1 | 1) => number);
|
|
22
|
+
/**
|
|
23
|
+
* A list's own keys — one table for the toast stack and the notification lists: Down moves to the next entry, Up to
|
|
24
|
+
* the previous one, without wrapping (`listCommands.ts:75-107`); Home goes to the first, End to the last
|
|
25
|
+
* (`listCommands.ts:169-193`); Page Up and Page Down are the surface's `paging`. From no focused entry (`current`
|
|
26
|
+
* null) Down starts at the first and Up at the last. `null` for any other key and for an empty list.
|
|
27
|
+
*/
|
|
28
|
+
export declare function notificationListFocusStep(event: {
|
|
29
|
+
readonly key: string;
|
|
30
|
+
}, current: number | null, count: number, paging: NotificationListPaging): number | null;
|
|
31
|
+
/** Where a scrolled list's entries lie and how much of them shows: what a page step reads. */
|
|
32
|
+
export interface NotificationListPage {
|
|
33
|
+
/** Each entry's top and bottom, in pixels down from the top of the scrolled content, in drawing order. */
|
|
34
|
+
readonly extents: readonly {
|
|
35
|
+
readonly top: number;
|
|
36
|
+
readonly bottom: number;
|
|
37
|
+
}[];
|
|
38
|
+
/** How far the content is scrolled. */
|
|
39
|
+
readonly scrollTop: number;
|
|
40
|
+
/** The height that shows. */
|
|
41
|
+
readonly height: number;
|
|
42
|
+
/** The furthest the content scrolls. */
|
|
43
|
+
readonly maxScrollTop: number;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* The entry a Page key moves to in a scrolled list, as the reference's list pages (`base/browser/ui/list/
|
|
47
|
+
* listWidget.ts:1836-1902`): Page Down goes to the last entry that ends inside the page that shows, and from there to
|
|
48
|
+
* the last that ends inside the page below; Page Up goes to the first entry that starts inside the page that shows,
|
|
49
|
+
* and from there to the first that starts inside the page above. At either end of the content the focus stays. The
|
|
50
|
+
* step never goes against its key and always moves while an entry lies beyond the focus, so an entry taller than the
|
|
51
|
+
* page is still reached.
|
|
52
|
+
*/
|
|
53
|
+
export declare function notificationListPageStep(page: NotificationListPage, current: number | null, direction: -1 | 1): number;
|
|
54
|
+
/**
|
|
55
|
+
* The list keys of a center's entries, for the `keydown` of the scrolled element that holds them (`viewport`): from an
|
|
56
|
+
* entry, or from a control inside one, the key moves the focus along the entries {@link notificationListFocusStep},
|
|
57
|
+
* a page at a time for Page Up and Page Down, and the entry that takes it is scrolled just into view, as the
|
|
58
|
+
* reference reveals its list's focus (`listCommands.ts:58-73`; `listWidget.ts:1985-1996`). A key aimed elsewhere,
|
|
59
|
+
* one an editable element takes, or one already handled is left alone.
|
|
60
|
+
*/
|
|
61
|
+
export declare function moveNotificationEntryFocus(event: KeyboardEvent, viewport: HTMLElement): void;
|
|
62
|
+
/** What a notification list that follows its focus tells its owner. */
|
|
63
|
+
export interface NotificationListFocus {
|
|
64
|
+
/**
|
|
65
|
+
* Whether the keyboard focus is in the list: set when the focus enters it, cleared when the focus moves to an element
|
|
66
|
+
* outside it (`focusin`). It still holds after the element that had the focus went away with its entry — the
|
|
67
|
+
* reference measures "the center had the focus" before the removal (`notificationsCenter.ts:344-346`) —, so an owner
|
|
68
|
+
* that hands the focus back when the list closes reads it rather than where the focus fell.
|
|
69
|
+
*/
|
|
70
|
+
readonly holdsFocus: () => boolean;
|
|
71
|
+
}
|
|
72
|
+
export interface NotificationListFocusOptions {
|
|
73
|
+
/** The element whose focus is followed: a center, a panel's list. */
|
|
74
|
+
readonly container: () => HTMLElement | undefined;
|
|
75
|
+
/** Reads what the list draws — tracked: the focus is checked once each change has been drawn. */
|
|
76
|
+
readonly drawn: () => unknown;
|
|
77
|
+
/** Focuses the list's own target when no entry is left to take the focus. */
|
|
78
|
+
readonly fallback: (container: HTMLElement) => void;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Keeps the keyboard focus in a notification list whose entries change under it, as the reference's list does
|
|
82
|
+
* (`notificationsList.ts:149-199`): the entry that held the focus keeps it when it is still drawn; when it went away,
|
|
83
|
+
* the focus goes to the entry before it — the first when it was the first —, and to the list's own target when no
|
|
84
|
+
* entry is left. Call it in the component's setup.
|
|
85
|
+
*/
|
|
86
|
+
export declare function followNotificationListFocus(options: NotificationListFocusOptions): NotificationListFocus;
|
|
87
|
+
/**
|
|
88
|
+
* A record's accessible name — its severity, its message and its source, as the reference names a notification of
|
|
89
|
+
* its list (`notificationsList.ts:271-283`).
|
|
90
|
+
*/
|
|
91
|
+
export declare function timelineEntryAriaLabel(entry: NotificationTimelineEntry): string;
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import type { NotificationTimelineEntry } from './notificationTimeline.js';
|
|
2
|
+
/** The mark of an entry of a notification center or panel, spread on the entry's element. */
|
|
3
|
+
export declare const notificationEntryMark: {
|
|
4
|
+
readonly "data-notification-entry": "";
|
|
5
|
+
};
|
|
6
|
+
/**
|
|
7
|
+
* Moves the focus to the first entry of the notification center or panel drawn under `root` — a running progress
|
|
8
|
+
* card, else the newest record —, as the reference's center does when it is shown. Whether the entry now holds the
|
|
9
|
+
* focus: `false` when `root` lists no entry, or when the one it lists could not take the focus (an inert or hidden
|
|
10
|
+
* subtree); the caller then focuses what it shows instead (the reference focuses its empty list).
|
|
11
|
+
*/
|
|
12
|
+
export declare function focusFirstNotificationEntry(root: ParentNode, options?: FocusOptions): boolean;
|
|
13
|
+
/**
|
|
14
|
+
* What Page Up and Page Down do on a surface — the one row of the key table that differs between them:
|
|
15
|
+
* - `'ends'`, the toast stack: the first and the last toast, as Home and End — the reference binds its first-toast and
|
|
16
|
+
* last-toast commands to Page Up and Page Down, with Home and End as their second keys
|
|
17
|
+
* (`workbench/browser/parts/notifications/notificationsCommands.ts:248-270`);
|
|
18
|
+
* - a function, a scrolled list: the entry a page away from `current` toward `direction`, read from the list's
|
|
19
|
+
* geometry ({@link notificationListPageStep}), as the reference's list pages (`listCommands.ts:143-167`).
|
|
20
|
+
*/
|
|
21
|
+
export type NotificationListPaging = 'ends' | ((current: number | null, direction: -1 | 1) => number);
|
|
22
|
+
/**
|
|
23
|
+
* A list's own keys — one table for the toast stack and the notification lists: Down moves to the next entry, Up to
|
|
24
|
+
* the previous one, without wrapping (`listCommands.ts:75-107`); Home goes to the first, End to the last
|
|
25
|
+
* (`listCommands.ts:169-193`); Page Up and Page Down are the surface's `paging`. From no focused entry (`current`
|
|
26
|
+
* null) Down starts at the first and Up at the last. `null` for any other key and for an empty list.
|
|
27
|
+
*/
|
|
28
|
+
export declare function notificationListFocusStep(event: {
|
|
29
|
+
readonly key: string;
|
|
30
|
+
}, current: number | null, count: number, paging: NotificationListPaging): number | null;
|
|
31
|
+
/** Where a scrolled list's entries lie and how much of them shows: what a page step reads. */
|
|
32
|
+
export interface NotificationListPage {
|
|
33
|
+
/** Each entry's top and bottom, in pixels down from the top of the scrolled content, in drawing order. */
|
|
34
|
+
readonly extents: readonly {
|
|
35
|
+
readonly top: number;
|
|
36
|
+
readonly bottom: number;
|
|
37
|
+
}[];
|
|
38
|
+
/** How far the content is scrolled. */
|
|
39
|
+
readonly scrollTop: number;
|
|
40
|
+
/** The height that shows. */
|
|
41
|
+
readonly height: number;
|
|
42
|
+
/** The furthest the content scrolls. */
|
|
43
|
+
readonly maxScrollTop: number;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* The entry a Page key moves to in a scrolled list, as the reference's list pages (`base/browser/ui/list/
|
|
47
|
+
* listWidget.ts:1836-1902`): Page Down goes to the last entry that ends inside the page that shows, and from there to
|
|
48
|
+
* the last that ends inside the page below; Page Up goes to the first entry that starts inside the page that shows,
|
|
49
|
+
* and from there to the first that starts inside the page above. At either end of the content the focus stays. The
|
|
50
|
+
* step never goes against its key and always moves while an entry lies beyond the focus, so an entry taller than the
|
|
51
|
+
* page is still reached.
|
|
52
|
+
*/
|
|
53
|
+
export declare function notificationListPageStep(page: NotificationListPage, current: number | null, direction: -1 | 1): number;
|
|
54
|
+
/**
|
|
55
|
+
* The list keys of a center's entries, for the `keydown` of the scrolled element that holds them (`viewport`): from an
|
|
56
|
+
* entry, or from a control inside one, the key moves the focus along the entries {@link notificationListFocusStep},
|
|
57
|
+
* a page at a time for Page Up and Page Down, and the entry that takes it is scrolled just into view, as the
|
|
58
|
+
* reference reveals its list's focus (`listCommands.ts:58-73`; `listWidget.ts:1985-1996`). A key aimed elsewhere,
|
|
59
|
+
* one an editable element takes, or one already handled is left alone.
|
|
60
|
+
*/
|
|
61
|
+
export declare function moveNotificationEntryFocus(event: KeyboardEvent, viewport: HTMLElement): void;
|
|
62
|
+
/** What a notification list that follows its focus tells its owner. */
|
|
63
|
+
export interface NotificationListFocus {
|
|
64
|
+
/**
|
|
65
|
+
* Whether the keyboard focus is in the list: set when the focus enters it, cleared when the focus moves to an element
|
|
66
|
+
* outside it (`focusin`). It still holds after the element that had the focus went away with its entry — the
|
|
67
|
+
* reference measures "the center had the focus" before the removal (`notificationsCenter.ts:344-346`) —, so an owner
|
|
68
|
+
* that hands the focus back when the list closes reads it rather than where the focus fell.
|
|
69
|
+
*/
|
|
70
|
+
readonly holdsFocus: () => boolean;
|
|
71
|
+
}
|
|
72
|
+
export interface NotificationListFocusOptions {
|
|
73
|
+
/** The element whose focus is followed: a center, a panel's list. */
|
|
74
|
+
readonly container: () => HTMLElement | undefined;
|
|
75
|
+
/** Reads what the list draws — tracked: the focus is checked once each change has been drawn. */
|
|
76
|
+
readonly drawn: () => unknown;
|
|
77
|
+
/** Focuses the list's own target when no entry is left to take the focus. */
|
|
78
|
+
readonly fallback: (container: HTMLElement) => void;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Keeps the keyboard focus in a notification list whose entries change under it, as the reference's list does
|
|
82
|
+
* (`notificationsList.ts:149-199`): the entry that held the focus keeps it when it is still drawn; when it went away,
|
|
83
|
+
* the focus goes to the entry before it — the first when it was the first —, and to the list's own target when no
|
|
84
|
+
* entry is left. Call it in the component's setup.
|
|
85
|
+
*/
|
|
86
|
+
export declare function followNotificationListFocus(options: NotificationListFocusOptions): NotificationListFocus;
|
|
87
|
+
/**
|
|
88
|
+
* A record's accessible name — its severity, its message and its source, as the reference names a notification of
|
|
89
|
+
* its list (`notificationsList.ts:271-283`).
|
|
90
|
+
*/
|
|
91
|
+
export declare function timelineEntryAriaLabel(entry: NotificationTimelineEntry): string;
|
|
@@ -23,6 +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
|
+
import type { NotificationFilter } from './toastFilterPolicy.cjs';
|
|
26
27
|
/** The host's infrastructure the notification service works with, and whether its notification center is in reach. */
|
|
27
28
|
export interface NotificationServiceDependencies {
|
|
28
29
|
readonly desktop: DesktopBridge;
|
|
@@ -77,6 +78,21 @@ export interface Notifications {
|
|
|
77
78
|
*/
|
|
78
79
|
readonly onDidRequestNavigation: Event<string>;
|
|
79
80
|
requestNavigation(route: string): void;
|
|
81
|
+
/**
|
|
82
|
+
* The realm's run-time notification filter (`NotificationFilter`), `'off'` until a host sets it — the reference's
|
|
83
|
+
* `INotificationService.getFilter`.
|
|
84
|
+
*/
|
|
85
|
+
getFilter(): NotificationFilter;
|
|
86
|
+
/**
|
|
87
|
+
* Sets the run-time filter — not a setting: nothing of it is stored, and it ends with the realm. A host sets it while
|
|
88
|
+
* a state of its own lasts and sets `'off'` after, as the reference's Zen mode sets its error filter while
|
|
89
|
+
* `zenMode.silentNotifications` is on and turns it off on exit (`workbench/browser/layout.ts:1513-1515`,
|
|
90
|
+
* `:1549-1555`, `:1592-1594`). Like a settings change, it takes back the shown cards it now silences; a running
|
|
91
|
+
* progress goes to the notification center, alive.
|
|
92
|
+
*/
|
|
93
|
+
setFilter(filter: NotificationFilter): void;
|
|
94
|
+
/** The run-time filter changed — the reference's `onDidChangeFilter`. */
|
|
95
|
+
readonly onDidChangeFilter: Event<NotificationFilter>;
|
|
80
96
|
}
|
|
81
97
|
export declare class NotificationService implements Notifications, IDisposable {
|
|
82
98
|
private readonly deps;
|
|
@@ -85,6 +101,9 @@ export declare class NotificationService implements Notifications, IDisposable {
|
|
|
85
101
|
readonly stack: NotificationStack;
|
|
86
102
|
readonly timeline: NotificationTimeline;
|
|
87
103
|
readonly onDidRequestNavigation: Event<string>;
|
|
104
|
+
readonly onDidChangeFilter: Event<NotificationFilter>;
|
|
105
|
+
private filter;
|
|
106
|
+
private readonly filterChange;
|
|
88
107
|
private readonly engine;
|
|
89
108
|
private readonly analytics;
|
|
90
109
|
private readonly sounds;
|
|
@@ -108,11 +127,13 @@ export declare class NotificationService implements Notifications, IDisposable {
|
|
|
108
127
|
getStatsSnapshot(): SourceStats[];
|
|
109
128
|
resetStats(): void;
|
|
110
129
|
requestNavigation(route: string): void;
|
|
130
|
+
getFilter(): NotificationFilter;
|
|
131
|
+
setFilter(filter: NotificationFilter): void;
|
|
111
132
|
dispose(): void;
|
|
112
133
|
/**
|
|
113
134
|
* The shown cards the notification settings now silence ({@link silencedCard}) are taken back from the toast stack
|
|
114
|
-
* — do not disturb, quiet hours, a muted source, the master switch, "urgent to the center only"
|
|
115
|
-
* issue would get now. A running progress is not the settings' to end: it goes to the notification center, its
|
|
135
|
+
* — do not disturb, quiet hours, a muted source, the master switch, "urgent to the center only", the run-time filter:
|
|
136
|
+
* the decision an issue would get now. A running progress is not the settings' to end: it goes to the notification center, its
|
|
116
137
|
* handles still `open`, as the reference removes the toast and keeps the notification in its center; the other cards
|
|
117
138
|
* close and their handles report `suppressed`, the timeline keeping their records.
|
|
118
139
|
*
|
|
@@ -23,6 +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
|
+
import type { NotificationFilter } from './toastFilterPolicy.js';
|
|
26
27
|
/** The host's infrastructure the notification service works with, and whether its notification center is in reach. */
|
|
27
28
|
export interface NotificationServiceDependencies {
|
|
28
29
|
readonly desktop: DesktopBridge;
|
|
@@ -77,6 +78,21 @@ export interface Notifications {
|
|
|
77
78
|
*/
|
|
78
79
|
readonly onDidRequestNavigation: Event<string>;
|
|
79
80
|
requestNavigation(route: string): void;
|
|
81
|
+
/**
|
|
82
|
+
* The realm's run-time notification filter (`NotificationFilter`), `'off'` until a host sets it — the reference's
|
|
83
|
+
* `INotificationService.getFilter`.
|
|
84
|
+
*/
|
|
85
|
+
getFilter(): NotificationFilter;
|
|
86
|
+
/**
|
|
87
|
+
* Sets the run-time filter — not a setting: nothing of it is stored, and it ends with the realm. A host sets it while
|
|
88
|
+
* a state of its own lasts and sets `'off'` after, as the reference's Zen mode sets its error filter while
|
|
89
|
+
* `zenMode.silentNotifications` is on and turns it off on exit (`workbench/browser/layout.ts:1513-1515`,
|
|
90
|
+
* `:1549-1555`, `:1592-1594`). Like a settings change, it takes back the shown cards it now silences; a running
|
|
91
|
+
* progress goes to the notification center, alive.
|
|
92
|
+
*/
|
|
93
|
+
setFilter(filter: NotificationFilter): void;
|
|
94
|
+
/** The run-time filter changed — the reference's `onDidChangeFilter`. */
|
|
95
|
+
readonly onDidChangeFilter: Event<NotificationFilter>;
|
|
80
96
|
}
|
|
81
97
|
export declare class NotificationService implements Notifications, IDisposable {
|
|
82
98
|
private readonly deps;
|
|
@@ -85,6 +101,9 @@ export declare class NotificationService implements Notifications, IDisposable {
|
|
|
85
101
|
readonly stack: NotificationStack;
|
|
86
102
|
readonly timeline: NotificationTimeline;
|
|
87
103
|
readonly onDidRequestNavigation: Event<string>;
|
|
104
|
+
readonly onDidChangeFilter: Event<NotificationFilter>;
|
|
105
|
+
private filter;
|
|
106
|
+
private readonly filterChange;
|
|
88
107
|
private readonly engine;
|
|
89
108
|
private readonly analytics;
|
|
90
109
|
private readonly sounds;
|
|
@@ -108,11 +127,13 @@ export declare class NotificationService implements Notifications, IDisposable {
|
|
|
108
127
|
getStatsSnapshot(): SourceStats[];
|
|
109
128
|
resetStats(): void;
|
|
110
129
|
requestNavigation(route: string): void;
|
|
130
|
+
getFilter(): NotificationFilter;
|
|
131
|
+
setFilter(filter: NotificationFilter): void;
|
|
111
132
|
dispose(): void;
|
|
112
133
|
/**
|
|
113
134
|
* The shown cards the notification settings now silence ({@link silencedCard}) are taken back from the toast stack
|
|
114
|
-
* — do not disturb, quiet hours, a muted source, the master switch, "urgent to the center only"
|
|
115
|
-
* issue would get now. A running progress is not the settings' to end: it goes to the notification center, its
|
|
135
|
+
* — do not disturb, quiet hours, a muted source, the master switch, "urgent to the center only", the run-time filter:
|
|
136
|
+
* the decision an issue would get now. A running progress is not the settings' to end: it goes to the notification center, its
|
|
116
137
|
* handles still `open`, as the reference removes the toast and keeps the notification in its center; the other cards
|
|
117
138
|
* close and their handles report `suppressed`, the timeline keeping their records.
|
|
118
139
|
*
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
import type { ToastCommonOptions, ToastErrorOptions, ToastProgressHandle } from '../_internal/contract/notification.cjs';
|
|
13
13
|
import { type NotificationTimeline } from './notificationTimeline.cjs';
|
|
14
14
|
import { type VendorErrorMatch, type VendorErrorSource } from '../_internal/platform/vendorErrors/index.cjs';
|
|
15
|
+
import { type NotificationFilter } from './toastFilterPolicy.cjs';
|
|
15
16
|
import { type NotificationSinks } from './fireNotification.cjs';
|
|
16
17
|
export interface ErrorToastEnrichment {
|
|
17
18
|
readonly text: string;
|
|
@@ -78,5 +79,7 @@ export interface ToastDependencies {
|
|
|
78
79
|
readonly vendorErrors: VendorErrorSource;
|
|
79
80
|
/** Opens a vendor's documentation link (the error toast's docs action). */
|
|
80
81
|
readonly openExternal: (url: string) => void;
|
|
82
|
+
/** The realm's run-time notification filter now (`Notifications.getFilter`), read at each issue. */
|
|
83
|
+
readonly filter: () => NotificationFilter;
|
|
81
84
|
}
|
|
82
85
|
export declare function createToast(deps: ToastDependencies): Toast;
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
import type { ToastCommonOptions, ToastErrorOptions, ToastProgressHandle } from '../_internal/contract/notification.js';
|
|
13
13
|
import { type NotificationTimeline } from './notificationTimeline.js';
|
|
14
14
|
import { type VendorErrorMatch, type VendorErrorSource } from '../_internal/platform/vendorErrors/index.js';
|
|
15
|
+
import { type NotificationFilter } from './toastFilterPolicy.js';
|
|
15
16
|
import { type NotificationSinks } from './fireNotification.js';
|
|
16
17
|
export interface ErrorToastEnrichment {
|
|
17
18
|
readonly text: string;
|
|
@@ -78,5 +79,7 @@ export interface ToastDependencies {
|
|
|
78
79
|
readonly vendorErrors: VendorErrorSource;
|
|
79
80
|
/** Opens a vendor's documentation link (the error toast's docs action). */
|
|
80
81
|
readonly openExternal: (url: string) => void;
|
|
82
|
+
/** The realm's run-time notification filter now (`Notifications.getFilter`), read at each issue. */
|
|
83
|
+
readonly filter: () => NotificationFilter;
|
|
81
84
|
}
|
|
82
85
|
export declare function createToast(deps: ToastDependencies): Toast;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { ToastPosition } from '../_internal/platform/settings/settingsTypes.cjs';
|
|
2
|
+
/**
|
|
3
|
+
* The window edge a notifications corner is on — the edge the toast stack and the center grow away from, which
|
|
4
|
+
* turns the icons that point along them, as the reference turns its center's hide icon and its cards' expand and
|
|
5
|
+
* collapse icons with the notifications' position (`workbench/browser/parts/notifications/notificationsCenter.ts:
|
|
6
|
+
* 104-111`; `notificationsActions.ts:19-24`, `:29-35`).
|
|
7
|
+
*/
|
|
8
|
+
export declare function toastCornerEdge(corner: ToastPosition): 'top' | 'bottom';
|