@workbench-kit/shell-react 0.0.2-prototype.0.2.6 → 0.0.2-prototype.0.2.8

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 (95) hide show
  1. package/README.md +41 -0
  2. package/package.json +9 -9
  3. package/src/{chat-ai-mock-proposals.ts → chat/ai-mock-proposals.ts} +39 -39
  4. package/src/{chat-command-input.ts → chat/command-input.ts} +52 -52
  5. package/src/{chat-command-policy.ts → chat/command-policy.ts} +54 -54
  6. package/src/{chat-command-surface.tsx → chat/command-surface.tsx} +155 -155
  7. package/src/{use-workbench-chat-command-proposals.ts → chat/use-chat-command-proposals.ts} +194 -194
  8. package/src/{chat-view-data.ts → chat/view-data.ts} +20 -20
  9. package/src/{chat-view.tsx → chat/view.tsx} +220 -220
  10. package/src/{command-inspector-surface.tsx → commands/inspector-surface.tsx} +46 -46
  11. package/src/{use-workbench-command-descriptors.ts → commands/use-command-descriptors.ts} +41 -41
  12. package/src/{use-context-key-revision.ts → commands/use-context-key-revision.ts} +18 -18
  13. package/src/{commands-view-data.ts → commands/view-data.ts} +17 -17
  14. package/src/{commands-view.tsx → commands/view.tsx} +43 -43
  15. package/src/devtools/WorkbenchDevtoolsPanel.tsx +124 -124
  16. package/src/devtools/WorkbenchDevtoolsShell.tsx +17 -17
  17. package/src/devtools/index.ts +11 -11
  18. package/src/devtools/use-workbench-devtools-snapshot.ts +84 -84
  19. package/src/devtools/workbench-devtools-snapshot.ts +140 -140
  20. package/src/devtools/workbench-devtools.css +82 -82
  21. package/src/{editor-area-dnd.ts → editor/area-dnd.ts} +69 -69
  22. package/src/{editor-area-model.ts → editor/area-model.ts} +71 -71
  23. package/src/{editor-area.css → editor/area.css} +454 -454
  24. package/src/{editor-area.tsx → editor/area.tsx} +676 -676
  25. package/src/{editor-host-surface.tsx → editor/host-surface.tsx} +631 -634
  26. package/src/{editor-pane-visibility.ts → editor/pane-visibility.ts} +130 -130
  27. package/src/{editor-resource.ts → editor/resource.ts} +36 -36
  28. package/src/{editor-state-storage.ts → editor/state-storage.ts} +182 -193
  29. package/src/{editor-tab-context-menu.ts → editor/tab-context-menu.ts} +118 -118
  30. package/src/{use-editor.ts → editor/use-editor.ts} +114 -107
  31. package/src/{editor-view-providers.tsx → editor/view-providers.tsx} +552 -552
  32. package/src/{editor-workspace-file-availability.ts → editor/workspace-file-availability.ts} +15 -15
  33. package/src/{editor-workspace-reconcile.tsx → editor/workspace-reconcile.tsx} +31 -28
  34. package/src/{explorer-context-menu.ts → explorer/context-menu.ts} +114 -114
  35. package/src/{createCommandWorkspaceExplorerPort.ts → explorer/create-command-workspace-explorer-port.ts} +86 -86
  36. package/src/{explorer-reveal.ts → explorer/reveal.ts} +112 -112
  37. package/src/{search-view-data.ts → explorer/search-view-data.ts} +15 -15
  38. package/src/{search-view.tsx → explorer/search-view.tsx} +65 -62
  39. package/src/{use-active-workspace-path.ts → explorer/use-active-workspace-path.ts} +15 -15
  40. package/src/{explorer-view-data.ts → explorer/view-data.ts} +58 -58
  41. package/src/{explorer-view.tsx → explorer/view.tsx} +227 -224
  42. package/src/{extension-context-menu.ts → extensions/context-menu.ts} +52 -52
  43. package/src/{extension-management-model.ts → extensions/management-model.ts} +313 -313
  44. package/src/{use-extension-management.ts → extensions/use-extension-management.ts} +241 -193
  45. package/src/{extensions-view-data.ts → extensions/view-data.ts} +19 -19
  46. package/src/{extensions-view.tsx → extensions/view.tsx} +63 -38
  47. package/src/{field-remap-demo.tsx → field-remap/demo.tsx} +18 -18
  48. package/src/{field-remap-editor-surface.tsx → field-remap/editor-surface.tsx} +36 -36
  49. package/src/{field-remap-flow-adapter.ts → field-remap/flow-adapter.ts} +240 -240
  50. package/src/{field-remap-flow.tsx → field-remap/flow.tsx} +369 -369
  51. package/src/{field-remap-graph.tsx → field-remap/graph.tsx} +559 -559
  52. package/src/field-remap/jsonata-transform.ts +166 -0
  53. package/src/{field-remap-panel.tsx → field-remap/panel.tsx} +193 -175
  54. package/src/{field-remap-samples.ts → field-remap/samples.ts} +352 -352
  55. package/src/{table-mapping-adapter.ts → field-remap/table-mapping-adapter.ts} +59 -59
  56. package/src/{field-remap-tree.tsx → field-remap/tree.tsx} +404 -404
  57. package/src/{field-remap-view-data.ts → field-remap/view-data.ts} +16 -16
  58. package/src/{field-remap-view.css → field-remap/view.css} +676 -676
  59. package/src/{field-remap-view.tsx → field-remap/view.tsx} +86 -86
  60. package/src/index.ts +212 -199
  61. package/src/{json-form-source-patch.ts → jdw/json-form-source-patch.ts} +323 -323
  62. package/src/{jdw-lab-view-data.ts → jdw/lab-view-data.ts} +25 -25
  63. package/src/{jdw-lab-view.css → jdw/lab-view.css} +21 -21
  64. package/src/{jdw-lab-view.tsx → jdw/lab-view.tsx} +79 -79
  65. package/src/{jdw-widget-form-view.tsx → jdw/widget-form-view.tsx} +68 -65
  66. package/src/{jdw-widget-preview-view.tsx → jdw/widget-preview-view.tsx} +54 -51
  67. package/src/{keybinding-overrides-storage.ts → management/keybinding-overrides-storage.ts} +49 -57
  68. package/src/{keybinding-management-settings.tsx → management/keybinding-settings.tsx} +16 -16
  69. package/src/{management-palette-commands.ts → management/palette-commands.ts} +38 -38
  70. package/src/{preference-settings-storage.ts → management/preference-settings-storage.ts} +50 -58
  71. package/src/{management-settings-ids.ts → management/settings-ids.ts} +12 -12
  72. package/src/{management-settings.tsx → management/settings.tsx} +96 -75
  73. package/src/{use-command-management.ts → management/use-command-management.ts} +191 -191
  74. package/src/{use-keybinding-management.ts → management/use-keybinding-management.ts} +130 -130
  75. package/src/{shell-model.tsx → shell/model.tsx} +149 -149
  76. package/src/{provider.tsx → shell/provider.tsx} +603 -573
  77. package/src/{shell-secondary-actions.tsx → shell/secondary-actions.tsx} +59 -59
  78. package/src/{shell-settings-constants.ts → shell/settings-constants.ts} +9 -9
  79. package/src/{shell-settings.tsx → shell/settings.tsx} +599 -599
  80. package/src/{shell.tsx → shell/shell.tsx} +680 -649
  81. package/src/{shell-titlebar-layout-controls.tsx → shell/titlebar-layout-controls.tsx} +4 -4
  82. package/src/{shell-view-host.tsx → shell/view-host.tsx} +212 -199
  83. package/src/{workbench-appearance-storage.ts → workbench/appearance-storage.ts} +107 -115
  84. package/src/{workbench-command-host.tsx → workbench/command-host.tsx} +243 -243
  85. package/src/{workbench-command-palette.ts → workbench/command-palette.ts} +208 -208
  86. package/src/{workbench-keybinding-bridge.ts → workbench/keybinding-bridge.ts} +54 -54
  87. package/src/{workbench-layout-storage.ts → workbench/layout-storage.ts} +134 -145
  88. package/src/{workbench-profile-modal.tsx → workbench/profile-modal.tsx} +118 -118
  89. package/src/{workbench-shell-command-registration.ts → workbench/shell-command-registration.ts} +58 -58
  90. package/src/{workbench-startup-gate.tsx → workbench/startup-gate.tsx} +136 -136
  91. package/src/{workbench-status-sections.ts → workbench/status-sections.ts} +43 -43
  92. package/src/{use-persisted-workbench-appearance.ts → workbench/use-persisted-appearance.ts} +33 -33
  93. package/src/{workbench-user-commands.ts → workbench/user-commands.ts} +46 -46
  94. package/src/{workspace-view-state.ts → workbench/workspace-view-state.ts} +35 -35
  95. package/src/jsonata-transform.ts +0 -36
@@ -1,369 +1,369 @@
1
- import { useCallback, useEffect, useMemo, type JSX, type MouseEvent } from 'react';
2
- import {
3
- Background,
4
- Controls,
5
- Handle,
6
- MiniMap,
7
- Position,
8
- ReactFlow,
9
- ReactFlowProvider,
10
- useEdgesState,
11
- useNodesState,
12
- type Connection,
13
- type Edge,
14
- type Node,
15
- type NodeProps,
16
- } from '@xyflow/react';
17
- import '@xyflow/react/dist/style.css';
18
- import { Badge, Button } from '@workbench-kit/react/primitives';
19
- import {
20
- MAX_TRANSFORM_CHAIN,
21
- type MappingEdge,
22
- type SourceField,
23
- type TargetSlot,
24
- type ValueTransformRegistry,
25
- } from '@workbench-kit/field-remap';
26
-
27
- import {
28
- connectionToMappingEdge,
29
- mappingToFlowGraph,
30
- SOURCE_OBJECT_NODE_ID,
31
- TARGET_OBJECT_NODE_ID,
32
- type FieldRemapFlowEdgeData,
33
- type FieldRemapFlowNodeData,
34
- type FieldRemapSourceObjectNodeData,
35
- type FieldRemapTargetObjectNodeData,
36
- type FieldRemapTransformNodeData,
37
- } from './field-remap-flow-adapter.js';
38
-
39
- function TypeBadge({ dataType }: { readonly dataType?: string }): JSX.Element | null {
40
- if (dataType !== 'object' && dataType !== 'array') {
41
- return null;
42
- }
43
- return <Badge variant="muted">{dataType}</Badge>;
44
- }
45
-
46
- function SourceObjectNode({ data }: NodeProps<Node<FieldRemapSourceObjectNodeData>>): JSX.Element {
47
- return (
48
- <div className="workbench-field-remap-flow-node workbench-field-remap-flow-node--object workbench-field-remap-flow-node--source">
49
- <div className="workbench-field-remap-flow-node__header">
50
- <strong>{data.title}</strong>
51
- </div>
52
- <ul className="workbench-field-remap-flow-node__ports">
53
- {data.ports.map((port) => (
54
- <li key={port.fieldId} className="workbench-field-remap-flow-node__port">
55
- <span className="workbench-field-remap-flow-node__port-label">
56
- <span>{port.label}</span>
57
- <TypeBadge dataType={port.dataType} />
58
- </span>
59
- <Handle
60
- type="source"
61
- position={Position.Right}
62
- id={port.fieldId}
63
- className="workbench-field-remap-flow-node__handle"
64
- />
65
- </li>
66
- ))}
67
- </ul>
68
- </div>
69
- );
70
- }
71
-
72
- function TargetObjectNode({ data }: NodeProps<Node<FieldRemapTargetObjectNodeData>>): JSX.Element {
73
- return (
74
- <div className="workbench-field-remap-flow-node workbench-field-remap-flow-node--object workbench-field-remap-flow-node--target">
75
- <div className="workbench-field-remap-flow-node__header">
76
- <strong>{data.title}</strong>
77
- </div>
78
- <ul className="workbench-field-remap-flow-node__ports">
79
- {data.ports.map((port) => (
80
- <li key={port.fieldId} className="workbench-field-remap-flow-node__port">
81
- <Handle
82
- type="target"
83
- position={Position.Left}
84
- id={port.fieldId}
85
- className="workbench-field-remap-flow-node__handle"
86
- />
87
- <span className="workbench-field-remap-flow-node__port-label">
88
- <span>{port.label}</span>
89
- <TypeBadge dataType={port.dataType} />
90
- </span>
91
- </li>
92
- ))}
93
- </ul>
94
- </div>
95
- );
96
- }
97
-
98
- function TransformNode({ data }: NodeProps<Node<FieldRemapTransformNodeData>>): JSX.Element {
99
- return (
100
- <div className="workbench-field-remap-flow-node workbench-field-remap-flow-node--transform">
101
- <Handle type="target" position={Position.Left} id="in" />
102
- <div className="workbench-field-remap-flow-node__title">
103
- <strong>{data.label}</strong>
104
- </div>
105
- <code className="workbench-field-remap-flow-node__id">{data.transformId}</code>
106
- <Handle type="source" position={Position.Right} id="out" />
107
- </div>
108
- );
109
- }
110
-
111
- const nodeTypes = {
112
- fieldRemapSourceObject: SourceObjectNode,
113
- fieldRemapTargetObject: TargetObjectNode,
114
- fieldRemapTransform: TransformNode,
115
- };
116
-
117
- export interface FieldRemapFlowMapperProps {
118
- readonly sources: readonly SourceField[];
119
- readonly targets: readonly TargetSlot[];
120
- readonly edges: readonly MappingEdge[];
121
- readonly transforms: ValueTransformRegistry;
122
- readonly onEdgesChange: (edges: readonly MappingEdge[]) => void;
123
- readonly sourceTitle?: string | undefined;
124
- readonly targetTitle?: string | undefined;
125
- }
126
-
127
- function FieldRemapFlowCanvas({
128
- sources,
129
- targets,
130
- edges,
131
- transforms,
132
- onEdgesChange,
133
- sourceTitle,
134
- targetTitle,
135
- }: FieldRemapFlowMapperProps): JSX.Element {
136
- const graph = useMemo(
137
- () =>
138
- mappingToFlowGraph({
139
- sources,
140
- targets,
141
- edges,
142
- transforms,
143
- sourceTitle,
144
- targetTitle,
145
- }),
146
- [sources, targets, edges, transforms, sourceTitle, targetTitle],
147
- );
148
-
149
- const [nodes, setNodes, onNodesChange] = useNodesState(graph.nodes);
150
- const [flowEdges, setFlowEdges, onFlowEdgesChange] = useEdgesState(graph.edges);
151
-
152
- useEffect(() => {
153
- setNodes(graph.nodes);
154
- setFlowEdges(graph.edges);
155
- }, [graph, setNodes, setFlowEdges]);
156
-
157
- const catalog = useMemo(
158
- () => transforms.list().filter((item) => item.id !== 'identity'),
159
- [transforms],
160
- );
161
-
162
- const isValidConnection = useCallback((connection: Connection | Edge) => {
163
- const source = connection.source;
164
- const target = connection.target;
165
- if (!source || !target) {
166
- return false;
167
- }
168
- // Object port → object port (fan-out from one source field to many targets).
169
- if (source === SOURCE_OBJECT_NODE_ID && target === TARGET_OBJECT_NODE_ID) {
170
- return Boolean(connection.sourceHandle && connection.targetHandle);
171
- }
172
- // Object port → transform in
173
- if (source === SOURCE_OBJECT_NODE_ID && target.startsWith('xf:')) {
174
- return Boolean(connection.sourceHandle);
175
- }
176
- // Transform out → object port
177
- if (source.startsWith('xf:') && target === TARGET_OBJECT_NODE_ID) {
178
- return Boolean(connection.targetHandle);
179
- }
180
- // Transform chain mid-links
181
- if (source.startsWith('xf:') && target.startsWith('xf:')) {
182
- return true;
183
- }
184
- return false;
185
- }, []);
186
-
187
- const onConnect = useCallback(
188
- (connection: Connection) => {
189
- if (!connection.source || !connection.target) {
190
- return;
191
- }
192
- const next = connectionToMappingEdge({
193
- sourceNodeId: connection.source,
194
- targetNodeId: connection.target,
195
- sourceHandle: connection.sourceHandle,
196
- targetHandle: connection.targetHandle,
197
- existing: edges,
198
- });
199
- if (!next) {
200
- return;
201
- }
202
- const withoutTarget = edges.filter((edge) => edge.targetSlotId !== next.targetSlotId);
203
- onEdgesChange([...withoutTarget, next]);
204
- },
205
- [edges, onEdgesChange],
206
- );
207
-
208
- const onEdgesDelete = useCallback(
209
- (deleted: Edge[]) => {
210
- const mappingIds = new Set(
211
- deleted
212
- .map((edge) => {
213
- const data = edge.data as FieldRemapFlowEdgeData | undefined;
214
- return data?.mappingEdgeId;
215
- })
216
- .filter((id): id is string => typeof id === 'string'),
217
- );
218
- if (mappingIds.size === 0) {
219
- return;
220
- }
221
- onEdgesChange(edges.filter((edge) => !mappingIds.has(edge.id)));
222
- },
223
- [edges, onEdgesChange],
224
- );
225
-
226
- const addTransform = (mappingEdgeId: string, transformId: string) => {
227
- onEdgesChange(
228
- edges.map((edge) => {
229
- if (edge.id !== mappingEdgeId) {
230
- return edge;
231
- }
232
- const current = edge.transformIds ?? [];
233
- if (current.length >= MAX_TRANSFORM_CHAIN) {
234
- return edge;
235
- }
236
- return { ...edge, transformIds: [...current, transformId] };
237
- }),
238
- );
239
- };
240
-
241
- const removeTransformStep = (mappingEdgeId: string, stepIndex: number) => {
242
- onEdgesChange(
243
- edges.map((edge) => {
244
- if (edge.id !== mappingEdgeId) {
245
- return edge;
246
- }
247
- const next = [...(edge.transformIds ?? [])];
248
- next.splice(stepIndex, 1);
249
- const optionSteps = edge.transformOptionSteps ? [...edge.transformOptionSteps] : undefined;
250
- if (optionSteps) {
251
- optionSteps.splice(stepIndex, 1);
252
- }
253
- return {
254
- ...edge,
255
- transformIds: next.length > 0 ? next : undefined,
256
- transformOptionSteps: optionSteps && optionSteps.length > 0 ? optionSteps : undefined,
257
- };
258
- }),
259
- );
260
- };
261
-
262
- const onNodeClick = useCallback(
263
- (_event: MouseEvent, node: Node) => {
264
- const data = node.data as FieldRemapFlowNodeData;
265
- if (data.kind !== 'transform') {
266
- return;
267
- }
268
- if (_event.altKey) {
269
- removeTransformStep(data.mappingEdgeId, data.stepIndex);
270
- }
271
- },
272
- [edges, onEdgesChange],
273
- );
274
-
275
- const defaultTransformId = catalog[0]?.id ?? 'string:trim';
276
-
277
- return (
278
- <div className="workbench-field-remap-flow" data-testid="field-remap-mapper">
279
- <p className="workbench-field-remap-mapper__hint" data-testid="field-remap-hint">
280
- Each object/table is one node with field ports. Drag a left field to a right field (one
281
- source can fan out to many targets). Middle nodes are transforms (Alt-click to remove).
282
- </p>
283
-
284
- <div className="workbench-field-remap-flow__canvas" data-testid="field-remap-flow">
285
- <ReactFlow
286
- nodes={nodes}
287
- edges={flowEdges}
288
- nodeTypes={nodeTypes}
289
- onNodesChange={onNodesChange}
290
- onEdgesChange={onFlowEdgesChange}
291
- onConnect={onConnect}
292
- onEdgesDelete={onEdgesDelete}
293
- onNodeClick={onNodeClick}
294
- isValidConnection={isValidConnection}
295
- fitView
296
- fitViewOptions={{ padding: 0.12, maxZoom: 1.15 }}
297
- proOptions={{ hideAttribution: true }}
298
- >
299
- <Background gap={16} color="var(--xy-background-pattern-color)" />
300
- <Controls showInteractive={false} />
301
- <MiniMap
302
- pannable
303
- zoomable
304
- bgColor="var(--xy-minimap-background-color)"
305
- maskColor="var(--xy-minimap-mask-background-color)"
306
- nodeColor={(node) => {
307
- const kind = (node.data as FieldRemapFlowNodeData | undefined)?.kind;
308
- if (kind === 'source-object') {
309
- return 'var(--vscode-charts-blue, #3794ff)';
310
- }
311
- if (kind === 'target-object') {
312
- return 'var(--vscode-charts-green, #89d185)';
313
- }
314
- return 'var(--vscode-focusBorder, var(--color-accent, #3794ff))';
315
- }}
316
- nodeStrokeColor="var(--xy-minimap-node-stroke-color)"
317
- />
318
- </ReactFlow>
319
- </div>
320
-
321
- <div className="workbench-field-remap-flow__bindings" data-testid="field-remap-edges">
322
- <h4>Bindings</h4>
323
- <ul>
324
- {edges.map((edge) => (
325
- <li key={edge.id} data-testid={`field-remap-lane-${edge.id}`}>
326
- <code>
327
- {edge.sourceFieldId} →{' '}
328
- {(edge.transformIds ?? []).length > 0
329
- ? `${(edge.transformIds ?? []).join(' → ')} → `
330
- : ''}
331
- {edge.targetSlotId}
332
- </code>
333
- <span className="workbench-field-remap-mapper__edge-actions">
334
- {(edge.transformIds?.length ?? 0) < MAX_TRANSFORM_CHAIN ? (
335
- <Button
336
- compact
337
- type="button"
338
- data-testid={`field-remap-add-node-${edge.id}`}
339
- onClick={() => addTransform(edge.id, defaultTransformId)}
340
- >
341
- + node
342
- </Button>
343
- ) : null}
344
- <Button
345
- compact
346
- type="button"
347
- onClick={() => onEdgesChange(edges.filter((item) => item.id !== edge.id))}
348
- >
349
- Remove
350
- </Button>
351
- </span>
352
- </li>
353
- ))}
354
- </ul>
355
- </div>
356
- </div>
357
- );
358
- }
359
-
360
- /**
361
- * React Flow mapper: multi-port source object → transforms → multi-port target object.
362
- */
363
- export function FieldRemapFlowMapper(props: FieldRemapFlowMapperProps): JSX.Element {
364
- return (
365
- <ReactFlowProvider>
366
- <FieldRemapFlowCanvas {...props} />
367
- </ReactFlowProvider>
368
- );
369
- }
1
+ import { useCallback, useEffect, useMemo, type JSX, type MouseEvent } from 'react';
2
+ import {
3
+ Background,
4
+ Controls,
5
+ Handle,
6
+ MiniMap,
7
+ Position,
8
+ ReactFlow,
9
+ ReactFlowProvider,
10
+ useEdgesState,
11
+ useNodesState,
12
+ type Connection,
13
+ type Edge,
14
+ type Node,
15
+ type NodeProps,
16
+ } from '@xyflow/react';
17
+ import '@xyflow/react/dist/style.css';
18
+ import { Badge, Button } from '@workbench-kit/react/primitives';
19
+ import {
20
+ MAX_TRANSFORM_CHAIN,
21
+ type MappingEdge,
22
+ type SourceField,
23
+ type TargetSlot,
24
+ type ValueTransformRegistry,
25
+ } from '@workbench-kit/field-remap';
26
+
27
+ import {
28
+ connectionToMappingEdge,
29
+ mappingToFlowGraph,
30
+ SOURCE_OBJECT_NODE_ID,
31
+ TARGET_OBJECT_NODE_ID,
32
+ type FieldRemapFlowEdgeData,
33
+ type FieldRemapFlowNodeData,
34
+ type FieldRemapSourceObjectNodeData,
35
+ type FieldRemapTargetObjectNodeData,
36
+ type FieldRemapTransformNodeData,
37
+ } from './flow-adapter.js';
38
+
39
+ function TypeBadge({ dataType }: { readonly dataType?: string }): JSX.Element | null {
40
+ if (dataType !== 'object' && dataType !== 'array') {
41
+ return null;
42
+ }
43
+ return <Badge variant="muted">{dataType}</Badge>;
44
+ }
45
+
46
+ function SourceObjectNode({ data }: NodeProps<Node<FieldRemapSourceObjectNodeData>>): JSX.Element {
47
+ return (
48
+ <div className="workbench-field-remap-flow-node workbench-field-remap-flow-node--object workbench-field-remap-flow-node--source">
49
+ <div className="workbench-field-remap-flow-node__header">
50
+ <strong>{data.title}</strong>
51
+ </div>
52
+ <ul className="workbench-field-remap-flow-node__ports">
53
+ {data.ports.map((port) => (
54
+ <li key={port.fieldId} className="workbench-field-remap-flow-node__port">
55
+ <span className="workbench-field-remap-flow-node__port-label">
56
+ <span>{port.label}</span>
57
+ <TypeBadge dataType={port.dataType} />
58
+ </span>
59
+ <Handle
60
+ type="source"
61
+ position={Position.Right}
62
+ id={port.fieldId}
63
+ className="workbench-field-remap-flow-node__handle"
64
+ />
65
+ </li>
66
+ ))}
67
+ </ul>
68
+ </div>
69
+ );
70
+ }
71
+
72
+ function TargetObjectNode({ data }: NodeProps<Node<FieldRemapTargetObjectNodeData>>): JSX.Element {
73
+ return (
74
+ <div className="workbench-field-remap-flow-node workbench-field-remap-flow-node--object workbench-field-remap-flow-node--target">
75
+ <div className="workbench-field-remap-flow-node__header">
76
+ <strong>{data.title}</strong>
77
+ </div>
78
+ <ul className="workbench-field-remap-flow-node__ports">
79
+ {data.ports.map((port) => (
80
+ <li key={port.fieldId} className="workbench-field-remap-flow-node__port">
81
+ <Handle
82
+ type="target"
83
+ position={Position.Left}
84
+ id={port.fieldId}
85
+ className="workbench-field-remap-flow-node__handle"
86
+ />
87
+ <span className="workbench-field-remap-flow-node__port-label">
88
+ <span>{port.label}</span>
89
+ <TypeBadge dataType={port.dataType} />
90
+ </span>
91
+ </li>
92
+ ))}
93
+ </ul>
94
+ </div>
95
+ );
96
+ }
97
+
98
+ function TransformNode({ data }: NodeProps<Node<FieldRemapTransformNodeData>>): JSX.Element {
99
+ return (
100
+ <div className="workbench-field-remap-flow-node workbench-field-remap-flow-node--transform">
101
+ <Handle type="target" position={Position.Left} id="in" />
102
+ <div className="workbench-field-remap-flow-node__title">
103
+ <strong>{data.label}</strong>
104
+ </div>
105
+ <code className="workbench-field-remap-flow-node__id">{data.transformId}</code>
106
+ <Handle type="source" position={Position.Right} id="out" />
107
+ </div>
108
+ );
109
+ }
110
+
111
+ const nodeTypes = {
112
+ fieldRemapSourceObject: SourceObjectNode,
113
+ fieldRemapTargetObject: TargetObjectNode,
114
+ fieldRemapTransform: TransformNode,
115
+ };
116
+
117
+ export interface FieldRemapFlowMapperProps {
118
+ readonly sources: readonly SourceField[];
119
+ readonly targets: readonly TargetSlot[];
120
+ readonly edges: readonly MappingEdge[];
121
+ readonly transforms: ValueTransformRegistry;
122
+ readonly onEdgesChange: (edges: readonly MappingEdge[]) => void;
123
+ readonly sourceTitle?: string | undefined;
124
+ readonly targetTitle?: string | undefined;
125
+ }
126
+
127
+ function FieldRemapFlowCanvas({
128
+ sources,
129
+ targets,
130
+ edges,
131
+ transforms,
132
+ onEdgesChange,
133
+ sourceTitle,
134
+ targetTitle,
135
+ }: FieldRemapFlowMapperProps): JSX.Element {
136
+ const graph = useMemo(
137
+ () =>
138
+ mappingToFlowGraph({
139
+ sources,
140
+ targets,
141
+ edges,
142
+ transforms,
143
+ sourceTitle,
144
+ targetTitle,
145
+ }),
146
+ [sources, targets, edges, transforms, sourceTitle, targetTitle],
147
+ );
148
+
149
+ const [nodes, setNodes, onNodesChange] = useNodesState(graph.nodes);
150
+ const [flowEdges, setFlowEdges, onFlowEdgesChange] = useEdgesState(graph.edges);
151
+
152
+ useEffect(() => {
153
+ setNodes(graph.nodes);
154
+ setFlowEdges(graph.edges);
155
+ }, [graph, setNodes, setFlowEdges]);
156
+
157
+ const catalog = useMemo(
158
+ () => transforms.list().filter((item) => item.id !== 'identity'),
159
+ [transforms],
160
+ );
161
+
162
+ const isValidConnection = useCallback((connection: Connection | Edge) => {
163
+ const source = connection.source;
164
+ const target = connection.target;
165
+ if (!source || !target) {
166
+ return false;
167
+ }
168
+ // Object port → object port (fan-out from one source field to many targets).
169
+ if (source === SOURCE_OBJECT_NODE_ID && target === TARGET_OBJECT_NODE_ID) {
170
+ return Boolean(connection.sourceHandle && connection.targetHandle);
171
+ }
172
+ // Object port → transform in
173
+ if (source === SOURCE_OBJECT_NODE_ID && target.startsWith('xf:')) {
174
+ return Boolean(connection.sourceHandle);
175
+ }
176
+ // Transform out → object port
177
+ if (source.startsWith('xf:') && target === TARGET_OBJECT_NODE_ID) {
178
+ return Boolean(connection.targetHandle);
179
+ }
180
+ // Transform chain mid-links
181
+ if (source.startsWith('xf:') && target.startsWith('xf:')) {
182
+ return true;
183
+ }
184
+ return false;
185
+ }, []);
186
+
187
+ const onConnect = useCallback(
188
+ (connection: Connection) => {
189
+ if (!connection.source || !connection.target) {
190
+ return;
191
+ }
192
+ const next = connectionToMappingEdge({
193
+ sourceNodeId: connection.source,
194
+ targetNodeId: connection.target,
195
+ sourceHandle: connection.sourceHandle,
196
+ targetHandle: connection.targetHandle,
197
+ existing: edges,
198
+ });
199
+ if (!next) {
200
+ return;
201
+ }
202
+ const withoutTarget = edges.filter((edge) => edge.targetSlotId !== next.targetSlotId);
203
+ onEdgesChange([...withoutTarget, next]);
204
+ },
205
+ [edges, onEdgesChange],
206
+ );
207
+
208
+ const onEdgesDelete = useCallback(
209
+ (deleted: Edge[]) => {
210
+ const mappingIds = new Set(
211
+ deleted
212
+ .map((edge) => {
213
+ const data = edge.data as FieldRemapFlowEdgeData | undefined;
214
+ return data?.mappingEdgeId;
215
+ })
216
+ .filter((id): id is string => typeof id === 'string'),
217
+ );
218
+ if (mappingIds.size === 0) {
219
+ return;
220
+ }
221
+ onEdgesChange(edges.filter((edge) => !mappingIds.has(edge.id)));
222
+ },
223
+ [edges, onEdgesChange],
224
+ );
225
+
226
+ const addTransform = (mappingEdgeId: string, transformId: string) => {
227
+ onEdgesChange(
228
+ edges.map((edge) => {
229
+ if (edge.id !== mappingEdgeId) {
230
+ return edge;
231
+ }
232
+ const current = edge.transformIds ?? [];
233
+ if (current.length >= MAX_TRANSFORM_CHAIN) {
234
+ return edge;
235
+ }
236
+ return { ...edge, transformIds: [...current, transformId] };
237
+ }),
238
+ );
239
+ };
240
+
241
+ const removeTransformStep = (mappingEdgeId: string, stepIndex: number) => {
242
+ onEdgesChange(
243
+ edges.map((edge) => {
244
+ if (edge.id !== mappingEdgeId) {
245
+ return edge;
246
+ }
247
+ const next = [...(edge.transformIds ?? [])];
248
+ next.splice(stepIndex, 1);
249
+ const optionSteps = edge.transformOptionSteps ? [...edge.transformOptionSteps] : undefined;
250
+ if (optionSteps) {
251
+ optionSteps.splice(stepIndex, 1);
252
+ }
253
+ return {
254
+ ...edge,
255
+ transformIds: next.length > 0 ? next : undefined,
256
+ transformOptionSteps: optionSteps && optionSteps.length > 0 ? optionSteps : undefined,
257
+ };
258
+ }),
259
+ );
260
+ };
261
+
262
+ const onNodeClick = useCallback(
263
+ (_event: MouseEvent, node: Node) => {
264
+ const data = node.data as FieldRemapFlowNodeData;
265
+ if (data.kind !== 'transform') {
266
+ return;
267
+ }
268
+ if (_event.altKey) {
269
+ removeTransformStep(data.mappingEdgeId, data.stepIndex);
270
+ }
271
+ },
272
+ [edges, onEdgesChange],
273
+ );
274
+
275
+ const defaultTransformId = catalog[0]?.id ?? 'string:trim';
276
+
277
+ return (
278
+ <div className="workbench-field-remap-flow" data-testid="field-remap-mapper">
279
+ <p className="workbench-field-remap-mapper__hint" data-testid="field-remap-hint">
280
+ Each object/table is one node with field ports. Drag a left field to a right field (one
281
+ source can fan out to many targets). Middle nodes are transforms (Alt-click to remove).
282
+ </p>
283
+
284
+ <div className="workbench-field-remap-flow__canvas" data-testid="field-remap-flow">
285
+ <ReactFlow
286
+ nodes={nodes}
287
+ edges={flowEdges}
288
+ nodeTypes={nodeTypes}
289
+ onNodesChange={onNodesChange}
290
+ onEdgesChange={onFlowEdgesChange}
291
+ onConnect={onConnect}
292
+ onEdgesDelete={onEdgesDelete}
293
+ onNodeClick={onNodeClick}
294
+ isValidConnection={isValidConnection}
295
+ fitView
296
+ fitViewOptions={{ padding: 0.12, maxZoom: 1.15 }}
297
+ proOptions={{ hideAttribution: true }}
298
+ >
299
+ <Background gap={16} color="var(--xy-background-pattern-color)" />
300
+ <Controls showInteractive={false} />
301
+ <MiniMap
302
+ pannable
303
+ zoomable
304
+ bgColor="var(--xy-minimap-background-color)"
305
+ maskColor="var(--xy-minimap-mask-background-color)"
306
+ nodeColor={(node) => {
307
+ const kind = (node.data as FieldRemapFlowNodeData | undefined)?.kind;
308
+ if (kind === 'source-object') {
309
+ return 'var(--vscode-charts-blue, #3794ff)';
310
+ }
311
+ if (kind === 'target-object') {
312
+ return 'var(--vscode-charts-green, #89d185)';
313
+ }
314
+ return 'var(--vscode-focusBorder, var(--color-accent, #3794ff))';
315
+ }}
316
+ nodeStrokeColor="var(--xy-minimap-node-stroke-color)"
317
+ />
318
+ </ReactFlow>
319
+ </div>
320
+
321
+ <div className="workbench-field-remap-flow__bindings" data-testid="field-remap-edges">
322
+ <h4>Bindings</h4>
323
+ <ul>
324
+ {edges.map((edge) => (
325
+ <li key={edge.id} data-testid={`field-remap-lane-${edge.id}`}>
326
+ <code>
327
+ {edge.sourceFieldId} →{' '}
328
+ {(edge.transformIds ?? []).length > 0
329
+ ? `${(edge.transformIds ?? []).join(' → ')} → `
330
+ : ''}
331
+ {edge.targetSlotId}
332
+ </code>
333
+ <span className="workbench-field-remap-mapper__edge-actions">
334
+ {(edge.transformIds?.length ?? 0) < MAX_TRANSFORM_CHAIN ? (
335
+ <Button
336
+ compact
337
+ type="button"
338
+ data-testid={`field-remap-add-node-${edge.id}`}
339
+ onClick={() => addTransform(edge.id, defaultTransformId)}
340
+ >
341
+ + node
342
+ </Button>
343
+ ) : null}
344
+ <Button
345
+ compact
346
+ type="button"
347
+ onClick={() => onEdgesChange(edges.filter((item) => item.id !== edge.id))}
348
+ >
349
+ Remove
350
+ </Button>
351
+ </span>
352
+ </li>
353
+ ))}
354
+ </ul>
355
+ </div>
356
+ </div>
357
+ );
358
+ }
359
+
360
+ /**
361
+ * React Flow mapper: multi-port source object → transforms → multi-port target object.
362
+ */
363
+ export function FieldRemapFlowMapper(props: FieldRemapFlowMapperProps): JSX.Element {
364
+ return (
365
+ <ReactFlowProvider>
366
+ <FieldRemapFlowCanvas {...props} />
367
+ </ReactFlowProvider>
368
+ );
369
+ }