@dxos/plugin-kanban 0.8.4-main.f9ba587 → 0.8.4-main.fcc0d83b33

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 (238) hide show
  1. package/dist/lib/browser/blueprints/index.mjs +27 -0
  2. package/dist/lib/browser/blueprints/index.mjs.map +7 -0
  3. package/dist/lib/browser/chunk-J5LGTIGS.mjs +10 -0
  4. package/dist/lib/browser/chunk-J5LGTIGS.mjs.map +7 -0
  5. package/dist/lib/browser/chunk-T32TEM55.mjs +105 -0
  6. package/dist/lib/browser/chunk-T32TEM55.mjs.map +7 -0
  7. package/dist/lib/browser/delete-card-7OSCNCW2.mjs +24 -0
  8. package/dist/lib/browser/delete-card-7OSCNCW2.mjs.map +7 -0
  9. package/dist/lib/browser/delete-card-field-NSB2RE3Z.mjs +42 -0
  10. package/dist/lib/browser/delete-card-field-NSB2RE3Z.mjs.map +7 -0
  11. package/dist/lib/browser/index.mjs +76 -95
  12. package/dist/lib/browser/index.mjs.map +4 -4
  13. package/dist/lib/browser/meta.json +1 -1
  14. package/dist/lib/browser/operations/index.mjs +13 -0
  15. package/dist/lib/browser/operations/index.mjs.map +7 -0
  16. package/dist/lib/browser/restore-card-FO3WERIE.mjs +21 -0
  17. package/dist/lib/browser/restore-card-FO3WERIE.mjs.map +7 -0
  18. package/dist/lib/browser/restore-card-field-U5XYEEOW.mjs +40 -0
  19. package/dist/lib/browser/restore-card-field-U5XYEEOW.mjs.map +7 -0
  20. package/dist/lib/browser/translations.mjs +44 -0
  21. package/dist/lib/browser/translations.mjs.map +7 -0
  22. package/dist/lib/browser/types/index.mjs +154 -7
  23. package/dist/lib/browser/types/index.mjs.map +4 -4
  24. package/dist/lib/node-esm/blueprints/index.mjs +28 -0
  25. package/dist/lib/node-esm/blueprints/index.mjs.map +7 -0
  26. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +11 -0
  27. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs.map +7 -0
  28. package/dist/lib/node-esm/chunk-W2RNFBMZ.mjs +106 -0
  29. package/dist/lib/node-esm/chunk-W2RNFBMZ.mjs.map +7 -0
  30. package/dist/lib/node-esm/delete-card-ZIREL6HN.mjs +25 -0
  31. package/dist/lib/node-esm/delete-card-ZIREL6HN.mjs.map +7 -0
  32. package/dist/lib/node-esm/delete-card-field-IPTEGVPP.mjs +43 -0
  33. package/dist/lib/node-esm/delete-card-field-IPTEGVPP.mjs.map +7 -0
  34. package/dist/lib/node-esm/index.mjs +76 -95
  35. package/dist/lib/node-esm/index.mjs.map +4 -4
  36. package/dist/lib/node-esm/meta.json +1 -1
  37. package/dist/lib/node-esm/operations/index.mjs +14 -0
  38. package/dist/lib/node-esm/operations/index.mjs.map +7 -0
  39. package/dist/lib/node-esm/restore-card-WJJ4YB7K.mjs +22 -0
  40. package/dist/lib/node-esm/restore-card-WJJ4YB7K.mjs.map +7 -0
  41. package/dist/lib/node-esm/restore-card-field-L24WJXAW.mjs +41 -0
  42. package/dist/lib/node-esm/restore-card-field-L24WJXAW.mjs.map +7 -0
  43. package/dist/lib/node-esm/translations.mjs +45 -0
  44. package/dist/lib/node-esm/translations.mjs.map +7 -0
  45. package/dist/lib/node-esm/types/index.mjs +154 -7
  46. package/dist/lib/node-esm/types/index.mjs.map +4 -4
  47. package/dist/types/src/KanbanPlugin.d.ts +2 -1
  48. package/dist/types/src/KanbanPlugin.d.ts.map +1 -1
  49. package/dist/types/src/blueprints/index.d.ts +2 -0
  50. package/dist/types/src/blueprints/index.d.ts.map +1 -0
  51. package/dist/types/src/blueprints/kanban-blueprint.d.ts +4 -0
  52. package/dist/types/src/blueprints/kanban-blueprint.d.ts.map +1 -0
  53. package/dist/types/src/capabilities/artifact-definition.d.ts +3 -2
  54. package/dist/types/src/capabilities/artifact-definition.d.ts.map +1 -1
  55. package/dist/types/src/capabilities/blueprint-definition.d.ts +5 -0
  56. package/dist/types/src/capabilities/blueprint-definition.d.ts.map +1 -0
  57. package/dist/types/src/capabilities/index.d.ts +7 -3
  58. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  59. package/dist/types/src/capabilities/migrations.d.ts +5 -0
  60. package/dist/types/src/capabilities/migrations.d.ts.map +1 -0
  61. package/dist/types/src/capabilities/operation-handler.d.ts +6 -0
  62. package/dist/types/src/capabilities/operation-handler.d.ts.map +1 -0
  63. package/dist/types/src/capabilities/react-surface.d.ts +3 -2
  64. package/dist/types/src/capabilities/react-surface.d.ts.map +1 -1
  65. package/dist/types/src/capabilities/undo-mappings.d.ts +5 -0
  66. package/dist/types/src/capabilities/undo-mappings.d.ts.map +1 -0
  67. package/dist/types/src/components/KanbanBoard/KanbanBoard.d.ts +57 -0
  68. package/dist/types/src/components/KanbanBoard/KanbanBoard.d.ts.map +1 -0
  69. package/dist/types/src/components/KanbanBoard/KanbanBoard.stories.d.ts +72 -0
  70. package/dist/types/src/components/KanbanBoard/KanbanBoard.stories.d.ts.map +1 -0
  71. package/dist/types/src/components/KanbanBoard/KanbanCard.d.ts +10 -0
  72. package/dist/types/src/components/KanbanBoard/KanbanCard.d.ts.map +1 -0
  73. package/dist/types/src/components/KanbanBoard/KanbanColumn.d.ts +9 -0
  74. package/dist/types/src/components/KanbanBoard/KanbanColumn.d.ts.map +1 -0
  75. package/dist/types/src/components/KanbanBoard/index.d.ts +2 -0
  76. package/dist/types/src/components/KanbanBoard/index.d.ts.map +1 -0
  77. package/dist/types/src/components/index.d.ts +1 -2
  78. package/dist/types/src/components/index.d.ts.map +1 -1
  79. package/dist/types/src/containers/KanbanContainer/KanbanContainer.d.ts +6 -0
  80. package/dist/types/src/containers/KanbanContainer/KanbanContainer.d.ts.map +1 -0
  81. package/dist/types/src/containers/KanbanContainer/KanbanContainer.stories.d.ts +79 -0
  82. package/dist/types/src/containers/KanbanContainer/KanbanContainer.stories.d.ts.map +1 -0
  83. package/dist/types/src/containers/KanbanContainer/index.d.ts +2 -0
  84. package/dist/types/src/containers/KanbanContainer/index.d.ts.map +1 -0
  85. package/dist/types/src/containers/KanbanSettings/KanbanSettings.d.ts +13 -0
  86. package/dist/types/src/containers/KanbanSettings/KanbanSettings.d.ts.map +1 -0
  87. package/dist/types/src/containers/KanbanSettings/index.d.ts +2 -0
  88. package/dist/types/src/containers/KanbanSettings/index.d.ts.map +1 -0
  89. package/dist/types/src/containers/index.d.ts +4 -0
  90. package/dist/types/src/containers/index.d.ts.map +1 -0
  91. package/dist/types/src/hooks/index.d.ts +7 -0
  92. package/dist/types/src/hooks/index.d.ts.map +1 -0
  93. package/dist/types/src/hooks/useEchoChangeCallback.d.ts +13 -0
  94. package/dist/types/src/hooks/useEchoChangeCallback.d.ts.map +1 -0
  95. package/dist/types/src/hooks/useItemsProjection.d.ts +10 -0
  96. package/dist/types/src/hooks/useItemsProjection.d.ts.map +1 -0
  97. package/dist/types/src/hooks/useKanbanBoardModel.browser.test.d.ts +2 -0
  98. package/dist/types/src/hooks/useKanbanBoardModel.browser.test.d.ts.map +1 -0
  99. package/dist/types/src/hooks/useKanbanBoardModel.d.ts +16 -0
  100. package/dist/types/src/hooks/useKanbanBoardModel.d.ts.map +1 -0
  101. package/dist/types/src/hooks/useKanbanColumnEventHandler.d.ts +22 -0
  102. package/dist/types/src/hooks/useKanbanColumnEventHandler.d.ts.map +1 -0
  103. package/dist/types/src/hooks/useKanbanItemEventHandler.d.ts +19 -0
  104. package/dist/types/src/hooks/useKanbanItemEventHandler.d.ts.map +1 -0
  105. package/dist/types/src/hooks/useProjectionModel.d.ts +15 -0
  106. package/dist/types/src/hooks/useProjectionModel.d.ts.map +1 -0
  107. package/dist/types/src/meta.d.ts +2 -3
  108. package/dist/types/src/meta.d.ts.map +1 -1
  109. package/dist/types/src/operations/definitions.d.ts +52 -0
  110. package/dist/types/src/operations/definitions.d.ts.map +1 -0
  111. package/dist/types/src/operations/delete-card-field.d.ts +5 -0
  112. package/dist/types/src/operations/delete-card-field.d.ts.map +1 -0
  113. package/dist/types/src/operations/delete-card.d.ts +5 -0
  114. package/dist/types/src/operations/delete-card.d.ts.map +1 -0
  115. package/dist/types/src/operations/index.d.ts +4 -0
  116. package/dist/types/src/operations/index.d.ts.map +1 -0
  117. package/dist/types/src/operations/restore-card-field.d.ts +5 -0
  118. package/dist/types/src/operations/restore-card-field.d.ts.map +1 -0
  119. package/dist/types/src/operations/restore-card.d.ts +5 -0
  120. package/dist/types/src/operations/restore-card.d.ts.map +1 -0
  121. package/dist/types/src/playwright/board-manager.d.ts +5 -0
  122. package/dist/types/src/playwright/board-manager.d.ts.map +1 -0
  123. package/dist/types/src/playwright/playwright.config.d.ts +3 -0
  124. package/dist/types/src/playwright/playwright.config.d.ts.map +1 -0
  125. package/dist/types/src/playwright/smoke.spec.d.ts +2 -0
  126. package/dist/types/src/playwright/smoke.spec.d.ts.map +1 -0
  127. package/dist/types/src/testing/KanbanCardTileSimple.d.ts +7 -0
  128. package/dist/types/src/testing/KanbanCardTileSimple.d.ts.map +1 -0
  129. package/dist/types/src/testing/index.d.ts +1 -2
  130. package/dist/types/src/testing/index.d.ts.map +1 -1
  131. package/dist/types/src/translations.d.ts +50 -22
  132. package/dist/types/src/translations.d.ts.map +1 -1
  133. package/dist/types/src/types/Kanban.d.ts +109 -0
  134. package/dist/types/src/types/Kanban.d.ts.map +1 -0
  135. package/dist/types/src/types/constants.d.ts +6 -0
  136. package/dist/types/src/types/constants.d.ts.map +1 -0
  137. package/dist/types/src/types/index.d.ts +3 -1
  138. package/dist/types/src/types/index.d.ts.map +1 -1
  139. package/dist/types/src/types/migrations.test.d.ts +2 -0
  140. package/dist/types/src/types/migrations.test.d.ts.map +1 -0
  141. package/dist/types/src/types/schema.d.ts +18 -53
  142. package/dist/types/src/types/schema.d.ts.map +1 -1
  143. package/dist/types/src/types/types.d.ts +26 -9
  144. package/dist/types/src/types/types.d.ts.map +1 -1
  145. package/dist/types/src/util/arrangement.d.ts +72 -0
  146. package/dist/types/src/util/arrangement.d.ts.map +1 -0
  147. package/dist/types/src/util/arrangement.test.d.ts +2 -0
  148. package/dist/types/src/util/arrangement.test.d.ts.map +1 -0
  149. package/dist/types/src/util/index.d.ts +2 -0
  150. package/dist/types/src/util/index.d.ts.map +1 -0
  151. package/dist/types/tsconfig.tsbuildinfo +1 -1
  152. package/package.json +89 -54
  153. package/src/KanbanPlugin.tsx +55 -56
  154. package/src/blueprints/index.ts +5 -0
  155. package/src/blueprints/kanban-blueprint.ts +27 -0
  156. package/src/capabilities/artifact-definition.ts +123 -108
  157. package/src/capabilities/blueprint-definition.ts +17 -0
  158. package/src/capabilities/index.ts +10 -4
  159. package/src/capabilities/migrations.ts +35 -0
  160. package/src/capabilities/operation-handler.ts +14 -0
  161. package/src/capabilities/react-surface.tsx +79 -65
  162. package/src/capabilities/undo-mappings.ts +34 -0
  163. package/src/components/KanbanBoard/KanbanBoard.stories.tsx +146 -0
  164. package/src/components/KanbanBoard/KanbanBoard.tsx +198 -0
  165. package/src/components/KanbanBoard/KanbanCard.tsx +98 -0
  166. package/src/components/KanbanBoard/KanbanColumn.tsx +71 -0
  167. package/src/components/KanbanBoard/index.ts +5 -0
  168. package/src/components/index.ts +1 -2
  169. package/src/containers/KanbanContainer/KanbanContainer.stories.tsx +275 -0
  170. package/src/containers/KanbanContainer/KanbanContainer.tsx +178 -0
  171. package/src/containers/KanbanContainer/index.ts +5 -0
  172. package/src/containers/KanbanSettings/KanbanSettings.tsx +94 -0
  173. package/src/containers/KanbanSettings/index.ts +5 -0
  174. package/src/containers/index.ts +8 -0
  175. package/src/hooks/index.ts +10 -0
  176. package/src/hooks/useEchoChangeCallback.ts +30 -0
  177. package/src/hooks/useItemsProjection.ts +44 -0
  178. package/src/hooks/useKanbanBoardModel.browser.test.ts +235 -0
  179. package/src/hooks/useKanbanBoardModel.ts +157 -0
  180. package/src/hooks/useKanbanColumnEventHandler.ts +106 -0
  181. package/src/hooks/useKanbanItemEventHandler.ts +133 -0
  182. package/src/hooks/useProjectionModel.ts +58 -0
  183. package/src/meta.ts +9 -7
  184. package/src/operations/definitions.ts +63 -0
  185. package/src/operations/delete-card-field.ts +47 -0
  186. package/src/operations/delete-card.ts +23 -0
  187. package/src/operations/index.ts +12 -0
  188. package/src/operations/restore-card-field.ts +41 -0
  189. package/src/operations/restore-card.ts +21 -0
  190. package/src/playwright/board-manager.ts +13 -0
  191. package/src/playwright/playwright.config.ts +19 -0
  192. package/src/playwright/smoke.spec.ts +107 -0
  193. package/src/testing/KanbanCardTileSimple.tsx +82 -0
  194. package/src/testing/index.ts +2 -3
  195. package/src/translations.ts +28 -20
  196. package/src/types/Kanban.ts +151 -0
  197. package/src/types/constants.ts +9 -0
  198. package/src/types/index.ts +3 -1
  199. package/src/types/migrations.test.ts +83 -0
  200. package/src/types/schema.ts +33 -46
  201. package/src/types/types.ts +30 -10
  202. package/src/util/arrangement.test.ts +218 -0
  203. package/src/util/arrangement.ts +177 -0
  204. package/src/util/index.ts +5 -0
  205. package/dist/lib/browser/artifact-definition-H5MOHOV5.mjs +0 -178
  206. package/dist/lib/browser/artifact-definition-H5MOHOV5.mjs.map +0 -7
  207. package/dist/lib/browser/chunk-76UNDUHS.mjs +0 -88
  208. package/dist/lib/browser/chunk-76UNDUHS.mjs.map +0 -7
  209. package/dist/lib/browser/intent-resolver-VJSWAUZD.mjs +0 -297
  210. package/dist/lib/browser/intent-resolver-VJSWAUZD.mjs.map +0 -7
  211. package/dist/lib/browser/react-surface-WMVUSDVR.mjs +0 -305
  212. package/dist/lib/browser/react-surface-WMVUSDVR.mjs.map +0 -7
  213. package/dist/lib/node-esm/artifact-definition-FDRLWGY5.mjs +0 -179
  214. package/dist/lib/node-esm/artifact-definition-FDRLWGY5.mjs.map +0 -7
  215. package/dist/lib/node-esm/chunk-B3AVV7SF.mjs +0 -90
  216. package/dist/lib/node-esm/chunk-B3AVV7SF.mjs.map +0 -7
  217. package/dist/lib/node-esm/intent-resolver-3ZSJN2NS.mjs +0 -298
  218. package/dist/lib/node-esm/intent-resolver-3ZSJN2NS.mjs.map +0 -7
  219. package/dist/lib/node-esm/react-surface-JKYB6SAC.mjs +0 -306
  220. package/dist/lib/node-esm/react-surface-JKYB6SAC.mjs.map +0 -7
  221. package/dist/types/src/capabilities/intent-resolver.d.ts +0 -4
  222. package/dist/types/src/capabilities/intent-resolver.d.ts.map +0 -1
  223. package/dist/types/src/components/KanbanContainer.d.ts +0 -7
  224. package/dist/types/src/components/KanbanContainer.d.ts.map +0 -1
  225. package/dist/types/src/components/KanbanContainer.stories.d.ts +0 -10
  226. package/dist/types/src/components/KanbanContainer.stories.d.ts.map +0 -1
  227. package/dist/types/src/components/KanbanViewEditor.d.ts +0 -8
  228. package/dist/types/src/components/KanbanViewEditor.d.ts.map +0 -1
  229. package/dist/types/src/testing/initialize-kanban.d.ts +0 -17
  230. package/dist/types/src/testing/initialize-kanban.d.ts.map +0 -1
  231. package/dist/types/src/testing/kanban-manager.d.ts +0 -7
  232. package/dist/types/src/testing/kanban-manager.d.ts.map +0 -1
  233. package/src/capabilities/intent-resolver.ts +0 -71
  234. package/src/components/KanbanContainer.stories.tsx +0 -191
  235. package/src/components/KanbanContainer.tsx +0 -95
  236. package/src/components/KanbanViewEditor.tsx +0 -104
  237. package/src/testing/initialize-kanban.ts +0 -128
  238. package/src/testing/kanban-manager.ts +0 -13
@@ -0,0 +1,98 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import React, { forwardRef, useCallback, useMemo, useState } from 'react';
6
+
7
+ import { Surface } from '@dxos/app-framework/ui';
8
+ import { AppSurface, useObjectMenuItems } from '@dxos/app-toolkit/ui';
9
+ import { Obj } from '@dxos/echo';
10
+ import { Card, Toolbar, useTranslation } from '@dxos/react-ui';
11
+ import { Menu, createMenuAction } from '@dxos/react-ui-menu';
12
+ import { Focus, Mosaic, type MosaicTileProps, useBoard } from '@dxos/react-ui-mosaic';
13
+
14
+ import { meta } from '#meta';
15
+
16
+ import { useKanbanBoard } from './KanbanBoard';
17
+
18
+ const KANBAN_CARD_TILE_NAME = 'KanbanBoard.Card';
19
+
20
+ export type KanbanCardProps = Pick<MosaicTileProps<Obj.Unknown>, 'location' | 'data' | 'debug'>;
21
+
22
+ /**
23
+ * Mosaic Tile for Kanban card.
24
+ * Uses Surface for content; requires plugin manager context.
25
+ */
26
+ export const KanbanCard = forwardRef<HTMLDivElement, KanbanCardProps>(({ data, location, debug }, forwardedRef) => {
27
+ const { t } = useTranslation(meta.id);
28
+ const { model } = useBoard(KANBAN_CARD_TILE_NAME);
29
+ const { projection, columnFieldPath, onCardRemove } = useKanbanBoard(KANBAN_CARD_TILE_NAME);
30
+ const [dragHandle, setDragHandle] = useState<HTMLButtonElement | null>(null);
31
+ const dragHandleRef = useCallback((el: HTMLButtonElement | null) => setDragHandle(el), []);
32
+
33
+ const objectMenuItems = useObjectMenuItems(data);
34
+
35
+ const menuItems = useMemo(
36
+ () => [
37
+ ...objectMenuItems,
38
+ ...(onCardRemove
39
+ ? [
40
+ createMenuAction('remove', () => onCardRemove(data), {
41
+ label: t('remove-card.label'),
42
+ icon: 'ph--trash--regular',
43
+ }),
44
+ ]
45
+ : []),
46
+ ],
47
+ [objectMenuItems, onCardRemove, data, t],
48
+ );
49
+
50
+ return (
51
+ <Menu.Root>
52
+ <Mosaic.Tile
53
+ asChild
54
+ id={model.getItemId(data)}
55
+ data={data}
56
+ location={location}
57
+ debug={debug}
58
+ dragHandle={dragHandle}
59
+ >
60
+ <Focus.Item asChild>
61
+ <Card.Root ref={forwardedRef} data-testid='board-item'>
62
+ <Card.Toolbar>
63
+ <Card.DragHandle ref={dragHandleRef} testId='mosaicBoard.cardDragHandle' />
64
+ <Card.Title data-testid='mosaicBoard.cardTitle'>{Obj.getLabel(data)}</Card.Title>
65
+ {/* TODO(wittjosiah): Reconcile with Card.Menu. */}
66
+ <Menu.Trigger asChild disabled={!menuItems?.length}>
67
+ <Toolbar.IconButton
68
+ iconOnly
69
+ variant='ghost'
70
+ icon='ph--dots-three-vertical--regular'
71
+ label={t('action-menu.label')}
72
+ />
73
+ </Menu.Trigger>
74
+ <Menu.Content items={menuItems} />
75
+ </Card.Toolbar>
76
+ <Card.Content>
77
+ {projection && (
78
+ <Surface.Surface
79
+ type={AppSurface.Card}
80
+ limit={1}
81
+ data={{
82
+ subject: data,
83
+ projection,
84
+ // Hide the pivot field: its value is already conveyed by
85
+ // which column the card sits in.
86
+ ignorePaths: columnFieldPath ? [columnFieldPath] : undefined,
87
+ }}
88
+ />
89
+ )}
90
+ </Card.Content>
91
+ </Card.Root>
92
+ </Focus.Item>
93
+ </Mosaic.Tile>
94
+ </Menu.Root>
95
+ );
96
+ });
97
+
98
+ KanbanCard.displayName = KANBAN_CARD_TILE_NAME;
@@ -0,0 +1,71 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import React, { FC, forwardRef, RefObject, useRef } from 'react';
6
+
7
+ import type { Obj } from '@dxos/echo';
8
+ import { Board, type MosaicTileProps, useBoard } from '@dxos/react-ui-mosaic';
9
+
10
+ import { useKanbanItemEventHandler } from '#hooks';
11
+ import { type ColumnStructure, UNCATEGORIZED_VALUE } from '#types';
12
+
13
+ import { useKanbanBoard } from './KanbanBoard';
14
+
15
+ const KANBAN_COLUMN_NAME = 'KanbanBoard.Column';
16
+
17
+ export type KanbanColumnProps = Pick<MosaicTileProps<ColumnStructure>, 'location' | 'data' | 'debug'>;
18
+
19
+ /**
20
+ * Mosaic Tile for Kanban column.
21
+ */
22
+ export const KanbanColumn = forwardRef<HTMLDivElement, KanbanColumnProps>(
23
+ ({ data: column, location, debug }, forwardedRef) => {
24
+ const { model } = useBoard<ColumnStructure, Obj.Unknown>(KANBAN_COLUMN_NAME);
25
+ const { columnFieldPath, change, onCardAdd, getPivotAttributes, itemTile } = useKanbanBoard(KANBAN_COLUMN_NAME);
26
+
27
+ const { title } = getPivotAttributes(column.columnValue);
28
+ const uncategorized = column.columnValue === UNCATEGORIZED_VALUE;
29
+ const dragHandleRef = useRef<HTMLButtonElement | null>(null);
30
+
31
+ const eventHandler = useKanbanItemEventHandler({
32
+ column,
33
+ columnFieldPath,
34
+ model,
35
+ change,
36
+ });
37
+
38
+ return (
39
+ <Board.Column.Root
40
+ data={column}
41
+ location={location}
42
+ classNames='grid grid-rows-[var(--dx-rail-action)_1fr_var(--dx-rail-action)]'
43
+ debug={debug}
44
+ dragHandleRef={dragHandleRef}
45
+ ref={forwardedRef}
46
+ >
47
+ {uncategorized ? (
48
+ <div className='border-b border-separator p-2' data-testid='board-column-header'>
49
+ <span className='font-medium'>{title}</span>
50
+ </div>
51
+ ) : (
52
+ <Board.Column.Header label={title} dragHandleRef={dragHandleRef as RefObject<HTMLButtonElement>} />
53
+ )}
54
+ <Board.Column.Body
55
+ data={column}
56
+ eventHandler={eventHandler}
57
+ Tile={itemTile as FC<MosaicTileProps<Obj.Unknown>>}
58
+ />
59
+ <Board.Column.Footer
60
+ onAdd={
61
+ onCardAdd
62
+ ? () => onCardAdd(column.columnValue === UNCATEGORIZED_VALUE ? undefined : column.columnValue)
63
+ : undefined
64
+ }
65
+ />
66
+ </Board.Column.Root>
67
+ );
68
+ },
69
+ );
70
+
71
+ KanbanColumn.displayName = KANBAN_COLUMN_NAME;
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ export * from './KanbanBoard';
@@ -2,5 +2,4 @@
2
2
  // Copyright 2024 DXOS.org
3
3
  //
4
4
 
5
- export * from './KanbanContainer';
6
- export * from './KanbanViewEditor';
5
+ export * from './KanbanBoard';
@@ -0,0 +1,275 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import { RegistryContext } from '@effect-atom/atom-react';
6
+ import { type Decorator, type Meta, type StoryObj } from '@storybook/react-vite';
7
+ import * as Effect from 'effect/Effect';
8
+ import React, { useCallback, useContext, useMemo } from 'react';
9
+ import { expect, waitFor, within } from 'storybook/test';
10
+
11
+ import { withPluginManager } from '@dxos/app-framework/testing';
12
+ import { Surface } from '@dxos/app-framework/ui';
13
+ import { AppSurface } from '@dxos/app-toolkit/ui';
14
+ import { Obj, type QueryAST, Type } from '@dxos/echo';
15
+ import { View } from '@dxos/echo';
16
+ import { type Mutable } from '@dxos/echo/internal';
17
+ import { invariant } from '@dxos/invariant';
18
+ import { ClientPlugin } from '@dxos/plugin-client';
19
+ import { initializeIdentity } from '@dxos/plugin-client/testing';
20
+ import { PreviewPlugin } from '@dxos/plugin-preview';
21
+ import { SpacePlugin } from '@dxos/plugin-space';
22
+ import { StorybookPlugin, corePlugins } from '@dxos/plugin-testing';
23
+ import { random } from '@dxos/random';
24
+ import { Filter, type Space, useQuery, useSchema, useSpaces } from '@dxos/react-client/echo';
25
+ import { ViewEditor } from '@dxos/react-ui-form';
26
+ import { Syntax } from '@dxos/react-ui-syntax-highlighter';
27
+ import { withLayout } from '@dxos/react-ui/testing';
28
+ import { ViewModel, getTypenameFromQuery } from '@dxos/schema';
29
+ // TODO(wittjosiah): Replace with echo/testing.
30
+ import { Organization, Person } from '@dxos/types';
31
+
32
+ import { useProjectionModel } from '#hooks';
33
+ import { translations } from '#translations';
34
+ import { Kanban } from '#types';
35
+
36
+ import { KanbanPlugin } from '../../KanbanPlugin';
37
+
38
+ random.seed(0);
39
+
40
+ const createOrg = (status?: Organization.Organization['status']) => ({
41
+ name: random.commerce.productName(),
42
+ description: random.lorem.paragraph(),
43
+ image: random.image.url(),
44
+ website: random.internet.url(),
45
+ status: (status ?? random.helpers.arrayElement(Organization.StatusOptions).id) as Organization.Organization['status'],
46
+ });
47
+
48
+ //
49
+ // Story setup helpers.
50
+ //
51
+
52
+ type ClientSetupOptions = {
53
+ types?: Type.AnyEntity[];
54
+ onSpaceCreated?: (space: Space) => Promise<void>;
55
+ };
56
+
57
+ /**
58
+ * Creates the standard plugin manager decorator with client configuration.
59
+ * Includes KanbanPlugin so the Surface resolves to KanbanContainer.
60
+ */
61
+ const withKanbanPlugins = ({ types = [], onSpaceCreated }: ClientSetupOptions): Decorator =>
62
+ withPluginManager({
63
+ plugins: [
64
+ ...corePlugins(),
65
+ ClientPlugin({
66
+ types: [...types, View.View, Kanban.Kanban],
67
+ onClientInitialized: ({ client }) =>
68
+ Effect.gen(function* () {
69
+ yield* initializeIdentity(client);
70
+ const space = yield* Effect.promise(() => client.spaces.create());
71
+ yield* Effect.promise(() => space.waitUntilReady());
72
+ yield* Effect.promise(() => onSpaceCreated?.(space) ?? Promise.resolve());
73
+ }),
74
+ }),
75
+ PreviewPlugin(),
76
+ SpacePlugin({}),
77
+ StorybookPlugin({}),
78
+ KanbanPlugin(),
79
+ ],
80
+ });
81
+
82
+ /**
83
+ * Renders the first Kanban in the space via Surface (resolves to KanbanContainer),
84
+ * with a sidebar containing ViewEditor and Json filter.
85
+ */
86
+ const DefaultComponent = () => {
87
+ const registry = useContext(RegistryContext);
88
+ const spaces = useSpaces();
89
+ const space = spaces[spaces.length - 1];
90
+ const [kanban] = useQuery(space?.db, Filter.type(Kanban.Kanban));
91
+ const viewRef = kanban && kanban.spec.kind === 'view' ? kanban.spec.view : undefined;
92
+ const view = viewRef?.target;
93
+ const typename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
94
+ const schema = useSchema(space?.db, typename);
95
+ const projection = useProjectionModel(schema, kanban, registry);
96
+
97
+ const data = useMemo(() => (kanban ? { subject: kanban, attendableId: 'story' } : undefined), [kanban]);
98
+
99
+ const handleUpdateQuery = useCallback(
100
+ (newQuery: QueryAST.Query) => {
101
+ invariant(schema);
102
+ invariant(view);
103
+ if (Type.isMutable(schema)) {
104
+ schema.updateTypename(getTypenameFromQuery(newQuery));
105
+ }
106
+ Obj.update(view, (view) => {
107
+ view.query.ast = newQuery as Mutable<QueryAST.Query>;
108
+ });
109
+ },
110
+ [view, schema],
111
+ );
112
+
113
+ const handleDeleteField = useCallback(
114
+ (fieldId: string) => {
115
+ if (schema && Type.isMutable(schema) && projection) {
116
+ projection.deleteFieldProjection(fieldId);
117
+ }
118
+ },
119
+ [schema, projection],
120
+ );
121
+
122
+ if (!schema || !view) {
123
+ return null;
124
+ }
125
+
126
+ return (
127
+ <div className='grow grid grid-cols-[1fr_350px] overflow-hidden h-full w-full'>
128
+ <Surface.Surface type={AppSurface.Article} data={data} limit={1} />
129
+ <div className='flex flex-col h-full overflow-hidden border-l border-separator'>
130
+ <ViewEditor
131
+ registry={space?.db.schemaRegistry}
132
+ schema={schema}
133
+ view={view}
134
+ onQueryChanged={handleUpdateQuery}
135
+ onDelete={schema && Type.isMutable(schema) ? handleDeleteField : undefined}
136
+ />
137
+ <Syntax.Root data={{ view, schema }}>
138
+ <Syntax.Content>
139
+ <Syntax.Filter />
140
+ <Syntax.Viewport>
141
+ <Syntax.Code classNames='text-xs' />
142
+ </Syntax.Viewport>
143
+ </Syntax.Content>
144
+ </Syntax.Root>
145
+ </div>
146
+ </div>
147
+ );
148
+ };
149
+
150
+ //
151
+ // Story definitions.
152
+ //
153
+
154
+ const meta = {
155
+ title: 'plugins/plugin-kanban/containers/Kanban',
156
+ component: DefaultComponent,
157
+ render: () => <DefaultComponent />,
158
+ decorators: [withLayout({ layout: 'fullscreen' })],
159
+ parameters: {
160
+ layout: 'fullscreen',
161
+ translations,
162
+ },
163
+ } satisfies Meta<typeof DefaultComponent>;
164
+
165
+ export default meta;
166
+
167
+ type Story = StoryObj<typeof meta>;
168
+
169
+ /**
170
+ * Default story using static runtime schema (immutable).
171
+ * Schema mutations are not allowed.
172
+ */
173
+ export const Default: Story = {
174
+ decorators: [
175
+ withKanbanPlugins({
176
+ types: [Organization.Organization, Person.Person],
177
+ onSpaceCreated: async (space) => {
178
+ const { view } = await ViewModel.makeFromDatabase({
179
+ db: space.db,
180
+ typename: Organization.Organization.typename,
181
+ pivotFieldName: 'status',
182
+ });
183
+ const kanban = Kanban.make({ view });
184
+ space.db.add(kanban);
185
+
186
+ Array.from({ length: 10 }).map(() => {
187
+ return space.db.add(Obj.make(Organization.Organization, createOrg()));
188
+ });
189
+ },
190
+ }),
191
+ ],
192
+ play: async ({ canvasElement }) => {
193
+ const canvas = within(canvasElement);
194
+
195
+ // Wait for the kanban columns to render by finding the status tags.
196
+ // Organization.StatusOptions: prospect, qualified, active, commit, reject.
197
+ const activeTag = await canvas.findByText('Active', undefined, { timeout: 12_000 });
198
+ const prospectTag = await canvas.findByText('Prospect', undefined, { timeout: 12_000 });
199
+ const commitTag = await canvas.findByText('Commit', undefined, { timeout: 12_000 });
200
+
201
+ // Verify all expected columns are rendered.
202
+ await expect(activeTag).toBeTruthy();
203
+ await expect(prospectTag).toBeTruthy();
204
+ await expect(commitTag).toBeTruthy();
205
+
206
+ // Find the column containers (Board uses data-testid="board-column").
207
+ const activeColumn = activeTag.closest('[data-testid="board-column"]') as HTMLElement;
208
+ const prospectColumn = prospectTag.closest('[data-testid="board-column"]') as HTMLElement;
209
+ await expect(activeColumn).toBeTruthy();
210
+ await expect(prospectColumn).toBeTruthy();
211
+
212
+ // Wait for cards to render in the columns (Board items use data-testid="board-item").
213
+ const getColumnCards = (column: HTMLElement) =>
214
+ Array.from(column.querySelectorAll('[data-testid="board-item"]')) as HTMLElement[];
215
+
216
+ await waitFor(() => expect(getColumnCards(activeColumn).length).toBeGreaterThan(0));
217
+
218
+ // Verify cards are distributed across columns.
219
+ const activeCards = getColumnCards(activeColumn);
220
+ const prospectCards = getColumnCards(prospectColumn);
221
+ await expect(activeCards.length).toBeGreaterThan(0);
222
+ await expect(prospectCards.length).toBeGreaterThan(0);
223
+
224
+ // Verify cards have drag handles (Card.Toolbar includes drag handle).
225
+ const firstActiveCard = activeCards[0];
226
+ const buttons = firstActiveCard.querySelectorAll('button');
227
+ await expect(buttons.length).toBeGreaterThan(0);
228
+
229
+ // Verify add-card action exists in columns (optional footer).
230
+ const activeAddItem = activeColumn.querySelector('[data-testid="board-column-add-item"]');
231
+ const prospectAddItem = prospectColumn.querySelector('[data-testid="board-column-add-item"]');
232
+ await expect(activeAddItem).toBeTruthy();
233
+ await expect(prospectAddItem).toBeTruthy();
234
+
235
+ // TODO(wittjosiah): Get drag & drop tests working.
236
+ // See packages/apps/composer-app/src/playwright/stack.spec.ts for reference.
237
+ },
238
+ };
239
+
240
+ /**
241
+ * Story variant that uses a mutable database schema (EchoSchema).
242
+ * This allows testing schema mutations like adding/removing fields.
243
+ */
244
+ // TODO(wittjosiah): Card previews (e.g., OrganizationCard) are type-specific and hard-coded.
245
+ // They don't use the projection to determine which fields to display, so deleting a field
246
+ // from the schema won't remove it from the card preview. To fix this, the type-specific
247
+ // cards in PreviewPlugin would need to accept and respect the projection prop.
248
+ export const MutableSchema: Story = {
249
+ decorators: [
250
+ withKanbanPlugins({
251
+ onSpaceCreated: async (space) => {
252
+ // Register schema in the database to make it mutable (EchoSchema).
253
+ const [schema] = await space.db.schemaRegistry.register([Organization.Organization]);
254
+
255
+ const { view } = await ViewModel.makeFromDatabase({
256
+ db: space.db,
257
+ typename: schema.typename,
258
+ pivotFieldName: 'status',
259
+ });
260
+ const kanban = Kanban.make({ view });
261
+ space.db.add(kanban);
262
+
263
+ // Create test data using the registered schema.
264
+ const requiredOrgs = [
265
+ ...Array.from({ length: 2 }, () => createOrg('prospect')),
266
+ ...Array.from({ length: 5 }, () => createOrg('qualified')),
267
+ ...Array.from({ length: 1 }, () => createOrg('active')),
268
+ ...Array.from({ length: 1 }, () => createOrg('commit')),
269
+ ...Array.from({ length: 1 }, () => createOrg('reject')),
270
+ ];
271
+ requiredOrgs.forEach((org) => space.db.add(Obj.make(schema, org)));
272
+ },
273
+ }),
274
+ ],
275
+ };
@@ -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 '#operations';
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';