@vokril/ui-solid 0.13.0 → 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 (581) hide show
  1. package/CHANGELOG.md +45 -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-BFi0_e3t.cjs +2 -0
  8. package/dist/CommandPalette-CAH08DGN.js +4013 -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/vendorErrors/index.d.cts +7 -17
  76. package/dist/_internal/platform/vendorErrors/index.d.ts +7 -17
  77. package/dist/_internal/platform/window/displayOwner.d.cts +35 -14
  78. package/dist/_internal/platform/window/displayOwner.d.ts +35 -14
  79. package/dist/a11y/index.cjs +1 -1
  80. package/dist/a11y/index.js +1 -1
  81. package/dist/actions-DtaFGwh2.cjs +1 -0
  82. package/dist/actions-wwAHs3ZU.js +16 -0
  83. package/dist/{server/appThemeDerivation-BiCyiSuz.js → appThemeDerivation-B7-DjMIM.js} +181 -184
  84. package/dist/appThemeDerivation-NS3Vws8q.cjs +1 -0
  85. package/dist/async/createGuardedListLoader.d.cts +3 -0
  86. package/dist/async/createGuardedListLoader.d.ts +3 -0
  87. package/dist/charts/index.cjs +1 -1
  88. package/dist/charts/index.js +1 -1
  89. package/dist/createDialogShellFocus-BBFu3Z_O.js +282 -0
  90. package/dist/createDialogShellFocus-CxRqhbRN.cjs +1 -0
  91. package/dist/createResizableSidebar-CfFxQUny.js +449 -0
  92. package/dist/createResizableSidebar-q7aC7SAO.cjs +1 -0
  93. package/dist/{createVirtualScroller-LN-7QFiv.cjs → createVirtualScroller-CL49JE2P.cjs} +1 -1
  94. package/dist/{server/createVirtualScroller-DBvqT0UW.js → createVirtualScroller-vu-l4rVv.js} +7 -7
  95. package/dist/defineSettings-D0CSMcyy.cjs +1 -0
  96. package/dist/defineSettings-Di1sG81q.js +407 -0
  97. package/dist/descriptor-CaHgh9N_.cjs +1 -0
  98. package/dist/{descriptor-CrCl515S.js → descriptor-eGtcBtpI.js} +5 -5
  99. package/dist/desktop/index.cjs +1 -1
  100. package/dist/desktop/index.js +500 -426
  101. package/dist/dialogFocusRestore-BrALT8Ew.js +35 -0
  102. package/dist/dialogFocusRestore-CcEsB50v.cjs +1 -0
  103. package/dist/electronBridge-BK92fycw.js +235 -0
  104. package/dist/electronBridge-cT0xww92.cjs +1 -0
  105. package/dist/errorHandler-BvPGW-Nm.js +373 -0
  106. package/dist/errorHandler-DoDAPpv2.cjs +3 -0
  107. package/dist/feedback/Loader.d.cts +6 -1
  108. package/dist/feedback/Loader.d.ts +6 -1
  109. package/dist/feedback/createPreference.d.cts +4 -1
  110. package/dist/feedback/createPreference.d.ts +4 -1
  111. package/dist/feedback/guidedInstallOutcome.d.cts +15 -2
  112. package/dist/feedback/guidedInstallOutcome.d.ts +15 -2
  113. package/dist/feedback/index.cjs +1 -1
  114. package/dist/feedback/index.js +37 -38
  115. package/dist/feedback/readFailureText.d.cts +20 -1
  116. package/dist/feedback/readFailureText.d.ts +20 -1
  117. package/dist/focusModality-BISb6-yg.cjs +1 -0
  118. package/dist/focusModality-FoLPWF-_.js +135 -0
  119. package/dist/forms/index.cjs +1 -1
  120. package/dist/forms/index.js +9 -9
  121. package/dist/grid/index.cjs +1 -1
  122. package/dist/grid/index.js +1 -1
  123. package/dist/{headerIconOverrides-DY3BTuca.cjs → headerIconOverrides-Bn1QuODq.cjs} +1 -1
  124. package/dist/{server/headerIconOverrides-B7TQUBmD.js → headerIconOverrides-Dh2PaOcO.js} +1 -1
  125. package/dist/host/index.cjs +1 -1
  126. package/dist/host/index.d.cts +14 -16
  127. package/dist/host/index.d.ts +14 -16
  128. package/dist/host/index.js +53 -90
  129. package/dist/host/kitHost.d.cts +42 -0
  130. package/dist/host/kitHost.d.ts +42 -0
  131. package/dist/host/window.d.cts +3 -11
  132. package/dist/host/window.d.ts +3 -11
  133. package/dist/i18n/index.cjs +1 -1
  134. package/dist/i18n/index.js +1 -1
  135. package/dist/{server/i18n-D9k9xwuD.js → i18n-DW9kcu0G.js} +180 -178
  136. package/dist/i18n-DZ0JlZal.cjs +4 -0
  137. package/dist/index.cjs +1 -1
  138. package/dist/index.d.cts +1 -1
  139. package/dist/index.d.ts +1 -1
  140. package/dist/index.js +665 -738
  141. package/dist/isOneOf-9EXOSYJu.cjs +1 -0
  142. package/dist/isOneOf-Dtomuazg.js +6 -0
  143. package/dist/{keys-Bfgdfak_.js → keys-B2nlkpqc.js} +6 -9
  144. package/dist/keys-GMxY2wcl.cjs +1 -0
  145. package/dist/layout/createResizableSidebar.d.cts +14 -0
  146. package/dist/layout/createResizableSidebar.d.ts +14 -0
  147. package/dist/layout/index.cjs +1 -1
  148. package/dist/layout/index.js +3 -3
  149. package/dist/layout/sidebarWidthClamp.d.cts +1 -1
  150. package/dist/layout/sidebarWidthClamp.d.ts +1 -1
  151. package/dist/mainRealmDom-C12lr9lm.js +171 -0
  152. package/dist/mainRealmDom-S6teqEr4.cjs +1 -0
  153. package/dist/navigation/index.cjs +1 -1
  154. package/dist/navigation/index.js +1 -1
  155. package/dist/notifications/NotificationHost.d.cts +7 -1
  156. package/dist/notifications/NotificationHost.d.ts +7 -1
  157. package/dist/notifications/NotificationItem.d.cts +48 -15
  158. package/dist/notifications/NotificationItem.d.ts +48 -15
  159. package/dist/notifications/catalogAdapter.d.cts +28 -6
  160. package/dist/notifications/catalogAdapter.d.ts +28 -6
  161. package/dist/notifications/createNotificationPreviewRuntime.d.cts +21 -3
  162. package/dist/notifications/createNotificationPreviewRuntime.d.ts +21 -3
  163. package/dist/notifications/customSoundCache.d.cts +24 -24
  164. package/dist/notifications/customSoundCache.d.ts +24 -24
  165. package/dist/notifications/emailDigest.d.cts +34 -16
  166. package/dist/notifications/emailDigest.d.ts +34 -16
  167. package/dist/notifications/errorActionButtons.d.cts +18 -1
  168. package/dist/notifications/errorActionButtons.d.ts +18 -1
  169. package/dist/notifications/fireNotification.d.cts +27 -17
  170. package/dist/notifications/fireNotification.d.ts +27 -17
  171. package/dist/notifications/index.cjs +1 -1
  172. package/dist/notifications/index.d.cts +6 -12
  173. package/dist/notifications/index.d.ts +6 -12
  174. package/dist/notifications/index.js +64 -104
  175. package/dist/notifications/nativeEngine.d.cts +18 -15
  176. package/dist/notifications/nativeEngine.d.ts +18 -15
  177. package/dist/notifications/notificationAnalytics.d.cts +11 -6
  178. package/dist/notifications/notificationAnalytics.d.ts +11 -6
  179. package/dist/notifications/notificationAudio.d.cts +30 -23
  180. package/dist/notifications/notificationAudio.d.ts +30 -23
  181. package/dist/notifications/notificationCardServices.d.cts +23 -0
  182. package/dist/notifications/notificationCardServices.d.ts +23 -0
  183. package/dist/notifications/notificationOverlayChannel.d.cts +4 -4
  184. package/dist/notifications/notificationOverlayChannel.d.ts +4 -4
  185. package/dist/notifications/notificationOverlaySync.d.cts +7 -2
  186. package/dist/notifications/notificationOverlaySync.d.ts +7 -2
  187. package/dist/notifications/notificationService.d.cts +101 -0
  188. package/dist/notifications/notificationService.d.ts +101 -0
  189. package/dist/notifications/notificationTimeline.d.cts +47 -49
  190. package/dist/notifications/notificationTimeline.d.ts +47 -49
  191. package/dist/notifications/notifications.notifications.d.cts +0 -4
  192. package/dist/notifications/notifications.notifications.d.ts +0 -4
  193. package/dist/notifications/toast.d.cts +24 -28
  194. package/dist/notifications/toast.d.ts +24 -28
  195. package/dist/notifications/webhookDelivery.d.cts +12 -17
  196. package/dist/notifications/webhookDelivery.d.ts +12 -17
  197. package/dist/overlay/ConfirmDialog.d.cts +0 -8
  198. package/dist/overlay/ConfirmDialog.d.ts +0 -8
  199. package/dist/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.d.cts +15 -14
  200. package/dist/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.d.ts +15 -14
  201. package/dist/overlay/command-palette/unifiedSearch/settingsSearchContributor.d.cts +1 -3
  202. package/dist/overlay/command-palette/unifiedSearch/settingsSearchContributor.d.ts +1 -3
  203. package/dist/overlay/command-palette/unifiedSearch/unifiedSearchTypes.d.cts +1 -1
  204. package/dist/overlay/command-palette/unifiedSearch/unifiedSearchTypes.d.ts +1 -1
  205. package/dist/overlay/index.cjs +1 -1
  206. package/dist/overlay/index.d.cts +2 -3
  207. package/dist/overlay/index.d.ts +2 -3
  208. package/dist/overlay/index.js +110 -115
  209. package/dist/pageTourState-BcBF8w89.js +516 -0
  210. package/dist/pageTourState-CrbEU7QW.cjs +5 -0
  211. package/dist/server/{AttributeGrid-UJtHTip2.js → AttributeGrid-B2s_rp00.js} +3 -3
  212. package/dist/server/{AttributeGrid-CyMsR4GC.cjs → AttributeGrid-C7aWbIe5.cjs} +1 -1
  213. package/dist/server/{Button-BesBg6eW.js → Button-Ck03cbUs.js} +1 -1
  214. package/dist/server/{Button-PZulLru4.cjs → Button-DWFMF5y0.cjs} +1 -1
  215. package/dist/server/CommandPalette-2UppyMxU.js +3271 -0
  216. package/dist/server/CommandPalette-DwpZyhO6.cjs +1 -0
  217. package/dist/server/{CopyButton-D_sN2Ggp.cjs → CopyButton-BOmAUQD4.cjs} +1 -1
  218. package/dist/server/{CopyButton-I5xsXV07.js → CopyButton-UvtFwOtA.js} +1 -1
  219. package/dist/server/DateRangePicker-BJteKzOY.cjs +9 -0
  220. package/dist/server/{DateRangePicker-DGUl2aE3.js → DateRangePicker-Cr58DczM.js} +158 -143
  221. package/dist/server/GuidedTour-C4msn-Ag.js +400 -0
  222. package/dist/server/GuidedTour-Rlsp8rOe.cjs +1 -0
  223. package/dist/server/HostPortal-B9Tzk_uN.cjs +1 -0
  224. package/dist/server/HostPortal-X1iw719T.js +33 -0
  225. package/dist/server/HostWindowContext-B2m0bVra.js +32 -0
  226. package/dist/server/HostWindowContext-_VZCt7xE.cjs +1 -0
  227. package/dist/server/{IconPicker-BlD0VBca.cjs → IconPicker-9DfOxql6.cjs} +1 -1
  228. package/dist/server/{IconPicker-o8hUxjYU.js → IconPicker-N0wub1Aj.js} +4 -4
  229. package/dist/server/Modal-D__GTo-n.cjs +1 -0
  230. package/dist/server/{Modal-DmF6CwfY.js → Modal-DeQjfpkG.js} +3 -3
  231. package/dist/server/{PageSkeleton-BigztY5i.js → PageSkeleton-C41pXOcr.js} +460 -458
  232. package/dist/server/PageSkeleton-D4i-UcnI.cjs +30 -0
  233. package/dist/server/{SearchableSelect-Dn-cssWx.js → SearchableSelect-CEcuBnge.js} +2 -2
  234. package/dist/server/{SearchableSelect-R0Dwz9rz.cjs → SearchableSelect-Ca9g8ztu.cjs} +1 -1
  235. package/dist/server/StatusBarNotificationBell-BotYny7q.cjs +49 -0
  236. package/dist/server/StatusBarNotificationBell-DyEQF2W7.js +13968 -0
  237. package/dist/server/{Stepper-dBm8YaCw.cjs → Stepper--pusyxso.cjs} +1 -1
  238. package/dist/server/{Stepper-BaQ6Kexj.js → Stepper-B_eL85hK.js} +1 -1
  239. package/dist/server/{TimeSeriesChart-BbbfDyeA.js → TimeSeriesChart-aSHquoBv.js} +1 -1
  240. package/dist/server/{TimeSeriesChart-qPgMkkaW.cjs → TimeSeriesChart-nZeB5jtN.cjs} +1 -1
  241. package/dist/server/ToggleButton-57_0SA-V.cjs +1 -0
  242. package/dist/server/{ToggleButton-C0_QpslP.js → ToggleButton-DjlWwgLJ.js} +4 -4
  243. package/dist/server/VpTrash-D49oUUJh.cjs +1 -0
  244. package/dist/server/VpTrash-Dlq8o6Uv.js +298 -0
  245. package/dist/server/a11y/index.cjs +1 -1
  246. package/dist/server/a11y/index.js +1 -1
  247. package/dist/server/actions-DtaFGwh2.cjs +1 -0
  248. package/dist/server/actions-wwAHs3ZU.js +16 -0
  249. package/dist/{appThemeDerivation-BiCyiSuz.js → server/appThemeDerivation-B7-DjMIM.js} +181 -184
  250. package/dist/server/appThemeDerivation-NS3Vws8q.cjs +1 -0
  251. package/dist/server/charts/index.cjs +1 -1
  252. package/dist/server/charts/index.js +1 -1
  253. package/dist/server/{format-CYCi8g4r.js → createDialogShellFocus-DNjzmcGj.js} +110 -126
  254. package/dist/server/createDialogShellFocus-PRRfMli-.cjs +1 -0
  255. package/dist/server/createResizableSidebar-CZtGmUnA.cjs +1 -0
  256. package/dist/server/createResizableSidebar-DdWdAB9l.js +287 -0
  257. package/dist/server/{createVirtualScroller-LN-7QFiv.cjs → createVirtualScroller-CL49JE2P.cjs} +1 -1
  258. package/dist/{createVirtualScroller-DBvqT0UW.js → server/createVirtualScroller-vu-l4rVv.js} +7 -7
  259. package/dist/server/defineSettings-D0CSMcyy.cjs +1 -0
  260. package/dist/server/defineSettings-Di1sG81q.js +407 -0
  261. package/dist/server/descriptor-CEGvvJZh.cjs +1 -0
  262. package/dist/server/{descriptor-DtZDXBe6.js → descriptor-GLoKPx6x.js} +4 -4
  263. package/dist/server/desktop/index.cjs +1 -1
  264. package/dist/server/desktop/index.js +389 -315
  265. package/dist/server/dialogFocusRestore-BrALT8Ew.js +35 -0
  266. package/dist/server/dialogFocusRestore-CcEsB50v.cjs +1 -0
  267. package/dist/server/electronBridge-BK92fycw.js +235 -0
  268. package/dist/server/electronBridge-cT0xww92.cjs +1 -0
  269. package/dist/server/errorHandler-BvPGW-Nm.js +373 -0
  270. package/dist/server/errorHandler-DoDAPpv2.cjs +3 -0
  271. package/dist/server/feedback/index.cjs +1 -1
  272. package/dist/server/feedback/index.js +37 -38
  273. package/dist/server/focusModality-D-nxv8Er.cjs +1 -0
  274. package/dist/server/{focusModality-BCX5GH0P.js → focusModality-nWNVX3JG.js} +41 -41
  275. package/dist/server/forms/index.cjs +1 -1
  276. package/dist/server/forms/index.js +7 -7
  277. package/dist/server/grid/index.cjs +1 -1
  278. package/dist/server/grid/index.js +1 -1
  279. package/dist/server/{headerIconOverrides-DY3BTuca.cjs → headerIconOverrides-Bn1QuODq.cjs} +1 -1
  280. package/dist/{headerIconOverrides-B7TQUBmD.js → server/headerIconOverrides-Dh2PaOcO.js} +1 -1
  281. package/dist/server/host/index.cjs +1 -1
  282. package/dist/server/host/index.js +53 -90
  283. package/dist/server/i18n/index.cjs +1 -1
  284. package/dist/server/i18n/index.js +1 -1
  285. package/dist/{i18n-D9k9xwuD.js → server/i18n-DW9kcu0G.js} +180 -178
  286. package/dist/server/i18n-DZ0JlZal.cjs +4 -0
  287. package/dist/server/{index-B4epvfiq.js → index-BNYr6EIW.js} +89 -90
  288. package/dist/server/index-Cqod09d_.cjs +1 -0
  289. package/dist/server/index.cjs +1 -1
  290. package/dist/server/index.js +810 -883
  291. package/dist/server/layout/index.cjs +1 -1
  292. package/dist/server/layout/index.js +3 -3
  293. package/dist/server/mainRealmDom-DPNaDWtw.js +121 -0
  294. package/dist/server/mainRealmDom-DwZVMPnO.cjs +1 -0
  295. package/dist/server/navigation/index.cjs +1 -1
  296. package/dist/server/navigation/index.js +1 -1
  297. package/dist/server/notifications/index.cjs +1 -1
  298. package/dist/server/notifications/index.js +63 -103
  299. package/dist/server/overlay/index.cjs +1 -1
  300. package/dist/server/overlay/index.js +104 -109
  301. package/dist/server/pageTourState-BcBF8w89.js +516 -0
  302. package/dist/server/pageTourState-CrbEU7QW.cjs +5 -0
  303. package/dist/server/settings/index.cjs +1 -1
  304. package/dist/server/settings/index.js +23 -24
  305. package/dist/server/stateDbStore-CThsVch-.cjs +1 -0
  306. package/dist/server/stateDbStore-DHZFUIEt.js +57 -0
  307. package/dist/server/tokens/index.cjs +1 -1
  308. package/dist/server/tokens/index.js +19 -20
  309. package/dist/server/tree/index.cjs +1 -1
  310. package/dist/server/tree/index.js +1 -1
  311. package/dist/server/useListCommands-BO_XrRHj.js +38 -0
  312. package/dist/server/useListCommands-Dnm4ktP1.cjs +1 -0
  313. package/dist/server/useSettingsSubscription-DKjCwmRd.cjs +1 -0
  314. package/dist/server/{notification-CpDYN_iu.js → useSettingsSubscription-DLEk4k4j.js} +41 -32
  315. package/dist/server/window-CUK6x8Pj.js +36 -0
  316. package/dist/server/window-_BfSgFGO.cjs +1 -0
  317. package/dist/server/windowRegistry-CxXtP-iY.cjs +1 -0
  318. package/dist/server/windowRegistry-DeGmXt6W.js +20 -0
  319. package/dist/settings/index.cjs +1 -1
  320. package/dist/settings/index.d.cts +1 -1
  321. package/dist/settings/index.d.ts +1 -1
  322. package/dist/settings/index.js +23 -24
  323. package/dist/solid/_internal/app/keybindings/context/useFocusClaim.js +3 -10
  324. package/dist/solid/_internal/app/keybindings/context/useListCommands.js +1 -2
  325. package/dist/solid/_internal/app/keybindings/panelCommandsRegistry.js +8 -1
  326. package/dist/solid/_internal/app/menu/menuFavorites.js +45 -40
  327. package/dist/solid/_internal/app/onboarding/PageTourHost.jsx +22 -22
  328. package/dist/solid/_internal/app/onboarding/pageTourState.js +94 -92
  329. package/dist/solid/_internal/app/platform/electronBridge.js +15 -49
  330. package/dist/solid/_internal/app/settings/secrets/notificationSecrets.js +0 -10
  331. package/dist/solid/_internal/app/windows/window/HostWindowContext.jsx +4 -13
  332. package/dist/solid/_internal/contract/catalogNotify.js +1 -24
  333. package/dist/solid/_internal/contract/hostErrorText.js +1 -14
  334. package/dist/solid/_internal/contract/notificationCatalog.js +1 -1
  335. package/dist/solid/_internal/platform/errors/diagnosticReport.js +2 -3
  336. package/dist/solid/_internal/platform/logging/consoleLogger.js +6 -0
  337. package/dist/solid/_internal/platform/settings/registry/defineSettings.js +48 -20
  338. package/dist/solid/_internal/platform/settings/registry/stateDbStore.js +29 -19
  339. package/dist/solid/_internal/platform/vendorErrors/index.js +4 -17
  340. package/dist/solid/_internal/platform/window/displayOwner.js +105 -114
  341. package/dist/solid/a11y/AriaAnnouncer.jsx +2 -3
  342. package/dist/solid/async/createGuardedListLoader.js +1 -1
  343. package/dist/solid/desktop/menu/MenuPanel.jsx +7 -7
  344. package/dist/solid/feedback/ErrorBoundary.jsx +7 -4
  345. package/dist/solid/feedback/Loader.jsx +1 -2
  346. package/dist/solid/feedback/createPreference.js +3 -2
  347. package/dist/solid/feedback/guidedInstallOutcome.js +1 -2
  348. package/dist/solid/feedback/preference.notifications.js +1 -2
  349. package/dist/solid/feedback/readFailureText.js +1 -2
  350. package/dist/solid/host/index.js +8 -16
  351. package/dist/solid/host/window.js +15 -22
  352. package/dist/solid/i18n/i18n.js +5 -6
  353. package/dist/solid/index.js +0 -1
  354. package/dist/solid/layout/createResizableSidebar.js +15 -23
  355. package/dist/solid/notifications/NotificationHost.jsx +21 -29
  356. package/dist/solid/notifications/NotificationItem.jsx +28 -104
  357. package/dist/solid/notifications/NotificationPanel.jsx +33 -44
  358. package/dist/solid/notifications/NotificationsCenter.jsx +22 -20
  359. package/dist/solid/notifications/StatusBarNotificationBell.jsx +4 -3
  360. package/dist/solid/notifications/catalogAdapter.js +61 -62
  361. package/dist/solid/notifications/createNotificationPreviewRuntime.js +29 -19
  362. package/dist/solid/notifications/customSoundCache.js +26 -21
  363. package/dist/solid/notifications/emailDigest.js +74 -86
  364. package/dist/solid/notifications/errorActionButtons.js +6 -11
  365. package/dist/solid/notifications/fireNotification.js +14 -19
  366. package/dist/solid/notifications/index.js +3 -12
  367. package/dist/solid/notifications/nativeEngine.js +6 -19
  368. package/dist/solid/notifications/notificationAnalytics.js +32 -38
  369. package/dist/solid/notifications/notificationAudio.js +77 -74
  370. package/dist/solid/notifications/notificationCardServices.js +34 -0
  371. package/dist/solid/notifications/notificationOverlayChannel.js +3 -3
  372. package/dist/solid/notifications/notificationOverlaySync.js +18 -23
  373. package/dist/solid/notifications/notificationService.js +135 -0
  374. package/dist/solid/notifications/notificationTimeline.js +117 -124
  375. package/dist/solid/notifications/notifications.notifications.js +3 -22
  376. package/dist/solid/notifications/toast.js +168 -213
  377. package/dist/solid/notifications/webhookDelivery.js +27 -53
  378. package/dist/solid/overlay/ConfirmDialog.jsx +1 -33
  379. package/dist/solid/overlay/command-palette/CommandPalette.jsx +3 -1
  380. package/dist/solid/overlay/command-palette/unifiedSearch/databaseObjectSearchContributor.js +26 -25
  381. package/dist/solid/overlay/command-palette/unifiedSearch/settingsSearchContributor.js +2 -7
  382. package/dist/solid/overlay/index.js +0 -3
  383. package/dist/solid/settings/index.js +1 -1
  384. package/dist/solid/tokens/index.js +1 -1
  385. package/dist/solid/tokens/palette/themeRegistry.js +20 -22
  386. package/dist/stateDbStore-CThsVch-.cjs +1 -0
  387. package/dist/stateDbStore-DHZFUIEt.js +57 -0
  388. package/dist/style.css +1 -1
  389. package/dist/tokens/index.cjs +1 -1
  390. package/dist/tokens/index.d.cts +1 -1
  391. package/dist/tokens/index.d.ts +1 -1
  392. package/dist/tokens/index.js +19 -20
  393. package/dist/tokens/palette/themeRegistry.d.cts +17 -22
  394. package/dist/tokens/palette/themeRegistry.d.ts +17 -22
  395. package/dist/{tooltipCoordinator-Zim5pWzk.js → tooltipCoordinator-BzxEyKhA.js} +2 -2
  396. package/dist/tooltipCoordinator-DslqMlsI.cjs +1 -0
  397. package/dist/tree/index.cjs +1 -1
  398. package/dist/tree/index.js +1 -1
  399. package/dist/ui.css +1 -1
  400. package/dist/{useFloatingDropdown-CfPEYRut.js → useFloatingDropdown-BN4J092P.js} +1 -1
  401. package/dist/{useFloatingDropdown-DcU7ozDg.cjs → useFloatingDropdown-D9OvEFAp.cjs} +1 -1
  402. package/dist/useListCommands-BO_XrRHj.js +38 -0
  403. package/dist/useListCommands-Dnm4ktP1.cjs +1 -0
  404. package/dist/useSettingsSubscription-DKjCwmRd.cjs +1 -0
  405. package/dist/{notification-CpDYN_iu.js → useSettingsSubscription-DLEk4k4j.js} +41 -32
  406. package/dist/window-CUK6x8Pj.js +36 -0
  407. package/dist/window-_BfSgFGO.cjs +1 -0
  408. package/dist/windowRegistry-CxXtP-iY.cjs +1 -0
  409. package/dist/windowRegistry-DeGmXt6W.js +20 -0
  410. package/package.json +1 -1
  411. package/dist/CommandPalette-DeEImZ8D.cjs +0 -2
  412. package/dist/CommandPalette-yqvM9AuU.js +0 -3897
  413. package/dist/DateRangePicker-7t4JKCp1.cjs +0 -9
  414. package/dist/GuidedTour-C_Lxe1t_.cjs +0 -21
  415. package/dist/GuidedTour-lsljVkPL.js +0 -11216
  416. package/dist/HostWindowContext-DqDeJmBP.cjs +0 -1
  417. package/dist/HostWindowContext-KL4U1qUv.js +0 -40
  418. package/dist/Modal-CJhd27dM.cjs +0 -1
  419. package/dist/PageSkeleton-SYSL4Adl.cjs +0 -30
  420. package/dist/Progress-B5YmNeyU.js +0 -56
  421. package/dist/Progress-BNy0wsJl.cjs +0 -1
  422. package/dist/StatusBarNotificationBell-B1bvE_SO.js +0 -2140
  423. package/dist/StatusBarNotificationBell-Cqo6cZbO.cjs +0 -4
  424. package/dist/ToggleButton-BmwDfsn4.cjs +0 -1
  425. package/dist/_internal/app/contexts/WorkspaceTabsContext.d.cts +0 -20
  426. package/dist/_internal/app/contexts/WorkspaceTabsContext.d.ts +0 -20
  427. package/dist/_internal/app/settings/theme/appThemeChange.d.cts +0 -20
  428. package/dist/_internal/app/settings/theme/appThemeChange.d.ts +0 -20
  429. package/dist/_internal/app/settings/ui/shell/openSettingsModal.d.cts +0 -6
  430. package/dist/_internal/app/settings/ui/shell/openSettingsModal.d.ts +0 -6
  431. package/dist/_internal/base/listenerDispatch.d.cts +0 -14
  432. package/dist/_internal/base/listenerDispatch.d.ts +0 -14
  433. package/dist/_internal/contract/appName.d.cts +0 -10
  434. package/dist/_internal/contract/appName.d.ts +0 -10
  435. package/dist/_internal/contract/hostText.d.cts +0 -25
  436. package/dist/_internal/contract/hostText.d.ts +0 -25
  437. package/dist/_internal/platform/logging/rendererLogging.d.cts +0 -65
  438. package/dist/_internal/platform/logging/rendererLogging.d.ts +0 -65
  439. package/dist/_internal/platform/settings/preferencesCache.d.cts +0 -162
  440. package/dist/_internal/platform/settings/preferencesCache.d.ts +0 -162
  441. package/dist/appThemeDerivation-DmKbTiFi.cjs +0 -1
  442. package/dist/catalogNotify-BcY9oqVy.js +0 -1223
  443. package/dist/catalogNotify-DacJjC-p.cjs +0 -27
  444. package/dist/createResizableSidebar-BIhyo5zN.cjs +0 -1
  445. package/dist/createResizableSidebar-Cqv-1IXG.js +0 -461
  446. package/dist/defineSettings-CcYXt2Jf.js +0 -391
  447. package/dist/defineSettings-yHQdUwxI.cjs +0 -1
  448. package/dist/descriptor-Dmch-3AF.cjs +0 -1
  449. package/dist/dialogFocusRestore-B4ggeVAM.js +0 -64
  450. package/dist/dialogFocusRestore-BcMPrbig.cjs +0 -1
  451. package/dist/displayOwner-eYQHHvjt.cjs +0 -1
  452. package/dist/displayOwner-mT80Oyi-.js +0 -75
  453. package/dist/feedback/preference.notifications.samples.d.cts +0 -1
  454. package/dist/feedback/preference.notifications.samples.d.ts +0 -1
  455. package/dist/focusModality-BNjYldd9.cjs +0 -1
  456. package/dist/focusModality-DxudpWPs.js +0 -135
  457. package/dist/format-BS7oDguE.js +0 -298
  458. package/dist/format-CuANkXXB.cjs +0 -1
  459. package/dist/i18n-DXXArz-m.cjs +0 -4
  460. package/dist/keys-BeeC5_RZ.cjs +0 -1
  461. package/dist/mainRealmDom-CkoRyNhZ.cjs +0 -1
  462. package/dist/mainRealmDom-kEStLHIY.js +0 -102
  463. package/dist/menuFavorites-BmdM_qV5.js +0 -69
  464. package/dist/menuFavorites-DoDFvtlQ.cjs +0 -1
  465. package/dist/notification-DygvQB_o.cjs +0 -1
  466. package/dist/notificationSuppressions-DGfo2QKG.cjs +0 -1
  467. package/dist/notificationSuppressions-ddyK85cB.js +0 -430
  468. package/dist/notifications/copyToClipboard.d.cts +0 -6
  469. package/dist/notifications/copyToClipboard.d.ts +0 -6
  470. package/dist/notifications/createCopyFlash.d.cts +0 -17
  471. package/dist/notifications/createCopyFlash.d.ts +0 -17
  472. package/dist/notifications/notificationDisplayOwner.d.cts +0 -27
  473. package/dist/notifications/notificationDisplayOwner.d.ts +0 -27
  474. package/dist/notifications/notificationRepeaterEntryFactory.d.cts +0 -36
  475. package/dist/notifications/notificationRepeaterEntryFactory.d.ts +0 -36
  476. package/dist/notifications/notifications.notifications.samples.d.cts +0 -1
  477. package/dist/notifications/notifications.notifications.samples.d.ts +0 -1
  478. package/dist/notifications/persistWithRollbackOnFailure.d.cts +0 -18
  479. package/dist/notifications/persistWithRollbackOnFailure.d.ts +0 -18
  480. package/dist/notifications/startNotificationSchedulers.d.cts +0 -2
  481. package/dist/notifications/startNotificationSchedulers.d.ts +0 -2
  482. package/dist/notifications/startNotificationSettingsReactions.d.cts +0 -46
  483. package/dist/notifications/startNotificationSettingsReactions.d.ts +0 -46
  484. package/dist/overlay/ToastHost.d.cts +0 -7
  485. package/dist/overlay/ToastHost.d.ts +0 -7
  486. package/dist/pageTourState-CIr8ockR.js +0 -92
  487. package/dist/pageTourState-D8Uapyft.cjs +0 -1
  488. package/dist/preferencesCache-Bow6TxP1.js +0 -65
  489. package/dist/preferencesCache-D7mm43_n.cjs +0 -1
  490. package/dist/rendererLogging-Dt5FZ8mq.cjs +0 -7
  491. package/dist/rendererLogging-gAhiHWkA.js +0 -822
  492. package/dist/server/CommandPalette-C8treS8g.cjs +0 -1
  493. package/dist/server/CommandPalette-Dslsq5Ez.js +0 -3155
  494. package/dist/server/DateRangePicker-CDKi9BAf.cjs +0 -9
  495. package/dist/server/GuidedTour-B3T9rAPX.cjs +0 -20
  496. package/dist/server/GuidedTour-DSoSZZby.js +0 -10983
  497. package/dist/server/HostWindowContext-DqDeJmBP.cjs +0 -1
  498. package/dist/server/HostWindowContext-KL4U1qUv.js +0 -40
  499. package/dist/server/Modal-CCUwQYso.cjs +0 -1
  500. package/dist/server/PageSkeleton-DdpXfZoC.cjs +0 -30
  501. package/dist/server/Progress-CRbj6nEy.cjs +0 -1
  502. package/dist/server/Progress-nsDy6clG.js +0 -41
  503. package/dist/server/StatusBarNotificationBell-C64Odn2C.js +0 -1974
  504. package/dist/server/StatusBarNotificationBell-DY0Q27su.cjs +0 -4
  505. package/dist/server/ToggleButton-1bNYk35x.cjs +0 -1
  506. package/dist/server/VpTerminal-Bpw-d9wD.js +0 -186
  507. package/dist/server/VpTerminal-C-U_dN_x.cjs +0 -1
  508. package/dist/server/VpTrash-CagiU2Uj.cjs +0 -1
  509. package/dist/server/VpTrash-DVBfts9_.js +0 -116
  510. package/dist/server/appThemeDerivation-DmKbTiFi.cjs +0 -1
  511. package/dist/server/catalogNotify-MCW2sa2e.cjs +0 -27
  512. package/dist/server/catalogNotify-s3YymAe8.js +0 -1261
  513. package/dist/server/createResizableSidebar-MIzUlfdd.js +0 -299
  514. package/dist/server/createResizableSidebar-TdxLuiY8.cjs +0 -1
  515. package/dist/server/defineSettings-CcYXt2Jf.js +0 -391
  516. package/dist/server/defineSettings-yHQdUwxI.cjs +0 -1
  517. package/dist/server/descriptor-DAyyoF-I.cjs +0 -1
  518. package/dist/server/dialogFocusRestore-B4ggeVAM.js +0 -64
  519. package/dist/server/dialogFocusRestore-BcMPrbig.cjs +0 -1
  520. package/dist/server/displayOwner-eYQHHvjt.cjs +0 -1
  521. package/dist/server/displayOwner-mT80Oyi-.js +0 -75
  522. package/dist/server/focusModality-BKgJWRlC.cjs +0 -1
  523. package/dist/server/format-WfZycMBL.cjs +0 -1
  524. package/dist/server/i18n-DXXArz-m.cjs +0 -4
  525. package/dist/server/index-DlQYWckZ.cjs +0 -1
  526. package/dist/server/mainRealmDom-BCL1p_q6.cjs +0 -1
  527. package/dist/server/mainRealmDom-Dk0xb5Gj.js +0 -67
  528. package/dist/server/menuFavorites-BmdM_qV5.js +0 -69
  529. package/dist/server/menuFavorites-DoDFvtlQ.cjs +0 -1
  530. package/dist/server/notification-DygvQB_o.cjs +0 -1
  531. package/dist/server/notificationSuppressions-B-LKq9ZU.js +0 -391
  532. package/dist/server/notificationSuppressions-Dcc2WFBZ.cjs +0 -1
  533. package/dist/server/pageTourState-CIr8ockR.js +0 -92
  534. package/dist/server/pageTourState-D8Uapyft.cjs +0 -1
  535. package/dist/server/preferencesCache-Bow6TxP1.js +0 -65
  536. package/dist/server/preferencesCache-D7mm43_n.cjs +0 -1
  537. package/dist/server/rendererLogging-Dt5FZ8mq.cjs +0 -7
  538. package/dist/server/rendererLogging-gAhiHWkA.js +0 -822
  539. package/dist/server/settingsSearchContributor-CRZsl2Q_.js +0 -199
  540. package/dist/server/settingsSearchContributor-DH8UFpp2.cjs +0 -1
  541. package/dist/server/stateDbStore-Ds3zJ4cd.js +0 -47
  542. package/dist/server/stateDbStore-THFfFGa0.cjs +0 -1
  543. package/dist/server/useListCommands-Bf7aOTXZ.js +0 -61
  544. package/dist/server/useListCommands-ucngC3t4.cjs +0 -1
  545. package/dist/server/useSettingsSubscription-cu943hND.js +0 -11
  546. package/dist/server/useSettingsSubscription-vlMrNNH9.cjs +0 -1
  547. package/dist/server/visibleBrowserRegistry-BTfWUlI1.cjs +0 -1
  548. package/dist/server/visibleBrowserRegistry-Dw2Y4y_I.js +0 -89
  549. package/dist/server/windowRegistry-Bk5lXIVd.js +0 -62
  550. package/dist/server/windowRegistry-CGvOBUsw.cjs +0 -1
  551. package/dist/settingsSearchContributor-DWP5dwn3.js +0 -199
  552. package/dist/settingsSearchContributor-Dltbs1j_.cjs +0 -1
  553. package/dist/solid/_internal/app/contexts/WorkspaceTabsContext.js +0 -10
  554. package/dist/solid/_internal/app/settings/theme/appThemeChange.js +0 -5
  555. package/dist/solid/_internal/app/settings/ui/shell/openSettingsModal.js +0 -15
  556. package/dist/solid/_internal/base/listenerDispatch.js +0 -12
  557. package/dist/solid/_internal/contract/appName.js +0 -7
  558. package/dist/solid/_internal/contract/hostText.js +0 -15
  559. package/dist/solid/_internal/platform/logging/rendererLogging.js +0 -42
  560. package/dist/solid/_internal/platform/settings/preferencesCache.js +0 -329
  561. package/dist/solid/feedback/preference.notifications.samples.js +0 -5
  562. package/dist/solid/notifications/copyToClipboard.js +0 -21
  563. package/dist/solid/notifications/createCopyFlash.js +0 -26
  564. package/dist/solid/notifications/notificationDisplayOwner.js +0 -1
  565. package/dist/solid/notifications/notificationRepeaterEntryFactory.js +0 -20
  566. package/dist/solid/notifications/notifications.notifications.samples.js +0 -14
  567. package/dist/solid/notifications/persistWithRollbackOnFailure.js +0 -11
  568. package/dist/solid/notifications/startNotificationSchedulers.js +0 -8
  569. package/dist/solid/notifications/startNotificationSettingsReactions.js +0 -22
  570. package/dist/solid/overlay/ToastHost.jsx +0 -1
  571. package/dist/stateDbStore-Ds3zJ4cd.js +0 -47
  572. package/dist/stateDbStore-THFfFGa0.cjs +0 -1
  573. package/dist/tooltipCoordinator-Causlcgt.cjs +0 -1
  574. package/dist/useListCommands-Bf7aOTXZ.js +0 -61
  575. package/dist/useListCommands-ucngC3t4.cjs +0 -1
  576. package/dist/useSettingsSubscription-cu943hND.js +0 -11
  577. package/dist/useSettingsSubscription-vlMrNNH9.cjs +0 -1
  578. package/dist/visibleBrowserRegistry-BTfWUlI1.cjs +0 -1
  579. package/dist/visibleBrowserRegistry-Dw2Y4y_I.js +0 -89
  580. package/dist/windowRegistry-Bk5lXIVd.js +0 -62
  581. package/dist/windowRegistry-CGvOBUsw.cjs +0 -1
@@ -1,25 +1,78 @@
1
+ /**
2
+ * The page tours of a realm — which tour runs, which page's tour the user has seen, and the coordination
3
+ * between the tour hosts that could start one.
4
+ *
5
+ * A plain class: the host creates one per realm with its storage and hands it to the kit
6
+ * (`KitHost.tours`); the kit's tour hosts and the host's own read the same instance, so one tour runs at a
7
+ * time across both. The status of each page's tour and the user's opt-out persist in the host's storage
8
+ * (APPLICATION scope, machine target, under `onboarding:page:<page>` and `onboarding:neverShowAgain`).
9
+ */
10
+ import { type Accessor } from 'solid-js';
11
+ import { type SettingsBackend } from '../../platform/settings/registry/stateDbStore.cjs';
1
12
  import type { TourPageId } from './pageTourTypes.cjs';
2
- export type TourStatus = 'shown' | 'skipped' | 'completed';
3
- export declare function getActiveTourPage(): TourPageId | null;
13
+ export declare const TOUR_STATUSES: readonly ["shown", "skipped", "completed"];
14
+ export type TourStatus = (typeof TOUR_STATUSES)[number];
15
+ /** The page a tour id stands for — two pages are known under two ids each. */
4
16
  export declare function canonicalTourPageId(page: TourPageId): TourPageId;
5
- export declare function isPageTourActive(page: TourPageId): boolean;
6
- export declare function setActiveTour(page: TourPageId | null): void;
7
- export declare function isNeverShowToursAgain(): boolean;
8
- export declare function setNeverShowToursAgain(never: boolean): void;
9
- export declare function readTourStatus(page: TourPageId): string | undefined;
10
- export declare function writeTourStatus(page: TourPageId, status: TourStatus): void;
11
- export declare function setSkipWelcome(value: boolean): void;
12
- export declare function shouldSkipWelcome(): boolean;
13
- interface TourHost {
14
- page: TourPageId;
15
- document: () => Document;
16
- visible: () => boolean;
17
- start: () => void;
18
- dismiss?: () => void;
17
+ /** A mounted surface that can run its page's tour. */
18
+ export interface TourHost {
19
+ readonly page: TourPageId;
20
+ document(): Document;
21
+ visible(): boolean;
22
+ start(): void;
23
+ dismiss?(): void;
24
+ }
25
+ export interface PageTours {
26
+ /** The page whose tour is running (reactive). */
27
+ readonly activePage: Accessor<TourPageId | null>;
28
+ isActive(page: TourPageId): boolean;
29
+ setActive(page: TourPageId | null): void;
30
+ /** The stored status of a page's tour; every page reads `'skipped'` once the user opted out of tours. */
31
+ readStatus(page: TourPageId): TourStatus | undefined;
32
+ writeStatus(page: TourPageId, status: TourStatus): void;
33
+ isNeverShowAgain(): boolean;
34
+ setNeverShowAgain(never: boolean): void;
35
+ /**
36
+ * Whether the shell skips the automatic first-run tour — the command line's answer, the reference's
37
+ * `environmentService.skipWelcome`. It silences only the automatic opening, never the user's own
38
+ * request, and it is NOT stored: it is a fact of this process, not a decision about the user.
39
+ */
40
+ skipWelcome(): boolean;
41
+ setSkipWelcome(skip: boolean): void;
42
+ /** Claims the right to run a tour; another token's claim refuses it. */
43
+ claim(token: object): boolean;
44
+ release(token: object): void;
45
+ registerHost(host: TourHost): () => void;
46
+ /**
47
+ * Starts the tour of `page` (or the visible page's) in its host, the one in the active window first.
48
+ * With no such host mounted yet, the request waits for it ({@link consumeRequest}).
49
+ */
50
+ request(page?: TourPageId): boolean;
51
+ /** Takes a waiting request for `page` — true while it has not expired. */
52
+ consumeRequest(page: TourPageId): boolean;
53
+ }
54
+ export declare class PageTourService implements PageTours {
55
+ private readonly storage;
56
+ readonly activePage: Accessor<TourPageId | null>;
57
+ private readonly setActivePage;
58
+ private readonly seen;
59
+ private neverShowAgainCache;
60
+ private skipWelcomeFlag;
61
+ private readonly hosts;
62
+ private owner;
63
+ private pending;
64
+ constructor(storage: SettingsBackend);
65
+ isActive(page: TourPageId): boolean;
66
+ setActive(page: TourPageId | null): void;
67
+ readStatus(page: TourPageId): TourStatus | undefined;
68
+ writeStatus(page: TourPageId, status: TourStatus): void;
69
+ isNeverShowAgain(): boolean;
70
+ setNeverShowAgain(never: boolean): void;
71
+ skipWelcome(): boolean;
72
+ setSkipWelcome(skip: boolean): void;
73
+ claim(token: object): boolean;
74
+ release(token: object): void;
75
+ registerHost(host: TourHost): () => void;
76
+ request(page?: TourPageId): boolean;
77
+ consumeRequest(page: TourPageId): boolean;
19
78
  }
20
- export declare function claimTour(token: object): boolean;
21
- export declare function releaseTour(token: object): void;
22
- export declare function registerTourHost(host: TourHost): () => void;
23
- export declare function requestPageTour(page?: TourPageId): boolean;
24
- export declare function consumeTourRequest(page: TourPageId): boolean;
25
- export {};
@@ -1,25 +1,78 @@
1
+ /**
2
+ * The page tours of a realm — which tour runs, which page's tour the user has seen, and the coordination
3
+ * between the tour hosts that could start one.
4
+ *
5
+ * A plain class: the host creates one per realm with its storage and hands it to the kit
6
+ * (`KitHost.tours`); the kit's tour hosts and the host's own read the same instance, so one tour runs at a
7
+ * time across both. The status of each page's tour and the user's opt-out persist in the host's storage
8
+ * (APPLICATION scope, machine target, under `onboarding:page:<page>` and `onboarding:neverShowAgain`).
9
+ */
10
+ import { type Accessor } from 'solid-js';
11
+ import { type SettingsBackend } from '../../platform/settings/registry/stateDbStore.js';
1
12
  import type { TourPageId } from './pageTourTypes.js';
2
- export type TourStatus = 'shown' | 'skipped' | 'completed';
3
- export declare function getActiveTourPage(): TourPageId | null;
13
+ export declare const TOUR_STATUSES: readonly ["shown", "skipped", "completed"];
14
+ export type TourStatus = (typeof TOUR_STATUSES)[number];
15
+ /** The page a tour id stands for — two pages are known under two ids each. */
4
16
  export declare function canonicalTourPageId(page: TourPageId): TourPageId;
5
- export declare function isPageTourActive(page: TourPageId): boolean;
6
- export declare function setActiveTour(page: TourPageId | null): void;
7
- export declare function isNeverShowToursAgain(): boolean;
8
- export declare function setNeverShowToursAgain(never: boolean): void;
9
- export declare function readTourStatus(page: TourPageId): string | undefined;
10
- export declare function writeTourStatus(page: TourPageId, status: TourStatus): void;
11
- export declare function setSkipWelcome(value: boolean): void;
12
- export declare function shouldSkipWelcome(): boolean;
13
- interface TourHost {
14
- page: TourPageId;
15
- document: () => Document;
16
- visible: () => boolean;
17
- start: () => void;
18
- dismiss?: () => void;
17
+ /** A mounted surface that can run its page's tour. */
18
+ export interface TourHost {
19
+ readonly page: TourPageId;
20
+ document(): Document;
21
+ visible(): boolean;
22
+ start(): void;
23
+ dismiss?(): void;
24
+ }
25
+ export interface PageTours {
26
+ /** The page whose tour is running (reactive). */
27
+ readonly activePage: Accessor<TourPageId | null>;
28
+ isActive(page: TourPageId): boolean;
29
+ setActive(page: TourPageId | null): void;
30
+ /** The stored status of a page's tour; every page reads `'skipped'` once the user opted out of tours. */
31
+ readStatus(page: TourPageId): TourStatus | undefined;
32
+ writeStatus(page: TourPageId, status: TourStatus): void;
33
+ isNeverShowAgain(): boolean;
34
+ setNeverShowAgain(never: boolean): void;
35
+ /**
36
+ * Whether the shell skips the automatic first-run tour — the command line's answer, the reference's
37
+ * `environmentService.skipWelcome`. It silences only the automatic opening, never the user's own
38
+ * request, and it is NOT stored: it is a fact of this process, not a decision about the user.
39
+ */
40
+ skipWelcome(): boolean;
41
+ setSkipWelcome(skip: boolean): void;
42
+ /** Claims the right to run a tour; another token's claim refuses it. */
43
+ claim(token: object): boolean;
44
+ release(token: object): void;
45
+ registerHost(host: TourHost): () => void;
46
+ /**
47
+ * Starts the tour of `page` (or the visible page's) in its host, the one in the active window first.
48
+ * With no such host mounted yet, the request waits for it ({@link consumeRequest}).
49
+ */
50
+ request(page?: TourPageId): boolean;
51
+ /** Takes a waiting request for `page` — true while it has not expired. */
52
+ consumeRequest(page: TourPageId): boolean;
53
+ }
54
+ export declare class PageTourService implements PageTours {
55
+ private readonly storage;
56
+ readonly activePage: Accessor<TourPageId | null>;
57
+ private readonly setActivePage;
58
+ private readonly seen;
59
+ private neverShowAgainCache;
60
+ private skipWelcomeFlag;
61
+ private readonly hosts;
62
+ private owner;
63
+ private pending;
64
+ constructor(storage: SettingsBackend);
65
+ isActive(page: TourPageId): boolean;
66
+ setActive(page: TourPageId | null): void;
67
+ readStatus(page: TourPageId): TourStatus | undefined;
68
+ writeStatus(page: TourPageId, status: TourStatus): void;
69
+ isNeverShowAgain(): boolean;
70
+ setNeverShowAgain(never: boolean): void;
71
+ skipWelcome(): boolean;
72
+ setSkipWelcome(skip: boolean): void;
73
+ claim(token: object): boolean;
74
+ release(token: object): void;
75
+ registerHost(host: TourHost): () => void;
76
+ request(page?: TourPageId): boolean;
77
+ consumeRequest(page: TourPageId): boolean;
19
78
  }
20
- export declare function claimTour(token: object): boolean;
21
- export declare function releaseTour(token: object): void;
22
- export declare function registerTourHost(host: TourHost): () => void;
23
- export declare function requestPageTour(page?: TourPageId): boolean;
24
- export declare function consumeTourRequest(page: TourPageId): boolean;
25
- export {};
@@ -1,20 +1,20 @@
1
1
  /**
2
- * ui adapter: the desktop bridge.
2
+ * The desktop bridge — the native behaviour the kit's notification system and surfaces use, provided by
3
+ * the host (decision 0008: the kit never imports Electron):
3
4
  *
4
- * The host app's bridge wraps `window.electronAPI` (IPC to its main process). The notification
5
- * system in ui calls six of its functions; ui keeps their signatures with browser
6
- * defaults and lets a desktop host (Electron, Tauri …) plug native behaviour in with
7
- * {@link configureDesktopBridge} (decision 0008 — the kit never imports Electron):
5
+ * openExternal open a link outside the app
6
+ * osNotify an OS notification (the in-app toast is shown regardless)
7
+ * setBadgeCount the dock/taskbar badge
8
+ * readAudioAsDataUrl a custom notification sound from disk
9
+ * fs save dialog + write, for the timeline export
10
+ * notificationOverlay the native notification overlay over embedded browser views
8
11
  *
9
- * openExternal same protocol allow-list (http/https/mailto); default `window.open`
10
- * osNotify OS notification; default: none (the in-app toast is always shown)
11
- * setOsBadgeCount dock/taskbar badge; default: none
12
- * readAudioAsDataUrl custom notification sound from disk; default: null (no custom sound)
13
- * getFsService save dialog + write for timeline export; default: browser download
14
- * notificationOverlayBridge native notification overlay over embedded browser views
15
- * (host app: electronAPI.browser.workspace); default: none
12
+ * The host hands one bridge to the kit (`KitHost.desktop`) and to its notification service. Every member
13
+ * is required: a platform without a capability says so in its implementation, as the browser's own does
14
+ * (`browserDesktopBridge`) — there is no fallback inside the kit.
16
15
  */
17
16
  import type { BrowserWorkspaceApi } from '../../contract/browser/workspace.cjs';
17
+ import type { ILogger } from '../../base/logging/ILogger.cjs';
18
18
  export interface OsNotifyOptions {
19
19
  title: string;
20
20
  body?: string;
@@ -28,7 +28,7 @@ export interface ShowSaveDialogResult {
28
28
  /** `null` or absent when the dialog was cancelled. */
29
29
  filePath?: string | null;
30
30
  }
31
- /** The file-system calls the notification export makes (host app: ElectronFsService). */
31
+ /** The file-system calls the notification export makes. */
32
32
  export interface DesktopFsService {
33
33
  showSaveDialog(options?: {
34
34
  title?: string;
@@ -46,21 +46,27 @@ export interface DesktopFsService {
46
46
  * other member, so the rest of the host's browser contract can change without touching the kit's types.
47
47
  */
48
48
  export type NotificationOverlayPort = Pick<BrowserWorkspaceApi, 'setNotificationOverlay' | 'onNotificationOverlayClose' | 'onNotificationOverlayAction' | 'onNotificationOverlayHover' | 'onNotificationOverlayFocus' | 'onNotificationOverlayPresented' | 'onNotificationOverlayToggleExpanded' | 'onNotificationOverlayCommand'>;
49
- /** ui extension: native behaviour a desktop host provides. Every member is optional. */
49
+ /** Native behaviour a host provides. */
50
50
  export interface DesktopBridge {
51
- openExternal?(url: string): void | Promise<void>;
52
- osNotify?(opts: OsNotifyOptions): void | Promise<void>;
53
- setBadgeCount?(count: number): void | Promise<void>;
54
- readAudioAsDataUrl?(filePath: string): Promise<string | null>;
55
- fs?: DesktopFsService;
56
- notificationOverlay?(win: Window): NotificationOverlayPort | undefined;
51
+ /** Opens a link outside the app. The kit calls it only with an allowed protocol (`openExternalUrl`). */
52
+ openExternal(url: string): void | Promise<void>;
53
+ osNotify(opts: OsNotifyOptions): void | Promise<void>;
54
+ setBadgeCount(count: number): void | Promise<void>;
55
+ /** A custom sound's data URL; `null` when the file cannot be read. */
56
+ readAudioAsDataUrl(filePath: string): Promise<string | null>;
57
+ readonly fs: DesktopFsService;
58
+ /** The native overlay of `win`; `undefined` where that window has none. */
59
+ notificationOverlay(win: Window): NotificationOverlayPort | undefined;
57
60
  }
58
- /** ui extension: plug a desktop host's native implementations in (call once at boot). */
59
- export declare function configureDesktopBridge(next: DesktopBridge | null): void;
60
- export declare function openExternal(url: string): void;
61
- export declare function osNotify(opts: OsNotifyOptions): void;
62
- export declare function setOsBadgeCount(count: number): void;
63
- export declare function readAudioAsDataUrl(filePath: string): Promise<string | null>;
64
- export declare function getFsService(): DesktopFsService;
65
- /** Native notification overlay port of `win` (host app: from `win.electronAPI.browser.workspace`). */
66
- export declare function notificationOverlayBridge(win: Window | undefined): NotificationOverlayPort | undefined;
61
+ /**
62
+ * Opens `url` through the host — only an http, https or mailto link. Links come from text the kit did not
63
+ * write (a notification's markdown body, a vendor's documentation table), so the protocol is checked
64
+ * before the host sees it; a refused or failed link is logged, never silent.
65
+ */
66
+ export declare function openExternalUrl(desktop: DesktopBridge, log: ILogger, url: string): void;
67
+ /**
68
+ * The browser's own behaviour, for a host that runs in a plain page: links open in a new tab, an export
69
+ * is a download. A browser page has no OS notification centre of its own, no badge, no custom sound file
70
+ * and no native overlay — those members do nothing, and that is the browser's answer, not a fallback.
71
+ */
72
+ export declare const browserDesktopBridge: DesktopBridge;
@@ -1,20 +1,20 @@
1
1
  /**
2
- * ui adapter: the desktop bridge.
2
+ * The desktop bridge — the native behaviour the kit's notification system and surfaces use, provided by
3
+ * the host (decision 0008: the kit never imports Electron):
3
4
  *
4
- * The host app's bridge wraps `window.electronAPI` (IPC to its main process). The notification
5
- * system in ui calls six of its functions; ui keeps their signatures with browser
6
- * defaults and lets a desktop host (Electron, Tauri …) plug native behaviour in with
7
- * {@link configureDesktopBridge} (decision 0008 — the kit never imports Electron):
5
+ * openExternal open a link outside the app
6
+ * osNotify an OS notification (the in-app toast is shown regardless)
7
+ * setBadgeCount the dock/taskbar badge
8
+ * readAudioAsDataUrl a custom notification sound from disk
9
+ * fs save dialog + write, for the timeline export
10
+ * notificationOverlay the native notification overlay over embedded browser views
8
11
  *
9
- * openExternal same protocol allow-list (http/https/mailto); default `window.open`
10
- * osNotify OS notification; default: none (the in-app toast is always shown)
11
- * setOsBadgeCount dock/taskbar badge; default: none
12
- * readAudioAsDataUrl custom notification sound from disk; default: null (no custom sound)
13
- * getFsService save dialog + write for timeline export; default: browser download
14
- * notificationOverlayBridge native notification overlay over embedded browser views
15
- * (host app: electronAPI.browser.workspace); default: none
12
+ * The host hands one bridge to the kit (`KitHost.desktop`) and to its notification service. Every member
13
+ * is required: a platform without a capability says so in its implementation, as the browser's own does
14
+ * (`browserDesktopBridge`) — there is no fallback inside the kit.
16
15
  */
17
16
  import type { BrowserWorkspaceApi } from '../../contract/browser/workspace.js';
17
+ import type { ILogger } from '../../base/logging/ILogger.js';
18
18
  export interface OsNotifyOptions {
19
19
  title: string;
20
20
  body?: string;
@@ -28,7 +28,7 @@ export interface ShowSaveDialogResult {
28
28
  /** `null` or absent when the dialog was cancelled. */
29
29
  filePath?: string | null;
30
30
  }
31
- /** The file-system calls the notification export makes (host app: ElectronFsService). */
31
+ /** The file-system calls the notification export makes. */
32
32
  export interface DesktopFsService {
33
33
  showSaveDialog(options?: {
34
34
  title?: string;
@@ -46,21 +46,27 @@ export interface DesktopFsService {
46
46
  * other member, so the rest of the host's browser contract can change without touching the kit's types.
47
47
  */
48
48
  export type NotificationOverlayPort = Pick<BrowserWorkspaceApi, 'setNotificationOverlay' | 'onNotificationOverlayClose' | 'onNotificationOverlayAction' | 'onNotificationOverlayHover' | 'onNotificationOverlayFocus' | 'onNotificationOverlayPresented' | 'onNotificationOverlayToggleExpanded' | 'onNotificationOverlayCommand'>;
49
- /** ui extension: native behaviour a desktop host provides. Every member is optional. */
49
+ /** Native behaviour a host provides. */
50
50
  export interface DesktopBridge {
51
- openExternal?(url: string): void | Promise<void>;
52
- osNotify?(opts: OsNotifyOptions): void | Promise<void>;
53
- setBadgeCount?(count: number): void | Promise<void>;
54
- readAudioAsDataUrl?(filePath: string): Promise<string | null>;
55
- fs?: DesktopFsService;
56
- notificationOverlay?(win: Window): NotificationOverlayPort | undefined;
51
+ /** Opens a link outside the app. The kit calls it only with an allowed protocol (`openExternalUrl`). */
52
+ openExternal(url: string): void | Promise<void>;
53
+ osNotify(opts: OsNotifyOptions): void | Promise<void>;
54
+ setBadgeCount(count: number): void | Promise<void>;
55
+ /** A custom sound's data URL; `null` when the file cannot be read. */
56
+ readAudioAsDataUrl(filePath: string): Promise<string | null>;
57
+ readonly fs: DesktopFsService;
58
+ /** The native overlay of `win`; `undefined` where that window has none. */
59
+ notificationOverlay(win: Window): NotificationOverlayPort | undefined;
57
60
  }
58
- /** ui extension: plug a desktop host's native implementations in (call once at boot). */
59
- export declare function configureDesktopBridge(next: DesktopBridge | null): void;
60
- export declare function openExternal(url: string): void;
61
- export declare function osNotify(opts: OsNotifyOptions): void;
62
- export declare function setOsBadgeCount(count: number): void;
63
- export declare function readAudioAsDataUrl(filePath: string): Promise<string | null>;
64
- export declare function getFsService(): DesktopFsService;
65
- /** Native notification overlay port of `win` (host app: from `win.electronAPI.browser.workspace`). */
66
- export declare function notificationOverlayBridge(win: Window | undefined): NotificationOverlayPort | undefined;
61
+ /**
62
+ * Opens `url` through the host — only an http, https or mailto link. Links come from text the kit did not
63
+ * write (a notification's markdown body, a vendor's documentation table), so the protocol is checked
64
+ * before the host sees it; a refused or failed link is logged, never silent.
65
+ */
66
+ export declare function openExternalUrl(desktop: DesktopBridge, log: ILogger, url: string): void;
67
+ /**
68
+ * The browser's own behaviour, for a host that runs in a plain page: links open in a new tab, an export
69
+ * is a download. A browser page has no OS notification centre of its own, no badge, no custom sound file
70
+ * and no native overlay — those members do nothing, and that is the browser's answer, not a fallback.
71
+ */
72
+ export declare const browserDesktopBridge: DesktopBridge;
@@ -1,3 +1,11 @@
1
+ /**
2
+ * The notification secrets — the SMTP password of the e-mail digest and each webhook's URL
3
+ * (bearer-equivalent) — and the one key scheme they are stored under.
4
+ *
5
+ * The helpers take the store they read and write: the application keeps these secrets in its own
6
+ * secret store and passes it — to these helpers and to its notification service, which reads the
7
+ * digest's SMTP password and the webhook URLs from it. There is no in-memory store in the kit.
8
+ */
1
9
  /** Where the notification secrets are kept. */
2
10
  export interface NotificationSecretStore {
3
11
  get(key: string): Promise<string | undefined>;
@@ -6,10 +14,6 @@ export interface NotificationSecretStore {
6
14
  /** Every stored key — the helpers select the notification keys themselves. */
7
15
  keys(): Promise<readonly string[]>;
8
16
  }
9
- /** The store the notification engine reads (the digest's SMTP password, webhook URLs). */
10
- export declare function provideNotificationSecretStore(store: NotificationSecretStore): void;
11
- /** The store bound for the notification engine. */
12
- export declare function notificationSecretStore(): NotificationSecretStore;
13
17
  /** The e-mail digest's SMTP password (undefined when unset). */
14
18
  export declare function getSmtpPass(store: NotificationSecretStore): Promise<string | undefined>;
15
19
  /** Stores the SMTP password, or deletes it when blank. */
@@ -1,3 +1,11 @@
1
+ /**
2
+ * The notification secrets — the SMTP password of the e-mail digest and each webhook's URL
3
+ * (bearer-equivalent) — and the one key scheme they are stored under.
4
+ *
5
+ * The helpers take the store they read and write: the application keeps these secrets in its own
6
+ * secret store and passes it — to these helpers and to its notification service, which reads the
7
+ * digest's SMTP password and the webhook URLs from it. There is no in-memory store in the kit.
8
+ */
1
9
  /** Where the notification secrets are kept. */
2
10
  export interface NotificationSecretStore {
3
11
  get(key: string): Promise<string | undefined>;
@@ -6,10 +14,6 @@ export interface NotificationSecretStore {
6
14
  /** Every stored key — the helpers select the notification keys themselves. */
7
15
  keys(): Promise<readonly string[]>;
8
16
  }
9
- /** The store the notification engine reads (the digest's SMTP password, webhook URLs). */
10
- export declare function provideNotificationSecretStore(store: NotificationSecretStore): void;
11
- /** The store bound for the notification engine. */
12
- export declare function notificationSecretStore(): NotificationSecretStore;
13
17
  /** The e-mail digest's SMTP password (undefined when unset). */
14
18
  export declare function getSmtpPass(store: NotificationSecretStore): Promise<string | undefined>;
15
19
  /** Stores the SMTP password, or deletes it when blank. */
@@ -1,26 +1,20 @@
1
1
  /**
2
- * ui adapter: same API (`HostWindowProvider`, `useHostWindow`, `useHostDocument`,
2
+ * The window a component tree is mounted in (`HostWindowProvider`, `useHostWindow`, `useHostDocument`,
3
3
  * `useHostWindowClose`).
4
4
  *
5
- * The host app throws when a subtree is mounted without a provider (its shell always wraps the
6
- * main and aux roots). A component library is mounted by arbitrary hosts, so without a
7
- * provider the window comes from the host window port (`src/host/window`, global window by
8
- * default). Hosts that render into auxiliary windows wrap those roots in
9
- * `<HostWindowProvider value={{ id, window, document }}>` exactly like the host app.
5
+ * Unlike the active window (a realm fact, `src/host/window`), the window of a subtree is a fact of its
6
+ * ROOT: the main root renders into the main window, an auxiliary root into its own. So it is given at the
7
+ * root, and there is no fallback — a subtree mounted without a provider throws. A silent main-window
8
+ * fallback would let a forgotten auxiliary root portal its popovers, menus and toasts into the main
9
+ * window, where nothing points at the mistake.
10
10
  */
11
11
  import { type JSX } from 'solid-js';
12
- import { type RegisteredWindow } from './windowRegistry.cjs';
13
- /**
14
- * ui extension: a multi-window host that wraps every mount root in a `HostWindowProvider` can
15
- * require it, so a subtree mounted without one throws instead of quietly using the main
16
- * window (the host app's rule). Off by default.
17
- */
18
- export declare function requireHostWindowProvider(required: boolean): void;
12
+ import type { RegisteredWindow } from './windowRegistry.cjs';
19
13
  export declare function HostWindowProvider(props: {
20
14
  value: RegisteredWindow;
21
15
  children: JSX.Element;
22
16
  }): JSX.Element;
23
- /** The window hosting the calling subtree (provider value, else the host main window). */
17
+ /** The window hosting the calling subtree — read during the component's setup. */
24
18
  export declare function useHostWindow(): RegisteredWindow;
25
19
  export declare function useHostDocument(): Document;
26
20
  export declare function useHostWindowClose(): () => void;
@@ -1,26 +1,20 @@
1
1
  /**
2
- * ui adapter: same API (`HostWindowProvider`, `useHostWindow`, `useHostDocument`,
2
+ * The window a component tree is mounted in (`HostWindowProvider`, `useHostWindow`, `useHostDocument`,
3
3
  * `useHostWindowClose`).
4
4
  *
5
- * The host app throws when a subtree is mounted without a provider (its shell always wraps the
6
- * main and aux roots). A component library is mounted by arbitrary hosts, so without a
7
- * provider the window comes from the host window port (`src/host/window`, global window by
8
- * default). Hosts that render into auxiliary windows wrap those roots in
9
- * `<HostWindowProvider value={{ id, window, document }}>` exactly like the host app.
5
+ * Unlike the active window (a realm fact, `src/host/window`), the window of a subtree is a fact of its
6
+ * ROOT: the main root renders into the main window, an auxiliary root into its own. So it is given at the
7
+ * root, and there is no fallback — a subtree mounted without a provider throws. A silent main-window
8
+ * fallback would let a forgotten auxiliary root portal its popovers, menus and toasts into the main
9
+ * window, where nothing points at the mistake.
10
10
  */
11
11
  import { type JSX } from 'solid-js';
12
- import { type RegisteredWindow } from './windowRegistry.js';
13
- /**
14
- * ui extension: a multi-window host that wraps every mount root in a `HostWindowProvider` can
15
- * require it, so a subtree mounted without one throws instead of quietly using the main
16
- * window (the host app's rule). Off by default.
17
- */
18
- export declare function requireHostWindowProvider(required: boolean): void;
12
+ import type { RegisteredWindow } from './windowRegistry.js';
19
13
  export declare function HostWindowProvider(props: {
20
14
  value: RegisteredWindow;
21
15
  children: JSX.Element;
22
16
  }): JSX.Element;
23
- /** The window hosting the calling subtree (provider value, else the host main window). */
17
+ /** The window hosting the calling subtree — read during the component's setup. */
24
18
  export declare function useHostWindow(): RegisteredWindow;
25
19
  export declare function useHostDocument(): Document;
26
20
  export declare function useHostWindowClose(): () => void;
@@ -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.cjs';
11
- import type { NotificationCatalogMetadata, NotificationCatalogPayload, NotificationDefinition, NotificationScenarioDescriptor } from './notificationCatalog.cjs';
10
+ import type { NotificationCatalogMetadata, NotificationCatalogPayload } from './notificationCatalog.cjs';
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,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;