@dxos/plugin-kanban 0.8.4-main.3eb6e50203 → 0.8.4-main.3fbcb4aa9b

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 (297) hide show
  1. package/dist/lib/neutral/KanbanContainer-QK6LNCYT.mjs +132 -0
  2. package/dist/lib/neutral/KanbanContainer-QK6LNCYT.mjs.map +7 -0
  3. package/dist/lib/neutral/KanbanPlugin.mjs +36 -0
  4. package/dist/lib/neutral/KanbanPlugin.mjs.map +7 -0
  5. package/dist/lib/neutral/KanbanPlugin.node.mjs +27 -0
  6. package/dist/lib/neutral/KanbanPlugin.node.mjs.map +7 -0
  7. package/dist/lib/neutral/KanbanSettings-G6M47NSK.mjs +83 -0
  8. package/dist/lib/neutral/KanbanSettings-G6M47NSK.mjs.map +7 -0
  9. package/dist/lib/neutral/blueprint-definition-FHVIEKTQ.mjs +15 -0
  10. package/dist/lib/neutral/blueprint-definition-FHVIEKTQ.mjs.map +7 -0
  11. package/dist/lib/neutral/blueprints/index.mjs +8 -0
  12. package/dist/lib/neutral/capabilities/index.mjs +19 -0
  13. package/dist/lib/neutral/capabilities/index.mjs.map +7 -0
  14. package/dist/lib/neutral/chunk-E65AME5F.mjs +255 -0
  15. package/dist/lib/neutral/chunk-E65AME5F.mjs.map +7 -0
  16. package/dist/lib/neutral/chunk-KDPM77BD.mjs +21 -0
  17. package/dist/lib/neutral/chunk-KDPM77BD.mjs.map +7 -0
  18. package/dist/lib/neutral/chunk-Z7O5CETK.mjs +8 -0
  19. package/dist/lib/neutral/chunk-Z7O5CETK.mjs.map +7 -0
  20. package/dist/lib/neutral/chunk-ZTQW5KQS.mjs +26 -0
  21. package/dist/lib/neutral/chunk-ZTQW5KQS.mjs.map +7 -0
  22. package/dist/lib/neutral/components/index.mjs +243 -0
  23. package/dist/lib/neutral/components/index.mjs.map +7 -0
  24. package/dist/lib/neutral/containers/index.mjs +11 -0
  25. package/dist/lib/neutral/containers/index.mjs.map +7 -0
  26. package/dist/lib/neutral/create-object-DKBSI46K.mjs +40 -0
  27. package/dist/lib/neutral/create-object-DKBSI46K.mjs.map +7 -0
  28. package/dist/lib/neutral/delete-card-QKT6OXGP.mjs +24 -0
  29. package/dist/lib/neutral/delete-card-QKT6OXGP.mjs.map +7 -0
  30. package/dist/lib/neutral/delete-card-field-XQKM7ZXE.mjs +42 -0
  31. package/dist/lib/neutral/delete-card-field-XQKM7ZXE.mjs.map +7 -0
  32. package/dist/lib/neutral/hooks/index.mjs +432 -0
  33. package/dist/lib/neutral/hooks/index.mjs.map +7 -0
  34. package/dist/lib/neutral/index.mjs +34 -0
  35. package/dist/lib/neutral/meta.json +1 -0
  36. package/dist/lib/neutral/meta.mjs +8 -0
  37. package/dist/lib/neutral/migrations-4NS6H7U2.mjs +31 -0
  38. package/dist/lib/neutral/migrations-4NS6H7U2.mjs.map +7 -0
  39. package/dist/lib/neutral/operation-handler-B7IW6MXU.mjs +13 -0
  40. package/dist/lib/neutral/operation-handler-B7IW6MXU.mjs.map +7 -0
  41. package/dist/lib/neutral/operations/index.mjs +8 -0
  42. package/dist/lib/neutral/plugin.mjs +16 -0
  43. package/dist/lib/neutral/plugin.mjs.map +7 -0
  44. package/dist/lib/neutral/react-surface-6RVSCHMJ.mjs +93 -0
  45. package/dist/lib/neutral/react-surface-6RVSCHMJ.mjs.map +7 -0
  46. package/dist/lib/neutral/restore-card-XW7AHMPO.mjs +21 -0
  47. package/dist/lib/neutral/restore-card-XW7AHMPO.mjs.map +7 -0
  48. package/dist/lib/neutral/restore-card-field-QOAUY3RJ.mjs +40 -0
  49. package/dist/lib/neutral/restore-card-field-QOAUY3RJ.mjs.map +7 -0
  50. package/dist/lib/neutral/testing/index.mjs +60 -0
  51. package/dist/lib/neutral/testing/index.mjs.map +7 -0
  52. package/dist/lib/neutral/translations.mjs +44 -0
  53. package/dist/lib/neutral/translations.mjs.map +7 -0
  54. package/dist/lib/neutral/types/index.mjs +22 -0
  55. package/dist/lib/neutral/undo-mappings-6CHW6BOF.mjs +42 -0
  56. package/dist/lib/neutral/undo-mappings-6CHW6BOF.mjs.map +7 -0
  57. package/dist/types/src/KanbanPlugin.d.ts +1 -0
  58. package/dist/types/src/KanbanPlugin.d.ts.map +1 -1
  59. package/dist/types/src/KanbanPlugin.node.d.ts +4 -0
  60. package/dist/types/src/KanbanPlugin.node.d.ts.map +1 -0
  61. package/dist/types/src/KanbanPlugin.test.d.ts +2 -0
  62. package/dist/types/src/KanbanPlugin.test.d.ts.map +1 -0
  63. package/dist/types/src/blueprints/index.d.ts +1 -1
  64. package/dist/types/src/blueprints/index.d.ts.map +1 -1
  65. package/dist/types/src/blueprints/kanban-blueprint.d.ts +3 -21
  66. package/dist/types/src/blueprints/kanban-blueprint.d.ts.map +1 -1
  67. package/dist/types/src/capabilities/{artifact-definition/artifact-definition.d.ts → artifact-definition.d.ts} +1 -1
  68. package/dist/types/src/capabilities/artifact-definition.d.ts.map +1 -0
  69. package/dist/types/src/capabilities/blueprint-definition.d.ts +6 -0
  70. package/dist/types/src/capabilities/blueprint-definition.d.ts.map +1 -0
  71. package/dist/types/src/capabilities/create-object.d.ts +11 -0
  72. package/dist/types/src/capabilities/create-object.d.ts.map +1 -0
  73. package/dist/types/src/capabilities/index.d.ts +13 -3
  74. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  75. package/dist/types/src/capabilities/migrations.d.ts +5 -0
  76. package/dist/types/src/capabilities/migrations.d.ts.map +1 -0
  77. package/dist/types/src/capabilities/operation-handler.d.ts +6 -0
  78. package/dist/types/src/capabilities/operation-handler.d.ts.map +1 -0
  79. package/dist/types/src/capabilities/react-surface.d.ts +5 -0
  80. package/dist/types/src/capabilities/react-surface.d.ts.map +1 -0
  81. package/dist/types/src/capabilities/undo-mappings.d.ts +5 -0
  82. package/dist/types/src/capabilities/undo-mappings.d.ts.map +1 -0
  83. package/dist/types/src/components/KanbanBoard/KanbanBoard.d.ts +37 -0
  84. package/dist/types/src/components/KanbanBoard/KanbanBoard.d.ts.map +1 -0
  85. package/dist/types/src/components/KanbanBoard/KanbanBoard.stories.d.ts +72 -0
  86. package/dist/types/src/components/KanbanBoard/KanbanBoard.stories.d.ts.map +1 -0
  87. package/dist/types/src/components/KanbanBoard/KanbanCard.d.ts +9 -0
  88. package/dist/types/src/components/KanbanBoard/KanbanCard.d.ts.map +1 -0
  89. package/dist/types/src/components/KanbanBoard/KanbanColumn.d.ts +8 -0
  90. package/dist/types/src/components/KanbanBoard/KanbanColumn.d.ts.map +1 -0
  91. package/dist/types/src/components/KanbanBoard/context.d.ts +38 -0
  92. package/dist/types/src/components/KanbanBoard/context.d.ts.map +1 -0
  93. package/dist/types/src/components/KanbanBoard/index.d.ts +2 -0
  94. package/dist/types/src/components/KanbanBoard/index.d.ts.map +1 -0
  95. package/dist/types/src/components/index.d.ts +1 -2
  96. package/dist/types/src/components/index.d.ts.map +1 -1
  97. package/dist/types/src/containers/KanbanContainer/KanbanContainer.d.ts +6 -0
  98. package/dist/types/src/containers/KanbanContainer/KanbanContainer.d.ts.map +1 -0
  99. package/dist/types/src/containers/KanbanContainer/KanbanContainer.stories.d.ts +79 -0
  100. package/dist/types/src/containers/KanbanContainer/KanbanContainer.stories.d.ts.map +1 -0
  101. package/dist/types/src/containers/KanbanContainer/index.d.ts +2 -0
  102. package/dist/types/src/containers/KanbanContainer/index.d.ts.map +1 -0
  103. package/dist/types/src/containers/KanbanSettings/KanbanSettings.d.ts +13 -0
  104. package/dist/types/src/containers/KanbanSettings/KanbanSettings.d.ts.map +1 -0
  105. package/dist/types/src/containers/KanbanSettings/index.d.ts +2 -0
  106. package/dist/types/src/containers/KanbanSettings/index.d.ts.map +1 -0
  107. package/dist/types/src/containers/index.d.ts +4 -0
  108. package/dist/types/src/containers/index.d.ts.map +1 -0
  109. package/dist/types/src/hooks/index.d.ts +7 -0
  110. package/dist/types/src/hooks/index.d.ts.map +1 -0
  111. package/dist/types/src/hooks/useEchoChangeCallback.d.ts +13 -0
  112. package/dist/types/src/hooks/useEchoChangeCallback.d.ts.map +1 -0
  113. package/dist/types/src/hooks/useItemsProjection.d.ts +10 -0
  114. package/dist/types/src/hooks/useItemsProjection.d.ts.map +1 -0
  115. package/dist/types/src/hooks/useKanbanBoardModel.browser.test.d.ts +2 -0
  116. package/dist/types/src/hooks/useKanbanBoardModel.browser.test.d.ts.map +1 -0
  117. package/dist/types/src/hooks/useKanbanBoardModel.d.ts +16 -0
  118. package/dist/types/src/hooks/useKanbanBoardModel.d.ts.map +1 -0
  119. package/dist/types/src/hooks/useKanbanColumnEventHandler.d.ts +22 -0
  120. package/dist/types/src/hooks/useKanbanColumnEventHandler.d.ts.map +1 -0
  121. package/dist/types/src/hooks/useKanbanItemEventHandler.d.ts +19 -0
  122. package/dist/types/src/hooks/useKanbanItemEventHandler.d.ts.map +1 -0
  123. package/dist/types/src/hooks/useProjectionModel.d.ts +15 -0
  124. package/dist/types/src/hooks/useProjectionModel.d.ts.map +1 -0
  125. package/dist/types/src/index.d.ts +3 -1
  126. package/dist/types/src/index.d.ts.map +1 -1
  127. package/dist/types/src/operations/delete-card-field.d.ts +5 -0
  128. package/dist/types/src/operations/delete-card-field.d.ts.map +1 -0
  129. package/dist/types/src/operations/delete-card.d.ts +5 -0
  130. package/dist/types/src/operations/delete-card.d.ts.map +1 -0
  131. package/dist/types/src/operations/index.d.ts +3 -0
  132. package/dist/types/src/operations/index.d.ts.map +1 -0
  133. package/dist/types/src/operations/restore-card-field.d.ts +5 -0
  134. package/dist/types/src/operations/restore-card-field.d.ts.map +1 -0
  135. package/dist/types/src/operations/restore-card.d.ts +5 -0
  136. package/dist/types/src/operations/restore-card.d.ts.map +1 -0
  137. package/dist/types/src/playwright/board-manager.d.ts +5 -0
  138. package/dist/types/src/playwright/board-manager.d.ts.map +1 -0
  139. package/dist/types/src/playwright/playwright.config.d.ts +3 -0
  140. package/dist/types/src/playwright/playwright.config.d.ts.map +1 -0
  141. package/dist/types/src/playwright/smoke.spec.d.ts +2 -0
  142. package/dist/types/src/playwright/smoke.spec.d.ts.map +1 -0
  143. package/dist/types/src/plugin.d.ts +4 -0
  144. package/dist/types/src/plugin.d.ts.map +1 -0
  145. package/dist/types/src/testing/KanbanCardTileSimple.d.ts +7 -0
  146. package/dist/types/src/testing/KanbanCardTileSimple.d.ts.map +1 -0
  147. package/dist/types/src/testing/index.d.ts +2 -0
  148. package/dist/types/src/testing/index.d.ts.map +1 -0
  149. package/dist/types/src/translations.d.ts +48 -32
  150. package/dist/types/src/translations.d.ts.map +1 -1
  151. package/dist/types/src/types/Kanban.d.ts +109 -0
  152. package/dist/types/src/types/Kanban.d.ts.map +1 -0
  153. package/dist/types/src/types/KanbanOperation.d.ts +52 -0
  154. package/dist/types/src/types/KanbanOperation.d.ts.map +1 -0
  155. package/dist/types/src/types/constants.d.ts +6 -0
  156. package/dist/types/src/types/constants.d.ts.map +1 -0
  157. package/dist/types/src/types/index.d.ts +3 -0
  158. package/dist/types/src/types/index.d.ts.map +1 -1
  159. package/dist/types/src/types/migrations.test.d.ts +2 -0
  160. package/dist/types/src/types/migrations.test.d.ts.map +1 -0
  161. package/dist/types/src/types/schema.d.ts +15 -104
  162. package/dist/types/src/types/schema.d.ts.map +1 -1
  163. package/dist/types/src/types/types.d.ts +28 -0
  164. package/dist/types/src/types/types.d.ts.map +1 -1
  165. package/dist/types/src/util/arrangement.d.ts +72 -0
  166. package/dist/types/src/util/arrangement.d.ts.map +1 -0
  167. package/dist/types/src/util/arrangement.test.d.ts +2 -0
  168. package/dist/types/src/util/arrangement.test.d.ts.map +1 -0
  169. package/dist/types/src/util/index.d.ts +2 -0
  170. package/dist/types/src/util/index.d.ts.map +1 -0
  171. package/dist/types/tsconfig.tsbuildinfo +1 -1
  172. package/package.json +109 -62
  173. package/src/KanbanPlugin.node.ts +21 -0
  174. package/src/KanbanPlugin.test.ts +31 -0
  175. package/src/KanbanPlugin.tsx +22 -32
  176. package/src/blueprints/index.ts +1 -1
  177. package/src/blueprints/kanban-blueprint.ts +12 -9
  178. package/src/capabilities/{artifact-definition/artifact-definition.ts → artifact-definition.ts} +11 -10
  179. package/src/capabilities/blueprint-definition.ts +19 -0
  180. package/src/capabilities/create-object.ts +40 -0
  181. package/src/capabilities/index.ts +13 -3
  182. package/src/capabilities/migrations.ts +35 -0
  183. package/src/capabilities/operation-handler.ts +14 -0
  184. package/src/capabilities/{react-surface/react-surface.tsx → react-surface.tsx} +25 -17
  185. package/src/capabilities/undo-mappings.ts +34 -0
  186. package/src/components/KanbanBoard/KanbanBoard.stories.tsx +146 -0
  187. package/src/components/KanbanBoard/KanbanBoard.tsx +164 -0
  188. package/src/components/KanbanBoard/KanbanCard.tsx +101 -0
  189. package/src/components/KanbanBoard/KanbanColumn.tsx +72 -0
  190. package/src/components/KanbanBoard/context.ts +54 -0
  191. package/src/components/KanbanBoard/index.ts +5 -0
  192. package/src/components/index.ts +1 -2
  193. package/src/{components → containers/KanbanContainer}/KanbanContainer.stories.tsx +90 -99
  194. package/src/containers/KanbanContainer/KanbanContainer.tsx +178 -0
  195. package/src/containers/KanbanContainer/index.ts +5 -0
  196. package/src/containers/KanbanSettings/KanbanSettings.tsx +94 -0
  197. package/src/containers/KanbanSettings/index.ts +5 -0
  198. package/src/containers/index.ts +8 -0
  199. package/src/hooks/index.ts +10 -0
  200. package/src/hooks/useEchoChangeCallback.ts +30 -0
  201. package/src/hooks/useItemsProjection.ts +44 -0
  202. package/src/hooks/useKanbanBoardModel.browser.test.ts +235 -0
  203. package/src/hooks/useKanbanBoardModel.ts +157 -0
  204. package/src/hooks/useKanbanColumnEventHandler.ts +106 -0
  205. package/src/hooks/useKanbanItemEventHandler.ts +133 -0
  206. package/src/hooks/useProjectionModel.ts +58 -0
  207. package/src/index.ts +3 -2
  208. package/src/meta.ts +1 -1
  209. package/src/operations/delete-card-field.ts +47 -0
  210. package/src/operations/delete-card.ts +23 -0
  211. package/src/operations/index.ts +10 -0
  212. package/src/operations/restore-card-field.ts +41 -0
  213. package/src/operations/restore-card.ts +21 -0
  214. package/src/playwright/board-manager.ts +13 -0
  215. package/src/playwright/playwright.config.ts +19 -0
  216. package/src/playwright/smoke.spec.ts +107 -0
  217. package/src/plugin.ts +11 -0
  218. package/src/testing/KanbanCardTileSimple.tsx +82 -0
  219. package/src/testing/index.ts +5 -0
  220. package/src/translations.ts +26 -18
  221. package/src/types/Kanban.ts +151 -0
  222. package/src/types/KanbanOperation.ts +67 -0
  223. package/src/types/constants.ts +9 -0
  224. package/src/types/index.ts +4 -0
  225. package/src/types/migrations.test.ts +83 -0
  226. package/src/types/schema.ts +20 -78
  227. package/src/types/types.ts +35 -0
  228. package/src/util/arrangement.test.ts +218 -0
  229. package/src/util/arrangement.ts +177 -0
  230. package/src/util/index.ts +5 -0
  231. package/dist/lib/browser/blueprint-definition-GGL6Y5GN.mjs +0 -18
  232. package/dist/lib/browser/blueprint-definition-GGL6Y5GN.mjs.map +0 -7
  233. package/dist/lib/browser/blueprints/index.mjs +0 -8
  234. package/dist/lib/browser/chunk-L6N4ZDZ7.mjs +0 -35
  235. package/dist/lib/browser/chunk-L6N4ZDZ7.mjs.map +0 -7
  236. package/dist/lib/browser/chunk-XYQO4VL7.mjs +0 -150
  237. package/dist/lib/browser/chunk-XYQO4VL7.mjs.map +0 -7
  238. package/dist/lib/browser/index.mjs +0 -99
  239. package/dist/lib/browser/index.mjs.map +0 -7
  240. package/dist/lib/browser/meta.json +0 -1
  241. package/dist/lib/browser/operation-resolver-RFQU4VAB.mjs +0 -162
  242. package/dist/lib/browser/operation-resolver-RFQU4VAB.mjs.map +0 -7
  243. package/dist/lib/browser/react-surface-FZQDOE3J.mjs +0 -237
  244. package/dist/lib/browser/react-surface-FZQDOE3J.mjs.map +0 -7
  245. package/dist/lib/browser/types/index.mjs +0 -14
  246. package/dist/lib/node-esm/blueprint-definition-AMIOYZSF.mjs +0 -19
  247. package/dist/lib/node-esm/blueprint-definition-AMIOYZSF.mjs.map +0 -7
  248. package/dist/lib/node-esm/blueprints/index.mjs +0 -9
  249. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +0 -11
  250. package/dist/lib/node-esm/chunk-NN6JMKIT.mjs +0 -152
  251. package/dist/lib/node-esm/chunk-NN6JMKIT.mjs.map +0 -7
  252. package/dist/lib/node-esm/chunk-ZHRMUKTF.mjs +0 -36
  253. package/dist/lib/node-esm/chunk-ZHRMUKTF.mjs.map +0 -7
  254. package/dist/lib/node-esm/index.mjs +0 -100
  255. package/dist/lib/node-esm/index.mjs.map +0 -7
  256. package/dist/lib/node-esm/meta.json +0 -1
  257. package/dist/lib/node-esm/operation-resolver-J4JUSY74.mjs +0 -163
  258. package/dist/lib/node-esm/operation-resolver-J4JUSY74.mjs.map +0 -7
  259. package/dist/lib/node-esm/react-surface-KOQ56TL6.mjs +0 -238
  260. package/dist/lib/node-esm/react-surface-KOQ56TL6.mjs.map +0 -7
  261. package/dist/lib/node-esm/types/index.mjs +0 -15
  262. package/dist/types/src/capabilities/artifact-definition/artifact-definition.d.ts.map +0 -1
  263. package/dist/types/src/capabilities/artifact-definition/index.d.ts +0 -3
  264. package/dist/types/src/capabilities/artifact-definition/index.d.ts.map +0 -1
  265. package/dist/types/src/capabilities/blueprint-definition/blueprint-definition.d.ts +0 -10
  266. package/dist/types/src/capabilities/blueprint-definition/blueprint-definition.d.ts.map +0 -1
  267. package/dist/types/src/capabilities/blueprint-definition/index.d.ts +0 -3
  268. package/dist/types/src/capabilities/blueprint-definition/index.d.ts.map +0 -1
  269. package/dist/types/src/capabilities/operation-resolver/index.d.ts +0 -3
  270. package/dist/types/src/capabilities/operation-resolver/index.d.ts.map +0 -1
  271. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts +0 -5
  272. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts.map +0 -1
  273. package/dist/types/src/capabilities/react-surface/index.d.ts +0 -3
  274. package/dist/types/src/capabilities/react-surface/index.d.ts.map +0 -1
  275. package/dist/types/src/capabilities/react-surface/react-surface.d.ts +0 -5
  276. package/dist/types/src/capabilities/react-surface/react-surface.d.ts.map +0 -1
  277. package/dist/types/src/components/KanbanContainer.d.ts +0 -6
  278. package/dist/types/src/components/KanbanContainer.d.ts.map +0 -1
  279. package/dist/types/src/components/KanbanContainer.stories.d.ts +0 -75
  280. package/dist/types/src/components/KanbanContainer.stories.d.ts.map +0 -1
  281. package/dist/types/src/components/KanbanViewEditor.d.ts +0 -8
  282. package/dist/types/src/components/KanbanViewEditor.d.ts.map +0 -1
  283. package/src/capabilities/artifact-definition/index.ts +0 -7
  284. package/src/capabilities/blueprint-definition/blueprint-definition.ts +0 -24
  285. package/src/capabilities/blueprint-definition/index.ts +0 -7
  286. package/src/capabilities/operation-resolver/index.ts +0 -7
  287. package/src/capabilities/operation-resolver/operation-resolver.ts +0 -133
  288. package/src/capabilities/react-surface/index.ts +0 -7
  289. package/src/components/KanbanContainer.tsx +0 -87
  290. package/src/components/KanbanViewEditor.tsx +0 -59
  291. /package/dist/lib/{browser → neutral}/blueprints/index.mjs.map +0 -0
  292. /package/dist/lib/{browser → neutral}/chunk-J5LGTIGS.mjs +0 -0
  293. /package/dist/lib/{browser → neutral}/chunk-J5LGTIGS.mjs.map +0 -0
  294. /package/dist/lib/{browser/types → neutral}/index.mjs.map +0 -0
  295. /package/dist/lib/{node-esm/blueprints/index.mjs.map → neutral/meta.mjs.map} +0 -0
  296. /package/dist/lib/{node-esm/types → neutral/operations}/index.mjs.map +0 -0
  297. /package/dist/lib/{node-esm/chunk-HSLMI22Q.mjs.map → neutral/types/index.mjs.map} +0 -0
@@ -5,43 +5,46 @@
5
5
  import { RegistryContext } from '@effect-atom/atom-react';
6
6
  import { type Decorator, type Meta, type StoryObj } from '@storybook/react-vite';
7
7
  import * as Effect from 'effect/Effect';
8
- import React, { useCallback, useContext } from 'react';
8
+ import React, { useCallback, useContext, useMemo } from 'react';
9
9
  import { expect, waitFor, within } from 'storybook/test';
10
10
 
11
11
  import { withPluginManager } from '@dxos/app-framework/testing';
12
+ import { Surface } from '@dxos/app-framework/ui';
13
+ import { AppSurface } from '@dxos/app-toolkit/ui';
12
14
  import { Obj, type QueryAST, Type } from '@dxos/echo';
15
+ import { View } from '@dxos/echo';
13
16
  import { type Mutable } from '@dxos/echo/internal';
14
17
  import { invariant } from '@dxos/invariant';
15
- import { ClientPlugin } from '@dxos/plugin-client';
16
- import { PreviewPlugin } from '@dxos/plugin-preview';
17
- import { useGlobalFilteredObjects } from '@dxos/plugin-search';
18
- import { SpacePlugin } from '@dxos/plugin-space';
18
+ // `/plugin` entrypoints used here for the same reason as `corePlugins()` —
19
+ // see `@dxos/plugin-testing/src/core.ts` for the rationale.
20
+ import { ClientPlugin } from '@dxos/plugin-client/testing';
21
+ import { initializeIdentity } from '@dxos/plugin-client/testing';
22
+ import { PreviewPlugin } from '@dxos/plugin-preview/testing';
23
+ import { SpacePlugin } from '@dxos/plugin-space/testing';
19
24
  import { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';
20
- import { faker } from '@dxos/random';
25
+ import { random } from '@dxos/random';
21
26
  import { Filter, type Space, useQuery, useSchema, useSpaces } from '@dxos/react-client/echo';
22
- import { withTheme } from '@dxos/react-ui/testing';
23
27
  import { ViewEditor } from '@dxos/react-ui-form';
24
- import {
25
- Kanban as KanbanComponent,
26
- translations as kanbanTranslations,
27
- useKanbanModel,
28
- useProjectionModel,
29
- } from '@dxos/react-ui-kanban';
30
- import { Kanban } from '@dxos/react-ui-kanban/types';
31
- import { JsonFilter } from '@dxos/react-ui-syntax-highlighter';
32
- import { View, getTypenameFromQuery } from '@dxos/schema';
28
+ import { Syntax } from '@dxos/react-ui-syntax-highlighter';
29
+ import { withLayout } from '@dxos/react-ui/testing';
30
+ import { ViewModel, getTypenameFromQuery } from '@dxos/schema';
31
+ // TODO(wittjosiah): Replace with echo/testing.
33
32
  import { Organization, Person } from '@dxos/types';
34
33
 
35
- import { translations } from '../translations';
34
+ import { useProjectionModel } from '#hooks';
35
+ import { translations } from '#translations';
36
+ import { Kanban } from '#types';
36
37
 
37
- faker.seed(0);
38
+ import { KanbanPlugin } from '../../KanbanPlugin';
38
39
 
39
- const createOrg = () => ({
40
- name: faker.commerce.productName(),
41
- description: faker.lorem.paragraph(),
42
- image: faker.image.url(),
43
- website: faker.internet.url(),
44
- status: faker.helpers.arrayElement(Organization.StatusOptions).id as Organization.Organization['status'],
40
+ random.seed(0);
41
+
42
+ const createOrg = (status?: Organization.Organization['status']) => ({
43
+ name: random.commerce.productName(),
44
+ description: random.lorem.paragraph(),
45
+ image: random.image.url(),
46
+ website: random.internet.url(),
47
+ status: (status ?? random.helpers.arrayElement(Organization.StatusOptions).id) as Organization.Organization['status'],
45
48
  });
46
49
 
47
50
  //
@@ -49,12 +52,13 @@ const createOrg = () => ({
49
52
  //
50
53
 
51
54
  type ClientSetupOptions = {
52
- types?: Type.Entity.Any[];
55
+ types?: Type.AnyEntity[];
53
56
  onSpaceCreated?: (space: Space) => Promise<void>;
54
57
  };
55
58
 
56
59
  /**
57
60
  * Creates the standard plugin manager decorator with client configuration.
61
+ * Includes KanbanPlugin so the Surface resolves to KanbanContainer.
58
62
  */
59
63
  const withKanbanPlugins = ({ types = [], onSpaceCreated }: ClientSetupOptions): Decorator =>
60
64
  withPluginManager({
@@ -64,7 +68,7 @@ const withKanbanPlugins = ({ types = [], onSpaceCreated }: ClientSetupOptions):
64
68
  types: [...types, View.View, Kanban.Kanban],
65
69
  onClientInitialized: ({ client }) =>
66
70
  Effect.gen(function* () {
67
- yield* Effect.promise(() => client.halo.createIdentity());
71
+ yield* initializeIdentity(client);
68
72
  const space = yield* Effect.promise(() => client.spaces.create());
69
73
  yield* Effect.promise(() => space.waitUntilReady());
70
74
  yield* Effect.promise(() => onSpaceCreated?.(space) ?? Promise.resolve());
@@ -73,61 +77,39 @@ const withKanbanPlugins = ({ types = [], onSpaceCreated }: ClientSetupOptions):
73
77
  PreviewPlugin(),
74
78
  SpacePlugin({}),
75
79
  StorybookPlugin({}),
80
+ KanbanPlugin(),
76
81
  ],
77
82
  });
78
83
 
79
- //
80
- // Story components.
81
- //
82
-
84
+ /**
85
+ * Renders the first Kanban in the space via Surface (resolves to KanbanContainer),
86
+ * with a sidebar containing ViewEditor and Json filter.
87
+ */
83
88
  const DefaultComponent = () => {
84
89
  const registry = useContext(RegistryContext);
85
90
  const spaces = useSpaces();
86
91
  const space = spaces[spaces.length - 1];
87
- const [object] = useQuery(space?.db, Filter.type(Kanban.Kanban));
88
- const typename = object?.view.target?.query ? getTypenameFromQuery(object.view.target.query.ast) : undefined;
92
+ const [kanban] = useQuery(space?.db, Filter.type(Kanban.Kanban));
93
+ const viewRef = kanban && kanban.spec.kind === 'view' ? kanban.spec.view : undefined;
94
+ const view = viewRef?.target;
95
+ const typename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
89
96
  const schema = useSchema(space?.db, typename);
97
+ const projection = useProjectionModel(schema, kanban, registry);
90
98
 
91
- const objects = useQuery(space?.db, schema ? Filter.type(schema) : Filter.nothing());
92
- const filteredObjects = useGlobalFilteredObjects(objects);
93
-
94
- const projection = useProjectionModel(schema, object, registry);
95
- const model = useKanbanModel({
96
- object,
97
- projection,
98
- items: filteredObjects,
99
- });
100
-
101
- const handleAddCard = useCallback(
102
- (columnValue: string | undefined) => {
103
- const path = model?.columnFieldPath;
104
- if (space && schema && Type.isObjectSchema(schema) && path) {
105
- const card = Obj.make(schema, {
106
- ...createOrg(),
107
- [path]: columnValue,
108
- });
109
-
110
- space.db.add(card);
111
- return card.id;
112
- }
113
- },
114
- [space, schema, model],
115
- );
116
-
117
- const handleRemoveCard = useCallback((card: { id: string }) => Obj.isObject(card) && space?.db.remove(card), [space]);
99
+ const data = useMemo(() => (kanban ? { subject: kanban, attendableId: 'story' } : undefined), [kanban]);
118
100
 
119
101
  const handleUpdateQuery = useCallback(
120
102
  (newQuery: QueryAST.Query) => {
121
103
  invariant(schema);
122
- invariant(Type.isMutable(schema));
123
- invariant(object.view.target);
124
-
125
- schema.updateTypename(getTypenameFromQuery(newQuery));
126
- Obj.change(object.view.target, (v) => {
127
- v.query.ast = newQuery as Mutable<typeof newQuery>;
104
+ invariant(view);
105
+ if (Type.isMutable(schema)) {
106
+ schema.updateTypename(getTypenameFromQuery(newQuery));
107
+ }
108
+ Obj.update(view, (view) => {
109
+ view.query.ast = newQuery as Mutable<QueryAST.Query>;
128
110
  });
129
111
  },
130
- [object, schema],
112
+ [view, schema],
131
113
  );
132
114
 
133
115
  const handleDeleteField = useCallback(
@@ -139,23 +121,29 @@ const DefaultComponent = () => {
139
121
  [schema, projection],
140
122
  );
141
123
 
142
- if (!schema || !object.view.target) {
124
+ if (!schema || !view) {
143
125
  return null;
144
126
  }
145
127
 
146
128
  return (
147
- <div className='grow grid grid-cols-[1fr_350px] overflow-hidden'>
148
- {model ? <KanbanComponent model={model} onAddCard={handleAddCard} onRemoveCard={handleRemoveCard} /> : <div />}
149
- <div className='flex flex-col bs-full overflow-hidden border-l border-separator'>
129
+ <div className='grow grid grid-cols-[1fr_350px] overflow-hidden h-full w-full'>
130
+ <Surface.Surface type={AppSurface.Article} data={data} limit={1} />
131
+ <div className='flex flex-col h-full overflow-hidden border-l border-separator'>
150
132
  <ViewEditor
151
- classNames='p-2'
152
133
  registry={space?.db.schemaRegistry}
153
134
  schema={schema}
154
- view={object.view.target}
135
+ view={view}
155
136
  onQueryChanged={handleUpdateQuery}
156
- onDelete={Type.isMutable(schema) ? handleDeleteField : undefined}
137
+ onDelete={schema && Type.isMutable(schema) ? handleDeleteField : undefined}
157
138
  />
158
- <JsonFilter data={{ view: object.view.target, schema }} classNames='text-xs' />
139
+ <Syntax.Root data={{ view, schema }}>
140
+ <Syntax.Content>
141
+ <Syntax.Filter />
142
+ <Syntax.Viewport>
143
+ <Syntax.Code classNames='text-xs' />
144
+ </Syntax.Viewport>
145
+ </Syntax.Content>
146
+ </Syntax.Root>
159
147
  </div>
160
148
  </div>
161
149
  );
@@ -166,13 +154,13 @@ const DefaultComponent = () => {
166
154
  //
167
155
 
168
156
  const meta = {
169
- title: 'plugins/plugin-kanban/Kanban',
157
+ title: 'plugins/plugin-kanban/containers/Kanban',
170
158
  component: DefaultComponent,
171
159
  render: () => <DefaultComponent />,
172
- decorators: [withTheme()],
160
+ decorators: [withLayout({ layout: 'fullscreen' })],
173
161
  parameters: {
174
162
  layout: 'fullscreen',
175
- translations: [...translations, ...kanbanTranslations],
163
+ translations,
176
164
  },
177
165
  } satisfies Meta<typeof DefaultComponent>;
178
166
 
@@ -189,7 +177,7 @@ export const Default: Story = {
189
177
  withKanbanPlugins({
190
178
  types: [Organization.Organization, Person.Person],
191
179
  onSpaceCreated: async (space) => {
192
- const { view } = await View.makeFromDatabase({
180
+ const { view } = await ViewModel.makeFromDatabase({
193
181
  db: space.db,
194
182
  typename: Organization.Organization.typename,
195
183
  pivotFieldName: 'status',
@@ -197,8 +185,7 @@ export const Default: Story = {
197
185
  const kanban = Kanban.make({ view });
198
186
  space.db.add(kanban);
199
187
 
200
- // TODO(burdon): Replace with sdk/schema/testing.
201
- Array.from({ length: 80 }).map(() => {
188
+ Array.from({ length: 10 }).map(() => {
202
189
  return space.db.add(Obj.make(Organization.Organization, createOrg()));
203
190
  });
204
191
  },
@@ -209,25 +196,24 @@ export const Default: Story = {
209
196
 
210
197
  // Wait for the kanban columns to render by finding the status tags.
211
198
  // Organization.StatusOptions: prospect, qualified, active, commit, reject.
212
- const activeTag = await canvas.findByText('Active', undefined, { timeout: 30_000 });
213
- const prospectTag = await canvas.findByText('Prospect', undefined, { timeout: 10_000 });
214
- const commitTag = await canvas.findByText('Commit', undefined, { timeout: 10_000 });
199
+ const activeTag = await canvas.findByText('Active', undefined, { timeout: 12_000 });
200
+ const prospectTag = await canvas.findByText('Prospect', undefined, { timeout: 12_000 });
201
+ const commitTag = await canvas.findByText('Commit', undefined, { timeout: 12_000 });
215
202
 
216
203
  // Verify all expected columns are rendered.
217
204
  await expect(activeTag).toBeTruthy();
218
205
  await expect(prospectTag).toBeTruthy();
219
206
  await expect(commitTag).toBeTruthy();
220
207
 
221
- // Find the column containers.
222
- const activeColumn = activeTag.closest('[data-dx-stack-item]') as HTMLElement;
223
- const prospectColumn = prospectTag.closest('[data-dx-stack-item]') as HTMLElement;
208
+ // Find the column containers (Board uses data-testid="board-column").
209
+ const activeColumn = activeTag.closest('[data-testid="board-column"]') as HTMLElement;
210
+ const prospectColumn = prospectTag.closest('[data-testid="board-column"]') as HTMLElement;
224
211
  await expect(activeColumn).toBeTruthy();
225
212
  await expect(prospectColumn).toBeTruthy();
226
213
 
227
- // Wait for cards to render in the columns.
228
- // Cards have data-dx-item-id attribute from StackItem.Root.
214
+ // Wait for cards to render in the columns (Board items use data-testid="board-item").
229
215
  const getColumnCards = (column: HTMLElement) =>
230
- Array.from(column.querySelectorAll('[data-dx-item-id]')) as HTMLElement[];
216
+ Array.from(column.querySelectorAll('[data-testid="board-item"]')) as HTMLElement[];
231
217
 
232
218
  await waitFor(() => expect(getColumnCards(activeColumn).length).toBeGreaterThan(0));
233
219
 
@@ -237,16 +223,16 @@ export const Default: Story = {
237
223
  await expect(activeCards.length).toBeGreaterThan(0);
238
224
  await expect(prospectCards.length).toBeGreaterThan(0);
239
225
 
240
- // Verify cards have drag handles (first button in toolbar).
226
+ // Verify cards have drag handles (Card.Toolbar includes drag handle).
241
227
  const firstActiveCard = activeCards[0];
242
228
  const buttons = firstActiveCard.querySelectorAll('button');
243
229
  await expect(buttons.length).toBeGreaterThan(0);
244
230
 
245
- // Verify the drop zone exists in each column.
246
- const activeDropZone = activeColumn.querySelector('.kanban-drop');
247
- const prospectDropZone = prospectColumn.querySelector('.kanban-drop');
248
- await expect(activeDropZone).toBeTruthy();
249
- await expect(prospectDropZone).toBeTruthy();
231
+ // Verify add-card action exists in columns (optional footer).
232
+ const activeAddItem = activeColumn.querySelector('[data-testid="board-column-add-item"]');
233
+ const prospectAddItem = prospectColumn.querySelector('[data-testid="board-column-add-item"]');
234
+ await expect(activeAddItem).toBeTruthy();
235
+ await expect(prospectAddItem).toBeTruthy();
250
236
 
251
237
  // TODO(wittjosiah): Get drag & drop tests working.
252
238
  // See packages/apps/composer-app/src/playwright/stack.spec.ts for reference.
@@ -268,7 +254,7 @@ export const MutableSchema: Story = {
268
254
  // Register schema in the database to make it mutable (EchoSchema).
269
255
  const [schema] = await space.db.schemaRegistry.register([Organization.Organization]);
270
256
 
271
- const { view } = await View.makeFromDatabase({
257
+ const { view } = await ViewModel.makeFromDatabase({
272
258
  db: space.db,
273
259
  typename: schema.typename,
274
260
  pivotFieldName: 'status',
@@ -277,9 +263,14 @@ export const MutableSchema: Story = {
277
263
  space.db.add(kanban);
278
264
 
279
265
  // Create test data using the registered schema.
280
- Array.from({ length: 80 }).map(() => {
281
- return space.db.add(Obj.make(schema, createOrg()));
282
- });
266
+ const requiredOrgs = [
267
+ ...Array.from({ length: 2 }, () => createOrg('prospect')),
268
+ ...Array.from({ length: 5 }, () => createOrg('qualified')),
269
+ ...Array.from({ length: 1 }, () => createOrg('active')),
270
+ ...Array.from({ length: 1 }, () => createOrg('commit')),
271
+ ...Array.from({ length: 1 }, () => createOrg('reject')),
272
+ ];
273
+ requiredOrgs.forEach((org) => space.db.add(Obj.make(schema, org)));
283
274
  },
284
275
  }),
285
276
  ],
@@ -0,0 +1,178 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import { Atom, RegistryContext } from '@effect-atom/atom-react';
6
+ import React, { useCallback, useContext, useMemo } from 'react';
7
+
8
+ import { useCapabilities, useOperationInvoker } from '@dxos/app-framework/ui';
9
+ import { AppCapabilities } from '@dxos/app-toolkit';
10
+ import { type AppSurface } from '@dxos/app-toolkit/ui';
11
+ import { Filter, Obj, Query, type Ref, Type } from '@dxos/echo';
12
+ import { AtomObj, AtomQuery } from '@dxos/echo-atom';
13
+ import { useObject, useSchema } from '@dxos/react-client/echo';
14
+ import { Panel, Toolbar } from '@dxos/react-ui';
15
+ import { getTagFromQuery, getTypenameFromQuery } from '@dxos/schema';
16
+
17
+ import { KanbanBoard } from '#components';
18
+ import { useEchoChangeCallback, useItemsProjection, useProjectionModel } from '#hooks';
19
+ import { KanbanOperation } from '#types';
20
+ import { Kanban } from '#types';
21
+
22
+ export type KanbanContainerProps = AppSurface.ObjectArticleProps<Kanban.Kanban>;
23
+
24
+ export const KanbanContainer = (props: KanbanContainerProps) => {
25
+ // Branch on `kanban.spec.kind`: view-variant runs a typename query through
26
+ // `useProjectionModel`; items-variant dereferences `kanban.spec.items` and
27
+ // uses a stub projection from `useItemsProjection`.
28
+ return Kanban.isKanbanItems(props.subject) ? (
29
+ <ItemsKanbanContainer {...props} subject={props.subject} />
30
+ ) : (
31
+ <ViewKanbanContainer {...props} />
32
+ );
33
+ };
34
+
35
+ const ViewKanbanContainer = ({ role, subject: object }: KanbanContainerProps) => {
36
+ const registry = useContext(RegistryContext);
37
+ const schemas = useCapabilities(AppCapabilities.Schema);
38
+ const db = Obj.getDatabase(object);
39
+ const { invokePromise } = useOperationInvoker();
40
+ const [view] = useObject(object.spec.kind === 'view' ? object.spec.view : undefined);
41
+ const typename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
42
+ const tag = view?.query ? getTagFromQuery(view.query.ast) : undefined;
43
+
44
+ const schemaFromDb = useSchema(db, typename);
45
+ const cardSchema = useMemo(
46
+ () => schemaFromDb ?? schemas.flat().find((schema) => Type.getTypename(schema) === typename),
47
+ [schemaFromDb, schemas, typename],
48
+ );
49
+
50
+ const items = useMemo(() => {
51
+ if (!db) {
52
+ return null;
53
+ }
54
+ const baseFilter = cardSchema ? Filter.type(cardSchema) : Filter.nothing();
55
+ const query = tag ? Query.select(baseFilter).select(Filter.tag(tag)) : Query.select(baseFilter);
56
+ return AtomQuery.make(db, query);
57
+ }, [db, cardSchema, tag]);
58
+
59
+ const projection = useProjectionModel(cardSchema, object, registry);
60
+ const change = useEchoChangeCallback(object);
61
+
62
+ const pivotFieldId = view?.projection?.pivotFieldId;
63
+ const columnFieldPath =
64
+ projection && pivotFieldId ? projection.tryGetFieldProjection(pivotFieldId)?.props.property : undefined;
65
+
66
+ const handleCardAdd = useCallback(
67
+ (columnValue: string | undefined) => {
68
+ if (db && cardSchema && columnFieldPath) {
69
+ const card = Obj.make(cardSchema, { [columnFieldPath]: columnValue });
70
+ db.add(card);
71
+ return card.id;
72
+ }
73
+ },
74
+ [db, cardSchema, columnFieldPath],
75
+ );
76
+
77
+ const handleCardRemove = useCallback(
78
+ (card: { id: string }) => {
79
+ void invokePromise(KanbanOperation.DeleteCard, { card });
80
+ },
81
+ [invokePromise],
82
+ );
83
+
84
+ if (!object || !db || !items || !projection || !change) {
85
+ return null;
86
+ }
87
+
88
+ return (
89
+ <Panel.Root role={role}>
90
+ <Panel.Toolbar asChild>
91
+ <Toolbar.Root />
92
+ </Panel.Toolbar>
93
+ <KanbanBoard.Root
94
+ kanban={object}
95
+ projection={projection}
96
+ items={items}
97
+ change={change}
98
+ onCardAdd={handleCardAdd}
99
+ onCardRemove={handleCardRemove}
100
+ >
101
+ <Panel.Content asChild>
102
+ <KanbanBoard.Content />
103
+ </Panel.Content>
104
+ </KanbanBoard.Root>
105
+ </Panel.Root>
106
+ );
107
+ };
108
+
109
+ type ItemsKanbanContainerProps = Omit<KanbanContainerProps, 'subject'> & { subject: Kanban.KanbanItems };
110
+
111
+ const ItemsKanbanContainer = ({ role, subject: object }: ItemsKanbanContainerProps) => {
112
+ const db = Obj.getDatabase(object);
113
+ const projection = useItemsProjection(object);
114
+ const change = useEchoChangeCallback(object);
115
+
116
+ // TODO(wittjosiah): pass refs (not loaded objects) through to the kanban
117
+ // board and let `KanbanCard` subscribe to its own ref via `useObject`.
118
+ // Today this atom subscribes to *every* item — any one changing causes the
119
+ // container (and the model's per-column atoms) to recompute. With cards
120
+ // subscribing themselves, the container only needs the refs and the
121
+ // per-card render is independent. Requires:
122
+ // - `KanbanCard` to accept `Ref<Obj.Unknown>` as `data` and call
123
+ // `useObject(ref)` internally.
124
+ // - The model to handle a ref-bearing item shape (id from
125
+ // `ref.dxn.asEchoDXN()?.echoId`) and use arrangement-only ordering
126
+ // for items-variant (no pivot-value fallback, since refs don't expose
127
+ // the pivot field without loading).
128
+ // - `Mosaic.isItem` to accept the ref wrapper alongside `Obj.isObject`.
129
+ const itemsAtom = useMemo(
130
+ () =>
131
+ Atom.make((get) => {
132
+ const out: Obj.Unknown[] = [];
133
+ for (const ref of object.spec.items as ReadonlyArray<Ref.Ref<Obj.Unknown>>) {
134
+ const target = get(AtomObj.make(ref));
135
+ if (target == null) {
136
+ continue;
137
+ }
138
+ // Drop soft-deleted cards (e.g. Trello-closed cards). The ref
139
+ // stays in `spec.items` so arrangement is preserved, but the card
140
+ // shouldn't render.
141
+ if (Obj.isDeleted(target)) {
142
+ continue;
143
+ }
144
+ out.push(target as unknown as Obj.Unknown);
145
+ }
146
+ return out;
147
+ }),
148
+ [object.spec.items],
149
+ );
150
+
151
+ const handleCardRemove = useCallback(() => undefined, []);
152
+
153
+ if (!object || !db || !change) {
154
+ return null;
155
+ }
156
+
157
+ // TODO(wittjosiah): wire `onCardAdd` to the create-object flow so
158
+ // users can add items directly from the kanban (currently the column's
159
+ // "+" button is hidden because `onCardAdd` is undefined).
160
+ return (
161
+ <Panel.Root role={role}>
162
+ <Panel.Toolbar asChild>
163
+ <Toolbar.Root />
164
+ </Panel.Toolbar>
165
+ <KanbanBoard.Root
166
+ kanban={object}
167
+ projection={projection}
168
+ items={itemsAtom}
169
+ change={change}
170
+ onCardRemove={handleCardRemove}
171
+ >
172
+ <Panel.Content asChild>
173
+ <KanbanBoard.Content />
174
+ </Panel.Content>
175
+ </KanbanBoard.Root>
176
+ </Panel.Root>
177
+ );
178
+ };
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ export { KanbanContainer as default } from './KanbanContainer';
@@ -0,0 +1,94 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { RegistryContext } from '@effect-atom/atom-react';
6
+ import React, { useCallback, useContext, useMemo } from 'react';
7
+
8
+ import { type AppSurface } from '@dxos/app-toolkit/ui';
9
+ import { Obj } from '@dxos/echo';
10
+ import { Format } from '@dxos/echo/internal';
11
+ import { useObject, useSchema } from '@dxos/react-client/echo';
12
+ import { Form, type FormFieldMap, SelectField } from '@dxos/react-ui-form';
13
+ import { getTypenameFromQuery } from '@dxos/schema';
14
+
15
+ import { useProjectionModel } from '#hooks';
16
+ import { type Kanban, KanbanSettingsSchema, KanbanViewSettingsSchema, UNCATEGORIZED_VALUE } from '#types';
17
+
18
+ export type KanbanSettingsProps = AppSurface.ObjectPropertiesProps<Kanban.Kanban>;
19
+
20
+ /**
21
+ * Settings panel for a Kanban. Renders fields common to every kanban
22
+ * (currently the "Hide uncategorized column" toggle); for view-variant
23
+ * kanbans an additional "Column field" picker drives the View's pivot
24
+ * field. Items-variant kanbans use a hardcoded `spec.pivotField`, so that
25
+ * field is omitted there.
26
+ */
27
+ export const KanbanSettings = ({ subject: object }: KanbanSettingsProps) => {
28
+ const registry = useContext(RegistryContext);
29
+ const db = Obj.getDatabase(object);
30
+ const isView = object.spec.kind === 'view';
31
+ const [view, updateView] = useObject(object.spec.kind === 'view' ? object.spec.view : undefined);
32
+ const [, updateKanban] = useObject(object);
33
+ const currentTypename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
34
+ const schema = useSchema(db, currentTypename);
35
+ const projection = useProjectionModel(schema, object, registry);
36
+
37
+ const fieldProjections = projection?.getFieldProjections() ?? [];
38
+ const selectFields = useMemo(
39
+ () =>
40
+ fieldProjections
41
+ .filter((field) => field.props.format === Format.TypeFormat.SingleSelect)
42
+ .map(({ field }) => ({ value: field.id, label: field.path })),
43
+ [fieldProjections],
44
+ );
45
+
46
+ const hideUncategorized = object.arrangement.columns[UNCATEGORIZED_VALUE]?.hidden ?? false;
47
+
48
+ const handleValuesChanged = useCallback(
49
+ (values: Partial<{ columnFieldId: string; hideUncategorized: boolean }>) => {
50
+ if (isView && values.columnFieldId != null) {
51
+ updateView((view) => {
52
+ view.projection.pivotFieldId = values.columnFieldId!;
53
+ });
54
+ }
55
+ if (values.hideUncategorized !== undefined) {
56
+ updateKanban((kanban) => {
57
+ const existing = kanban.arrangement.columns[UNCATEGORIZED_VALUE];
58
+ if (existing) {
59
+ existing.hidden = values.hideUncategorized;
60
+ } else {
61
+ kanban.arrangement.columns[UNCATEGORIZED_VALUE] = {
62
+ ids: [],
63
+ hidden: values.hideUncategorized,
64
+ };
65
+ }
66
+ });
67
+ }
68
+ },
69
+ [isView, updateView, updateKanban],
70
+ );
71
+
72
+ const initialValues = useMemo(
73
+ () => ({
74
+ ...(isView ? { columnFieldId: view?.projection.pivotFieldId } : {}),
75
+ hideUncategorized,
76
+ }),
77
+ [isView, view?.projection.pivotFieldId, hideUncategorized],
78
+ );
79
+
80
+ const fieldMap: FormFieldMap = useMemo(
81
+ () => ({ columnFieldId: (props) => <SelectField {...props} options={selectFields} /> }),
82
+ [selectFields],
83
+ );
84
+
85
+ // Schema is picked by `kanban.spec.kind` — they have different shapes,
86
+ // so cast for `Form.Root`'s single-schema prop.
87
+ const settingsSchema = (isView ? KanbanViewSettingsSchema : KanbanSettingsSchema) as any;
88
+
89
+ return (
90
+ <Form.Root schema={settingsSchema} values={initialValues} fieldMap={fieldMap} onValuesChanged={handleValuesChanged}>
91
+ <Form.FieldSet />
92
+ </Form.Root>
93
+ );
94
+ };
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export { KanbanSettings as default } from './KanbanSettings';
@@ -0,0 +1,8 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import { type ComponentType, lazy } from 'react';
6
+
7
+ export const KanbanContainer: ComponentType<any> = lazy(() => import('./KanbanContainer'));
8
+ export const KanbanSettings: ComponentType<any> = lazy(() => import('./KanbanSettings'));
@@ -0,0 +1,10 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ export * from './useEchoChangeCallback';
6
+ export * from './useItemsProjection';
7
+ export * from './useKanbanBoardModel';
8
+ export * from './useKanbanColumnEventHandler';
9
+ export * from './useKanbanItemEventHandler';
10
+ export * from './useProjectionModel';
@@ -0,0 +1,30 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { useMemo } from 'react';
6
+
7
+ import { Obj } from '@dxos/echo';
8
+
9
+ import { type Kanban, type KanbanChangeCallback } from '#types';
10
+
11
+ /**
12
+ * Creates a change callback for ECHO-backed kanban and items (plain function, no hooks).
13
+ * Use this when the kanban and items are stored in the ECHO database.
14
+ */
15
+ export const createEchoChangeCallback = <T extends Obj.Unknown>(kanban: Kanban.Kanban): KanbanChangeCallback<T> => ({
16
+ kanban: (mutate) => Obj.update(kanban, (kanban) => mutate(kanban)),
17
+ setItemField: (item, field, value) => {
18
+ Obj.update(item, (item: any) => {
19
+ item[field] = value;
20
+ });
21
+ },
22
+ });
23
+
24
+ /**
25
+ * Returns a memoized ECHO change callback for the given kanban.
26
+ * Returns null when kanban is undefined.
27
+ */
28
+ export const useEchoChangeCallback = <T extends Obj.Unknown = Obj.Unknown>(
29
+ kanban: Kanban.Kanban | undefined,
30
+ ): KanbanChangeCallback<T> | null => useMemo(() => (kanban ? createEchoChangeCallback<T>(kanban) : null), [kanban]);