@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,82 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import React, { useEffect, useMemo, useState } from 'react';
6
+
7
+ import { TimeoutError } from '@dxos/errors';
8
+ import { log } from '@dxos/log';
9
+ import { type Node } from '@dxos/plugin-graph';
10
+ import { ErrorFallback, type ErrorFallbackProps, useTranslation } from '@dxos/react-ui';
11
+ import { descriptionMessage, mx } from '@dxos/ui-theme';
12
+
13
+ import { meta } from '#meta';
14
+
15
+ import { PlankHeading, type PlankHeadingProps } from './PlankHeading';
16
+ import { PlankLoading } from './PlankLoading';
17
+
18
+ export const PlankError = ({
19
+ id,
20
+ part,
21
+ node,
22
+ error: errorProp,
23
+ }: {
24
+ id: string;
25
+ part: PlankHeadingProps['part'];
26
+ node?: Node.Node;
27
+ error?: Error;
28
+ }) => {
29
+ const [timedOut, setTimedOut] = useState(false);
30
+ useEffect(() => {
31
+ const timer = setTimeout(() => setTimedOut(true), 5_000);
32
+ return () => clearTimeout(timer);
33
+ }, []);
34
+
35
+ const error = useMemo(() => {
36
+ if (timedOut) {
37
+ return new TimeoutError({ message: 'Timeout loading content' });
38
+ }
39
+
40
+ return errorProp;
41
+ }, [timedOut, errorProp]);
42
+
43
+ return (
44
+ <>
45
+ <PlankHeading id={id} part={part} node={node} pending={!timedOut} />
46
+ {timedOut ? <PlankErrorFallback error={error} /> : <PlankLoading />}
47
+ </>
48
+ );
49
+ };
50
+
51
+ /**
52
+ * User facing error fallback.
53
+ */
54
+ export const PlankErrorFallback = ({ error }: ErrorFallbackProps) => {
55
+ const { t } = useTranslation(meta.id);
56
+
57
+ useEffect(() => {
58
+ if (error) {
59
+ log.error('plank error', { error });
60
+ }
61
+ }, [error]);
62
+
63
+ if (process.env.NODE_ENV === 'development') {
64
+ return <ErrorFallback title='Plank Error' error={error} />;
65
+ } else {
66
+ const errorString = error?.toString() ?? '';
67
+
68
+ return (
69
+ <div
70
+ role='alert'
71
+ data-testid='plank-content-error'
72
+ className='dx-attention-surface overflow-y-auto p-8 grid place-items-center'
73
+ >
74
+ <div className='flex flex-col items-center gap-2'>
75
+ <p className={mx(descriptionMessage, 'break-all rounded-md p-4')}>
76
+ {error ? errorString : t('error-fallback.message')}
77
+ </p>
78
+ </div>
79
+ </div>
80
+ );
81
+ }
82
+ };
@@ -4,21 +4,22 @@
4
4
 
5
5
  import React, { Fragment, type MouseEvent, memo, useCallback, useEffect, useMemo } from 'react';
6
6
 
7
- import { LayoutAction, createIntent } from '@dxos/app-framework';
8
- import { Surface, useAppGraph, useIntentDispatcher } from '@dxos/app-framework/react';
9
- import { type Node } from '@dxos/plugin-graph';
7
+ import { Surface } from '@dxos/app-framework/ui';
8
+ import { AppSurface } from '@dxos/app-toolkit/ui';
9
+ import { Graph, type Node, useActionRunner } from '@dxos/plugin-graph';
10
10
  import { Icon, IconButton, Popover, toLocalizedString, useTranslation } from '@dxos/react-ui';
11
+ import { getLinkedVariant } from '@dxos/react-ui-attention';
11
12
  import { StackItem, type StackItemSigilAction } from '@dxos/react-ui-stack';
12
13
  import { TextTooltip } from '@dxos/react-ui-text-tooltip';
13
- import { hoverableControls, hoverableFocusedWithinControls } from '@dxos/react-ui-theme';
14
+ import { hoverableControls, hoverableFocusedWithinControls, iconSize } from '@dxos/ui-theme';
14
15
 
15
- import { useBreakpoints } from '../../hooks';
16
- import { parseEntryId } from '../../layout';
17
- import { meta } from '../../meta';
18
- import { DeckAction, type LayoutMode, PLANK_COMPANION_TYPE, type ResolvedPart } from '../../types';
19
- import { soloInlinePadding } from '../fragments';
16
+ import { useBreakpoints } from '#hooks';
17
+ import { meta } from '#meta';
18
+ import { DeckOperation } from '#types';
19
+ import { type LayoutMode, PLANK_COMPANION_TYPE, type ResolvedPart } from '#types';
20
20
 
21
21
  import { PlankCompanionControls, PlankControls } from './PlankControls';
22
+ import { usePlankContext } from './PlankRoot';
22
23
 
23
24
  const MAX_COMPANIONS = 5;
24
25
 
@@ -26,7 +27,7 @@ export type PlankHeadingProps = {
26
27
  id: string;
27
28
  part: ResolvedPart;
28
29
  layoutMode?: LayoutMode;
29
- node?: Node;
30
+ node?: Node.Node;
30
31
  deckEnabled?: boolean;
31
32
  canIncrementStart?: boolean;
32
33
  canIncrementEnd?: boolean;
@@ -34,8 +35,9 @@ export type PlankHeadingProps = {
34
35
  primaryId?: string;
35
36
  pending?: boolean;
36
37
  companioned?: 'primary' | 'companion';
37
- companions?: Node[];
38
+ companions?: Node.Node[];
38
39
  actions?: StackItemSigilAction[];
40
+ debug?: boolean;
39
41
  };
40
42
 
41
43
  export const PlankHeading = memo(
@@ -53,15 +55,16 @@ export const PlankHeading = memo(
53
55
  companions,
54
56
  layoutMode,
55
57
  actions = [],
58
+ debug = false,
56
59
  }: PlankHeadingProps) => {
57
60
  const { t } = useTranslation(meta.id);
58
- const { dispatchPromise: dispatch } = useIntentDispatcher();
59
- const { graph } = useAppGraph();
61
+ const { graph, onAdjust, onUpdateCompanion } = usePlankContext('PlankHeading');
62
+ const runAction = useActionRunner();
60
63
  const breakpoint = useBreakpoints();
61
- const icon = node?.properties?.icon ?? 'ph--placeholder--regular';
64
+ const icon = node?.properties?.icon ?? 'ph--circle-dashed--regular';
62
65
  const label = pending
63
- ? t('pending heading')
64
- : toLocalizedString(node?.properties?.label ?? ['plank heading fallback label', { ns: meta.id }], t);
66
+ ? t('pending.heading')
67
+ : toLocalizedString(node?.properties?.label ?? ['plank-heading-fallback.label', { ns: meta.id }], t);
65
68
 
66
69
  const isCompanionNode = node?.type === PLANK_COMPANION_TYPE;
67
70
 
@@ -69,7 +72,7 @@ export const PlankHeading = memo(
69
72
  const frame = requestAnimationFrame(() => {
70
73
  // Load actions for the node.
71
74
  if (node) {
72
- void graph.expand(node.id);
75
+ void Graph.expand(graph, node.id, 'child');
73
76
  }
74
77
  });
75
78
 
@@ -80,16 +83,16 @@ export const PlankHeading = memo(
80
83
  const capabilities = useMemo(
81
84
  () => ({
82
85
  deck: deckEnabled ?? true,
83
- solo: breakpoint !== 'mobile' && (part === 'solo' || part === 'deck'),
86
+ solo: breakpoint !== 'mobile' && (part === 'solo' || part === 'multi'),
84
87
  incrementStart: canIncrementStart,
85
88
  incrementEnd: canIncrementEnd,
86
89
  fullscreen: !isCompanionNode,
87
- companion: !isCompanionNode && companions && companions.length > 0,
90
+ companion: layoutMode !== 'multi' && !isCompanionNode && companions && companions.length > 0,
88
91
  }),
89
- [breakpoint, part, companions, canIncrementStart, canIncrementEnd, isCompanionNode, deckEnabled],
92
+ [breakpoint, part, companions, canIncrementStart, canIncrementEnd, isCompanionNode, deckEnabled, layoutMode],
90
93
  );
91
94
 
92
- const { variant } = parseEntryId(id);
95
+ const variant = isCompanionNode ? getLinkedVariant(id) : undefined;
93
96
  const sigilActions = useMemo(() => {
94
97
  if (!node) {
95
98
  return undefined;
@@ -98,81 +101,67 @@ export const PlankHeading = memo(
98
101
  } else {
99
102
  return [
100
103
  actions,
101
- graph
102
- .getActions(node.id)
103
- .filter((a) => ['list-item', 'list-item-primary', 'heading-list-item'].includes(a.properties.disposition)),
104
+ Graph.getActions(graph, node.id).filter((action) =>
105
+ ['list-item', 'list-item-primary', 'heading-list-item'].includes(action.properties.disposition),
106
+ ),
104
107
  ].filter((a) => a.length > 0);
105
108
  }
106
109
  }, [actions, node, variant, graph]);
107
110
 
108
111
  const handleAction = useCallback(
109
112
  (action: StackItemSigilAction) => {
110
- typeof action.data === 'function' && void action.data?.({ parent: node, caller: meta.id });
113
+ if (typeof action.data === 'function') {
114
+ void runAction(action as Node.Action, { parent: node, caller: meta.id });
115
+ }
111
116
  },
112
- [node],
117
+ [node, runAction],
113
118
  );
114
119
 
115
120
  const handlePlankAction = useCallback(
116
- (eventType: DeckAction.PartAdjustment) => {
117
- if (eventType.startsWith('solo')) {
118
- return dispatch(createIntent(DeckAction.Adjust, { type: eventType, id }));
119
- } else if (eventType === 'close') {
120
- if (part === 'complementary') {
121
- return dispatch(
122
- createIntent(LayoutAction.UpdateComplementary, {
123
- part: 'complementary',
124
- options: { state: 'collapsed' },
125
- }),
126
- );
127
- } else {
128
- return dispatch(
129
- createIntent(LayoutAction.Close, { part: 'main', subject: [id], options: { state: false } }),
130
- );
131
- }
132
- } else {
133
- return dispatch(createIntent(DeckAction.Adjust, { type: eventType, id }));
134
- }
121
+ (eventType: DeckOperation.PartAdjustment) => {
122
+ onAdjust?.(id, eventType);
135
123
  },
136
- [dispatch, id, part],
124
+ [onAdjust, id],
137
125
  );
138
126
 
139
- const ActionRoot = node && popoverAnchorId === `dxos.org/ui/${meta.id}/${node.id}` ? Popover.Anchor : Fragment;
127
+ const ActionRoot = node && popoverAnchorId === `${meta.id}:${node.id}` ? Popover.Anchor : Fragment;
140
128
 
141
129
  const handleTabClick = useCallback(
142
130
  (event: MouseEvent) => {
143
131
  const target = (event.target as HTMLElement).closest('[data-id]') as HTMLElement | null;
144
132
  const tabId = target?.dataset?.id;
145
- if (primaryId && tabId) {
146
- void dispatch(
147
- createIntent(DeckAction.ChangeCompanion, {
148
- primary: primaryId,
149
- companion: tabId,
150
- }),
151
- );
133
+ if (tabId) {
134
+ onUpdateCompanion?.(tabId);
152
135
  }
153
136
  },
154
- [primaryId],
137
+ [onUpdateCompanion],
155
138
  );
156
139
 
157
140
  return (
158
141
  <StackItem.Heading
142
+ data-tauri-drag-region
143
+ data-plank-heading
144
+ style={iconSize(5)}
159
145
  classNames={[
160
- 'plb-1 items-stretch gap-1 sticky inline-start-12 app-drag min-is-0 contain-layout density-coarse',
161
- part === 'solo' ? soloInlinePadding : 'pli-1',
146
+ 'py-1 items-stretch gap-1 sticky left-12 dx-app-drag min-w-0 dx-contain-layout dx-density-lg',
147
+ part === 'solo'
148
+ ? 'ps-[calc(env(safe-area-inset-left)+.25rem)] pe-[calc(env(safe-area-inset-right)+.25rem)]'
149
+ : 'px-1',
162
150
  ...(layoutMode === 'solo--fullscreen'
163
151
  ? [
164
152
  hoverableControls,
165
153
  hoverableFocusedWithinControls,
166
- '*:transition-opacity *:opacity-[--controls-opacity] bg-transparent border-transparent transition-[background-color,border-color]',
167
- 'hover-hover:hover:bg-headerSurface focus-within:bg-headerSurface hover-hover:hover:border-subduedSeparator focus-within:border-subduedSeparator',
154
+ '*:transition-opacity *:opacity-(--controls-opacity) bg-transparent',
155
+ 'border-transparent transition-[background-color,border-color]',
156
+ 'hover-hover:hover:bg-header-surface focus-within:bg-header-surface',
157
+ 'hover-hover:hover:border-subdued-separator focus-within:border-subdued-separator',
168
158
  ]
169
159
  : []),
170
160
  ]}
171
- data-plank-heading
172
161
  >
173
162
  {companions && isCompanionNode ? (
174
163
  /* TODO(thure): IMPORTANT: This is a tablist; it should be implemented as such. */
175
- <div role='none' className='flex-1 min-is-0 overflow-x-auto scrollbar-none flex gap-1'>
164
+ <div data-tauri-drag-region className='flex-1 min-w-0 overflow-x-auto scrollbar-none flex gap-1'>
176
165
  {companions.map(({ id, properties: { icon, label } }) => (
177
166
  <IconButton
178
167
  key={id}
@@ -193,11 +182,14 @@ export const PlankHeading = memo(
193
182
  icon={icon}
194
183
  related={part === 'complementary'}
195
184
  attendableId={attendableId}
196
- triggerLabel={t('actions menu label')}
185
+ triggerLabel={t('actions-menu.label')}
197
186
  actions={sigilActions}
198
187
  onAction={handleAction}
199
188
  >
200
- <Surface role='menu-footer' data={{ subject: node.data }} />
189
+ <Surface.Surface
190
+ type={AppSurface.MenuFooter}
191
+ data={{ subject: node.data } satisfies AppSurface.MenuFooterData}
192
+ />
201
193
  </StackItem.Sigil>
202
194
  ) : (
203
195
  <StackItem.SigilButton>
@@ -208,6 +200,7 @@ export const PlankHeading = memo(
208
200
  </ActionRoot>
209
201
  <TextTooltip text={label} onlyWhenTruncating>
210
202
  <StackItem.HeadingLabel
203
+ data-tauri-drag-region
211
204
  attendableId={attendableId}
212
205
  related={part === 'complementary'}
213
206
  {...(pending && { classNames: 'text-description' })}
@@ -217,7 +210,17 @@ export const PlankHeading = memo(
217
210
  </TextTooltip>
218
211
  </>
219
212
  )}
220
- {node && part !== 'complementary' && <Surface role='navbar-end' data={{ subject: node.data }} />}
213
+ {debug && (
214
+ <div className='flex items-center text-sm text-info-text'>
215
+ {layoutMode}:{part}:{companioned}
216
+ </div>
217
+ )}
218
+ {node && part !== 'complementary' && (
219
+ <Surface.Surface
220
+ type={AppSurface.NavbarEnd}
221
+ data={{ subject: node.data } satisfies AppSurface.NavbarEndData}
222
+ />
223
+ )}
221
224
  {companioned === 'companion' ? (
222
225
  <PlankCompanionControls primary={primaryId} />
223
226
  ) : (
@@ -6,5 +6,5 @@ import React from 'react';
6
6
 
7
7
  // TODO(burdon): Show skeleton: https://github.com/dxos/dxos/issues/8259
8
8
  export const PlankLoading = () => {
9
- return <div role='none' className='grid place-items-center attention-surface' />;
9
+ return <div className='grid place-items-center dx-attention-surface' />;
10
10
  };
@@ -0,0 +1,49 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ import { createContext } from '@radix-ui/react-context';
6
+ import React, { PropsWithChildren } from 'react';
7
+
8
+ import { type Graph } from '@dxos/plugin-graph';
9
+
10
+ import { type DeckOperation } from '#types';
11
+ import { type LayoutMode, type PlankSizing, type ResolvedPart, type Settings } from '#types';
12
+
13
+ const PLANK_NAME = 'Plank';
14
+
15
+ export type PlankContextValue = {
16
+ /** The application graph. */
17
+ graph: Graph.ExpandableGraph;
18
+ /** Which part of the layout this plank occupies. */
19
+ part: ResolvedPart;
20
+ /** Current layout mode. */
21
+ layoutMode: LayoutMode;
22
+ /** Deck settings. */
23
+ settings?: Settings.Settings;
24
+ /** Popover anchor ID for heading menus. */
25
+ popoverAnchorId?: string;
26
+ /** ID of plank that should be scrolled into view. */
27
+ scrollIntoView?: string;
28
+ /** Persisted plank sizes keyed by plank ID. */
29
+ plankSizing?: PlankSizing;
30
+ /** Callback for plank adjustments (close, solo, increment, companion). */
31
+ onAdjust?: (id: string, type: DeckOperation.PartAdjustment) => void;
32
+ /** Callback for plank resize. */
33
+ onResize?: (id: string, size: number) => void;
34
+ /** Callback to clear scroll-into-view state. */
35
+ onScrollIntoView?: (id?: string) => void;
36
+ /** Callback to update the companion. */
37
+ onUpdateCompanion?: (companion: string | null) => void;
38
+ };
39
+
40
+ export const [PlankProvider, usePlankContext] = createContext<PlankContextValue>(PLANK_NAME);
41
+
42
+ export type PlankRootProps = PropsWithChildren<PlankContextValue>;
43
+
44
+ /**
45
+ * Headless root that provides plank context.
46
+ */
47
+ export const PlankRoot = ({ children, ...context }: PlankRootProps) => {
48
+ return <PlankProvider {...context}>{children}</PlankProvider>;
49
+ };
@@ -3,7 +3,5 @@
3
3
  //
4
4
 
5
5
  export * from './Plank';
6
- export * from './PlankControls';
7
6
  export * from './PlankError';
8
- export * from './PlankHeading';
9
7
  export * from './PlankLoading';
@@ -0,0 +1,192 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import React, { type MouseEvent, useCallback, useEffect, useMemo, useState } from 'react';
6
+
7
+ import { Surface, useOperationInvoker } from '@dxos/app-framework/ui';
8
+ import { LayoutOperation } from '@dxos/app-toolkit';
9
+ import { IconButton, type Label, Main, Panel, toLocalizedString, Toolbar, useTranslation } from '@dxos/react-ui';
10
+ import { getLinkedVariant } from '@dxos/react-ui-attention';
11
+ import { Tabs } from '@dxos/react-ui-tabs';
12
+ import { iconSize, mx } from '@dxos/ui-theme';
13
+
14
+ import { type DeckCompanion, useBreakpoints, useDeckCompanions, useDeckState } from '#hooks';
15
+ import { meta } from '#meta';
16
+ import { getMode } from '#types';
17
+
18
+ import { layoutAppliesTopbar } from '../../util';
19
+ import { PlankErrorFallback, PlankLoading } from '../Plank';
20
+ import { ToggleComplementarySidebarButton } from './SidebarButton';
21
+
22
+ const label = ['complementary-sidebar.title', { ns: meta.id }] satisfies Label;
23
+
24
+ export type ComplementarySidebarProps = {
25
+ current?: string;
26
+ };
27
+
28
+ export const ComplementarySidebar = ({ current }: ComplementarySidebarProps) => {
29
+ const { invokePromise } = useOperationInvoker();
30
+ const { t } = useTranslation(meta.id);
31
+ const { state, deck, updateState } = useDeckState();
32
+ const layoutMode = getMode(deck);
33
+ const breakpoint = useBreakpoints();
34
+ const topbar = layoutAppliesTopbar(breakpoint, layoutMode);
35
+
36
+ const companions = useDeckCompanions();
37
+ const activeCompanion = companions.find((companion) => getLinkedVariant(companion.id) === current);
38
+ const activeId = activeCompanion && getLinkedVariant(activeCompanion.id);
39
+ const [internalValue, setInternalValue] = useState(activeId);
40
+
41
+ useEffect(() => {
42
+ setInternalValue(activeId);
43
+ }, [activeId]);
44
+
45
+ const handleTabClick = useCallback(
46
+ (event: MouseEvent) => {
47
+ const nextValue = event.currentTarget.getAttribute('data-value') as string;
48
+ if (nextValue === activeId) {
49
+ updateState((state) => ({
50
+ ...state,
51
+ complementarySidebarState: state.complementarySidebarState === 'expanded' ? 'collapsed' : 'expanded',
52
+ }));
53
+ } else {
54
+ setInternalValue(nextValue);
55
+ updateState((state) => ({ ...state, complementarySidebarState: 'expanded' }));
56
+ void invokePromise(LayoutOperation.UpdateComplementary, { subject: nextValue });
57
+ }
58
+ },
59
+ [state.complementarySidebarState, activeId, invokePromise, updateState],
60
+ );
61
+
62
+ const data = useMemo(
63
+ () =>
64
+ activeCompanion && {
65
+ id: activeCompanion.id,
66
+ subject: activeCompanion.data,
67
+ },
68
+ [activeCompanion?.id, activeCompanion?.data],
69
+ );
70
+
71
+ useEffect(() => {
72
+ if (!activeId) {
73
+ void invokePromise(LayoutOperation.UpdateComplementary, { state: 'collapsed' });
74
+ }
75
+ }, [activeId, invokePromise]);
76
+
77
+ return (
78
+ <Main.ComplementarySidebar
79
+ label={label}
80
+ classNames={[topbar && 'top-[calc(env(safe-area-inset-top)+var(--dx-rail-size))]']}
81
+ >
82
+ {/* R0 Tabs */}
83
+ <Tabs.Root classNames='contents' orientation='vertical' value={internalValue}>
84
+ <div
85
+ data-tauri-drag-region
86
+ style={iconSize(5)}
87
+ className={mx(
88
+ 'absolute z-1 inset-y-0 end-0 w-(--dx-r0-size)!',
89
+ 'py-[env(safe-area-inset-top)] pb-[env(safe-area-inset-bottom)] border-s border-subdued-separator',
90
+ 'grid grid-cols-1 grid-rows-[1fr_min-content] bg-toolbar-surface dx-contain-layout dx-app-drag',
91
+ )}
92
+ >
93
+ {/* TODO(burdon): ScrollArea. */}
94
+ <Tabs.Tablist classNames='grid grid-cols-1 auto-rows-(--dx-rail-action) overflow-y-auto gap-1 p-1'>
95
+ {companions.map((companion) => (
96
+ <Tabs.Tab key={getLinkedVariant(companion.id)} value={getLinkedVariant(companion.id)} asChild>
97
+ <IconButton
98
+ classNames='w-(--dx-rail-action) h-(--dx-rail-action) min-h-0 px-0'
99
+ label={toLocalizedString(companion.properties.label, t)}
100
+ icon={companion.properties.icon}
101
+ iconOnly
102
+ tooltipSide='left'
103
+ data-value={getLinkedVariant(companion.id)}
104
+ {...(companion.properties.joyride && { 'data-joyride': companion.properties.joyride })}
105
+ variant={
106
+ activeId === getLinkedVariant(companion.id)
107
+ ? state.complementarySidebarState === 'expanded'
108
+ ? 'primary'
109
+ : 'ghost'
110
+ : 'ghost'
111
+ }
112
+ onClick={handleTabClick}
113
+ />
114
+ </Tabs.Tab>
115
+ ))}
116
+ </Tabs.Tablist>
117
+ <div
118
+ className='grid grid-cols-1 auto-rows-(--dx-rail-item) py-0.5 gap-0.5 overflow-y-auto scrollbar-none'
119
+ style={iconSize(4)}
120
+ >
121
+ <Surface.Surface role='status-indicator' />
122
+ </div>
123
+ <div className='hidden lg:grid grid-cols-1 auto-rows-(--dx-rail-action) p-1'>
124
+ <ToggleComplementarySidebarButton />
125
+ </div>
126
+ </div>
127
+
128
+ {/* R1 Content. */}
129
+ {activeId &&
130
+ companions.map((companion) => (
131
+ <Tabs.Panel
132
+ key={getLinkedVariant(companion.id)}
133
+ value={getLinkedVariant(companion.id)}
134
+ classNames={[
135
+ 'absolute data-[state="inactive"]:-z-[1] overflow-hidden',
136
+ 'inset-y-0 start-0 w-full lg:w-(--dx-r1-size)',
137
+ ]}
138
+ {...(state.complementarySidebarState !== 'expanded' && { inert: true })}
139
+ >
140
+ <ComplementarySidebarPanel companion={companion} activeId={activeId} data={data} />
141
+ </Tabs.Panel>
142
+ ))}
143
+ </Tabs.Root>
144
+ </Main.ComplementarySidebar>
145
+ );
146
+ };
147
+
148
+ type ComplementarySidebarPanelProps = {
149
+ companion: DeckCompanion;
150
+ activeId: string;
151
+ data?: {
152
+ id: string;
153
+ subject: any;
154
+ };
155
+ };
156
+
157
+ const ComplementarySidebarPanel = ({ companion, activeId, data }: ComplementarySidebarPanelProps) => {
158
+ const { t } = useTranslation(meta.id);
159
+
160
+ if (getLinkedVariant(companion.id) !== activeId && !data) {
161
+ return null;
162
+ }
163
+
164
+ return (
165
+ <Panel.Root>
166
+ <Panel.Toolbar asChild size='lg'>
167
+ <Toolbar.Root style={iconSize(5)} classNames='bg-modal-surface border-b border-subdued-separator'>
168
+ <IconButton
169
+ classNames='w-(--dx-rail-action) h-(--dx-rail-action) min-h-0 px-0'
170
+ label={toLocalizedString(companion.properties.label, t)}
171
+ icon={companion.properties.icon}
172
+ iconOnly
173
+ tooltipSide='left'
174
+ data-value={getLinkedVariant(companion.id)}
175
+ variant='default'
176
+ />
177
+ <div role='none' className='px-1'>
178
+ {toLocalizedString(companion.properties.label, t)}
179
+ </div>
180
+ </Toolbar.Root>
181
+ </Panel.Toolbar>
182
+ <Panel.Content classNames='bg-base-surface'>
183
+ <Surface.Surface
184
+ role={`deck-companion--${getLinkedVariant(companion.id)}`}
185
+ data={data}
186
+ fallback={PlankErrorFallback}
187
+ placeholder={<PlankLoading />}
188
+ />
189
+ </Panel.Content>
190
+ </Panel.Root>
191
+ );
192
+ };
@@ -0,0 +1,39 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import React, { useMemo } from 'react';
6
+
7
+ import { Surface } from '@dxos/app-framework/ui';
8
+ import { AppSurface } from '@dxos/app-toolkit/ui';
9
+ import { type Label, Main } from '@dxos/react-ui';
10
+
11
+ import { useBreakpoints, useDeckState } from '#hooks';
12
+ import { meta } from '#meta';
13
+ import { getMode } from '#types';
14
+
15
+ import { layoutAppliesTopbar } from '../../util';
16
+
17
+ const label = ['sidebar.title', { ns: meta.id }] satisfies Label;
18
+
19
+ export const Sidebar = () => {
20
+ const { state, deck } = useDeckState();
21
+ const { popoverAnchorId, activeDeck: current } = state;
22
+ const breakpoint = useBreakpoints();
23
+ const layoutMode = getMode(deck);
24
+ const topbar = layoutAppliesTopbar(breakpoint, layoutMode);
25
+
26
+ const navigationData = useMemo<AppSurface.NavigationData<{ topbar: boolean }>>(
27
+ () => ({ popoverAnchorId, topbar, current }),
28
+ [popoverAnchorId, topbar, current],
29
+ );
30
+
31
+ return (
32
+ <Main.NavigationSidebar
33
+ label={label}
34
+ classNames={['grid', topbar && 'top-[calc(env(safe-area-inset-top)+var(--dx-rail-size))]']}
35
+ >
36
+ <Surface.Surface type={AppSurface.Navigation} data={navigationData} limit={1} />
37
+ </Main.NavigationSidebar>
38
+ );
39
+ };