@vokril/ui-solid 0.9.3 → 0.17.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 (607) hide show
  1. package/CHANGELOG.md +69 -0
  2. package/README.md +110 -31
  3. package/dist/{AttributeGrid-Bnn1w5XX.cjs → AttributeGrid-7cLOWtPn.cjs} +1 -1
  4. package/dist/{AttributeGrid-DJdW32LQ.js → AttributeGrid-CVyqzT7-.js} +5 -5
  5. package/dist/{Button-BZWXPn8y.js → Button-BiKPB3cH.js} +2 -2
  6. package/dist/{Button-X8QR6llv.cjs → Button-Nx7byQZc.cjs} +1 -1
  7. package/dist/CommandPalette-BFi0_e3t.cjs +2 -0
  8. package/dist/CommandPalette-CAH08DGN.js +4013 -0
  9. package/dist/{CopyButton-D3dIRRnn.js → CopyButton-BF7L1TCO.js} +1 -1
  10. package/dist/{CopyButton-3cX5MHAf.cjs → CopyButton-BtgGbiy9.cjs} +1 -1
  11. package/dist/DateRangePicker-Ce2tTbJ4.cjs +9 -0
  12. package/dist/{DateRangePicker-BcqoUao4.js → DateRangePicker-jSQBwB78.js} +181 -166
  13. package/dist/GuidedTour-CWDtBRHv.js +483 -0
  14. package/dist/GuidedTour-CYaR5Ozj.cjs +1 -0
  15. package/dist/HostPortal-B9Tzk_uN.cjs +1 -0
  16. package/dist/HostPortal-X1iw719T.js +33 -0
  17. package/dist/HostWindowContext-B2m0bVra.js +32 -0
  18. package/dist/HostWindowContext-_VZCt7xE.cjs +1 -0
  19. package/dist/{IconPicker-9tjEtmqt.cjs → IconPicker-4bdAeGxS.cjs} +1 -1
  20. package/dist/{IconPicker-CXbFmJ3y.js → IconPicker-Df6uIUpJ.js} +4 -4
  21. package/dist/{Input-BEnk4FCF.cjs → Input-CZruORyy.cjs} +1 -1
  22. package/dist/{Input-PZ5wRvPx.js → Input-DkPhsdfk.js} +2 -2
  23. package/dist/Modal-CQG8l4x7.cjs +1 -0
  24. package/dist/{Modal-CsiV55WW.js → Modal-CUPe98-o.js} +5 -5
  25. package/dist/PageSkeleton-C3mo6UGh.cjs +30 -0
  26. package/dist/{PageSkeleton-CyTXvZYm.js → PageSkeleton-CUTLh9Ip.js} +630 -628
  27. package/dist/{Popover-C24npAQ7.js → Popover-Dht1jFEy.js} +1 -1
  28. package/dist/{Popover-hhGcYQ-a.cjs → Popover-YfzC0Tjh.cjs} +1 -1
  29. package/dist/{SearchableSelect-C6KL7e42.js → SearchableSelect-C01brsF0.js} +5 -5
  30. package/dist/{SearchableSelect-zT8XNpmt.cjs → SearchableSelect-pCaUie2M.cjs} +1 -1
  31. package/dist/StatusBarNotificationBell-BwqVV09r.js +14266 -0
  32. package/dist/StatusBarNotificationBell-C5Zc2IvW.cjs +50 -0
  33. package/dist/{Stepper-BxXwbDq4.js → Stepper-38IAEOyT.js} +3 -3
  34. package/dist/{Stepper-DoJFCfC7.cjs → Stepper-CtaTpnQu.cjs} +1 -1
  35. package/dist/{Textarea-BUxibzkR.js → Textarea-B5QqqKnI.js} +1 -1
  36. package/dist/{Textarea-BunKEY68.cjs → Textarea-CeAGf08O.cjs} +1 -1
  37. package/dist/{TimeSeriesChart-DBrDzBGE.js → TimeSeriesChart-ByKG4E1G.js} +2 -2
  38. package/dist/{TimeSeriesChart-CS4jQflv.cjs → TimeSeriesChart-_NOs_Job.cjs} +1 -1
  39. package/dist/ToggleButton-Bz3zAtec.cjs +1 -0
  40. package/dist/{ToggleButton-BfjXnp-P.js → ToggleButton-D-N0C2Fu.js} +54 -53
  41. package/dist/_internal/app/keybindings/context/keybindingsContext.d.cts +11 -6
  42. package/dist/_internal/app/keybindings/context/keybindingsContext.d.ts +11 -6
  43. package/dist/_internal/app/keybindings/context/useFocusClaim.d.cts +4 -3
  44. package/dist/_internal/app/keybindings/context/useFocusClaim.d.ts +4 -3
  45. package/dist/_internal/app/keybindings/context/useListCommands.d.cts +6 -5
  46. package/dist/_internal/app/keybindings/context/useListCommands.d.ts +6 -5
  47. package/dist/_internal/app/keybindings/index.d.cts +0 -10
  48. package/dist/_internal/app/keybindings/index.d.ts +0 -10
  49. package/dist/_internal/app/keybindings/panelCommandsRegistry.d.cts +14 -9
  50. package/dist/_internal/app/keybindings/panelCommandsRegistry.d.ts +14 -9
  51. package/dist/_internal/app/menu/menuFavorites.d.cts +35 -8
  52. package/dist/_internal/app/menu/menuFavorites.d.ts +35 -8
  53. package/dist/_internal/app/onboarding/pageTourState.d.cts +75 -22
  54. package/dist/_internal/app/onboarding/pageTourState.d.ts +75 -22
  55. package/dist/_internal/app/platform/electronBridge.d.cts +35 -29
  56. package/dist/_internal/app/platform/electronBridge.d.ts +35 -29
  57. package/dist/_internal/app/settings/secrets/notificationSecrets.d.cts +27 -14
  58. package/dist/_internal/app/settings/secrets/notificationSecrets.d.ts +27 -14
  59. package/dist/_internal/app/windows/window/HostWindowContext.d.cts +8 -14
  60. package/dist/_internal/app/windows/window/HostWindowContext.d.ts +8 -14
  61. package/dist/_internal/contract/catalogNotify.d.cts +6 -19
  62. package/dist/_internal/contract/catalogNotify.d.ts +6 -19
  63. package/dist/_internal/contract/hostErrorText.d.cts +13 -23
  64. package/dist/_internal/contract/hostErrorText.d.ts +13 -23
  65. package/dist/_internal/contract/notificationCatalog.d.cts +16 -5
  66. package/dist/_internal/contract/notificationCatalog.d.ts +16 -5
  67. package/dist/_internal/platform/a11y/announcerService.d.cts +9 -13
  68. package/dist/_internal/platform/a11y/announcerService.d.ts +9 -13
  69. package/dist/_internal/platform/errors/diagnosticReport.d.cts +3 -1
  70. package/dist/_internal/platform/errors/diagnosticReport.d.ts +3 -1
  71. package/dist/_internal/platform/logging/consoleLogger.d.cts +7 -0
  72. package/dist/_internal/platform/logging/consoleLogger.d.ts +7 -0
  73. package/dist/_internal/platform/settings/registry/defineSettings.d.cts +19 -8
  74. package/dist/_internal/platform/settings/registry/defineSettings.d.ts +19 -8
  75. package/dist/_internal/platform/settings/registry/stateDbStore.d.cts +23 -15
  76. package/dist/_internal/platform/settings/registry/stateDbStore.d.ts +23 -15
  77. package/dist/_internal/platform/settings/settingsTypes.d.cts +0 -5
  78. package/dist/_internal/platform/settings/settingsTypes.d.ts +0 -5
  79. package/dist/_internal/platform/vendorErrors/index.d.cts +7 -17
  80. package/dist/_internal/platform/vendorErrors/index.d.ts +7 -17
  81. package/dist/_internal/platform/window/displayOwner.d.cts +35 -14
  82. package/dist/_internal/platform/window/displayOwner.d.ts +35 -14
  83. package/dist/a11y/index.cjs +1 -1
  84. package/dist/a11y/index.js +1 -1
  85. package/dist/actions-DtaFGwh2.cjs +1 -0
  86. package/dist/actions-wwAHs3ZU.js +16 -0
  87. package/dist/{server/appThemeDerivation-BiCyiSuz.js → appThemeDerivation-B7-DjMIM.js} +181 -184
  88. package/dist/appThemeDerivation-NS3Vws8q.cjs +1 -0
  89. package/dist/async/createGuardedListLoader.d.cts +3 -0
  90. package/dist/async/createGuardedListLoader.d.ts +3 -0
  91. package/dist/charts/index.cjs +1 -1
  92. package/dist/charts/index.js +1 -1
  93. package/dist/createDialogShellFocus-BBFu3Z_O.js +282 -0
  94. package/dist/createDialogShellFocus-CxRqhbRN.cjs +1 -0
  95. package/dist/createResizableSidebar-CfFxQUny.js +449 -0
  96. package/dist/createResizableSidebar-q7aC7SAO.cjs +1 -0
  97. package/dist/{createVirtualScroller-LN-7QFiv.cjs → createVirtualScroller-CL49JE2P.cjs} +1 -1
  98. package/dist/{server/createVirtualScroller-DBvqT0UW.js → createVirtualScroller-vu-l4rVv.js} +7 -7
  99. package/dist/defineSettings-D0CSMcyy.cjs +1 -0
  100. package/dist/defineSettings-Di1sG81q.js +407 -0
  101. package/dist/descriptor-CaHgh9N_.cjs +1 -0
  102. package/dist/{descriptor-B1MaujhY.js → descriptor-eGtcBtpI.js} +5 -5
  103. package/dist/desktop/index.cjs +1 -1
  104. package/dist/desktop/index.js +500 -426
  105. package/dist/dialogFocusRestore-BrALT8Ew.js +35 -0
  106. package/dist/dialogFocusRestore-CcEsB50v.cjs +1 -0
  107. package/dist/electronBridge-BK92fycw.js +235 -0
  108. package/dist/electronBridge-cT0xww92.cjs +1 -0
  109. package/dist/errorHandler-BvPGW-Nm.js +373 -0
  110. package/dist/errorHandler-DoDAPpv2.cjs +3 -0
  111. package/dist/feedback/Loader.d.cts +6 -1
  112. package/dist/feedback/Loader.d.ts +6 -1
  113. package/dist/feedback/createPreference.d.cts +4 -1
  114. package/dist/feedback/createPreference.d.ts +4 -1
  115. package/dist/feedback/guidedInstallOutcome.d.cts +15 -2
  116. package/dist/feedback/guidedInstallOutcome.d.ts +15 -2
  117. package/dist/feedback/index.cjs +1 -1
  118. package/dist/feedback/index.js +37 -38
  119. package/dist/feedback/readFailureText.d.cts +20 -1
  120. package/dist/feedback/readFailureText.d.ts +20 -1
  121. package/dist/focusModality-BISb6-yg.cjs +1 -0
  122. package/dist/focusModality-FoLPWF-_.js +135 -0
  123. package/dist/forms/index.cjs +1 -1
  124. package/dist/forms/index.js +9 -9
  125. package/dist/grid/index.cjs +1 -1
  126. package/dist/grid/index.js +1 -1
  127. package/dist/{headerIconOverrides-64lFnqTt.cjs → headerIconOverrides-Bn1QuODq.cjs} +1 -1
  128. package/dist/{server/headerIconOverrides-BCzeaBA1.js → headerIconOverrides-Dh2PaOcO.js} +1 -1
  129. package/dist/host/index.cjs +1 -1
  130. package/dist/host/index.d.cts +15 -16
  131. package/dist/host/index.d.ts +15 -16
  132. package/dist/host/index.js +56 -90
  133. package/dist/host/kitHost.d.cts +65 -0
  134. package/dist/host/kitHost.d.ts +65 -0
  135. package/dist/host/window.d.cts +3 -11
  136. package/dist/host/window.d.ts +3 -11
  137. package/dist/i18n/index.cjs +1 -1
  138. package/dist/i18n/index.js +1 -1
  139. package/dist/{i18n-CYq-dVvv.js → i18n-DW9kcu0G.js} +180 -178
  140. package/dist/i18n-DZ0JlZal.cjs +4 -0
  141. package/dist/index.cjs +1 -1
  142. package/dist/index.d.cts +1 -1
  143. package/dist/index.d.ts +1 -1
  144. package/dist/index.js +973 -992
  145. package/dist/isOneOf-9EXOSYJu.cjs +1 -0
  146. package/dist/isOneOf-Dtomuazg.js +6 -0
  147. package/dist/{keys-Bfgdfak_.js → keys-B2nlkpqc.js} +6 -9
  148. package/dist/keys-GMxY2wcl.cjs +1 -0
  149. package/dist/kitHost-BfJExE1G.cjs +1 -0
  150. package/dist/kitHost-CVAEi9sF.js +23 -0
  151. package/dist/layout/createResizableSidebar.d.cts +14 -0
  152. package/dist/layout/createResizableSidebar.d.ts +14 -0
  153. package/dist/layout/index.cjs +1 -1
  154. package/dist/layout/index.js +3 -3
  155. package/dist/layout/sidebarWidthClamp.d.cts +1 -1
  156. package/dist/layout/sidebarWidthClamp.d.ts +1 -1
  157. package/dist/mainRealmDom-C12lr9lm.js +171 -0
  158. package/dist/mainRealmDom-S6teqEr4.cjs +1 -0
  159. package/dist/navigation/index.cjs +1 -1
  160. package/dist/navigation/index.js +1 -1
  161. package/dist/notifications/NotificationHost.d.cts +7 -1
  162. package/dist/notifications/NotificationHost.d.ts +7 -1
  163. package/dist/notifications/NotificationItem.d.cts +48 -15
  164. package/dist/notifications/NotificationItem.d.ts +48 -15
  165. package/dist/notifications/catalogAdapter.d.cts +28 -6
  166. package/dist/notifications/catalogAdapter.d.ts +28 -6
  167. package/dist/notifications/createNotificationPreviewRuntime.d.cts +21 -3
  168. package/dist/notifications/createNotificationPreviewRuntime.d.ts +21 -3
  169. package/dist/notifications/customSoundCache.d.cts +24 -24
  170. package/dist/notifications/customSoundCache.d.ts +24 -24
  171. package/dist/notifications/emailDigest.d.cts +34 -16
  172. package/dist/notifications/emailDigest.d.ts +34 -16
  173. package/dist/notifications/errorActionButtons.d.cts +18 -1
  174. package/dist/notifications/errorActionButtons.d.ts +18 -1
  175. package/dist/notifications/fireNotification.d.cts +27 -17
  176. package/dist/notifications/fireNotification.d.ts +27 -17
  177. package/dist/notifications/index.cjs +1 -1
  178. package/dist/notifications/index.d.cts +7 -12
  179. package/dist/notifications/index.d.ts +7 -12
  180. package/dist/notifications/index.js +64 -98
  181. package/dist/notifications/nativeEngine.d.cts +18 -15
  182. package/dist/notifications/nativeEngine.d.ts +18 -15
  183. package/dist/notifications/notificationAnalytics.d.cts +11 -6
  184. package/dist/notifications/notificationAnalytics.d.ts +11 -6
  185. package/dist/notifications/notificationAudio.d.cts +30 -23
  186. package/dist/notifications/notificationAudio.d.ts +30 -23
  187. package/dist/notifications/notificationCardServices.d.cts +23 -0
  188. package/dist/notifications/notificationCardServices.d.ts +23 -0
  189. package/dist/notifications/notificationOverlayChannel.d.cts +4 -4
  190. package/dist/notifications/notificationOverlayChannel.d.ts +4 -4
  191. package/dist/notifications/notificationOverlaySync.d.cts +7 -2
  192. package/dist/notifications/notificationOverlaySync.d.ts +7 -2
  193. package/dist/notifications/notificationService.d.cts +101 -0
  194. package/dist/notifications/notificationService.d.ts +101 -0
  195. package/dist/notifications/notificationTimeline.d.cts +47 -49
  196. package/dist/notifications/notificationTimeline.d.ts +47 -49
  197. package/dist/notifications/notifications.notifications.d.cts +0 -4
  198. package/dist/notifications/notifications.notifications.d.ts +0 -4
  199. package/dist/notifications/toast.d.cts +24 -28
  200. package/dist/notifications/toast.d.ts +24 -28
  201. package/dist/notifications/webhookDelivery.d.cts +12 -17
  202. package/dist/notifications/webhookDelivery.d.ts +12 -17
  203. package/dist/overlay/ConfirmDialog.d.cts +20 -10
  204. package/dist/overlay/ConfirmDialog.d.ts +20 -10
  205. package/dist/overlay/DangerousActionDialog.d.cts +2 -2
  206. package/dist/overlay/DangerousActionDialog.d.ts +2 -2
  207. package/dist/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.d.cts +15 -14
  208. package/dist/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.d.ts +15 -14
  209. package/dist/overlay/command-palette/unifiedSearch/settingsSearchContributor.d.cts +1 -3
  210. package/dist/overlay/command-palette/unifiedSearch/settingsSearchContributor.d.ts +1 -3
  211. package/dist/overlay/command-palette/unifiedSearch/unifiedSearchTypes.d.cts +1 -1
  212. package/dist/overlay/command-palette/unifiedSearch/unifiedSearchTypes.d.ts +1 -1
  213. package/dist/overlay/index.cjs +1 -1
  214. package/dist/overlay/index.d.cts +2 -3
  215. package/dist/overlay/index.d.ts +2 -3
  216. package/dist/overlay/index.js +114 -119
  217. package/dist/pageTourState-BcBF8w89.js +516 -0
  218. package/dist/pageTourState-CrbEU7QW.cjs +5 -0
  219. package/dist/server/{AttributeGrid-BCYNwNjw.js → AttributeGrid-B2s_rp00.js} +3 -3
  220. package/dist/server/{AttributeGrid-BVAQshm3.cjs → AttributeGrid-C7aWbIe5.cjs} +1 -1
  221. package/dist/server/{Button-BhqhjFpY.js → Button-Ck03cbUs.js} +1 -1
  222. package/dist/server/{Button-CFOM8pOv.cjs → Button-DWFMF5y0.cjs} +1 -1
  223. package/dist/server/CommandPalette-2UppyMxU.js +3271 -0
  224. package/dist/server/CommandPalette-DwpZyhO6.cjs +1 -0
  225. package/dist/server/{CopyButton-C2jzn9tR.cjs → CopyButton-BOmAUQD4.cjs} +1 -1
  226. package/dist/server/{CopyButton-CChDa2p3.js → CopyButton-UvtFwOtA.js} +1 -1
  227. package/dist/server/DateRangePicker-BJteKzOY.cjs +9 -0
  228. package/dist/server/{DateRangePicker-QV6U1adB.js → DateRangePicker-Cr58DczM.js} +158 -143
  229. package/dist/server/GuidedTour-C4msn-Ag.js +400 -0
  230. package/dist/server/GuidedTour-Rlsp8rOe.cjs +1 -0
  231. package/dist/server/HostPortal-B9Tzk_uN.cjs +1 -0
  232. package/dist/server/HostPortal-X1iw719T.js +33 -0
  233. package/dist/server/HostWindowContext-B2m0bVra.js +32 -0
  234. package/dist/server/HostWindowContext-_VZCt7xE.cjs +1 -0
  235. package/dist/server/{IconPicker-BEACrT09.cjs → IconPicker-9DfOxql6.cjs} +1 -1
  236. package/dist/server/{IconPicker-at_coEi6.js → IconPicker-N0wub1Aj.js} +4 -4
  237. package/dist/server/Modal-D__GTo-n.cjs +1 -0
  238. package/dist/server/{Modal-usxkqDtK.js → Modal-DeQjfpkG.js} +3 -3
  239. package/dist/server/{PageSkeleton-Bpgep9QW.js → PageSkeleton-C41pXOcr.js} +457 -455
  240. package/dist/server/PageSkeleton-D4i-UcnI.cjs +30 -0
  241. package/dist/server/{SearchableSelect-0dP7bp0a.js → SearchableSelect-CEcuBnge.js} +2 -2
  242. package/dist/server/{SearchableSelect-nMecJAYS.cjs → SearchableSelect-Ca9g8ztu.cjs} +1 -1
  243. package/dist/server/StatusBarNotificationBell-BotYny7q.cjs +49 -0
  244. package/dist/server/StatusBarNotificationBell-DyEQF2W7.js +13968 -0
  245. package/dist/server/{Stepper-DvoJXLcM.cjs → Stepper--pusyxso.cjs} +1 -1
  246. package/dist/server/{Stepper-B8hDDujj.js → Stepper-B_eL85hK.js} +1 -1
  247. package/dist/server/{TimeSeriesChart-C1LbL_xp.js → TimeSeriesChart-aSHquoBv.js} +1 -1
  248. package/dist/server/{TimeSeriesChart-DtldQrxS.cjs → TimeSeriesChart-nZeB5jtN.cjs} +1 -1
  249. package/dist/server/ToggleButton-57_0SA-V.cjs +1 -0
  250. package/dist/server/{ToggleButton--G4HCOTD.js → ToggleButton-DjlWwgLJ.js} +4 -4
  251. package/dist/server/VpTrash-D49oUUJh.cjs +1 -0
  252. package/dist/server/VpTrash-Dlq8o6Uv.js +298 -0
  253. package/dist/server/a11y/index.cjs +1 -1
  254. package/dist/server/a11y/index.js +1 -1
  255. package/dist/server/actions-DtaFGwh2.cjs +1 -0
  256. package/dist/server/actions-wwAHs3ZU.js +16 -0
  257. package/dist/{appThemeDerivation-BiCyiSuz.js → server/appThemeDerivation-B7-DjMIM.js} +181 -184
  258. package/dist/server/appThemeDerivation-NS3Vws8q.cjs +1 -0
  259. package/dist/server/charts/index.cjs +1 -1
  260. package/dist/server/charts/index.js +1 -1
  261. package/dist/server/{format-CW_FVfq2.js → createDialogShellFocus-DNjzmcGj.js} +110 -126
  262. package/dist/server/createDialogShellFocus-PRRfMli-.cjs +1 -0
  263. package/dist/server/createResizableSidebar-CZtGmUnA.cjs +1 -0
  264. package/dist/server/createResizableSidebar-DdWdAB9l.js +287 -0
  265. package/dist/server/{createVirtualScroller-LN-7QFiv.cjs → createVirtualScroller-CL49JE2P.cjs} +1 -1
  266. package/dist/{createVirtualScroller-DBvqT0UW.js → server/createVirtualScroller-vu-l4rVv.js} +7 -7
  267. package/dist/server/defineSettings-D0CSMcyy.cjs +1 -0
  268. package/dist/server/defineSettings-Di1sG81q.js +407 -0
  269. package/dist/server/descriptor-CEGvvJZh.cjs +1 -0
  270. package/dist/server/{descriptor-DWkJAggS.js → descriptor-GLoKPx6x.js} +4 -4
  271. package/dist/server/desktop/index.cjs +1 -1
  272. package/dist/server/desktop/index.js +389 -315
  273. package/dist/server/dialogFocusRestore-BrALT8Ew.js +35 -0
  274. package/dist/server/dialogFocusRestore-CcEsB50v.cjs +1 -0
  275. package/dist/server/electronBridge-BK92fycw.js +235 -0
  276. package/dist/server/electronBridge-cT0xww92.cjs +1 -0
  277. package/dist/server/errorHandler-BvPGW-Nm.js +373 -0
  278. package/dist/server/errorHandler-DoDAPpv2.cjs +3 -0
  279. package/dist/server/feedback/index.cjs +1 -1
  280. package/dist/server/feedback/index.js +37 -38
  281. package/dist/server/focusModality-D-nxv8Er.cjs +1 -0
  282. package/dist/server/focusModality-nWNVX3JG.js +126 -0
  283. package/dist/server/forms/index.cjs +1 -1
  284. package/dist/server/forms/index.js +7 -7
  285. package/dist/server/grid/index.cjs +1 -1
  286. package/dist/server/grid/index.js +1 -1
  287. package/dist/server/{headerIconOverrides-64lFnqTt.cjs → headerIconOverrides-Bn1QuODq.cjs} +1 -1
  288. package/dist/{headerIconOverrides-BCzeaBA1.js → server/headerIconOverrides-Dh2PaOcO.js} +1 -1
  289. package/dist/server/host/index.cjs +1 -1
  290. package/dist/server/host/index.js +56 -90
  291. package/dist/server/i18n/index.cjs +1 -1
  292. package/dist/server/i18n/index.js +1 -1
  293. package/dist/server/{i18n-CYq-dVvv.js → i18n-DW9kcu0G.js} +180 -178
  294. package/dist/server/i18n-DZ0JlZal.cjs +4 -0
  295. package/dist/server/{index-BFT4Uh9D.js → index-BNYr6EIW.js} +89 -90
  296. package/dist/server/index-Cqod09d_.cjs +1 -0
  297. package/dist/server/index.cjs +1 -1
  298. package/dist/server/index.js +1022 -1041
  299. package/dist/server/kitHost-BfJExE1G.cjs +1 -0
  300. package/dist/server/kitHost-CVAEi9sF.js +23 -0
  301. package/dist/server/layout/index.cjs +1 -1
  302. package/dist/server/layout/index.js +3 -3
  303. package/dist/server/mainRealmDom-DPNaDWtw.js +121 -0
  304. package/dist/server/mainRealmDom-DwZVMPnO.cjs +1 -0
  305. package/dist/server/navigation/index.cjs +1 -1
  306. package/dist/server/navigation/index.js +1 -1
  307. package/dist/server/notifications/index.cjs +1 -1
  308. package/dist/server/notifications/index.js +63 -97
  309. package/dist/server/overlay/index.cjs +1 -1
  310. package/dist/server/overlay/index.js +109 -114
  311. package/dist/server/pageTourState-BcBF8w89.js +516 -0
  312. package/dist/server/pageTourState-CrbEU7QW.cjs +5 -0
  313. package/dist/server/settings/index.cjs +1 -1
  314. package/dist/server/settings/index.js +23 -24
  315. package/dist/server/stateDbStore-CThsVch-.cjs +1 -0
  316. package/dist/server/stateDbStore-DHZFUIEt.js +57 -0
  317. package/dist/server/tokens/index.cjs +1 -1
  318. package/dist/server/tokens/index.js +19 -20
  319. package/dist/server/tree/index.cjs +1 -1
  320. package/dist/server/tree/index.js +1 -1
  321. package/dist/server/useListCommands-BO_XrRHj.js +38 -0
  322. package/dist/server/useListCommands-Dnm4ktP1.cjs +1 -0
  323. package/dist/server/useSettingsSubscription-DKjCwmRd.cjs +1 -0
  324. package/dist/{notification-DFbp3S_f.js → server/useSettingsSubscription-DLEk4k4j.js} +41 -32
  325. package/dist/server/window-CUK6x8Pj.js +36 -0
  326. package/dist/server/window-_BfSgFGO.cjs +1 -0
  327. package/dist/server/windowRegistry-CxXtP-iY.cjs +1 -0
  328. package/dist/server/windowRegistry-DeGmXt6W.js +20 -0
  329. package/dist/settings/index.cjs +1 -1
  330. package/dist/settings/index.d.cts +1 -1
  331. package/dist/settings/index.d.ts +1 -1
  332. package/dist/settings/index.js +23 -24
  333. package/dist/solid/_internal/app/keybindings/context/useFocusClaim.js +3 -10
  334. package/dist/solid/_internal/app/keybindings/context/useListCommands.js +1 -2
  335. package/dist/solid/_internal/app/keybindings/panelCommandsRegistry.js +8 -1
  336. package/dist/solid/_internal/app/menu/menuFavorites.js +45 -40
  337. package/dist/solid/_internal/app/onboarding/PageTourHost.jsx +22 -22
  338. package/dist/solid/_internal/app/onboarding/pageTourState.js +94 -92
  339. package/dist/solid/_internal/app/platform/electronBridge.js +15 -49
  340. package/dist/solid/_internal/app/settings/secrets/notificationSecrets.js +11 -29
  341. package/dist/solid/_internal/app/windows/window/HostWindowContext.jsx +4 -13
  342. package/dist/solid/_internal/contract/catalogNotify.js +1 -24
  343. package/dist/solid/_internal/contract/hostErrorText.js +1 -14
  344. package/dist/solid/_internal/contract/notificationCatalog.js +1 -1
  345. package/dist/solid/_internal/platform/a11y/announcerService.js +0 -24
  346. package/dist/solid/_internal/platform/errors/diagnosticReport.js +2 -3
  347. package/dist/solid/_internal/platform/logging/consoleLogger.js +6 -0
  348. package/dist/solid/_internal/platform/settings/registry/defineSettings.js +48 -20
  349. package/dist/solid/_internal/platform/settings/registry/stateDbStore.js +29 -19
  350. package/dist/solid/_internal/platform/vendorErrors/index.js +4 -17
  351. package/dist/solid/_internal/platform/window/displayOwner.js +105 -114
  352. package/dist/solid/a11y/AriaAnnouncer.jsx +5 -6
  353. package/dist/solid/async/createGuardedListLoader.js +1 -1
  354. package/dist/solid/desktop/menu/MenuPanel.jsx +7 -7
  355. package/dist/solid/feedback/ErrorBoundary.jsx +7 -4
  356. package/dist/solid/feedback/Loader.jsx +1 -2
  357. package/dist/solid/feedback/createPreference.js +3 -2
  358. package/dist/solid/feedback/guidedInstallOutcome.js +1 -2
  359. package/dist/solid/feedback/preference.notifications.js +1 -2
  360. package/dist/solid/feedback/readFailureText.js +1 -2
  361. package/dist/solid/host/index.js +9 -16
  362. package/dist/solid/host/kitHost.jsx +15 -0
  363. package/dist/solid/host/window.js +15 -22
  364. package/dist/solid/i18n/i18n.js +5 -6
  365. package/dist/solid/index.js +0 -1
  366. package/dist/solid/layout/createResizableSidebar.js +15 -23
  367. package/dist/solid/notifications/NotificationHost.jsx +21 -29
  368. package/dist/solid/notifications/NotificationItem.jsx +28 -103
  369. package/dist/solid/notifications/NotificationPanel.jsx +33 -44
  370. package/dist/solid/notifications/NotificationsCenter.jsx +22 -20
  371. package/dist/solid/notifications/StatusBarNotificationBell.jsx +4 -3
  372. package/dist/solid/notifications/catalogAdapter.js +61 -62
  373. package/dist/solid/notifications/createNotificationPreviewRuntime.js +29 -19
  374. package/dist/solid/notifications/customSoundCache.js +26 -21
  375. package/dist/solid/notifications/emailDigest.js +74 -86
  376. package/dist/solid/notifications/errorActionButtons.js +6 -11
  377. package/dist/solid/notifications/fireNotification.js +14 -19
  378. package/dist/solid/notifications/index.js +4 -12
  379. package/dist/solid/notifications/nativeEngine.js +6 -19
  380. package/dist/solid/notifications/notificationAnalytics.js +32 -38
  381. package/dist/solid/notifications/notificationAudio.js +77 -74
  382. package/dist/solid/notifications/notificationCardServices.js +34 -0
  383. package/dist/solid/notifications/notificationOverlayChannel.js +3 -3
  384. package/dist/solid/notifications/notificationOverlaySync.js +18 -23
  385. package/dist/solid/notifications/notificationService.js +135 -0
  386. package/dist/solid/notifications/notificationTimeline.js +117 -124
  387. package/dist/solid/notifications/notifications.notifications.js +3 -22
  388. package/dist/solid/notifications/toast.js +168 -213
  389. package/dist/solid/notifications/webhookDelivery.js +27 -53
  390. package/dist/solid/overlay/ConfirmDialog.jsx +2 -54
  391. package/dist/solid/overlay/command-palette/CommandPalette.jsx +3 -1
  392. package/dist/solid/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.js +26 -25
  393. package/dist/solid/overlay/command-palette/unifiedSearch/settingsSearchContributor.js +2 -7
  394. package/dist/solid/overlay/index.js +0 -3
  395. package/dist/solid/settings/index.js +1 -1
  396. package/dist/solid/tokens/index.js +1 -1
  397. package/dist/solid/tokens/palette/themeRegistry.js +20 -22
  398. package/dist/stateDbStore-CThsVch-.cjs +1 -0
  399. package/dist/stateDbStore-DHZFUIEt.js +57 -0
  400. package/dist/style.css +1 -1
  401. package/dist/tokens/index.cjs +1 -1
  402. package/dist/tokens/index.d.cts +1 -1
  403. package/dist/tokens/index.d.ts +1 -1
  404. package/dist/tokens/index.js +19 -20
  405. package/dist/tokens/palette/themeRegistry.d.cts +17 -22
  406. package/dist/tokens/palette/themeRegistry.d.ts +17 -22
  407. package/dist/{tooltipCoordinator-GV0L9lXH.js → tooltipCoordinator-BzxEyKhA.js} +2 -2
  408. package/dist/tooltipCoordinator-DslqMlsI.cjs +1 -0
  409. package/dist/tree/index.cjs +1 -1
  410. package/dist/tree/index.js +1 -1
  411. package/dist/ui.css +1 -1
  412. package/dist/{useFloatingDropdown-CfPEYRut.js → useFloatingDropdown-BN4J092P.js} +1 -1
  413. package/dist/{useFloatingDropdown-DcU7ozDg.cjs → useFloatingDropdown-D9OvEFAp.cjs} +1 -1
  414. package/dist/useListCommands-BO_XrRHj.js +38 -0
  415. package/dist/useListCommands-Dnm4ktP1.cjs +1 -0
  416. package/dist/useSettingsSubscription-DKjCwmRd.cjs +1 -0
  417. package/dist/{server/notification-DFbp3S_f.js → useSettingsSubscription-DLEk4k4j.js} +41 -32
  418. package/dist/window-CUK6x8Pj.js +36 -0
  419. package/dist/window-_BfSgFGO.cjs +1 -0
  420. package/dist/windowRegistry-CxXtP-iY.cjs +1 -0
  421. package/dist/windowRegistry-DeGmXt6W.js +20 -0
  422. package/package.json +1 -1
  423. package/dist/CommandPalette-DToM9pUp.cjs +0 -2
  424. package/dist/CommandPalette-ZCFlLqrP.js +0 -3950
  425. package/dist/DateRangePicker-DHI3SNna.cjs +0 -9
  426. package/dist/GuidedTour-B-BXe3ul.js +0 -11214
  427. package/dist/GuidedTour-c7XiyOmE.cjs +0 -21
  428. package/dist/HostWindowContext-DqDeJmBP.cjs +0 -1
  429. package/dist/HostWindowContext-KL4U1qUv.js +0 -40
  430. package/dist/Modal-DpDHzCWT.cjs +0 -1
  431. package/dist/PageSkeleton-DzKYTuNy.cjs +0 -30
  432. package/dist/Progress-B5YmNeyU.js +0 -56
  433. package/dist/Progress-BNy0wsJl.cjs +0 -1
  434. package/dist/StatusBarNotificationBell-CZmym2gV.js +0 -2140
  435. package/dist/StatusBarNotificationBell-DG8Pe6R-.cjs +0 -4
  436. package/dist/ToggleButton-Bjxv8KGH.cjs +0 -1
  437. package/dist/_internal/app/contexts/WorkspaceTabsContext.d.cts +0 -20
  438. package/dist/_internal/app/contexts/WorkspaceTabsContext.d.ts +0 -20
  439. package/dist/_internal/app/settings/theme/appThemeChange.d.cts +0 -20
  440. package/dist/_internal/app/settings/theme/appThemeChange.d.ts +0 -20
  441. package/dist/_internal/app/settings/ui/shell/openSettingsModal.d.cts +0 -6
  442. package/dist/_internal/app/settings/ui/shell/openSettingsModal.d.ts +0 -6
  443. package/dist/_internal/base/listenerDispatch.d.cts +0 -14
  444. package/dist/_internal/base/listenerDispatch.d.ts +0 -14
  445. package/dist/_internal/contract/appName.d.cts +0 -10
  446. package/dist/_internal/contract/appName.d.ts +0 -10
  447. package/dist/_internal/contract/hostText.d.cts +0 -25
  448. package/dist/_internal/contract/hostText.d.ts +0 -25
  449. package/dist/_internal/platform/instantiation/common/descriptors.d.cts +0 -9
  450. package/dist/_internal/platform/instantiation/common/descriptors.d.ts +0 -9
  451. package/dist/_internal/platform/instantiation/common/instantiation.d.cts +0 -99
  452. package/dist/_internal/platform/instantiation/common/instantiation.d.ts +0 -99
  453. package/dist/_internal/platform/instantiation/common/serviceCollection.d.cts +0 -8
  454. package/dist/_internal/platform/instantiation/common/serviceCollection.d.ts +0 -8
  455. package/dist/_internal/platform/logging/rendererLogging.d.cts +0 -65
  456. package/dist/_internal/platform/logging/rendererLogging.d.ts +0 -65
  457. package/dist/_internal/platform/settings/preferencesCache.d.cts +0 -162
  458. package/dist/_internal/platform/settings/preferencesCache.d.ts +0 -162
  459. package/dist/announcerService-B7yicxvU.js +0 -97
  460. package/dist/announcerService-D_pFE24a.cjs +0 -1
  461. package/dist/appThemeDerivation-DmKbTiFi.cjs +0 -1
  462. package/dist/catalogNotify-C9RzbC6x.cjs +0 -27
  463. package/dist/catalogNotify-CIhFuJ1b.js +0 -1210
  464. package/dist/createResizableSidebar-2TgiFZp1.js +0 -461
  465. package/dist/createResizableSidebar-pDoO-7q9.cjs +0 -1
  466. package/dist/defineSettings-By5ell8e.js +0 -391
  467. package/dist/defineSettings-DRv1FRbv.cjs +0 -1
  468. package/dist/descriptor-lw1fA9mi.cjs +0 -1
  469. package/dist/dialogFocusRestore-B4ggeVAM.js +0 -64
  470. package/dist/dialogFocusRestore-BcMPrbig.cjs +0 -1
  471. package/dist/displayOwner-BNw2Foa_.cjs +0 -1
  472. package/dist/displayOwner-B_ezJv-O.js +0 -75
  473. package/dist/feedback/preference.notifications.samples.d.cts +0 -1
  474. package/dist/feedback/preference.notifications.samples.d.ts +0 -1
  475. package/dist/focusModality-B150daiS.js +0 -133
  476. package/dist/focusModality-PPfeW05D.cjs +0 -1
  477. package/dist/format-Dih0q9gm.cjs +0 -1
  478. package/dist/format-UGlMj0HW.js +0 -298
  479. package/dist/i18n-B9ccWgcR.cjs +0 -4
  480. package/dist/keys-BeeC5_RZ.cjs +0 -1
  481. package/dist/mainRealmDom-COGBiX78.js +0 -102
  482. package/dist/mainRealmDom-DijAgSXt.cjs +0 -1
  483. package/dist/menuFavorites-Db1DpHX6.js +0 -69
  484. package/dist/menuFavorites-EluLLTfi.cjs +0 -1
  485. package/dist/notification-CrxHMXsk.cjs +0 -1
  486. package/dist/notificationSuppressions-CBIJ4bC4.js +0 -430
  487. package/dist/notificationSuppressions-DFbFpayS.cjs +0 -1
  488. package/dist/notifications/copyToClipboard.d.cts +0 -6
  489. package/dist/notifications/copyToClipboard.d.ts +0 -6
  490. package/dist/notifications/createCopyFlash.d.cts +0 -17
  491. package/dist/notifications/createCopyFlash.d.ts +0 -17
  492. package/dist/notifications/notificationDisplayOwner.d.cts +0 -27
  493. package/dist/notifications/notificationDisplayOwner.d.ts +0 -27
  494. package/dist/notifications/notificationRepeaterEntryFactory.d.cts +0 -36
  495. package/dist/notifications/notificationRepeaterEntryFactory.d.ts +0 -36
  496. package/dist/notifications/notifications.notifications.samples.d.cts +0 -1
  497. package/dist/notifications/notifications.notifications.samples.d.ts +0 -1
  498. package/dist/notifications/persistWithRollbackOnFailure.d.cts +0 -18
  499. package/dist/notifications/persistWithRollbackOnFailure.d.ts +0 -18
  500. package/dist/notifications/startNotificationSchedulers.d.cts +0 -2
  501. package/dist/notifications/startNotificationSchedulers.d.ts +0 -2
  502. package/dist/notifications/startNotificationSettingsReactions.d.cts +0 -46
  503. package/dist/notifications/startNotificationSettingsReactions.d.ts +0 -46
  504. package/dist/overlay/ToastHost.d.cts +0 -7
  505. package/dist/overlay/ToastHost.d.ts +0 -7
  506. package/dist/pageTourState-CIr8ockR.js +0 -92
  507. package/dist/pageTourState-D8Uapyft.cjs +0 -1
  508. package/dist/preferencesCache-BhUd3K9p.js +0 -65
  509. package/dist/preferencesCache-DJPCTPYx.cjs +0 -1
  510. package/dist/rendererLogging-B4XML4_G.cjs +0 -7
  511. package/dist/rendererLogging-Edo4ALXU.js +0 -822
  512. package/dist/server/CommandPalette-C3Bw1teR.cjs +0 -1
  513. package/dist/server/CommandPalette-S7tfmFMb.js +0 -3208
  514. package/dist/server/DateRangePicker-sX2m4194.cjs +0 -9
  515. package/dist/server/GuidedTour-BhJGkoPa.js +0 -10981
  516. package/dist/server/GuidedTour-Dx0endYh.cjs +0 -20
  517. package/dist/server/HostWindowContext-DqDeJmBP.cjs +0 -1
  518. package/dist/server/HostWindowContext-KL4U1qUv.js +0 -40
  519. package/dist/server/Modal-CAVr4DU6.cjs +0 -1
  520. package/dist/server/PageSkeleton-KwYRrZua.cjs +0 -30
  521. package/dist/server/Progress-CRbj6nEy.cjs +0 -1
  522. package/dist/server/Progress-nsDy6clG.js +0 -41
  523. package/dist/server/StatusBarNotificationBell-BJyGqDCX.cjs +0 -4
  524. package/dist/server/StatusBarNotificationBell-C9MCuKT6.js +0 -1974
  525. package/dist/server/ToggleButton-DTI2HB97.cjs +0 -1
  526. package/dist/server/VpTerminal-Bpw-d9wD.js +0 -186
  527. package/dist/server/VpTerminal-C-U_dN_x.cjs +0 -1
  528. package/dist/server/VpTrash-CagiU2Uj.cjs +0 -1
  529. package/dist/server/VpTrash-DVBfts9_.js +0 -116
  530. package/dist/server/announcerService-B7yicxvU.js +0 -97
  531. package/dist/server/announcerService-D_pFE24a.cjs +0 -1
  532. package/dist/server/appThemeDerivation-DmKbTiFi.cjs +0 -1
  533. package/dist/server/catalogNotify-BPPTINme.cjs +0 -27
  534. package/dist/server/catalogNotify-mUcKuUmZ.js +0 -1248
  535. package/dist/server/createResizableSidebar-CCrAgu_K.js +0 -299
  536. package/dist/server/createResizableSidebar-DGd-3PrM.cjs +0 -1
  537. package/dist/server/defineSettings-By5ell8e.js +0 -391
  538. package/dist/server/defineSettings-DRv1FRbv.cjs +0 -1
  539. package/dist/server/descriptor-IJq9wdXK.cjs +0 -1
  540. package/dist/server/dialogFocusRestore-B4ggeVAM.js +0 -64
  541. package/dist/server/dialogFocusRestore-BcMPrbig.cjs +0 -1
  542. package/dist/server/displayOwner-BNw2Foa_.cjs +0 -1
  543. package/dist/server/displayOwner-B_ezJv-O.js +0 -75
  544. package/dist/server/focusModality-CeTPyRiF.cjs +0 -1
  545. package/dist/server/focusModality-DmOZptla.js +0 -124
  546. package/dist/server/format-x-8syaS2.cjs +0 -1
  547. package/dist/server/i18n-B9ccWgcR.cjs +0 -4
  548. package/dist/server/index-Xlas73iC.cjs +0 -1
  549. package/dist/server/mainRealmDom-BCL1p_q6.cjs +0 -1
  550. package/dist/server/mainRealmDom-Dk0xb5Gj.js +0 -67
  551. package/dist/server/menuFavorites-Db1DpHX6.js +0 -69
  552. package/dist/server/menuFavorites-EluLLTfi.cjs +0 -1
  553. package/dist/server/notification-CrxHMXsk.cjs +0 -1
  554. package/dist/server/notificationSuppressions-D7FZmJy8.cjs +0 -1
  555. package/dist/server/notificationSuppressions-DkrUMXHx.js +0 -391
  556. package/dist/server/pageTourState-CIr8ockR.js +0 -92
  557. package/dist/server/pageTourState-D8Uapyft.cjs +0 -1
  558. package/dist/server/preferencesCache-BhUd3K9p.js +0 -65
  559. package/dist/server/preferencesCache-DJPCTPYx.cjs +0 -1
  560. package/dist/server/rendererLogging-B4XML4_G.cjs +0 -7
  561. package/dist/server/rendererLogging-Edo4ALXU.js +0 -822
  562. package/dist/server/settingsSearchContributor-DZj7Wc8l.cjs +0 -1
  563. package/dist/server/settingsSearchContributor-DeMn-njw.js +0 -199
  564. package/dist/server/stateDbStore-Ds3zJ4cd.js +0 -47
  565. package/dist/server/stateDbStore-THFfFGa0.cjs +0 -1
  566. package/dist/server/useListCommands-Bf7aOTXZ.js +0 -61
  567. package/dist/server/useListCommands-ucngC3t4.cjs +0 -1
  568. package/dist/server/useSettingsSubscription-cu943hND.js +0 -11
  569. package/dist/server/useSettingsSubscription-vlMrNNH9.cjs +0 -1
  570. package/dist/server/visibleBrowserRegistry-BTfWUlI1.cjs +0 -1
  571. package/dist/server/visibleBrowserRegistry-Dw2Y4y_I.js +0 -89
  572. package/dist/server/windowRegistry-Bk5lXIVd.js +0 -62
  573. package/dist/server/windowRegistry-CGvOBUsw.cjs +0 -1
  574. package/dist/settingsSearchContributor-C-UJc7Xc.js +0 -199
  575. package/dist/settingsSearchContributor-Du0SDpJt.cjs +0 -1
  576. package/dist/solid/_internal/app/contexts/WorkspaceTabsContext.js +0 -10
  577. package/dist/solid/_internal/app/settings/theme/appThemeChange.js +0 -5
  578. package/dist/solid/_internal/app/settings/ui/shell/openSettingsModal.js +0 -15
  579. package/dist/solid/_internal/base/listenerDispatch.js +0 -12
  580. package/dist/solid/_internal/contract/appName.js +0 -7
  581. package/dist/solid/_internal/contract/hostText.js +0 -15
  582. package/dist/solid/_internal/platform/instantiation/common/descriptors.js +0 -10
  583. package/dist/solid/_internal/platform/instantiation/common/instantiation.js +0 -35
  584. package/dist/solid/_internal/platform/instantiation/common/serviceCollection.js +0 -14
  585. package/dist/solid/_internal/platform/logging/rendererLogging.js +0 -42
  586. package/dist/solid/_internal/platform/settings/preferencesCache.js +0 -329
  587. package/dist/solid/feedback/preference.notifications.samples.js +0 -5
  588. package/dist/solid/notifications/copyToClipboard.js +0 -21
  589. package/dist/solid/notifications/createCopyFlash.js +0 -26
  590. package/dist/solid/notifications/notificationDisplayOwner.js +0 -1
  591. package/dist/solid/notifications/notificationRepeaterEntryFactory.js +0 -20
  592. package/dist/solid/notifications/notifications.notifications.samples.js +0 -14
  593. package/dist/solid/notifications/persistWithRollbackOnFailure.js +0 -11
  594. package/dist/solid/notifications/startNotificationSchedulers.js +0 -8
  595. package/dist/solid/notifications/startNotificationSettingsReactions.js +0 -22
  596. package/dist/solid/overlay/ToastHost.jsx +0 -1
  597. package/dist/stateDbStore-Ds3zJ4cd.js +0 -47
  598. package/dist/stateDbStore-THFfFGa0.cjs +0 -1
  599. package/dist/tooltipCoordinator-y5YP3tsJ.cjs +0 -1
  600. package/dist/useListCommands-Bf7aOTXZ.js +0 -61
  601. package/dist/useListCommands-ucngC3t4.cjs +0 -1
  602. package/dist/useSettingsSubscription-cu943hND.js +0 -11
  603. package/dist/useSettingsSubscription-vlMrNNH9.cjs +0 -1
  604. package/dist/visibleBrowserRegistry-BTfWUlI1.cjs +0 -1
  605. package/dist/visibleBrowserRegistry-Dw2Y4y_I.js +0 -89
  606. package/dist/windowRegistry-Bk5lXIVd.js +0 -62
  607. package/dist/windowRegistry-CGvOBUsw.cjs +0 -1
@@ -1,27 +1,14 @@
1
1
  /**
2
- * ===== CATALOG NOTIFICATION PORT =====
2
+ * ===== CATALOG DELIVERY — what turns a built catalog payload into a notification =====
3
3
  *
4
- * ui adapter: same API as the host app's catalog notification port. The host app throws while
5
- * no shell provided the catalog host; ui falls back to its own notification system
6
- * (`src/notifications/catalogAdapter`), so catalog notifications raised by modules show up as
7
- * toasts without any wiring. A host with its own notification surface calls
8
- * `provideCatalogNotificationHost()` at boot.
4
+ * A feature never delivers a payload itself: it asks the realm's notification service
5
+ * (`notifications.notify(definition, params)`), which builds the payload with its render host and
6
+ * hands it to this surface. The same surface is the seam of the developer catalog's isolated preview
7
+ * (`createNotificationPreviewRuntime`), which delivers into its own engine.
9
8
  */
10
9
  import type { ToastProgressHandle } from './notification.js';
11
- import type { NotificationCatalogMetadata, NotificationCatalogPayload, NotificationDefinition, NotificationScenarioDescriptor } from './notificationCatalog.js';
10
+ import type { NotificationCatalogMetadata, NotificationCatalogPayload } from './notificationCatalog.js';
12
11
  export interface CatalogNotificationHost {
13
12
  readonly notify: (definition: NotificationCatalogMetadata<'message' | 'query-completed'>, payload: NotificationCatalogPayload) => string;
14
13
  readonly progress: (definition: NotificationCatalogMetadata<'progress'>, payload: NotificationCatalogPayload) => ToastProgressHandle;
15
- readonly dismiss?: (id: string) => void;
16
14
  }
17
- export declare function provideCatalogNotificationHost(surface: CatalogNotificationHost): void;
18
- /**
19
- * The type of the parameters comes ONLY from the definition (`NoInfer`): if it were also inferred
20
- * from the argument, extra fields the definition does not read (e.g. an `options` bag) would
21
- * slip past the compiler silently — measured: the monitoring alerts passed a bag carrying
22
- * source/priority/route and none of the definitions read it.
23
- */
24
- export declare function notifyFromCatalog<TParams>(definition: NotificationDefinition<TParams, 'message' | 'query-completed'>, params: NoInfer<TParams>): string;
25
- export declare function progressFromCatalog<TParams>(definition: NotificationDefinition<TParams, 'progress'>, params: NoInfer<TParams>): ToastProgressHandle;
26
- export declare function dismissNotificationFromCatalog(id: string): void;
27
- export declare function resolveNotificationScenario(scenario: NotificationScenarioDescriptor): NotificationCatalogPayload;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * ===== ERROR PRESENTATION PORT — the sentence of an error that goes to the user, from ONE home =====
2
+ * ===== ERROR PRESENTATION — the sentence of an error that goes to the user, from ONE home =====
3
3
  *
4
4
  * ## The fact it closes
5
5
  *
@@ -9,28 +9,21 @@
9
9
  * turned into text; even a class that has a sentence in the user's language, like a transfer
10
10
  * problem, reached the notification with the main process's developer-facing message.
11
11
  *
12
- * Now catalogs take the ERROR (`cause: unknown`) and ask this port for the sentence. The presenter
13
- * behind the port is the renderer's single presentation home: if the domain of the fact coming from
12
+ * Now catalogs take the ERROR (`cause: unknown`) and ask the presenter for the sentence. The
13
+ * presenter is the application's single presentation home: if the domain of the fact coming from
14
14
  * the boundary carries a presentation table, the sentence comes from there, in the user's language;
15
15
  * otherwise the producer's message.
16
16
  *
17
- * ## Why `contract/`
17
+ * ## Where the kit gets it
18
18
  *
19
- * Catalogs also live outside `app/` and cannot see `app/`; the presentation tables, in turn, live in
20
- * the domains' UI homes. `contract/` is the one node both can see — the same reason as `hostText`.
21
- *
22
- * ⚠ **NO HIDDEN FALLBACK.** `errorText` THROWS while the slot is empty. An identity return
23
- * (`error.message`) would silently show the raw message in a realm that forgot to wire it, and no
24
- * measurement would see it.
25
- *
26
- * ⚠ Web workers and the main process do not bind this port: the code there turns the error into text
27
- * with `toErrorMessage` (`base/errorMessage`). Measured: `errorText` + `t` entering the markdown
28
- * worker split the worker bundle (the `iife` format does not support code splitting) — the build
29
- * failed; it would have thrown at run time too.
19
+ * The application hands its presenter to the kit's components (`KitHost.errorPresenter`) and to its
20
+ * notification service; a catalog's builder receives `errorText` with its render host, a helper that
21
+ * phrases an error takes it as a parameter. There is no module slot and no default: a realm that
22
+ * forgot its presenter fails at the first sentence instead of quietly showing raw messages.
30
23
  *
31
24
  * ## Actions
32
25
  *
33
- * The same presenter also provides the error's ACTIONS (`errorActions`, the precedent's
26
+ * The same presenter also provides the error's ACTIONS (`actions`, the precedent's
34
27
  * `createErrorWithActions`): those attached to the error (`base/errors/errorActions`) and those the
35
28
  * domain's action table derives from the carried fact. A notification carries the error it presents
36
29
  * in its payload (`cause`) and the actions become buttons — the caller collects no actions.
@@ -51,11 +44,8 @@ export interface HostErrorPresenter {
51
44
  readonly actions: ErrorActionsFn;
52
45
  }
53
46
  /**
54
- * THE SHELL PUBLISHES THE PRESENTER — once at boot, from the host app's port wiring. `null` returns
55
- * to the kit's default.
47
+ * The presenter of an application without presentation tables: the error's own message (or the
48
+ * caller's sentence for a message-less value) and the actions attached to the error. An application
49
+ * chooses it explicitly; the kit never falls back to it.
56
50
  */
57
- export declare function provideHostErrorPresenter(next: HostErrorPresenter | null): void;
58
- /** The sentence of the error for the user — see {@link ErrorTextFn}. */
59
- export declare function errorText(error: unknown, general: string): string;
60
- /** The actions of the error — see {@link ErrorActionsFn}. */
61
- export declare function errorActions(error: unknown): readonly ErrorAction[];
51
+ export declare const messageErrorPresenter: HostErrorPresenter;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * ===== ERROR PRESENTATION PORT — the sentence of an error that goes to the user, from ONE home =====
2
+ * ===== ERROR PRESENTATION — the sentence of an error that goes to the user, from ONE home =====
3
3
  *
4
4
  * ## The fact it closes
5
5
  *
@@ -9,28 +9,21 @@
9
9
  * turned into text; even a class that has a sentence in the user's language, like a transfer
10
10
  * problem, reached the notification with the main process's developer-facing message.
11
11
  *
12
- * Now catalogs take the ERROR (`cause: unknown`) and ask this port for the sentence. The presenter
13
- * behind the port is the renderer's single presentation home: if the domain of the fact coming from
12
+ * Now catalogs take the ERROR (`cause: unknown`) and ask the presenter for the sentence. The
13
+ * presenter is the application's single presentation home: if the domain of the fact coming from
14
14
  * the boundary carries a presentation table, the sentence comes from there, in the user's language;
15
15
  * otherwise the producer's message.
16
16
  *
17
- * ## Why `contract/`
17
+ * ## Where the kit gets it
18
18
  *
19
- * Catalogs also live outside `app/` and cannot see `app/`; the presentation tables, in turn, live in
20
- * the domains' UI homes. `contract/` is the one node both can see — the same reason as `hostText`.
21
- *
22
- * ⚠ **NO HIDDEN FALLBACK.** `errorText` THROWS while the slot is empty. An identity return
23
- * (`error.message`) would silently show the raw message in a realm that forgot to wire it, and no
24
- * measurement would see it.
25
- *
26
- * ⚠ Web workers and the main process do not bind this port: the code there turns the error into text
27
- * with `toErrorMessage` (`base/errorMessage`). Measured: `errorText` + `t` entering the markdown
28
- * worker split the worker bundle (the `iife` format does not support code splitting) — the build
29
- * failed; it would have thrown at run time too.
19
+ * The application hands its presenter to the kit's components (`KitHost.errorPresenter`) and to its
20
+ * notification service; a catalog's builder receives `errorText` with its render host, a helper that
21
+ * phrases an error takes it as a parameter. There is no module slot and no default: a realm that
22
+ * forgot its presenter fails at the first sentence instead of quietly showing raw messages.
30
23
  *
31
24
  * ## Actions
32
25
  *
33
- * The same presenter also provides the error's ACTIONS (`errorActions`, the precedent's
26
+ * The same presenter also provides the error's ACTIONS (`actions`, the precedent's
34
27
  * `createErrorWithActions`): those attached to the error (`base/errors/errorActions`) and those the
35
28
  * domain's action table derives from the carried fact. A notification carries the error it presents
36
29
  * in its payload (`cause`) and the actions become buttons — the caller collects no actions.
@@ -51,11 +44,8 @@ export interface HostErrorPresenter {
51
44
  readonly actions: ErrorActionsFn;
52
45
  }
53
46
  /**
54
- * THE SHELL PUBLISHES THE PRESENTER — once at boot, from the host app's port wiring. `null` returns
55
- * to the kit's default.
47
+ * The presenter of an application without presentation tables: the error's own message (or the
48
+ * caller's sentence for a message-less value) and the actions attached to the error. An application
49
+ * chooses it explicitly; the kit never falls back to it.
56
50
  */
57
- export declare function provideHostErrorPresenter(next: HostErrorPresenter | null): void;
58
- /** The sentence of the error for the user — see {@link ErrorTextFn}. */
59
- export declare function errorText(error: unknown, general: string): string;
60
- /** The actions of the error — see {@link ErrorActionsFn}. */
61
- export declare function errorActions(error: unknown): readonly ErrorAction[];
51
+ export declare const messageErrorPresenter: HostErrorPresenter;
@@ -1,5 +1,6 @@
1
1
  import type { NotificationPriority, NotificationSeverity, NotificationSourceId, ToastAction } from './notification.cjs';
2
2
  import type { VendorErrorRef } from './vendorErrorRef.cjs';
3
+ import type { ErrorTextFn } from './hostErrorText.cjs';
3
4
  export type NotificationDelivery = 'in-app' | 'os-only';
4
5
  export type NotificationKind = 'message' | 'progress' | 'query-completed';
5
6
  /** Routing policy owned by the feature that defines a user-visible meaning. */
@@ -40,20 +41,30 @@ export interface NotificationCatalogPayload {
40
41
  /** Vendor code of an error notification — only from the fact or from the catalog sample; see `ToastErrorOptions`. */
41
42
  readonly vendorError?: VendorErrorRef;
42
43
  }
44
+ /**
45
+ * What a definition's builder may ask of the realm that delivers it — the sentence of an error it
46
+ * presents (`errorText(cause, general)`), from the realm's single error presenter. The builder takes it
47
+ * as its second argument instead of reaching a module slot, so a catalog renders the same way in every
48
+ * realm and in a preview.
49
+ */
50
+ export interface NotificationRenderHost {
51
+ readonly errorText: ErrorTextFn;
52
+ }
43
53
  export interface NotificationDefinition<TParams, TKind extends NotificationKind = NotificationKind> extends NotificationCatalogMetadata<TKind> {
44
- readonly build: (params: TParams) => NotificationCatalogPayload;
54
+ readonly build: (params: TParams, host: NotificationRenderHost) => NotificationCatalogPayload;
45
55
  }
46
56
  /**
47
57
  * Makes a feature-local, typed notification definition. The builder is pure:
48
- * user-facing text and interactions are derived from typed parameters before
49
- * the app delivery adapter performs its side effect.
58
+ * user-facing text and interactions are derived from typed parameters (and, for
59
+ * an error's sentence, the render host) before the delivery performs its side
60
+ * effect.
50
61
  */
51
- export declare function defineNotification<TParams, TKind extends NotificationKind = NotificationKind>(metadata: NotificationCatalogMetadataInput<TKind>, build: (params: TParams) => NotificationCatalogPayload): NotificationDefinition<TParams, TKind>;
62
+ export declare function defineNotification<TParams, TKind extends NotificationKind = NotificationKind>(metadata: NotificationCatalogMetadataInput<TKind>, build: (params: TParams, host: NotificationRenderHost) => NotificationCatalogPayload): NotificationDefinition<TParams, TKind>;
52
63
  /** A heterogeneous developer scenario that can be collected by module glob. */
53
64
  export interface NotificationScenarioDescriptor {
54
65
  readonly id: string;
55
66
  readonly notification: NotificationCatalogMetadata;
56
- readonly resolve: () => NotificationCatalogPayload;
67
+ readonly resolve: (host: NotificationRenderHost) => NotificationCatalogPayload;
57
68
  }
58
69
  /** Erases parameter types only after the scenario has captured its own values. */
59
70
  export declare function defineNotificationScenario<TParams>(id: string, notification: NotificationDefinition<TParams>, params: TParams): NotificationScenarioDescriptor;
@@ -1,5 +1,6 @@
1
1
  import type { NotificationPriority, NotificationSeverity, NotificationSourceId, ToastAction } from './notification.js';
2
2
  import type { VendorErrorRef } from './vendorErrorRef.js';
3
+ import type { ErrorTextFn } from './hostErrorText.js';
3
4
  export type NotificationDelivery = 'in-app' | 'os-only';
4
5
  export type NotificationKind = 'message' | 'progress' | 'query-completed';
5
6
  /** Routing policy owned by the feature that defines a user-visible meaning. */
@@ -40,20 +41,30 @@ export interface NotificationCatalogPayload {
40
41
  /** Vendor code of an error notification — only from the fact or from the catalog sample; see `ToastErrorOptions`. */
41
42
  readonly vendorError?: VendorErrorRef;
42
43
  }
44
+ /**
45
+ * What a definition's builder may ask of the realm that delivers it — the sentence of an error it
46
+ * presents (`errorText(cause, general)`), from the realm's single error presenter. The builder takes it
47
+ * as its second argument instead of reaching a module slot, so a catalog renders the same way in every
48
+ * realm and in a preview.
49
+ */
50
+ export interface NotificationRenderHost {
51
+ readonly errorText: ErrorTextFn;
52
+ }
43
53
  export interface NotificationDefinition<TParams, TKind extends NotificationKind = NotificationKind> extends NotificationCatalogMetadata<TKind> {
44
- readonly build: (params: TParams) => NotificationCatalogPayload;
54
+ readonly build: (params: TParams, host: NotificationRenderHost) => NotificationCatalogPayload;
45
55
  }
46
56
  /**
47
57
  * Makes a feature-local, typed notification definition. The builder is pure:
48
- * user-facing text and interactions are derived from typed parameters before
49
- * the app delivery adapter performs its side effect.
58
+ * user-facing text and interactions are derived from typed parameters (and, for
59
+ * an error's sentence, the render host) before the delivery performs its side
60
+ * effect.
50
61
  */
51
- export declare function defineNotification<TParams, TKind extends NotificationKind = NotificationKind>(metadata: NotificationCatalogMetadataInput<TKind>, build: (params: TParams) => NotificationCatalogPayload): NotificationDefinition<TParams, TKind>;
62
+ export declare function defineNotification<TParams, TKind extends NotificationKind = NotificationKind>(metadata: NotificationCatalogMetadataInput<TKind>, build: (params: TParams, host: NotificationRenderHost) => NotificationCatalogPayload): NotificationDefinition<TParams, TKind>;
52
63
  /** A heterogeneous developer scenario that can be collected by module glob. */
53
64
  export interface NotificationScenarioDescriptor {
54
65
  readonly id: string;
55
66
  readonly notification: NotificationCatalogMetadata;
56
- readonly resolve: () => NotificationCatalogPayload;
67
+ readonly resolve: (host: NotificationRenderHost) => NotificationCatalogPayload;
57
68
  }
58
69
  /** Erases parameter types only after the scenario has captured its own values. */
59
70
  export declare function defineNotificationScenario<TParams>(id: string, notification: NotificationDefinition<TParams>, params: TParams): NotificationScenarioDescriptor;
@@ -1,3 +1,10 @@
1
+ /**
2
+ * Screen-reader live announcements (polite and assertive).
3
+ *
4
+ * A plain class: the application creates the one instance, hands it to the kit through
5
+ * `KitHost.announcer` and announces through it itself. The kit's `AriaAnnouncer` renders what it
6
+ * announces.
7
+ */
1
8
  import { type Event } from '../../base/event.cjs';
2
9
  import type { IDisposable } from '../../base/lifecycle.cjs';
3
10
  export type AnnouncePoliteness = 'polite' | 'assertive';
@@ -13,8 +20,7 @@ export interface Announcement {
13
20
  readonly politeness: AnnouncePoliteness;
14
21
  readonly timestamp: number;
15
22
  }
16
- export interface IAnnouncerService {
17
- readonly _serviceBrand: undefined;
23
+ export interface Announcer {
18
24
  announce(message: string, politenessOrOptions?: AnnouncePoliteness | AnnounceOptions, options?: AnnounceOptions): void;
19
25
  polite(message: string, options?: AnnounceOptions): void;
20
26
  assertive(message: string, options?: AnnounceOptions): void;
@@ -23,9 +29,7 @@ export interface IAnnouncerService {
23
29
  readonly onDidClear: Event<AnnouncePoliteness | 'all'>;
24
30
  getLatestAnnouncement(politeness: AnnouncePoliteness): string;
25
31
  }
26
- export declare const IAnnouncerService: import("../instantiation/common/instantiation.cjs").ServiceIdentifier<IAnnouncerService>;
27
- export declare class AnnouncerService implements IAnnouncerService, IDisposable {
28
- readonly _serviceBrand: undefined;
32
+ export declare class AnnouncerService implements Announcer, IDisposable {
29
33
  private readonly _onDidAnnounce;
30
34
  readonly onDidAnnounce: Event<Announcement>;
31
35
  private readonly _onDidClear;
@@ -40,11 +44,3 @@ export declare class AnnouncerService implements IAnnouncerService, IDisposable
40
44
  getLatestAnnouncement(politeness: AnnouncePoliteness): string;
41
45
  dispose(): void;
42
46
  }
43
- export declare function getAnnouncerService(): IAnnouncerService;
44
- export declare function setAnnouncerServiceForTest(mock: IAnnouncerService | undefined): void;
45
- export declare function useAnnounce(): {
46
- announce: (message: string, politenessOrOptions?: AnnouncePoliteness | AnnounceOptions, options?: AnnounceOptions) => void;
47
- polite: (message: string, options?: AnnounceOptions) => void;
48
- assertive: (message: string, options?: AnnounceOptions) => void;
49
- clear: (politeness?: AnnouncePoliteness) => void;
50
- };
@@ -1,3 +1,10 @@
1
+ /**
2
+ * Screen-reader live announcements (polite and assertive).
3
+ *
4
+ * A plain class: the application creates the one instance, hands it to the kit through
5
+ * `KitHost.announcer` and announces through it itself. The kit's `AriaAnnouncer` renders what it
6
+ * announces.
7
+ */
1
8
  import { type Event } from '../../base/event.js';
2
9
  import type { IDisposable } from '../../base/lifecycle.js';
3
10
  export type AnnouncePoliteness = 'polite' | 'assertive';
@@ -13,8 +20,7 @@ export interface Announcement {
13
20
  readonly politeness: AnnouncePoliteness;
14
21
  readonly timestamp: number;
15
22
  }
16
- export interface IAnnouncerService {
17
- readonly _serviceBrand: undefined;
23
+ export interface Announcer {
18
24
  announce(message: string, politenessOrOptions?: AnnouncePoliteness | AnnounceOptions, options?: AnnounceOptions): void;
19
25
  polite(message: string, options?: AnnounceOptions): void;
20
26
  assertive(message: string, options?: AnnounceOptions): void;
@@ -23,9 +29,7 @@ export interface IAnnouncerService {
23
29
  readonly onDidClear: Event<AnnouncePoliteness | 'all'>;
24
30
  getLatestAnnouncement(politeness: AnnouncePoliteness): string;
25
31
  }
26
- export declare const IAnnouncerService: import("../instantiation/common/instantiation.js").ServiceIdentifier<IAnnouncerService>;
27
- export declare class AnnouncerService implements IAnnouncerService, IDisposable {
28
- readonly _serviceBrand: undefined;
32
+ export declare class AnnouncerService implements Announcer, IDisposable {
29
33
  private readonly _onDidAnnounce;
30
34
  readonly onDidAnnounce: Event<Announcement>;
31
35
  private readonly _onDidClear;
@@ -40,11 +44,3 @@ export declare class AnnouncerService implements IAnnouncerService, IDisposable
40
44
  getLatestAnnouncement(politeness: AnnouncePoliteness): string;
41
45
  dispose(): void;
42
46
  }
43
- export declare function getAnnouncerService(): IAnnouncerService;
44
- export declare function setAnnouncerServiceForTest(mock: IAnnouncerService | undefined): void;
45
- export declare function useAnnounce(): {
46
- announce: (message: string, politenessOrOptions?: AnnouncePoliteness | AnnounceOptions, options?: AnnounceOptions) => void;
47
- polite: (message: string, options?: AnnounceOptions) => void;
48
- assertive: (message: string, options?: AnnounceOptions) => void;
49
- clear: (politeness?: AnnouncePoliteness) => void;
50
- };
@@ -5,10 +5,12 @@
5
5
  * redacted Markdown document that users can copy and paste into bug reports.
6
6
  */
7
7
  export interface DiagnosticReportOptions {
8
+ /** The product name the report's title writes; `''` writes none. */
9
+ readonly appName: string;
8
10
  readonly context?: Record<string, unknown> | undefined;
9
11
  readonly maxBreadcrumbs?: number | undefined;
10
12
  }
11
13
  /**
12
14
  * Generate a complete markdown diagnostic report.
13
15
  */
14
- export declare function generateDiagnosticReport(error: unknown, options?: DiagnosticReportOptions): string;
16
+ export declare function generateDiagnosticReport(error: unknown, options: DiagnosticReportOptions): string;
@@ -5,10 +5,12 @@
5
5
  * redacted Markdown document that users can copy and paste into bug reports.
6
6
  */
7
7
  export interface DiagnosticReportOptions {
8
+ /** The product name the report's title writes; `''` writes none. */
9
+ readonly appName: string;
8
10
  readonly context?: Record<string, unknown> | undefined;
9
11
  readonly maxBreadcrumbs?: number | undefined;
10
12
  }
11
13
  /**
12
14
  * Generate a complete markdown diagnostic report.
13
15
  */
14
- export declare function generateDiagnosticReport(error: unknown, options?: DiagnosticReportOptions): string;
16
+ export declare function generateDiagnosticReport(error: unknown, options: DiagnosticReportOptions): string;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * A logger that writes to the console — for a host without a logging pipeline of its own (a page, a
3
+ * demo, a test). It redacts secrets like every `Logger`. A host with its own pipeline hands the kit its
4
+ * own logger instead (`KitHost.log`); the kit keeps no root logger of its own.
5
+ */
6
+ import { LogLevel, type ILogger } from '../../base/logging/ILogger.cjs';
7
+ export declare function createConsoleLogger(level?: LogLevel): ILogger;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * A logger that writes to the console — for a host without a logging pipeline of its own (a page, a
3
+ * demo, a test). It redacts secrets like every `Logger`. A host with its own pipeline hands the kit its
4
+ * own logger instead (`KitHost.log`); the kit keeps no root logger of its own.
5
+ */
6
+ import { LogLevel, type ILogger } from '../../base/logging/ILogger.js';
7
+ export declare function createConsoleLogger(level?: LogLevel): ILogger;
@@ -18,10 +18,12 @@
18
18
  * Type safety is preserved: `fields` is checked field-by-field against `T`, and
19
19
  * `get()` returns `T`. No `string`-keyed casts leak to callers.
20
20
  *
21
- * The renderer logger is now `import.meta`-free (its dev flag is injected at boot
22
- * via `configureRendererLogging`), so the core imports it DIRECTLY — descriptors
23
- * stay loadable under ts-jest without the old lazy `await import('logger')` hatch.
21
+ * A group is used only after it is hydrated: the realm binds its storage and hydrates
22
+ * every group once at startup (`hydrateRegisteredSettings(backend)`), and a group read
23
+ * or written before that throws — a read would otherwise answer the default while the
24
+ * user's stored choice sits unread.
24
25
  */
26
+ import { type SettingsBackend } from './stateDbStore.cjs';
25
27
  import type { FieldSpec, FieldSpecs, SettingsScopeName, UiControl, UiFieldMeta, UiFieldSchema } from './fieldSpec.cjs';
26
28
  export type { FieldSpec, FieldSpecs, SettingsScopeName, UiControl, UiFieldMeta, UiFieldSchema, };
27
29
  /**
@@ -212,13 +214,22 @@ export interface DefineSettingsOptions<T> {
212
214
  readonly disallowPluginDefaults?: boolean;
213
215
  }
214
216
  /**
215
- * Hydrates every registered group and GUARANTEES that those registered afterwards are
216
- * hydrated too.
217
+ * BINDS THE REALM'S SETTINGS STORAGE and hydrates every registered group from it — once, at startup.
217
218
  *
218
- * The boot path calls this once. A second call is harmless (hydration is idempotent); still,
219
- * the only call site is `hydrateAllSettings`.
219
+ * The backend is the explicit argument: settings groups are module-level declarations shared by
220
+ * every root of the realm, so the realm binds their storage once, at the moment it reads them.
221
+ * A second call throws (`bindSettingsBackend`).
222
+ *
223
+ * ## Registration ORDER is not a correctness condition
224
+ *
225
+ * A descriptor module evaluated AFTER this call — a vendor bringing its own setting, a bundle
226
+ * made lazy with `import()` — registers a group this walk never saw. Such a group is hydrated
227
+ * the moment it registers (see `makeGroup`), from the same bound backend: otherwise the user's
228
+ * stored preference would never be read, the screen would show the default and no error would
229
+ * appear. *A correctness condition that relies on module evaluation order is not written down
230
+ * but coincidental.*
220
231
  */
221
- export declare function hydrateRegisteredSettings(): void;
232
+ export declare function hydrateRegisteredSettings(backend: SettingsBackend): void;
222
233
  /** Every descriptor defined so far — drives the structure conformance gate. */
223
234
  export declare function getRegisteredSettingsGroups(): readonly SettingsGroupLifecycle<unknown>[];
224
235
  /**
@@ -18,10 +18,12 @@
18
18
  * Type safety is preserved: `fields` is checked field-by-field against `T`, and
19
19
  * `get()` returns `T`. No `string`-keyed casts leak to callers.
20
20
  *
21
- * The renderer logger is now `import.meta`-free (its dev flag is injected at boot
22
- * via `configureRendererLogging`), so the core imports it DIRECTLY — descriptors
23
- * stay loadable under ts-jest without the old lazy `await import('logger')` hatch.
21
+ * A group is used only after it is hydrated: the realm binds its storage and hydrates
22
+ * every group once at startup (`hydrateRegisteredSettings(backend)`), and a group read
23
+ * or written before that throws — a read would otherwise answer the default while the
24
+ * user's stored choice sits unread.
24
25
  */
26
+ import { type SettingsBackend } from './stateDbStore.js';
25
27
  import type { FieldSpec, FieldSpecs, SettingsScopeName, UiControl, UiFieldMeta, UiFieldSchema } from './fieldSpec.js';
26
28
  export type { FieldSpec, FieldSpecs, SettingsScopeName, UiControl, UiFieldMeta, UiFieldSchema, };
27
29
  /**
@@ -212,13 +214,22 @@ export interface DefineSettingsOptions<T> {
212
214
  readonly disallowPluginDefaults?: boolean;
213
215
  }
214
216
  /**
215
- * Hydrates every registered group and GUARANTEES that those registered afterwards are
216
- * hydrated too.
217
+ * BINDS THE REALM'S SETTINGS STORAGE and hydrates every registered group from it — once, at startup.
217
218
  *
218
- * The boot path calls this once. A second call is harmless (hydration is idempotent); still,
219
- * the only call site is `hydrateAllSettings`.
219
+ * The backend is the explicit argument: settings groups are module-level declarations shared by
220
+ * every root of the realm, so the realm binds their storage once, at the moment it reads them.
221
+ * A second call throws (`bindSettingsBackend`).
222
+ *
223
+ * ## Registration ORDER is not a correctness condition
224
+ *
225
+ * A descriptor module evaluated AFTER this call — a vendor bringing its own setting, a bundle
226
+ * made lazy with `import()` — registers a group this walk never saw. Such a group is hydrated
227
+ * the moment it registers (see `makeGroup`), from the same bound backend: otherwise the user's
228
+ * stored preference would never be read, the screen would show the default and no error would
229
+ * appear. *A correctness condition that relies on module evaluation order is not written down
230
+ * but coincidental.*
220
231
  */
221
- export declare function hydrateRegisteredSettings(): void;
232
+ export declare function hydrateRegisteredSettings(backend: SettingsBackend): void;
222
233
  /** Every descriptor defined so far — drives the structure conformance gate. */
223
234
  export declare function getRegisteredSettingsGroups(): readonly SettingsGroupLifecycle<unknown>[];
224
235
  /**
@@ -1,35 +1,43 @@
1
1
  /**
2
- * ui adapter: same API as the host app's settings state store (`stateDbStore(key, target)`,
3
- * `SCOPE_MAP`), backed by an in-memory map instead of the host app's state database. Values
4
- * round-trip through JSON exactly like the original, so a settings descriptor behaves the same
5
- * (defaults until written, normalised on read). A host can swap the backend with
6
- * {@link configureSettingsBackend}.
2
+ * The settings storage — where the settings groups of a realm read and write their raw values.
3
+ *
4
+ * Settings groups are module-level declarations shared by every root of the realm, so their storage is
5
+ * the realm's too: the realm binds its backend once, when it hydrates its settings
6
+ * (`hydrateRegisteredSettings(backend)`). There is no default backend — a store used before the realm
7
+ * bound one throws, so a realm that forgot the binding fails at its first read instead of quietly keeping
8
+ * the user's settings in memory. A stored value that is not JSON is an error of its own
9
+ * ({@link StoredSettingUnreadableError}), never "unset": reading a corrupt entry as the default would hide
10
+ * that the user's choice was lost.
7
11
  */
8
12
  import type { SettingsStore } from './defineSettings.cjs';
9
13
  import type { SettingsScopeName } from './fieldSpec.cjs';
10
- /** Storage scope ids — the host app's `StorageScope` values, kept for SCOPE_MAP parity. */
14
+ /** Storage scope ids — the values a host's storage service keys its scopes by. */
11
15
  export declare enum StorageScope {
12
16
  APPLICATION = -1,
13
17
  PROFILE = 0,
14
18
  WORKSPACE = 1,
15
19
  CONNECTION = 2
16
20
  }
17
- /** Storage target ids — the host app's `StorageTarget` values. */
21
+ /** Storage target ids — whether a value follows the user (synced) or stays on the machine. */
18
22
  export declare enum StorageTarget {
19
23
  USER = 0,
20
24
  MACHINE = 1
21
25
  }
22
26
  export declare const SCOPE_MAP: Record<SettingsScopeName, StorageScope>;
23
- /** ui extension: the raw string backend behind every settings store. */
27
+ /** The raw string backend behind every settings store — the host's storage service. */
24
28
  export interface SettingsBackend {
25
29
  get(key: string, scope: StorageScope): string | undefined;
26
30
  store(key: string, value: string, scope: StorageScope, target: StorageTarget): void;
27
31
  }
28
- /** ui extension: replace the settings backend (default: in-memory, nothing persisted). */
29
- export declare function configureSettingsBackend(next: SettingsBackend | null): void;
30
- /**
31
- * ui extension: the backend in use — state the kit persists outside settings groups (menu
32
- * favourites, tour status) shares it, under the host app's keys.
33
- */
34
- export declare function getSettingsBackend(): SettingsBackend;
32
+ /** A stored settings value that does not parse — reported, and its layer read as unset. */
33
+ export declare class StoredSettingUnreadableError extends Error {
34
+ readonly key: string;
35
+ readonly scope: SettingsScopeName;
36
+ constructor(key: string, scope: SettingsScopeName, cause: unknown);
37
+ }
38
+ /** Binds the realm's settings backend — once, from `hydrateRegisteredSettings`. */
39
+ export declare function bindSettingsBackend(backend: SettingsBackend): void;
40
+ /** Whether the realm bound its backend — a group registered after that is hydrated at once. */
41
+ export declare function isSettingsBackendBound(): boolean;
42
+ /** The store of one settings key over the realm's backend. */
35
43
  export declare function stateDbStore<T>(key: string, target?: StorageTarget): SettingsStore<T>;
@@ -1,35 +1,43 @@
1
1
  /**
2
- * ui adapter: same API as the host app's settings state store (`stateDbStore(key, target)`,
3
- * `SCOPE_MAP`), backed by an in-memory map instead of the host app's state database. Values
4
- * round-trip through JSON exactly like the original, so a settings descriptor behaves the same
5
- * (defaults until written, normalised on read). A host can swap the backend with
6
- * {@link configureSettingsBackend}.
2
+ * The settings storage — where the settings groups of a realm read and write their raw values.
3
+ *
4
+ * Settings groups are module-level declarations shared by every root of the realm, so their storage is
5
+ * the realm's too: the realm binds its backend once, when it hydrates its settings
6
+ * (`hydrateRegisteredSettings(backend)`). There is no default backend — a store used before the realm
7
+ * bound one throws, so a realm that forgot the binding fails at its first read instead of quietly keeping
8
+ * the user's settings in memory. A stored value that is not JSON is an error of its own
9
+ * ({@link StoredSettingUnreadableError}), never "unset": reading a corrupt entry as the default would hide
10
+ * that the user's choice was lost.
7
11
  */
8
12
  import type { SettingsStore } from './defineSettings.js';
9
13
  import type { SettingsScopeName } from './fieldSpec.js';
10
- /** Storage scope ids — the host app's `StorageScope` values, kept for SCOPE_MAP parity. */
14
+ /** Storage scope ids — the values a host's storage service keys its scopes by. */
11
15
  export declare enum StorageScope {
12
16
  APPLICATION = -1,
13
17
  PROFILE = 0,
14
18
  WORKSPACE = 1,
15
19
  CONNECTION = 2
16
20
  }
17
- /** Storage target ids — the host app's `StorageTarget` values. */
21
+ /** Storage target ids — whether a value follows the user (synced) or stays on the machine. */
18
22
  export declare enum StorageTarget {
19
23
  USER = 0,
20
24
  MACHINE = 1
21
25
  }
22
26
  export declare const SCOPE_MAP: Record<SettingsScopeName, StorageScope>;
23
- /** ui extension: the raw string backend behind every settings store. */
27
+ /** The raw string backend behind every settings store — the host's storage service. */
24
28
  export interface SettingsBackend {
25
29
  get(key: string, scope: StorageScope): string | undefined;
26
30
  store(key: string, value: string, scope: StorageScope, target: StorageTarget): void;
27
31
  }
28
- /** ui extension: replace the settings backend (default: in-memory, nothing persisted). */
29
- export declare function configureSettingsBackend(next: SettingsBackend | null): void;
30
- /**
31
- * ui extension: the backend in use — state the kit persists outside settings groups (menu
32
- * favourites, tour status) shares it, under the host app's keys.
33
- */
34
- export declare function getSettingsBackend(): SettingsBackend;
32
+ /** A stored settings value that does not parse — reported, and its layer read as unset. */
33
+ export declare class StoredSettingUnreadableError extends Error {
34
+ readonly key: string;
35
+ readonly scope: SettingsScopeName;
36
+ constructor(key: string, scope: SettingsScopeName, cause: unknown);
37
+ }
38
+ /** Binds the realm's settings backend — once, from `hydrateRegisteredSettings`. */
39
+ export declare function bindSettingsBackend(backend: SettingsBackend): void;
40
+ /** Whether the realm bound its backend — a group registered after that is hydrated at once. */
41
+ export declare function isSettingsBackendBound(): boolean;
42
+ /** The store of one settings key over the realm's backend. */
35
43
  export declare function stateDbStore<T>(key: string, target?: StorageTarget): SettingsStore<T>;
@@ -730,9 +730,6 @@ export interface NotificationSettings {
730
730
  * `prefers-reduced-motion` media query for users who want explicit control. */
731
731
  reduceMotion: boolean;
732
732
  }
733
- export interface ExitConfirmationSettings {
734
- dontAskAgain: boolean;
735
- }
736
733
  /**
737
734
  * Window/file lifecycle preferences. `confirmBeforeClose` mirrors the standard
738
735
  * tri-state guard against accidental quit.
@@ -1413,8 +1410,6 @@ export interface VaultSettings {
1413
1410
  sshState?: VaultSshPreferences;
1414
1411
  /** Generic UI layout state (sidebar widths, column visibility). */
1415
1412
  uiLayoutState?: UiLayoutPreferences;
1416
- /** Exit-confirmation "don't ask again" flag — read by the main process at quit. */
1417
- exitConfirmationSettings?: ExitConfirmationSettings;
1418
1413
  /** User-pinned bookmarks (files / SQL queries). */
1419
1414
  bookmarks?: Bookmark[];
1420
1415
  /** Saved SQL snippets surfaced as a "Virtual Views" panel. */