@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.
Files changed (253) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +27 -0
  3. package/dist/{AttributeGrid-eND8YDby.cjs → AttributeGrid-Ch1k9v5j.cjs} +1 -1
  4. package/dist/{AttributeGrid-CASILa4u.js → AttributeGrid-DqFd4gBm.js} +3 -3
  5. package/dist/Button-4meERfnv.js +300 -0
  6. package/dist/Button-OyZHrl-t.cjs +1 -0
  7. package/dist/CommandPalette-CxYZUJtN.cjs +2 -0
  8. package/dist/{CommandPalette-Cj618AOz.js → CommandPalette-DwOp8y1-.js} +1467 -1466
  9. package/dist/{CopyButton-B5gS2ft3.cjs → CopyButton-16QNPgz6.cjs} +1 -1
  10. package/dist/{CopyButton-g-WSiBDZ.js → CopyButton-BVS49lMS.js} +1 -1
  11. package/dist/{DateRangePicker-CJD9ADgB.js → DateRangePicker-8QvydugY.js} +4 -4
  12. package/dist/{DateRangePicker-Frc0HVxp.cjs → DateRangePicker-DI-06xWY.cjs} +1 -1
  13. package/dist/{GuidedTour-B6q7lYhn.cjs → GuidedTour-DUQwdW8n.cjs} +1 -1
  14. package/dist/{GuidedTour-CFCvRJN4.js → GuidedTour-DXMmHn0o.js} +2 -2
  15. package/dist/{HostPortal-CXGUUhP8.js → HostPortal-Ba3MD9CG.js} +1 -1
  16. package/dist/HostPortal-CpWsArs6.cjs +1 -0
  17. package/dist/{IconPicker-DYqNi5ud.js → IconPicker-D1G8HK92.js} +3 -3
  18. package/dist/{IconPicker-CIbJb1ei.cjs → IconPicker-Q-ZDtNkd.cjs} +1 -1
  19. package/dist/Input-Brp5EDhg.cjs +1 -0
  20. package/dist/Input-CZi8KEfm.js +374 -0
  21. package/dist/Modal-CBi7Wd2V.cjs +1 -0
  22. package/dist/Modal-iyY1HUtr.js +588 -0
  23. package/dist/{PageSkeleton-BPbb28-H.cjs → PageSkeleton-B_-4fz1q.cjs} +1 -1
  24. package/dist/{PageSkeleton-CLnJO6uD.js → PageSkeleton-zNyjLPlk.js} +3 -3
  25. package/dist/{Popover-Cttb6NYT.js → Popover-DVi179wu.js} +4 -3
  26. package/dist/Popover-DXrczbt9.cjs +1 -0
  27. package/dist/{SearchableSelect-BvCm4enQ.js → SearchableSelect-DtHbWJhR.js} +34 -33
  28. package/dist/SearchableSelect-yLVqCGFo.cjs +1 -0
  29. package/dist/StatusBarNotificationBell-DQs5g1K6.cjs +50 -0
  30. package/dist/{StatusBarNotificationBell-7Izs_msz.js → StatusBarNotificationBell-ZTEhZFmJ.js} +4279 -4002
  31. package/dist/{Stepper-D9i1Xclm.js → Stepper-CyRgzWlR.js} +1 -1
  32. package/dist/{Stepper-Ci5JpLbS.cjs → Stepper-u2ZsE5oP.cjs} +1 -1
  33. package/dist/{Textarea-CeAGf08O.cjs → Textarea-DASNQNoi.cjs} +1 -1
  34. package/dist/{Textarea-B5QqqKnI.js → Textarea-szHXQahi.js} +1 -1
  35. package/dist/{TimeSeriesChart-DOwi2lJs.js → TimeSeriesChart-D7lIqolp.js} +1 -1
  36. package/dist/{TimeSeriesChart-huvheefm.cjs → TimeSeriesChart-DGzM9B--.cjs} +1 -1
  37. package/dist/{ToggleButton-CFM8P3JY.js → ToggleButton-B22PsCqo.js} +61 -60
  38. package/dist/ToggleButton-DWslrIBN.cjs +1 -0
  39. package/dist/_internal/contract/notification.d.cts +9 -0
  40. package/dist/_internal/contract/notification.d.ts +9 -0
  41. package/dist/_internal/contract/notificationCatalog.d.cts +2 -0
  42. package/dist/_internal/contract/notificationCatalog.d.ts +2 -0
  43. package/dist/_internal/platform/settings/settingsTypes.d.cts +0 -8
  44. package/dist/_internal/platform/settings/settingsTypes.d.ts +0 -8
  45. package/dist/anchoredLayout-CBjQ1etD.cjs +1 -0
  46. package/dist/anchoredLayout-E0mqCWxk.js +233 -0
  47. package/dist/appThemeDerivation-BylmT80v.cjs +1 -0
  48. package/dist/{appThemeDerivation-CKoSe4KP.js → appThemeDerivation-DBAOkGl7.js} +260 -231
  49. package/dist/base.css +2 -2
  50. package/dist/charts/index.cjs +1 -1
  51. package/dist/charts/index.js +1 -1
  52. package/dist/context/DesktopContextMenuContext.d.cts +8 -1
  53. package/dist/context/DesktopContextMenuContext.d.ts +8 -1
  54. package/dist/createDialogShellFocus-CQ0VNC2g.cjs +1 -0
  55. package/dist/{createDialogShellFocus-B4piXDU4.js → createDialogShellFocus-DbiQmLgb.js} +9 -9
  56. package/dist/createResizableSidebar-COlpGQ7H.cjs +1 -0
  57. package/dist/createResizableSidebar-cmCKTIg_.js +504 -0
  58. package/dist/desktop/index.cjs +1 -1
  59. package/dist/desktop/index.js +3 -3
  60. package/dist/dialogFocusRestore-BhxVTSiP.js +10 -0
  61. package/dist/dialogFocusRestore-DP5b1bDo.cjs +1 -0
  62. package/dist/feedback/index.cjs +1 -1
  63. package/dist/feedback/index.js +3 -3
  64. package/dist/forms/Input.d.cts +20 -0
  65. package/dist/forms/Input.d.ts +20 -0
  66. package/dist/forms/InputMessage.d.cts +19 -0
  67. package/dist/forms/InputMessage.d.ts +19 -0
  68. package/dist/forms/index.cjs +1 -1
  69. package/dist/forms/index.js +9 -9
  70. package/dist/grid/index.cjs +1 -1
  71. package/dist/grid/index.js +1 -1
  72. package/dist/index.cjs +1 -1
  73. package/dist/index.js +547 -541
  74. package/dist/layout/index.cjs +1 -1
  75. package/dist/layout/index.js +2 -2
  76. package/dist/layout/resizeCarry.d.cts +17 -0
  77. package/dist/layout/resizeCarry.d.ts +17 -0
  78. package/dist/mainRealmDom-B215swW-.js +166 -0
  79. package/dist/mainRealmDom-BYGSE-fo.cjs +1 -0
  80. package/dist/nativeTitleHold-A9jUISgQ.js +170 -0
  81. package/dist/nativeTitleHold-B7Ou-W9b.cjs +1 -0
  82. package/dist/navigation/index.cjs +1 -1
  83. package/dist/navigation/index.js +1 -1
  84. package/dist/notifications/NotificationItem.d.cts +9 -0
  85. package/dist/notifications/NotificationItem.d.ts +9 -0
  86. package/dist/notifications/NotificationsCenter.d.cts +18 -0
  87. package/dist/notifications/NotificationsCenter.d.ts +18 -0
  88. package/dist/notifications/RunningProgressCards.d.cts +3 -0
  89. package/dist/notifications/RunningProgressCards.d.ts +3 -0
  90. package/dist/notifications/fireNotification.d.cts +35 -16
  91. package/dist/notifications/fireNotification.d.ts +35 -16
  92. package/dist/notifications/index.cjs +1 -1
  93. package/dist/notifications/index.d.cts +1 -0
  94. package/dist/notifications/index.d.ts +1 -0
  95. package/dist/notifications/index.js +55 -52
  96. package/dist/notifications/nativeEngine.d.cts +4 -3
  97. package/dist/notifications/nativeEngine.d.ts +4 -3
  98. package/dist/notifications/notificationEntryList.d.cts +91 -0
  99. package/dist/notifications/notificationEntryList.d.ts +91 -0
  100. package/dist/notifications/notificationService.d.cts +23 -2
  101. package/dist/notifications/notificationService.d.ts +23 -2
  102. package/dist/notifications/toast.d.cts +3 -0
  103. package/dist/notifications/toast.d.ts +3 -0
  104. package/dist/notifications/toastCorner.d.cts +8 -0
  105. package/dist/notifications/toastCorner.d.ts +8 -0
  106. package/dist/notifications/toastFilterPolicy.d.cts +33 -1
  107. package/dist/notifications/toastFilterPolicy.d.ts +33 -1
  108. package/dist/overlay/Modal.d.cts +6 -0
  109. package/dist/overlay/Modal.d.ts +6 -0
  110. package/dist/overlay/backgroundInert.d.cts +6 -2
  111. package/dist/overlay/backgroundInert.d.ts +6 -2
  112. package/dist/overlay/command-palette/CommandPalette.d.cts +12 -0
  113. package/dist/overlay/command-palette/CommandPalette.d.ts +12 -0
  114. package/dist/overlay/index.cjs +1 -1
  115. package/dist/overlay/index.js +70 -68
  116. package/dist/overlay/nativeTitleHold.d.cts +24 -0
  117. package/dist/overlay/nativeTitleHold.d.ts +24 -0
  118. package/dist/ownerAnimationFrame-DzFcMSmn.js +19 -0
  119. package/dist/ownerAnimationFrame-T6jf6qYC.cjs +1 -0
  120. package/dist/server/{AttributeGrid-CMi-UtWb.js → AttributeGrid-Bpjlauuz.js} +2 -2
  121. package/dist/server/{AttributeGrid-B7sb3btp.cjs → AttributeGrid-DNYdKb8J.cjs} +1 -1
  122. package/dist/server/CommandPalette-BuVxnqBG.cjs +1 -0
  123. package/dist/server/{CommandPalette-CozogFlk.js → CommandPalette-Dn3NKXPM.js} +1095 -1069
  124. package/dist/server/{DateRangePicker-KLZzyuPJ.cjs → DateRangePicker-BFzNjaME.cjs} +1 -1
  125. package/dist/server/{DateRangePicker-C35q8BTw.js → DateRangePicker-CnYkTgXX.js} +3 -3
  126. package/dist/server/{GuidedTour-DmLbBttx.js → GuidedTour-BZardPYW.js} +1 -1
  127. package/dist/server/{GuidedTour-DfV0yzqh.cjs → GuidedTour-yhdZk2SU.cjs} +1 -1
  128. package/dist/server/{HostPortal-CXGUUhP8.js → HostPortal-C4IrAeWN.js} +1 -1
  129. package/dist/server/HostPortal-D5ECrJvn.cjs +1 -0
  130. package/dist/server/{IconPicker-B1soopAp.cjs → IconPicker-C5lAN9pX.cjs} +1 -1
  131. package/dist/server/{IconPicker-B4aXspLw.js → IconPicker-DDWgB7sm.js} +3 -3
  132. package/dist/server/Input-AdF-i0O8.js +245 -0
  133. package/dist/server/Input-XF9Jr0G9.cjs +1 -0
  134. package/dist/server/{Modal-BheFQLs1.js → Modal-C5dzgcRW.js} +102 -97
  135. package/dist/server/{Modal-BswxV8Pn.cjs → Modal-nAhBS1L9.cjs} +1 -1
  136. package/dist/server/Popover-C5avmGWz.cjs +1 -0
  137. package/dist/server/{Popover-Cg28aPUZ.js → Popover-H3AAYZI0.js} +57 -57
  138. package/dist/server/{SearchableSelect-09ECcDlB.cjs → SearchableSelect-CZrXDKfC.cjs} +1 -1
  139. package/dist/server/{SearchableSelect-vjhS4c-H.js → SearchableSelect-DMqed5Er.js} +1 -1
  140. package/dist/server/StatusBarNotificationBell-CGcMdT4h.cjs +49 -0
  141. package/dist/server/{StatusBarNotificationBell-D8Jt3PXI.js → StatusBarNotificationBell-DW2l5O9B.js} +4216 -3949
  142. package/dist/server/{Stepper-DxNrskdq.cjs → Stepper-CpapA_WH.cjs} +1 -1
  143. package/dist/server/{Stepper-n5f9r-ye.js → Stepper-gGA7JwjV.js} +1 -1
  144. package/dist/server/{Textarea-BQf2lL59.cjs → Textarea-Bh5LVrBn.cjs} +1 -1
  145. package/dist/server/{Textarea-BTH48NET.js → Textarea-DVkfGkP0.js} +1 -1
  146. package/dist/server/{ToggleButton-TE3Xf2yD.cjs → ToggleButton-CA9T-OsI.cjs} +1 -1
  147. package/dist/server/{ToggleButton-FywO2CCI.js → ToggleButton-CBNKajZa.js} +4 -4
  148. package/dist/server/{VpTrash-Dlq8o6Uv.js → VpTrash-CZMWCIpF.js} +84 -70
  149. package/dist/server/VpTrash-DiczWhwm.cjs +1 -0
  150. package/dist/server/appThemeDerivation-BylmT80v.cjs +1 -0
  151. package/dist/server/{appThemeDerivation-CKoSe4KP.js → appThemeDerivation-DBAOkGl7.js} +260 -231
  152. package/dist/server/{createDialogShellFocus-BiBAZOCI.cjs → createDialogShellFocus-CDaLuPg8.cjs} +1 -1
  153. package/dist/server/{createDialogShellFocus-BFo8awdj.js → createDialogShellFocus-LGDBOVnr.js} +6 -6
  154. package/dist/server/{createResizableSidebar-BImbKlLe.js → createResizableSidebar-Dvu7iEk1.js} +1 -1
  155. package/dist/server/{createResizableSidebar-GFgZIj-5.cjs → createResizableSidebar-v40ZOb-Q.cjs} +1 -1
  156. package/dist/server/desktop/index.cjs +1 -1
  157. package/dist/server/desktop/index.js +3 -3
  158. package/dist/server/dialogFocusRestore-BhxVTSiP.js +10 -0
  159. package/dist/server/dialogFocusRestore-DP5b1bDo.cjs +1 -0
  160. package/dist/server/forms/index.cjs +1 -1
  161. package/dist/server/forms/index.js +7 -7
  162. package/dist/server/grid/index.cjs +1 -1
  163. package/dist/server/grid/index.js +1 -1
  164. package/dist/server/{index-UIjsx3oJ.js → index-BEARfm54.js} +3604 -3617
  165. package/dist/server/index-C6rYfWCJ.cjs +1 -0
  166. package/dist/server/index.cjs +1 -1
  167. package/dist/server/index.js +502 -497
  168. package/dist/server/layout/index.cjs +1 -1
  169. package/dist/server/layout/index.js +2 -2
  170. package/dist/server/navigation/index.cjs +1 -1
  171. package/dist/server/navigation/index.js +1 -1
  172. package/dist/server/notifications/index.cjs +1 -1
  173. package/dist/server/notifications/index.js +55 -52
  174. package/dist/server/overlay/index.cjs +1 -1
  175. package/dist/server/overlay/index.js +54 -53
  176. package/dist/server/tokens/index.cjs +1 -1
  177. package/dist/server/tokens/index.js +30 -28
  178. package/dist/solid/feedback/Badge.jsx +3 -14
  179. package/dist/solid/forms/Button.jsx +3 -14
  180. package/dist/solid/forms/Input.jsx +31 -5
  181. package/dist/solid/forms/Input.module.css.js +1 -0
  182. package/dist/solid/forms/InputMessage.jsx +86 -0
  183. package/dist/solid/forms/PressableSurface.jsx +3 -14
  184. package/dist/solid/layout/ResizeHandle.jsx +11 -1
  185. package/dist/solid/layout/resizeCarry.js +31 -0
  186. package/dist/solid/notifications/NotificationHost.jsx +5 -18
  187. package/dist/solid/notifications/NotificationItem.jsx +5 -5
  188. package/dist/solid/notifications/NotificationPanel.jsx +14 -4
  189. package/dist/solid/notifications/NotificationsCenter.jsx +70 -12
  190. package/dist/solid/notifications/RunningProgressCards.jsx +1 -1
  191. package/dist/solid/notifications/StatusBarNotificationBell.jsx +8 -3
  192. package/dist/solid/notifications/catalogAdapter.js +1 -0
  193. package/dist/solid/notifications/fireNotification.js +21 -16
  194. package/dist/solid/notifications/index.js +1 -0
  195. package/dist/solid/notifications/notificationEntryList.js +168 -0
  196. package/dist/solid/notifications/notificationService.js +20 -4
  197. package/dist/solid/notifications/toast.js +54 -7
  198. package/dist/solid/notifications/toastCorner.js +3 -0
  199. package/dist/solid/notifications/toastFilterPolicy.js +12 -0
  200. package/dist/solid/overlay/Drawer.jsx +2 -1
  201. package/dist/solid/overlay/Modal.jsx +42 -4
  202. package/dist/solid/overlay/command-palette/CommandPalette.jsx +4 -4
  203. package/dist/solid/overlay/context-menu/DesktopContextMenu.jsx +8 -7
  204. package/dist/solid/overlay/nativeTitleHold.js +33 -0
  205. package/dist/solid/overlay/tooltipDirective.js +3 -11
  206. package/dist/solid/tokens/index.js +1 -0
  207. package/dist/solid/tokens/palette/paletteContract.js +27 -0
  208. package/dist/style.css +2 -2
  209. package/dist/theme.css +1 -1
  210. package/dist/tokens/index.cjs +1 -1
  211. package/dist/tokens/index.d.cts +1 -0
  212. package/dist/tokens/index.d.ts +1 -0
  213. package/dist/tokens/index.js +30 -28
  214. package/dist/tokens/palette/paletteContract.d.cts +17 -0
  215. package/dist/tokens/palette/paletteContract.d.ts +17 -0
  216. package/dist/tokens/tokens.css +1 -1
  217. package/dist/ui.css +1 -1
  218. package/package.json +1 -1
  219. package/dist/Button-Bb68ymNP.cjs +0 -1
  220. package/dist/Button-D-T0tyGF.js +0 -305
  221. package/dist/CommandPalette-5FQRgPG9.cjs +0 -2
  222. package/dist/HostPortal-CgJwxt-f.cjs +0 -1
  223. package/dist/Input-CZruORyy.cjs +0 -1
  224. package/dist/Input-DkPhsdfk.js +0 -227
  225. package/dist/Modal-CY6ePolt.cjs +0 -1
  226. package/dist/Modal-NzZzHSwb.js +0 -559
  227. package/dist/Popover-CWrR51eG.cjs +0 -1
  228. package/dist/SearchableSelect-CVqdVMOC.cjs +0 -1
  229. package/dist/StatusBarNotificationBell-BJiORN4s.cjs +0 -50
  230. package/dist/ToggleButton-BFWh1_o5.cjs +0 -1
  231. package/dist/anchoredLayout-Dstwa5OH.cjs +0 -1
  232. package/dist/anchoredLayout-FC-qv8xm.js +0 -250
  233. package/dist/appThemeDerivation-Be_oKljl.cjs +0 -1
  234. package/dist/createDialogShellFocus-CJaw9-B9.cjs +0 -1
  235. package/dist/createResizableSidebar-BDUlX9-G.js +0 -472
  236. package/dist/createResizableSidebar-BVJBU2kP.cjs +0 -1
  237. package/dist/dialogFocusRestore--dH59ER2.js +0 -35
  238. package/dist/dialogFocusRestore-CL-ExfAA.cjs +0 -1
  239. package/dist/mainRealmDom-C12lr9lm.js +0 -171
  240. package/dist/mainRealmDom-S6teqEr4.cjs +0 -1
  241. package/dist/server/CommandPalette-DQK6N98N.cjs +0 -1
  242. package/dist/server/HostPortal-CgJwxt-f.cjs +0 -1
  243. package/dist/server/Input-CjvD8w18.cjs +0 -1
  244. package/dist/server/Input-DaEN2JJd.js +0 -127
  245. package/dist/server/Popover-BsxIKBbl.cjs +0 -1
  246. package/dist/server/StatusBarNotificationBell-LJHLMT9F.cjs +0 -49
  247. package/dist/server/VpTrash-D49oUUJh.cjs +0 -1
  248. package/dist/server/appThemeDerivation-Be_oKljl.cjs +0 -1
  249. package/dist/server/dialogFocusRestore--dH59ER2.js +0 -35
  250. package/dist/server/dialogFocusRestore-CL-ExfAA.cjs +0 -1
  251. package/dist/server/index-2mQPVEDR.cjs +0 -1
  252. package/dist/tooltipCoordinator-BzxEyKhA.js +0 -144
  253. 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(source: NotificationSourceId, title: string, priority: NotificationPriority, dontShowAgainKey: string | undefined, recordTimeline: boolean | undefined): FilterDecision;
60
+ export declare function decideFilter(issue: IssueDecisionInput): FilterDecision;
42
61
  /**
43
- * Whether the user turned a notification of this key and text down on a card — "don't show again", "remind me later".
44
- * Unlike a setting that silences, the choice rejects the notification itself, its record too (the decision's explicit
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, dontShowAgainKey: string | undefined): boolean;
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 that key, else on the card's `remindKey` (the
51
- * text a progress was issued with), else on the key derived from its source and title. The engine ends a running card
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 priority off the screen — an issue's decision
58
- * without the per-key choices: "don't show again" and "remind me later" are made on the card, which they close — a
59
- * running progress too ({@link turnedDownCard}) —, and an issue they turn down is {@link turnedDownOnCard}.
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 and "don't show again" key.
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-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
+ "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 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";
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
- s as ACCEPT_PRIMARY_ACTION_NOTIFICATION,
6
- a as CLEAR_NOTIFICATION,
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
- I as NotificationPanel,
15
- S as NotificationService,
16
- f as NotificationTimeline,
17
- T as NotificationsCenter,
18
- d as SEVERITY_ORDER,
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
- R as createNativeNotificationEngine,
26
- g as createNotificationPreviewRuntime,
27
- E as decideFilter,
28
- Ii as defineNotification,
29
- Si as defineNotificationScenario,
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
- y as dismissKey,
33
- h as dismissableToastIds,
34
- F as entryVendorMatch,
35
- P as exportTimelineAsCsv,
36
- x as exportTimelineAsJson,
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 getSmtpPass,
39
- K as getWebhookUrl,
40
- b as groupTimelineEntries,
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,
63
- ai as restoreKey,
64
- ti as setSmtpPass,
65
- oi as setSourceMuted,
66
- ri as setWebhookUrl,
67
- ni as shouldFireOsNative,
68
- ci as toTimelineActions,
69
- li as unmuteAllSources
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. A verb whose card's title moves away from the text it was issued
50
- * with (a progress's `update`) sets it, so the menu silences the next issue of that text — the key the issue's
51
- * decision checks; unset, the card derives it from its title. A `neverShowAgainKey` still wins.
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. A verb whose card's title moves away from the text it was issued
50
- * with (a progress's `update`) sets it, so the menu silences the next issue of that text — the key the issue's
51
- * decision checks; unset, the card derives it from its title. A `neverShowAgainKey` still wins.
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": the decision an
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": the decision an
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';