@vokril/ui-solid 0.13.0 → 0.18.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 (585) hide show
  1. package/CHANGELOG.md +52 -0
  2. package/README.md +110 -31
  3. package/dist/{AttributeGrid-Bg88JYZI.cjs → AttributeGrid-7cLOWtPn.cjs} +1 -1
  4. package/dist/{AttributeGrid-BypjAajJ.js → AttributeGrid-CVyqzT7-.js} +5 -5
  5. package/dist/{Button-Db6wMY-3.js → Button-BiKPB3cH.js} +2 -2
  6. package/dist/{Button-d9jJBibg.cjs → Button-Nx7byQZc.cjs} +1 -1
  7. package/dist/CommandPalette-BH7c1cbU.js +3968 -0
  8. package/dist/CommandPalette-Dfb4V-Hb.cjs +2 -0
  9. package/dist/{CopyButton-C93PFyYK.js → CopyButton-BF7L1TCO.js} +1 -1
  10. package/dist/{CopyButton-CXaZRU7b.cjs → CopyButton-BtgGbiy9.cjs} +1 -1
  11. package/dist/DateRangePicker-Ce2tTbJ4.cjs +9 -0
  12. package/dist/{DateRangePicker-D-5rg3h1.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-DPT-QfsC.cjs → IconPicker-4bdAeGxS.cjs} +1 -1
  20. package/dist/{IconPicker-C3ZwWkB1.js → IconPicker-Df6uIUpJ.js} +4 -4
  21. package/dist/{Input-Ca8fLm_s.cjs → Input-CZruORyy.cjs} +1 -1
  22. package/dist/{Input-gq8EcQao.js → Input-DkPhsdfk.js} +2 -2
  23. package/dist/Modal-CQG8l4x7.cjs +1 -0
  24. package/dist/{Modal-C4l_yuY9.js → Modal-CUPe98-o.js} +5 -5
  25. package/dist/PageSkeleton-C3mo6UGh.cjs +30 -0
  26. package/dist/{PageSkeleton-C95fXUUk.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-BpOD2_A-.js → SearchableSelect-C01brsF0.js} +5 -5
  30. package/dist/{SearchableSelect-MN5azo9r.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-BgDx1cPX.js → Stepper-38IAEOyT.js} +3 -3
  34. package/dist/{Stepper-D7rXGxdg.cjs → Stepper-CtaTpnQu.cjs} +1 -1
  35. package/dist/{Textarea-BueHsjOk.js → Textarea-B5QqqKnI.js} +1 -1
  36. package/dist/{Textarea-BltpSavs.cjs → Textarea-CeAGf08O.cjs} +1 -1
  37. package/dist/{TimeSeriesChart-C3o7NZPh.js → TimeSeriesChart-ByKG4E1G.js} +2 -2
  38. package/dist/{TimeSeriesChart-DhYtrAgX.cjs → TimeSeriesChart-_NOs_Job.cjs} +1 -1
  39. package/dist/ToggleButton-Bz3zAtec.cjs +1 -0
  40. package/dist/{ToggleButton-DCP7f6Uo.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 +8 -4
  58. package/dist/_internal/app/settings/secrets/notificationSecrets.d.ts +8 -4
  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/errors/diagnosticReport.d.cts +3 -1
  68. package/dist/_internal/platform/errors/diagnosticReport.d.ts +3 -1
  69. package/dist/_internal/platform/logging/consoleLogger.d.cts +7 -0
  70. package/dist/_internal/platform/logging/consoleLogger.d.ts +7 -0
  71. package/dist/_internal/platform/settings/registry/defineSettings.d.cts +19 -8
  72. package/dist/_internal/platform/settings/registry/defineSettings.d.ts +19 -8
  73. package/dist/_internal/platform/settings/registry/stateDbStore.d.cts +23 -15
  74. package/dist/_internal/platform/settings/registry/stateDbStore.d.ts +23 -15
  75. package/dist/_internal/platform/settings/settingsTypes.d.cts +5 -0
  76. package/dist/_internal/platform/settings/settingsTypes.d.ts +5 -0
  77. package/dist/_internal/platform/vendorErrors/index.d.cts +7 -17
  78. package/dist/_internal/platform/vendorErrors/index.d.ts +7 -17
  79. package/dist/_internal/platform/window/displayOwner.d.cts +35 -14
  80. package/dist/_internal/platform/window/displayOwner.d.ts +35 -14
  81. package/dist/a11y/index.cjs +1 -1
  82. package/dist/a11y/index.js +1 -1
  83. package/dist/actions-DtaFGwh2.cjs +1 -0
  84. package/dist/actions-wwAHs3ZU.js +16 -0
  85. package/dist/{server/appThemeDerivation-BiCyiSuz.js → appThemeDerivation-B7-DjMIM.js} +181 -184
  86. package/dist/appThemeDerivation-NS3Vws8q.cjs +1 -0
  87. package/dist/async/createGuardedListLoader.d.cts +3 -0
  88. package/dist/async/createGuardedListLoader.d.ts +3 -0
  89. package/dist/charts/index.cjs +1 -1
  90. package/dist/charts/index.js +1 -1
  91. package/dist/createDialogShellFocus-BBFu3Z_O.js +282 -0
  92. package/dist/createDialogShellFocus-CxRqhbRN.cjs +1 -0
  93. package/dist/createResizableSidebar-CfFxQUny.js +449 -0
  94. package/dist/createResizableSidebar-q7aC7SAO.cjs +1 -0
  95. package/dist/{createVirtualScroller-LN-7QFiv.cjs → createVirtualScroller-CL49JE2P.cjs} +1 -1
  96. package/dist/{server/createVirtualScroller-DBvqT0UW.js → createVirtualScroller-vu-l4rVv.js} +7 -7
  97. package/dist/defineSettings-D0CSMcyy.cjs +1 -0
  98. package/dist/defineSettings-Di1sG81q.js +407 -0
  99. package/dist/descriptor-CaHgh9N_.cjs +1 -0
  100. package/dist/{descriptor-CrCl515S.js → descriptor-eGtcBtpI.js} +5 -5
  101. package/dist/desktop/index.cjs +1 -1
  102. package/dist/desktop/index.js +500 -426
  103. package/dist/dialogFocusRestore-BrALT8Ew.js +35 -0
  104. package/dist/dialogFocusRestore-CcEsB50v.cjs +1 -0
  105. package/dist/electronBridge-BK92fycw.js +235 -0
  106. package/dist/electronBridge-cT0xww92.cjs +1 -0
  107. package/dist/errorHandler-BvPGW-Nm.js +373 -0
  108. package/dist/errorHandler-DoDAPpv2.cjs +3 -0
  109. package/dist/feedback/Loader.d.cts +6 -1
  110. package/dist/feedback/Loader.d.ts +6 -1
  111. package/dist/feedback/createPreference.d.cts +4 -1
  112. package/dist/feedback/createPreference.d.ts +4 -1
  113. package/dist/feedback/guidedInstallOutcome.d.cts +15 -2
  114. package/dist/feedback/guidedInstallOutcome.d.ts +15 -2
  115. package/dist/feedback/index.cjs +1 -1
  116. package/dist/feedback/index.js +37 -38
  117. package/dist/feedback/readFailureText.d.cts +20 -1
  118. package/dist/feedback/readFailureText.d.ts +20 -1
  119. package/dist/focusModality-BISb6-yg.cjs +1 -0
  120. package/dist/focusModality-FoLPWF-_.js +135 -0
  121. package/dist/forms/index.cjs +1 -1
  122. package/dist/forms/index.js +9 -9
  123. package/dist/grid/index.cjs +1 -1
  124. package/dist/grid/index.js +1 -1
  125. package/dist/{headerIconOverrides-DY3BTuca.cjs → headerIconOverrides-Bn1QuODq.cjs} +1 -1
  126. package/dist/{server/headerIconOverrides-B7TQUBmD.js → headerIconOverrides-Dh2PaOcO.js} +1 -1
  127. package/dist/host/index.cjs +1 -1
  128. package/dist/host/index.d.cts +14 -16
  129. package/dist/host/index.d.ts +14 -16
  130. package/dist/host/index.js +53 -90
  131. package/dist/host/kitHost.d.cts +42 -0
  132. package/dist/host/kitHost.d.ts +42 -0
  133. package/dist/host/window.d.cts +3 -11
  134. package/dist/host/window.d.ts +3 -11
  135. package/dist/i18n/index.cjs +1 -1
  136. package/dist/i18n/index.js +1 -1
  137. package/dist/{server/i18n-D9k9xwuD.js → i18n-DW9kcu0G.js} +180 -178
  138. package/dist/i18n-DZ0JlZal.cjs +4 -0
  139. package/dist/index.cjs +1 -1
  140. package/dist/index.d.cts +1 -1
  141. package/dist/index.d.ts +1 -1
  142. package/dist/index.js +665 -738
  143. package/dist/isOneOf-9EXOSYJu.cjs +1 -0
  144. package/dist/isOneOf-Dtomuazg.js +6 -0
  145. package/dist/{keys-Bfgdfak_.js → keys-B2nlkpqc.js} +6 -9
  146. package/dist/keys-GMxY2wcl.cjs +1 -0
  147. package/dist/layout/createResizableSidebar.d.cts +14 -0
  148. package/dist/layout/createResizableSidebar.d.ts +14 -0
  149. package/dist/layout/index.cjs +1 -1
  150. package/dist/layout/index.js +3 -3
  151. package/dist/layout/sidebarWidthClamp.d.cts +1 -1
  152. package/dist/layout/sidebarWidthClamp.d.ts +1 -1
  153. package/dist/mainRealmDom-C12lr9lm.js +171 -0
  154. package/dist/mainRealmDom-S6teqEr4.cjs +1 -0
  155. package/dist/navigation/index.cjs +1 -1
  156. package/dist/navigation/index.js +1 -1
  157. package/dist/notifications/NotificationHost.d.cts +7 -1
  158. package/dist/notifications/NotificationHost.d.ts +7 -1
  159. package/dist/notifications/NotificationItem.d.cts +48 -15
  160. package/dist/notifications/NotificationItem.d.ts +48 -15
  161. package/dist/notifications/catalogAdapter.d.cts +28 -6
  162. package/dist/notifications/catalogAdapter.d.ts +28 -6
  163. package/dist/notifications/createNotificationPreviewRuntime.d.cts +21 -3
  164. package/dist/notifications/createNotificationPreviewRuntime.d.ts +21 -3
  165. package/dist/notifications/customSoundCache.d.cts +24 -24
  166. package/dist/notifications/customSoundCache.d.ts +24 -24
  167. package/dist/notifications/emailDigest.d.cts +34 -16
  168. package/dist/notifications/emailDigest.d.ts +34 -16
  169. package/dist/notifications/errorActionButtons.d.cts +18 -1
  170. package/dist/notifications/errorActionButtons.d.ts +18 -1
  171. package/dist/notifications/fireNotification.d.cts +27 -17
  172. package/dist/notifications/fireNotification.d.ts +27 -17
  173. package/dist/notifications/index.cjs +1 -1
  174. package/dist/notifications/index.d.cts +6 -12
  175. package/dist/notifications/index.d.ts +6 -12
  176. package/dist/notifications/index.js +64 -104
  177. package/dist/notifications/nativeEngine.d.cts +18 -15
  178. package/dist/notifications/nativeEngine.d.ts +18 -15
  179. package/dist/notifications/notificationAnalytics.d.cts +11 -6
  180. package/dist/notifications/notificationAnalytics.d.ts +11 -6
  181. package/dist/notifications/notificationAudio.d.cts +30 -23
  182. package/dist/notifications/notificationAudio.d.ts +30 -23
  183. package/dist/notifications/notificationCardServices.d.cts +23 -0
  184. package/dist/notifications/notificationCardServices.d.ts +23 -0
  185. package/dist/notifications/notificationOverlayChannel.d.cts +4 -4
  186. package/dist/notifications/notificationOverlayChannel.d.ts +4 -4
  187. package/dist/notifications/notificationOverlaySync.d.cts +7 -2
  188. package/dist/notifications/notificationOverlaySync.d.ts +7 -2
  189. package/dist/notifications/notificationService.d.cts +101 -0
  190. package/dist/notifications/notificationService.d.ts +101 -0
  191. package/dist/notifications/notificationTimeline.d.cts +47 -49
  192. package/dist/notifications/notificationTimeline.d.ts +47 -49
  193. package/dist/notifications/notifications.notifications.d.cts +0 -4
  194. package/dist/notifications/notifications.notifications.d.ts +0 -4
  195. package/dist/notifications/toast.d.cts +24 -28
  196. package/dist/notifications/toast.d.ts +24 -28
  197. package/dist/notifications/webhookDelivery.d.cts +12 -17
  198. package/dist/notifications/webhookDelivery.d.ts +12 -17
  199. package/dist/overlay/ConfirmDialog.d.cts +16 -17
  200. package/dist/overlay/ConfirmDialog.d.ts +16 -17
  201. package/dist/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.d.cts +15 -14
  202. package/dist/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.d.ts +15 -14
  203. package/dist/overlay/command-palette/unifiedSearch/settingsSearchContributor.d.cts +1 -3
  204. package/dist/overlay/command-palette/unifiedSearch/settingsSearchContributor.d.ts +1 -3
  205. package/dist/overlay/command-palette/unifiedSearch/unifiedSearchTypes.d.cts +1 -1
  206. package/dist/overlay/command-palette/unifiedSearch/unifiedSearchTypes.d.ts +1 -1
  207. package/dist/overlay/dialogShellKeyIntent.d.cts +3 -3
  208. package/dist/overlay/dialogShellKeyIntent.d.ts +3 -3
  209. package/dist/overlay/index.cjs +1 -1
  210. package/dist/overlay/index.d.cts +2 -3
  211. package/dist/overlay/index.d.ts +2 -3
  212. package/dist/overlay/index.js +114 -119
  213. package/dist/pageTourState-BcBF8w89.js +516 -0
  214. package/dist/pageTourState-CrbEU7QW.cjs +5 -0
  215. package/dist/server/{AttributeGrid-UJtHTip2.js → AttributeGrid-B2s_rp00.js} +3 -3
  216. package/dist/server/{AttributeGrid-CyMsR4GC.cjs → AttributeGrid-C7aWbIe5.cjs} +1 -1
  217. package/dist/server/{Button-BesBg6eW.js → Button-Ck03cbUs.js} +1 -1
  218. package/dist/server/{Button-PZulLru4.cjs → Button-DWFMF5y0.cjs} +1 -1
  219. package/dist/server/CommandPalette-DwlWZI1s.js +3224 -0
  220. package/dist/server/CommandPalette-VewDIghb.cjs +1 -0
  221. package/dist/server/{CopyButton-D_sN2Ggp.cjs → CopyButton-BOmAUQD4.cjs} +1 -1
  222. package/dist/server/{CopyButton-I5xsXV07.js → CopyButton-UvtFwOtA.js} +1 -1
  223. package/dist/server/DateRangePicker-BJteKzOY.cjs +9 -0
  224. package/dist/server/{DateRangePicker-DGUl2aE3.js → DateRangePicker-Cr58DczM.js} +158 -143
  225. package/dist/server/GuidedTour-C4msn-Ag.js +400 -0
  226. package/dist/server/GuidedTour-Rlsp8rOe.cjs +1 -0
  227. package/dist/server/HostPortal-B9Tzk_uN.cjs +1 -0
  228. package/dist/server/HostPortal-X1iw719T.js +33 -0
  229. package/dist/server/HostWindowContext-B2m0bVra.js +32 -0
  230. package/dist/server/HostWindowContext-_VZCt7xE.cjs +1 -0
  231. package/dist/server/{IconPicker-BlD0VBca.cjs → IconPicker-9DfOxql6.cjs} +1 -1
  232. package/dist/server/{IconPicker-o8hUxjYU.js → IconPicker-N0wub1Aj.js} +4 -4
  233. package/dist/server/Modal-D__GTo-n.cjs +1 -0
  234. package/dist/server/{Modal-DmF6CwfY.js → Modal-DeQjfpkG.js} +3 -3
  235. package/dist/server/{PageSkeleton-BigztY5i.js → PageSkeleton-C41pXOcr.js} +460 -458
  236. package/dist/server/PageSkeleton-D4i-UcnI.cjs +30 -0
  237. package/dist/server/{SearchableSelect-Dn-cssWx.js → SearchableSelect-CEcuBnge.js} +2 -2
  238. package/dist/server/{SearchableSelect-R0Dwz9rz.cjs → SearchableSelect-Ca9g8ztu.cjs} +1 -1
  239. package/dist/server/StatusBarNotificationBell-BotYny7q.cjs +49 -0
  240. package/dist/server/StatusBarNotificationBell-DyEQF2W7.js +13968 -0
  241. package/dist/server/{Stepper-dBm8YaCw.cjs → Stepper--pusyxso.cjs} +1 -1
  242. package/dist/server/{Stepper-BaQ6Kexj.js → Stepper-B_eL85hK.js} +1 -1
  243. package/dist/server/{TimeSeriesChart-BbbfDyeA.js → TimeSeriesChart-aSHquoBv.js} +1 -1
  244. package/dist/server/{TimeSeriesChart-qPgMkkaW.cjs → TimeSeriesChart-nZeB5jtN.cjs} +1 -1
  245. package/dist/server/ToggleButton-57_0SA-V.cjs +1 -0
  246. package/dist/server/{ToggleButton-C0_QpslP.js → ToggleButton-DjlWwgLJ.js} +4 -4
  247. package/dist/server/VpTrash-D49oUUJh.cjs +1 -0
  248. package/dist/server/VpTrash-Dlq8o6Uv.js +298 -0
  249. package/dist/server/a11y/index.cjs +1 -1
  250. package/dist/server/a11y/index.js +1 -1
  251. package/dist/server/actions-DtaFGwh2.cjs +1 -0
  252. package/dist/server/actions-wwAHs3ZU.js +16 -0
  253. package/dist/{appThemeDerivation-BiCyiSuz.js → server/appThemeDerivation-B7-DjMIM.js} +181 -184
  254. package/dist/server/appThemeDerivation-NS3Vws8q.cjs +1 -0
  255. package/dist/server/charts/index.cjs +1 -1
  256. package/dist/server/charts/index.js +1 -1
  257. package/dist/server/{format-CYCi8g4r.js → createDialogShellFocus-DNjzmcGj.js} +110 -126
  258. package/dist/server/createDialogShellFocus-PRRfMli-.cjs +1 -0
  259. package/dist/server/createResizableSidebar-CZtGmUnA.cjs +1 -0
  260. package/dist/server/createResizableSidebar-DdWdAB9l.js +287 -0
  261. package/dist/server/{createVirtualScroller-LN-7QFiv.cjs → createVirtualScroller-CL49JE2P.cjs} +1 -1
  262. package/dist/{createVirtualScroller-DBvqT0UW.js → server/createVirtualScroller-vu-l4rVv.js} +7 -7
  263. package/dist/server/defineSettings-D0CSMcyy.cjs +1 -0
  264. package/dist/server/defineSettings-Di1sG81q.js +407 -0
  265. package/dist/server/descriptor-CEGvvJZh.cjs +1 -0
  266. package/dist/server/{descriptor-DtZDXBe6.js → descriptor-GLoKPx6x.js} +4 -4
  267. package/dist/server/desktop/index.cjs +1 -1
  268. package/dist/server/desktop/index.js +389 -315
  269. package/dist/server/dialogFocusRestore-BrALT8Ew.js +35 -0
  270. package/dist/server/dialogFocusRestore-CcEsB50v.cjs +1 -0
  271. package/dist/server/electronBridge-BK92fycw.js +235 -0
  272. package/dist/server/electronBridge-cT0xww92.cjs +1 -0
  273. package/dist/server/errorHandler-BvPGW-Nm.js +373 -0
  274. package/dist/server/errorHandler-DoDAPpv2.cjs +3 -0
  275. package/dist/server/feedback/index.cjs +1 -1
  276. package/dist/server/feedback/index.js +37 -38
  277. package/dist/server/focusModality-D-nxv8Er.cjs +1 -0
  278. package/dist/server/{focusModality-BCX5GH0P.js → focusModality-nWNVX3JG.js} +41 -41
  279. package/dist/server/forms/index.cjs +1 -1
  280. package/dist/server/forms/index.js +7 -7
  281. package/dist/server/grid/index.cjs +1 -1
  282. package/dist/server/grid/index.js +1 -1
  283. package/dist/server/{headerIconOverrides-DY3BTuca.cjs → headerIconOverrides-Bn1QuODq.cjs} +1 -1
  284. package/dist/{headerIconOverrides-B7TQUBmD.js → server/headerIconOverrides-Dh2PaOcO.js} +1 -1
  285. package/dist/server/host/index.cjs +1 -1
  286. package/dist/server/host/index.js +53 -90
  287. package/dist/server/i18n/index.cjs +1 -1
  288. package/dist/server/i18n/index.js +1 -1
  289. package/dist/{i18n-D9k9xwuD.js → server/i18n-DW9kcu0G.js} +180 -178
  290. package/dist/server/i18n-DZ0JlZal.cjs +4 -0
  291. package/dist/server/{index-B4epvfiq.js → index-BNYr6EIW.js} +89 -90
  292. package/dist/server/index-Cqod09d_.cjs +1 -0
  293. package/dist/server/index.cjs +1 -1
  294. package/dist/server/index.js +825 -898
  295. package/dist/server/layout/index.cjs +1 -1
  296. package/dist/server/layout/index.js +3 -3
  297. package/dist/server/mainRealmDom-DPNaDWtw.js +121 -0
  298. package/dist/server/mainRealmDom-DwZVMPnO.cjs +1 -0
  299. package/dist/server/navigation/index.cjs +1 -1
  300. package/dist/server/navigation/index.js +1 -1
  301. package/dist/server/notifications/index.cjs +1 -1
  302. package/dist/server/notifications/index.js +63 -103
  303. package/dist/server/overlay/index.cjs +1 -1
  304. package/dist/server/overlay/index.js +115 -120
  305. package/dist/server/pageTourState-BcBF8w89.js +516 -0
  306. package/dist/server/pageTourState-CrbEU7QW.cjs +5 -0
  307. package/dist/server/settings/index.cjs +1 -1
  308. package/dist/server/settings/index.js +23 -24
  309. package/dist/server/stateDbStore-CThsVch-.cjs +1 -0
  310. package/dist/server/stateDbStore-DHZFUIEt.js +57 -0
  311. package/dist/server/tokens/index.cjs +1 -1
  312. package/dist/server/tokens/index.js +19 -20
  313. package/dist/server/tree/index.cjs +1 -1
  314. package/dist/server/tree/index.js +1 -1
  315. package/dist/server/useListCommands-BO_XrRHj.js +38 -0
  316. package/dist/server/useListCommands-Dnm4ktP1.cjs +1 -0
  317. package/dist/server/useSettingsSubscription-DKjCwmRd.cjs +1 -0
  318. package/dist/server/{notification-CpDYN_iu.js → useSettingsSubscription-DLEk4k4j.js} +41 -32
  319. package/dist/server/window-CUK6x8Pj.js +36 -0
  320. package/dist/server/window-_BfSgFGO.cjs +1 -0
  321. package/dist/server/windowRegistry-CxXtP-iY.cjs +1 -0
  322. package/dist/server/windowRegistry-DeGmXt6W.js +20 -0
  323. package/dist/settings/index.cjs +1 -1
  324. package/dist/settings/index.d.cts +1 -1
  325. package/dist/settings/index.d.ts +1 -1
  326. package/dist/settings/index.js +23 -24
  327. package/dist/solid/_internal/app/keybindings/context/useFocusClaim.js +3 -10
  328. package/dist/solid/_internal/app/keybindings/context/useListCommands.js +1 -2
  329. package/dist/solid/_internal/app/keybindings/panelCommandsRegistry.js +8 -1
  330. package/dist/solid/_internal/app/menu/menuFavorites.js +45 -40
  331. package/dist/solid/_internal/app/onboarding/PageTourHost.jsx +22 -22
  332. package/dist/solid/_internal/app/onboarding/pageTourState.js +94 -92
  333. package/dist/solid/_internal/app/platform/electronBridge.js +15 -49
  334. package/dist/solid/_internal/app/settings/secrets/notificationSecrets.js +0 -10
  335. package/dist/solid/_internal/app/windows/window/HostWindowContext.jsx +4 -13
  336. package/dist/solid/_internal/contract/catalogNotify.js +1 -24
  337. package/dist/solid/_internal/contract/hostErrorText.js +1 -14
  338. package/dist/solid/_internal/contract/notificationCatalog.js +1 -1
  339. package/dist/solid/_internal/platform/errors/diagnosticReport.js +2 -3
  340. package/dist/solid/_internal/platform/logging/consoleLogger.js +6 -0
  341. package/dist/solid/_internal/platform/settings/registry/defineSettings.js +48 -20
  342. package/dist/solid/_internal/platform/settings/registry/stateDbStore.js +29 -19
  343. package/dist/solid/_internal/platform/vendorErrors/index.js +4 -17
  344. package/dist/solid/_internal/platform/window/displayOwner.js +105 -114
  345. package/dist/solid/a11y/AriaAnnouncer.jsx +2 -3
  346. package/dist/solid/async/createGuardedListLoader.js +1 -1
  347. package/dist/solid/desktop/menu/MenuPanel.jsx +7 -7
  348. package/dist/solid/feedback/ErrorBoundary.jsx +7 -4
  349. package/dist/solid/feedback/Loader.jsx +1 -2
  350. package/dist/solid/feedback/createPreference.js +3 -2
  351. package/dist/solid/feedback/guidedInstallOutcome.js +1 -2
  352. package/dist/solid/feedback/preference.notifications.js +1 -2
  353. package/dist/solid/feedback/readFailureText.js +1 -2
  354. package/dist/solid/host/index.js +8 -16
  355. package/dist/solid/host/window.js +15 -22
  356. package/dist/solid/i18n/i18n.js +5 -6
  357. package/dist/solid/index.js +0 -1
  358. package/dist/solid/layout/createResizableSidebar.js +15 -23
  359. package/dist/solid/notifications/NotificationHost.jsx +21 -29
  360. package/dist/solid/notifications/NotificationItem.jsx +28 -104
  361. package/dist/solid/notifications/NotificationPanel.jsx +33 -44
  362. package/dist/solid/notifications/NotificationsCenter.jsx +22 -20
  363. package/dist/solid/notifications/StatusBarNotificationBell.jsx +4 -3
  364. package/dist/solid/notifications/catalogAdapter.js +61 -62
  365. package/dist/solid/notifications/createNotificationPreviewRuntime.js +29 -19
  366. package/dist/solid/notifications/customSoundCache.js +26 -21
  367. package/dist/solid/notifications/emailDigest.js +74 -86
  368. package/dist/solid/notifications/errorActionButtons.js +6 -11
  369. package/dist/solid/notifications/fireNotification.js +14 -19
  370. package/dist/solid/notifications/index.js +3 -12
  371. package/dist/solid/notifications/nativeEngine.js +6 -19
  372. package/dist/solid/notifications/notificationAnalytics.js +32 -38
  373. package/dist/solid/notifications/notificationAudio.js +77 -74
  374. package/dist/solid/notifications/notificationCardServices.js +34 -0
  375. package/dist/solid/notifications/notificationOverlayChannel.js +3 -3
  376. package/dist/solid/notifications/notificationOverlaySync.js +18 -23
  377. package/dist/solid/notifications/notificationService.js +135 -0
  378. package/dist/solid/notifications/notificationTimeline.js +117 -124
  379. package/dist/solid/notifications/notifications.notifications.js +3 -22
  380. package/dist/solid/notifications/toast.js +168 -213
  381. package/dist/solid/notifications/webhookDelivery.js +27 -53
  382. package/dist/solid/overlay/ConfirmDialog.jsx +14 -58
  383. package/dist/solid/overlay/command-palette/CommandPalette.jsx +3 -1
  384. package/dist/solid/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.js +26 -25
  385. package/dist/solid/overlay/command-palette/unifiedSearch/settingsSearchContributor.js +2 -7
  386. package/dist/solid/overlay/index.js +0 -3
  387. package/dist/solid/settings/index.js +1 -1
  388. package/dist/solid/tokens/index.js +1 -1
  389. package/dist/solid/tokens/palette/themeRegistry.js +20 -22
  390. package/dist/stateDbStore-CThsVch-.cjs +1 -0
  391. package/dist/stateDbStore-DHZFUIEt.js +57 -0
  392. package/dist/style.css +1 -1
  393. package/dist/tokens/index.cjs +1 -1
  394. package/dist/tokens/index.d.cts +1 -1
  395. package/dist/tokens/index.d.ts +1 -1
  396. package/dist/tokens/index.js +19 -20
  397. package/dist/tokens/palette/themeRegistry.d.cts +17 -22
  398. package/dist/tokens/palette/themeRegistry.d.ts +17 -22
  399. package/dist/{tooltipCoordinator-Zim5pWzk.js → tooltipCoordinator-BzxEyKhA.js} +2 -2
  400. package/dist/tooltipCoordinator-DslqMlsI.cjs +1 -0
  401. package/dist/tree/index.cjs +1 -1
  402. package/dist/tree/index.js +1 -1
  403. package/dist/ui.css +1 -1
  404. package/dist/{useFloatingDropdown-CfPEYRut.js → useFloatingDropdown-BN4J092P.js} +1 -1
  405. package/dist/{useFloatingDropdown-DcU7ozDg.cjs → useFloatingDropdown-D9OvEFAp.cjs} +1 -1
  406. package/dist/useListCommands-BO_XrRHj.js +38 -0
  407. package/dist/useListCommands-Dnm4ktP1.cjs +1 -0
  408. package/dist/useSettingsSubscription-DKjCwmRd.cjs +1 -0
  409. package/dist/{notification-CpDYN_iu.js → useSettingsSubscription-DLEk4k4j.js} +41 -32
  410. package/dist/window-CUK6x8Pj.js +36 -0
  411. package/dist/window-_BfSgFGO.cjs +1 -0
  412. package/dist/windowRegistry-CxXtP-iY.cjs +1 -0
  413. package/dist/windowRegistry-DeGmXt6W.js +20 -0
  414. package/package.json +1 -1
  415. package/dist/CommandPalette-DeEImZ8D.cjs +0 -2
  416. package/dist/CommandPalette-yqvM9AuU.js +0 -3897
  417. package/dist/DateRangePicker-7t4JKCp1.cjs +0 -9
  418. package/dist/GuidedTour-C_Lxe1t_.cjs +0 -21
  419. package/dist/GuidedTour-lsljVkPL.js +0 -11216
  420. package/dist/HostWindowContext-DqDeJmBP.cjs +0 -1
  421. package/dist/HostWindowContext-KL4U1qUv.js +0 -40
  422. package/dist/Modal-CJhd27dM.cjs +0 -1
  423. package/dist/PageSkeleton-SYSL4Adl.cjs +0 -30
  424. package/dist/Progress-B5YmNeyU.js +0 -56
  425. package/dist/Progress-BNy0wsJl.cjs +0 -1
  426. package/dist/StatusBarNotificationBell-B1bvE_SO.js +0 -2140
  427. package/dist/StatusBarNotificationBell-Cqo6cZbO.cjs +0 -4
  428. package/dist/ToggleButton-BmwDfsn4.cjs +0 -1
  429. package/dist/_internal/app/contexts/WorkspaceTabsContext.d.cts +0 -20
  430. package/dist/_internal/app/contexts/WorkspaceTabsContext.d.ts +0 -20
  431. package/dist/_internal/app/settings/theme/appThemeChange.d.cts +0 -20
  432. package/dist/_internal/app/settings/theme/appThemeChange.d.ts +0 -20
  433. package/dist/_internal/app/settings/ui/shell/openSettingsModal.d.cts +0 -6
  434. package/dist/_internal/app/settings/ui/shell/openSettingsModal.d.ts +0 -6
  435. package/dist/_internal/base/listenerDispatch.d.cts +0 -14
  436. package/dist/_internal/base/listenerDispatch.d.ts +0 -14
  437. package/dist/_internal/contract/appName.d.cts +0 -10
  438. package/dist/_internal/contract/appName.d.ts +0 -10
  439. package/dist/_internal/contract/hostText.d.cts +0 -25
  440. package/dist/_internal/contract/hostText.d.ts +0 -25
  441. package/dist/_internal/platform/logging/rendererLogging.d.cts +0 -65
  442. package/dist/_internal/platform/logging/rendererLogging.d.ts +0 -65
  443. package/dist/_internal/platform/settings/preferencesCache.d.cts +0 -162
  444. package/dist/_internal/platform/settings/preferencesCache.d.ts +0 -162
  445. package/dist/appThemeDerivation-DmKbTiFi.cjs +0 -1
  446. package/dist/catalogNotify-BcY9oqVy.js +0 -1223
  447. package/dist/catalogNotify-DacJjC-p.cjs +0 -27
  448. package/dist/createResizableSidebar-BIhyo5zN.cjs +0 -1
  449. package/dist/createResizableSidebar-Cqv-1IXG.js +0 -461
  450. package/dist/defineSettings-CcYXt2Jf.js +0 -391
  451. package/dist/defineSettings-yHQdUwxI.cjs +0 -1
  452. package/dist/descriptor-Dmch-3AF.cjs +0 -1
  453. package/dist/dialogFocusRestore-B4ggeVAM.js +0 -64
  454. package/dist/dialogFocusRestore-BcMPrbig.cjs +0 -1
  455. package/dist/displayOwner-eYQHHvjt.cjs +0 -1
  456. package/dist/displayOwner-mT80Oyi-.js +0 -75
  457. package/dist/feedback/preference.notifications.samples.d.cts +0 -1
  458. package/dist/feedback/preference.notifications.samples.d.ts +0 -1
  459. package/dist/focusModality-BNjYldd9.cjs +0 -1
  460. package/dist/focusModality-DxudpWPs.js +0 -135
  461. package/dist/format-BS7oDguE.js +0 -298
  462. package/dist/format-CuANkXXB.cjs +0 -1
  463. package/dist/i18n-DXXArz-m.cjs +0 -4
  464. package/dist/keys-BeeC5_RZ.cjs +0 -1
  465. package/dist/mainRealmDom-CkoRyNhZ.cjs +0 -1
  466. package/dist/mainRealmDom-kEStLHIY.js +0 -102
  467. package/dist/menuFavorites-BmdM_qV5.js +0 -69
  468. package/dist/menuFavorites-DoDFvtlQ.cjs +0 -1
  469. package/dist/notification-DygvQB_o.cjs +0 -1
  470. package/dist/notificationSuppressions-DGfo2QKG.cjs +0 -1
  471. package/dist/notificationSuppressions-ddyK85cB.js +0 -430
  472. package/dist/notifications/copyToClipboard.d.cts +0 -6
  473. package/dist/notifications/copyToClipboard.d.ts +0 -6
  474. package/dist/notifications/createCopyFlash.d.cts +0 -17
  475. package/dist/notifications/createCopyFlash.d.ts +0 -17
  476. package/dist/notifications/notificationDisplayOwner.d.cts +0 -27
  477. package/dist/notifications/notificationDisplayOwner.d.ts +0 -27
  478. package/dist/notifications/notificationRepeaterEntryFactory.d.cts +0 -36
  479. package/dist/notifications/notificationRepeaterEntryFactory.d.ts +0 -36
  480. package/dist/notifications/notifications.notifications.samples.d.cts +0 -1
  481. package/dist/notifications/notifications.notifications.samples.d.ts +0 -1
  482. package/dist/notifications/persistWithRollbackOnFailure.d.cts +0 -18
  483. package/dist/notifications/persistWithRollbackOnFailure.d.ts +0 -18
  484. package/dist/notifications/startNotificationSchedulers.d.cts +0 -2
  485. package/dist/notifications/startNotificationSchedulers.d.ts +0 -2
  486. package/dist/notifications/startNotificationSettingsReactions.d.cts +0 -46
  487. package/dist/notifications/startNotificationSettingsReactions.d.ts +0 -46
  488. package/dist/overlay/ToastHost.d.cts +0 -7
  489. package/dist/overlay/ToastHost.d.ts +0 -7
  490. package/dist/pageTourState-CIr8ockR.js +0 -92
  491. package/dist/pageTourState-D8Uapyft.cjs +0 -1
  492. package/dist/preferencesCache-Bow6TxP1.js +0 -65
  493. package/dist/preferencesCache-D7mm43_n.cjs +0 -1
  494. package/dist/rendererLogging-Dt5FZ8mq.cjs +0 -7
  495. package/dist/rendererLogging-gAhiHWkA.js +0 -822
  496. package/dist/server/CommandPalette-C8treS8g.cjs +0 -1
  497. package/dist/server/CommandPalette-Dslsq5Ez.js +0 -3155
  498. package/dist/server/DateRangePicker-CDKi9BAf.cjs +0 -9
  499. package/dist/server/GuidedTour-B3T9rAPX.cjs +0 -20
  500. package/dist/server/GuidedTour-DSoSZZby.js +0 -10983
  501. package/dist/server/HostWindowContext-DqDeJmBP.cjs +0 -1
  502. package/dist/server/HostWindowContext-KL4U1qUv.js +0 -40
  503. package/dist/server/Modal-CCUwQYso.cjs +0 -1
  504. package/dist/server/PageSkeleton-DdpXfZoC.cjs +0 -30
  505. package/dist/server/Progress-CRbj6nEy.cjs +0 -1
  506. package/dist/server/Progress-nsDy6clG.js +0 -41
  507. package/dist/server/StatusBarNotificationBell-C64Odn2C.js +0 -1974
  508. package/dist/server/StatusBarNotificationBell-DY0Q27su.cjs +0 -4
  509. package/dist/server/ToggleButton-1bNYk35x.cjs +0 -1
  510. package/dist/server/VpTerminal-Bpw-d9wD.js +0 -186
  511. package/dist/server/VpTerminal-C-U_dN_x.cjs +0 -1
  512. package/dist/server/VpTrash-CagiU2Uj.cjs +0 -1
  513. package/dist/server/VpTrash-DVBfts9_.js +0 -116
  514. package/dist/server/appThemeDerivation-DmKbTiFi.cjs +0 -1
  515. package/dist/server/catalogNotify-MCW2sa2e.cjs +0 -27
  516. package/dist/server/catalogNotify-s3YymAe8.js +0 -1261
  517. package/dist/server/createResizableSidebar-MIzUlfdd.js +0 -299
  518. package/dist/server/createResizableSidebar-TdxLuiY8.cjs +0 -1
  519. package/dist/server/defineSettings-CcYXt2Jf.js +0 -391
  520. package/dist/server/defineSettings-yHQdUwxI.cjs +0 -1
  521. package/dist/server/descriptor-DAyyoF-I.cjs +0 -1
  522. package/dist/server/dialogFocusRestore-B4ggeVAM.js +0 -64
  523. package/dist/server/dialogFocusRestore-BcMPrbig.cjs +0 -1
  524. package/dist/server/displayOwner-eYQHHvjt.cjs +0 -1
  525. package/dist/server/displayOwner-mT80Oyi-.js +0 -75
  526. package/dist/server/focusModality-BKgJWRlC.cjs +0 -1
  527. package/dist/server/format-WfZycMBL.cjs +0 -1
  528. package/dist/server/i18n-DXXArz-m.cjs +0 -4
  529. package/dist/server/index-DlQYWckZ.cjs +0 -1
  530. package/dist/server/mainRealmDom-BCL1p_q6.cjs +0 -1
  531. package/dist/server/mainRealmDom-Dk0xb5Gj.js +0 -67
  532. package/dist/server/menuFavorites-BmdM_qV5.js +0 -69
  533. package/dist/server/menuFavorites-DoDFvtlQ.cjs +0 -1
  534. package/dist/server/notification-DygvQB_o.cjs +0 -1
  535. package/dist/server/notificationSuppressions-B-LKq9ZU.js +0 -391
  536. package/dist/server/notificationSuppressions-Dcc2WFBZ.cjs +0 -1
  537. package/dist/server/pageTourState-CIr8ockR.js +0 -92
  538. package/dist/server/pageTourState-D8Uapyft.cjs +0 -1
  539. package/dist/server/preferencesCache-Bow6TxP1.js +0 -65
  540. package/dist/server/preferencesCache-D7mm43_n.cjs +0 -1
  541. package/dist/server/rendererLogging-Dt5FZ8mq.cjs +0 -7
  542. package/dist/server/rendererLogging-gAhiHWkA.js +0 -822
  543. package/dist/server/settingsSearchContributor-CRZsl2Q_.js +0 -199
  544. package/dist/server/settingsSearchContributor-DH8UFpp2.cjs +0 -1
  545. package/dist/server/stateDbStore-Ds3zJ4cd.js +0 -47
  546. package/dist/server/stateDbStore-THFfFGa0.cjs +0 -1
  547. package/dist/server/useListCommands-Bf7aOTXZ.js +0 -61
  548. package/dist/server/useListCommands-ucngC3t4.cjs +0 -1
  549. package/dist/server/useSettingsSubscription-cu943hND.js +0 -11
  550. package/dist/server/useSettingsSubscription-vlMrNNH9.cjs +0 -1
  551. package/dist/server/visibleBrowserRegistry-BTfWUlI1.cjs +0 -1
  552. package/dist/server/visibleBrowserRegistry-Dw2Y4y_I.js +0 -89
  553. package/dist/server/windowRegistry-Bk5lXIVd.js +0 -62
  554. package/dist/server/windowRegistry-CGvOBUsw.cjs +0 -1
  555. package/dist/settingsSearchContributor-DWP5dwn3.js +0 -199
  556. package/dist/settingsSearchContributor-Dltbs1j_.cjs +0 -1
  557. package/dist/solid/_internal/app/contexts/WorkspaceTabsContext.js +0 -10
  558. package/dist/solid/_internal/app/settings/theme/appThemeChange.js +0 -5
  559. package/dist/solid/_internal/app/settings/ui/shell/openSettingsModal.js +0 -15
  560. package/dist/solid/_internal/base/listenerDispatch.js +0 -12
  561. package/dist/solid/_internal/contract/appName.js +0 -7
  562. package/dist/solid/_internal/contract/hostText.js +0 -15
  563. package/dist/solid/_internal/platform/logging/rendererLogging.js +0 -42
  564. package/dist/solid/_internal/platform/settings/preferencesCache.js +0 -329
  565. package/dist/solid/feedback/preference.notifications.samples.js +0 -5
  566. package/dist/solid/notifications/copyToClipboard.js +0 -21
  567. package/dist/solid/notifications/createCopyFlash.js +0 -26
  568. package/dist/solid/notifications/notificationDisplayOwner.js +0 -1
  569. package/dist/solid/notifications/notificationRepeaterEntryFactory.js +0 -20
  570. package/dist/solid/notifications/notifications.notifications.samples.js +0 -14
  571. package/dist/solid/notifications/persistWithRollbackOnFailure.js +0 -11
  572. package/dist/solid/notifications/startNotificationSchedulers.js +0 -8
  573. package/dist/solid/notifications/startNotificationSettingsReactions.js +0 -22
  574. package/dist/solid/overlay/ToastHost.jsx +0 -1
  575. package/dist/stateDbStore-Ds3zJ4cd.js +0 -47
  576. package/dist/stateDbStore-THFfFGa0.cjs +0 -1
  577. package/dist/tooltipCoordinator-Causlcgt.cjs +0 -1
  578. package/dist/useListCommands-Bf7aOTXZ.js +0 -61
  579. package/dist/useListCommands-ucngC3t4.cjs +0 -1
  580. package/dist/useSettingsSubscription-cu943hND.js +0 -11
  581. package/dist/useSettingsSubscription-vlMrNNH9.cjs +0 -1
  582. package/dist/visibleBrowserRegistry-BTfWUlI1.cjs +0 -1
  583. package/dist/visibleBrowserRegistry-Dw2Y4y_I.js +0 -89
  584. package/dist/windowRegistry-Bk5lXIVd.js +0 -62
  585. package/dist/windowRegistry-CGvOBUsw.cjs +0 -1
@@ -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;
@@ -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>;
@@ -1306,6 +1306,11 @@ export interface ConnectionWorkspacePreferences {
1306
1306
  * the top of the tree mirroring a Favorites tool window).
1307
1307
  */
1308
1308
  databaseExplorerBookmarks?: Array<{
1309
+ /**
1310
+ * The database the object lives in, when it is not the connection's own. Absent means the
1311
+ * connection's own database — so does every entry written before this field existed.
1312
+ */
1313
+ database?: string;
1309
1314
  schemaName: string;
1310
1315
  name: string;
1311
1316
  objectType: string;
@@ -1306,6 +1306,11 @@ export interface ConnectionWorkspacePreferences {
1306
1306
  * the top of the tree mirroring a Favorites tool window).
1307
1307
  */
1308
1308
  databaseExplorerBookmarks?: Array<{
1309
+ /**
1310
+ * The database the object lives in, when it is not the connection's own. Absent means the
1311
+ * connection's own database — so does every entry written before this field existed.
1312
+ */
1313
+ database?: string;
1309
1314
  schemaName: string;
1310
1315
  name: string;
1311
1316
  objectType: string;
@@ -9,7 +9,7 @@ import type { VendorErrorRef } from '../../contract/vendorErrorRef.cjs';
9
9
  * (`formatCode`, `docsUrl`, `docsLinkLabel`, `passwordExpiredCode`, …). Importing the registry
10
10
  * directly from a service closes a dependency cycle, and simply deleting that import would break
11
11
  * a working error path: the helpers object is genuinely used. So the dependency goes through this
12
- * PORT — the shell installs a source at boot and services read it.
12
+ * PORT — the host hands its source to whoever resolves a vendor error ({@link VendorErrorSource}).
13
13
  *
14
14
  * *Counting an edge does not give the cost of removing it — the surface the edge CARRIES does.*
15
15
  *
@@ -90,7 +90,10 @@ export interface VendorErrorPreview {
90
90
  readonly vendorError: VendorErrorRef;
91
91
  }
92
92
  /**
93
- * The SOURCE side of the port — the shell installs it at boot.
93
+ * The SOURCE of the vendor error helpers — the host's vendor registry, handed to the kit's components
94
+ * (`KitHost.vendorErrors`) and to its notification service; the helpers below take it as their first
95
+ * argument. There is no module slot: a realm without a source has no vendor to resolve, and says so by
96
+ * passing one that registers none.
94
97
  *
95
98
  * ⚠ The surface is deliberately NARROW: not the whole registry, only the two members the error
96
99
  * axis needs. A wide interface would tie `services/` to EVERY change of the registry — it would
@@ -100,27 +103,14 @@ export interface VendorErrorSource {
100
103
  registeredVendorIds(): readonly string[];
101
104
  errorHelpersFor(vendorId: string): VendorErrorHelpers | null;
102
105
  }
103
- /** Called by the shell at boot. */
104
- export declare function installVendorErrorSource(source: VendorErrorSource): void;
105
- /**
106
- * Whether a source is installed — a check that does **not throw**.
107
- *
108
- * For call sites that run at module load time: throwing before boot would turn the very path that
109
- * is supposed to report the error into an error.
110
- */
111
- export declare function isVendorErrorSourceInstalled(): boolean;
112
- /**
113
- * The installed source. Throws if called before boot — does not happen in production; tests install a stub.
114
- */
115
- export declare function getVendorErrorSource(): VendorErrorSource;
116
106
  /** Resolves the reference with the vendor's helpers; `null` if the vendor is not registered. */
117
- export declare function resolveVendorError(ref: VendorErrorRef): VendorErrorMatch | null;
107
+ export declare function resolveVendorError(source: VendorErrorSource, ref: VendorErrorRef): VendorErrorMatch | null;
118
108
  /**
119
109
  * Turns a catalog sample into the shape the toast path expects: text starting with the vendor's
120
110
  * canonical label and the sample's OWN reference. If the vendor is not registered the developer
121
111
  * catalog is wired wrongly.
122
112
  */
123
- export declare function createVendorErrorPreview(vendorId: string, code: string, message: string): VendorErrorPreview;
113
+ export declare function createVendorErrorPreview(source: VendorErrorSource, vendorId: string, code: string, message: string): VendorErrorPreview;
124
114
  /**
125
115
  * Vendor-agnostic external search URL. Lives here (not in a vendor folder) because the action is
126
116
  * the same whichever driver produced the message.
@@ -9,7 +9,7 @@ import type { VendorErrorRef } from '../../contract/vendorErrorRef.js';
9
9
  * (`formatCode`, `docsUrl`, `docsLinkLabel`, `passwordExpiredCode`, …). Importing the registry
10
10
  * directly from a service closes a dependency cycle, and simply deleting that import would break
11
11
  * a working error path: the helpers object is genuinely used. So the dependency goes through this
12
- * PORT — the shell installs a source at boot and services read it.
12
+ * PORT — the host hands its source to whoever resolves a vendor error ({@link VendorErrorSource}).
13
13
  *
14
14
  * *Counting an edge does not give the cost of removing it — the surface the edge CARRIES does.*
15
15
  *
@@ -90,7 +90,10 @@ export interface VendorErrorPreview {
90
90
  readonly vendorError: VendorErrorRef;
91
91
  }
92
92
  /**
93
- * The SOURCE side of the port — the shell installs it at boot.
93
+ * The SOURCE of the vendor error helpers — the host's vendor registry, handed to the kit's components
94
+ * (`KitHost.vendorErrors`) and to its notification service; the helpers below take it as their first
95
+ * argument. There is no module slot: a realm without a source has no vendor to resolve, and says so by
96
+ * passing one that registers none.
94
97
  *
95
98
  * ⚠ The surface is deliberately NARROW: not the whole registry, only the two members the error
96
99
  * axis needs. A wide interface would tie `services/` to EVERY change of the registry — it would
@@ -100,27 +103,14 @@ export interface VendorErrorSource {
100
103
  registeredVendorIds(): readonly string[];
101
104
  errorHelpersFor(vendorId: string): VendorErrorHelpers | null;
102
105
  }
103
- /** Called by the shell at boot. */
104
- export declare function installVendorErrorSource(source: VendorErrorSource): void;
105
- /**
106
- * Whether a source is installed — a check that does **not throw**.
107
- *
108
- * For call sites that run at module load time: throwing before boot would turn the very path that
109
- * is supposed to report the error into an error.
110
- */
111
- export declare function isVendorErrorSourceInstalled(): boolean;
112
- /**
113
- * The installed source. Throws if called before boot — does not happen in production; tests install a stub.
114
- */
115
- export declare function getVendorErrorSource(): VendorErrorSource;
116
106
  /** Resolves the reference with the vendor's helpers; `null` if the vendor is not registered. */
117
- export declare function resolveVendorError(ref: VendorErrorRef): VendorErrorMatch | null;
107
+ export declare function resolveVendorError(source: VendorErrorSource, ref: VendorErrorRef): VendorErrorMatch | null;
118
108
  /**
119
109
  * Turns a catalog sample into the shape the toast path expects: text starting with the vendor's
120
110
  * canonical label and the sample's OWN reference. If the vendor is not registered the developer
121
111
  * catalog is wired wrongly.
122
112
  */
123
- export declare function createVendorErrorPreview(vendorId: string, code: string, message: string): VendorErrorPreview;
113
+ export declare function createVendorErrorPreview(source: VendorErrorSource, vendorId: string, code: string, message: string): VendorErrorPreview;
124
114
  /**
125
115
  * Vendor-agnostic external search URL. Lives here (not in a vendor folder) because the action is
126
116
  * the same whichever driver produced the message.