@vokril/ui-solid 0.29.0 → 0.32.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 (433) hide show
  1. package/CHANGELOG.md +121 -0
  2. package/README.md +90 -0
  3. package/dist/AttributeGrid-CNkALmJq.cjs +1 -0
  4. package/dist/AttributeGrid-DnuTPJ_P.js +320 -0
  5. package/dist/Button-CX7mylBT.js +308 -0
  6. package/dist/Button-lMUW5P3O.cjs +1 -0
  7. package/dist/CommandPalette-DAR9VMqY.cjs +2 -0
  8. package/dist/CommandPalette-DlLcdd4o.js +4029 -0
  9. package/dist/CopyButton-BVvv5M8g.js +63 -0
  10. package/dist/CopyButton-Dnd8_2Lj.cjs +1 -0
  11. package/dist/DateRangePicker-BlJWtJBA.cjs +9 -0
  12. package/dist/DateRangePicker-CHmUU4PA.js +552 -0
  13. package/dist/GuidedTour-9rqvNB_m.js +483 -0
  14. package/dist/GuidedTour-DbXeuTc7.cjs +1 -0
  15. package/dist/{HostPortal-CXGUUhP8.js → HostPortal-De65s6CU.js} +1 -1
  16. package/dist/HostPortal-Dm4BmY8M.cjs +1 -0
  17. package/dist/{IconPicker-DYqNi5ud.js → IconPicker-CsYW8CXe.js} +4 -4
  18. package/dist/IconPicker-D-GU1mD3.cjs +1 -0
  19. package/dist/Input-C3rEQffK.js +382 -0
  20. package/dist/Input-CHtvL4_4.cjs +1 -0
  21. package/dist/Modal-3L6p7Dwt.js +599 -0
  22. package/dist/Modal-CtrWEnJ7.cjs +1 -0
  23. package/dist/OverlayScrollArea-Cr0VAApT.cjs +1 -0
  24. package/dist/OverlayScrollArea-CrrPFLq9.js +180 -0
  25. package/dist/{PageSkeleton-CLnJO6uD.js → PageSkeleton-BRuqaDzr.js} +372 -371
  26. package/dist/PageSkeleton-Cz2bckO4.cjs +30 -0
  27. package/dist/Popover-CLTXG8W0.cjs +1 -0
  28. package/dist/Popover-DkqGvMNy.js +207 -0
  29. package/dist/SearchableSelect-C-lV1vSv.cjs +1 -0
  30. package/dist/SearchableSelect-Du12kcI9.js +328 -0
  31. package/dist/StatusBarNotificationBell-CNs_obmZ.cjs +50 -0
  32. package/dist/{StatusBarNotificationBell-7Izs_msz.js → StatusBarNotificationBell-CgsYrrpj.js} +5205 -4850
  33. package/dist/Stepper-DzI-gtKd.js +586 -0
  34. package/dist/Stepper-rpu7lpzB.cjs +1 -0
  35. package/dist/{Textarea-CeAGf08O.cjs → Textarea-D4nYoQ0J.cjs} +1 -1
  36. package/dist/{Textarea-B5QqqKnI.js → Textarea-DOzZCc-O.js} +1 -1
  37. package/dist/TimeSeriesChart-BJqQpeEJ.cjs +1 -0
  38. package/dist/TimeSeriesChart-DvAhuyVl.js +442 -0
  39. package/dist/ToggleButton-B-hBpdzk.js +2144 -0
  40. package/dist/ToggleButton-BMH1A-IX.cjs +1 -0
  41. package/dist/_internal/app/onboarding/pageTourState.d.cts +0 -2
  42. package/dist/_internal/app/onboarding/pageTourState.d.ts +0 -2
  43. package/dist/_internal/app/onboarding/pageTourTypes.d.cts +2 -1
  44. package/dist/_internal/app/onboarding/pageTourTypes.d.ts +2 -1
  45. package/dist/_internal/contract/notification.d.cts +28 -3
  46. package/dist/_internal/contract/notification.d.ts +28 -3
  47. package/dist/_internal/contract/notificationCatalog.d.cts +2 -0
  48. package/dist/_internal/contract/notificationCatalog.d.ts +2 -0
  49. package/dist/_internal/platform/settings/settingsTypes.d.cts +0 -8
  50. package/dist/_internal/platform/settings/settingsTypes.d.ts +0 -8
  51. package/dist/a11y/index.cjs +1 -1
  52. package/dist/a11y/index.js +1 -1
  53. package/dist/anchoredLayout-CBjQ1etD.cjs +1 -0
  54. package/dist/anchoredLayout-E0mqCWxk.js +233 -0
  55. package/dist/base.css +3 -3
  56. package/dist/charts/index.cjs +1 -1
  57. package/dist/charts/index.js +1 -1
  58. package/dist/context/DesktopContextMenuContext.d.cts +8 -1
  59. package/dist/context/DesktopContextMenuContext.d.ts +8 -1
  60. package/dist/createDialogShellFocus-DI1rUvYf.js +282 -0
  61. package/dist/createDialogShellFocus-kzkNSLWS.cjs +1 -0
  62. package/dist/createResizableSidebar--Ve6DbDu.js +504 -0
  63. package/dist/createResizableSidebar-DlVAuq5t.cjs +1 -0
  64. package/dist/desktop/index.cjs +1 -1
  65. package/dist/desktop/index.js +229 -228
  66. package/dist/dialogFocusRestore-BhxVTSiP.js +10 -0
  67. package/dist/dialogFocusRestore-DP5b1bDo.cjs +1 -0
  68. package/dist/feedback/index.cjs +1 -1
  69. package/dist/feedback/index.js +4 -4
  70. package/dist/{focusModality-BISb6-yg.cjs → focusModality-D704CJVN.cjs} +1 -1
  71. package/dist/{focusModality-FoLPWF-_.js → focusModality-ROUF6YGR.js} +1 -1
  72. package/dist/forms/Input.d.cts +20 -0
  73. package/dist/forms/Input.d.ts +20 -0
  74. package/dist/forms/InputMessage.d.cts +19 -0
  75. package/dist/forms/InputMessage.d.ts +19 -0
  76. package/dist/forms/index.cjs +1 -1
  77. package/dist/forms/index.js +9 -9
  78. package/dist/grid/index.cjs +1 -1
  79. package/dist/grid/index.js +1 -1
  80. package/dist/host/index.cjs +1 -1
  81. package/dist/host/index.d.cts +1 -0
  82. package/dist/host/index.d.ts +1 -0
  83. package/dist/host/index.js +38 -39
  84. package/dist/host/kitHost.d.cts +8 -0
  85. package/dist/host/kitHost.d.ts +8 -0
  86. package/dist/index.cjs +1 -1
  87. package/dist/index.js +936 -928
  88. package/dist/kitHost-BMMWpU4w.js +47 -0
  89. package/dist/kitHost-u0-mKvEK.cjs +1 -0
  90. package/dist/layout/index.cjs +1 -1
  91. package/dist/layout/index.js +2 -2
  92. package/dist/layout/resizeCarry.d.cts +17 -0
  93. package/dist/layout/resizeCarry.d.ts +17 -0
  94. package/dist/mainRealmDom-BcPuVvcy.cjs +1 -0
  95. package/dist/mainRealmDom-DydRT2Us.js +54 -0
  96. package/dist/nativeTitleHold-A9jUISgQ.js +170 -0
  97. package/dist/nativeTitleHold-B7Ou-W9b.cjs +1 -0
  98. package/dist/navigation/index.cjs +1 -1
  99. package/dist/navigation/index.js +1 -1
  100. package/dist/notificationCatalog-CRERhjp6.js +168 -0
  101. package/dist/notificationCatalog-DqTkd7M6.cjs +1 -0
  102. package/dist/notifications/NotificationItem.d.cts +9 -0
  103. package/dist/notifications/NotificationItem.d.ts +9 -0
  104. package/dist/notifications/NotificationsCenter.d.cts +18 -0
  105. package/dist/notifications/NotificationsCenter.d.ts +18 -0
  106. package/dist/notifications/RunningProgressCards.d.cts +3 -0
  107. package/dist/notifications/RunningProgressCards.d.ts +3 -0
  108. package/dist/notifications/fireNotification.d.cts +35 -16
  109. package/dist/notifications/fireNotification.d.ts +35 -16
  110. package/dist/notifications/holdWhileShown.d.cts +18 -0
  111. package/dist/notifications/holdWhileShown.d.ts +18 -0
  112. package/dist/notifications/index.cjs +1 -1
  113. package/dist/notifications/index.d.cts +1 -0
  114. package/dist/notifications/index.d.ts +1 -0
  115. package/dist/notifications/index.js +55 -52
  116. package/dist/notifications/nativeEngine.d.cts +38 -5
  117. package/dist/notifications/nativeEngine.d.ts +38 -5
  118. package/dist/notifications/notificationEntryList.d.cts +104 -0
  119. package/dist/notifications/notificationEntryList.d.ts +104 -0
  120. package/dist/notifications/notificationService.d.cts +23 -2
  121. package/dist/notifications/notificationService.d.ts +23 -2
  122. package/dist/notifications/toast.d.cts +3 -0
  123. package/dist/notifications/toast.d.ts +3 -0
  124. package/dist/notifications/toastCorner.d.cts +8 -0
  125. package/dist/notifications/toastCorner.d.ts +8 -0
  126. package/dist/notifications/toastFilterPolicy.d.cts +33 -1
  127. package/dist/notifications/toastFilterPolicy.d.ts +33 -1
  128. package/dist/overlay/Modal.d.cts +19 -0
  129. package/dist/overlay/Modal.d.ts +19 -0
  130. package/dist/overlay/backgroundInert.d.cts +6 -2
  131. package/dist/overlay/backgroundInert.d.ts +6 -2
  132. package/dist/overlay/command-palette/CommandPalette.d.cts +12 -0
  133. package/dist/overlay/command-palette/CommandPalette.d.ts +12 -0
  134. package/dist/overlay/index.cjs +1 -1
  135. package/dist/overlay/index.d.cts +2 -1
  136. package/dist/overlay/index.d.ts +2 -1
  137. package/dist/overlay/index.js +80 -75
  138. package/dist/overlay/modalDefaults.d.cts +23 -0
  139. package/dist/overlay/modalDefaults.d.ts +23 -0
  140. package/dist/overlay/modalViewport.d.cts +16 -2
  141. package/dist/overlay/modalViewport.d.ts +16 -2
  142. package/dist/overlay/nativeTitleHold.d.cts +24 -0
  143. package/dist/overlay/nativeTitleHold.d.ts +24 -0
  144. package/dist/ownerAnimationFrame-DzFcMSmn.js +19 -0
  145. package/dist/ownerAnimationFrame-T6jf6qYC.cjs +1 -0
  146. package/dist/pageTourState-BuA-GBYO.cjs +5 -0
  147. package/dist/{pageTourState-BcBF8w89.js → pageTourState-DsSKdPOu.js} +160 -169
  148. package/dist/rowSource-BRGZHclZ.js +1231 -0
  149. package/dist/rowSource-C3zlzAtR.cjs +1 -0
  150. package/dist/server/AttributeGrid-B9j_c2wM.js +281 -0
  151. package/dist/server/AttributeGrid-BALCTvOI.cjs +1 -0
  152. package/dist/server/Button-DHefmmYz.cjs +1 -0
  153. package/dist/server/Button-ft_8RNJj.js +226 -0
  154. package/dist/server/CommandPalette-CHdfYtxs.js +3305 -0
  155. package/dist/server/CommandPalette-D0Prl7by.cjs +1 -0
  156. package/dist/server/CopyButton-CiYcsQcI.js +64 -0
  157. package/dist/server/CopyButton-D2q7tQ0m.cjs +1 -0
  158. package/dist/server/DateRangePicker-C6wZI7No.js +487 -0
  159. package/dist/server/DateRangePicker-CF70G2yr.cjs +9 -0
  160. package/dist/server/GuidedTour-BmDAWNfN.cjs +1 -0
  161. package/dist/server/GuidedTour-DYBhprVK.js +400 -0
  162. package/dist/server/{HostPortal-CXGUUhP8.js → HostPortal-C4xdfRyM.js} +1 -1
  163. package/dist/server/HostPortal-CwyePpDX.cjs +1 -0
  164. package/dist/server/{IconPicker-B4aXspLw.js → IconPicker--Xso9fUf.js} +5 -5
  165. package/dist/server/IconPicker-BTI4cNgf.cjs +1 -0
  166. package/dist/server/Input-UX0Hk53M.cjs +1 -0
  167. package/dist/server/Input-V9Szcw6w.js +249 -0
  168. package/dist/server/Modal-CBnNlaTx.cjs +1 -0
  169. package/dist/server/Modal-D9CjieKK.js +426 -0
  170. package/dist/server/OverlayScrollArea-DuwGRSMm.cjs +1 -0
  171. package/dist/server/OverlayScrollArea-h6G3yk6U.js +66 -0
  172. package/dist/server/{PageSkeleton-DoxlE_bD.js → PageSkeleton-CFs7AdTA.js} +267 -266
  173. package/dist/server/PageSkeleton-D0KOKLsb.cjs +30 -0
  174. package/dist/server/Popover-BBDBIpT6.cjs +1 -0
  175. package/dist/server/Popover-e9JpRh11.js +439 -0
  176. package/dist/server/SearchableSelect-B2ZFnp6i.js +205 -0
  177. package/dist/server/SearchableSelect-BBu5cP6P.cjs +1 -0
  178. package/dist/server/{StatusBarNotificationBell-D8Jt3PXI.js → StatusBarNotificationBell-CJJFE4rf.js} +5043 -4698
  179. package/dist/server/StatusBarNotificationBell-Cxs_bVKX.cjs +49 -0
  180. package/dist/server/Stepper-C04rOZcI.cjs +1 -0
  181. package/dist/server/Stepper-CVAOsf3o.js +381 -0
  182. package/dist/server/{Textarea-BQf2lL59.cjs → Textarea-BG6F8taO.cjs} +1 -1
  183. package/dist/server/{Textarea-BTH48NET.js → Textarea-DM4zpgWo.js} +1 -1
  184. package/dist/server/TimeSeriesChart-kuuqH7we.js +242 -0
  185. package/dist/server/TimeSeriesChart-tWbSF6fJ.cjs +1 -0
  186. package/dist/server/ToggleButton-BdqufQ7G.js +1344 -0
  187. package/dist/server/ToggleButton-Bo24NK3o.cjs +1 -0
  188. package/dist/server/{VpTrash-Dlq8o6Uv.js → VpTrash-CZMWCIpF.js} +84 -70
  189. package/dist/server/VpTrash-DiczWhwm.cjs +1 -0
  190. package/dist/server/a11y/index.cjs +1 -1
  191. package/dist/server/a11y/index.js +1 -1
  192. package/dist/server/charts/index.cjs +1 -1
  193. package/dist/server/charts/index.js +1 -1
  194. package/dist/server/createDialogShellFocus-DvoNWpIu.cjs +1 -0
  195. package/dist/server/createDialogShellFocus-J8wqPlsa.js +370 -0
  196. package/dist/server/{createResizableSidebar-BImbKlLe.js → createResizableSidebar-CIrhLNKW.js} +104 -102
  197. package/dist/server/createResizableSidebar-DcZ2Cnpf.cjs +1 -0
  198. package/dist/server/desktop/index.cjs +1 -1
  199. package/dist/server/desktop/index.js +154 -153
  200. package/dist/server/dialogFocusRestore-BhxVTSiP.js +10 -0
  201. package/dist/server/dialogFocusRestore-DP5b1bDo.cjs +1 -0
  202. package/dist/server/feedback/index.cjs +1 -1
  203. package/dist/server/feedback/index.js +4 -4
  204. package/dist/server/{focusModality-nWNVX3JG.js → focusModality-Bu4Kuwm4.js} +1 -1
  205. package/dist/server/{focusModality-D-nxv8Er.cjs → focusModality-G2i60_7y.cjs} +1 -1
  206. package/dist/server/forms/index.cjs +1 -1
  207. package/dist/server/forms/index.js +9 -9
  208. package/dist/server/grid/index.cjs +1 -1
  209. package/dist/server/grid/index.js +1 -1
  210. package/dist/server/host/index.cjs +1 -1
  211. package/dist/server/host/index.js +38 -39
  212. package/dist/server/{index-UIjsx3oJ.js → index-CPUZyKo7.js} +3604 -3617
  213. package/dist/server/index-CVbkasNJ.cjs +1 -0
  214. package/dist/server/index.cjs +1 -1
  215. package/dist/server/index.js +656 -649
  216. package/dist/server/kitHost-BMMWpU4w.js +47 -0
  217. package/dist/server/kitHost-u0-mKvEK.cjs +1 -0
  218. package/dist/server/layout/index.cjs +1 -1
  219. package/dist/server/layout/index.js +2 -2
  220. package/dist/server/mainRealmDom-BuGEeM_r.cjs +1 -0
  221. package/dist/server/{EmptyState-Csydyy_7.js → mainRealmDom-CzckS_ss.js} +12 -8
  222. package/dist/server/navigation/index.cjs +1 -1
  223. package/dist/server/navigation/index.js +1 -1
  224. package/dist/server/notificationCatalog-CEDltsJS.cjs +1 -0
  225. package/dist/server/notificationCatalog-Cl1dH4aJ.js +122 -0
  226. package/dist/server/notifications/index.cjs +1 -1
  227. package/dist/server/notifications/index.js +55 -52
  228. package/dist/server/overlay/index.cjs +1 -1
  229. package/dist/server/overlay/index.js +72 -68
  230. package/dist/server/pageTourState-BuA-GBYO.cjs +5 -0
  231. package/dist/server/{pageTourState-BcBF8w89.js → pageTourState-DsSKdPOu.js} +160 -169
  232. package/dist/server/rowSource-C1F4l0xZ.cjs +1 -0
  233. package/dist/server/rowSource-CoeHYNsV.js +1123 -0
  234. package/dist/server/tokens/index.cjs +1 -1
  235. package/dist/server/tokens/index.js +29 -26
  236. package/dist/server/tokens/palette/index.cjs +1 -0
  237. package/dist/server/tokens/palette/index.js +31 -0
  238. package/dist/server/tree/index.cjs +1 -1
  239. package/dist/server/tree/index.js +1 -1
  240. package/dist/solid/_internal/app/onboarding/PageTourHost.jsx +11 -10
  241. package/dist/solid/_internal/app/onboarding/pageTourState.js +12 -23
  242. package/dist/solid/charts/TimeSeriesChart.jsx +23 -22
  243. package/dist/solid/desktop/WindowControls.jsx +6 -3
  244. package/dist/solid/feedback/Badge.jsx +12 -19
  245. package/dist/solid/feedback/ErrorBoundary.jsx +18 -14
  246. package/dist/solid/forms/Button.jsx +18 -23
  247. package/dist/solid/forms/Checkbox.jsx +5 -4
  248. package/dist/solid/forms/Combobox.jsx +12 -10
  249. package/dist/solid/forms/CopyButton.jsx +7 -4
  250. package/dist/solid/forms/DatePicker.jsx +12 -7
  251. package/dist/solid/forms/Dropzone.jsx +17 -13
  252. package/dist/solid/forms/FilePickerButton.jsx +5 -4
  253. package/dist/solid/forms/HiddenFileInput.jsx +3 -1
  254. package/dist/solid/forms/Input.jsx +31 -5
  255. package/dist/solid/forms/Input.module.css.js +1 -0
  256. package/dist/solid/forms/InputMessage.jsx +87 -0
  257. package/dist/solid/forms/MultiSearchableSelect.jsx +8 -7
  258. package/dist/solid/forms/NumberInput.jsx +25 -19
  259. package/dist/solid/forms/Picker.jsx +8 -6
  260. package/dist/solid/forms/PressableSurface.jsx +17 -23
  261. package/dist/solid/forms/RadioGroup.jsx +4 -3
  262. package/dist/solid/forms/SearchInput.jsx +4 -3
  263. package/dist/solid/forms/SearchableSelect.jsx +4 -3
  264. package/dist/solid/forms/SegmentedControl.jsx +4 -3
  265. package/dist/solid/forms/TagInput.jsx +22 -16
  266. package/dist/solid/forms/ToggleButton.jsx +4 -3
  267. package/dist/solid/forms/date-range-picker/DateRangePicker.jsx +12 -10
  268. package/dist/solid/grid/Pagination.jsx +7 -3
  269. package/dist/solid/host/kitHost.jsx +5 -1
  270. package/dist/solid/layout/PageHeaderIcon.jsx +11 -9
  271. package/dist/solid/layout/ResizableSplitPane.jsx +4 -4
  272. package/dist/solid/layout/ResizeHandle.jsx +15 -4
  273. package/dist/solid/layout/resizeCarry.js +31 -0
  274. package/dist/solid/navigation/Accordion.jsx +8 -5
  275. package/dist/solid/navigation/Tabs.jsx +11 -8
  276. package/dist/solid/notifications/NotificationHost.jsx +5 -18
  277. package/dist/solid/notifications/NotificationItem.jsx +62 -58
  278. package/dist/solid/notifications/NotificationPanel.jsx +27 -9
  279. package/dist/solid/notifications/NotificationsCenter.jsx +72 -12
  280. package/dist/solid/notifications/RunningProgressCards.jsx +1 -1
  281. package/dist/solid/notifications/StatusBarNotificationBell.jsx +12 -6
  282. package/dist/solid/notifications/catalogAdapter.js +1 -0
  283. package/dist/solid/notifications/createNotificationPreviewRuntime.js +2 -0
  284. package/dist/solid/notifications/fireNotification.js +21 -16
  285. package/dist/solid/notifications/holdWhileShown.js +30 -0
  286. package/dist/solid/notifications/index.js +1 -0
  287. package/dist/solid/notifications/nativeEngine.js +52 -1
  288. package/dist/solid/notifications/notificationEntryList.js +184 -0
  289. package/dist/solid/notifications/notificationService.js +20 -4
  290. package/dist/solid/notifications/toast.js +58 -7
  291. package/dist/solid/notifications/toastCorner.js +3 -0
  292. package/dist/solid/notifications/toastFilterPolicy.js +12 -0
  293. package/dist/solid/overlay/ConfirmDialog.jsx +21 -16
  294. package/dist/solid/overlay/DangerousActionDialogParts.jsx +5 -3
  295. package/dist/solid/overlay/Disclosure.jsx +4 -3
  296. package/dist/solid/overlay/Drawer.jsx +2 -1
  297. package/dist/solid/overlay/DropdownMenu.jsx +6 -4
  298. package/dist/solid/overlay/FloatingWindow.jsx +3 -3
  299. package/dist/solid/overlay/HoverTooltip.jsx +9 -7
  300. package/dist/solid/overlay/Modal.jsx +81 -34
  301. package/dist/solid/overlay/OverlayScrollArea.jsx +5 -3
  302. package/dist/solid/overlay/Tooltip.jsx +5 -4
  303. package/dist/solid/overlay/command-palette/CommandPalette.jsx +11 -11
  304. package/dist/solid/overlay/context-menu/DesktopContextMenu.jsx +73 -57
  305. package/dist/solid/overlay/index.js +2 -1
  306. package/dist/solid/overlay/menu/MenuParts.jsx +11 -8
  307. package/dist/solid/overlay/modalDefaults.jsx +10 -0
  308. package/dist/solid/overlay/modalViewport.js +17 -4
  309. package/dist/solid/overlay/nativeTitleHold.js +33 -0
  310. package/dist/solid/overlay/popover/Popover.jsx +17 -11
  311. package/dist/solid/overlay/tooltipDirective.js +3 -11
  312. package/dist/solid/overlay/tour/GuidedTour.jsx +18 -14
  313. package/dist/solid/tokens/index.js +1 -0
  314. package/dist/solid/tokens/palette/index.js +1 -0
  315. package/dist/solid/tokens/palette/paletteContract.js +27 -0
  316. package/dist/solid/tree/TreeRow.jsx +19 -16
  317. package/dist/solid/tree/TreeSurface.jsx +15 -14
  318. package/dist/solid/widgets/SettingsField.jsx +11 -10
  319. package/dist/style.css +4 -3
  320. package/dist/theme.css +3 -2
  321. package/dist/tokens/index.cjs +1 -1
  322. package/dist/tokens/index.d.cts +1 -0
  323. package/dist/tokens/index.d.ts +1 -0
  324. package/dist/tokens/index.js +29 -26
  325. package/dist/tokens/palette/index.cjs +1 -0
  326. package/dist/tokens/palette/index.d.cts +12 -0
  327. package/dist/tokens/palette/index.d.ts +12 -0
  328. package/dist/tokens/palette/index.js +31 -0
  329. package/dist/tokens/palette/paletteContract.d.cts +17 -0
  330. package/dist/tokens/palette/paletteContract.d.ts +17 -0
  331. package/dist/tokens/tokens.css +3 -2
  332. package/dist/tree/index.cjs +1 -1
  333. package/dist/tree/index.js +1 -1
  334. package/dist/ui.css +1 -1
  335. package/package.json +25 -1
  336. package/dist/AttributeGrid-CASILa4u.js +0 -320
  337. package/dist/AttributeGrid-eND8YDby.cjs +0 -1
  338. package/dist/Button-Bb68ymNP.cjs +0 -1
  339. package/dist/Button-D-T0tyGF.js +0 -305
  340. package/dist/CommandPalette-5FQRgPG9.cjs +0 -2
  341. package/dist/CommandPalette-Cj618AOz.js +0 -4017
  342. package/dist/CopyButton-B5gS2ft3.cjs +0 -1
  343. package/dist/CopyButton-g-WSiBDZ.js +0 -63
  344. package/dist/DateRangePicker-CJD9ADgB.js +0 -550
  345. package/dist/DateRangePicker-Frc0HVxp.cjs +0 -9
  346. package/dist/EmptyState-B9TxGJ5v.cjs +0 -1
  347. package/dist/EmptyState-Dph6HU74.js +0 -50
  348. package/dist/GuidedTour-B6q7lYhn.cjs +0 -1
  349. package/dist/GuidedTour-CFCvRJN4.js +0 -483
  350. package/dist/HostPortal-CgJwxt-f.cjs +0 -1
  351. package/dist/IconPicker-CIbJb1ei.cjs +0 -1
  352. package/dist/Input-CZruORyy.cjs +0 -1
  353. package/dist/Input-DkPhsdfk.js +0 -227
  354. package/dist/Modal-CY6ePolt.cjs +0 -1
  355. package/dist/Modal-NzZzHSwb.js +0 -559
  356. package/dist/OverlayScrollArea-BSlaXG1h.cjs +0 -1
  357. package/dist/OverlayScrollArea-c8Za77qs.js +0 -180
  358. package/dist/PageSkeleton-BPbb28-H.cjs +0 -30
  359. package/dist/Popover-CWrR51eG.cjs +0 -1
  360. package/dist/Popover-Cttb6NYT.js +0 -206
  361. package/dist/SearchableSelect-BvCm4enQ.js +0 -327
  362. package/dist/SearchableSelect-CVqdVMOC.cjs +0 -1
  363. package/dist/StatusBarNotificationBell-BJiORN4s.cjs +0 -50
  364. package/dist/Stepper-Ci5JpLbS.cjs +0 -1
  365. package/dist/Stepper-D9i1Xclm.js +0 -583
  366. package/dist/TimeSeriesChart-DOwi2lJs.js +0 -441
  367. package/dist/TimeSeriesChart-huvheefm.cjs +0 -1
  368. package/dist/ToggleButton-BFWh1_o5.cjs +0 -1
  369. package/dist/ToggleButton-CFM8P3JY.js +0 -2137
  370. package/dist/anchoredLayout-Dstwa5OH.cjs +0 -1
  371. package/dist/anchoredLayout-FC-qv8xm.js +0 -250
  372. package/dist/createDialogShellFocus-B4piXDU4.js +0 -282
  373. package/dist/createDialogShellFocus-CJaw9-B9.cjs +0 -1
  374. package/dist/createResizableSidebar-BDUlX9-G.js +0 -472
  375. package/dist/createResizableSidebar-BVJBU2kP.cjs +0 -1
  376. package/dist/dialogFocusRestore--dH59ER2.js +0 -35
  377. package/dist/dialogFocusRestore-CL-ExfAA.cjs +0 -1
  378. package/dist/kitHost-BfJExE1G.cjs +0 -1
  379. package/dist/kitHost-CVAEi9sF.js +0 -23
  380. package/dist/mainRealmDom-C12lr9lm.js +0 -171
  381. package/dist/mainRealmDom-S6teqEr4.cjs +0 -1
  382. package/dist/pageTourState-CrbEU7QW.cjs +0 -5
  383. package/dist/rowSource-D__7o4h0.js +0 -1230
  384. package/dist/rowSource-DiwTu_r8.cjs +0 -1
  385. package/dist/server/AttributeGrid-B7sb3btp.cjs +0 -1
  386. package/dist/server/AttributeGrid-CMi-UtWb.js +0 -281
  387. package/dist/server/Button-0AXWRw9Q.cjs +0 -1
  388. package/dist/server/Button-3yNrnn4P.js +0 -220
  389. package/dist/server/CommandPalette-CozogFlk.js +0 -3265
  390. package/dist/server/CommandPalette-DQK6N98N.cjs +0 -1
  391. package/dist/server/CopyButton-B6xd9Z6j.js +0 -64
  392. package/dist/server/CopyButton-D8IN6Vnd.cjs +0 -1
  393. package/dist/server/DateRangePicker-C35q8BTw.js +0 -484
  394. package/dist/server/DateRangePicker-KLZzyuPJ.cjs +0 -9
  395. package/dist/server/EmptyState-BnAHklc5.cjs +0 -1
  396. package/dist/server/GuidedTour-DfV0yzqh.cjs +0 -1
  397. package/dist/server/GuidedTour-DmLbBttx.js +0 -400
  398. package/dist/server/HostPortal-CgJwxt-f.cjs +0 -1
  399. package/dist/server/IconPicker-B1soopAp.cjs +0 -1
  400. package/dist/server/Input-CjvD8w18.cjs +0 -1
  401. package/dist/server/Input-DaEN2JJd.js +0 -127
  402. package/dist/server/Modal-BheFQLs1.js +0 -415
  403. package/dist/server/Modal-BswxV8Pn.cjs +0 -1
  404. package/dist/server/OverlayScrollArea-221dfKyz.js +0 -65
  405. package/dist/server/OverlayScrollArea-D4e9D9Nd.cjs +0 -1
  406. package/dist/server/PageSkeleton-DBo7hQq-.cjs +0 -30
  407. package/dist/server/Popover-BsxIKBbl.cjs +0 -1
  408. package/dist/server/Popover-Cg28aPUZ.js +0 -439
  409. package/dist/server/SearchableSelect-09ECcDlB.cjs +0 -1
  410. package/dist/server/SearchableSelect-vjhS4c-H.js +0 -205
  411. package/dist/server/StatusBarNotificationBell-LJHLMT9F.cjs +0 -49
  412. package/dist/server/Stepper-DxNrskdq.cjs +0 -1
  413. package/dist/server/Stepper-n5f9r-ye.js +0 -375
  414. package/dist/server/TimeSeriesChart-BQVXUFoj.cjs +0 -1
  415. package/dist/server/TimeSeriesChart-PAb95s6x.js +0 -242
  416. package/dist/server/ToggleButton-FywO2CCI.js +0 -1335
  417. package/dist/server/ToggleButton-TE3Xf2yD.cjs +0 -1
  418. package/dist/server/VpTrash-D49oUUJh.cjs +0 -1
  419. package/dist/server/createDialogShellFocus-BFo8awdj.js +0 -369
  420. package/dist/server/createDialogShellFocus-BiBAZOCI.cjs +0 -1
  421. package/dist/server/createResizableSidebar-GFgZIj-5.cjs +0 -1
  422. package/dist/server/dialogFocusRestore--dH59ER2.js +0 -35
  423. package/dist/server/dialogFocusRestore-CL-ExfAA.cjs +0 -1
  424. package/dist/server/index-2mQPVEDR.cjs +0 -1
  425. package/dist/server/kitHost-BfJExE1G.cjs +0 -1
  426. package/dist/server/kitHost-CVAEi9sF.js +0 -23
  427. package/dist/server/mainRealmDom-DPNaDWtw.js +0 -121
  428. package/dist/server/mainRealmDom-DwZVMPnO.cjs +0 -1
  429. package/dist/server/pageTourState-CrbEU7QW.cjs +0 -5
  430. package/dist/server/rowSource-D-wcDmFU.js +0 -1122
  431. package/dist/server/rowSource-DltiY0o3.cjs +0 -1
  432. package/dist/tooltipCoordinator-BzxEyKhA.js +0 -144
  433. package/dist/tooltipCoordinator-DslqMlsI.cjs +0 -1
@@ -0,0 +1,104 @@
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
+ * The mark of a notification list that is a focus target of its own — the panel's list, named and focusable like the
8
+ * reference's list (`base/browser/ui/list/listView.ts:410`, `listWidget.ts:1502`, `:1523`, `:1566-1571`): it holds the
9
+ * focus while it lists no notification ({@link focusFirstNotificationEntry}, {@link followNotificationListFocus}), and
10
+ * its keys start on its first or last notification ({@link moveNotificationEntryFocus}).
11
+ */
12
+ export declare const notificationListMark: {
13
+ readonly "data-notification-list": "";
14
+ };
15
+ /**
16
+ * Moves the focus to the first entry of the notification center or panel drawn under `root` — a running progress
17
+ * card, else the newest record —, as the reference's center does when it is shown; when `root` lists no entry, to the
18
+ * list itself where the list is a focus target of its own (a `NotificationPanel`'s list), as the reference focuses its
19
+ * empty list (`workbench/browser/parts/notifications/notificationsList.ts:227-233`). Whether that element now holds the
20
+ * focus: `false` when `root` draws neither — a `NotificationsCenter` that lists nothing, which focuses itself —, or when
21
+ * the element could not take the focus (an inert or hidden subtree); the caller then focuses what it shows instead.
22
+ */
23
+ export declare function focusFirstNotificationEntry(root: ParentNode, options?: FocusOptions): boolean;
24
+ /**
25
+ * What Page Up and Page Down do on a surface — the one row of the key table that differs between them:
26
+ * - `'ends'`, the toast stack: the first and the last toast, as Home and End — the reference binds its first-toast and
27
+ * last-toast commands to Page Up and Page Down, with Home and End as their second keys
28
+ * (`workbench/browser/parts/notifications/notificationsCommands.ts:248-270`);
29
+ * - a function, a scrolled list: the entry a page away from `current` toward `direction`, read from the list's
30
+ * geometry ({@link notificationListPageStep}), as the reference's list pages (`listCommands.ts:143-167`).
31
+ */
32
+ export type NotificationListPaging = 'ends' | ((current: number | null, direction: -1 | 1) => number);
33
+ /**
34
+ * A list's own keys — one table for the toast stack and the notification lists: Down moves to the next entry, Up to
35
+ * the previous one, without wrapping (`listCommands.ts:75-107`); Home goes to the first, End to the last
36
+ * (`listCommands.ts:169-193`); Page Up and Page Down are the surface's `paging`. From no focused entry (`current`
37
+ * null) Down starts at the first and Up at the last. `null` for any other key and for an empty list.
38
+ */
39
+ export declare function notificationListFocusStep(event: {
40
+ readonly key: string;
41
+ }, current: number | null, count: number, paging: NotificationListPaging): number | null;
42
+ /** Where a scrolled list's entries lie and how much of them shows: what a page step reads. */
43
+ export interface NotificationListPage {
44
+ /** Each entry's top and bottom, in pixels down from the top of the scrolled content, in drawing order. */
45
+ readonly extents: readonly {
46
+ readonly top: number;
47
+ readonly bottom: number;
48
+ }[];
49
+ /** How far the content is scrolled. */
50
+ readonly scrollTop: number;
51
+ /** The height that shows. */
52
+ readonly height: number;
53
+ /** The furthest the content scrolls. */
54
+ readonly maxScrollTop: number;
55
+ }
56
+ /**
57
+ * The entry a Page key moves to in a scrolled list, as the reference's list pages (`base/browser/ui/list/
58
+ * listWidget.ts:1836-1902`): Page Down goes to the last entry that ends inside the page that shows, and from there to
59
+ * the last that ends inside the page below; Page Up goes to the first entry that starts inside the page that shows,
60
+ * and from there to the first that starts inside the page above. At either end of the content the focus stays. The
61
+ * step never goes against its key and always moves while an entry lies beyond the focus, so an entry taller than the
62
+ * page is still reached.
63
+ */
64
+ export declare function notificationListPageStep(page: NotificationListPage, current: number | null, direction: -1 | 1): number;
65
+ /**
66
+ * The list keys of a center's entries, for the `keydown` of the scrolled element that holds them (`viewport`): from an
67
+ * entry, or from a control inside one, the key moves the focus along the entries {@link notificationListFocusStep},
68
+ * a page at a time for Page Up and Page Down, and the entry that takes it is scrolled just into view, as the
69
+ * reference reveals its list's focus (`listCommands.ts:58-73`; `listWidget.ts:1985-1996`). From the list itself — a
70
+ * list that is a focus target of its own ({@link notificationListMark}) and holds the focus — the step starts from no
71
+ * entry: Down goes to the first, Up to the last. A key aimed elsewhere, one an editable element takes, or one already
72
+ * handled is left alone.
73
+ */
74
+ export declare function moveNotificationEntryFocus(event: KeyboardEvent, viewport: HTMLElement): void;
75
+ /** What a notification list that follows its focus tells its owner. */
76
+ export interface NotificationListFocus {
77
+ /**
78
+ * Whether the keyboard focus is in the list: set when the focus enters it, cleared when the focus moves to an element
79
+ * outside it (`focusin`). It still holds after the element that had the focus went away with its entry — the
80
+ * reference measures "the center had the focus" before the removal (`notificationsCenter.ts:344-346`) —, so an owner
81
+ * that hands the focus back when the list closes reads it rather than where the focus fell.
82
+ */
83
+ readonly holdsFocus: () => boolean;
84
+ }
85
+ export interface NotificationListFocusOptions {
86
+ /** The element whose focus is followed: a center, a panel's list. */
87
+ readonly container: () => HTMLElement | undefined;
88
+ /** Reads what the list draws — tracked: the focus is checked once each change has been drawn. */
89
+ readonly drawn: () => unknown;
90
+ /** Focuses the list's own target when no entry is left to take the focus. */
91
+ readonly fallback: (container: HTMLElement) => void;
92
+ }
93
+ /**
94
+ * Keeps the keyboard focus in a notification list whose entries change under it, as the reference's list does
95
+ * (`notificationsList.ts:149-199`): the entry that held the focus keeps it when it is still drawn; when it went away,
96
+ * the focus goes to the entry before it — the first when it was the first —, and to the list's own target when no
97
+ * entry is left. Call it in the component's setup.
98
+ */
99
+ export declare function followNotificationListFocus(options: NotificationListFocusOptions): NotificationListFocus;
100
+ /**
101
+ * A record's accessible name — its severity, its message and its source, as the reference names a notification of
102
+ * its list (`notificationsList.ts:271-283`).
103
+ */
104
+ export declare function timelineEntryAriaLabel(entry: NotificationTimelineEntry): string;
@@ -0,0 +1,104 @@
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
+ * The mark of a notification list that is a focus target of its own — the panel's list, named and focusable like the
8
+ * reference's list (`base/browser/ui/list/listView.ts:410`, `listWidget.ts:1502`, `:1523`, `:1566-1571`): it holds the
9
+ * focus while it lists no notification ({@link focusFirstNotificationEntry}, {@link followNotificationListFocus}), and
10
+ * its keys start on its first or last notification ({@link moveNotificationEntryFocus}).
11
+ */
12
+ export declare const notificationListMark: {
13
+ readonly "data-notification-list": "";
14
+ };
15
+ /**
16
+ * Moves the focus to the first entry of the notification center or panel drawn under `root` — a running progress
17
+ * card, else the newest record —, as the reference's center does when it is shown; when `root` lists no entry, to the
18
+ * list itself where the list is a focus target of its own (a `NotificationPanel`'s list), as the reference focuses its
19
+ * empty list (`workbench/browser/parts/notifications/notificationsList.ts:227-233`). Whether that element now holds the
20
+ * focus: `false` when `root` draws neither — a `NotificationsCenter` that lists nothing, which focuses itself —, or when
21
+ * the element could not take the focus (an inert or hidden subtree); the caller then focuses what it shows instead.
22
+ */
23
+ export declare function focusFirstNotificationEntry(root: ParentNode, options?: FocusOptions): boolean;
24
+ /**
25
+ * What Page Up and Page Down do on a surface — the one row of the key table that differs between them:
26
+ * - `'ends'`, the toast stack: the first and the last toast, as Home and End — the reference binds its first-toast and
27
+ * last-toast commands to Page Up and Page Down, with Home and End as their second keys
28
+ * (`workbench/browser/parts/notifications/notificationsCommands.ts:248-270`);
29
+ * - a function, a scrolled list: the entry a page away from `current` toward `direction`, read from the list's
30
+ * geometry ({@link notificationListPageStep}), as the reference's list pages (`listCommands.ts:143-167`).
31
+ */
32
+ export type NotificationListPaging = 'ends' | ((current: number | null, direction: -1 | 1) => number);
33
+ /**
34
+ * A list's own keys — one table for the toast stack and the notification lists: Down moves to the next entry, Up to
35
+ * the previous one, without wrapping (`listCommands.ts:75-107`); Home goes to the first, End to the last
36
+ * (`listCommands.ts:169-193`); Page Up and Page Down are the surface's `paging`. From no focused entry (`current`
37
+ * null) Down starts at the first and Up at the last. `null` for any other key and for an empty list.
38
+ */
39
+ export declare function notificationListFocusStep(event: {
40
+ readonly key: string;
41
+ }, current: number | null, count: number, paging: NotificationListPaging): number | null;
42
+ /** Where a scrolled list's entries lie and how much of them shows: what a page step reads. */
43
+ export interface NotificationListPage {
44
+ /** Each entry's top and bottom, in pixels down from the top of the scrolled content, in drawing order. */
45
+ readonly extents: readonly {
46
+ readonly top: number;
47
+ readonly bottom: number;
48
+ }[];
49
+ /** How far the content is scrolled. */
50
+ readonly scrollTop: number;
51
+ /** The height that shows. */
52
+ readonly height: number;
53
+ /** The furthest the content scrolls. */
54
+ readonly maxScrollTop: number;
55
+ }
56
+ /**
57
+ * The entry a Page key moves to in a scrolled list, as the reference's list pages (`base/browser/ui/list/
58
+ * listWidget.ts:1836-1902`): Page Down goes to the last entry that ends inside the page that shows, and from there to
59
+ * the last that ends inside the page below; Page Up goes to the first entry that starts inside the page that shows,
60
+ * and from there to the first that starts inside the page above. At either end of the content the focus stays. The
61
+ * step never goes against its key and always moves while an entry lies beyond the focus, so an entry taller than the
62
+ * page is still reached.
63
+ */
64
+ export declare function notificationListPageStep(page: NotificationListPage, current: number | null, direction: -1 | 1): number;
65
+ /**
66
+ * The list keys of a center's entries, for the `keydown` of the scrolled element that holds them (`viewport`): from an
67
+ * entry, or from a control inside one, the key moves the focus along the entries {@link notificationListFocusStep},
68
+ * a page at a time for Page Up and Page Down, and the entry that takes it is scrolled just into view, as the
69
+ * reference reveals its list's focus (`listCommands.ts:58-73`; `listWidget.ts:1985-1996`). From the list itself — a
70
+ * list that is a focus target of its own ({@link notificationListMark}) and holds the focus — the step starts from no
71
+ * entry: Down goes to the first, Up to the last. A key aimed elsewhere, one an editable element takes, or one already
72
+ * handled is left alone.
73
+ */
74
+ export declare function moveNotificationEntryFocus(event: KeyboardEvent, viewport: HTMLElement): void;
75
+ /** What a notification list that follows its focus tells its owner. */
76
+ export interface NotificationListFocus {
77
+ /**
78
+ * Whether the keyboard focus is in the list: set when the focus enters it, cleared when the focus moves to an element
79
+ * outside it (`focusin`). It still holds after the element that had the focus went away with its entry — the
80
+ * reference measures "the center had the focus" before the removal (`notificationsCenter.ts:344-346`) —, so an owner
81
+ * that hands the focus back when the list closes reads it rather than where the focus fell.
82
+ */
83
+ readonly holdsFocus: () => boolean;
84
+ }
85
+ export interface NotificationListFocusOptions {
86
+ /** The element whose focus is followed: a center, a panel's list. */
87
+ readonly container: () => HTMLElement | undefined;
88
+ /** Reads what the list draws — tracked: the focus is checked once each change has been drawn. */
89
+ readonly drawn: () => unknown;
90
+ /** Focuses the list's own target when no entry is left to take the focus. */
91
+ readonly fallback: (container: HTMLElement) => void;
92
+ }
93
+ /**
94
+ * Keeps the keyboard focus in a notification list whose entries change under it, as the reference's list does
95
+ * (`notificationsList.ts:149-199`): the entry that held the focus keeps it when it is still drawn; when it went away,
96
+ * the focus goes to the entry before it — the first when it was the first —, and to the list's own target when no
97
+ * entry is left. Call it in the component's setup.
98
+ */
99
+ export declare function followNotificationListFocus(options: NotificationListFocusOptions): NotificationListFocus;
100
+ /**
101
+ * A record's accessible name — its severity, its message and its source, as the reference names a notification of
102
+ * its list (`notificationsList.ts:271-283`).
103
+ */
104
+ 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';
@@ -0,0 +1,8 @@
1
+ import type { ToastPosition } from '../_internal/platform/settings/settingsTypes.js';
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';
@@ -22,7 +22,23 @@
22
22
  * cannot import from the app anyway, so this is not a stylistic choice but a structural
23
23
  * necessity.
24
24
  */
25
- import type { NotificationPriority } from '../_internal/contract/notification.cjs';
25
+ import type { NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.cjs';
26
+ /**
27
+ * A run-time notification filter — not a setting: a host sets it while a state of its own lasts and turns it off
28
+ * after, and nothing of it is stored (the reference's `NotificationsFilter`).
29
+ * - `'off'`: every notification is decided by the settings alone.
30
+ * - `'errors-only'`: the reference's error filter, the one its Zen mode sets while `zenMode.silentNotifications` is on
31
+ * (`workbench/browser/layout.ts:1485`, `:1513-1515`, `:1549-1555`, `:1592-1594`): a notification of the default or
32
+ * the optional priority that is not an error is silent — recorded, no toast (`workbench/common/notifications.ts:
33
+ * 494-502`). Errors, urgent notifications and acknowledgments still toast.
34
+ */
35
+ export type NotificationFilter = 'off' | 'errors-only';
36
+ /**
37
+ * The priority an issue is decided under the run-time filter: the reference's error filter makes a default or optional
38
+ * notification that is not an error silent, the priority the decision already knows — one rule, no second silencing
39
+ * path. The notification keeps the priority it was issued with everywhere else (its record, its card).
40
+ */
41
+ export declare function filteredPriority(priority: NotificationPriority, severity: NotificationSeverity, filter: NotificationFilter): NotificationPriority;
26
42
  export interface FilterDecision {
27
43
  showToast: boolean;
28
44
  recordTimeline: boolean;
@@ -60,4 +76,20 @@ export interface ToastFilterInput {
60
76
  * apart, "remind me later" would silently silence nothing.
61
77
  */
62
78
  export declare function deriveImplicitRemindKey(source: string, title: string): string;
79
+ /** What a card's "remind me later" keys on — its fields that name the notification. */
80
+ export interface RemindKeySource {
81
+ /** The key the card carries: its issuer's (`ToastCommonOptions.remindKey`), or the one a progress was issued with. */
82
+ readonly remindKey?: string | undefined;
83
+ readonly neverShowAgainKey?: string | undefined;
84
+ readonly source?: string | undefined;
85
+ readonly title: string;
86
+ }
87
+ /**
88
+ * The key "remind me later" on a card silences: the key the card carries, else its "don't show again" key, else the
89
+ * key derived from its source and title.
90
+ *
91
+ * ⚠ SINGLE HOME: the card's gear menu writes this key and the check that a running card was turned down reads it; two
92
+ * copies drifting apart would silence nothing.
93
+ */
94
+ export declare function cardRemindKey(card: RemindKeySource): string;
63
95
  export declare function decideFilter(input: ToastFilterInput, settings: ToastFilterSettings, gates: ToastFilterGates): FilterDecision;
@@ -22,7 +22,23 @@
22
22
  * cannot import from the app anyway, so this is not a stylistic choice but a structural
23
23
  * necessity.
24
24
  */
25
- import type { NotificationPriority } from '../_internal/contract/notification.js';
25
+ import type { NotificationPriority, NotificationSeverity } from '../_internal/contract/notification.js';
26
+ /**
27
+ * A run-time notification filter — not a setting: a host sets it while a state of its own lasts and turns it off
28
+ * after, and nothing of it is stored (the reference's `NotificationsFilter`).
29
+ * - `'off'`: every notification is decided by the settings alone.
30
+ * - `'errors-only'`: the reference's error filter, the one its Zen mode sets while `zenMode.silentNotifications` is on
31
+ * (`workbench/browser/layout.ts:1485`, `:1513-1515`, `:1549-1555`, `:1592-1594`): a notification of the default or
32
+ * the optional priority that is not an error is silent — recorded, no toast (`workbench/common/notifications.ts:
33
+ * 494-502`). Errors, urgent notifications and acknowledgments still toast.
34
+ */
35
+ export type NotificationFilter = 'off' | 'errors-only';
36
+ /**
37
+ * The priority an issue is decided under the run-time filter: the reference's error filter makes a default or optional
38
+ * notification that is not an error silent, the priority the decision already knows — one rule, no second silencing
39
+ * path. The notification keeps the priority it was issued with everywhere else (its record, its card).
40
+ */
41
+ export declare function filteredPriority(priority: NotificationPriority, severity: NotificationSeverity, filter: NotificationFilter): NotificationPriority;
26
42
  export interface FilterDecision {
27
43
  showToast: boolean;
28
44
  recordTimeline: boolean;
@@ -60,4 +76,20 @@ export interface ToastFilterInput {
60
76
  * apart, "remind me later" would silently silence nothing.
61
77
  */
62
78
  export declare function deriveImplicitRemindKey(source: string, title: string): string;
79
+ /** What a card's "remind me later" keys on — its fields that name the notification. */
80
+ export interface RemindKeySource {
81
+ /** The key the card carries: its issuer's (`ToastCommonOptions.remindKey`), or the one a progress was issued with. */
82
+ readonly remindKey?: string | undefined;
83
+ readonly neverShowAgainKey?: string | undefined;
84
+ readonly source?: string | undefined;
85
+ readonly title: string;
86
+ }
87
+ /**
88
+ * The key "remind me later" on a card silences: the key the card carries, else its "don't show again" key, else the
89
+ * key derived from its source and title.
90
+ *
91
+ * ⚠ SINGLE HOME: the card's gear menu writes this key and the check that a running card was turned down reads it; two
92
+ * copies drifting apart would silence nothing.
93
+ */
94
+ export declare function cardRemindKey(card: RemindKeySource): string;
63
95
  export declare function decideFilter(input: ToastFilterInput, settings: ToastFilterSettings, gates: ToastFilterGates): FilterDecision;
@@ -22,11 +22,30 @@ export interface ModalProps {
22
22
  * Defaults to true (unless embedded is true).
23
23
  */
24
24
  allowMaximize?: boolean;
25
+ /**
26
+ * This modal's own title bar height (any CSS length) — an override. The height has one home, set
27
+ * ONCE per window: the host writes `--modal-maximize-inset` on each window's root (`:root`, or
28
+ * `document.documentElement.style`; `2.875rem` when it sets none, `'0px'` for a page without a
29
+ * title bar). Every modal reads it — the maximized layout (right under the title bar), the normal
30
+ * layout's top gap and height, and the drag bound (`modalTitlebarHeight`) —, as the reference
31
+ * reads one title bar offset (`workbench/browser/parts/editor/modalEditorPart.ts:493-509`, `:671`,
32
+ * `:702`, `:707`). This prop sets it on this modal's overlay only.
33
+ */
34
+ maximizeInset?: string | undefined;
25
35
  /**
26
36
  * Allow dragging the modal by its header using pointer events.
27
37
  * Defaults to true (unless embedded is true or allowDrag is false).
28
38
  */
29
39
  allowDrag?: boolean;
40
+ /**
41
+ * Allow pulling a MAXIMIZED modal off the top by its header: it returns to its size under the pointer and the drag
42
+ * carries on, like a desktop window (it needs `allowDrag` and `allowMaximize`, and no `embedded`). `false` keeps a
43
+ * maximized modal in place, as the reference's modal editor does — no drag while maximized
44
+ * (`workbench/browser/parts/editor/modalEditorPart.ts:456-459`); the Restore button and a double-click on the header
45
+ * still restore it. A host sets it once for every modal of a root — `KitHostProvider`'s `modals` option
46
+ * (`ModalDefaults`); this prop overrides it for one modal. With neither, `true`.
47
+ */
48
+ allowMaximizedDrag?: boolean | undefined;
30
49
  /**
31
50
  * Renders full-bleed (no backdrop, no centering, no `open()` gate) so this
32
51
  * content fills its container 1:1. Used when the modal is popped into its
@@ -22,11 +22,30 @@ export interface ModalProps {
22
22
  * Defaults to true (unless embedded is true).
23
23
  */
24
24
  allowMaximize?: boolean;
25
+ /**
26
+ * This modal's own title bar height (any CSS length) — an override. The height has one home, set
27
+ * ONCE per window: the host writes `--modal-maximize-inset` on each window's root (`:root`, or
28
+ * `document.documentElement.style`; `2.875rem` when it sets none, `'0px'` for a page without a
29
+ * title bar). Every modal reads it — the maximized layout (right under the title bar), the normal
30
+ * layout's top gap and height, and the drag bound (`modalTitlebarHeight`) —, as the reference
31
+ * reads one title bar offset (`workbench/browser/parts/editor/modalEditorPart.ts:493-509`, `:671`,
32
+ * `:702`, `:707`). This prop sets it on this modal's overlay only.
33
+ */
34
+ maximizeInset?: string | undefined;
25
35
  /**
26
36
  * Allow dragging the modal by its header using pointer events.
27
37
  * Defaults to true (unless embedded is true or allowDrag is false).
28
38
  */
29
39
  allowDrag?: boolean;
40
+ /**
41
+ * Allow pulling a MAXIMIZED modal off the top by its header: it returns to its size under the pointer and the drag
42
+ * carries on, like a desktop window (it needs `allowDrag` and `allowMaximize`, and no `embedded`). `false` keeps a
43
+ * maximized modal in place, as the reference's modal editor does — no drag while maximized
44
+ * (`workbench/browser/parts/editor/modalEditorPart.ts:456-459`); the Restore button and a double-click on the header
45
+ * still restore it. A host sets it once for every modal of a root — `KitHostProvider`'s `modals` option
46
+ * (`ModalDefaults`); this prop overrides it for one modal. With neither, `true`.
47
+ */
48
+ allowMaximizedDrag?: boolean | undefined;
30
49
  /**
31
50
  * Renders full-bleed (no backdrop, no centering, no `open()` gate) so this
32
51
  * content fills its container 1:1. Used when the modal is popped into its
@@ -28,8 +28,12 @@
28
28
  * closing the inner restores exactly that and nothing else. An element the page
29
29
  * had already marked inert for its own reasons is never un-marked.
30
30
  */
31
- /** Surfaces that stay live above every modal: the notification stack and the app live region. */
32
- export type ModalBackgroundExemption = 'notifications' | 'live-region';
31
+ /**
32
+ * Surfaces that stay live above every modal: the notification stack and the app live region. A
33
+ * `dialog-backdrop` is the click-away layer a dialog draws beside itself (a drawer's): it is not
34
+ * background, it is part of the dialog, and inerting it would make clicking outside do nothing.
35
+ */
36
+ export type ModalBackgroundExemption = 'notifications' | 'live-region' | 'dialog-backdrop';
33
37
  declare const EXEMPTION_ATTRIBUTE = "data-modal-background-exempt";
34
38
  /**
35
39
  * Spread onto the root element of a surface that must stay live while a modal is
@@ -28,8 +28,12 @@
28
28
  * closing the inner restores exactly that and nothing else. An element the page
29
29
  * had already marked inert for its own reasons is never un-marked.
30
30
  */
31
- /** Surfaces that stay live above every modal: the notification stack and the app live region. */
32
- export type ModalBackgroundExemption = 'notifications' | 'live-region';
31
+ /**
32
+ * Surfaces that stay live above every modal: the notification stack and the app live region. A
33
+ * `dialog-backdrop` is the click-away layer a dialog draws beside itself (a drawer's): it is not
34
+ * background, it is part of the dialog, and inerting it would make clicking outside do nothing.
35
+ */
36
+ export type ModalBackgroundExemption = 'notifications' | 'live-region' | 'dialog-backdrop';
33
37
  declare const EXEMPTION_ATTRIBUTE = "data-modal-background-exempt";
34
38
  /**
35
39
  * Spread onto the root element of a surface that must stay live while a modal is
@@ -51,7 +51,19 @@ interface CommandPaletteProps {
51
51
  commands: CommandPaletteCommand[];
52
52
  recentCommandIds: string[];
53
53
  style: CommandPaletteStyle;
54
+ /**
55
+ * Closes the palette: the host turns `open` false — and must do it before `onClose` returns. The palette calls it
56
+ * BEFORE it runs a pick (a command, a submenu row, the "Configure Keybinding" gear), and its close — the focus
57
+ * handed back, the background's inertness lifted — runs as `open` turns false; the pick runs right after and may
58
+ * move the focus. A close that lands later — deferred to a microtask, a timer or a transition, or written inside a
59
+ * `batch` that is still open — lets the pick run under the open palette, and the late close takes the focus back
60
+ * from it.
61
+ */
54
62
  onClose: () => void;
63
+ /**
64
+ * Called with the id of the command a pick runs — for a submenu's row, the command that opened the submenu —, after
65
+ * `onClose` and before the pick runs.
66
+ */
55
67
  onCommandExecuted: (commandId: string) => void;
56
68
  /**
57
69
  * When the palette opens, returns an action id whose submenu should be
@@ -51,7 +51,19 @@ interface CommandPaletteProps {
51
51
  commands: CommandPaletteCommand[];
52
52
  recentCommandIds: string[];
53
53
  style: CommandPaletteStyle;
54
+ /**
55
+ * Closes the palette: the host turns `open` false — and must do it before `onClose` returns. The palette calls it
56
+ * BEFORE it runs a pick (a command, a submenu row, the "Configure Keybinding" gear), and its close — the focus
57
+ * handed back, the background's inertness lifted — runs as `open` turns false; the pick runs right after and may
58
+ * move the focus. A close that lands later — deferred to a microtask, a timer or a transition, or written inside a
59
+ * `batch` that is still open — lets the pick run under the open palette, and the late close takes the focus back
60
+ * from it.
61
+ */
54
62
  onClose: () => void;
63
+ /**
64
+ * Called with the id of the command a pick runs — for a submenu's row, the command that opened the submenu —, after
65
+ * `onClose` and before the pick runs.
66
+ */
55
67
  onCommandExecuted: (commandId: string) => void;
56
68
  /**
57
69
  * When the palette opens, returns an action id whose submenu should be