@dxos/react-ui-mosaic 0.8.4-main.bc674ce → 0.8.4-main.bcb3aa67d6

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 (190) hide show
  1. package/dist/lib/browser/chunk-UTD5AWW5.mjs +1009 -0
  2. package/dist/lib/browser/chunk-UTD5AWW5.mjs.map +7 -0
  3. package/dist/lib/browser/index.mjs +604 -71
  4. package/dist/lib/browser/index.mjs.map +4 -4
  5. package/dist/lib/browser/meta.json +1 -1
  6. package/dist/lib/browser/playwright/index.mjs +148 -0
  7. package/dist/lib/browser/playwright/index.mjs.map +7 -0
  8. package/dist/lib/browser/testing/index.mjs +69 -236
  9. package/dist/lib/browser/testing/index.mjs.map +4 -4
  10. package/dist/lib/node-esm/chunk-5K56GSJL.mjs +1011 -0
  11. package/dist/lib/node-esm/chunk-5K56GSJL.mjs.map +7 -0
  12. package/dist/lib/node-esm/index.mjs +604 -71
  13. package/dist/lib/node-esm/index.mjs.map +4 -4
  14. package/dist/lib/node-esm/meta.json +1 -1
  15. package/dist/lib/node-esm/playwright/index.mjs +150 -0
  16. package/dist/lib/node-esm/playwright/index.mjs.map +7 -0
  17. package/dist/lib/node-esm/testing/index.mjs +69 -236
  18. package/dist/lib/node-esm/testing/index.mjs.map +4 -4
  19. package/dist/types/src/components/Board/Board.d.ts +88 -0
  20. package/dist/types/src/components/Board/Board.d.ts.map +1 -0
  21. package/dist/types/src/components/Board/Board.stories.d.ts +41 -0
  22. package/dist/types/src/components/Board/Board.stories.d.ts.map +1 -0
  23. package/dist/types/src/components/Board/Column.d.ts +48 -0
  24. package/dist/types/src/components/Board/Column.d.ts.map +1 -0
  25. package/dist/types/src/components/Board/Item.d.ts +12 -0
  26. package/dist/types/src/components/Board/Item.d.ts.map +1 -0
  27. package/dist/types/src/components/Board/index.d.ts +2 -0
  28. package/dist/types/src/components/Board/index.d.ts.map +1 -0
  29. package/dist/types/src/components/Focus/Focus.d.ts +1 -24
  30. package/dist/types/src/components/Focus/Focus.d.ts.map +1 -1
  31. package/dist/types/src/components/Focus/index.d.ts +0 -1
  32. package/dist/types/src/components/Focus/index.d.ts.map +1 -1
  33. package/dist/types/src/components/Mosaic/Container.d.ts +49 -0
  34. package/dist/types/src/components/Mosaic/Container.d.ts.map +1 -0
  35. package/dist/types/src/components/Mosaic/Mosaic.d.ts +36 -126
  36. package/dist/types/src/components/Mosaic/Mosaic.d.ts.map +1 -1
  37. package/dist/types/src/components/Mosaic/Placeholder.d.ts +21 -0
  38. package/dist/types/src/components/Mosaic/Placeholder.d.ts.map +1 -0
  39. package/dist/types/src/components/Mosaic/Root.d.ts +36 -0
  40. package/dist/types/src/components/Mosaic/Root.d.ts.map +1 -0
  41. package/dist/types/src/components/Mosaic/Stack.d.ts +23 -0
  42. package/dist/types/src/components/Mosaic/Stack.d.ts.map +1 -0
  43. package/dist/types/src/components/Mosaic/Stack.stories.d.ts +20 -0
  44. package/dist/types/src/components/Mosaic/Stack.stories.d.ts.map +1 -0
  45. package/dist/types/src/components/Mosaic/Tile.d.ts +57 -0
  46. package/dist/types/src/components/Mosaic/Tile.d.ts.map +1 -0
  47. package/dist/types/src/components/Mosaic/styles.d.ts.map +1 -1
  48. package/dist/types/src/components/Mosaic/types.d.ts +9 -2
  49. package/dist/types/src/components/Mosaic/types.d.ts.map +1 -1
  50. package/dist/types/src/components/index.d.ts +1 -4
  51. package/dist/types/src/components/index.d.ts.map +1 -1
  52. package/dist/types/src/hooks/index.d.ts +1 -0
  53. package/dist/types/src/hooks/index.d.ts.map +1 -1
  54. package/dist/types/src/hooks/useDefaultColumnEventHandler.d.ts +15 -0
  55. package/dist/types/src/hooks/useDefaultColumnEventHandler.d.ts.map +1 -0
  56. package/dist/types/src/hooks/useEventHandlerAdapter.d.ts +1 -1
  57. package/dist/types/src/hooks/useEventHandlerAdapter.d.ts.map +1 -1
  58. package/dist/types/src/hooks/useVisibleItems.d.ts +2 -2
  59. package/dist/types/src/hooks/useVisibleItems.d.ts.map +1 -1
  60. package/dist/types/src/playwright/board-manager.d.ts +45 -0
  61. package/dist/types/src/playwright/board-manager.d.ts.map +1 -0
  62. package/dist/types/src/playwright/index.d.ts +9 -0
  63. package/dist/types/src/playwright/index.d.ts.map +1 -0
  64. package/dist/types/src/playwright/playwright.config.d.ts +3 -0
  65. package/dist/types/src/playwright/playwright.config.d.ts.map +1 -0
  66. package/dist/types/src/playwright/smoke.spec.d.ts +2 -0
  67. package/dist/types/src/playwright/smoke.spec.d.ts.map +1 -0
  68. package/dist/types/src/testing/CardContainer.d.ts +5 -4
  69. package/dist/types/src/testing/CardContainer.d.ts.map +1 -1
  70. package/dist/types/src/testing/DefaultStackTile.d.ts +2 -2
  71. package/dist/types/src/testing/DefaultStackTile.d.ts.map +1 -1
  72. package/dist/types/src/testing/index.d.ts +1 -1
  73. package/dist/types/src/testing/index.d.ts.map +1 -1
  74. package/dist/types/src/testing/types.d.ts +21 -0
  75. package/dist/types/src/testing/types.d.ts.map +1 -0
  76. package/dist/types/src/translations.d.ts +5 -1
  77. package/dist/types/src/translations.d.ts.map +1 -1
  78. package/dist/types/tsconfig.tsbuildinfo +1 -1
  79. package/package.json +43 -28
  80. package/src/AUDIT.md +106 -0
  81. package/src/components/Board/Board.stories.tsx +273 -0
  82. package/src/components/Board/Board.tsx +191 -0
  83. package/src/components/Board/Column.tsx +302 -0
  84. package/src/components/Board/Item.tsx +116 -0
  85. package/src/components/{Layout → Board}/index.ts +1 -1
  86. package/src/components/Focus/Focus.tsx +2 -93
  87. package/src/components/Focus/index.ts +0 -2
  88. package/src/components/Mosaic/Container.tsx +318 -0
  89. package/src/components/Mosaic/Mosaic.tsx +35 -913
  90. package/src/components/Mosaic/Placeholder.tsx +133 -0
  91. package/src/components/Mosaic/Root.tsx +292 -0
  92. package/src/components/Mosaic/Stack.stories.tsx +176 -0
  93. package/src/components/Mosaic/Stack.tsx +321 -0
  94. package/src/components/Mosaic/Tile.tsx +247 -0
  95. package/src/components/Mosaic/extension.ts +1 -1
  96. package/src/components/Mosaic/styles.ts +9 -8
  97. package/src/components/Mosaic/types.ts +15 -3
  98. package/src/components/index.ts +1 -4
  99. package/src/hooks/index.ts +1 -0
  100. package/src/hooks/useContainerDebug.tsx +5 -3
  101. package/src/hooks/useDefaultColumnEventHandler.ts +35 -0
  102. package/src/hooks/useEventHandlerAdapter.ts +15 -6
  103. package/src/hooks/useVisibleItems.ts +7 -2
  104. package/src/playwright/board-manager.ts +159 -0
  105. package/src/playwright/index.ts +13 -0
  106. package/src/playwright/playwright.config.ts +17 -0
  107. package/src/playwright/smoke.spec.ts +143 -0
  108. package/src/testing/CardContainer.tsx +31 -19
  109. package/src/testing/DefaultStackTile.tsx +36 -22
  110. package/src/testing/index.ts +1 -1
  111. package/src/testing/types.ts +38 -0
  112. package/src/translations.ts +5 -1
  113. package/dist/lib/browser/chunk-UMBPEG4F.mjs +0 -1637
  114. package/dist/lib/browser/chunk-UMBPEG4F.mjs.map +0 -7
  115. package/dist/lib/browser/index.css +0 -13
  116. package/dist/lib/browser/index.css.map +0 -7
  117. package/dist/lib/browser/testing/index.css +0 -13
  118. package/dist/lib/browser/testing/index.css.map +0 -7
  119. package/dist/lib/node-esm/chunk-X6GV7SMK.mjs +0 -1639
  120. package/dist/lib/node-esm/chunk-X6GV7SMK.mjs.map +0 -7
  121. package/dist/lib/node-esm/index.css +0 -13
  122. package/dist/lib/node-esm/index.css.map +0 -7
  123. package/dist/lib/node-esm/testing/index.css +0 -13
  124. package/dist/lib/node-esm/testing/index.css.map +0 -7
  125. package/dist/types/src/components/Card/Card.d.ts +0 -121
  126. package/dist/types/src/components/Card/Card.d.ts.map +0 -1
  127. package/dist/types/src/components/Card/Card.stories.d.ts +0 -21
  128. package/dist/types/src/components/Card/Card.stories.d.ts.map +0 -1
  129. package/dist/types/src/components/Card/CardDragPreview.d.ts +0 -6
  130. package/dist/types/src/components/Card/CardDragPreview.d.ts.map +0 -1
  131. package/dist/types/src/components/Card/index.d.ts +0 -4
  132. package/dist/types/src/components/Card/index.d.ts.map +0 -1
  133. package/dist/types/src/components/Card/styles.d.ts +0 -13
  134. package/dist/types/src/components/Card/styles.d.ts.map +0 -1
  135. package/dist/types/src/components/Focus/styles.d.ts +0 -6
  136. package/dist/types/src/components/Focus/styles.d.ts.map +0 -1
  137. package/dist/types/src/components/Image/Image.d.ts +0 -14
  138. package/dist/types/src/components/Image/Image.d.ts.map +0 -1
  139. package/dist/types/src/components/Image/Image.stories.d.ts +0 -33
  140. package/dist/types/src/components/Image/Image.stories.d.ts.map +0 -1
  141. package/dist/types/src/components/Image/index.d.ts +0 -2
  142. package/dist/types/src/components/Image/index.d.ts.map +0 -1
  143. package/dist/types/src/components/Layout/Layout.d.ts +0 -33
  144. package/dist/types/src/components/Layout/Layout.d.ts.map +0 -1
  145. package/dist/types/src/components/Layout/Layout.stories.d.ts +0 -10
  146. package/dist/types/src/components/Layout/Layout.stories.d.ts.map +0 -1
  147. package/dist/types/src/components/Layout/index.d.ts +0 -2
  148. package/dist/types/src/components/Layout/index.d.ts.map +0 -1
  149. package/dist/types/src/components/Mosaic/Mosaic.stories.d.ts +0 -27
  150. package/dist/types/src/components/Mosaic/Mosaic.stories.d.ts.map +0 -1
  151. package/dist/types/src/components/Scrollable/Scrollable.d.ts +0 -24
  152. package/dist/types/src/components/Scrollable/Scrollable.d.ts.map +0 -1
  153. package/dist/types/src/components/Scrollable/Scrollable.stories.d.ts +0 -10
  154. package/dist/types/src/components/Scrollable/Scrollable.stories.d.ts.map +0 -1
  155. package/dist/types/src/components/Scrollable/index.d.ts +0 -2
  156. package/dist/types/src/components/Scrollable/index.d.ts.map +0 -1
  157. package/dist/types/src/components/Stack/Stack.d.ts +0 -22
  158. package/dist/types/src/components/Stack/Stack.d.ts.map +0 -1
  159. package/dist/types/src/components/Stack/Stack.stories.d.ts +0 -9
  160. package/dist/types/src/components/Stack/Stack.stories.d.ts.map +0 -1
  161. package/dist/types/src/components/Stack/index.d.ts +0 -2
  162. package/dist/types/src/components/Stack/index.d.ts.map +0 -1
  163. package/dist/types/src/testing/Board.d.ts +0 -45
  164. package/dist/types/src/testing/Board.d.ts.map +0 -1
  165. package/dist/types/src/testing/Slot.stories.d.ts +0 -14
  166. package/dist/types/src/testing/Slot.stories.d.ts.map +0 -1
  167. package/dist/types/src/testing/Virtualizer.stories.d.ts +0 -12
  168. package/dist/types/src/testing/Virtualizer.stories.d.ts.map +0 -1
  169. package/src/components/Card/Card.stories.tsx +0 -148
  170. package/src/components/Card/Card.tsx +0 -458
  171. package/src/components/Card/CardDragPreview.tsx +0 -23
  172. package/src/components/Card/index.ts +0 -8
  173. package/src/components/Card/styles.ts +0 -23
  174. package/src/components/Focus/styles.ts +0 -24
  175. package/src/components/Image/Image.stories.tsx +0 -86
  176. package/src/components/Image/Image.tsx +0 -223
  177. package/src/components/Image/index.ts +0 -5
  178. package/src/components/Layout/Layout.stories.tsx +0 -59
  179. package/src/components/Layout/Layout.tsx +0 -108
  180. package/src/components/Mosaic/Mosaic.stories.tsx +0 -113
  181. package/src/components/Scrollable/Scrollable.stories.tsx +0 -59
  182. package/src/components/Scrollable/Scrollable.tsx +0 -88
  183. package/src/components/Scrollable/index.ts +0 -5
  184. package/src/components/Scrollable/scrollable.css +0 -20
  185. package/src/components/Stack/Stack.stories.tsx +0 -115
  186. package/src/components/Stack/Stack.tsx +0 -210
  187. package/src/components/Stack/index.ts +0 -5
  188. package/src/testing/Board.tsx +0 -278
  189. package/src/testing/Slot.stories.tsx +0 -101
  190. package/src/testing/Virtualizer.stories.tsx +0 -133
@@ -0,0 +1,35 @@
1
+ //
2
+ // Copyright 2026 DXOS.org
3
+ //
4
+
5
+ import { type Obj } from '@dxos/echo';
6
+
7
+ import { type GetId, type MosaicEventHandler } from '../components';
8
+
9
+ import { useEventHandlerAdapter } from './useEventHandlerAdapter';
10
+
11
+ /**
12
+ * Minimal model shape needed to build the default column handler.
13
+ */
14
+ export type DefaultColumnEventHandlerModel<TColumn = unknown> = {
15
+ getColumnId: GetId<TColumn>;
16
+ isColumn: (obj: unknown) => obj is TColumn;
17
+ };
18
+
19
+ /**
20
+ * Returns the default column drag/drop handler (no persistence).
21
+ * Use this when no custom eventHandler is passed to Board.Content.
22
+ */
23
+ export const useDefaultColumnEventHandler = <TColumn extends Obj.Unknown = Obj.Unknown>(
24
+ id: string,
25
+ model: DefaultColumnEventHandlerModel<TColumn>,
26
+ items: TColumn[],
27
+ ): MosaicEventHandler<TColumn> =>
28
+ useEventHandlerAdapter<TColumn, TColumn>({
29
+ id,
30
+ items,
31
+ getId: model.getColumnId,
32
+ get: (data) => data,
33
+ make: (object) => object,
34
+ canDrop: ({ source }) => model.isColumn(source.data),
35
+ });
@@ -10,7 +10,10 @@ import { arrayMove } from '@dxos/util';
10
10
 
11
11
  import { type GetId, type MosaicEventHandler } from '../components';
12
12
 
13
- export type UseEventHandlerProps<TItem = any, TObject = any> = Pick<MosaicEventHandler<TItem>, 'id' | 'canDrop'> & {
13
+ export type UseEventHandlerProps<TItem = any, TObject extends Obj.Unknown = Obj.Unknown> = Pick<
14
+ MosaicEventHandler<TItem>,
15
+ 'id' | 'canDrop'
16
+ > & {
14
17
  /**
15
18
  * The items to manage.
16
19
  */
@@ -72,17 +75,23 @@ export const useEventHandlerAdapter = <TItem = any, TObject extends Obj.Unknown
72
75
  void cb(source.data);
73
76
  },
74
77
  onDrop: ({ source, target }) => {
75
- const to = target?.type === 'tile' || target?.type === 'placeholder' ? target.location : -1;
76
- log.info('onDrop', { source, target, to });
78
+ log.info('onDrop', { source, target });
77
79
 
78
80
  const mutate = (items: TItem[]) => {
81
+ const to =
82
+ target?.type === 'tile' || target?.type === 'placeholder'
83
+ ? target.location
84
+ : target?.type === 'container'
85
+ ? items.length
86
+ : -1;
79
87
  const from = items.findIndex((item) => getId(item) === source.id);
80
- if (to !== -1) {
88
+ const insertIndex = typeof to === 'number' && to >= 0 ? Math.floor(to) : -1;
89
+ if (insertIndex !== -1) {
81
90
  if (from !== -1) {
82
- arrayMove(items, from, to);
91
+ arrayMove(items, from, insertIndex);
83
92
  } else {
84
93
  // TODO(burdon): This should be the responsibility of the source container.
85
- items.splice(to, 0, make(get(source.data)));
94
+ items.splice(insertIndex, 0, make(get(source.data)));
86
95
  }
87
96
  }
88
97
  };
@@ -11,7 +11,7 @@ export type UseVisibleItemsProps<TItem = any> = {
11
11
  id: string;
12
12
 
13
13
  /** Current items. */
14
- items?: TItem[];
14
+ items?: readonly TItem[] | TItem[];
15
15
 
16
16
  /** Currently dragging item. */
17
17
  dragging: MosaicTileData<TItem> | undefined;
@@ -23,7 +23,12 @@ export type UseVisibleItemsProps<TItem = any> = {
23
23
  /**
24
24
  * Returns items with the dragging item removed.
25
25
  */
26
- export const useVisibleItems = <TItem = any>({ id, items, dragging, getId }: UseVisibleItemsProps<TItem>): TItem[] => {
26
+ export const useVisibleItems = <TItem = any>({
27
+ id,
28
+ items,
29
+ dragging,
30
+ getId,
31
+ }: UseVisibleItemsProps<TItem>): readonly TItem[] | TItem[] => {
27
32
  const visibleItems = useMemo(() => {
28
33
  if (!items || !dragging || id !== dragging.containerId) {
29
34
  return items ?? [];
@@ -0,0 +1,159 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import type { Locator, Page } from '@playwright/test';
6
+
7
+ export class BoardManager {
8
+ private readonly _page: Page;
9
+
10
+ constructor(readonly locator: Locator) {
11
+ this._page = locator.page();
12
+ }
13
+
14
+ columns(): Locator {
15
+ return this.locator.getByTestId('board-column');
16
+ }
17
+
18
+ column(index: number): ColumnManager {
19
+ return new ColumnManager(this.locator.getByTestId('board-column').nth(index));
20
+ }
21
+ }
22
+
23
+ export class ColumnManager {
24
+ private readonly _page: Page;
25
+
26
+ constructor(readonly locator: Locator) {
27
+ this._page = locator.page();
28
+ }
29
+
30
+ items(): Locator {
31
+ return this.locator.getByTestId('board-item');
32
+ }
33
+
34
+ item(index: number): ItemManager {
35
+ return new ItemManager(this.locator.getByTestId('board-item').nth(index));
36
+ }
37
+
38
+ async addItem(): Promise<void> {
39
+ await this.locator.getByTestId('board-column-add-item').click();
40
+ }
41
+
42
+ header(): Locator {
43
+ return this.locator.getByTestId('board-column-header');
44
+ }
45
+
46
+ title(): Locator {
47
+ return this.locator.getByTestId('mosaicBoard.columnTitle');
48
+ }
49
+
50
+ async dragTo(target: Locator, offset = { x: 0, y: 0 }): Promise<void> {
51
+ const handle = this.header().getByTestId('mosaicBoard.columnDragHandle');
52
+ const handleBox = await handle.boundingBox();
53
+ if (!handleBox) {
54
+ return;
55
+ }
56
+
57
+ await handle.hover();
58
+ await this._page.mouse.down();
59
+ // Small initial movement to trigger the native drag start.
60
+ await this._page.mouse.move(handleBox.x + handleBox.width / 2 + 1, handleBox.y + handleBox.height / 2, {
61
+ steps: 1,
62
+ });
63
+ // Allow the drag monitor to register and the DOM to settle
64
+ // (the dragged column is removed from visible items, shifting remaining columns).
65
+ await this._page.waitForTimeout(200);
66
+ const box = await target.boundingBox();
67
+ if (box) {
68
+ await this._page.mouse.move(offset.x + box.x + box.width / 2, offset.y + box.y + box.height / 2, { steps: 4 });
69
+ // Allow the drop target to process the hover before releasing.
70
+ await this._page.waitForTimeout(100);
71
+ await this._page.mouse.up();
72
+ }
73
+ }
74
+ }
75
+
76
+ export class ItemManager {
77
+ private readonly _page: Page;
78
+
79
+ constructor(readonly locator: Locator) {
80
+ this._page = locator.page();
81
+ }
82
+
83
+ title(): Locator {
84
+ return this.locator.getByTestId('mosaicBoard.cardTitle');
85
+ }
86
+
87
+ async dragTo(target: Locator, offset = { x: 0, y: 0 }): Promise<void> {
88
+ const handle = this.locator.getByTestId('mosaicBoard.cardDragHandle');
89
+ const box = await target.boundingBox();
90
+ if (box) {
91
+ await handle.hover();
92
+ await this._page.mouse.down();
93
+ // Allow the drag monitor to register the grab before moving.
94
+ await this._page.waitForTimeout(100);
95
+ await this._page.mouse.move(offset.x + box.x + box.width / 2, offset.y + box.y + box.height / 2, { steps: 4 });
96
+ // Allow the drop target to process the hover before releasing.
97
+ await this._page.waitForTimeout(100);
98
+ await this._page.mouse.up();
99
+ }
100
+ }
101
+
102
+ /**
103
+ * Drag this item to a column's scroll bottom, hold to trigger auto-scroll,
104
+ * then wait for the drop target to become visible and drop on it.
105
+ *
106
+ * @param holdTarget - The footer element; mouse is held ~20px above it to trigger auto-scroll.
107
+ * @param dropTarget - The element to drop on once it scrolls into view.
108
+ * @param dropOffset - Offset from the drop target center.
109
+ */
110
+ async dragToEndWithAutoScroll(holdTarget: Locator, dropTarget: Locator, dropOffset = { x: 0, y: 0 }): Promise<void> {
111
+ const handle = this.locator.getByTestId('mosaicBoard.cardDragHandle');
112
+ const holdBox = await holdTarget.boundingBox();
113
+ if (!holdBox) {
114
+ return;
115
+ }
116
+
117
+ // The hold position is ~20px above the footer to trigger pragmatic auto-scroll.
118
+ const holdX = holdBox.x + holdBox.width / 2;
119
+ const holdY = holdBox.y - 20;
120
+
121
+ await handle.hover();
122
+ await this._page.mouse.down();
123
+ // Allow the drag monitor to register the grab before moving.
124
+ await this._page.waitForTimeout(100);
125
+
126
+ // Move to hold position above the footer to trigger auto-scroll.
127
+ await this._page.mouse.move(holdX, holdY, { steps: 4 });
128
+
129
+ // Hold and nudge mouse periodically to keep auto-scroll active until drop target is visible.
130
+ for (let i = 0; i < 40; i++) {
131
+ // Wait between nudges to give auto-scroll time to advance.
132
+ await this._page.waitForTimeout(200);
133
+ // Small nudge to keep drag events firing (auto-scroll stalls without movement).
134
+ await this._page.mouse.move(holdX + (i % 2), holdY, { steps: 1 });
135
+
136
+ const dropBox = await dropTarget.boundingBox();
137
+ if (dropBox && dropBox.y + dropBox.height < holdY) {
138
+ // Drop target has scrolled into view. Re-read box so we use current position (scroll may have moved it).
139
+ const finalBox = await dropTarget.boundingBox();
140
+ if (!finalBox) {
141
+ await this._page.mouse.up();
142
+ return;
143
+ }
144
+
145
+ const dropX = dropOffset.x + finalBox.x + finalBox.width / 2;
146
+ const dropY = dropOffset.y + finalBox.y + finalBox.height / 2;
147
+ await this._page.mouse.move(dropX, dropY, { steps: 8 });
148
+ // Let drop target receive dragOver and settle (headless is faster; needs a moment to register).
149
+ await dropTarget.waitFor({ state: 'visible' });
150
+ await this._page.waitForTimeout(200);
151
+ await this._page.mouse.up();
152
+ return;
153
+ }
154
+ }
155
+
156
+ // Fallback: drop wherever we are.
157
+ await this._page.mouse.up();
158
+ }
159
+ }
@@ -0,0 +1,13 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ /**
6
+ * Playwright-only entry point for e2e helpers (e.g. BoardManager).
7
+ * Kept separate from the ./testing entry point so that Node can load this
8
+ * without pulling in the testing bundle and its browser-only dependencies
9
+ * (e.g. @atlaskit/pragmatic-drag-and-drop). Use ./playwright from Playwright
10
+ * specs; use ./testing for in-browser test helpers.
11
+ */
12
+
13
+ export * from './board-manager';
@@ -0,0 +1,17 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { defineConfig } from '@playwright/test';
6
+
7
+ import { e2ePreset } from '@dxos/test-utils/playwright';
8
+
9
+ export default defineConfig({
10
+ ...e2ePreset(import.meta.dirname),
11
+ // TODO(wittjosiah): Avoid hard-coding ports.
12
+ webServer: {
13
+ command: 'pnpm storybook dev --ci --quiet --port=9008 --config-dir=.storybook',
14
+ port: 9008,
15
+ reuseExistingServer: false,
16
+ },
17
+ });
@@ -0,0 +1,143 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { type Page, expect, test } from '@playwright/test';
6
+
7
+ import { setupPage, storybookUrl } from '@dxos/test-utils/playwright';
8
+
9
+ import { BoardManager } from './board-manager';
10
+
11
+ const PORT = 9008;
12
+ const STORY_URL = storybookUrl('ui-react-ui-mosaic-board--spec', PORT);
13
+
14
+ const ABOVE_OFFSET = -20;
15
+ const BELOW_OFFSET = 50;
16
+
17
+ test.describe('Board', () => {
18
+ let page: Page;
19
+ let board: BoardManager;
20
+
21
+ test.beforeEach(async ({ browser }) => {
22
+ ({ page } = await setupPage(browser, { url: STORY_URL }));
23
+ await page.getByTestId('board-column').first().waitFor({ state: 'visible' });
24
+ board = new BoardManager(page.locator('body'));
25
+ });
26
+
27
+ test.afterEach(async () => {
28
+ await page.close();
29
+ });
30
+
31
+ test('rearrange columns', async () => {
32
+ const col0Label = await board.column(0).title().textContent();
33
+ const col1Label = await board.column(1).title().textContent();
34
+
35
+ // Drag column 0 to the right of column 1.
36
+ await board.column(0).dragTo(board.column(1).header());
37
+
38
+ await expect(board.column(0).title()).toHaveText(col1Label!);
39
+ await expect(board.column(1).title()).toHaveText(col0Label!);
40
+ });
41
+
42
+ test('rearrange within column', async () => {
43
+ // Pick whichever column has more items for a reliable test.
44
+ const col0Count = await board.column(0).items().count();
45
+ const col1Count = await board.column(1).items().count();
46
+ const colIndex = col0Count >= col1Count ? 0 : 1;
47
+ const column = board.column(colIndex);
48
+ const countBefore = Math.max(col0Count, col1Count);
49
+ expect(countBefore).toBeGreaterThanOrEqual(2);
50
+
51
+ const firstLabel = await column.item(0).title().textContent();
52
+ const secondLabel = await column.item(1).title().textContent();
53
+
54
+ // Drag first item below the second item.
55
+ await column.item(0).dragTo(column.item(1).locator, { x: 0, y: BELOW_OFFSET });
56
+
57
+ // Item count should stay the same.
58
+ await expect(column.items()).toHaveCount(countBefore);
59
+
60
+ // The first item should now be what was previously the second item.
61
+ await expect(column.item(0).title()).toHaveText(secondLabel!);
62
+
63
+ // The original first item should now be at index 1.
64
+ await expect(column.item(1).title()).toHaveText(firstLabel!);
65
+ });
66
+
67
+ test('drag to beginning of another column', async () => {
68
+ const col0 = board.column(0);
69
+ const col1 = board.column(1);
70
+
71
+ const col0CountBefore = await col0.items().count();
72
+ const col1CountBefore = await col1.items().count();
73
+ const draggedLabel = await col0.item(0).title().textContent();
74
+
75
+ // Drag above the first item in the target column.
76
+ await col0.item(0).dragTo(col1.item(0).locator, { x: 0, y: ABOVE_OFFSET });
77
+
78
+ await expect(col0.items()).toHaveCount(col0CountBefore - 1);
79
+ await expect(col1.items()).toHaveCount(col1CountBefore + 1);
80
+ await expect(col1.item(0).title()).toHaveText(draggedLabel!);
81
+ });
82
+
83
+ test('drag to middle of another column', async () => {
84
+ const col0 = board.column(0);
85
+ const col1 = board.column(1);
86
+
87
+ const col0CountBefore = await col0.items().count();
88
+ const col1CountBefore = await col1.items().count();
89
+ const draggedLabel = await col0.item(0).title().textContent();
90
+
91
+ // Drag to below the first item in the target column.
92
+ await col0.item(0).dragTo(col1.item(0).locator, { x: 0, y: BELOW_OFFSET });
93
+
94
+ await expect(col0.items()).toHaveCount(col0CountBefore - 1);
95
+ await expect(col1.items()).toHaveCount(col1CountBefore + 1);
96
+ await expect(col1.items().getByRole('heading', { name: draggedLabel! })).toBeVisible();
97
+ });
98
+
99
+ test('drag to end of another column', async () => {
100
+ const col0 = board.column(0);
101
+ const col1 = board.column(1);
102
+
103
+ const col0CountBefore = await col0.items().count();
104
+ const col1CountBefore = await col1.items().count();
105
+ const draggedLabel = await col0.item(0).title().textContent();
106
+
107
+ // Hold ~20px above the footer to trigger pragmatic auto-scroll,
108
+ // then drop on the last item once it scrolls into view.
109
+ const footer = col1.locator.getByTestId('board-column-add-item');
110
+ await col0
111
+ .item(0)
112
+ .dragToEndWithAutoScroll(footer, col1.item(col1CountBefore - 1).locator, { x: 0, y: BELOW_OFFSET });
113
+
114
+ await expect(col0.items()).toHaveCount(col0CountBefore - 1);
115
+ await expect(col1.items()).toHaveCount(col1CountBefore + 1);
116
+ await expect(col1.items().getByRole('heading', { name: draggedLabel! })).toBeVisible();
117
+ });
118
+
119
+ test('drag into empty column', async () => {
120
+ const col0 = board.column(0);
121
+ const col2 = board.column(2);
122
+
123
+ const col0CountBefore = await col0.items().count();
124
+ await expect(col2.items()).toHaveCount(0);
125
+ const draggedLabel = await col0.item(0).title().textContent();
126
+
127
+ // Drag into the empty column body area.
128
+ await col0.item(0).dragTo(col2.header(), { x: 0, y: BELOW_OFFSET });
129
+
130
+ await expect(col0.items()).toHaveCount(col0CountBefore - 1);
131
+ await expect(col2.items()).toHaveCount(1);
132
+ await expect(col2.item(0).title()).toHaveText(draggedLabel!);
133
+ });
134
+
135
+ test('create new item', async () => {
136
+ const column = board.column(0);
137
+ const countBefore = await column.items().count();
138
+
139
+ await column.addItem();
140
+
141
+ await expect(column.items()).toHaveCount(countBefore + 1);
142
+ });
143
+ });
@@ -15,44 +15,49 @@ const MIN_BLOCK_SIZE = 8;
15
15
  // Card container.
16
16
  //
17
17
 
18
- export const CardContainer = ({
19
- children,
20
- icon = 'ph--placeholder--regular',
21
- role,
22
- }: PropsWithChildren<{ icon?: string; role?: string }>) => {
18
+ export type CardContainerProps = PropsWithChildren<{ role?: 'popover' | 'intrinsic'; icon?: string }>;
19
+
20
+ export const CardContainer = ({ children, role, icon = 'ph--arrow-line-down--regular' }: CardContainerProps) => {
23
21
  switch (role) {
24
- case 'card--popover':
25
- return <PopoverCardContainer icon={icon}>{children}</PopoverCardContainer>;
26
- case 'card--intrinsic':
22
+ case 'popover':
23
+ return (
24
+ <div role='none' className='flex justify-center'>
25
+ <PopoverCardContainer icon={icon}>{children}</PopoverCardContainer>
26
+ </div>
27
+ );
28
+ case 'intrinsic':
27
29
  default:
28
30
  return <IntrinsicCardContainer>{children}</IntrinsicCardContainer>;
29
31
  }
30
32
  };
31
33
 
32
- const border = 'relative border border-dashed border-subduedSeparator p-4 rounded-lg overflow-x-auto';
33
-
34
34
  //
35
35
  // Popover
36
36
  //
37
37
 
38
38
  export type PopoverCardContainerProps = PropsWithChildren<{ icon?: string }>;
39
39
 
40
- export const PopoverCardContainer = ({ children, icon = 'ph--placeholder--regular' }: PopoverCardContainerProps) => {
40
+ export const PopoverCardContainer = ({
41
+ children,
42
+ icon = 'ph--arrow-line-down--regular',
43
+ }: PopoverCardContainerProps) => {
41
44
  return (
42
45
  <Popover.Root open>
43
- <Popover.Content onOpenAutoFocus={(event) => event.preventDefault()}>
44
- <Popover.Viewport classNames='popover-card-width'>{children}</Popover.Viewport>
45
- <Popover.Arrow />
46
- </Popover.Content>
47
46
  <Popover.Trigger asChild>
48
- <Icon icon={icon} size={5} />
47
+ <Icon icon={icon} />
49
48
  </Popover.Trigger>
49
+ <Popover.Portal>
50
+ <Popover.Content onOpenAutoFocus={(event: Event) => event.preventDefault()}>
51
+ <Popover.Viewport classNames='dx-card-popover'>{children}</Popover.Viewport>
52
+ <Popover.Arrow />
53
+ </Popover.Content>
54
+ </Popover.Portal>
50
55
  </Popover.Root>
51
56
  );
52
57
  };
53
58
 
54
59
  //
55
- // Intrinsic card container (size constrained by card).
60
+ // Intrinsic card container (size constrained by card itself).
56
61
  //
57
62
 
58
63
  export type IntrinsicCardContainerProps = PropsWithChildren<{
@@ -74,8 +79,15 @@ export const IntrinsicCardContainer = ({
74
79
  });
75
80
 
76
81
  return (
77
- <div className={border} style={sizeStyle(size, 'horizontal')} {...resizeAttributes}>
78
- {children}
82
+ <div
83
+ role='none'
84
+ className='relative p-2 grid overflow-hidden border-2 border-dashed border-green-500 rounded-lg'
85
+ style={sizeStyle(size, 'horizontal')}
86
+ {...resizeAttributes}
87
+ >
88
+ <div role='none' className='dx-container flex flex-col'>
89
+ {children}
90
+ </div>
79
91
  <ResizeHandle
80
92
  side='inline-end'
81
93
  fallbackSize={DEFAULT_BLOCK_SIZE}
@@ -2,36 +2,50 @@
2
2
  // Copyright 2026 DXOS.org
3
3
  //
4
4
 
5
- import React, { useRef, useState } from 'react';
5
+ import React, { useMemo, useRef, useState } from 'react';
6
6
 
7
7
  import { Obj } from '@dxos/echo';
8
+ import { Card, Toolbar } from '@dxos/react-ui';
9
+ import { Menu, createMenuAction } from '@dxos/react-ui-menu';
8
10
  import { Json } from '@dxos/react-ui-syntax-highlighter';
9
11
 
10
- import { Card, Mosaic, type StackTileComponent } from '../components';
12
+ import { Focus, Mosaic, type MosaicStackTileComponent } from '../components';
11
13
 
12
- export const DefaultStackTile: StackTileComponent<Obj.Any> = (props) => {
14
+ export const DefaultStackTile: MosaicStackTileComponent<Obj.Any> = (props) => {
13
15
  const dragHandleRef = useRef<HTMLButtonElement>(null);
14
16
  const [open, setOpen] = useState(false);
17
+ const menuItems = useMemo(
18
+ () => [
19
+ createMenuAction('toggle-details', () => setOpen((prev) => !prev), {
20
+ label: open ? 'Hide details' : 'Show details',
21
+ icon: 'ph--placeholder--regular',
22
+ }),
23
+ ],
24
+ [open],
25
+ );
26
+
15
27
  return (
16
- <Mosaic.Tile {...props} className='border border-separator rounded-sm font-mono'>
17
- <Card.Toolbar>
18
- <Card.DragHandle ref={dragHandleRef} />
19
- <Card.Title>{Obj.getLabel(props.data) ?? props.data.id}</Card.Title>
20
- <Card.Menu
21
- items={[
22
- {
23
- label: open ? 'Hide details' : 'Show details',
24
- onClick: () => setOpen((open) => !open),
25
- },
26
- ]}
27
- />
28
- </Card.Toolbar>
29
- {open && (
30
- <Card.Row>
31
- <Json data={props.data} classNames='text-xs' />
32
- </Card.Row>
33
- )}
34
- </Mosaic.Tile>
28
+ <Menu.Root>
29
+ <Mosaic.Tile {...props} asChild>
30
+ <Focus.Item asChild>
31
+ <Card.Root className='dx-current dx-hover'>
32
+ <Card.Toolbar>
33
+ <Card.DragHandle ref={dragHandleRef} />
34
+ <Card.Title>{Obj.getLabel(props.data) ?? props.data.id}</Card.Title>
35
+ <Menu.Trigger asChild disabled={!menuItems?.length}>
36
+ <Toolbar.IconButton iconOnly variant='ghost' icon='ph--dots-three-vertical--regular' label='Menu' />
37
+ </Menu.Trigger>
38
+ <Menu.Content items={menuItems} />
39
+ </Card.Toolbar>
40
+ {open && (
41
+ <Card.Row>
42
+ <Json.Data data={props.data} classNames='text-xs' />
43
+ </Card.Row>
44
+ )}
45
+ </Card.Root>
46
+ </Focus.Item>
47
+ </Mosaic.Tile>
48
+ </Menu.Root>
35
49
  );
36
50
  };
37
51
 
@@ -3,7 +3,7 @@
3
3
  //
4
4
 
5
5
  export * from './decorator';
6
+ export * from './types';
6
7
 
7
- export * from './Board';
8
8
  export * from './CardContainer';
9
9
  export * from './DefaultStackTile';
@@ -0,0 +1,38 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ import * as Schema from 'effect/Schema';
6
+
7
+ import { Ref, Type } from '@dxos/echo';
8
+ import { ObjectId } from '@dxos/keys';
9
+
10
+ //
11
+ // Test Data
12
+ //
13
+
14
+ export const TestItem = Schema.Struct({
15
+ name: Schema.String,
16
+ description: Schema.optional(Schema.String),
17
+ label: Schema.optional(Schema.String),
18
+ }).pipe(
19
+ Type.object({
20
+ typename: 'com.example.type.item',
21
+ version: '0.1.0',
22
+ }),
23
+ );
24
+
25
+ export interface TestItem extends Schema.Schema.Type<typeof TestItem> {}
26
+
27
+ export const TestColumn = Schema.Struct({
28
+ id: ObjectId,
29
+ name: Schema.String,
30
+ items: Schema.mutable(Schema.Array(Ref.Ref(TestItem))),
31
+ }).pipe(
32
+ Type.object({
33
+ typename: 'com.example.type.column',
34
+ version: '0.1.0',
35
+ }),
36
+ );
37
+
38
+ export interface TestColumn extends Schema.Schema.Type<typeof TestColumn> {}
@@ -9,7 +9,11 @@ export const translationKey = '@dxos/react-ui-mosaic';
9
9
  export const translations = [
10
10
  {
11
11
  'en-US': {
12
- [translationKey]: {},
12
+ [translationKey]: {
13
+ 'action-menu.label': 'Actions',
14
+ 'add-item.label': 'Add item',
15
+ 'delete-menu.label': 'Delete',
16
+ },
13
17
  },
14
18
  },
15
19
  ] as const satisfies Resource[];