@dxos/app-framework 0.8.4-main.f9ba587 → 0.8.4-main.fcfe5033a5

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 (701) hide show
  1. package/.storybook/main.mts +9 -0
  2. package/.storybook/preview.mts +8 -0
  3. package/.swc/plugins/linux_x86_64_19.0.0/727453fb3a62f7f1d952a41e051ca8a6f88cadc45cee43c6a4d1aa45f9b75665.wasmer-v7 +0 -0
  4. package/dist/lib/browser/capability-EYY7KYU5.mjs +35 -0
  5. package/dist/lib/browser/capability-EYY7KYU5.mjs.map +7 -0
  6. package/dist/lib/browser/capability-W7NPZR6A.mjs +38 -0
  7. package/dist/lib/browser/capability-W7NPZR6A.mjs.map +7 -0
  8. package/dist/lib/browser/chunk-2CKCJ6PN.mjs +79 -0
  9. package/dist/lib/browser/chunk-2CKCJ6PN.mjs.map +7 -0
  10. package/dist/lib/browser/chunk-4D6YAWLP.mjs +393 -0
  11. package/dist/lib/browser/chunk-4D6YAWLP.mjs.map +7 -0
  12. package/dist/lib/browser/chunk-56CEL32L.mjs +963 -0
  13. package/dist/lib/browser/chunk-56CEL32L.mjs.map +7 -0
  14. package/dist/lib/browser/chunk-F7FW2RK2.mjs +167 -0
  15. package/dist/lib/browser/chunk-F7FW2RK2.mjs.map +7 -0
  16. package/dist/lib/browser/chunk-I34GF4NG.mjs +34 -0
  17. package/dist/lib/browser/chunk-I34GF4NG.mjs.map +7 -0
  18. package/dist/lib/browser/chunk-J5LGTIGS.mjs +10 -0
  19. package/dist/lib/browser/chunk-JKWMHZP6.mjs +80 -0
  20. package/dist/lib/browser/chunk-JKWMHZP6.mjs.map +7 -0
  21. package/dist/lib/browser/chunk-QRTB4Q3U.mjs +594 -0
  22. package/dist/lib/browser/chunk-QRTB4Q3U.mjs.map +7 -0
  23. package/dist/lib/browser/chunk-QSXYHXCE.mjs +48 -0
  24. package/dist/lib/browser/chunk-QSXYHXCE.mjs.map +7 -0
  25. package/dist/lib/browser/chunk-RFSO3JRG.mjs +1 -0
  26. package/dist/lib/browser/chunk-RHQGPRWN.mjs +174 -0
  27. package/dist/lib/browser/chunk-RHQGPRWN.mjs.map +7 -0
  28. package/dist/lib/browser/chunk-T3Y4AEKX.mjs +42 -0
  29. package/dist/lib/browser/chunk-T3Y4AEKX.mjs.map +7 -0
  30. package/dist/lib/browser/chunk-TGX63LTL.mjs +8 -0
  31. package/dist/lib/browser/chunk-TGX63LTL.mjs.map +7 -0
  32. package/dist/lib/browser/chunk-ZBA6IH6L.mjs +148 -0
  33. package/dist/lib/browser/chunk-ZBA6IH6L.mjs.map +7 -0
  34. package/dist/lib/browser/cli/index.mjs +90 -0
  35. package/dist/lib/browser/cli/index.mjs.map +7 -0
  36. package/dist/lib/browser/common/activation-events.mjs +24 -0
  37. package/dist/lib/browser/common/capabilities.mjs +46 -0
  38. package/dist/lib/browser/core/activation-event.mjs +20 -0
  39. package/dist/lib/browser/core/activation-event.mjs.map +7 -0
  40. package/dist/lib/browser/core/capability.mjs +30 -0
  41. package/dist/lib/browser/core/capability.mjs.map +7 -0
  42. package/dist/lib/browser/core/plugin-manager.mjs +15 -0
  43. package/dist/lib/browser/core/plugin-manager.mjs.map +7 -0
  44. package/dist/lib/browser/core/plugin.mjs +29 -0
  45. package/dist/lib/browser/core/plugin.mjs.map +7 -0
  46. package/dist/lib/browser/core/url-loader.mjs +16 -0
  47. package/dist/lib/browser/core/url-loader.mjs.map +7 -0
  48. package/dist/lib/browser/index.mjs +91 -156
  49. package/dist/lib/browser/index.mjs.map +4 -4
  50. package/dist/lib/browser/invoker-capability-35BJSGXJ.mjs +43 -0
  51. package/dist/lib/browser/invoker-capability-35BJSGXJ.mjs.map +7 -0
  52. package/dist/lib/browser/meta.json +1 -1
  53. package/dist/lib/browser/testing/index.mjs +248 -51
  54. package/dist/lib/browser/testing/index.mjs.map +4 -4
  55. package/dist/lib/browser/testing/react.mjs +78 -0
  56. package/dist/lib/browser/testing/react.mjs.map +7 -0
  57. package/dist/lib/browser/ui/index.mjs +46 -0
  58. package/dist/lib/browser/ui/index.mjs.map +7 -0
  59. package/dist/lib/node-esm/capability-IY3YIHIO.mjs +39 -0
  60. package/dist/lib/node-esm/capability-IY3YIHIO.mjs.map +7 -0
  61. package/dist/lib/node-esm/capability-RDCTCARS.mjs +36 -0
  62. package/dist/lib/node-esm/capability-RDCTCARS.mjs.map +7 -0
  63. package/dist/lib/node-esm/chunk-42KBWDE4.mjs +80 -0
  64. package/dist/lib/node-esm/chunk-42KBWDE4.mjs.map +7 -0
  65. package/dist/lib/node-esm/chunk-DAYWQOOQ.mjs +149 -0
  66. package/dist/lib/node-esm/chunk-DAYWQOOQ.mjs.map +7 -0
  67. package/dist/lib/node-esm/chunk-DER2JDBT.mjs +175 -0
  68. package/dist/lib/node-esm/chunk-DER2JDBT.mjs.map +7 -0
  69. package/dist/lib/node-esm/chunk-EL3R25OQ.mjs +2 -0
  70. package/dist/lib/node-esm/chunk-EL3R25OQ.mjs.map +7 -0
  71. package/dist/lib/node-esm/chunk-FKE4Z3D6.mjs +10 -0
  72. package/dist/lib/node-esm/chunk-FKE4Z3D6.mjs.map +7 -0
  73. package/dist/lib/node-esm/chunk-G3RTFSNG.mjs +81 -0
  74. package/dist/lib/node-esm/chunk-G3RTFSNG.mjs.map +7 -0
  75. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +11 -0
  76. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs.map +7 -0
  77. package/dist/lib/node-esm/chunk-JPWVIQ5I.mjs +595 -0
  78. package/dist/lib/node-esm/chunk-JPWVIQ5I.mjs.map +7 -0
  79. package/dist/lib/node-esm/chunk-LX6YJOSO.mjs +394 -0
  80. package/dist/lib/node-esm/chunk-LX6YJOSO.mjs.map +7 -0
  81. package/dist/lib/node-esm/chunk-URWHJQT2.mjs +168 -0
  82. package/dist/lib/node-esm/chunk-URWHJQT2.mjs.map +7 -0
  83. package/dist/lib/node-esm/chunk-VKHGNEDB.mjs +43 -0
  84. package/dist/lib/node-esm/chunk-VKHGNEDB.mjs.map +7 -0
  85. package/dist/lib/node-esm/chunk-W4K4RU4S.mjs +964 -0
  86. package/dist/lib/node-esm/chunk-W4K4RU4S.mjs.map +7 -0
  87. package/dist/lib/node-esm/chunk-WZCSOX5Q.mjs +35 -0
  88. package/dist/lib/node-esm/chunk-WZCSOX5Q.mjs.map +7 -0
  89. package/dist/lib/node-esm/chunk-ZZ7CKK6W.mjs +49 -0
  90. package/dist/lib/node-esm/chunk-ZZ7CKK6W.mjs.map +7 -0
  91. package/dist/lib/node-esm/cli/index.mjs +91 -0
  92. package/dist/lib/node-esm/cli/index.mjs.map +7 -0
  93. package/dist/lib/node-esm/common/activation-events.mjs +25 -0
  94. package/dist/lib/node-esm/common/activation-events.mjs.map +7 -0
  95. package/dist/lib/node-esm/common/capabilities.mjs +47 -0
  96. package/dist/lib/node-esm/common/capabilities.mjs.map +7 -0
  97. package/dist/lib/node-esm/core/activation-event.mjs +21 -0
  98. package/dist/lib/node-esm/core/activation-event.mjs.map +7 -0
  99. package/dist/lib/node-esm/core/capability.mjs +31 -0
  100. package/dist/lib/node-esm/core/capability.mjs.map +7 -0
  101. package/dist/lib/node-esm/core/plugin-manager.mjs +16 -0
  102. package/dist/lib/node-esm/core/plugin-manager.mjs.map +7 -0
  103. package/dist/lib/node-esm/core/plugin.mjs +30 -0
  104. package/dist/lib/node-esm/core/plugin.mjs.map +7 -0
  105. package/dist/lib/node-esm/core/url-loader.mjs +17 -0
  106. package/dist/lib/node-esm/core/url-loader.mjs.map +7 -0
  107. package/dist/lib/node-esm/index.mjs +91 -156
  108. package/dist/lib/node-esm/index.mjs.map +4 -4
  109. package/dist/lib/node-esm/invoker-capability-3QWBSM5Q.mjs +44 -0
  110. package/dist/lib/node-esm/invoker-capability-3QWBSM5Q.mjs.map +7 -0
  111. package/dist/lib/node-esm/meta.json +1 -1
  112. package/dist/lib/node-esm/testing/index.mjs +248 -51
  113. package/dist/lib/node-esm/testing/index.mjs.map +4 -4
  114. package/dist/lib/node-esm/testing/react.mjs +79 -0
  115. package/dist/lib/node-esm/testing/react.mjs.map +7 -0
  116. package/dist/lib/node-esm/ui/index.mjs +47 -0
  117. package/dist/lib/node-esm/ui/index.mjs.map +7 -0
  118. package/dist/plugin/node-esm/index.mjs +730 -0
  119. package/dist/plugin/node-esm/index.mjs.map +7 -0
  120. package/dist/plugin/node-esm/meta.json +1 -0
  121. package/dist/types/src/cli/cli.d.ts +39 -0
  122. package/dist/types/src/cli/cli.d.ts.map +1 -0
  123. package/dist/types/src/cli/index.d.ts +2 -0
  124. package/dist/types/src/cli/index.d.ts.map +1 -0
  125. package/dist/types/src/common/activation-events.d.ts +27 -0
  126. package/dist/types/src/common/activation-events.d.ts.map +1 -0
  127. package/dist/types/src/common/capabilities.d.ts +109 -121
  128. package/dist/types/src/common/capabilities.d.ts.map +1 -1
  129. package/dist/types/src/common/index.d.ts +4 -8
  130. package/dist/types/src/common/index.d.ts.map +1 -1
  131. package/dist/types/src/common/operations.d.ts +19 -0
  132. package/dist/types/src/common/operations.d.ts.map +1 -0
  133. package/dist/types/src/common/translations.d.ts +8 -8
  134. package/dist/types/src/common/translations.d.ts.map +1 -1
  135. package/dist/types/src/context.d.ts +5 -0
  136. package/dist/types/src/context.d.ts.map +1 -0
  137. package/dist/types/src/core/{events.d.ts → activation-event.d.ts} +7 -7
  138. package/dist/types/src/core/activation-event.d.ts.map +1 -0
  139. package/dist/types/src/core/capability-manager.d.ts +48 -0
  140. package/dist/types/src/core/capability-manager.d.ts.map +1 -0
  141. package/dist/types/src/core/capability-manager.test.d.ts +2 -0
  142. package/dist/types/src/core/capability-manager.test.d.ts.map +1 -0
  143. package/dist/types/src/core/capability.d.ts +156 -0
  144. package/dist/types/src/core/capability.d.ts.map +1 -0
  145. package/dist/types/src/core/index.d.ts +6 -4
  146. package/dist/types/src/core/index.d.ts.map +1 -1
  147. package/dist/types/src/core/plugin-manager.d.ts +73 -0
  148. package/dist/types/src/core/plugin-manager.d.ts.map +1 -0
  149. package/dist/types/src/core/plugin-manager.test.d.ts +2 -0
  150. package/dist/types/src/core/plugin-manager.test.d.ts.map +1 -0
  151. package/dist/types/src/core/plugin.d.ts +124 -37
  152. package/dist/types/src/core/plugin.d.ts.map +1 -1
  153. package/dist/types/src/core/url-loader.d.ts +42 -0
  154. package/dist/types/src/core/url-loader.d.ts.map +1 -0
  155. package/dist/types/src/core/url-loader.test.d.ts +2 -0
  156. package/dist/types/src/core/url-loader.test.d.ts.map +1 -0
  157. package/dist/types/src/index.d.ts +3 -4
  158. package/dist/types/src/index.d.ts.map +1 -1
  159. package/dist/types/src/plugin-operation/OperationPlugin.d.ts +3 -0
  160. package/dist/types/src/plugin-operation/OperationPlugin.d.ts.map +1 -0
  161. package/dist/types/src/plugin-operation/history/capability.d.ts +7 -0
  162. package/dist/types/src/plugin-operation/history/capability.d.ts.map +1 -0
  163. package/dist/types/src/plugin-operation/history/errors.d.ts +32 -0
  164. package/dist/types/src/plugin-operation/history/errors.d.ts.map +1 -0
  165. package/dist/types/src/plugin-operation/history/history-tracker.d.ts +18 -0
  166. package/dist/types/src/plugin-operation/history/history-tracker.d.ts.map +1 -0
  167. package/dist/types/src/plugin-operation/history/history-tracker.test.d.ts +2 -0
  168. package/dist/types/src/plugin-operation/history/history-tracker.test.d.ts.map +1 -0
  169. package/dist/types/src/plugin-operation/history/index.d.ts +6 -0
  170. package/dist/types/src/plugin-operation/history/index.d.ts.map +1 -0
  171. package/dist/types/src/plugin-operation/history/types.d.ts +13 -0
  172. package/dist/types/src/plugin-operation/history/types.d.ts.map +1 -0
  173. package/dist/types/src/plugin-operation/history/undo-mapping.d.ts +101 -0
  174. package/dist/types/src/plugin-operation/history/undo-mapping.d.ts.map +1 -0
  175. package/dist/types/src/plugin-operation/history/undo-registry.d.ts +23 -0
  176. package/dist/types/src/plugin-operation/history/undo-registry.d.ts.map +1 -0
  177. package/dist/types/src/plugin-operation/history/undo-registry.test.d.ts +2 -0
  178. package/dist/types/src/plugin-operation/history/undo-registry.test.d.ts.map +1 -0
  179. package/dist/types/src/plugin-operation/index.d.ts +3 -0
  180. package/dist/types/src/plugin-operation/index.d.ts.map +1 -0
  181. package/dist/types/src/plugin-operation/invoker-capability.d.ts +6 -0
  182. package/dist/types/src/plugin-operation/invoker-capability.d.ts.map +1 -0
  183. package/dist/types/src/plugin-operation/meta.d.ts +3 -0
  184. package/dist/types/src/plugin-operation/meta.d.ts.map +1 -0
  185. package/dist/types/src/plugin-operation/testing.d.ts +58 -0
  186. package/dist/types/src/plugin-operation/testing.d.ts.map +1 -0
  187. package/dist/types/src/plugin-runtime/RuntimePlugin.d.ts +3 -0
  188. package/dist/types/src/plugin-runtime/RuntimePlugin.d.ts.map +1 -0
  189. package/dist/types/src/plugin-runtime/capability.d.ts +6 -0
  190. package/dist/types/src/plugin-runtime/capability.d.ts.map +1 -0
  191. package/dist/types/src/plugin-runtime/index.d.ts +2 -0
  192. package/dist/types/src/plugin-runtime/index.d.ts.map +1 -0
  193. package/dist/types/src/plugin-runtime/meta.d.ts +3 -0
  194. package/dist/types/src/plugin-runtime/meta.d.ts.map +1 -0
  195. package/dist/types/src/testing/harness.d.ts +67 -0
  196. package/dist/types/src/testing/harness.d.ts.map +1 -0
  197. package/dist/types/src/testing/index.d.ts +2 -0
  198. package/dist/types/src/testing/index.d.ts.map +1 -1
  199. package/dist/types/src/testing/react.d.ts +27 -0
  200. package/dist/types/src/testing/react.d.ts.map +1 -0
  201. package/dist/types/src/testing/react.test.d.ts +2 -0
  202. package/dist/types/src/testing/react.test.d.ts.map +1 -0
  203. package/dist/types/src/testing/service.d.ts +8 -0
  204. package/dist/types/src/testing/service.d.ts.map +1 -0
  205. package/dist/types/src/testing/withPluginManager.d.ts +11 -10
  206. package/dist/types/src/testing/withPluginManager.d.ts.map +1 -1
  207. package/dist/types/src/testing/withPluginManager.stories.d.ts +9 -3
  208. package/dist/types/src/testing/withPluginManager.stories.d.ts.map +1 -1
  209. package/dist/types/src/ui/components/App/App.d.ts +9 -0
  210. package/dist/types/src/ui/components/App/App.d.ts.map +1 -0
  211. package/dist/types/src/ui/components/App/App.stories.d.ts +19 -0
  212. package/dist/types/src/ui/components/App/App.stories.d.ts.map +1 -0
  213. package/dist/types/src/ui/components/App/index.d.ts +2 -0
  214. package/dist/types/src/ui/components/App/index.d.ts.map +1 -0
  215. package/dist/types/src/ui/components/PluginManager/PluginManagerContext.stories.d.ts +13 -0
  216. package/dist/types/src/ui/components/PluginManager/PluginManagerContext.stories.d.ts.map +1 -0
  217. package/dist/types/src/ui/components/PluginManager/PluginManagerProvider.d.ts +10 -0
  218. package/dist/types/src/ui/components/PluginManager/PluginManagerProvider.d.ts.map +1 -0
  219. package/dist/types/src/ui/components/PluginManager/index.d.ts +2 -0
  220. package/dist/types/src/ui/components/PluginManager/index.d.ts.map +1 -0
  221. package/dist/types/src/ui/components/Surface/SurfaceComponent.d.ts +24 -0
  222. package/dist/types/src/ui/components/Surface/SurfaceComponent.d.ts.map +1 -0
  223. package/dist/types/src/ui/components/Surface/SurfaceComponent.stories.d.ts +14 -0
  224. package/dist/types/src/ui/components/Surface/SurfaceComponent.stories.d.ts.map +1 -0
  225. package/dist/types/src/ui/components/Surface/SurfaceInfo.d.ts +11 -0
  226. package/dist/types/src/ui/components/Surface/SurfaceInfo.d.ts.map +1 -0
  227. package/dist/types/src/ui/components/Surface/SurfaceProfilerContext.d.ts +48 -0
  228. package/dist/types/src/ui/components/Surface/SurfaceProfilerContext.d.ts.map +1 -0
  229. package/dist/types/src/ui/components/Surface/context.d.ts +5 -0
  230. package/dist/types/src/ui/components/Surface/context.d.ts.map +1 -0
  231. package/dist/types/src/ui/components/Surface/index.d.ts +36 -0
  232. package/dist/types/src/ui/components/Surface/index.d.ts.map +1 -0
  233. package/dist/types/src/ui/components/Surface/types.d.ts +197 -0
  234. package/dist/types/src/ui/components/Surface/types.d.ts.map +1 -0
  235. package/dist/types/src/ui/components/Surface/types.test.d.ts +2 -0
  236. package/dist/types/src/ui/components/Surface/types.test.d.ts.map +1 -0
  237. package/dist/types/src/ui/components/index.d.ts +4 -0
  238. package/dist/types/src/ui/components/index.d.ts.map +1 -0
  239. package/dist/types/src/ui/hooks/index.d.ts +6 -0
  240. package/dist/types/src/ui/hooks/index.d.ts.map +1 -0
  241. package/dist/types/src/ui/hooks/useApp.d.ts +62 -0
  242. package/dist/types/src/ui/hooks/useApp.d.ts.map +1 -0
  243. package/dist/types/src/ui/hooks/useApp.test.d.ts +2 -0
  244. package/dist/types/src/ui/hooks/useApp.test.d.ts.map +1 -0
  245. package/dist/types/src/ui/hooks/useCapabilities.d.ts +31 -0
  246. package/dist/types/src/ui/hooks/useCapabilities.d.ts.map +1 -0
  247. package/dist/types/src/ui/hooks/useLoading.d.ts +18 -0
  248. package/dist/types/src/ui/hooks/useLoading.d.ts.map +1 -0
  249. package/dist/types/src/ui/hooks/useSettingsState.d.ts +10 -0
  250. package/dist/types/src/ui/hooks/useSettingsState.d.ts.map +1 -0
  251. package/dist/types/src/ui/hooks/useSurface.d.ts +3 -0
  252. package/dist/types/src/ui/hooks/useSurface.d.ts.map +1 -0
  253. package/dist/types/src/ui/index.d.ts +3 -0
  254. package/dist/types/src/ui/index.d.ts.map +1 -0
  255. package/dist/types/src/vite-plugin/composer-plugin.d.ts +34 -0
  256. package/dist/types/src/vite-plugin/composer-plugin.d.ts.map +1 -0
  257. package/dist/types/src/vite-plugin/import-map-plugin.d.ts +16 -0
  258. package/dist/types/src/vite-plugin/import-map-plugin.d.ts.map +1 -0
  259. package/dist/types/src/vite-plugin/index.d.ts +4 -0
  260. package/dist/types/src/vite-plugin/index.d.ts.map +1 -0
  261. package/dist/types/src/vite-plugin/manifest.d.ts +16 -0
  262. package/dist/types/src/vite-plugin/manifest.d.ts.map +1 -0
  263. package/dist/types/src/vite-plugin/manifest.test.d.ts +2 -0
  264. package/dist/types/src/vite-plugin/manifest.test.d.ts.map +1 -0
  265. package/dist/types/src/vite-plugin/packages.d.ts +13 -0
  266. package/dist/types/src/vite-plugin/packages.d.ts.map +1 -0
  267. package/dist/types/tsconfig.tsbuildinfo +1 -1
  268. package/moon.yml +26 -3
  269. package/package.json +144 -44
  270. package/src/cli/cli.ts +107 -0
  271. package/src/{playground/layout → cli}/index.ts +1 -1
  272. package/src/common/activation-events.ts +44 -0
  273. package/src/common/capabilities.ts +168 -109
  274. package/src/common/index.ts +4 -8
  275. package/src/common/operations.ts +35 -0
  276. package/src/common/translations.ts +18 -10
  277. package/src/context.ts +9 -0
  278. package/src/core/{events.ts → activation-event.ts} +10 -7
  279. package/src/core/capability-manager.test.ts +151 -0
  280. package/src/core/capability-manager.ts +192 -0
  281. package/src/core/capability.ts +247 -0
  282. package/src/core/index.ts +6 -4
  283. package/src/core/plugin-manager.test.ts +1113 -0
  284. package/src/core/plugin-manager.ts +883 -0
  285. package/src/core/plugin.ts +261 -43
  286. package/src/core/url-loader.test.ts +112 -0
  287. package/src/core/url-loader.ts +178 -0
  288. package/src/helpers.test.ts +1 -1
  289. package/src/index.ts +3 -4
  290. package/src/plugin-operation/OperationPlugin.ts +24 -0
  291. package/src/plugin-operation/history/capability.ts +36 -0
  292. package/src/plugin-operation/history/errors.ts +7 -0
  293. package/src/plugin-operation/history/history-tracker.test.ts +373 -0
  294. package/src/plugin-operation/history/history-tracker.ts +128 -0
  295. package/src/plugin-operation/history/index.ts +9 -0
  296. package/src/plugin-operation/history/types.ts +17 -0
  297. package/src/plugin-operation/history/undo-mapping.ts +135 -0
  298. package/src/plugin-operation/history/undo-registry.test.ts +72 -0
  299. package/src/plugin-operation/history/undo-registry.ts +54 -0
  300. package/src/plugin-operation/index.ts +6 -0
  301. package/src/plugin-operation/invoker-capability.ts +54 -0
  302. package/src/plugin-operation/meta.ts +11 -0
  303. package/src/plugin-operation/testing.ts +154 -0
  304. package/src/plugin-runtime/RuntimePlugin.ts +19 -0
  305. package/src/plugin-runtime/capability.ts +53 -0
  306. package/src/{playground/debug → plugin-runtime}/index.ts +1 -1
  307. package/src/plugin-runtime/meta.ts +11 -0
  308. package/src/testing/harness.ts +229 -0
  309. package/src/testing/index.ts +2 -0
  310. package/src/testing/react.test.tsx +48 -0
  311. package/src/testing/react.tsx +113 -0
  312. package/src/testing/service.ts +52 -0
  313. package/src/testing/withPluginManager.stories.tsx +14 -11
  314. package/src/testing/withPluginManager.tsx +78 -54
  315. package/src/ui/components/App/App.stories.tsx +92 -0
  316. package/src/ui/components/App/App.tsx +58 -0
  317. package/src/{playground/logger → ui/components/App}/index.ts +1 -1
  318. package/src/ui/components/PluginManager/PluginManagerContext.stories.tsx +183 -0
  319. package/src/{react → ui/components/PluginManager}/PluginManagerProvider.ts +3 -3
  320. package/src/ui/components/PluginManager/index.ts +5 -0
  321. package/src/ui/components/Surface/SurfaceComponent.stories.tsx +144 -0
  322. package/src/ui/components/Surface/SurfaceComponent.tsx +303 -0
  323. package/src/ui/components/Surface/SurfaceInfo.tsx +107 -0
  324. package/src/ui/components/Surface/SurfaceProfilerContext.tsx +207 -0
  325. package/src/ui/components/Surface/context.ts +12 -0
  326. package/src/ui/components/Surface/index.ts +54 -0
  327. package/src/ui/components/Surface/types.test.ts +126 -0
  328. package/src/ui/components/Surface/types.ts +269 -0
  329. package/src/ui/components/index.ts +7 -0
  330. package/src/ui/hooks/index.ts +9 -0
  331. package/src/ui/hooks/useApp.test.tsx +159 -0
  332. package/src/ui/hooks/useApp.tsx +289 -0
  333. package/src/ui/hooks/useCapabilities.ts +67 -0
  334. package/src/ui/hooks/useLoading.tsx +68 -0
  335. package/src/ui/hooks/useSettingsState.ts +26 -0
  336. package/src/ui/hooks/useSurface.ts +13 -0
  337. package/src/ui/index.ts +6 -0
  338. package/src/vite-plugin/composer-plugin.ts +284 -0
  339. package/src/vite-plugin/import-map-plugin.ts +490 -0
  340. package/src/vite-plugin/index.ts +7 -0
  341. package/src/vite-plugin/manifest.test.ts +23 -0
  342. package/src/vite-plugin/manifest.ts +20 -0
  343. package/src/vite-plugin/packages.ts +181 -0
  344. package/tsconfig.json +15 -25
  345. package/tsconfig.node.json +2 -4
  346. package/typedoc.json +2 -4
  347. package/vitest.config.ts +8 -6
  348. package/.eslintrc.cjs +0 -9
  349. package/.swc/plugins/v7_linux_x86_64_13.0.0/f45bdff002284d9e8f9ef3f0be909de12da36c049cbcf261ac78fc00abb09a2d +0 -0
  350. package/.swc/plugins/v7_linux_x86_64_13.0.0/fce1bdb8e20a094e4af08bad09cc81497ed0e2e7c51223b07d371063cca18429 +0 -0
  351. package/dist/lib/browser/app-graph-builder-BGGXLD6T.mjs +0 -137
  352. package/dist/lib/browser/app-graph-builder-BGGXLD6T.mjs.map +0 -7
  353. package/dist/lib/browser/chunk-2636QSIK.mjs +0 -1518
  354. package/dist/lib/browser/chunk-2636QSIK.mjs.map +0 -7
  355. package/dist/lib/browser/chunk-DHZB7HG7.mjs +0 -413
  356. package/dist/lib/browser/chunk-DHZB7HG7.mjs.map +0 -7
  357. package/dist/lib/browser/chunk-ORWHM7CO.mjs +0 -32
  358. package/dist/lib/browser/chunk-ORWHM7CO.mjs.map +0 -7
  359. package/dist/lib/browser/intent-dispatcher-TWKB22NI.mjs +0 -11
  360. package/dist/lib/browser/intent-resolver-O67UANYP.mjs +0 -39
  361. package/dist/lib/browser/intent-resolver-O67UANYP.mjs.map +0 -7
  362. package/dist/lib/browser/store-LFKDWHUQ.mjs +0 -30
  363. package/dist/lib/browser/store-LFKDWHUQ.mjs.map +0 -7
  364. package/dist/lib/browser/worker.mjs +0 -79
  365. package/dist/lib/node-esm/app-graph-builder-QHIJUYYW.mjs +0 -138
  366. package/dist/lib/node-esm/app-graph-builder-QHIJUYYW.mjs.map +0 -7
  367. package/dist/lib/node-esm/chunk-NJAFK626.mjs +0 -414
  368. package/dist/lib/node-esm/chunk-NJAFK626.mjs.map +0 -7
  369. package/dist/lib/node-esm/chunk-UMZQERLE.mjs +0 -34
  370. package/dist/lib/node-esm/chunk-UMZQERLE.mjs.map +0 -7
  371. package/dist/lib/node-esm/chunk-VSKRV3NW.mjs +0 -1520
  372. package/dist/lib/node-esm/chunk-VSKRV3NW.mjs.map +0 -7
  373. package/dist/lib/node-esm/intent-dispatcher-5PRM3KGH.mjs +0 -12
  374. package/dist/lib/node-esm/intent-resolver-K3D4BXQQ.mjs +0 -40
  375. package/dist/lib/node-esm/intent-resolver-K3D4BXQQ.mjs.map +0 -7
  376. package/dist/lib/node-esm/store-53XDUBMD.mjs +0 -31
  377. package/dist/lib/node-esm/store-53XDUBMD.mjs.map +0 -7
  378. package/dist/lib/node-esm/worker.mjs +0 -80
  379. package/dist/types/src/App.d.ts +0 -43
  380. package/dist/types/src/App.d.ts.map +0 -1
  381. package/dist/types/src/common/collaboration.d.ts +0 -19
  382. package/dist/types/src/common/collaboration.d.ts.map +0 -1
  383. package/dist/types/src/common/events.d.ts +0 -52
  384. package/dist/types/src/common/events.d.ts.map +0 -1
  385. package/dist/types/src/common/file.d.ts +0 -14
  386. package/dist/types/src/common/file.d.ts.map +0 -1
  387. package/dist/types/src/common/graph.d.ts +0 -21
  388. package/dist/types/src/common/graph.d.ts.map +0 -1
  389. package/dist/types/src/common/layout.d.ts +0 -281
  390. package/dist/types/src/common/layout.d.ts.map +0 -1
  391. package/dist/types/src/common/surface.d.ts +0 -65
  392. package/dist/types/src/common/surface.d.ts.map +0 -1
  393. package/dist/types/src/core/capabilities.d.ts +0 -114
  394. package/dist/types/src/core/capabilities.d.ts.map +0 -1
  395. package/dist/types/src/core/capabilities.test.d.ts +0 -2
  396. package/dist/types/src/core/capabilities.test.d.ts.map +0 -1
  397. package/dist/types/src/core/events.d.ts.map +0 -1
  398. package/dist/types/src/core/manager.d.ts +0 -122
  399. package/dist/types/src/core/manager.d.ts.map +0 -1
  400. package/dist/types/src/core/manager.test.d.ts +0 -2
  401. package/dist/types/src/core/manager.test.d.ts.map +0 -1
  402. package/dist/types/src/playground/debug/Debug.d.ts +0 -6
  403. package/dist/types/src/playground/debug/Debug.d.ts.map +0 -1
  404. package/dist/types/src/playground/debug/index.d.ts +0 -2
  405. package/dist/types/src/playground/debug/index.d.ts.map +0 -1
  406. package/dist/types/src/playground/debug/plugin.d.ts +0 -2
  407. package/dist/types/src/playground/debug/plugin.d.ts.map +0 -1
  408. package/dist/types/src/playground/generator/Main.d.ts +0 -6
  409. package/dist/types/src/playground/generator/Main.d.ts.map +0 -1
  410. package/dist/types/src/playground/generator/Toolbar.d.ts +0 -6
  411. package/dist/types/src/playground/generator/Toolbar.d.ts.map +0 -1
  412. package/dist/types/src/playground/generator/generator.d.ts +0 -7
  413. package/dist/types/src/playground/generator/generator.d.ts.map +0 -1
  414. package/dist/types/src/playground/generator/index.d.ts +0 -3
  415. package/dist/types/src/playground/generator/index.d.ts.map +0 -1
  416. package/dist/types/src/playground/generator/plugin.d.ts +0 -2
  417. package/dist/types/src/playground/generator/plugin.d.ts.map +0 -1
  418. package/dist/types/src/playground/layout/Layout.d.ts +0 -8
  419. package/dist/types/src/playground/layout/Layout.d.ts.map +0 -1
  420. package/dist/types/src/playground/layout/index.d.ts +0 -2
  421. package/dist/types/src/playground/layout/index.d.ts.map +0 -1
  422. package/dist/types/src/playground/layout/plugin.d.ts +0 -2
  423. package/dist/types/src/playground/layout/plugin.d.ts.map +0 -1
  424. package/dist/types/src/playground/logger/Toolbar.d.ts +0 -6
  425. package/dist/types/src/playground/logger/Toolbar.d.ts.map +0 -1
  426. package/dist/types/src/playground/logger/index.d.ts +0 -2
  427. package/dist/types/src/playground/logger/index.d.ts.map +0 -1
  428. package/dist/types/src/playground/logger/plugin.d.ts +0 -2
  429. package/dist/types/src/playground/logger/plugin.d.ts.map +0 -1
  430. package/dist/types/src/playground/logger/schema.d.ts +0 -13
  431. package/dist/types/src/playground/logger/schema.d.ts.map +0 -1
  432. package/dist/types/src/playground/playground.stories.d.ts +0 -10
  433. package/dist/types/src/playground/playground.stories.d.ts.map +0 -1
  434. package/dist/types/src/plugin-intent/IntentPlugin.d.ts +0 -2
  435. package/dist/types/src/plugin-intent/IntentPlugin.d.ts.map +0 -1
  436. package/dist/types/src/plugin-intent/actions.d.ts +0 -38
  437. package/dist/types/src/plugin-intent/actions.d.ts.map +0 -1
  438. package/dist/types/src/plugin-intent/errors.d.ts +0 -16
  439. package/dist/types/src/plugin-intent/errors.d.ts.map +0 -1
  440. package/dist/types/src/plugin-intent/index.d.ts +0 -5
  441. package/dist/types/src/plugin-intent/index.d.ts.map +0 -1
  442. package/dist/types/src/plugin-intent/intent-dispatcher.d.ts +0 -139
  443. package/dist/types/src/plugin-intent/intent-dispatcher.d.ts.map +0 -1
  444. package/dist/types/src/plugin-intent/intent-dispatcher.test.d.ts +0 -2
  445. package/dist/types/src/plugin-intent/intent-dispatcher.test.d.ts.map +0 -1
  446. package/dist/types/src/plugin-intent/intent.d.ts +0 -63
  447. package/dist/types/src/plugin-intent/intent.d.ts.map +0 -1
  448. package/dist/types/src/plugin-settings/SettingsPlugin.d.ts +0 -2
  449. package/dist/types/src/plugin-settings/SettingsPlugin.d.ts.map +0 -1
  450. package/dist/types/src/plugin-settings/actions.d.ts +0 -27
  451. package/dist/types/src/plugin-settings/actions.d.ts.map +0 -1
  452. package/dist/types/src/plugin-settings/app-graph-builder.d.ts +0 -4
  453. package/dist/types/src/plugin-settings/app-graph-builder.d.ts.map +0 -1
  454. package/dist/types/src/plugin-settings/index.d.ts +0 -3
  455. package/dist/types/src/plugin-settings/index.d.ts.map +0 -1
  456. package/dist/types/src/plugin-settings/intent-resolver.d.ts +0 -4
  457. package/dist/types/src/plugin-settings/intent-resolver.d.ts.map +0 -1
  458. package/dist/types/src/plugin-settings/store.d.ts +0 -5
  459. package/dist/types/src/plugin-settings/store.d.ts.map +0 -1
  460. package/dist/types/src/plugin-settings/translations.d.ts +0 -10
  461. package/dist/types/src/plugin-settings/translations.d.ts.map +0 -1
  462. package/dist/types/src/react/ErrorBoundary.d.ts +0 -31
  463. package/dist/types/src/react/ErrorBoundary.d.ts.map +0 -1
  464. package/dist/types/src/react/IntentContext.d.ts +0 -8
  465. package/dist/types/src/react/IntentContext.d.ts.map +0 -1
  466. package/dist/types/src/react/PluginManagerProvider.d.ts +0 -10
  467. package/dist/types/src/react/PluginManagerProvider.d.ts.map +0 -1
  468. package/dist/types/src/react/Surface.d.ts +0 -12
  469. package/dist/types/src/react/Surface.d.ts.map +0 -1
  470. package/dist/types/src/react/Surface.stories.d.ts +0 -16
  471. package/dist/types/src/react/Surface.stories.d.ts.map +0 -1
  472. package/dist/types/src/react/common.d.ts +0 -13
  473. package/dist/types/src/react/common.d.ts.map +0 -1
  474. package/dist/types/src/react/index.d.ts +0 -7
  475. package/dist/types/src/react/index.d.ts.map +0 -1
  476. package/dist/types/src/react/useCapabilities.d.ts +0 -13
  477. package/dist/types/src/react/useCapabilities.d.ts.map +0 -1
  478. package/dist/types/src/react/useIntentResolver.d.ts +0 -3
  479. package/dist/types/src/react/useIntentResolver.d.ts.map +0 -1
  480. package/dist/types/src/worker.d.ts +0 -4
  481. package/dist/types/src/worker.d.ts.map +0 -1
  482. package/src/App.tsx +0 -276
  483. package/src/common/collaboration.ts +0 -21
  484. package/src/common/events.ts +0 -77
  485. package/src/common/file.ts +0 -22
  486. package/src/common/graph.ts +0 -30
  487. package/src/common/layout.ts +0 -278
  488. package/src/common/surface.ts +0 -86
  489. package/src/core/capabilities.test.ts +0 -136
  490. package/src/core/capabilities.ts +0 -254
  491. package/src/core/manager.test.ts +0 -515
  492. package/src/core/manager.ts +0 -519
  493. package/src/playground/debug/Debug.tsx +0 -39
  494. package/src/playground/debug/plugin.ts +0 -17
  495. package/src/playground/generator/Main.tsx +0 -71
  496. package/src/playground/generator/Toolbar.tsx +0 -46
  497. package/src/playground/generator/generator.ts +0 -48
  498. package/src/playground/generator/index.ts +0 -6
  499. package/src/playground/generator/plugin.ts +0 -23
  500. package/src/playground/layout/Layout.tsx +0 -33
  501. package/src/playground/layout/plugin.ts +0 -17
  502. package/src/playground/logger/Toolbar.tsx +0 -29
  503. package/src/playground/logger/plugin.ts +0 -36
  504. package/src/playground/logger/schema.ts +0 -12
  505. package/src/playground/playground.stories.tsx +0 -42
  506. package/src/plugin-intent/IntentPlugin.ts +0 -20
  507. package/src/plugin-intent/actions.ts +0 -33
  508. package/src/plugin-intent/errors.ts +0 -39
  509. package/src/plugin-intent/index.ts +0 -8
  510. package/src/plugin-intent/intent-dispatcher.test.ts +0 -279
  511. package/src/plugin-intent/intent-dispatcher.ts +0 -333
  512. package/src/plugin-intent/intent.ts +0 -154
  513. package/src/plugin-settings/SettingsPlugin.ts +0 -35
  514. package/src/plugin-settings/actions.ts +0 -29
  515. package/src/plugin-settings/app-graph-builder.ts +0 -157
  516. package/src/plugin-settings/index.ts +0 -6
  517. package/src/plugin-settings/intent-resolver.ts +0 -34
  518. package/src/plugin-settings/store.ts +0 -33
  519. package/src/plugin-settings/translations.ts +0 -19
  520. package/src/react/ErrorBoundary.tsx +0 -45
  521. package/src/react/IntentContext.tsx +0 -34
  522. package/src/react/Surface.stories.tsx +0 -96
  523. package/src/react/Surface.tsx +0 -77
  524. package/src/react/common.ts +0 -12
  525. package/src/react/index.ts +0 -10
  526. package/src/react/useCapabilities.ts +0 -30
  527. package/src/react/useIntentResolver.ts +0 -22
  528. package/src/worker.ts +0 -11
  529. package/typedoc/.nojekyll +0 -1
  530. package/typedoc/assets/hierarchy.js +0 -1
  531. package/typedoc/assets/highlight.css +0 -106
  532. package/typedoc/assets/icons.js +0 -18
  533. package/typedoc/assets/icons.svg +0 -1
  534. package/typedoc/assets/main.js +0 -60
  535. package/typedoc/assets/navigation.js +0 -1
  536. package/typedoc/assets/search.js +0 -1
  537. package/typedoc/assets/style.css +0 -1640
  538. package/typedoc/classes/CollaborationActions.InsertContent.html +0 -421
  539. package/typedoc/classes/ErrorBoundary.html +0 -125
  540. package/typedoc/classes/IntentAction.ShowUndo.html +0 -227
  541. package/typedoc/classes/IntentAction.Track.html +0 -266
  542. package/typedoc/classes/LayoutAction.AddToast.html +0 -265
  543. package/typedoc/classes/LayoutAction.Close.html +0 -382
  544. package/typedoc/classes/LayoutAction.Expose.html +0 -265
  545. package/typedoc/classes/LayoutAction.Open.html +0 -1123
  546. package/typedoc/classes/LayoutAction.RevertWorkspace.html +0 -343
  547. package/typedoc/classes/LayoutAction.ScrollIntoView.html +0 -460
  548. package/typedoc/classes/LayoutAction.Set.html +0 -460
  549. package/typedoc/classes/LayoutAction.SetLayoutMode.html +0 -499
  550. package/typedoc/classes/LayoutAction.SwitchWorkspace.html +0 -265
  551. package/typedoc/classes/LayoutAction.UpdateComplementary.html +0 -616
  552. package/typedoc/classes/LayoutAction.UpdateDialog.html +0 -1123
  553. package/typedoc/classes/LayoutAction.UpdateLayout.html +0 -461
  554. package/typedoc/classes/LayoutAction.UpdatePopover.html +0 -1435
  555. package/typedoc/classes/LayoutAction.UpdateSidebar.html +0 -616
  556. package/typedoc/classes/Plugin.html +0 -6
  557. package/typedoc/classes/PluginContext.html +0 -38
  558. package/typedoc/classes/PluginManager.html +0 -43
  559. package/typedoc/classes/PluginModule.html +0 -18
  560. package/typedoc/classes/SettingsAction.Open.html +0 -226
  561. package/typedoc/classes/SettingsAction.OpenPluginRegistry.html +0 -265
  562. package/typedoc/functions/Events.createStateEvent.html +0 -2
  563. package/typedoc/functions/IntentPlugin.html +0 -1
  564. package/typedoc/functions/SettingsPlugin.html +0 -1
  565. package/typedoc/functions/allOf.html +0 -2
  566. package/typedoc/functions/chain.html +0 -3
  567. package/typedoc/functions/contributes.html +0 -2
  568. package/typedoc/functions/createDispatcher.html +0 -3
  569. package/typedoc/functions/createIntent.html +0 -6
  570. package/typedoc/functions/createResolver.html +0 -2
  571. package/typedoc/functions/createSurface.html +0 -2
  572. package/typedoc/functions/defineCapability.html +0 -2
  573. package/typedoc/functions/defineEvent.html +0 -2
  574. package/typedoc/functions/defineModule.html +0 -2
  575. package/typedoc/functions/definePlugin.html +0 -2
  576. package/typedoc/functions/eventKey.html +0 -2
  577. package/typedoc/functions/getEvents.html +0 -2
  578. package/typedoc/functions/isAllOf.html +0 -2
  579. package/typedoc/functions/isOneOf.html +0 -2
  580. package/typedoc/functions/isSurfaceAvailable.html +0 -2
  581. package/typedoc/functions/lazy.html +0 -2
  582. package/typedoc/functions/oneOf.html +0 -2
  583. package/typedoc/functions/useApp.html +0 -6
  584. package/typedoc/functions/useAppGraph.html +0 -1
  585. package/typedoc/functions/useCapabilities.html +0 -3
  586. package/typedoc/functions/useCapability.html +0 -4
  587. package/typedoc/functions/useIntentDispatcher.html +0 -1
  588. package/typedoc/functions/useIntentResolver.html +0 -1
  589. package/typedoc/functions/useLayout.html +0 -1
  590. package/typedoc/functions/usePluginManager.html +0 -2
  591. package/typedoc/hierarchy.html +0 -1
  592. package/typedoc/index.html +0 -12
  593. package/typedoc/interfaces/LayoutAction.Toast.html +0 -10
  594. package/typedoc/media/LICENSE +0 -8
  595. package/typedoc/modules/Capabilities.html +0 -1
  596. package/typedoc/modules/CollaborationActions.html +0 -1
  597. package/typedoc/modules/Events.html +0 -1
  598. package/typedoc/modules/IntentAction.html +0 -1
  599. package/typedoc/modules/LayoutAction.html +0 -2
  600. package/typedoc/modules/SettingsAction.html +0 -1
  601. package/typedoc/modules.html +0 -1
  602. package/typedoc/types/ActivationEvent.html +0 -8
  603. package/typedoc/types/ActivationEvents.html +0 -2
  604. package/typedoc/types/AnyCapability.html +0 -1
  605. package/typedoc/types/AnyIntent.html +0 -1
  606. package/typedoc/types/AnyIntentChain.html +0 -1
  607. package/typedoc/types/AnyIntentEffectResult.html +0 -1
  608. package/typedoc/types/AnyIntentResolver.html +0 -1
  609. package/typedoc/types/AnyIntentResult.html +0 -1
  610. package/typedoc/types/Capabilities.FileUploader.html +0 -1
  611. package/typedoc/types/Capabilities.IntentResolver.html +0 -1
  612. package/typedoc/types/Capabilities.Layout.html +0 -1
  613. package/typedoc/types/Capabilities.Metadata.html +0 -1
  614. package/typedoc/types/Capabilities.ReactContext.html +0 -1
  615. package/typedoc/types/Capabilities.ReactRoot.html +0 -1
  616. package/typedoc/types/Capabilities.ReactSurface.html +0 -1
  617. package/typedoc/types/Capabilities.Settings.html +0 -4
  618. package/typedoc/types/Capability.html +0 -9
  619. package/typedoc/types/CreateAppOptions.html +0 -10
  620. package/typedoc/types/FileInfo.html +0 -1
  621. package/typedoc/types/Intent.html +0 -10
  622. package/typedoc/types/IntentChain.html +0 -6
  623. package/typedoc/types/IntentContext.html +0 -5
  624. package/typedoc/types/IntentData.html +0 -1
  625. package/typedoc/types/IntentDispatcher.html +0 -2
  626. package/typedoc/types/IntentDispatcherResult.html +0 -2
  627. package/typedoc/types/IntentEffectDefinition.html +0 -2
  628. package/typedoc/types/IntentEffectResult.html +0 -15
  629. package/typedoc/types/IntentParams.html +0 -3
  630. package/typedoc/types/IntentResolver.html +0 -2
  631. package/typedoc/types/IntentResultData.html +0 -1
  632. package/typedoc/types/IntentSchema.html +0 -1
  633. package/typedoc/types/IntentUndo.html +0 -2
  634. package/typedoc/types/InterfaceDef.html +0 -4
  635. package/typedoc/types/Label.html +0 -1
  636. package/typedoc/types/NodeSerializer.html +0 -8
  637. package/typedoc/types/PluginManagerOptions.html +0 -6
  638. package/typedoc/types/PluginMeta.html +0 -21
  639. package/typedoc/types/PromiseIntentDispatcher.html +0 -2
  640. package/typedoc/types/PromiseIntentUndo.html +0 -2
  641. package/typedoc/types/Resource.html +0 -1
  642. package/typedoc/types/ResourceKey.html +0 -1
  643. package/typedoc/types/ResourceLanguage.html +0 -1
  644. package/typedoc/types/SerializedNode.html +0 -4
  645. package/typedoc/types/SurfaceComponent.html +0 -2
  646. package/typedoc/types/SurfaceDefinition.html +0 -2
  647. package/typedoc/types/SurfaceProps.html +0 -4
  648. package/typedoc/variables/Capabilities.AnchorSort.html +0 -1
  649. package/typedoc/variables/Capabilities.AppGraph.html +0 -1
  650. package/typedoc/variables/Capabilities.AppGraphBuilder.html +0 -1
  651. package/typedoc/variables/Capabilities.AppGraphSerializer.html +0 -1
  652. package/typedoc/variables/Capabilities.ArtifactDefinition.html +0 -1
  653. package/typedoc/variables/Capabilities.FileUploader.html +0 -1
  654. package/typedoc/variables/Capabilities.IntentDispatcher.html +0 -1
  655. package/typedoc/variables/Capabilities.IntentResolver.html +0 -1
  656. package/typedoc/variables/Capabilities.Layout.html +0 -1
  657. package/typedoc/variables/Capabilities.Metadata.html +0 -1
  658. package/typedoc/variables/Capabilities.Null.html +0 -1
  659. package/typedoc/variables/Capabilities.PluginManager.html +0 -1
  660. package/typedoc/variables/Capabilities.ReactContext.html +0 -1
  661. package/typedoc/variables/Capabilities.ReactRoot.html +0 -1
  662. package/typedoc/variables/Capabilities.ReactSurface.html +0 -1
  663. package/typedoc/variables/Capabilities.RxRegistry.html +0 -1
  664. package/typedoc/variables/Capabilities.Settings.html +0 -1
  665. package/typedoc/variables/Capabilities.SettingsStore.html +0 -1
  666. package/typedoc/variables/Capabilities.Tools.html +0 -1
  667. package/typedoc/variables/Capabilities.Translations.html +0 -1
  668. package/typedoc/variables/Events.AppGraphReady.html +0 -2
  669. package/typedoc/variables/Events.DispatcherReady.html +0 -2
  670. package/typedoc/variables/Events.LayoutReady.html +0 -1
  671. package/typedoc/variables/Events.SettingsReady.html +0 -2
  672. package/typedoc/variables/Events.SetupAppGraph.html +0 -2
  673. package/typedoc/variables/Events.SetupArtifactDefinition.html +0 -2
  674. package/typedoc/variables/Events.SetupIntentResolver.html +0 -2
  675. package/typedoc/variables/Events.SetupMetadata.html +0 -2
  676. package/typedoc/variables/Events.SetupReactSurface.html +0 -2
  677. package/typedoc/variables/Events.SetupSettings.html +0 -2
  678. package/typedoc/variables/Events.SetupTranslations.html +0 -2
  679. package/typedoc/variables/Events.Startup.html +0 -2
  680. package/typedoc/variables/FileInfoSchema.html +0 -1
  681. package/typedoc/variables/INTENT_ACTION.html +0 -1
  682. package/typedoc/variables/INTENT_PLUGIN.html +0 -1
  683. package/typedoc/variables/LAYOUT_ACTION.html +0 -1
  684. package/typedoc/variables/LAYOUT_PLUGIN.html +0 -1
  685. package/typedoc/variables/Label.html +0 -1
  686. package/typedoc/variables/LayoutAction.Toast.html +0 -1
  687. package/typedoc/variables/LayoutAction.UPDATE_LAYOUT.html +0 -1
  688. package/typedoc/variables/PluginManagerProvider.html +0 -2
  689. package/typedoc/variables/Resource.html +0 -2
  690. package/typedoc/variables/ResourceKey.html +0 -1
  691. package/typedoc/variables/ResourceLanguage.html +0 -1
  692. package/typedoc/variables/SETTINGS_ACTION.html +0 -1
  693. package/typedoc/variables/SETTINGS_ID.html +0 -1
  694. package/typedoc/variables/SETTINGS_KEY.html +0 -1
  695. package/typedoc/variables/SETTINGS_PLUGIN.html +0 -1
  696. package/typedoc/variables/Surface.html +0 -2
  697. package/typedoc/variables/defaultFileTypes.html +0 -1
  698. /package/dist/lib/browser/{intent-dispatcher-TWKB22NI.mjs.map → chunk-J5LGTIGS.mjs.map} +0 -0
  699. /package/dist/lib/browser/{worker.mjs.map → chunk-RFSO3JRG.mjs.map} +0 -0
  700. /package/dist/lib/{node-esm/intent-dispatcher-5PRM3KGH.mjs.map → browser/common/activation-events.mjs.map} +0 -0
  701. /package/dist/lib/{node-esm/worker.mjs.map → browser/common/capabilities.mjs.map} +0 -0
@@ -2,12 +2,82 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { type MaybePromise } from '@dxos/util';
5
+ import * as Context from 'effect/Context';
6
+ import * as Effect from 'effect/Effect';
7
+ import * as Option from 'effect/Option';
8
+ import * as Pipeable from 'effect/Pipeable';
6
9
 
7
- import { type AnyCapability, type PluginContext } from './capabilities';
8
- import { type ActivationEvent, type ActivationEvents } from './events';
10
+ import { invariant } from '@dxos/invariant';
9
11
 
10
- interface PluginModuleInterface {
12
+ import type * as ActivationEvent from './activation-event';
13
+ import * as Capability from './capability';
14
+ import type * as PluginManager from './plugin-manager';
15
+
16
+ //
17
+ // Plugin Service Layer
18
+ //
19
+
20
+ /**
21
+ * Effect Context.Tag for accessing PluginManager via the Effect layer system.
22
+ * This allows lifecycle operations to access the plugin manager without having it passed as an argument.
23
+ */
24
+ export class Service extends Context.Tag('@dxos/app-framework/PluginManager')<Service, PluginManager.PluginManager>() {}
25
+
26
+ //
27
+ // Lifecycle Functions
28
+ //
29
+
30
+ /**
31
+ * Activates plugins based on the activation event.
32
+ * Accesses the PluginManager via the Effect layer system.
33
+ * @param event The activation event.
34
+ * @returns Whether the activation was successful.
35
+ */
36
+ export const activate = (event: ActivationEvent.ActivationEvent): Effect.Effect<boolean, Error, Service> =>
37
+ Effect.flatMap(Service, (manager) => manager.activate(event));
38
+
39
+ /**
40
+ * Re-activates the modules that were activated by the event.
41
+ * Accesses the PluginManager via the Effect layer system.
42
+ * @param event The activation event.
43
+ * @returns Whether the reset was successful.
44
+ */
45
+ export const reset = (event: ActivationEvent.ActivationEvent): Effect.Effect<boolean, Error, Service> =>
46
+ Effect.flatMap(Service, (manager) => manager.reset(event));
47
+
48
+ /**
49
+ * Shuts down the plugin manager, deactivating all active modules and clearing lifecycle state.
50
+ * Accesses the PluginManager via the Effect layer system.
51
+ */
52
+ export const shutdown = (): Effect.Effect<boolean, Error, Service> =>
53
+ Effect.flatMap(Service, (manager) => manager.shutdown());
54
+
55
+ /**
56
+ * Computes a module ID from plugin ID and export name.
57
+ */
58
+ const computeModuleId = (pluginId: string, moduleName: string): string => {
59
+ return `${pluginId}.module.${moduleName}`;
60
+ };
61
+
62
+ /**
63
+ * Identifier denoting a PluginModule.
64
+ */
65
+ export const PluginModuleTypeId: unique symbol = Symbol.for('@dxos/app-framework/PluginModule');
66
+ export type PluginModuleTypeId = typeof PluginModuleTypeId;
67
+
68
+ /**
69
+ * Type guard to check if a value is a PluginModule.
70
+ */
71
+ export const isPluginModule = (value: unknown): value is PluginModule => {
72
+ return typeof value === 'object' && value !== null && PluginModuleTypeId in value;
73
+ };
74
+
75
+ /**
76
+ * A unit of containment of modular functionality that can be provided to an application.
77
+ * Activation of a module is async allowing for code to split and loaded lazily.
78
+ */
79
+ export interface PluginModule {
80
+ readonly [PluginModuleTypeId]: PluginModuleTypeId;
11
81
  /**
12
82
  * Unique id of the module.
13
83
  */
@@ -16,63 +86,73 @@ interface PluginModuleInterface {
16
86
  /**
17
87
  * Events for which the module will be activated.
18
88
  */
19
- activatesOn: ActivationEvents;
89
+ activatesOn: ActivationEvent.Events;
20
90
 
21
91
  /**
22
- * Events which the plugin depends on being activated.
23
- * Plugin is marked as needing reset a plugin activated by a dependent event is removed.
24
- * Events are automatically activated before activation of the plugin.
92
+ * Events that this module fires *before* its own activation runs.
93
+ *
94
+ * When this module is asked to activate (via {@link activatesOn}), the
95
+ * plugin manager first activates every event listed here, ensuring any
96
+ * other modules that contribute to those events have completed before
97
+ * this module's {@link activate} body executes. These events are fired
98
+ * by the framework on this module's behalf — the module does not need
99
+ * to wait for some other code to fire them.
100
+ *
101
+ * The module is marked as needing reset if a module activated by one
102
+ * of these events is later removed.
103
+ *
104
+ * Read as: "this module fires these events before [its] activation".
25
105
  */
26
- activatesBefore?: ActivationEvent[];
106
+ firesBeforeActivation?: ActivationEvent.ActivationEvent[];
27
107
 
28
108
  /**
29
- * Events which this plugin triggers upon activation.
109
+ * Events that this module fires *after* its own activation completes.
110
+ *
111
+ * Once this module's {@link activate} body has finished executing, the
112
+ * plugin manager activates every event listed here, causing any modules
113
+ * listening on those events to run. These events are fired by the
114
+ * framework on this module's behalf as part of this module's lifecycle.
115
+ *
116
+ * Read as: "this module fires these events after [its] activation".
30
117
  */
31
- activatesAfter?: ActivationEvent[];
118
+ firesAfterActivation?: ActivationEvent.ActivationEvent[];
32
119
 
33
120
  /**
34
121
  * Called when the module is activated.
35
- * @param context The plugin context.
122
+ * CapabilityManager is accessed via the Effect layer system (Capability.Service).
123
+ * PluginManager is accessed via Plugin.Service.
124
+ * @param props Optional props passed to the module.
36
125
  * @returns The capabilities of the module.
37
126
  */
38
- activate: (
39
- context: PluginContext,
40
- ) => MaybePromise<AnyCapability | AnyCapability[]> | Promise<() => Promise<AnyCapability | AnyCapability[]>>;
127
+ activate: (props?: any) => Effect.Effect<Capability.ModuleReturn, Error, Capability.Service | Service | never>;
41
128
  }
42
129
 
43
- /**
44
- * A unit of containment of modular functionality that can be provided to an application.
45
- * Activation of a module is async allowing for code to split and loaded lazily.
46
- */
47
- // NOTE: This is implemented as a class to prevent it from being proxied by PluginManager state.
48
- export class PluginModule implements PluginModuleInterface {
49
- readonly id: PluginModuleInterface['id'];
50
- readonly activatesOn: PluginModuleInterface['activatesOn'];
51
- readonly activatesBefore?: PluginModuleInterface['activatesBefore'];
52
- readonly activatesAfter?: PluginModuleInterface['activatesAfter'];
53
- readonly activate: PluginModuleInterface['activate'];
130
+ export type PluginModuleOptions = Omit<PluginModule, 'id' | typeof PluginModuleTypeId> & { id?: string };
54
131
 
55
- constructor(options: PluginModuleInterface) {
132
+ class PluginModuleImpl implements PluginModule {
133
+ readonly [PluginModuleTypeId]: PluginModuleTypeId = PluginModuleTypeId;
134
+ readonly id: PluginModule['id'];
135
+ readonly activatesOn: PluginModule['activatesOn'];
136
+ readonly firesBeforeActivation?: PluginModule['firesBeforeActivation'];
137
+ readonly firesAfterActivation?: PluginModule['firesAfterActivation'];
138
+ readonly activate: PluginModule['activate'];
139
+
140
+ constructor(options: Omit<PluginModule, typeof PluginModuleTypeId>) {
56
141
  this.id = options.id;
57
142
  this.activatesOn = options.activatesOn;
58
- this.activatesBefore = options.activatesBefore;
59
- this.activatesAfter = options.activatesAfter;
143
+ this.firesBeforeActivation = options.firesBeforeActivation;
144
+ this.firesAfterActivation = options.firesAfterActivation;
60
145
  this.activate = options.activate;
61
146
  }
62
147
  }
63
148
 
64
- /**
65
- * Helper to define a module.
66
- */
67
- export const defineModule = (options: PluginModuleInterface) => new PluginModule(options);
68
-
69
- export type PluginMeta = {
149
+ export type Meta = {
70
150
  /**
71
151
  * Globally unique ID.
72
152
  *
73
153
  * Expected to be in the form of a valid URL.
74
154
  *
75
- * @example dxos.org/plugin/example
155
+ * @example org.dxos.plugin.example
76
156
  */
77
157
  id: string;
78
158
 
@@ -110,23 +190,161 @@ export type PluginMeta = {
110
190
  * A grep-able symbol string which can be resolved to an icon asset by @ch-ui/icons, via @ch-ui/vite-plugin-icons.
111
191
  */
112
192
  icon?: string;
193
+
194
+ /**
195
+ * Icon hue (ChromaticPalette).
196
+ */
197
+ iconHue?: string;
198
+ };
199
+
200
+ /**
201
+ * Identifier denoting a Plugin.
202
+ */
203
+ export const PluginTypeId: unique symbol = Symbol.for('@dxos/app-framework/Plugin');
204
+ export type PluginTypeId = typeof PluginTypeId;
205
+
206
+ /**
207
+ * Type guard to check if a value is a Plugin.
208
+ */
209
+ export const isPlugin = (value: unknown): value is Plugin => {
210
+ return typeof value === 'object' && value !== null && PluginTypeId in value;
113
211
  };
114
212
 
115
213
  /**
116
214
  * A collection of modules that are be enabled/disabled as a unit.
117
215
  * Plugins provide things such as components, state, actions, etc. to the application.
118
216
  */
119
- // NOTE: This is implemented as a class to prevent it from being proxied by PluginManager state.
120
- export class Plugin {
217
+ // TODO(burdon): Convert to ECHO schema.
218
+ export interface Plugin {
219
+ readonly [PluginTypeId]: PluginTypeId;
220
+ readonly meta: Readonly<Meta>;
221
+ readonly modules: ReadonlyArray<PluginModule>;
222
+ }
223
+
224
+ /**
225
+ * Internal implementation of Plugin.
226
+ * @internal
227
+ */
228
+ class PluginImpl implements Plugin {
229
+ readonly [PluginTypeId]: PluginTypeId = PluginTypeId;
230
+
121
231
  constructor(
122
- readonly meta: PluginMeta,
123
- readonly modules: PluginModule[],
232
+ private readonly _meta: Meta,
233
+ private readonly _modules: PluginModule[],
124
234
  ) {}
235
+
236
+ get meta(): Readonly<Meta> {
237
+ return this._meta;
238
+ }
239
+
240
+ get modules(): ReadonlyArray<PluginModule> {
241
+ return this._modules;
242
+ }
243
+ }
244
+
245
+ /**
246
+ * Builder interface for creating plugins incrementally.
247
+ */
248
+ export interface PluginBuilder<T = void> extends Pipeable.Pipeable {
249
+ readonly meta: Meta;
250
+ readonly modules: ReadonlyArray<PluginModuleOptions | ((options: T) => PluginModuleOptions)>;
251
+ addModule(moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): PluginBuilder<T>;
252
+ }
253
+
254
+ /**
255
+ * Builder implementation for creating plugins incrementally.
256
+ */
257
+ class PluginBuilderImpl<T = void> implements PluginBuilder<T> {
258
+ readonly meta: Meta;
259
+ private readonly _modules: Array<PluginModuleOptions | ((options: T) => PluginModuleOptions)> = [];
260
+
261
+ constructor(meta: Meta) {
262
+ this.meta = meta;
263
+ }
264
+
265
+ get modules(): ReadonlyArray<PluginModuleOptions | ((options: T) => PluginModuleOptions)> {
266
+ return this._modules;
267
+ }
268
+
269
+ addModule(moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions)): PluginBuilder<T> {
270
+ this._modules.push(moduleOptions);
271
+ return this;
272
+ }
273
+
274
+ pipe() {
275
+ // eslint-disable-next-line prefer-rest-params
276
+ return Pipeable.pipeArguments(this, arguments);
277
+ }
278
+ }
279
+
280
+ /**
281
+ * Creates a new PluginBuilder to start building a plugin.
282
+ */
283
+ export const define = <T = void>(meta: Meta): PluginBuilder<T> => new PluginBuilderImpl<T>(meta);
284
+
285
+ /**
286
+ * Adds a module to a plugin builder.
287
+ * Supports both pipeline and direct call styles.
288
+ * Modules can be either PluginModuleOptions or functions that receive options.
289
+ */
290
+ export function addModule<T>(
291
+ moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions),
292
+ ): (builder: PluginBuilder<T>) => PluginBuilder<T>;
293
+ export function addModule<T>(
294
+ builder: PluginBuilder<T>,
295
+ moduleOptions: PluginModuleOptions | ((options: T) => PluginModuleOptions),
296
+ ): PluginBuilder<T>;
297
+ export function addModule<T>(
298
+ moduleOptionsOrBuilder: PluginModuleOptions | ((options: T) => PluginModuleOptions) | PluginBuilder<T>,
299
+ moduleOptions?: PluginModuleOptions | ((options: T) => PluginModuleOptions),
300
+ ): ((builder: PluginBuilder<T>) => PluginBuilder<T>) | PluginBuilder<T> {
301
+ // If second arg is provided, it's the direct call style: addModule(builder, moduleOptions)
302
+ if (moduleOptions !== undefined) {
303
+ return (moduleOptionsOrBuilder as PluginBuilder<T>).addModule(moduleOptions);
304
+ }
305
+ // Otherwise it's pipeline style: addModule(moduleOptions) returns a function
306
+ const moduleOpts = moduleOptionsOrBuilder as PluginModuleOptions | ((options: T) => PluginModuleOptions);
307
+ return (builder: PluginBuilder<T>) => builder.addModule(moduleOpts);
125
308
  }
126
309
 
310
+ export type PluginFactory<T = void> = ((options: T) => Plugin) & { meta: Meta };
311
+
127
312
  /**
128
- * Helper to define a plugin.
313
+ * Resolves a module from either PluginModuleOptions or a function that returns PluginModuleOptions.
129
314
  */
130
- export const definePlugin = (meta: PluginMeta, modules: PluginModule[]) => {
131
- return new Plugin(meta, modules);
315
+ const resolveModule = (
316
+ meta: Meta,
317
+ module: PluginModuleOptions | ((options: any) => PluginModuleOptions),
318
+ options?: any,
319
+ ): PluginModuleImpl => {
320
+ const moduleOptions = typeof module === 'function' ? module(options) : module;
321
+ const id = Option.fromNullable(moduleOptions.id).pipe(
322
+ Option.match({
323
+ onNone: () => {
324
+ const exportName = Capability.getModuleTag(moduleOptions.activate);
325
+ invariant(exportName, `Plugin module missing name. Plugin: ${meta.id}`);
326
+ return computeModuleId(meta.id, exportName);
327
+ },
328
+ onSome: (id) => computeModuleId(meta.id, id),
329
+ }),
330
+ );
331
+ return new PluginModuleImpl({ ...moduleOptions, id });
132
332
  };
333
+
334
+ /**
335
+ * Creates a Plugin from a builder.
336
+ * Supports both pipeline and direct call styles.
337
+ * Always returns a factory function (options: T) => Plugin.
338
+ * When T is void, the function takes no arguments: () => Plugin.
339
+ */
340
+ export function make<T>(builder: PluginBuilder<T>): PluginFactory<T>;
341
+ export function make<T>(builder: PluginBuilder<T>): PluginFactory<T> {
342
+ const meta = builder.meta;
343
+
344
+ const factory = (options: T) => {
345
+ const modules = builder.modules.map((module) => resolveModule(meta, module, options));
346
+ return new PluginImpl(meta, modules);
347
+ };
348
+
349
+ return Object.assign(factory, { meta });
350
+ }
@@ -0,0 +1,112 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ import { assert, describe, it } from '@effect/vitest';
6
+ import * as Effect from 'effect/Effect';
7
+
8
+ import * as Plugin from './plugin';
9
+ import * as UrlLoader from './url-loader';
10
+
11
+ const testMeta = { id: 'org.dxos.plugin.test', name: 'Test' };
12
+
13
+ describe('UrlLoader', () => {
14
+ describe('isLocalUrl', () => {
15
+ it('matches localhost, 127.0.0.1, and ::1', ({ expect }) => {
16
+ expect(UrlLoader.isLocalUrl('http://localhost:5173/plugin.mjs')).toBe(true);
17
+ expect(UrlLoader.isLocalUrl('https://LOCALHOST/plugin.mjs')).toBe(true);
18
+ expect(UrlLoader.isLocalUrl('http://127.0.0.1:8080/plugin.mjs')).toBe(true);
19
+ expect(UrlLoader.isLocalUrl('http://[::1]:8080/plugin.mjs')).toBe(true);
20
+ });
21
+
22
+ it('rejects public and malformed URLs', ({ expect }) => {
23
+ expect(UrlLoader.isLocalUrl('https://example.com/plugin.mjs')).toBe(false);
24
+ expect(UrlLoader.isLocalUrl('https://192.168.1.10/plugin.mjs')).toBe(false);
25
+ expect(UrlLoader.isLocalUrl('not a url')).toBe(false);
26
+ expect(UrlLoader.isLocalUrl('')).toBe(false);
27
+ });
28
+ });
29
+
30
+ describe('getRemoteEntries', () => {
31
+ it('returns persisted entries from storage', ({ expect }) => {
32
+ const storage: UrlLoader.Storage = {
33
+ get: () => '[{"id":"p1","url":"http://localhost:5173/p.mjs"}]',
34
+ set: () => {},
35
+ };
36
+ expect(UrlLoader.getRemoteEntries({ storage })).toEqual([{ id: 'p1', url: 'http://localhost:5173/p.mjs' }]);
37
+ });
38
+
39
+ it('returns an empty array when storage is empty or malformed', ({ expect }) => {
40
+ const empty: UrlLoader.Storage = { get: () => null, set: () => {} };
41
+ const malformed: UrlLoader.Storage = { get: () => '{not json', set: () => {} };
42
+ expect(UrlLoader.getRemoteEntries({ storage: empty })).toEqual([]);
43
+ expect(UrlLoader.getRemoteEntries({ storage: malformed })).toEqual([]);
44
+ });
45
+ });
46
+
47
+ describe('make', () => {
48
+ it.effect('resolves built-in plugins by meta.id', () =>
49
+ Effect.gen(function* () {
50
+ const testPlugin = Plugin.make(Plugin.define(testMeta))();
51
+ const loader = UrlLoader.make([testPlugin]);
52
+ const result = yield* loader(testMeta.id);
53
+ assert.strictEqual(result.meta.id, testMeta.id);
54
+ }),
55
+ );
56
+
57
+ it.effect('fails for unknown non-URL locator', () =>
58
+ Effect.gen(function* () {
59
+ const loader = UrlLoader.make([]);
60
+ const exit = yield* Effect.exit(loader('not-a-url'));
61
+ assert.isTrue(exit._tag === 'Failure');
62
+ }),
63
+ );
64
+ });
65
+
66
+ describe('preload', () => {
67
+ it('returns empty array when storage has no entries', async ({ expect }) => {
68
+ const storage: UrlLoader.Storage = {
69
+ get: () => null,
70
+ set: () => {},
71
+ };
72
+ const result = await UrlLoader.preload({ storage });
73
+ expect(result).toEqual([]);
74
+ });
75
+
76
+ it('returns empty array when storage has invalid JSON', async ({ expect }) => {
77
+ const storage: UrlLoader.Storage = {
78
+ get: () => '{{invalid json',
79
+ set: () => {},
80
+ };
81
+ const result = await UrlLoader.preload({ storage });
82
+ expect(result).toEqual([]);
83
+ });
84
+
85
+ it('returns empty array when storage contains null', async ({ expect }) => {
86
+ const storage: UrlLoader.Storage = {
87
+ get: () => 'null',
88
+ set: () => {},
89
+ };
90
+ const result = await UrlLoader.preload({ storage });
91
+ expect(result).toEqual([]);
92
+ });
93
+
94
+ it('returns empty array when storage contains an object', async ({ expect }) => {
95
+ const storage: UrlLoader.Storage = {
96
+ get: () => '{}',
97
+ set: () => {},
98
+ };
99
+ const result = await UrlLoader.preload({ storage });
100
+ expect(result).toEqual([]);
101
+ });
102
+
103
+ it('returns empty array when entries are missing required fields', async ({ expect }) => {
104
+ const storage: UrlLoader.Storage = {
105
+ get: () => '[{"title":"no url"}]',
106
+ set: () => {},
107
+ };
108
+ const result = await UrlLoader.preload({ storage });
109
+ expect(result).toEqual([]);
110
+ });
111
+ });
112
+ });
@@ -0,0 +1,178 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { log } from '@dxos/log';
8
+
9
+ import * as Plugin from './plugin';
10
+
11
+ const DEFAULT_KEY = 'org.dxos.composer.remote-plugins';
12
+
13
+ /**
14
+ * Abstraction over key-value storage (defaults to localStorage).
15
+ */
16
+ export type Storage = {
17
+ get(key: string): string | null;
18
+ set(key: string, value: string): void;
19
+ };
20
+
21
+ /**
22
+ * Options for configuring the URL loader.
23
+ */
24
+ export type Options = {
25
+ storage?: Storage;
26
+ key?: string;
27
+ };
28
+
29
+ /**
30
+ * Persisted record of a remote plugin that has been loaded previously.
31
+ */
32
+ export type RemotePluginEntry = {
33
+ id: string;
34
+ url: string;
35
+ };
36
+
37
+ const defaultStorage = (): Storage => ({
38
+ get: (key) => localStorage.getItem(key),
39
+ set: (key, value) => localStorage.setItem(key, value),
40
+ });
41
+
42
+ const getPersistedRemotePlugins = (storage: Storage, key: string): RemotePluginEntry[] => {
43
+ try {
44
+ const parsed: unknown = JSON.parse(storage.get(key) ?? '[]');
45
+ if (!Array.isArray(parsed)) {
46
+ return [];
47
+ }
48
+ return parsed.filter(
49
+ (entry): entry is RemotePluginEntry =>
50
+ typeof entry === 'object' && entry !== null && typeof entry.id === 'string' && typeof entry.url === 'string',
51
+ );
52
+ } catch {
53
+ return [];
54
+ }
55
+ };
56
+
57
+ const persistRemotePlugin = (storage: Storage, key: string, entry: RemotePluginEntry): void => {
58
+ try {
59
+ const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);
60
+ entries.push(entry);
61
+ storage.set(key, JSON.stringify(entries));
62
+ } catch (error) {
63
+ log.warn('failed to persist remote plugin entry', { entry, error });
64
+ }
65
+ };
66
+
67
+ const isUrl = (locator: string): boolean => {
68
+ try {
69
+ const url = new URL(locator);
70
+ return url.protocol === 'http:' || url.protocol === 'https:';
71
+ } catch {
72
+ return false;
73
+ }
74
+ };
75
+
76
+ /**
77
+ * Returns true when the URL's hostname is the local host (localhost, 127.0.0.1, or ::1).
78
+ */
79
+ export const isLocalUrl = (locator: string): boolean => {
80
+ try {
81
+ const hostname = new URL(locator).hostname.toLowerCase();
82
+ // WHATWG URL returns '::1' without brackets in Node; some browsers return '[::1]'.
83
+ return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1' || hostname === '[::1]';
84
+ } catch {
85
+ return false;
86
+ }
87
+ };
88
+
89
+ /**
90
+ * Returns the list of remote plugin entries previously persisted by {@link make}.
91
+ * Useful for UI code that needs to know which loaded plugins were installed from a URL
92
+ * (e.g. to surface a tag on remote or localhost-hosted plugins).
93
+ */
94
+ export const getRemoteEntries = (options: Options = {}): readonly RemotePluginEntry[] => {
95
+ const storage = options.storage ?? defaultStorage();
96
+ const key = options.key ?? DEFAULT_KEY;
97
+ return getPersistedRemotePlugins(storage, key);
98
+ };
99
+
100
+ const normalizePluginExport = (mod: Record<string, unknown>): Plugin.Plugin => {
101
+ const exported = mod.default;
102
+ if (Plugin.isPlugin(exported)) {
103
+ return exported;
104
+ }
105
+ if (typeof exported === 'function') {
106
+ const result = (exported as () => unknown)();
107
+ if (Plugin.isPlugin(result)) {
108
+ return result;
109
+ }
110
+ }
111
+ throw new Error('Remote module default export is not a Plugin or a zero-arg plugin factory.');
112
+ };
113
+
114
+ const loadRemotePlugin = async (url: string): Promise<Plugin.Plugin> => {
115
+ log.info('loading remote plugin', { url });
116
+ const mod = await import(/* @vite-ignore */ url);
117
+ const plugin = normalizePluginExport(mod);
118
+ if (!plugin.meta.id || !plugin.meta.name) {
119
+ throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);
120
+ }
121
+ return plugin;
122
+ };
123
+
124
+ /**
125
+ * Preloads previously persisted remote plugins from storage.
126
+ */
127
+ export const preload = async (options: Options = {}): Promise<Plugin.Plugin[]> => {
128
+ const storage = options.storage ?? defaultStorage();
129
+ const key = options.key ?? DEFAULT_KEY;
130
+
131
+ const entries = getPersistedRemotePlugins(storage, key);
132
+ if (entries.length === 0) {
133
+ return [];
134
+ }
135
+ log.info('preloading remote plugins', { count: entries.length });
136
+ const results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));
137
+ const plugins: Plugin.Plugin[] = [];
138
+ for (let index = 0; index < results.length; index++) {
139
+ const result = results[index];
140
+ if (result.status === 'fulfilled') {
141
+ plugins.push(result.value);
142
+ } else {
143
+ log.warn('failed to preload remote plugin', { entry: entries[index], error: result.reason });
144
+ }
145
+ }
146
+ return plugins;
147
+ };
148
+
149
+ /**
150
+ * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.
151
+ */
152
+ export const make = (builtinPlugins: Plugin.Plugin[], options: Options = {}) => {
153
+ const storage = options.storage ?? defaultStorage();
154
+ const key = options.key ?? DEFAULT_KEY;
155
+
156
+ return (locator: string): Effect.Effect<Plugin.Plugin, Error> =>
157
+ Effect.gen(function* () {
158
+ const builtin = builtinPlugins.find((plugin) => plugin.meta.id === locator);
159
+ if (builtin) {
160
+ return builtin;
161
+ }
162
+ if (!isUrl(locator)) {
163
+ return yield* Effect.fail(new Error(`Plugin not found and locator is not a URL: ${locator}`));
164
+ }
165
+ const plugin = yield* Effect.tryPromise({
166
+ try: () => loadRemotePlugin(locator),
167
+ catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`),
168
+ });
169
+ const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
170
+ if (duplicate) {
171
+ return yield* Effect.fail(
172
+ new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`),
173
+ );
174
+ }
175
+ persistRemotePlugin(storage, key, { id: plugin.meta.id, url: locator });
176
+ return plugin;
177
+ });
178
+ };
@@ -2,7 +2,7 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { describe, it, expect } from 'vitest';
5
+ import { describe, expect, it } from 'vitest';
6
6
 
7
7
  import { topologicalSort } from './helpers';
8
8
 
package/src/index.ts CHANGED
@@ -2,9 +2,8 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- export * from './App';
6
5
  export * from './common';
6
+ export * from './context';
7
7
  export * from './core';
8
- export * from './plugin-intent';
9
- export * from './plugin-settings';
10
- export * from './react';
8
+ export * from './plugin-operation';
9
+ export * from './plugin-runtime';