@dxos/react-ui-graph 0.8.2-main.10c050d

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 (206) hide show
  1. package/LICENSE +8 -0
  2. package/README.md +25 -0
  3. package/dist/lib/browser/chunk-2YMRPQU7.mjs +979 -0
  4. package/dist/lib/browser/chunk-2YMRPQU7.mjs.map +7 -0
  5. package/dist/lib/browser/index.mjs +1546 -0
  6. package/dist/lib/browser/index.mjs.map +7 -0
  7. package/dist/lib/browser/meta.json +1 -0
  8. package/dist/lib/browser/testing/index.mjs +180 -0
  9. package/dist/lib/browser/testing/index.mjs.map +7 -0
  10. package/dist/lib/node/chunk-WFHWEMPB.cjs +919 -0
  11. package/dist/lib/node/chunk-WFHWEMPB.cjs.map +7 -0
  12. package/dist/lib/node/index.cjs +1547 -0
  13. package/dist/lib/node/index.cjs.map +7 -0
  14. package/dist/lib/node/meta.json +1 -0
  15. package/dist/lib/node/testing/index.cjs +214 -0
  16. package/dist/lib/node/testing/index.cjs.map +7 -0
  17. package/dist/lib/node-esm/chunk-ITHTKQOY.mjs +981 -0
  18. package/dist/lib/node-esm/chunk-ITHTKQOY.mjs.map +7 -0
  19. package/dist/lib/node-esm/index.mjs +1547 -0
  20. package/dist/lib/node-esm/index.mjs.map +7 -0
  21. package/dist/lib/node-esm/meta.json +1 -0
  22. package/dist/lib/node-esm/testing/index.mjs +181 -0
  23. package/dist/lib/node-esm/testing/index.mjs.map +7 -0
  24. package/dist/types/src/components/Graph/Graph.d.ts +26 -0
  25. package/dist/types/src/components/Graph/Graph.d.ts.map +1 -0
  26. package/dist/types/src/components/Graph/Graph.stories.d.ts +29 -0
  27. package/dist/types/src/components/Graph/Graph.stories.d.ts.map +1 -0
  28. package/dist/types/src/components/Graph/index.d.ts +2 -0
  29. package/dist/types/src/components/Graph/index.d.ts.map +1 -0
  30. package/dist/types/src/components/Mesh/Mesh.d.ts +6 -0
  31. package/dist/types/src/components/Mesh/Mesh.d.ts.map +1 -0
  32. package/dist/types/src/components/Mesh/Mesh.stories.d.ts +12 -0
  33. package/dist/types/src/components/Mesh/Mesh.stories.d.ts.map +1 -0
  34. package/dist/types/src/components/Mesh/index.d.ts +2 -0
  35. package/dist/types/src/components/Mesh/index.d.ts.map +1 -0
  36. package/dist/types/src/components/SVG/Grid.d.ts +9 -0
  37. package/dist/types/src/components/SVG/Grid.d.ts.map +1 -0
  38. package/dist/types/src/components/SVG/Markers.d.ts +10 -0
  39. package/dist/types/src/components/SVG/Markers.d.ts.map +1 -0
  40. package/dist/types/src/components/SVG/Root.d.ts +12 -0
  41. package/dist/types/src/components/SVG/Root.d.ts.map +1 -0
  42. package/dist/types/src/components/SVG/SVG.d.ts +23 -0
  43. package/dist/types/src/components/SVG/SVG.d.ts.map +1 -0
  44. package/dist/types/src/components/SVG/Svg.stories.d.ts +17 -0
  45. package/dist/types/src/components/SVG/Svg.stories.d.ts.map +1 -0
  46. package/dist/types/src/components/SVG/Zoom.d.ts +12 -0
  47. package/dist/types/src/components/SVG/Zoom.d.ts.map +1 -0
  48. package/dist/types/src/components/SVG/index.d.ts +2 -0
  49. package/dist/types/src/components/SVG/index.d.ts.map +1 -0
  50. package/dist/types/src/components/index.d.ts +4 -0
  51. package/dist/types/src/components/index.d.ts.map +1 -0
  52. package/dist/types/src/fx/fx.stories.d.ts +19 -0
  53. package/dist/types/src/fx/fx.stories.d.ts.map +1 -0
  54. package/dist/types/src/fx/index.d.ts +2 -0
  55. package/dist/types/src/fx/index.d.ts.map +1 -0
  56. package/dist/types/src/fx/pulsar.d.ts +17 -0
  57. package/dist/types/src/fx/pulsar.d.ts.map +1 -0
  58. package/dist/types/src/graph/index.d.ts +5 -0
  59. package/dist/types/src/graph/index.d.ts.map +1 -0
  60. package/dist/types/src/graph/markers.d.ts +11 -0
  61. package/dist/types/src/graph/markers.d.ts.map +1 -0
  62. package/dist/types/src/graph/projector/graph-drag.d.ts +16 -0
  63. package/dist/types/src/graph/projector/graph-drag.d.ts.map +1 -0
  64. package/dist/types/src/graph/projector/graph-force-projector.d.ts +96 -0
  65. package/dist/types/src/graph/projector/graph-force-projector.d.ts.map +1 -0
  66. package/dist/types/src/graph/projector/graph-forces.d.ts +8 -0
  67. package/dist/types/src/graph/projector/graph-forces.d.ts.map +1 -0
  68. package/dist/types/src/graph/projector/graph-hierarchical-projector.d.ts +14 -0
  69. package/dist/types/src/graph/projector/graph-hierarchical-projector.d.ts.map +1 -0
  70. package/dist/types/src/graph/projector/graph-projector.d.ts +25 -0
  71. package/dist/types/src/graph/projector/graph-projector.d.ts.map +1 -0
  72. package/dist/types/src/graph/projector/graph-radial-projector.d.ts +34 -0
  73. package/dist/types/src/graph/projector/graph-radial-projector.d.ts.map +1 -0
  74. package/dist/types/src/graph/projector/graph-relational-projector.d.ts +14 -0
  75. package/dist/types/src/graph/projector/graph-relational-projector.d.ts.map +1 -0
  76. package/dist/types/src/graph/projector/index.d.ts +8 -0
  77. package/dist/types/src/graph/projector/index.d.ts.map +1 -0
  78. package/dist/types/src/graph/projector/projector.d.ts +32 -0
  79. package/dist/types/src/graph/projector/projector.d.ts.map +1 -0
  80. package/dist/types/src/graph/renderer/bullets.d.ts +16 -0
  81. package/dist/types/src/graph/renderer/bullets.d.ts.map +1 -0
  82. package/dist/types/src/graph/renderer/graph-renderer.d.ts +43 -0
  83. package/dist/types/src/graph/renderer/graph-renderer.d.ts.map +1 -0
  84. package/dist/types/src/graph/renderer/index.d.ts +4 -0
  85. package/dist/types/src/graph/renderer/index.d.ts.map +1 -0
  86. package/dist/types/src/graph/renderer/linker.d.ts +12 -0
  87. package/dist/types/src/graph/renderer/linker.d.ts.map +1 -0
  88. package/dist/types/src/graph/renderer/renderer.d.ts +20 -0
  89. package/dist/types/src/graph/renderer/renderer.d.ts.map +1 -0
  90. package/dist/types/src/graph/types.d.ts +52 -0
  91. package/dist/types/src/graph/types.d.ts.map +1 -0
  92. package/dist/types/src/hooks/index.d.ts +5 -0
  93. package/dist/types/src/hooks/index.d.ts.map +1 -0
  94. package/dist/types/src/hooks/useGrid.d.ts +24 -0
  95. package/dist/types/src/hooks/useGrid.d.ts.map +1 -0
  96. package/dist/types/src/hooks/useStateRef.d.ts +22 -0
  97. package/dist/types/src/hooks/useStateRef.d.ts.map +1 -0
  98. package/dist/types/src/hooks/useSvgContext.d.ts +41 -0
  99. package/dist/types/src/hooks/useSvgContext.d.ts.map +1 -0
  100. package/dist/types/src/hooks/useZoom.d.ts +34 -0
  101. package/dist/types/src/hooks/useZoom.d.ts.map +1 -0
  102. package/dist/types/src/index.d.ts +6 -0
  103. package/dist/types/src/index.d.ts.map +1 -0
  104. package/dist/types/src/stories/hooks.stories.d.ts +22 -0
  105. package/dist/types/src/stories/hooks.stories.d.ts.map +1 -0
  106. package/dist/types/src/testing/data.d.ts +27 -0
  107. package/dist/types/src/testing/data.d.ts.map +1 -0
  108. package/dist/types/src/testing/data.test.d.ts +2 -0
  109. package/dist/types/src/testing/data.test.d.ts.map +1 -0
  110. package/dist/types/src/testing/hooks.d.ts +42 -0
  111. package/dist/types/src/testing/hooks.d.ts.map +1 -0
  112. package/dist/types/src/testing/index.d.ts +4 -0
  113. package/dist/types/src/testing/index.d.ts.map +1 -0
  114. package/dist/types/src/testing/model.d.ts +14 -0
  115. package/dist/types/src/testing/model.d.ts.map +1 -0
  116. package/dist/types/src/util/d3-types.d.ts +5 -0
  117. package/dist/types/src/util/d3-types.d.ts.map +1 -0
  118. package/dist/types/src/util/events.d.ts +10 -0
  119. package/dist/types/src/util/events.d.ts.map +1 -0
  120. package/dist/types/src/util/fraction.d.ts +65 -0
  121. package/dist/types/src/util/fraction.d.ts.map +1 -0
  122. package/dist/types/src/util/fraction.test.d.ts +2 -0
  123. package/dist/types/src/util/fraction.test.d.ts.map +1 -0
  124. package/dist/types/src/util/index.d.ts +9 -0
  125. package/dist/types/src/util/index.d.ts.map +1 -0
  126. package/dist/types/src/util/points.d.ts +15 -0
  127. package/dist/types/src/util/points.d.ts.map +1 -0
  128. package/dist/types/src/util/scale.d.ts +57 -0
  129. package/dist/types/src/util/scale.d.ts.map +1 -0
  130. package/dist/types/src/util/scale.test.d.ts +2 -0
  131. package/dist/types/src/util/scale.test.d.ts.map +1 -0
  132. package/dist/types/src/util/screen.d.ts +25 -0
  133. package/dist/types/src/util/screen.d.ts.map +1 -0
  134. package/dist/types/src/util/screen.test.d.ts +2 -0
  135. package/dist/types/src/util/screen.test.d.ts.map +1 -0
  136. package/dist/types/src/util/types.d.ts +4 -0
  137. package/dist/types/src/util/types.d.ts.map +1 -0
  138. package/dist/types/src/util/vector.d.ts +48 -0
  139. package/dist/types/src/util/vector.d.ts.map +1 -0
  140. package/dist/types/src/util/vector.test.d.ts +2 -0
  141. package/dist/types/src/util/vector.test.d.ts.map +1 -0
  142. package/dist/types/tsconfig.tsbuildinfo +1 -0
  143. package/package.json +86 -0
  144. package/src/components/Graph/Graph.stories.tsx +457 -0
  145. package/src/components/Graph/Graph.tsx +130 -0
  146. package/src/components/Graph/index.ts +5 -0
  147. package/src/components/Mesh/Mesh.stories.tsx +62 -0
  148. package/src/components/Mesh/Mesh.tsx +143 -0
  149. package/src/components/Mesh/index.ts +5 -0
  150. package/src/components/SVG/Grid.tsx +20 -0
  151. package/src/components/SVG/Markers.tsx +25 -0
  152. package/src/components/SVG/Root.tsx +55 -0
  153. package/src/components/SVG/SVG.tsx +27 -0
  154. package/src/components/SVG/Svg.stories.tsx +57 -0
  155. package/src/components/SVG/Zoom.tsx +27 -0
  156. package/src/components/SVG/index.ts +5 -0
  157. package/src/components/index.ts +7 -0
  158. package/src/fx/fx.stories.tsx +116 -0
  159. package/src/fx/index.ts +5 -0
  160. package/src/fx/pulsar.ts +58 -0
  161. package/src/graph/index.ts +8 -0
  162. package/src/graph/markers.ts +85 -0
  163. package/src/graph/projector/graph-drag.ts +124 -0
  164. package/src/graph/projector/graph-force-projector.ts +414 -0
  165. package/src/graph/projector/graph-forces.ts +35 -0
  166. package/src/graph/projector/graph-hierarchical-projector.ts +80 -0
  167. package/src/graph/projector/graph-projector.ts +99 -0
  168. package/src/graph/projector/graph-radial-projector.ts +142 -0
  169. package/src/graph/projector/graph-relational-projector.ts +110 -0
  170. package/src/graph/projector/index.ts +11 -0
  171. package/src/graph/projector/projector.ts +72 -0
  172. package/src/graph/renderer/bullets.ts +72 -0
  173. package/src/graph/renderer/graph-renderer.ts +484 -0
  174. package/src/graph/renderer/index.ts +7 -0
  175. package/src/graph/renderer/linker.ts +42 -0
  176. package/src/graph/renderer/renderer.ts +49 -0
  177. package/src/graph/types.ts +80 -0
  178. package/src/hooks/index.ts +8 -0
  179. package/src/hooks/useGrid.ts +194 -0
  180. package/src/hooks/useStateRef.ts +60 -0
  181. package/src/hooks/useSvgContext.ts +96 -0
  182. package/src/hooks/useZoom.ts +118 -0
  183. package/src/index.ts +9 -0
  184. package/src/stories/hooks.stories.tsx +212 -0
  185. package/src/testing/data.test.ts +12 -0
  186. package/src/testing/data.ts +100 -0
  187. package/src/testing/hooks.ts +103 -0
  188. package/src/testing/index.ts +7 -0
  189. package/src/testing/model.ts +29 -0
  190. package/src/typings.d.ts +5 -0
  191. package/src/util/d3-types.ts +26 -0
  192. package/src/util/events.ts +24 -0
  193. package/src/util/fraction.test.ts +76 -0
  194. package/src/util/fraction.ts +175 -0
  195. package/src/util/index.ts +12 -0
  196. package/src/util/points.ts +68 -0
  197. package/src/util/scale.test.ts +31 -0
  198. package/src/util/scale.ts +137 -0
  199. package/src/util/screen.test.ts +41 -0
  200. package/src/util/screen.ts +91 -0
  201. package/src/util/types.ts +9 -0
  202. package/src/util/vector.test.ts +15 -0
  203. package/src/util/vector.ts +67 -0
  204. package/styles/graph.css +142 -0
  205. package/testing.d.ts +11 -0
  206. package/testing.js +5 -0
@@ -0,0 +1,457 @@
1
+ //
2
+ // Copyright 2022 DXOS.org
3
+ //
4
+
5
+ import '@dxos-theme';
6
+
7
+ import { effect } from '@preact/signals-core';
8
+ import { type StoryObj } from '@storybook/react';
9
+ import { select } from 'd3';
10
+ import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
11
+
12
+ import { type GraphModel, SelectionModel, type Graph } from '@dxos/graph';
13
+ import { IconButton, Popover, Toolbar } from '@dxos/react-ui';
14
+ import { JsonFilter, SyntaxHighlighter } from '@dxos/react-ui-syntax-highlighter';
15
+ import { getHashColor, mx } from '@dxos/react-ui-theme';
16
+ import { type Meta, withLayout, withTheme } from '@dxos/storybook-utils';
17
+
18
+ import { Graph as GraphComponent, type GraphController, type GraphProps } from './Graph';
19
+ import { Pulsar } from '../../fx';
20
+ import {
21
+ GraphForceProjector,
22
+ type GraphForceProjectorOptions,
23
+ GraphHierarchicalProjector,
24
+ type GraphHierarchicalProjectorOptions,
25
+ GraphRadialProjector,
26
+ type GraphRadialProjectorOptions,
27
+ GraphRelationalProjector,
28
+ type GraphRelationalProjectorOptions,
29
+ type GraphLayoutEdge,
30
+ type GraphLayoutNode,
31
+ type GraphProjector,
32
+ } from '../../graph';
33
+ import { type SVGContext } from '../../hooks';
34
+ import { convertTreeToGraph, createGraph, createNode, createTree, TestGraphModel, type TestNode } from '../../testing';
35
+ import { SVG, type SVGGridProps } from '../SVG';
36
+
37
+ import '../../../styles/graph.css';
38
+
39
+ type ProjectorType = 'force' | 'radial' | 'hierarchical' | 'relational';
40
+
41
+ type Factory = {
42
+ new (...args: ConstructorParameters<typeof GraphProjector>): GraphProjector<TestNode>;
43
+ };
44
+
45
+ const projectorTypes: Record<ProjectorType, Factory> = {
46
+ force: GraphForceProjector as Factory,
47
+ radial: GraphRadialProjector as Factory,
48
+ hierarchical: GraphHierarchicalProjector as Factory,
49
+ relational: GraphRelationalProjector as Factory,
50
+ };
51
+
52
+ type StoryProps = GraphProps & {
53
+ debug?: boolean;
54
+ grid?: boolean | SVGGridProps;
55
+ inspect?: boolean;
56
+ singleSelect?: boolean;
57
+ graph: () => Graph;
58
+ projectorType?: ProjectorType;
59
+ projectorOptions?:
60
+ | GraphForceProjectorOptions
61
+ | GraphHierarchicalProjectorOptions
62
+ | GraphRadialProjectorOptions
63
+ | GraphRelationalProjectorOptions;
64
+ };
65
+
66
+ const DefaultStory = ({
67
+ debug,
68
+ grid,
69
+ inspect,
70
+ singleSelect,
71
+ graph: _graph,
72
+ projectorType: _projectorType = 'force',
73
+ projectorOptions,
74
+ ...props
75
+ }: StoryProps) => {
76
+ const graphRef = useRef<GraphController | null>(null);
77
+ const context = useRef<SVGContext>(null);
78
+
79
+ // Models.
80
+ const [model, setModel] = useState<GraphModel | undefined>(() => new TestGraphModel(_graph?.()));
81
+ const selection = useMemo(() => new SelectionModel(singleSelect), [singleSelect]);
82
+
83
+ // Projector.
84
+ const [projectorType, setProjectorType] = useState<ProjectorType>(_projectorType);
85
+ const [projector, setProjector] = useState<GraphProjector<TestNode>>();
86
+ useEffect(() => {
87
+ if (!context.current) {
88
+ return;
89
+ }
90
+
91
+ const Projector = projectorTypes[projectorType];
92
+ setProjector((projector) => new Projector(context.current, projectorOptions, selection, projector?.layout));
93
+ }, [context.current, selection, projectorType, projectorOptions]);
94
+
95
+ const popoverAnchorRef = useRef<HTMLButtonElement | null>(null);
96
+ const [popover, setPopover] = useState<any>();
97
+
98
+ // Dismiss popover when SVG context transform changes.
99
+ useEffect(() => {
100
+ if (!context.current) {
101
+ return;
102
+ }
103
+
104
+ return context.current.resized.on(() => setPopover(undefined));
105
+ }, [context]);
106
+
107
+ const handleInspect = useCallback<GraphProps['onInspect']>((node, event) => {
108
+ setPopover(undefined);
109
+ popoverAnchorRef.current = null;
110
+
111
+ queueMicrotask(() => {
112
+ popoverAnchorRef.current = event.target as HTMLButtonElement;
113
+ setPopover(node.data);
114
+ });
115
+ }, []);
116
+
117
+ const handleSelect = useCallback<GraphProps['onSelect']>(
118
+ (node) => {
119
+ if (selection.contains(node.id)) {
120
+ selection.remove(node.id);
121
+ } else {
122
+ selection.add(node.id);
123
+ }
124
+
125
+ graphRef.current?.repaint();
126
+ },
127
+ [selection, projector],
128
+ );
129
+
130
+ const handleAdd = useCallback(() => {
131
+ if (model) {
132
+ const graph = model.graph;
133
+ if (Math.random() < 0.5) {
134
+ model.addNode(createNode());
135
+ } else if (graph.nodes.length) {
136
+ const source = graph.nodes[Math.floor(Math.random() * graph.nodes.length)];
137
+ const target = graph.nodes[Math.floor(Math.random() * graph.nodes.length)];
138
+ if (source !== target) {
139
+ model.addEdge({ source: source.id, target: target.id });
140
+ }
141
+ }
142
+ }
143
+ }, [model]);
144
+
145
+ const handleDelete = useCallback(() => {
146
+ if (model) {
147
+ const graph = model.graph;
148
+ if (graph) {
149
+ const node = graph.nodes[Math.floor(Math.random() * graph.nodes.length)];
150
+ if (node) {
151
+ model.removeNode(node.id);
152
+ }
153
+ }
154
+ }
155
+ }, [model]);
156
+
157
+ const handleRegenerate = useCallback(() => {
158
+ setModel(new TestGraphModel(_graph?.()));
159
+ }, [_graph]);
160
+
161
+ const handleClear = useCallback(() => {
162
+ setModel(undefined);
163
+ }, []);
164
+
165
+ const handleRefresh = useCallback(() => {
166
+ graphRef.current?.refresh();
167
+ }, []);
168
+
169
+ const handleRepaint = useCallback(() => {
170
+ graphRef.current?.repaint();
171
+ }, []);
172
+
173
+ const handleToggleProjector = useCallback(() => {
174
+ setProjectorType((projectorType) => {
175
+ const keys = Object.keys(projectorTypes) as ProjectorType[];
176
+ const index = keys.indexOf(projectorType);
177
+ return keys[index + 1] ?? keys[0];
178
+ });
179
+ }, []);
180
+
181
+ const active = useMemo(() => new SelectionModel(), []);
182
+ const handlePing = useCallback(() => {
183
+ for (const id of active.selected.value) {
184
+ const node = graphRef.current?.findNode(id);
185
+ if (node) {
186
+ Pulsar.remove(select(node));
187
+ }
188
+ }
189
+
190
+ active.clear();
191
+ for (const id of selection.selected.value) {
192
+ const node = graphRef.current?.findNode(id);
193
+ if (node) {
194
+ active.add(id);
195
+ const r = parseFloat(select(node).select('circle').attr('r') ?? '8');
196
+ Pulsar.create(select(node), r);
197
+ }
198
+ }
199
+ }, [selection, active]);
200
+
201
+ return (
202
+ <Popover.Root open={!!popover} onOpenChange={(state) => !state && setPopover(undefined)}>
203
+ <div className={mx('w-full grid divide-x divide-separator', debug && 'grid-cols-[1fr_30rem]')}>
204
+ <SVG.Root ref={context}>
205
+ <SVG.Markers />
206
+ {grid && <SVG.Grid {...(typeof grid === 'boolean' ? { axis: grid } : grid)} />}
207
+ <SVG.Zoom extent={[1 / 4, 4]}>
208
+ <GraphComponent
209
+ ref={graphRef}
210
+ model={model}
211
+ projector={projector}
212
+ labels={{
213
+ text: (node: GraphLayoutNode<TestNode>) => node.data.label,
214
+ }}
215
+ attributes={{
216
+ node: (node: GraphLayoutNode<TestNode>) => ({
217
+ data: {
218
+ color: getHashColor(node.data?.type ?? node.type)?.color,
219
+ },
220
+ classes: {
221
+ 'dx-selected': selection.contains(node.id),
222
+ },
223
+ }),
224
+ edge: (edge: GraphLayoutEdge<TestNode>) => ({
225
+ data: {
226
+ color: getHashColor(edge.data?.type ?? edge.type)?.color,
227
+ },
228
+ }),
229
+ }}
230
+ onInspect={inspect ? handleInspect : undefined}
231
+ onSelect={handleSelect}
232
+ {...props}
233
+ />
234
+ </SVG.Zoom>
235
+ </SVG.Root>
236
+
237
+ {debug && (
238
+ <Debug
239
+ model={model}
240
+ selection={selection}
241
+ projector={projectorType}
242
+ onToggleProjector={handleToggleProjector}
243
+ onRefresh={handleRefresh}
244
+ onRepaint={handleRepaint}
245
+ onRegenerate={handleRegenerate}
246
+ onClear={handleClear}
247
+ onAdd={handleAdd}
248
+ onDelete={handleDelete}
249
+ onPing={handlePing}
250
+ />
251
+ )}
252
+ </div>
253
+
254
+ <Popover.VirtualTrigger virtualRef={popoverAnchorRef} />
255
+ <Popover.Content
256
+ classNames='p-1 bg-groupSurface popover-card-width'
257
+ onOpenAutoFocus={(event) => event.preventDefault()}
258
+ >
259
+ <SyntaxHighlighter
260
+ classNames='p-0 bg-transparent text-xs'
261
+ language='json'
262
+ code={JSON.stringify(popover, null, 2)}
263
+ />
264
+ <Popover.Arrow />
265
+ </Popover.Content>
266
+ </Popover.Root>
267
+ );
268
+ };
269
+
270
+ const Debug = ({
271
+ model,
272
+ selection,
273
+ projector,
274
+ onToggleProjector,
275
+ onRefresh,
276
+ onRepaint,
277
+ onRegenerate,
278
+ onClear,
279
+ onAdd,
280
+ onDelete,
281
+ onPing,
282
+ }: {
283
+ model?: GraphModel;
284
+ selection: SelectionModel;
285
+ projector: ProjectorType;
286
+ onToggleProjector: () => void;
287
+ onRefresh: () => void;
288
+ onRepaint: () => void;
289
+ onRegenerate: () => void;
290
+ onClear: () => void;
291
+ onAdd: () => void;
292
+ onDelete: () => void;
293
+ onPing: () => void;
294
+ }) => {
295
+ const [data, setData] = useState({});
296
+ useEffect(() => {
297
+ effect(() => {
298
+ setData({
299
+ projector,
300
+ selection: selection.toJSON(),
301
+ model: model?.toJSON(),
302
+ });
303
+ });
304
+ }, [model, selection, projector]);
305
+
306
+ return (
307
+ <div className='flex flex-col overflow-hidden'>
308
+ <Toolbar.Root>
309
+ <IconButton onClick={onToggleProjector} size={5} label='Projector' icon='ph--graph--regular' iconOnly />
310
+ <IconButton onClick={onRefresh} size={5} label='Refresh' icon='ph--arrow-clockwise--regular' iconOnly />
311
+ <IconButton onClick={onRepaint} size={5} label='Repaint' icon='ph--paint-roller--regular' iconOnly />
312
+ <IconButton onClick={onRegenerate} size={5} label='Regenerate' icon='ph--arrows-clockwise--regular' iconOnly />
313
+ <IconButton onClick={onClear} size={5} label='Clear' icon='ph--trash--regular' iconOnly />
314
+ <IconButton onClick={onAdd} size={5} label='Add' icon='ph--plus--regular' iconOnly />
315
+ <IconButton onClick={onDelete} size={5} label='Delete' icon='ph--x--regular' iconOnly />
316
+ <IconButton onClick={onPing} size={5} label='Delete' icon='ph--crosshair-simple--regular' iconOnly />
317
+ </Toolbar.Root>
318
+ <JsonFilter data={data} classNames='text-sm' />
319
+ </div>
320
+ );
321
+ };
322
+
323
+ const meta: Meta<StoryProps> = {
324
+ title: 'ui/react-ui-graph/Graph',
325
+ render: DefaultStory,
326
+ decorators: [withTheme, withLayout({ fullscreen: true })],
327
+ };
328
+
329
+ export default meta;
330
+
331
+ type Story = StoryObj<StoryProps>;
332
+
333
+ export const Default: Story = {
334
+ args: {
335
+ graph: () => convertTreeToGraph(createTree({ depth: 3 })),
336
+ debug: true,
337
+ grid: {
338
+ axis: true,
339
+ },
340
+ drag: true,
341
+ arrows: true,
342
+ },
343
+ };
344
+
345
+ export const Projector: Story = {
346
+ args: {
347
+ graph: () => convertTreeToGraph(createTree({ depth: 4 })),
348
+ debug: true,
349
+ drag: true,
350
+ arrows: true,
351
+ singleSelect: true,
352
+ projectorType: 'hierarchical',
353
+ projectorOptions: {
354
+ duration: 500,
355
+ },
356
+ },
357
+ };
358
+
359
+ export const Force: Story = {
360
+ args: {
361
+ graph: () => convertTreeToGraph(createTree({ depth: 5 })),
362
+ debug: true,
363
+ drag: true,
364
+ projectorOptions: {
365
+ guides: true,
366
+ attributes: {
367
+ radius: (node, count) => 3 + Math.log(count + 1) * 3,
368
+ },
369
+ radius: 400,
370
+ forces: {
371
+ collide: {
372
+ strength: 1,
373
+ },
374
+ manyBody: {
375
+ strength: -80,
376
+ },
377
+ link: {
378
+ distance: 20,
379
+ iterations: 10,
380
+ strength: 0.2,
381
+ },
382
+ radial: {
383
+ delay: 500,
384
+ radius: 300,
385
+ strength: 0.5,
386
+ },
387
+ },
388
+ },
389
+ },
390
+ };
391
+
392
+ export const Select: Story = {
393
+ args: {
394
+ graph: () => createGraph(100, 30, ['type-1', 'type-2', 'type-3', 'type-4', 'type-5', 'type-6']),
395
+ debug: false,
396
+ drag: true,
397
+ grid: true,
398
+ subgraphs: true,
399
+ projectorOptions: {
400
+ forces: {
401
+ collide: true,
402
+ x: {
403
+ strength: 0.02,
404
+ },
405
+ y: {
406
+ strength: 0.02,
407
+ },
408
+ },
409
+ },
410
+ },
411
+ };
412
+
413
+ export const WithSubgraphs: Story = {
414
+ args: {
415
+ graph: () => createGraph(50, 30),
416
+ debug: true,
417
+ drag: true,
418
+ subgraphs: true,
419
+ projectorOptions: {
420
+ forces: {
421
+ radial: {
422
+ radius: 200,
423
+ strength: 0.05,
424
+ },
425
+ },
426
+ },
427
+ },
428
+ };
429
+
430
+ export const WithPopover: Story = {
431
+ args: {
432
+ graph: () => createGraph(30, 10),
433
+ debug: false,
434
+ drag: true,
435
+ inspect: true,
436
+ grid: true,
437
+ subgraphs: true,
438
+ projectorOptions: {
439
+ forces: {
440
+ collide: true,
441
+ point: true,
442
+ },
443
+ },
444
+ },
445
+ };
446
+
447
+ export const Empty: Story = {
448
+ render: () => (
449
+ <SVG.Root>
450
+ <SVG.Markers />
451
+ <SVG.Grid axis />
452
+ <SVG.Zoom extent={[1 / 4, 4]}>
453
+ <GraphComponent />
454
+ </SVG.Zoom>
455
+ </SVG.Root>
456
+ ),
457
+ };
@@ -0,0 +1,130 @@
1
+ //
2
+ // Copyright 2022 DXOS.org
3
+ //
4
+
5
+ import { effect } from '@preact/signals-core';
6
+ import React, { type JSX, type Ref, forwardRef, useEffect, useImperativeHandle, useMemo, useRef } from 'react';
7
+
8
+ import { combine } from '@dxos/async';
9
+ import { type BaseGraphEdge, type BaseGraphNode, type GraphModel } from '@dxos/graph';
10
+ import { log } from '@dxos/log';
11
+ import { type ThemedClassName } from '@dxos/react-ui';
12
+ import { mx } from '@dxos/react-ui-theme';
13
+
14
+ import {
15
+ createGraphDrag,
16
+ GraphForceProjector,
17
+ type GraphLayoutNode,
18
+ type GraphProjector,
19
+ GraphRenderer,
20
+ type GraphRendererOptions,
21
+ } from '../../graph';
22
+ import { useSvgContext } from '../../hooks';
23
+
24
+ export type GraphController = {
25
+ refresh: () => void;
26
+ repaint: () => void;
27
+ findNode: (id: string) => SVGGElement | null;
28
+ };
29
+
30
+ export type GraphProps<Node extends BaseGraphNode = any, Edge extends BaseGraphEdge = any> = ThemedClassName<
31
+ Pick<GraphRendererOptions<Node>, 'labels' | 'subgraphs' | 'attributes'> & {
32
+ model?: GraphModel<Node, Edge>; // TODO(burdon): ReactiveGraphModel
33
+ projector?: GraphProjector<Node>;
34
+ renderer?: GraphRenderer<Node>;
35
+ drag?: boolean;
36
+ arrows?: boolean;
37
+ onSelect?: (node: GraphLayoutNode<Node>, event: MouseEvent) => void;
38
+ onInspect?: (node: GraphLayoutNode<Node>, event: MouseEvent) => void;
39
+ }
40
+ >;
41
+
42
+ export const GraphInner = <Node extends BaseGraphNode = any, Edge extends BaseGraphEdge = any>(
43
+ {
44
+ classNames,
45
+ model,
46
+ projector: _projector,
47
+ renderer: _renderer,
48
+ drag,
49
+ arrows,
50
+ onSelect,
51
+ onInspect,
52
+ ...props
53
+ }: GraphProps<Node, Edge>,
54
+ forwardedRef: Ref<GraphController>,
55
+ ) => {
56
+ const context = useSvgContext();
57
+ const graphRef = useRef<SVGGElement>();
58
+
59
+ const { projector, renderer } = useMemo(() => {
60
+ let projector = _projector;
61
+ if (!projector) {
62
+ projector = new GraphForceProjector<Node>(context);
63
+ }
64
+
65
+ let renderer = _renderer;
66
+ if (!renderer) {
67
+ renderer = new GraphRenderer<Node>(context, graphRef, {
68
+ ...props,
69
+ // TODO(burdon): Replace drag when projector is updated.
70
+ drag: drag ? createGraphDrag(context, projector) : undefined,
71
+ arrows: { end: arrows },
72
+ onNodeClick: onSelect ? (node: GraphLayoutNode, event) => onSelect(node, event) : undefined,
73
+ onNodePointerEnter: onInspect ? (node: GraphLayoutNode, event) => onInspect(node, event) : undefined,
74
+ });
75
+ }
76
+
77
+ return { projector, renderer };
78
+ }, [context, _projector, _renderer, drag]);
79
+
80
+ // External API.
81
+ useImperativeHandle(
82
+ forwardedRef,
83
+ () => ({
84
+ refresh: () => {
85
+ projector.updateData(model?.graph);
86
+ },
87
+ repaint: () => {
88
+ renderer.render(projector.layout);
89
+ },
90
+ findNode: (id: string) => {
91
+ return graphRef.current?.querySelector<SVGGElement>(`g[data-id="${id}"]`);
92
+ },
93
+ }),
94
+ [model, projector, renderer],
95
+ );
96
+
97
+ // Subscriptions.
98
+ useEffect(() => {
99
+ return combine(
100
+ effect(() => {
101
+ projector.updateData(model?.graph);
102
+ }),
103
+ projector.updated.on(({ layout }) => {
104
+ try {
105
+ renderer.render(layout);
106
+ } catch (error) {
107
+ void projector.stop();
108
+ log.catch(error);
109
+ }
110
+ }),
111
+ );
112
+ }, [model, projector, renderer]);
113
+
114
+ // Start.
115
+ useEffect(() => {
116
+ void projector.start();
117
+ return () => {
118
+ void projector.stop();
119
+ };
120
+ }, [projector]);
121
+
122
+ return <g ref={graphRef} className={mx('dx-graph', classNames)} />;
123
+ };
124
+
125
+ /**
126
+ * SVG Graph.
127
+ */
128
+ export const Graph = forwardRef(GraphInner) as <Node extends BaseGraphNode = any, Edge extends BaseGraphEdge = any>(
129
+ props: GraphProps<Node, Edge> & { ref?: Ref<GraphController> },
130
+ ) => JSX.Element;
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2020 DXOS.org
3
+ //
4
+
5
+ export * from './Graph';
@@ -0,0 +1,62 @@
1
+ //
2
+ // Copyright 2024 DXOS.org
3
+ //
4
+
5
+ import '@dxos-theme';
6
+
7
+ import { type StoryObj } from '@storybook/react';
8
+ import React, { useEffect, useState } from 'react';
9
+
10
+ import { type Meta, withLayout, withTheme } from '@dxos/storybook-utils';
11
+
12
+ import { Mesh } from './Mesh';
13
+ import { SVG, type SVGRootProps } from '../SVG';
14
+
15
+ // TODO(burdon): Create waves/game of life.
16
+ const DefaultStory = (props: SVGRootProps) => {
17
+ const [value, setValue] = useState(1);
18
+ useEffect(() => {
19
+ const i = setInterval(() => {
20
+ setValue((value) => {
21
+ if (value === 50) {
22
+ clearInterval(i);
23
+ }
24
+
25
+ return value + 1;
26
+ });
27
+ }, 500);
28
+ return () => clearInterval(i);
29
+ }, []);
30
+
31
+ return (
32
+ <SVG.Root centered={false} {...props}>
33
+ <Mesh radius={12} value={value / 100} />
34
+ </SVG.Root>
35
+ );
36
+ };
37
+
38
+ const meta: Meta<typeof DefaultStory> = {
39
+ title: 'ui/react-ui-graph/Mesh',
40
+ render: DefaultStory,
41
+ decorators: [withTheme, withLayout({ fullscreen: true })],
42
+ };
43
+
44
+ export default meta;
45
+
46
+ type Story = StoryObj<typeof DefaultStory>;
47
+
48
+ export const Default: Story = {
49
+ args: {
50
+ classNames: [
51
+ '[&>.mesh]:fill-none',
52
+ '[&>.hexagon>path.fill]:fill-blue-800 [&>.hexagon]:stroke-blue-700',
53
+ '[&>.border]:fill-none [&>.border]:stroke-blue-500 [&>.border]:stroke-2',
54
+ ],
55
+ },
56
+ };
57
+
58
+ export const Outline: Story = {
59
+ args: {
60
+ classNames: ['[&>.mesh]:fill-none', '[&>.border]:fill-none [&>.border]:stroke-red-500 [&>.border]:stroke-2'],
61
+ },
62
+ };