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

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 (186) hide show
  1. package/dist/lib/browser/chunk-7S4PIFKU.mjs +953 -0
  2. package/dist/lib/browser/chunk-7S4PIFKU.mjs.map +7 -0
  3. package/dist/lib/browser/index.mjs +596 -70
  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 +138 -0
  7. package/dist/lib/browser/playwright/index.mjs.map +7 -0
  8. package/dist/lib/browser/testing/index.mjs +61 -232
  9. package/dist/lib/browser/testing/index.mjs.map +4 -4
  10. package/dist/lib/node-esm/chunk-MK6KU66S.mjs +955 -0
  11. package/dist/lib/node-esm/chunk-MK6KU66S.mjs.map +7 -0
  12. package/dist/lib/node-esm/index.mjs +596 -70
  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 +140 -0
  16. package/dist/lib/node-esm/playwright/index.mjs.map +7 -0
  17. package/dist/lib/node-esm/testing/index.mjs +61 -232
  18. package/dist/lib/node-esm/testing/index.mjs.map +4 -4
  19. package/dist/types/src/components/Board/Board.d.ts +81 -0
  20. package/dist/types/src/components/Board/Board.d.ts.map +1 -0
  21. package/dist/types/src/components/{Mosaic/Mosaic.stories.d.ts → Board/Board.stories.d.ts} +15 -1
  22. package/dist/types/src/components/Board/Board.stories.d.ts.map +1 -0
  23. package/dist/types/src/components/Board/Column.d.ts +40 -0
  24. package/dist/types/src/components/Board/Column.d.ts.map +1 -0
  25. package/dist/types/src/components/Board/Item.d.ts +9 -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 +5 -4
  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 +42 -0
  34. package/dist/types/src/components/Mosaic/Container.d.ts.map +1 -0
  35. package/dist/types/src/components/Mosaic/Mosaic.d.ts +35 -118
  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/{Stack → Mosaic}/Stack.stories.d.ts +2 -2
  44. package/dist/types/src/components/Mosaic/Stack.stories.d.ts.map +1 -0
  45. package/dist/types/src/components/Mosaic/Tile.d.ts +48 -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/components/Board/Board.stories.tsx +273 -0
  81. package/src/components/Board/Board.tsx +191 -0
  82. package/src/components/Board/Column.tsx +300 -0
  83. package/src/components/Board/Item.tsx +116 -0
  84. package/src/components/{Layout → Board}/index.ts +1 -1
  85. package/src/components/Focus/Focus.tsx +26 -17
  86. package/src/components/Focus/index.ts +0 -2
  87. package/src/components/Mosaic/Container.tsx +289 -0
  88. package/src/components/Mosaic/Mosaic.tsx +35 -913
  89. package/src/components/Mosaic/Placeholder.tsx +133 -0
  90. package/src/components/Mosaic/Root.tsx +292 -0
  91. package/src/components/{Stack → Mosaic}/Stack.stories.tsx +30 -26
  92. package/src/components/Mosaic/Stack.tsx +246 -0
  93. package/src/components/Mosaic/Tile.tsx +242 -0
  94. package/src/components/Mosaic/extension.ts +1 -1
  95. package/src/components/Mosaic/styles.ts +9 -8
  96. package/src/components/Mosaic/types.ts +15 -3
  97. package/src/components/index.ts +1 -4
  98. package/src/hooks/index.ts +1 -0
  99. package/src/hooks/useContainerDebug.tsx +4 -2
  100. package/src/hooks/useDefaultColumnEventHandler.ts +35 -0
  101. package/src/hooks/useEventHandlerAdapter.ts +15 -6
  102. package/src/hooks/useVisibleItems.ts +7 -2
  103. package/src/playwright/board-manager.ts +154 -0
  104. package/src/playwright/index.ts +13 -0
  105. package/src/playwright/playwright.config.ts +17 -0
  106. package/src/playwright/smoke.spec.ts +138 -0
  107. package/src/testing/CardContainer.tsx +30 -18
  108. package/src/testing/DefaultStackTile.tsx +27 -16
  109. package/src/testing/index.ts +1 -1
  110. package/src/testing/types.ts +38 -0
  111. package/src/translations.ts +5 -1
  112. package/dist/lib/browser/chunk-UMBPEG4F.mjs +0 -1637
  113. package/dist/lib/browser/chunk-UMBPEG4F.mjs.map +0 -7
  114. package/dist/lib/browser/index.css +0 -13
  115. package/dist/lib/browser/index.css.map +0 -7
  116. package/dist/lib/browser/testing/index.css +0 -13
  117. package/dist/lib/browser/testing/index.css.map +0 -7
  118. package/dist/lib/node-esm/chunk-X6GV7SMK.mjs +0 -1639
  119. package/dist/lib/node-esm/chunk-X6GV7SMK.mjs.map +0 -7
  120. package/dist/lib/node-esm/index.css +0 -13
  121. package/dist/lib/node-esm/index.css.map +0 -7
  122. package/dist/lib/node-esm/testing/index.css +0 -13
  123. package/dist/lib/node-esm/testing/index.css.map +0 -7
  124. package/dist/types/src/components/Card/Card.d.ts +0 -121
  125. package/dist/types/src/components/Card/Card.d.ts.map +0 -1
  126. package/dist/types/src/components/Card/Card.stories.d.ts +0 -21
  127. package/dist/types/src/components/Card/Card.stories.d.ts.map +0 -1
  128. package/dist/types/src/components/Card/CardDragPreview.d.ts +0 -6
  129. package/dist/types/src/components/Card/CardDragPreview.d.ts.map +0 -1
  130. package/dist/types/src/components/Card/index.d.ts +0 -4
  131. package/dist/types/src/components/Card/index.d.ts.map +0 -1
  132. package/dist/types/src/components/Card/styles.d.ts +0 -13
  133. package/dist/types/src/components/Card/styles.d.ts.map +0 -1
  134. package/dist/types/src/components/Focus/styles.d.ts +0 -6
  135. package/dist/types/src/components/Focus/styles.d.ts.map +0 -1
  136. package/dist/types/src/components/Image/Image.d.ts +0 -14
  137. package/dist/types/src/components/Image/Image.d.ts.map +0 -1
  138. package/dist/types/src/components/Image/Image.stories.d.ts +0 -33
  139. package/dist/types/src/components/Image/Image.stories.d.ts.map +0 -1
  140. package/dist/types/src/components/Image/index.d.ts +0 -2
  141. package/dist/types/src/components/Image/index.d.ts.map +0 -1
  142. package/dist/types/src/components/Layout/Layout.d.ts +0 -33
  143. package/dist/types/src/components/Layout/Layout.d.ts.map +0 -1
  144. package/dist/types/src/components/Layout/Layout.stories.d.ts +0 -10
  145. package/dist/types/src/components/Layout/Layout.stories.d.ts.map +0 -1
  146. package/dist/types/src/components/Layout/index.d.ts +0 -2
  147. package/dist/types/src/components/Layout/index.d.ts.map +0 -1
  148. package/dist/types/src/components/Mosaic/Mosaic.stories.d.ts.map +0 -1
  149. package/dist/types/src/components/Scrollable/Scrollable.d.ts +0 -24
  150. package/dist/types/src/components/Scrollable/Scrollable.d.ts.map +0 -1
  151. package/dist/types/src/components/Scrollable/Scrollable.stories.d.ts +0 -10
  152. package/dist/types/src/components/Scrollable/Scrollable.stories.d.ts.map +0 -1
  153. package/dist/types/src/components/Scrollable/index.d.ts +0 -2
  154. package/dist/types/src/components/Scrollable/index.d.ts.map +0 -1
  155. package/dist/types/src/components/Stack/Stack.d.ts +0 -22
  156. package/dist/types/src/components/Stack/Stack.d.ts.map +0 -1
  157. package/dist/types/src/components/Stack/Stack.stories.d.ts.map +0 -1
  158. package/dist/types/src/components/Stack/index.d.ts +0 -2
  159. package/dist/types/src/components/Stack/index.d.ts.map +0 -1
  160. package/dist/types/src/testing/Board.d.ts +0 -45
  161. package/dist/types/src/testing/Board.d.ts.map +0 -1
  162. package/dist/types/src/testing/Slot.stories.d.ts +0 -14
  163. package/dist/types/src/testing/Slot.stories.d.ts.map +0 -1
  164. package/dist/types/src/testing/Virtualizer.stories.d.ts +0 -12
  165. package/dist/types/src/testing/Virtualizer.stories.d.ts.map +0 -1
  166. package/src/components/Card/Card.stories.tsx +0 -148
  167. package/src/components/Card/Card.tsx +0 -458
  168. package/src/components/Card/CardDragPreview.tsx +0 -23
  169. package/src/components/Card/index.ts +0 -8
  170. package/src/components/Card/styles.ts +0 -23
  171. package/src/components/Focus/styles.ts +0 -24
  172. package/src/components/Image/Image.stories.tsx +0 -86
  173. package/src/components/Image/Image.tsx +0 -223
  174. package/src/components/Image/index.ts +0 -5
  175. package/src/components/Layout/Layout.stories.tsx +0 -59
  176. package/src/components/Layout/Layout.tsx +0 -108
  177. package/src/components/Mosaic/Mosaic.stories.tsx +0 -113
  178. package/src/components/Scrollable/Scrollable.stories.tsx +0 -59
  179. package/src/components/Scrollable/Scrollable.tsx +0 -88
  180. package/src/components/Scrollable/index.ts +0 -5
  181. package/src/components/Scrollable/scrollable.css +0 -20
  182. package/src/components/Stack/Stack.tsx +0 -210
  183. package/src/components/Stack/index.ts +0 -5
  184. package/src/testing/Board.tsx +0 -278
  185. package/src/testing/Slot.stories.tsx +0 -101
  186. package/src/testing/Virtualizer.stories.tsx +0 -133
@@ -0,0 +1,300 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ import { useAtomValue } from '@effect-atom/atom-react';
6
+ import { createContext } from '@radix-ui/react-context';
7
+ import React, {
8
+ type PropsWithChildren,
9
+ type ReactElement,
10
+ type Ref as ReactRef,
11
+ type RefObject,
12
+ forwardRef,
13
+ useMemo,
14
+ useRef,
15
+ useState,
16
+ } from 'react';
17
+
18
+ import { Obj, Ref } from '@dxos/echo';
19
+ import { useObject } from '@dxos/react-client/echo';
20
+ import { IconButton, ScrollArea, type ThemedClassName, Toolbar, useTranslation } from '@dxos/react-ui';
21
+ import { Menu, createMenuAction } from '@dxos/react-ui-menu';
22
+ import { mx } from '@dxos/ui-theme';
23
+
24
+ import { useContainerDebug, useEventHandlerAdapter } from '../../hooks';
25
+ import { translationKey } from '../../translations';
26
+ import { Focus } from '../Focus';
27
+ import { Mosaic, type MosaicContainerProps, type MosaicStackProps, type MosaicTileProps } from '../Mosaic';
28
+
29
+ import { useBoard } from './Board';
30
+ import { BoardItem } from './Item';
31
+
32
+ //
33
+ // Column context
34
+ //
35
+
36
+ const BOARD_COLUMN_CONTEXT_NAME = 'Board.Column';
37
+
38
+ export type BoardColumnContextValue<TColumn = unknown> = {
39
+ column: TColumn;
40
+ };
41
+
42
+ const [BoardColumnProvider, useBoardColumnContext] = createContext<BoardColumnContextValue | null>(
43
+ BOARD_COLUMN_CONTEXT_NAME,
44
+ null,
45
+ );
46
+
47
+ /** Returns the current column when rendered inside a board column (e.g., in column header or item tile). */
48
+ export function useBoardColumn<TColumn = unknown>(): TColumn | undefined {
49
+ const value = useBoardColumnContext(BOARD_COLUMN_CONTEXT_NAME);
50
+ return value?.column as TColumn | undefined;
51
+ }
52
+
53
+ type BoardColumnProps<TColumn = any> = Pick<MosaicTileProps<TColumn>, 'classNames' | 'location' | 'data' | 'debug'>;
54
+
55
+ //
56
+ // Column Root
57
+ //
58
+
59
+ const BOARD_COLUMN_ROOT_NAME = 'Board.Column.Root';
60
+
61
+ type BoardColumnRootProps<TColumn = any> = PropsWithChildren<BoardColumnProps<TColumn>> & {
62
+ dragHandleRef?: RefObject<HTMLButtonElement | null>;
63
+ };
64
+
65
+ const BoardColumnRootInner = forwardRef<HTMLDivElement, BoardColumnRootProps>(
66
+ ({ classNames, children, location, data, debug, dragHandleRef: dragHandleRefProp, ...rest }, forwardedRef) => {
67
+ const { model } = useBoard(BOARD_COLUMN_ROOT_NAME);
68
+
69
+ // TODO(burdon): Use merge ref hook (see react-hooks).
70
+ const internalRef = useRef<HTMLButtonElement>(null);
71
+ const dragHandleRef = dragHandleRefProp ?? internalRef;
72
+
73
+ return (
74
+ <Mosaic.Tile
75
+ asChild
76
+ location={location}
77
+ id={model.getColumnId(data)}
78
+ data={data}
79
+ debug={debug}
80
+ dragHandle={dragHandleRef.current}
81
+ >
82
+ <Focus.Group
83
+ {...rest}
84
+ data-testid='board-column'
85
+ classNames={mx(
86
+ // NOTE: Reserves 2px for outer Focus.Group border.
87
+ 'group/column h-full overflow-hidden w-[calc(100vw-2px)] md:w-card-default-width snap-center bg-deck-surface',
88
+ classNames,
89
+ )}
90
+ ref={forwardedRef}
91
+ >
92
+ <BoardColumnProvider column={data}>{children}</BoardColumnProvider>
93
+ </Focus.Group>
94
+ </Mosaic.Tile>
95
+ );
96
+ },
97
+ );
98
+
99
+ BoardColumnRootInner.displayName = BOARD_COLUMN_ROOT_NAME;
100
+
101
+ const BoardColumnRoot = BoardColumnRootInner as <TColumn = unknown>(
102
+ props: BoardColumnRootProps<TColumn> & { ref?: ReactRef<HTMLDivElement> },
103
+ ) => ReactElement;
104
+
105
+ //
106
+ // Column Header
107
+ //
108
+
109
+ const BOARD_COLUMN_HEADER_NAME = 'Board.Column.Header';
110
+
111
+ type BoardColumnHeaderProps = ThemedClassName<{ label: string; dragHandleRef: ReactRef<HTMLButtonElement> }>;
112
+
113
+ const BoardColumnHeader = forwardRef<HTMLDivElement, BoardColumnHeaderProps>(
114
+ ({ classNames, label, dragHandleRef }, forwardedRef) => {
115
+ const { t } = useTranslation(translationKey);
116
+ const { model } = useBoard(BOARD_COLUMN_HEADER_NAME);
117
+ const column = useBoardColumn();
118
+ const columnMenuItems = useMemo(
119
+ () =>
120
+ column != null && model.onColumnDelete
121
+ ? [
122
+ createMenuAction('delete-column', () => model.onColumnDelete?.(column), {
123
+ label: t('delete menu label'),
124
+ icon: 'ph--trash--regular',
125
+ }),
126
+ ]
127
+ : [],
128
+ [column, model.onColumnDelete, t],
129
+ );
130
+
131
+ return (
132
+ <Menu.Root>
133
+ <Toolbar.Root
134
+ classNames={mx('border-b border-separator', classNames)}
135
+ data-testid='board-column-header'
136
+ ref={forwardedRef}
137
+ >
138
+ <Toolbar.DragHandle ref={dragHandleRef} />
139
+ <Toolbar.Text>{label}</Toolbar.Text>
140
+ {/* TODO(wittjosiah): Reconcile with Card.Menu. */}
141
+ <Menu.Trigger asChild disabled={!columnMenuItems?.length}>
142
+ <Toolbar.IconButton
143
+ iconOnly
144
+ variant='ghost'
145
+ icon='ph--dots-three-vertical--regular'
146
+ label={t('action menu label')}
147
+ />
148
+ </Menu.Trigger>
149
+ <Menu.Content items={columnMenuItems} />
150
+ </Toolbar.Root>
151
+ </Menu.Root>
152
+ );
153
+ },
154
+ );
155
+
156
+ BoardColumnHeader.displayName = BOARD_COLUMN_HEADER_NAME;
157
+
158
+ //
159
+ // Column Body
160
+ //
161
+
162
+ const BOARD_COLUMN_BODY_NAME = 'Board.Column.Body';
163
+
164
+ type BoardColumnBodyProps = Pick<BoardColumnProps, 'data'> &
165
+ Pick<MosaicContainerProps, 'eventHandler' | 'debug'> & {
166
+ Tile?: MosaicStackProps<Obj.Unknown>['Tile'];
167
+ };
168
+
169
+ const BoardColumnBody = ({ data, eventHandler, Tile = BoardItem, debug }: BoardColumnBodyProps) => {
170
+ const { model } = useBoard(BOARD_COLUMN_BODY_NAME);
171
+ const [viewport, setViewport] = useState<HTMLElement | null>(null);
172
+ const items = useAtomValue(model.items(data));
173
+
174
+ return (
175
+ <Mosaic.Container
176
+ asChild
177
+ withFocus
178
+ orientation='vertical'
179
+ autoScroll={viewport}
180
+ eventHandler={eventHandler}
181
+ debug={debug}
182
+ >
183
+ <ScrollArea.Root orientation='vertical' thin margin padding>
184
+ <ScrollArea.Viewport classNames='snap-y md:snap-none' ref={setViewport}>
185
+ <Mosaic.Stack items={items} getId={model.getItemId} Tile={Tile} />
186
+ </ScrollArea.Viewport>
187
+ </ScrollArea.Root>
188
+ </Mosaic.Container>
189
+ );
190
+ };
191
+
192
+ BoardColumnBody.displayName = BOARD_COLUMN_BODY_NAME;
193
+
194
+ //
195
+ // Column Footer
196
+ //
197
+
198
+ const BOARD_COLUMN_FOOTER_NAME = 'Board.Column.Footer';
199
+
200
+ type BoardColumnFooterProps = ThemedClassName & {
201
+ data?: any;
202
+ onAdd?: () => void;
203
+ };
204
+
205
+ const BoardColumnFooter = forwardRef<HTMLDivElement, BoardColumnFooterProps>(
206
+ ({ classNames, data, onAdd }, forwardedRef) => {
207
+ const { t } = useTranslation(translationKey);
208
+ const { model } = useBoard(BOARD_COLUMN_FOOTER_NAME);
209
+
210
+ const handleAdd = onAdd ?? (model.onItemCreate && data ? () => void model.onItemCreate?.(data) : undefined);
211
+
212
+ return (
213
+ <Toolbar.Root classNames={mx('rounded-b-sm border-t border-separator', classNames)} ref={forwardedRef}>
214
+ {handleAdd && (
215
+ <IconButton
216
+ data-testid='board-column-add-item'
217
+ classNames='group-hover/column:opacity-100 md:opacity-0 transition transition-opacity duration-500'
218
+ variant='ghost'
219
+ icon='ph--plus--regular'
220
+ iconOnly
221
+ label={t('add item label')}
222
+ onClick={handleAdd}
223
+ />
224
+ )}
225
+ </Toolbar.Root>
226
+ );
227
+ },
228
+ );
229
+
230
+ BoardColumnFooter.displayName = BOARD_COLUMN_FOOTER_NAME;
231
+
232
+ //
233
+ // DefaultBoardColumn
234
+ //
235
+
236
+ const BOARD_DEFAULT_COLUMN_NAME = 'Board.DefaultColumn';
237
+
238
+ type DefaultBoardColumnProps = BoardColumnProps & Pick<BoardColumnBodyProps, 'Tile'>;
239
+
240
+ const DefaultBoardColumn = forwardRef<HTMLDivElement, DefaultBoardColumnProps>(
241
+ ({ classNames, location, data, debug, Tile = BoardItem }, forwardedRef) => {
242
+ const { model } = useBoard(BOARD_DEFAULT_COLUMN_NAME);
243
+ const [DebugInfo, debugHandler] = useContainerDebug(debug);
244
+ const dragHandleRef = useRef<HTMLButtonElement>(null);
245
+ const [column, updateColumn] = useObject(data);
246
+
247
+ const eventHandler = useEventHandlerAdapter<Ref.Unknown>({
248
+ id: model.getColumnId(data),
249
+ items: column?.items ?? [],
250
+ getId: (ref) => ref.target?.id ?? ref.dxn.toString(),
251
+ get: (refOrObj) => (Ref.isRef(refOrObj) ? refOrObj.target! : refOrObj),
252
+ make: (object) => Ref.make(object),
253
+ canDrop: ({ source }) => {
254
+ const item = Ref.isRef(source.data) ? source.data.target : source.data;
255
+ return item != null && Obj.isObject(item) && model.isItem(item);
256
+ },
257
+ onChange: (mutator) => updateColumn((col) => mutator(col.items)),
258
+ });
259
+
260
+ return (
261
+ <BoardColumnRootInner
262
+ classNames={mx(
263
+ 'group/column grid',
264
+ debug
265
+ ? 'grid-rows-[var(--dx-rail-action)_1fr_20rem]'
266
+ : 'grid-rows-[var(--dx-rail-action)_1fr_var(--dx-rail-action)]',
267
+ classNames,
268
+ )}
269
+ location={location}
270
+ data={data}
271
+ dragHandleRef={dragHandleRef}
272
+ ref={forwardedRef}
273
+ >
274
+ <BoardColumnHeader label={Obj.getLabel(data) ?? data.id} dragHandleRef={dragHandleRef} />
275
+ <BoardColumnBody data={data} eventHandler={eventHandler} debug={debugHandler} Tile={Tile} />
276
+ <div role='none' className='flex flex-col col-span-full'>
277
+ <BoardColumnFooter data={data} />
278
+ <DebugInfo />
279
+ </div>
280
+ </BoardColumnRootInner>
281
+ );
282
+ },
283
+ );
284
+
285
+ DefaultBoardColumn.displayName = BOARD_DEFAULT_COLUMN_NAME;
286
+
287
+ //
288
+ // BoardColumn
289
+ //
290
+
291
+ export const BoardColumn = {
292
+ Root: BoardColumnRoot,
293
+ Header: BoardColumnHeader,
294
+ Body: BoardColumnBody,
295
+ Footer: BoardColumnFooter,
296
+ };
297
+
298
+ export { DefaultBoardColumn };
299
+
300
+ export { type BoardColumnProps };
@@ -0,0 +1,116 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ import { useComposedRefs } from '@radix-ui/react-compose-refs';
6
+ import React, { type ReactElement, type Ref as ReactRef, forwardRef, useMemo, useRef } from 'react';
7
+
8
+ import { Obj } from '@dxos/echo';
9
+ import { Card, Tag, Toolbar, useTranslation } from '@dxos/react-ui';
10
+ import { Menu, createMenuAction } from '@dxos/react-ui-menu';
11
+ import { getHashStyles } from '@dxos/ui-theme';
12
+
13
+ import { translationKey } from '../../translations';
14
+ import { Focus } from '../Focus';
15
+ import { Mosaic, type MosaicTileProps } from '../Mosaic';
16
+
17
+ import { useBoard } from './Board';
18
+ import { useBoardColumn } from './Column';
19
+
20
+ //
21
+ // Item
22
+ //
23
+
24
+ const BOARD_ITEM_NAME = 'Board.Item';
25
+
26
+ type BoardItemProps<TItem extends Obj.Unknown = any> = Pick<
27
+ MosaicTileProps<TItem>,
28
+ 'classNames' | 'location' | 'data' | 'debug'
29
+ >;
30
+
31
+ const BoardItemInner = forwardRef<HTMLDivElement, BoardItemProps>(
32
+ ({ classNames, data, location, debug }, forwardedRef) => {
33
+ const { t } = useTranslation(translationKey);
34
+ const rootRef = useRef<HTMLDivElement>(null);
35
+ const composedRef = useComposedRefs<HTMLDivElement>(rootRef, forwardedRef);
36
+ const dragHandleRef = useRef<HTMLButtonElement>(null);
37
+
38
+ const { model } = useBoard(BOARD_ITEM_NAME);
39
+ const column = useBoardColumn();
40
+ const items = useMemo(
41
+ () =>
42
+ column != null && model.onItemDelete
43
+ ? [
44
+ createMenuAction('delete-item', () => model.onItemDelete?.(column, data), {
45
+ label: t('delete menu label'),
46
+ icon: 'ph--trash--regular',
47
+ }),
48
+ ]
49
+ : [],
50
+ [column, data, model.onItemDelete, t],
51
+ );
52
+
53
+ if (!data) {
54
+ return null;
55
+ }
56
+
57
+ const label = Obj.getLabel(data);
58
+ const description = Obj.getDescription(data);
59
+
60
+ return (
61
+ <Mosaic.Tile
62
+ asChild
63
+ dragHandle={dragHandleRef.current}
64
+ id={data.id}
65
+ data={data}
66
+ location={location}
67
+ debug={debug}
68
+ >
69
+ <Focus.Group asChild>
70
+ <Menu.Root>
71
+ <Card.Root
72
+ classNames={classNames}
73
+ data-testid='board-item'
74
+ onClick={() => rootRef.current?.focus()}
75
+ ref={composedRef}
76
+ >
77
+ <Card.Toolbar>
78
+ <Card.DragHandle ref={dragHandleRef} />
79
+ <Card.Title>{label}</Card.Title>
80
+ {/* TODO(wittjosiah): Reconcile with Card.Menu. */}
81
+ <Menu.Trigger asChild disabled={!items?.length}>
82
+ <Toolbar.IconButton
83
+ iconOnly
84
+ variant='ghost'
85
+ icon='ph--dots-three-vertical--regular'
86
+ label={t('action menu label')}
87
+ />
88
+ </Menu.Trigger>
89
+ <Menu.Content items={items} />
90
+ </Card.Toolbar>
91
+ {/* TODO(burdon): Replace with surface. */}
92
+ <Card.Row icon='ph--note--regular' classNames='text-description'>
93
+ {description}
94
+ </Card.Row>
95
+ <Card.Row icon='ph--tag--regular'>
96
+ {label && (
97
+ <div role='none' className='shrink-0 flex gap-1 items-center text-xs'>
98
+ <Tag palette={getHashStyles(label).hue}>{label}</Tag>
99
+ </div>
100
+ )}
101
+ </Card.Row>
102
+ </Card.Root>
103
+ </Menu.Root>
104
+ </Focus.Group>
105
+ </Mosaic.Tile>
106
+ );
107
+ },
108
+ );
109
+
110
+ BoardItemInner.displayName = BOARD_ITEM_NAME;
111
+
112
+ const BoardItem = BoardItemInner as <TItem extends Obj.Unknown = any>(
113
+ props: BoardItemProps<TItem> & { ref?: ReactRef<HTMLDivElement> },
114
+ ) => ReactElement;
115
+
116
+ export { BoardItem, type BoardItemProps };
@@ -2,4 +2,4 @@
2
2
  // Copyright 2026 DXOS.org
3
3
  //
4
4
 
5
- export * from './Layout';
5
+ export * from './Board';
@@ -3,7 +3,6 @@
3
3
  //
4
4
 
5
5
  import {
6
- type UseArrowNavigationGroupOptions,
7
6
  useArrowNavigationGroup,
8
7
  useFocusableGroup,
9
8
  useMergedTabsterAttributes_unstable,
@@ -13,11 +12,9 @@ import { Primitive } from '@radix-ui/react-primitive';
13
12
  import { Slot } from '@radix-ui/react-slot';
14
13
  import React, { type PropsWithChildren, createContext, forwardRef, useContext, useRef, useState } from 'react';
15
14
 
16
- import { type ThemedClassName } from '@dxos/react-ui';
15
+ import { type Axis, type ThemedClassName } from '@dxos/react-ui';
17
16
  import { mx } from '@dxos/ui-theme';
18
17
 
19
- import { styles } from './styles';
20
-
21
18
  //
22
19
  // Context
23
20
  //
@@ -39,27 +36,26 @@ const useFocus = () => useContext(FocusContext);
39
36
  //
40
37
 
41
38
  type GroupProps = ThemedClassName<
42
- PropsWithChildren<
43
- {
44
- asChild?: boolean;
45
- } & Pick<UseArrowNavigationGroupOptions, 'axis'>
46
- >
39
+ PropsWithChildren<{
40
+ asChild?: boolean;
41
+ orientation?: Axis;
42
+ }>
47
43
  > & { className?: string };
48
44
 
49
45
  // TODO(wittjosiah): Consider how this could integrate with with react-ui-attention.
50
46
  // Perhaps react-ui-attention comes under the mosaic umbrella as it supports selection?
51
47
  const Group = forwardRef<HTMLDivElement, GroupProps>(
52
- ({ classNames, className, children, asChild, axis = 'vertical', ...props }: GroupProps, forwardedRef) => {
48
+ ({ classNames, className, children, asChild, orientation = 'vertical', ...props }: GroupProps, forwardedRef) => {
53
49
  const rootRef = useRef<HTMLDivElement>(null);
54
50
  const composedRef = useComposedRefs<HTMLDivElement>(rootRef, forwardedRef);
55
- const Root = asChild ? Slot : Primitive.div;
51
+ const Comp = asChild ? Slot : Primitive.div;
56
52
 
57
53
  // TODO(burdon): Configure.
58
54
  const focusableGroupAttrs = useFocusableGroup({
59
55
  tabBehavior: 'limited-trap-focus',
60
56
  });
61
57
  const arrowNavigationAttrs = useArrowNavigationGroup({
62
- axis,
58
+ axis: orientation,
63
59
  memorizeCurrent: true,
64
60
  });
65
61
  const tabsterAttrs = useMergedTabsterAttributes_unstable(focusableGroupAttrs, arrowNavigationAttrs);
@@ -67,18 +63,31 @@ const Group = forwardRef<HTMLDivElement, GroupProps>(
67
63
 
68
64
  return (
69
65
  <FocusContext.Provider value={{ setFocus: setState }}>
70
- <Root
71
- tabIndex={0}
72
- className={mx(styles.container.root, className, classNames)}
66
+ <Comp
67
+ {...props}
73
68
  {...tabsterAttrs}
74
69
  {...(state && {
75
70
  [`data-${FOCUS_STATE_ATTR}`]: state,
76
71
  })}
77
- {...props}
72
+ tabIndex={0}
73
+ className={mx(
74
+ [
75
+ // TODO(burdon): Option for border/rounded; ring/outline vs border?
76
+ 'outline-hidden border border-separator md:rounded-xs',
77
+ // Focus (e.g., via tabster).
78
+ 'focus:!border-accent-surface',
79
+ // Active (e.g., drop target).
80
+ 'data-[focus-state=active]:border-neutral-focus-indicator',
81
+ // Error
82
+ 'data-[focus-state=error]:border-rose-500',
83
+ ],
84
+ className,
85
+ classNames,
86
+ )}
78
87
  ref={composedRef}
79
88
  >
80
89
  {children}
81
- </Root>
90
+ </Comp>
82
91
  </FocusContext.Provider>
83
92
  );
84
93
  },
@@ -2,6 +2,4 @@
2
2
  // Copyright 2026 DXOS.org
3
3
  //
4
4
 
5
- export { styles as focusStyles } from './styles';
6
-
7
5
  export * from './Focus';