@dxos/plugin-deck 0.8.4-main.e8ec1fe → 0.8.4-main.effb148878

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 (502) hide show
  1. package/LICENSE +102 -5
  2. package/README.md +1 -1
  3. package/dist/lib/neutral/DeckLayout-NBVPPAQP.mjs +278 -0
  4. package/dist/lib/neutral/DeckLayout-NBVPPAQP.mjs.map +7 -0
  5. package/dist/lib/neutral/DeckPlugin.mjs +70 -0
  6. package/dist/lib/neutral/DeckPlugin.mjs.map +7 -0
  7. package/dist/lib/neutral/DeckPlugin.node.mjs +18 -0
  8. package/dist/lib/neutral/DeckPlugin.node.mjs.map +7 -0
  9. package/dist/lib/neutral/DeckPlugin.workerd.mjs +16 -0
  10. package/dist/lib/neutral/DeckPlugin.workerd.mjs.map +7 -0
  11. package/dist/lib/neutral/DeckSettings-W5I57OXM.mjs +27 -0
  12. package/dist/lib/neutral/DeckSettings-W5I57OXM.mjs.map +7 -0
  13. package/dist/lib/neutral/add-toast-H2PK2S3H.mjs +24 -0
  14. package/dist/lib/neutral/add-toast-H2PK2S3H.mjs.map +7 -0
  15. package/dist/lib/neutral/adjust-J6ZPQ5BT.mjs +93 -0
  16. package/dist/lib/neutral/adjust-J6ZPQ5BT.mjs.map +7 -0
  17. package/dist/lib/neutral/app-graph-builder-MRA3OMKO.mjs +129 -0
  18. package/dist/lib/neutral/app-graph-builder-MRA3OMKO.mjs.map +7 -0
  19. package/dist/lib/neutral/capabilities/index.mjs +23 -0
  20. package/dist/lib/neutral/capabilities/index.mjs.map +7 -0
  21. package/dist/lib/neutral/check-app-scheme-A7FZVNZO.mjs +10 -0
  22. package/dist/lib/neutral/chunk-3WIBNTUT.mjs +35 -0
  23. package/dist/lib/neutral/chunk-3WIBNTUT.mjs.map +7 -0
  24. package/dist/lib/neutral/chunk-FBN443XP.mjs +8 -0
  25. package/dist/lib/neutral/chunk-FBN443XP.mjs.map +7 -0
  26. package/dist/lib/neutral/chunk-FSIEKCMR.mjs +1305 -0
  27. package/dist/lib/neutral/chunk-FSIEKCMR.mjs.map +7 -0
  28. package/dist/lib/neutral/chunk-GBIGQKYW.mjs +112 -0
  29. package/dist/lib/neutral/chunk-GBIGQKYW.mjs.map +7 -0
  30. package/dist/lib/neutral/chunk-GLB73Q6U.mjs +22 -0
  31. package/dist/lib/neutral/chunk-GLB73Q6U.mjs.map +7 -0
  32. package/dist/lib/neutral/chunk-HD44H4CJ.mjs +280 -0
  33. package/dist/lib/neutral/chunk-HD44H4CJ.mjs.map +7 -0
  34. package/dist/lib/neutral/chunk-J5LGTIGS.mjs +10 -0
  35. package/dist/lib/neutral/chunk-VHETZ22W.mjs +101 -0
  36. package/dist/lib/neutral/chunk-VHETZ22W.mjs.map +7 -0
  37. package/dist/lib/neutral/chunk-ZYYOSX5I.mjs +69 -0
  38. package/dist/lib/neutral/chunk-ZYYOSX5I.mjs.map +7 -0
  39. package/dist/lib/neutral/close-IPQTWQXS.mjs +44 -0
  40. package/dist/lib/neutral/close-IPQTWQXS.mjs.map +7 -0
  41. package/dist/lib/neutral/components/index.mjs +126 -0
  42. package/dist/lib/neutral/components/index.mjs.map +7 -0
  43. package/dist/lib/neutral/containers/index.mjs +32 -0
  44. package/dist/lib/neutral/containers/index.mjs.map +7 -0
  45. package/dist/lib/neutral/hooks/index.mjs +159 -0
  46. package/dist/lib/neutral/hooks/index.mjs.map +7 -0
  47. package/dist/lib/neutral/index.mjs +38 -0
  48. package/dist/lib/neutral/index.mjs.map +7 -0
  49. package/dist/lib/neutral/meta.json +1 -0
  50. package/dist/lib/neutral/meta.mjs +8 -0
  51. package/dist/lib/neutral/meta.mjs.map +7 -0
  52. package/dist/lib/neutral/open-OAKTKZM2.mjs +149 -0
  53. package/dist/lib/neutral/open-OAKTKZM2.mjs.map +7 -0
  54. package/dist/lib/neutral/operation-handler-266CVMTW.mjs +13 -0
  55. package/dist/lib/neutral/operation-handler-266CVMTW.mjs.map +7 -0
  56. package/dist/lib/neutral/operations/index.mjs +8 -0
  57. package/dist/lib/neutral/operations/index.mjs.map +7 -0
  58. package/dist/lib/neutral/plugin.mjs +16 -0
  59. package/dist/lib/neutral/plugin.mjs.map +7 -0
  60. package/dist/lib/neutral/react-root-WZ6KH27J.mjs +41 -0
  61. package/dist/lib/neutral/react-root-WZ6KH27J.mjs.map +7 -0
  62. package/dist/lib/neutral/react-surface-KAAZDHV3.mjs +34 -0
  63. package/dist/lib/neutral/react-surface-KAAZDHV3.mjs.map +7 -0
  64. package/dist/lib/neutral/revert-workspace-PLY4YQ4X.mjs +21 -0
  65. package/dist/lib/neutral/revert-workspace-PLY4YQ4X.mjs.map +7 -0
  66. package/dist/lib/neutral/scroll-into-view-INJL3YOV.mjs +21 -0
  67. package/dist/lib/neutral/scroll-into-view-INJL3YOV.mjs.map +7 -0
  68. package/dist/lib/neutral/set-CQ6AO7QB.mjs +37 -0
  69. package/dist/lib/neutral/set-CQ6AO7QB.mjs.map +7 -0
  70. package/dist/lib/neutral/set-layout-mode-NBPJRYGC.mjs +85 -0
  71. package/dist/lib/neutral/set-layout-mode-NBPJRYGC.mjs.map +7 -0
  72. package/dist/lib/neutral/settings-EGNYUM4T.mjs +33 -0
  73. package/dist/lib/neutral/settings-EGNYUM4T.mjs.map +7 -0
  74. package/dist/lib/neutral/show-undo-EZH7JPAV.mjs +59 -0
  75. package/dist/lib/neutral/show-undo-EZH7JPAV.mjs.map +7 -0
  76. package/dist/lib/neutral/state-IIDXMQUO.mjs +86 -0
  77. package/dist/lib/neutral/state-IIDXMQUO.mjs.map +7 -0
  78. package/dist/lib/neutral/switch-workspace-UCFFW3B6.mjs +60 -0
  79. package/dist/lib/neutral/switch-workspace-UCFFW3B6.mjs.map +7 -0
  80. package/dist/lib/neutral/translations.mjs +58 -0
  81. package/dist/lib/neutral/translations.mjs.map +7 -0
  82. package/dist/lib/neutral/types/index.mjs +34 -0
  83. package/dist/lib/neutral/types/index.mjs.map +7 -0
  84. package/dist/lib/neutral/update-companion-NCPRS5MP.mjs +32 -0
  85. package/dist/lib/neutral/update-companion-NCPRS5MP.mjs.map +7 -0
  86. package/dist/lib/neutral/update-complementary-4RERA3VA.mjs +28 -0
  87. package/dist/lib/neutral/update-complementary-4RERA3VA.mjs.map +7 -0
  88. package/dist/lib/neutral/update-dialog-GMFMY7KZ.mjs +29 -0
  89. package/dist/lib/neutral/update-dialog-GMFMY7KZ.mjs.map +7 -0
  90. package/dist/lib/neutral/update-plank-size-TO7RMHQM.mjs +26 -0
  91. package/dist/lib/neutral/update-plank-size-TO7RMHQM.mjs.map +7 -0
  92. package/dist/lib/neutral/update-popover-H3KBQQZ4.mjs +33 -0
  93. package/dist/lib/neutral/update-popover-H3KBQQZ4.mjs.map +7 -0
  94. package/dist/lib/neutral/update-sidebar-OM7EGDQR.mjs +25 -0
  95. package/dist/lib/neutral/update-sidebar-OM7EGDQR.mjs.map +7 -0
  96. package/dist/lib/neutral/url-handler-3QTKEM2K.mjs +184 -0
  97. package/dist/lib/neutral/url-handler-3QTKEM2K.mjs.map +7 -0
  98. package/dist/types/src/DeckPlugin.d.ts +3 -1
  99. package/dist/types/src/DeckPlugin.d.ts.map +1 -1
  100. package/dist/types/src/DeckPlugin.node.d.ts +4 -0
  101. package/dist/types/src/DeckPlugin.node.d.ts.map +1 -0
  102. package/dist/types/src/DeckPlugin.test.d.ts +2 -0
  103. package/dist/types/src/DeckPlugin.test.d.ts.map +1 -0
  104. package/dist/types/src/DeckPlugin.workerd.d.ts +4 -0
  105. package/dist/types/src/DeckPlugin.workerd.d.ts.map +1 -0
  106. package/dist/types/src/capabilities/app-graph-builder.d.ts +4 -2
  107. package/dist/types/src/capabilities/app-graph-builder.d.ts.map +1 -1
  108. package/dist/types/src/capabilities/check-app-scheme.d.ts +17 -2
  109. package/dist/types/src/capabilities/check-app-scheme.d.ts.map +1 -1
  110. package/dist/types/src/capabilities/index.d.ts +196 -12
  111. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  112. package/dist/types/src/capabilities/operation-handler.d.ts +6 -0
  113. package/dist/types/src/capabilities/operation-handler.d.ts.map +1 -0
  114. package/dist/types/src/capabilities/react-root.d.ts +4 -2
  115. package/dist/types/src/capabilities/react-root.d.ts.map +1 -1
  116. package/dist/types/src/capabilities/react-surface.d.ts +3 -2
  117. package/dist/types/src/capabilities/react-surface.d.ts.map +1 -1
  118. package/dist/types/src/capabilities/settings.d.ts +5 -2
  119. package/dist/types/src/capabilities/settings.d.ts.map +1 -1
  120. package/dist/types/src/capabilities/state.d.ts +136 -49
  121. package/dist/types/src/capabilities/state.d.ts.map +1 -1
  122. package/dist/types/src/capabilities/tools.d.ts +4 -3
  123. package/dist/types/src/capabilities/tools.d.ts.map +1 -1
  124. package/dist/types/src/capabilities/url-handler.d.ts +3 -2
  125. package/dist/types/src/capabilities/url-handler.d.ts.map +1 -1
  126. package/dist/types/src/components/DeckSettings/DeckSettings.d.ts +4 -4
  127. package/dist/types/src/components/DeckSettings/DeckSettings.d.ts.map +1 -1
  128. package/dist/types/src/components/DeckSettings/DeckSettings.stories.d.ts +62 -0
  129. package/dist/types/src/components/DeckSettings/DeckSettings.stories.d.ts.map +1 -0
  130. package/dist/types/src/components/DeckSettings/index.d.ts +1 -1
  131. package/dist/types/src/components/DeckSettings/index.d.ts.map +1 -1
  132. package/dist/types/src/components/Matrix/Matrix.d.ts +41 -0
  133. package/dist/types/src/components/Matrix/Matrix.d.ts.map +1 -0
  134. package/dist/types/src/components/Matrix/Matrix.stories.d.ts +17 -0
  135. package/dist/types/src/components/Matrix/Matrix.stories.d.ts.map +1 -0
  136. package/dist/types/src/components/Matrix/index.d.ts +3 -0
  137. package/dist/types/src/components/Matrix/index.d.ts.map +1 -0
  138. package/dist/types/src/components/index.d.ts +3 -2
  139. package/dist/types/src/components/index.d.ts.map +1 -1
  140. package/dist/types/src/{components/DeckLayout → containers/Deck}/Banner.d.ts +1 -1
  141. package/dist/types/src/containers/Deck/Banner.d.ts.map +1 -0
  142. package/dist/types/src/containers/Deck/Deck.d.ts +25 -0
  143. package/dist/types/src/containers/Deck/Deck.d.ts.map +1 -0
  144. package/dist/types/src/containers/Deck/Deck.stories.d.ts +62 -0
  145. package/dist/types/src/containers/Deck/Deck.stories.d.ts.map +1 -0
  146. package/dist/types/src/containers/Deck/DeckContent.d.ts +7 -0
  147. package/dist/types/src/containers/Deck/DeckContent.d.ts.map +1 -0
  148. package/dist/types/src/containers/Deck/DeckRoot.d.ts +39 -0
  149. package/dist/types/src/containers/Deck/DeckRoot.d.ts.map +1 -0
  150. package/dist/types/src/containers/Deck/DeckViewport.d.ts +16 -0
  151. package/dist/types/src/containers/Deck/DeckViewport.d.ts.map +1 -0
  152. package/dist/types/src/containers/Deck/StatusBar.d.ts.map +1 -0
  153. package/dist/types/src/containers/Deck/index.d.ts +2 -0
  154. package/dist/types/src/containers/Deck/index.d.ts.map +1 -0
  155. package/dist/types/src/containers/DeckLayout/ActiveNode.d.ts.map +1 -0
  156. package/dist/types/src/containers/DeckLayout/DeckLayout.d.ts.map +1 -0
  157. package/dist/types/src/containers/DeckLayout/DeckLayout.stories.d.ts +64 -0
  158. package/dist/types/src/containers/DeckLayout/DeckLayout.stories.d.ts.map +1 -0
  159. package/dist/types/src/containers/DeckLayout/Dialog.d.ts.map +1 -0
  160. package/dist/types/src/containers/DeckLayout/Fallback.d.ts +2 -0
  161. package/dist/types/src/containers/DeckLayout/Fallback.d.ts.map +1 -0
  162. package/dist/types/src/containers/DeckLayout/Popover.d.ts +5 -0
  163. package/dist/types/src/containers/DeckLayout/Popover.d.ts.map +1 -0
  164. package/dist/types/src/{components → containers}/DeckLayout/Toast.d.ts +3 -3
  165. package/dist/types/src/containers/DeckLayout/Toast.d.ts.map +1 -0
  166. package/dist/types/src/containers/DeckLayout/constants.d.ts.map +1 -0
  167. package/dist/types/src/containers/DeckLayout/index.d.ts +4 -0
  168. package/dist/types/src/containers/DeckLayout/index.d.ts.map +1 -0
  169. package/dist/types/src/containers/Plank/Plank.d.ts +17 -0
  170. package/dist/types/src/containers/Plank/Plank.d.ts.map +1 -0
  171. package/dist/types/src/containers/Plank/Plank.stories.d.ts +62 -0
  172. package/dist/types/src/containers/Plank/Plank.stories.d.ts.map +1 -0
  173. package/dist/types/src/containers/Plank/PlankComponent.d.ts +17 -0
  174. package/dist/types/src/containers/Plank/PlankComponent.d.ts.map +1 -0
  175. package/dist/types/src/containers/Plank/PlankContent.d.ts +10 -0
  176. package/dist/types/src/containers/Plank/PlankContent.d.ts.map +1 -0
  177. package/dist/types/src/{components → containers}/Plank/PlankControls.d.ts +5 -6
  178. package/dist/types/src/containers/Plank/PlankControls.d.ts.map +1 -0
  179. package/dist/types/src/containers/Plank/PlankError.d.ts +15 -0
  180. package/dist/types/src/containers/Plank/PlankError.d.ts.map +1 -0
  181. package/dist/types/src/{components → containers}/Plank/PlankHeading.d.ts +5 -4
  182. package/dist/types/src/containers/Plank/PlankHeading.d.ts.map +1 -0
  183. package/dist/types/src/{components → containers}/Plank/PlankLoading.d.ts.map +1 -1
  184. package/dist/types/src/containers/Plank/PlankRoot.d.ts +37 -0
  185. package/dist/types/src/containers/Plank/PlankRoot.d.ts.map +1 -0
  186. package/dist/types/src/containers/Plank/index.d.ts +4 -0
  187. package/dist/types/src/containers/Plank/index.d.ts.map +1 -0
  188. package/dist/types/src/containers/Sidebar/ComplementarySidebar.d.ts.map +1 -0
  189. package/dist/types/src/containers/Sidebar/Sidebar.d.ts.map +1 -0
  190. package/dist/types/src/{components → containers}/Sidebar/SidebarButton.d.ts +1 -1
  191. package/dist/types/src/containers/Sidebar/SidebarButton.d.ts.map +1 -0
  192. package/dist/types/src/{components → containers}/Sidebar/index.d.ts.map +1 -1
  193. package/dist/types/src/containers/index.d.ts +6 -0
  194. package/dist/types/src/containers/index.d.ts.map +1 -0
  195. package/dist/types/src/hooks/index.d.ts +2 -1
  196. package/dist/types/src/hooks/index.d.ts.map +1 -1
  197. package/dist/types/src/hooks/useBreakpoints.d.ts +1 -1
  198. package/dist/types/src/hooks/useCompanions.d.ts.map +1 -1
  199. package/dist/types/src/hooks/useDeckCompanions.d.ts +4 -4
  200. package/dist/types/src/hooks/useDeckCompanions.d.ts.map +1 -1
  201. package/dist/types/src/hooks/useDeckState.d.ts +17 -0
  202. package/dist/types/src/hooks/useDeckState.d.ts.map +1 -0
  203. package/dist/types/src/hooks/useMainSize.d.ts +2 -2
  204. package/dist/types/src/hooks/useMainSize.d.ts.map +1 -1
  205. package/dist/types/src/hooks/useNodeActionExpander.d.ts +1 -1
  206. package/dist/types/src/hooks/useNodeActionExpander.d.ts.map +1 -1
  207. package/dist/types/src/hooks/useSelectedCompanion.d.ts +13 -0
  208. package/dist/types/src/hooks/useSelectedCompanion.d.ts.map +1 -0
  209. package/dist/types/src/index.d.ts +1 -4
  210. package/dist/types/src/index.d.ts.map +1 -1
  211. package/dist/types/src/layout.d.ts +20 -9
  212. package/dist/types/src/layout.d.ts.map +1 -1
  213. package/dist/types/src/layout.test.d.ts +2 -0
  214. package/dist/types/src/layout.test.d.ts.map +1 -0
  215. package/dist/types/src/meta.d.ts +2 -2
  216. package/dist/types/src/meta.d.ts.map +1 -1
  217. package/dist/types/src/operations/add-toast.d.ts +5 -0
  218. package/dist/types/src/operations/add-toast.d.ts.map +1 -0
  219. package/dist/types/src/operations/adjust.d.ts +5 -0
  220. package/dist/types/src/operations/adjust.d.ts.map +1 -0
  221. package/dist/types/src/operations/close.d.ts +5 -0
  222. package/dist/types/src/operations/close.d.ts.map +1 -0
  223. package/dist/types/src/operations/helpers.d.ts +3 -0
  224. package/dist/types/src/operations/helpers.d.ts.map +1 -0
  225. package/dist/types/src/operations/index.d.ts +3 -0
  226. package/dist/types/src/operations/index.d.ts.map +1 -0
  227. package/dist/types/src/operations/open.d.ts +5 -0
  228. package/dist/types/src/operations/open.d.ts.map +1 -0
  229. package/dist/types/src/operations/revert-workspace.d.ts +5 -0
  230. package/dist/types/src/operations/revert-workspace.d.ts.map +1 -0
  231. package/dist/types/src/operations/scroll-into-view.d.ts +5 -0
  232. package/dist/types/src/operations/scroll-into-view.d.ts.map +1 -0
  233. package/dist/types/src/operations/set-layout-mode.d.ts +9 -0
  234. package/dist/types/src/operations/set-layout-mode.d.ts.map +1 -0
  235. package/dist/types/src/operations/set.d.ts +5 -0
  236. package/dist/types/src/operations/set.d.ts.map +1 -0
  237. package/dist/types/src/operations/show-undo.d.ts +5 -0
  238. package/dist/types/src/operations/show-undo.d.ts.map +1 -0
  239. package/dist/types/src/operations/switch-workspace.d.ts +5 -0
  240. package/dist/types/src/operations/switch-workspace.d.ts.map +1 -0
  241. package/dist/types/src/operations/update-companion.d.ts +5 -0
  242. package/dist/types/src/operations/update-companion.d.ts.map +1 -0
  243. package/dist/types/src/operations/update-complementary.d.ts +5 -0
  244. package/dist/types/src/operations/update-complementary.d.ts.map +1 -0
  245. package/dist/types/src/operations/update-dialog.d.ts +5 -0
  246. package/dist/types/src/operations/update-dialog.d.ts.map +1 -0
  247. package/dist/types/src/operations/update-plank-size.d.ts +5 -0
  248. package/dist/types/src/operations/update-plank-size.d.ts.map +1 -0
  249. package/dist/types/src/operations/update-popover.d.ts +5 -0
  250. package/dist/types/src/operations/update-popover.d.ts.map +1 -0
  251. package/dist/types/src/operations/update-sidebar.d.ts +5 -0
  252. package/dist/types/src/operations/update-sidebar.d.ts.map +1 -0
  253. package/dist/types/src/plugin.d.ts +4 -0
  254. package/dist/types/src/plugin.d.ts.map +1 -0
  255. package/dist/types/src/translations.d.ts +43 -55
  256. package/dist/types/src/translations.d.ts.map +1 -1
  257. package/dist/types/src/types/DeckCapabilities.d.ts +188 -0
  258. package/dist/types/src/types/DeckCapabilities.d.ts.map +1 -0
  259. package/dist/types/src/types/DeckEvents.d.ts +5 -0
  260. package/dist/types/src/types/DeckEvents.d.ts.map +1 -0
  261. package/dist/types/src/types/DeckOperation.d.ts +15 -0
  262. package/dist/types/src/types/DeckOperation.d.ts.map +1 -0
  263. package/dist/types/src/types/Settings.d.ts +10 -0
  264. package/dist/types/src/types/Settings.d.ts.map +1 -0
  265. package/dist/types/src/types/index.d.ts +4 -0
  266. package/dist/types/src/types/index.d.ts.map +1 -1
  267. package/dist/types/src/types/schema.d.ts +64 -64
  268. package/dist/types/src/types/schema.d.ts.map +1 -1
  269. package/dist/types/src/util/index.d.ts +2 -1
  270. package/dist/types/src/util/index.d.ts.map +1 -1
  271. package/dist/types/src/util/layoutAppliesTopbar.d.ts +1 -1
  272. package/dist/types/src/util/layoutAppliesTopbar.d.ts.map +1 -1
  273. package/dist/types/src/util/plank-url-params.d.ts +14 -0
  274. package/dist/types/src/util/plank-url-params.d.ts.map +1 -0
  275. package/dist/types/src/util/plank-url-params.test.d.ts +2 -0
  276. package/dist/types/src/util/plank-url-params.test.d.ts.map +1 -0
  277. package/dist/types/src/util/sanitize-persisted-state.d.ts +19 -0
  278. package/dist/types/src/util/sanitize-persisted-state.d.ts.map +1 -0
  279. package/dist/types/src/util/sanitize-persisted-state.test.d.ts +2 -0
  280. package/dist/types/src/util/sanitize-persisted-state.test.d.ts.map +1 -0
  281. package/dist/types/src/util/set-active.d.ts +19 -4
  282. package/dist/types/src/util/set-active.d.ts.map +1 -1
  283. package/dist/types/src/util/set-active.test.d.ts +2 -0
  284. package/dist/types/src/util/set-active.test.d.ts.map +1 -0
  285. package/dist/types/tsconfig.tsbuildinfo +1 -1
  286. package/package.json +130 -61
  287. package/src/DeckPlugin.node.ts +17 -0
  288. package/src/DeckPlugin.test.ts +27 -0
  289. package/src/DeckPlugin.ts +32 -56
  290. package/src/DeckPlugin.workerd.ts +16 -0
  291. package/src/capabilities/app-graph-builder.ts +111 -127
  292. package/src/capabilities/check-app-scheme.ts +123 -24
  293. package/src/capabilities/index.ts +13 -14
  294. package/src/capabilities/operation-handler.ts +16 -0
  295. package/src/capabilities/react-root.tsx +37 -30
  296. package/src/capabilities/react-surface.tsx +28 -22
  297. package/src/capabilities/settings.ts +29 -20
  298. package/src/capabilities/state.ts +74 -96
  299. package/src/capabilities/tools.ts +57 -50
  300. package/src/capabilities/url-handler.ts +221 -50
  301. package/src/components/DeckSettings/DeckSettings.stories.tsx +37 -0
  302. package/src/components/DeckSettings/DeckSettings.tsx +19 -88
  303. package/src/components/DeckSettings/index.ts +2 -2
  304. package/src/components/Matrix/Matrix.stories.tsx +220 -0
  305. package/src/components/Matrix/Matrix.tsx +205 -0
  306. package/src/components/Matrix/SPEC.md +219 -0
  307. package/src/components/Matrix/index.ts +6 -0
  308. package/src/components/index.ts +6 -3
  309. package/src/containers/Deck/Banner.tsx +41 -0
  310. package/src/containers/Deck/Deck.stories.tsx +81 -0
  311. package/src/containers/Deck/Deck.tsx +21 -0
  312. package/src/containers/Deck/DeckContent.tsx +102 -0
  313. package/src/containers/Deck/DeckRoot.tsx +50 -0
  314. package/src/containers/Deck/DeckViewport.tsx +450 -0
  315. package/src/{components/DeckLayout → containers/Deck}/StatusBar.tsx +4 -4
  316. package/src/containers/Deck/index.ts +5 -0
  317. package/src/{components → containers}/DeckLayout/ActiveNode.tsx +9 -4
  318. package/src/containers/DeckLayout/DeckLayout.stories.tsx +395 -0
  319. package/src/containers/DeckLayout/DeckLayout.tsx +62 -0
  320. package/src/containers/DeckLayout/Dialog.tsx +52 -0
  321. package/src/containers/DeckLayout/Fallback.tsx +24 -0
  322. package/src/containers/DeckLayout/Popover.tsx +162 -0
  323. package/src/{components → containers}/DeckLayout/Toast.tsx +5 -5
  324. package/src/{components → containers}/DeckLayout/constants.ts +1 -0
  325. package/src/{components → containers}/DeckLayout/index.ts +3 -2
  326. package/src/containers/Plank/Plank.stories.tsx +108 -0
  327. package/src/containers/Plank/Plank.tsx +22 -0
  328. package/src/containers/Plank/PlankComponent.tsx +218 -0
  329. package/src/containers/Plank/PlankContent.tsx +45 -0
  330. package/src/{components → containers}/Plank/PlankControls.tsx +43 -37
  331. package/src/containers/Plank/PlankError.tsx +82 -0
  332. package/src/{components → containers}/Plank/PlankHeading.tsx +67 -64
  333. package/src/{components → containers}/Plank/PlankLoading.tsx +1 -1
  334. package/src/containers/Plank/PlankRoot.tsx +49 -0
  335. package/src/{components → containers}/Plank/index.ts +0 -2
  336. package/src/containers/Sidebar/ComplementarySidebar.tsx +192 -0
  337. package/src/containers/Sidebar/Sidebar.tsx +39 -0
  338. package/src/containers/Sidebar/SidebarButton.tsx +100 -0
  339. package/src/containers/index.ts +11 -0
  340. package/src/hooks/index.ts +2 -1
  341. package/src/hooks/useCompanions.ts +3 -3
  342. package/src/hooks/useDeckCompanions.ts +8 -11
  343. package/src/hooks/useDeckState.ts +73 -0
  344. package/src/hooks/useMainSize.ts +2 -2
  345. package/src/hooks/useNodeActionExpander.ts +4 -4
  346. package/src/hooks/useSelectedCompanion.ts +32 -0
  347. package/src/index.ts +1 -4
  348. package/src/layout.test.ts +59 -0
  349. package/src/layout.ts +38 -40
  350. package/src/meta.ts +22 -5
  351. package/src/operations/add-toast.ts +24 -0
  352. package/src/operations/adjust.ts +82 -0
  353. package/src/operations/close.ts +35 -0
  354. package/src/operations/helpers.ts +22 -0
  355. package/src/operations/index.ts +24 -0
  356. package/src/operations/open.ts +186 -0
  357. package/src/operations/revert-workspace.ts +22 -0
  358. package/src/operations/scroll-into-view.ts +24 -0
  359. package/src/operations/set-layout-mode.ts +84 -0
  360. package/src/operations/set.ts +36 -0
  361. package/src/operations/show-undo.ts +47 -0
  362. package/src/operations/switch-workspace.ts +66 -0
  363. package/src/operations/update-companion.ts +35 -0
  364. package/src/operations/update-complementary.ts +33 -0
  365. package/src/operations/update-dialog.ts +34 -0
  366. package/src/operations/update-plank-size.ts +28 -0
  367. package/src/operations/update-popover.ts +36 -0
  368. package/src/operations/update-sidebar.ts +28 -0
  369. package/src/plugin.ts +11 -0
  370. package/src/translations.ts +43 -54
  371. package/src/types/DeckCapabilities.ts +34 -0
  372. package/src/types/DeckEvents.ts +21 -0
  373. package/src/types/DeckOperation.ts +53 -0
  374. package/src/types/Settings.ts +36 -0
  375. package/src/types/index.ts +5 -0
  376. package/src/types/schema.ts +49 -58
  377. package/src/util/index.ts +2 -1
  378. package/src/util/layoutAppliesTopbar.ts +2 -2
  379. package/src/util/plank-url-params.test.ts +85 -0
  380. package/src/util/plank-url-params.ts +36 -0
  381. package/src/util/sanitize-persisted-state.test.ts +79 -0
  382. package/src/util/sanitize-persisted-state.ts +52 -0
  383. package/src/util/set-active.test.ts +106 -0
  384. package/src/util/set-active.ts +50 -30
  385. package/src/vite-env.d.ts +5 -0
  386. package/dist/lib/browser/app-graph-builder-D74NTOMK.mjs +0 -128
  387. package/dist/lib/browser/app-graph-builder-D74NTOMK.mjs.map +0 -7
  388. package/dist/lib/browser/check-app-scheme-HIEVFAAX.mjs +0 -32
  389. package/dist/lib/browser/check-app-scheme-HIEVFAAX.mjs.map +0 -7
  390. package/dist/lib/browser/chunk-5KMJPIQC.mjs +0 -16
  391. package/dist/lib/browser/chunk-5KMJPIQC.mjs.map +0 -7
  392. package/dist/lib/browser/chunk-CNTGBCMK.mjs +0 -145
  393. package/dist/lib/browser/chunk-CNTGBCMK.mjs.map +0 -7
  394. package/dist/lib/browser/chunk-F3VCCHVL.mjs +0 -162
  395. package/dist/lib/browser/chunk-F3VCCHVL.mjs.map +0 -7
  396. package/dist/lib/browser/chunk-QKCGZ45E.mjs +0 -128
  397. package/dist/lib/browser/chunk-QKCGZ45E.mjs.map +0 -7
  398. package/dist/lib/browser/chunk-UXLU6CMW.mjs +0 -16
  399. package/dist/lib/browser/chunk-UXLU6CMW.mjs.map +0 -7
  400. package/dist/lib/browser/chunk-VBYJ664A.mjs +0 -132
  401. package/dist/lib/browser/chunk-VBYJ664A.mjs.map +0 -7
  402. package/dist/lib/browser/chunk-VUJ6UNIJ.mjs +0 -1553
  403. package/dist/lib/browser/chunk-VUJ6UNIJ.mjs.map +0 -7
  404. package/dist/lib/browser/index.mjs +0 -174
  405. package/dist/lib/browser/index.mjs.map +0 -7
  406. package/dist/lib/browser/intent-resolver-UA4YQGAC.mjs +0 -524
  407. package/dist/lib/browser/intent-resolver-UA4YQGAC.mjs.map +0 -7
  408. package/dist/lib/browser/meta.json +0 -1
  409. package/dist/lib/browser/react-root-JAMHKYWN.mjs +0 -44
  410. package/dist/lib/browser/react-root-JAMHKYWN.mjs.map +0 -7
  411. package/dist/lib/browser/react-surface-6LW337ZT.mjs +0 -40
  412. package/dist/lib/browser/react-surface-6LW337ZT.mjs.map +0 -7
  413. package/dist/lib/browser/settings-SDPTOCCM.mjs +0 -30
  414. package/dist/lib/browser/settings-SDPTOCCM.mjs.map +0 -7
  415. package/dist/lib/browser/state-7IFAGZQO.mjs +0 -12
  416. package/dist/lib/browser/toolkit-L5CFXJCF.mjs +0 -52
  417. package/dist/lib/browser/toolkit-L5CFXJCF.mjs.map +0 -7
  418. package/dist/lib/browser/types/index.mjs +0 -32
  419. package/dist/lib/browser/url-handler-QEYGYE2H.mjs +0 -70
  420. package/dist/lib/browser/url-handler-QEYGYE2H.mjs.map +0 -7
  421. package/dist/types/src/capabilities/capabilities.d.ts +0 -184
  422. package/dist/types/src/capabilities/capabilities.d.ts.map +0 -1
  423. package/dist/types/src/capabilities/intent-resolver.d.ts +0 -4
  424. package/dist/types/src/capabilities/intent-resolver.d.ts.map +0 -1
  425. package/dist/types/src/capabilities/toolkit.d.ts +0 -25
  426. package/dist/types/src/capabilities/toolkit.d.ts.map +0 -1
  427. package/dist/types/src/components/DeckLayout/ActiveNode.d.ts.map +0 -1
  428. package/dist/types/src/components/DeckLayout/Banner.d.ts.map +0 -1
  429. package/dist/types/src/components/DeckLayout/ContentEmpty.d.ts +0 -3
  430. package/dist/types/src/components/DeckLayout/ContentEmpty.d.ts.map +0 -1
  431. package/dist/types/src/components/DeckLayout/DeckLayout.d.ts.map +0 -1
  432. package/dist/types/src/components/DeckLayout/DeckLayout.stories.d.ts +0 -74
  433. package/dist/types/src/components/DeckLayout/DeckLayout.stories.d.ts.map +0 -1
  434. package/dist/types/src/components/DeckLayout/DeckMain.d.ts +0 -3
  435. package/dist/types/src/components/DeckLayout/DeckMain.d.ts.map +0 -1
  436. package/dist/types/src/components/DeckLayout/Dialog.d.ts.map +0 -1
  437. package/dist/types/src/components/DeckLayout/Fallback.d.ts +0 -3
  438. package/dist/types/src/components/DeckLayout/Fallback.d.ts.map +0 -1
  439. package/dist/types/src/components/DeckLayout/Popover.d.ts +0 -5
  440. package/dist/types/src/components/DeckLayout/Popover.d.ts.map +0 -1
  441. package/dist/types/src/components/DeckLayout/StatusBar.d.ts.map +0 -1
  442. package/dist/types/src/components/DeckLayout/Toast.d.ts.map +0 -1
  443. package/dist/types/src/components/DeckLayout/Topbar.d.ts +0 -3
  444. package/dist/types/src/components/DeckLayout/Topbar.d.ts.map +0 -1
  445. package/dist/types/src/components/DeckLayout/constants.d.ts.map +0 -1
  446. package/dist/types/src/components/DeckLayout/index.d.ts +0 -4
  447. package/dist/types/src/components/DeckLayout/index.d.ts.map +0 -1
  448. package/dist/types/src/components/Plank/Plank.d.ts +0 -27
  449. package/dist/types/src/components/Plank/Plank.d.ts.map +0 -1
  450. package/dist/types/src/components/Plank/Plank.stories.d.ts +0 -89
  451. package/dist/types/src/components/Plank/Plank.stories.d.ts.map +0 -1
  452. package/dist/types/src/components/Plank/PlankControls.d.ts.map +0 -1
  453. package/dist/types/src/components/Plank/PlankError.d.ts +0 -13
  454. package/dist/types/src/components/Plank/PlankError.d.ts.map +0 -1
  455. package/dist/types/src/components/Plank/PlankHeading.d.ts.map +0 -1
  456. package/dist/types/src/components/Plank/index.d.ts +0 -6
  457. package/dist/types/src/components/Plank/index.d.ts.map +0 -1
  458. package/dist/types/src/components/Sidebar/ComplementarySidebar.d.ts.map +0 -1
  459. package/dist/types/src/components/Sidebar/Sidebar.d.ts.map +0 -1
  460. package/dist/types/src/components/Sidebar/SidebarButton.d.ts.map +0 -1
  461. package/dist/types/src/components/fragments.d.ts +0 -4
  462. package/dist/types/src/components/fragments.d.ts.map +0 -1
  463. package/dist/types/src/events.d.ts +0 -4
  464. package/dist/types/src/events.d.ts.map +0 -1
  465. package/dist/types/src/hooks/useHoistStatusbar.d.ts +0 -3
  466. package/dist/types/src/hooks/useHoistStatusbar.d.ts.map +0 -1
  467. package/dist/types/src/util/overscroll.d.ts +0 -47
  468. package/dist/types/src/util/overscroll.d.ts.map +0 -1
  469. package/src/capabilities/capabilities.ts +0 -14
  470. package/src/capabilities/intent-resolver.ts +0 -471
  471. package/src/capabilities/toolkit.ts +0 -66
  472. package/src/components/DeckLayout/Banner.tsx +0 -39
  473. package/src/components/DeckLayout/ContentEmpty.tsx +0 -31
  474. package/src/components/DeckLayout/DeckLayout.stories.tsx +0 -63
  475. package/src/components/DeckLayout/DeckLayout.tsx +0 -32
  476. package/src/components/DeckLayout/DeckMain.tsx +0 -281
  477. package/src/components/DeckLayout/Dialog.tsx +0 -36
  478. package/src/components/DeckLayout/Fallback.tsx +0 -28
  479. package/src/components/DeckLayout/Popover.tsx +0 -95
  480. package/src/components/DeckLayout/Topbar.tsx +0 -11
  481. package/src/components/Plank/Plank.stories.tsx +0 -54
  482. package/src/components/Plank/Plank.tsx +0 -299
  483. package/src/components/Plank/PlankError.tsx +0 -49
  484. package/src/components/Sidebar/ComplementarySidebar.tsx +0 -214
  485. package/src/components/Sidebar/Sidebar.tsx +0 -42
  486. package/src/components/Sidebar/SidebarButton.tsx +0 -88
  487. package/src/components/fragments.ts +0 -14
  488. package/src/events.ts +0 -11
  489. package/src/hooks/useHoistStatusbar.ts +0 -27
  490. package/src/util/overscroll.ts +0 -69
  491. /package/dist/lib/{browser/state-7IFAGZQO.mjs.map → neutral/check-app-scheme-A7FZVNZO.mjs.map} +0 -0
  492. /package/dist/lib/{browser/types/index.mjs.map → neutral/chunk-J5LGTIGS.mjs.map} +0 -0
  493. /package/dist/types/src/{components/DeckLayout → containers/Deck}/StatusBar.d.ts +0 -0
  494. /package/dist/types/src/{components → containers}/DeckLayout/ActiveNode.d.ts +0 -0
  495. /package/dist/types/src/{components → containers}/DeckLayout/DeckLayout.d.ts +0 -0
  496. /package/dist/types/src/{components → containers}/DeckLayout/Dialog.d.ts +0 -0
  497. /package/dist/types/src/{components → containers}/DeckLayout/constants.d.ts +0 -0
  498. /package/dist/types/src/{components → containers}/Plank/PlankLoading.d.ts +0 -0
  499. /package/dist/types/src/{components → containers}/Sidebar/ComplementarySidebar.d.ts +0 -0
  500. /package/dist/types/src/{components → containers}/Sidebar/Sidebar.d.ts +0 -0
  501. /package/dist/types/src/{components → containers}/Sidebar/index.d.ts +0 -0
  502. /package/src/{components → containers}/Sidebar/index.ts +0 -0
@@ -0,0 +1,28 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities } from '@dxos/app-framework';
8
+ import { Operation } from '@dxos/compute';
9
+
10
+ import { DeckCapabilities, DeckOperation } from '../types';
11
+ import { updateActiveDeck } from './helpers';
12
+
13
+ const handler: Operation.WithHandler<typeof DeckOperation.UpdatePlankSize> = DeckOperation.UpdatePlankSize.pipe(
14
+ Operation.withHandler(
15
+ Effect.fnUntraced(function* (input) {
16
+ yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) =>
17
+ updateActiveDeck(state, {
18
+ plankSizing: {
19
+ ...state.decks[state.activeDeck]?.plankSizing,
20
+ [input.id]: input.size,
21
+ },
22
+ }),
23
+ );
24
+ }),
25
+ ),
26
+ );
27
+
28
+ export default handler;
@@ -0,0 +1,36 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities } from '@dxos/app-framework';
8
+ import { LayoutOperation } from '@dxos/app-toolkit';
9
+ import { Operation } from '@dxos/compute';
10
+
11
+ import { DeckCapabilities } from '../types';
12
+
13
+ const handler: Operation.WithHandler<typeof LayoutOperation.UpdatePopover> = LayoutOperation.UpdatePopover.pipe(
14
+ Operation.withHandler(
15
+ Effect.fnUntraced(function* (input) {
16
+ yield* Capabilities.updateAtomValue(DeckCapabilities.EphemeralState, (state) => ({
17
+ ...state,
18
+ popoverOpen: input.state ?? Boolean(input.subject),
19
+ popoverKind: input.kind ?? 'base',
20
+ popoverTitle: input.kind === 'card' ? input.title : undefined,
21
+ popoverContentRef: input.subjectRef,
22
+ popoverContent:
23
+ typeof input.subject === 'string'
24
+ ? { component: input.subject, props: input.props }
25
+ : input.subject
26
+ ? { subject: input.subject }
27
+ : null,
28
+ popoverSide: input.side,
29
+ popoverAnchor: input.variant === 'virtual' ? input.anchor : state.popoverAnchor,
30
+ popoverAnchorId: input.variant !== 'virtual' ? input.anchorId : state.popoverAnchorId,
31
+ }));
32
+ }),
33
+ ),
34
+ );
35
+
36
+ export default handler;
@@ -0,0 +1,28 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities } from '@dxos/app-framework';
8
+ import { LayoutOperation } from '@dxos/app-toolkit';
9
+ import { Operation } from '@dxos/compute';
10
+
11
+ import { DeckCapabilities } from '../types';
12
+
13
+ const handler: Operation.WithHandler<typeof LayoutOperation.UpdateSidebar> = LayoutOperation.UpdateSidebar.pipe(
14
+ Operation.withHandler(
15
+ Effect.fnUntraced(function* (input) {
16
+ const state = yield* Capabilities.getAtomValue(DeckCapabilities.State);
17
+ const next = input.state ?? state.sidebarState;
18
+ if (next !== state.sidebarState) {
19
+ yield* Capabilities.updateAtomValue(DeckCapabilities.State, (state) => ({
20
+ ...state,
21
+ sidebarState: next,
22
+ }));
23
+ }
24
+ }),
25
+ ),
26
+ );
27
+
28
+ export default handler;
package/src/plugin.ts ADDED
@@ -0,0 +1,11 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ import { Plugin } from '@dxos/app-framework';
6
+
7
+ import { meta } from './meta';
8
+
9
+ export const DeckPlugin = Plugin.lazy(meta, () => import('#plugin'));
10
+
11
+ export { DeckOperationHandlerSet } from './operations';
@@ -4,66 +4,55 @@
4
4
 
5
5
  import { type Resource } from '@dxos/react-ui';
6
6
 
7
- import { meta } from './meta';
7
+ import { meta } from '#meta';
8
8
 
9
9
  export const translations = [
10
10
  {
11
11
  'en-US': {
12
12
  [meta.id]: {
13
- 'plugin name': 'Deck',
14
- 'settings title': 'Deck settings',
15
- 'main header label': 'Main header',
16
- 'open navigation sidebar label': 'Open sidebar',
17
- 'collapse navigation sidebar label': 'Minimize sidebar',
18
- 'open complementary sidebar label': 'Open context sidebar',
19
- 'close complementary sidebar label': 'Minimize context sidebar',
20
- 'sidebar title': 'Navigation sidebar',
21
- 'complementary sidebar title': 'Context sidebar',
22
- 'plugin error message': 'Content failed to render.',
23
- 'content fallback message': 'Unsupported',
24
- 'content fallback description':
13
+ 'plugin.name': 'Deck',
14
+ 'settings.title': 'Deck settings',
15
+ 'main-header.label': 'Main header',
16
+ 'open-navigation-sidebar.label': 'Open sidebar',
17
+ 'collapse-navigation-sidebar.label': 'Close sidebar',
18
+ 'open-complementary-sidebar.label': 'Open context sidebar',
19
+ 'close-complementary-sidebar.label': 'Close context sidebar',
20
+ 'sidebar.title': 'Navigation sidebar',
21
+ 'complementary-sidebar.title': 'Context sidebar',
22
+ 'plugin-error.message': 'Content failed to render.',
23
+ 'content-fallback.message': 'Unsupported',
24
+ 'content-fallback.description':
25
25
  'No plugin had a response for the address you navigated to. Double-check the URL, and ensure you’ve enabled a plugin that supports the object.',
26
- 'toggle fullscreen label': 'Toggle fullscreen',
27
- 'settings show hints label': 'Show hints',
28
- 'settings native redirect label': 'Enable native url redirect (experimental)',
29
- 'settings new plank position start label': 'Start',
30
- 'settings new plank position end label': 'End',
31
- 'select new plank positioning placeholder': 'Select new plank positioning',
32
- 'select new plank positioning label': 'New plank positioning',
33
- 'undo available label': 'Click to undo previous action.',
34
- 'undo action label': 'Undo',
35
- 'undo action alt': 'Undo previous action',
36
- 'undo close label': 'Dismiss',
37
- 'error fallback message': 'Unable to open this item',
38
- 'plank heading fallback label': 'Untitled',
39
- 'actions menu label': 'Options',
40
- 'settings deck label': 'Disable deck',
41
- 'pending heading': 'Loading…',
42
- 'insert plank label': 'Open',
43
- 'resize label': 'Drag to resize',
44
- 'pin start label': 'Pin to the left sidebar',
45
- 'pin end label': 'Pin to the right sidebar',
46
- 'increment start label': 'Move to the left',
47
- 'increment end label': 'Move to the right',
48
- 'show deck plank label': 'Return to deck',
49
- 'show solo plank label': 'Maximize',
50
- 'exit fullscreen label': 'Exit fullscreen',
51
- 'show fullscreen plank label': 'Fullscreen',
52
- 'close label': 'Close',
53
- 'minify label': 'Minify',
54
- 'open companion label': 'Open companion',
55
- 'close companion label': 'Close companion',
56
- 'settings overscroll label': 'Plank scrolling',
57
- 'select overscroll placeholder': 'Select plank scrolling behavior',
58
- 'settings overscroll centering label': 'Centering',
59
- 'settings overscroll none label': 'None',
60
- 'settings enable statusbar label': 'Show status bar',
61
- 'settings enable deck label': 'Enable Deck',
62
- 'settings encapsulated planks label': 'Encapsulated planks',
63
- 'close current label': 'Close current plank',
64
- 'close others label': 'Close other planks',
65
- 'close all label': 'Close all planks',
66
- 'companion plank heading fallback label': 'Related',
26
+ 'toggle-fullscreen.label': 'Toggle fullscreen',
27
+ 'undo-available.label': 'Click to undo previous action.',
28
+ 'undo-action.label': 'Undo',
29
+ 'undo-action.alt': 'Undo previous action',
30
+ 'undo-close.label': 'Dismiss',
31
+ 'error-fallback.message': 'Unable to open this object',
32
+ 'error-fallback.copy.label': 'Copy error details',
33
+ 'plank-heading-fallback.label': 'Untitled',
34
+ 'actions-menu.label': 'Options',
35
+ 'settings.deck.label': 'Disable deck',
36
+ 'pending.heading': 'Loading…',
37
+ 'insert-plank.label': 'Open',
38
+ 'resize.label': 'Drag to resize',
39
+ 'pin-start.label': 'Pin to the left sidebar',
40
+ 'pin-end.label': 'Pin to the right sidebar',
41
+ 'increment-start.label': 'Move to the left',
42
+ 'increment-end.label': 'Move to the right',
43
+ 'show-deck-plank.label': 'Return to deck',
44
+ 'show-solo-plank.label': 'Maximize',
45
+ 'exit-fullscreen.label': 'Exit fullscreen',
46
+ 'show-fullscreen-plank.label': 'Fullscreen',
47
+ 'close.label': 'Close',
48
+ 'minify.label': 'Minify',
49
+ 'open-companion.label': 'Open companion',
50
+ 'close-companion.label': 'Close companion',
51
+ 'close-current.label': 'Close current plank',
52
+ 'close-others.label': 'Close other planks',
53
+ 'close-all.label': 'Close all planks',
54
+ 'close-navigation-sidebar.button': 'Close',
55
+ 'companion-plank-heading-fallback.label': 'Related',
67
56
  },
68
57
  },
69
58
  },
@@ -0,0 +1,34 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ // @import-as-namespace
6
+
7
+ import { type Atom } from '@effect-atom/atom-react';
8
+ import * as Effect from 'effect/Effect';
9
+
10
+ import { Capabilities, Capability } from '@dxos/app-framework';
11
+ import { invariant } from '@dxos/invariant';
12
+
13
+ import { meta } from '#meta';
14
+
15
+ import { type EphemeralDeckState, type DeckState, type StoredDeckState } from './schema';
16
+
17
+ export const Settings = Capability.make<Atom.Writable<import('./Settings').Settings>>(`${meta.id}.capability.settings`);
18
+
19
+ /** Persisted state (stored in KVS/localStorage). */
20
+ export const State = Capability.make<Atom.Writable<StoredDeckState>>(`${meta.id}.capability.state`);
21
+
22
+ /** Transient/ephemeral state (not persisted). */
23
+ export const EphemeralState = Capability.make<Atom.Writable<EphemeralDeckState>>(
24
+ `${meta.id}.capability.ephemeral-state`,
25
+ );
26
+
27
+ /** Get the current active deck from state. */
28
+ export const getDeck = (): Effect.Effect<DeckState, Error, Capability.Service> =>
29
+ Effect.gen(function* () {
30
+ const state = yield* Capabilities.getAtomValue(State);
31
+ const deck = state.decks[state.activeDeck];
32
+ invariant(deck, `Deck not found: ${state.activeDeck}`);
33
+ return deck;
34
+ });
@@ -0,0 +1,21 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ // @import-as-namespace
6
+
7
+ import { type ActivationEvent } from '@dxos/app-framework';
8
+ import { AppActivationEvents } from '@dxos/app-toolkit';
9
+
10
+ import { meta } from '#meta';
11
+
12
+ import * as DeckCapabilities from './DeckCapabilities';
13
+
14
+ export const StateReady: ActivationEvent.ActivationEvent = AppActivationEvents.createStateEvent(
15
+ `${meta.id}.state-ready`,
16
+ );
17
+
18
+ /** Fired when DeckSettings capability is ready. */
19
+ export const SettingsReady: ActivationEvent.ActivationEvent = AppActivationEvents.createSettingsEvent(
20
+ DeckCapabilities.Settings.identifier,
21
+ );
@@ -0,0 +1,53 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ // @import-as-namespace
6
+
7
+ import * as Schema from 'effect/Schema';
8
+
9
+ import { Capability } from '@dxos/app-framework';
10
+ import { Operation } from '@dxos/compute';
11
+
12
+ import { meta } from '#meta';
13
+
14
+ const PartAdjustmentSchema = Schema.Union(
15
+ Schema.Literal('close').annotations({ description: 'Close the plank.' }),
16
+ Schema.Literal('companion').annotations({ description: 'Open the companion plank.' }),
17
+ Schema.Literal('solo').annotations({ description: 'Solo the plank.' }),
18
+ Schema.Literal('solo--fullscreen').annotations({ description: 'Fullscreen the plank.' }),
19
+ Schema.Literal('increment-start').annotations({ description: 'Move the plank towards the start of the deck.' }),
20
+ Schema.Literal('increment-end').annotations({ description: 'Move the plank towards the end of the deck.' }),
21
+ );
22
+
23
+ export type PartAdjustment = Schema.Schema.Type<typeof PartAdjustmentSchema>;
24
+
25
+ export const Adjust = Operation.make({
26
+ meta: {
27
+ key: `${meta.id}.operation.adjust`,
28
+ name: 'Adjust',
29
+ description: 'Adjust the layout of a plank.',
30
+ icon: 'ph--layout--regular',
31
+ },
32
+ services: [Capability.Service],
33
+ input: Schema.Struct({
34
+ id: Schema.String.annotations({ description: 'The id of the plank to adjust.' }),
35
+ type: PartAdjustmentSchema.annotations({ description: 'The type of adjustment to make.' }),
36
+ }),
37
+ output: Schema.Void,
38
+ });
39
+
40
+ export const UpdatePlankSize = Operation.make({
41
+ meta: {
42
+ key: `${meta.id}.operation.update-plank-size`,
43
+ name: 'Update Plank Size',
44
+ description: 'Update the size of a plank.',
45
+ icon: 'ph--arrows-out--regular',
46
+ },
47
+ services: [Capability.Service],
48
+ input: Schema.Struct({
49
+ id: Schema.String.annotations({ description: 'The id of the plank to resize.' }),
50
+ size: Schema.Number.annotations({ description: 'The new size of the plank.' }),
51
+ }),
52
+ output: Schema.Void,
53
+ });
@@ -0,0 +1,36 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ // @import-as-namespace
6
+
7
+ import * as Schema from 'effect/Schema';
8
+
9
+ export const Settings = Schema.Struct({
10
+ enableDeck: Schema.optional(
11
+ Schema.Boolean.annotations({
12
+ title: 'Enable Deck',
13
+ description: 'Display multiple panels side by side instead of one at a time.',
14
+ }),
15
+ ),
16
+ // TODO(burdon): Rename layoutMode? (e.g., bento/encapsulated or floating/compact, etc.)
17
+ encapsulatedPlanks: Schema.optional(
18
+ Schema.Boolean.annotations({
19
+ title: 'Encapsulated planks',
20
+ description: 'Render each plank inside its own isolated container.',
21
+ }),
22
+ ),
23
+ showHints: Schema.optional(
24
+ Schema.Boolean.annotations({
25
+ title: 'Show hints',
26
+ description: 'Show helpful tips and keyboard shortcut hints in the interface.',
27
+ }),
28
+ ),
29
+ enableNativeRedirect: Schema.optional(
30
+ Schema.Boolean.annotations({
31
+ title: 'Enable native url redirect',
32
+ description: 'Redirect supported URLs to the native desktop application.',
33
+ }),
34
+ ),
35
+ }).pipe(Schema.mutable);
36
+ export interface Settings extends Schema.Schema.Type<typeof Settings> {}
@@ -3,3 +3,8 @@
3
3
  //
4
4
 
5
5
  export * from './schema';
6
+
7
+ export * as DeckCapabilities from './DeckCapabilities';
8
+ export * as DeckEvents from './DeckEvents';
9
+ export * as DeckOperation from './DeckOperation';
10
+ export * as Settings from './Settings';
@@ -4,52 +4,37 @@
4
4
 
5
5
  import * as Schema from 'effect/Schema';
6
6
 
7
- import { LayoutAction } from '@dxos/app-framework';
7
+ import { Label, LayoutOperation } from '@dxos/app-toolkit';
8
8
  import { type DeepReadonly } from '@dxos/util';
9
9
 
10
- import { meta } from '../meta';
10
+ import { meta } from '#meta';
11
11
 
12
- export { ATTENDABLE_PATH_SEPARATOR } from '@dxos/react-ui-attention';
12
+ export { PLANK_COMPANION_TYPE, DECK_COMPANION_TYPE } from '@dxos/app-toolkit';
13
13
 
14
- export const PLANK_COMPANION_TYPE = `${meta.id}/plank-companion`;
15
- export const DECK_COMPANION_TYPE = `${meta.id}/deck-companion`;
16
-
17
- // TODO(Zan): In the future we should consider adding new planks adjacent to the attended plank.
18
- export const NewPlankPositions = ['start', 'end'] as const;
19
- export type NewPlankPositioning = (typeof NewPlankPositions)[number];
20
-
21
- export const OverscrollOptions = ['none', 'centering'] as const;
22
- export type Overscroll = (typeof OverscrollOptions)[number];
23
-
24
- export type Part = 'solo' | 'deck' | 'complementary';
14
+ export type Part = 'solo' | 'multi' | 'complementary';
25
15
  export type ResolvedPart = Part | 'solo-primary' | 'solo-companion';
26
16
 
27
- export const DeckSettingsSchema = Schema.Struct({
28
- showHints: Schema.optional(Schema.Boolean),
29
- enableDeck: Schema.optional(Schema.Boolean),
30
- enableStatusbar: Schema.optional(Schema.Boolean),
31
- enableNativeRedirect: Schema.optional(Schema.Boolean),
32
- newPlankPositioning: Schema.optional(Schema.Literal(...NewPlankPositions)),
33
- overscroll: Schema.optional(Schema.Literal(...OverscrollOptions)),
34
- // TODO(burdon): Rename layoutMode? (e.g., bento | encapsulated?)
35
- encapsulatedPlanks: Schema.optional(Schema.Boolean),
36
- }).pipe(Schema.mutable);
37
- export type DeckSettingsProps = Schema.Schema.Type<typeof DeckSettingsSchema>;
38
-
39
17
  export const PlankSizing = Schema.Record({ key: Schema.String, value: Schema.Number });
40
18
  export type PlankSizing = Schema.Schema.Type<typeof PlankSizing>;
41
19
 
42
- // State of an individual deck.
43
20
  export const DeckState = Schema.Struct({
44
21
  /** If false, the deck has not yet left solo mode and new planks should be soloed. */
45
22
  initialized: Schema.Boolean,
23
+ /** Item IDs of planks currently displayed in multi-mode. */
46
24
  active: Schema.mutable(Schema.Array(Schema.String)),
47
- // TODO(wittjosiah): Piping into both mutable and optional caused invalid typescript output.
48
- activeCompanions: Schema.optional(Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.String }))),
25
+ /** Item IDs of planks that have been closed; used for state persistence and reopening. */
49
26
  inactive: Schema.mutable(Schema.Array(Schema.String)),
27
+ /** Item ID of the single plank displayed in solo or fullscreen mode. */
50
28
  solo: Schema.optional(Schema.String),
29
+ /** Whether the solo plank is displayed in fullscreen mode (no heading or sidebars). */
51
30
  fullscreen: Schema.Boolean,
31
+ /** Persisted plank widths in rem, keyed by item ID. */
52
32
  plankSizing: Schema.mutable(PlankSizing),
33
+ /** Whether the companion pane is visible alongside the active plank(s). */
34
+ companionOpen: Schema.Boolean,
35
+ /** Which companion variant to display when the companion pane is open. */
36
+ companionVariant: Schema.optional(Schema.String),
37
+ /** Persisted companion frame widths in rem, keyed by frame ID. */
53
38
  companionFrameSizing: Schema.mutable(PlankSizing),
54
39
  });
55
40
  export type DeckState = Schema.Schema.Type<typeof DeckState>;
@@ -57,61 +42,75 @@ export type DeckState = Schema.Schema.Type<typeof DeckState>;
57
42
  export const defaultDeck: DeckState = {
58
43
  initialized: false,
59
44
  active: [],
60
- activeCompanions: {},
61
45
  inactive: [],
62
46
  solo: undefined,
63
47
  fullscreen: false,
64
48
  plankSizing: {},
49
+ companionOpen: false,
50
+ companionVariant: undefined,
65
51
  companionFrameSizing: {},
66
52
  };
67
53
 
68
- const LayoutMode = Schema.Literal('deck', 'solo', 'solo--fullscreen');
54
+ //
55
+ // Layout
56
+ //
57
+
58
+ const LayoutMode = Schema.Literal('multi', 'solo', 'solo--fullscreen');
69
59
  export type LayoutMode = Schema.Schema.Type<typeof LayoutMode>;
70
60
  export const isLayoutMode = (value: any): value is LayoutMode => Schema.is(LayoutMode)(value);
71
-
72
61
  export const getMode = (deck: DeckState | DeepReadonly<DeckState>): LayoutMode => {
73
62
  if (deck.solo) {
74
63
  return deck.fullscreen ? 'solo--fullscreen' : 'solo';
75
64
  }
76
65
 
77
- return 'deck';
66
+ return 'multi';
78
67
  };
79
68
 
80
- // State of the deck plugin.
81
- export const DeckPluginState = Schema.Struct({
69
+ // Persisted plugin state (stored in KVS/localStorage).
70
+ export const StoredDeckState = Schema.Struct({
82
71
  sidebarState: Schema.Literal('closed', 'collapsed', 'expanded'),
83
72
  complementarySidebarState: Schema.Literal('closed', 'collapsed', 'expanded'),
84
73
  complementarySidebarPanel: Schema.optional(Schema.String),
74
+ activeDeck: Schema.String,
75
+ previousDeck: Schema.String,
76
+ decks: Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.mutable(DeckState) })),
77
+ previousMode: Schema.mutable(Schema.Record({ key: Schema.String, value: LayoutMode })),
78
+ }).pipe(Schema.mutable);
79
+ export type StoredDeckState = Schema.Schema.Type<typeof StoredDeckState>;
85
80
 
81
+ // Transient/ephemeral plugin state (not persisted).
82
+ export const EphemeralDeckState = Schema.Struct({
86
83
  dialogOpen: Schema.Boolean,
87
84
  dialogType: Schema.optional(Schema.Literal('default', 'alert')),
88
85
  dialogBlockAlign: Schema.optional(Schema.Literal('start', 'center', 'end')),
89
86
  dialogOverlayClasses: Schema.optional(Schema.String),
90
87
  dialogOverlayStyle: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Any })),
91
88
  /** Data to be passed to the dialog Surface. */
92
- dialogContent: Schema.optional(Schema.Any),
93
-
89
+ dialogContent: Schema.NullOr(Schema.Struct({ component: Schema.String, props: Schema.optional(Schema.Any) })),
94
90
  popoverOpen: Schema.Boolean,
95
91
  popoverSide: Schema.optional(Schema.Literal('top', 'right', 'bottom', 'left')),
96
92
  popoverAnchor: Schema.optional(Schema.Any),
97
93
  popoverAnchorId: Schema.optional(Schema.String),
94
+ popoverKind: Schema.optional(Schema.Literal('base', 'card')),
95
+ popoverTitle: Schema.optional(Label.annotations({ description: 'The title of the popover.' })),
96
+ /** Ref of the subject to be passed to the popover Surface. */
97
+ popoverContentRef: Schema.optional(Schema.String),
98
98
  /** Data to be passed to the popover Surface. */
99
- popoverContent: Schema.optional(Schema.Any),
100
-
101
- toasts: Schema.mutable(Schema.Array(LayoutAction.Toast)),
99
+ popoverContent: Schema.NullOr(
100
+ Schema.Union(
101
+ Schema.Struct({ component: Schema.String, props: Schema.optional(Schema.Any) }),
102
+ Schema.Struct({ subject: Schema.Any }),
103
+ ),
104
+ ),
105
+ toasts: Schema.mutable(Schema.Array(LayoutOperation.Toast)),
102
106
  currentUndoId: Schema.optional(Schema.String),
103
-
104
- activeDeck: Schema.String,
105
- previousDeck: Schema.String,
106
- decks: Schema.mutable(Schema.Record({ key: Schema.String, value: Schema.mutable(DeckState) })),
107
- previousMode: Schema.mutable(Schema.Record({ key: Schema.String, value: LayoutMode })),
108
- deck: Schema.mutable(DeckState),
109
-
110
107
  /** The identifier of a component to scroll into view when it is mounted. */
111
108
  scrollIntoView: Schema.optional(Schema.String),
112
109
  }).pipe(Schema.mutable);
110
+ export type EphemeralDeckState = Schema.Schema.Type<typeof EphemeralDeckState>;
113
111
 
114
- export type DeckPluginState = Schema.Schema.Type<typeof DeckPluginState>;
112
+ // Combined state type (for convenience in components that need both).
113
+ export type DeckPluginState = StoredDeckState & EphemeralDeckState;
115
114
 
116
115
  export namespace DeckAction {
117
116
  const PartAdjustmentSchema = Schema.Union(
@@ -127,24 +126,16 @@ export namespace DeckAction {
127
126
  export type Adjustment = Schema.Schema.Type<typeof Adjustment>;
128
127
 
129
128
  // An atomic transaction to apply to the deck, describing which element to move to which location.
130
- export class Adjust extends Schema.TaggedClass<Adjust>()(`${meta.id}/action/adjust`, {
129
+ export class Adjust extends Schema.TaggedClass<Adjust>()(`${meta.id}.action.adjust`, {
131
130
  input: Adjustment,
132
131
  output: Schema.Void,
133
132
  }) {}
134
133
 
135
- export class UpdatePlankSize extends Schema.TaggedClass<UpdatePlankSize>()(`${meta.id}/action/update-plank-size`, {
134
+ export class UpdatePlankSize extends Schema.TaggedClass<UpdatePlankSize>()(`${meta.id}.action.update-plank-size`, {
136
135
  input: Schema.Struct({
137
136
  id: Schema.String,
138
137
  size: Schema.Number,
139
138
  }),
140
139
  output: Schema.Void,
141
140
  }) {}
142
-
143
- export class ChangeCompanion extends Schema.TaggedClass<ChangeCompanion>()(`${meta.id}/action/change-companion`, {
144
- input: Schema.Struct({
145
- primary: Schema.String,
146
- companion: Schema.Union(Schema.String, Schema.Null),
147
- }),
148
- output: Schema.Void,
149
- }) {}
150
141
  }
package/src/util/index.ts CHANGED
@@ -3,5 +3,6 @@
3
3
  //
4
4
 
5
5
  export * from './layoutAppliesTopbar';
6
- export * from './overscroll';
6
+ export * from './plank-url-params';
7
+ export * from './sanitize-persisted-state';
7
8
  export * from './set-active';
@@ -2,11 +2,11 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { type LayoutMode } from '../types';
5
+ import { type LayoutMode } from '#types';
6
6
 
7
7
  export const layoutAppliesTopbar = (breakpoint: string, layoutMode?: LayoutMode) => {
8
8
  return (
9
- document.body.getAttribute('data-platform') === 'win' &&
9
+ document.body.getAttribute('data-platform') === 'windows' &&
10
10
  breakpoint === 'desktop' &&
11
11
  layoutMode !== 'solo--fullscreen'
12
12
  );