@flowdrop/flowdrop 2.0.0-beta.1 → 2.0.0-beta.10

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 (228) hide show
  1. package/CHANGELOG.md +173 -0
  2. package/MIGRATION-2.0.md +173 -3
  3. package/README.md +5 -5
  4. package/dist/adapters/WorkflowAdapter.js +4 -5
  5. package/dist/adapters/agentspec/AgentSpecAdapter.js +3 -3
  6. package/dist/adapters/agentspec/defaultNodeTypes.js +9 -9
  7. package/dist/api/enhanced-client.js +6 -11
  8. package/dist/commands/executor.js +51 -26
  9. package/dist/commands/storeIntegration.svelte.js +11 -1
  10. package/dist/commands/types.js +5 -5
  11. package/dist/components/App.svelte +547 -386
  12. package/dist/components/App.svelte.d.ts +16 -8
  13. package/dist/components/Button.stories.svelte +65 -0
  14. package/dist/components/Button.stories.svelte.d.ts +19 -0
  15. package/dist/components/Button.svelte +62 -0
  16. package/dist/components/Button.svelte.d.ts +24 -0
  17. package/dist/components/CanvasIconButton.svelte +76 -0
  18. package/dist/components/CanvasIconButton.svelte.d.ts +18 -0
  19. package/dist/components/ConfigForm.svelte +167 -562
  20. package/dist/components/ConfigForm.svelte.d.ts +24 -7
  21. package/dist/components/ConfigModal.svelte +9 -1
  22. package/dist/components/ConfigPanel.svelte +234 -15
  23. package/dist/components/ConfigPanel.svelte.d.ts +6 -0
  24. package/dist/components/EditorStatusBar.stories.svelte +44 -0
  25. package/dist/components/EditorStatusBar.stories.svelte.d.ts +27 -0
  26. package/dist/components/EditorStatusBar.svelte +99 -0
  27. package/dist/components/EditorStatusBar.svelte.d.ts +15 -0
  28. package/dist/components/IconButton.svelte +80 -0
  29. package/dist/components/IconButton.svelte.d.ts +30 -0
  30. package/dist/components/Input.svelte +74 -0
  31. package/dist/components/Input.svelte.d.ts +17 -0
  32. package/dist/components/LogoWordmark.svelte +113 -0
  33. package/dist/components/LogoWordmark.svelte.d.ts +26 -0
  34. package/dist/components/Navbar.svelte +17 -63
  35. package/dist/components/Navbar.svelte.d.ts +3 -0
  36. package/dist/components/NodeSidebar.svelte +21 -126
  37. package/dist/components/NodeSwapPicker.svelte +12 -30
  38. package/dist/components/PipelineStatus.svelte +6 -1
  39. package/dist/components/PipelineStatus.svelte.d.ts +3 -0
  40. package/dist/components/PortMappingRow.svelte +0 -2
  41. package/dist/components/SchemaForm.svelte +4 -14
  42. package/dist/components/Select.svelte +53 -0
  43. package/dist/components/Select.svelte.d.ts +15 -0
  44. package/dist/components/SettingsModal.svelte +0 -5
  45. package/dist/components/SettingsPanel.svelte +24 -6
  46. package/dist/components/Textarea.svelte +39 -0
  47. package/dist/components/Textarea.svelte.d.ts +12 -0
  48. package/dist/components/ThemeToggle.svelte +15 -94
  49. package/dist/components/UniversalNode.svelte +36 -4
  50. package/dist/components/UniversalNode.svelte.d.ts +1 -1
  51. package/dist/components/WorkflowEditor.svelte +66 -52
  52. package/dist/components/WorkflowEditor.svelte.d.ts +21 -0
  53. package/dist/components/chat/AIChatPanel.svelte +7 -2
  54. package/dist/components/console/ConsoleAutocomplete.svelte +1 -1
  55. package/dist/components/console/ConsoleInput.svelte +3 -3
  56. package/dist/components/console/ConsoleOutput.svelte +2 -2
  57. package/dist/components/form/FormArray.svelte +37 -173
  58. package/dist/components/form/FormAutocomplete.svelte +18 -15
  59. package/dist/components/form/FormCheckboxGroup.svelte +1 -5
  60. package/dist/components/form/FormCodeEditor.svelte +9 -7
  61. package/dist/components/form/FormField.svelte +18 -42
  62. package/dist/components/form/FormFieldLight.svelte +52 -48
  63. package/dist/components/form/FormFieldLight.svelte.d.ts +12 -0
  64. package/dist/components/form/FormFieldset.svelte +45 -11
  65. package/dist/components/form/FormMarkdownEditor.svelte +8 -5
  66. package/dist/components/form/FormNumberField.svelte +4 -36
  67. package/dist/components/form/FormPorts.svelte +262 -0
  68. package/dist/components/form/FormPorts.svelte.d.ts +13 -0
  69. package/dist/components/form/FormRangeField.svelte +61 -30
  70. package/dist/components/form/FormSelect.svelte +13 -75
  71. package/dist/components/form/FormTemplateEditor.svelte +6 -4
  72. package/dist/components/form/FormTextField.svelte +3 -35
  73. package/dist/components/form/FormTextarea.svelte +4 -39
  74. package/dist/components/form/FormToggle.svelte +0 -4
  75. package/dist/components/form/FormUISchemaRenderer.svelte +3 -1
  76. package/dist/components/form/resolveFieldType.d.ts +24 -0
  77. package/dist/components/form/resolveFieldType.js +55 -0
  78. package/dist/components/icons/CloseIcon.svelte +6 -0
  79. package/dist/components/icons/CloseIcon.svelte.d.ts +26 -0
  80. package/dist/components/icons/CommandLineIcon.svelte +15 -0
  81. package/dist/components/icons/CommandLineIcon.svelte.d.ts +26 -0
  82. package/dist/components/icons/MenuIcon.svelte +4 -0
  83. package/dist/components/icons/MenuIcon.svelte.d.ts +26 -0
  84. package/dist/components/icons/MenuOpenIcon.svelte +6 -0
  85. package/dist/components/icons/MenuOpenIcon.svelte.d.ts +26 -0
  86. package/dist/components/interrupt/ChoicePrompt.svelte +0 -10
  87. package/dist/components/interrupt/ConfirmationPrompt.svelte +0 -5
  88. package/dist/components/interrupt/InterruptBubble.svelte +11 -12
  89. package/dist/components/interrupt/ReviewPrompt.svelte +0 -20
  90. package/dist/components/interrupt/TextInputPrompt.svelte +0 -6
  91. package/dist/components/layouts/MainLayout.svelte +4 -5
  92. package/dist/components/nodes/AtomNode.svelte +62 -76
  93. package/dist/components/nodes/AtomNode.svelte.d.ts +1 -1
  94. package/dist/components/nodes/GatewayNode.svelte +117 -164
  95. package/dist/components/nodes/GatewayNode.svelte.d.ts +1 -1
  96. package/dist/components/nodes/IdeaNode.svelte +72 -98
  97. package/dist/components/nodes/IdeaNode.svelte.d.ts +8 -4
  98. package/dist/components/nodes/NodeConfigButton.svelte +86 -0
  99. package/dist/components/nodes/NodeConfigButton.svelte.d.ts +15 -0
  100. package/dist/components/nodes/NotesNode.svelte +76 -85
  101. package/dist/components/nodes/NotesNode.svelte.d.ts +8 -4
  102. package/dist/components/nodes/SimpleNode.svelte +59 -133
  103. package/dist/components/nodes/SimpleNode.svelte.d.ts +4 -4
  104. package/dist/components/nodes/SquareNode.svelte +110 -164
  105. package/dist/components/nodes/SquareNode.svelte.d.ts +4 -4
  106. package/dist/components/nodes/TerminalNode.svelte +62 -124
  107. package/dist/components/nodes/TerminalNode.svelte.d.ts +4 -4
  108. package/dist/components/nodes/ToolNode.svelte +92 -103
  109. package/dist/components/nodes/ToolNode.svelte.d.ts +6 -6
  110. package/dist/components/nodes/WorkflowNode.svelte +132 -191
  111. package/dist/components/nodes/WorkflowNode.svelte.d.ts +1 -1
  112. package/dist/components/playground/ChatInput.svelte +0 -1
  113. package/dist/components/playground/InputCollector.svelte +11 -48
  114. package/dist/components/playground/PipelineKanbanView.svelte +6 -4
  115. package/dist/components/playground/PipelineKanbanView.svelte.d.ts +2 -0
  116. package/dist/components/playground/PipelinePanel.svelte +20 -3
  117. package/dist/components/playground/PipelinePanel.svelte.d.ts +2 -0
  118. package/dist/components/playground/PipelineTableView.svelte +6 -4
  119. package/dist/components/playground/PipelineTableView.svelte.d.ts +2 -0
  120. package/dist/components/playground/Playground.svelte +76 -25
  121. package/dist/components/playground/Playground.svelte.d.ts +3 -0
  122. package/dist/components/playground/PlaygroundApp.svelte +6 -1
  123. package/dist/components/playground/PlaygroundApp.svelte.d.ts +3 -0
  124. package/dist/components/playground/PlaygroundModal.svelte +5 -0
  125. package/dist/components/playground/PlaygroundModal.svelte.d.ts +3 -0
  126. package/dist/components/playground/PlaygroundStudio.svelte +7 -6
  127. package/dist/components/playground/PlaygroundStudio.svelte.d.ts +3 -0
  128. package/dist/components/playground/pipelineViewUtils.svelte.d.ts +2 -1
  129. package/dist/components/playground/pipelineViewUtils.svelte.js +2 -2
  130. package/dist/components/surfaces/SurfaceOverlay.svelte +153 -0
  131. package/dist/components/surfaces/SurfaceOverlay.svelte.d.ts +14 -0
  132. package/dist/components/surfaces/TabbedSurface.svelte +133 -0
  133. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +27 -0
  134. package/dist/config/endpoints.d.ts +23 -0
  135. package/dist/config/endpoints.js +28 -0
  136. package/dist/core/index.d.ts +2 -3
  137. package/dist/core/index.js +2 -6
  138. package/dist/display/index.d.ts +6 -1
  139. package/dist/display/index.js +9 -1
  140. package/dist/editor/index.d.ts +1 -1
  141. package/dist/editor/index.js +1 -1
  142. package/dist/form/full.d.ts +2 -1
  143. package/dist/form/full.js +4 -1
  144. package/dist/form/index.d.ts +0 -1
  145. package/dist/form/index.js +3 -2
  146. package/dist/helpers/workflowEditorHelper.d.ts +4 -2
  147. package/dist/helpers/workflowEditorHelper.js +8 -8
  148. package/dist/messages/index.d.ts +1 -1
  149. package/dist/messages/index.js +1 -1
  150. package/dist/openapi/v1/openapi.yaml +35 -23
  151. package/dist/playground/index.d.ts +2 -2
  152. package/dist/playground/index.js +2 -2
  153. package/dist/playground/mount.d.ts +19 -5
  154. package/dist/playground/mount.js +16 -8
  155. package/dist/registry/builtinNodeTypes.d.ts +53 -0
  156. package/dist/registry/builtinNodeTypes.js +67 -0
  157. package/dist/registry/builtinNodes.d.ts +2 -39
  158. package/dist/registry/builtinNodes.js +6 -53
  159. package/dist/registry/nodeComponentRegistry.d.ts +2 -1
  160. package/dist/schemas/v1/workflow.schema.json +16 -14
  161. package/dist/services/agentSpecExecutionService.d.ts +0 -2
  162. package/dist/services/agentSpecExecutionService.js +0 -2
  163. package/dist/services/apiVariableService.js +12 -26
  164. package/dist/services/categoriesApi.js +3 -6
  165. package/dist/services/chatService.d.ts +4 -3
  166. package/dist/services/chatService.js +13 -18
  167. package/dist/services/dynamicSchemaService.d.ts +31 -4
  168. package/dist/services/dynamicSchemaService.js +62 -33
  169. package/dist/services/historyService.d.ts +30 -8
  170. package/dist/services/historyService.js +51 -15
  171. package/dist/services/interruptService.d.ts +7 -6
  172. package/dist/services/interruptService.js +19 -21
  173. package/dist/services/playgroundService.d.ts +9 -8
  174. package/dist/services/playgroundService.js +23 -25
  175. package/dist/services/portConfigApi.js +3 -6
  176. package/dist/services/settingsService.d.ts +9 -4
  177. package/dist/services/settingsService.js +23 -12
  178. package/dist/skins/drafter.d.ts +30 -0
  179. package/dist/skins/drafter.js +198 -0
  180. package/dist/skins/index.d.ts +2 -1
  181. package/dist/skins/index.js +4 -2
  182. package/dist/stores/apiContext.d.ts +11 -0
  183. package/dist/stores/apiContext.js +15 -0
  184. package/dist/stores/categoriesStore.svelte.js +0 -1
  185. package/dist/stores/historyStore.svelte.d.ts +17 -3
  186. package/dist/stores/historyStore.svelte.js +30 -3
  187. package/dist/stores/instanceContainer.svelte.js +5 -0
  188. package/dist/stores/playgroundStore.svelte.js +1 -3
  189. package/dist/stores/settingsStore.svelte.d.ts +13 -0
  190. package/dist/stores/settingsStore.svelte.js +32 -0
  191. package/dist/stores/workflowStore.svelte.d.ts +42 -5
  192. package/dist/stores/workflowStore.svelte.js +109 -32
  193. package/dist/styles/base.css +285 -14
  194. package/dist/styles/tokens.css +60 -2
  195. package/dist/svelte-app.d.ts +18 -1
  196. package/dist/svelte-app.js +75 -110
  197. package/dist/themes/drafter.d.ts +2 -0
  198. package/dist/themes/drafter.js +15 -0
  199. package/dist/themes/index.d.ts +2 -1
  200. package/dist/themes/index.js +8 -2
  201. package/dist/types/auth.d.ts +9 -51
  202. package/dist/types/auth.js +4 -54
  203. package/dist/types/events.d.ts +18 -0
  204. package/dist/types/events.js +2 -1
  205. package/dist/types/index.d.ts +84 -29
  206. package/dist/types/index.js +0 -1
  207. package/dist/types/settings.d.ts +17 -1
  208. package/dist/types/settings.js +4 -2
  209. package/dist/types/skin.d.ts +1 -1
  210. package/dist/types/theme.d.ts +16 -2
  211. package/dist/types/uischema.d.ts +5 -0
  212. package/dist/utils/colors.d.ts +27 -0
  213. package/dist/utils/colors.js +23 -0
  214. package/dist/utils/connections.js +20 -56
  215. package/dist/utils/edgeStyling.js +9 -5
  216. package/dist/utils/fetchWithAuth.d.ts +36 -15
  217. package/dist/utils/fetchWithAuth.js +53 -23
  218. package/dist/utils/nodeIds.d.ts +1 -1
  219. package/dist/utils/nodeIds.js +1 -1
  220. package/dist/utils/nodeSwap.js +3 -6
  221. package/dist/utils/nodeTypes.js +1 -1
  222. package/dist/utils/portUtils.d.ts +47 -11
  223. package/dist/utils/portUtils.js +67 -14
  224. package/dist/utils/portal.d.ts +18 -0
  225. package/dist/utils/portal.js +34 -0
  226. package/dist/utils/schemaMerge.d.ts +25 -0
  227. package/dist/utils/schemaMerge.js +61 -0
  228. package/package.json +2 -1
@@ -4,31 +4,32 @@
4
4
  Uses SvelteFlow's Handle for connection ports
5
5
  Styled with BEM syntax
6
6
 
7
- UI Extensions Support:
8
- - hideUnconnectedHandles: Hides ports that are not connected to reduce visual clutter
9
- - portOrder: Visual-only reordering of input/output ports (no effect on execution)
10
- - hiddenPorts: Manually hidden ports per direction (required ports cannot be hidden)
7
+ Port rendering:
8
+ - Exposure (data.config.ports, falling back to each port's exposedByDefault)
9
+ decides which ports render — a not-exposed port is hidden.
10
+ - Order: data.config.ports order overrides the metadata default (displayOrder);
11
+ cosmetic only, no effect on execution.
11
12
  -->
12
13
 
13
14
  <script lang="ts">
14
15
  import { Position, Handle } from '@xyflow/svelte';
15
- import type { WorkflowNode, NodePort, DynamicPort } from '../../types/index.js';
16
+ import type { WorkflowNode, DynamicPort, PortsConfig } from '../../types/index.js';
16
17
  import { dynamicPortToNodePort } from '../../types/index.js';
17
18
  import Icon from '@iconify/svelte';
18
19
  import { getNodeIcon } from '../../utils/icons.js';
19
- import CogIcon from '../icons/CogIcon.svelte';
20
+ import NodeConfigButton from './NodeConfigButton.svelte';
20
21
  import {
21
- getDataTypeColorToken,
22
22
  getCategoryColorToken,
23
- getPortBackgroundColor
23
+ getPortColorToken,
24
+ getPortBackgroundColorForPort
24
25
  } from '../../utils/colors.js';
25
26
  import { getInstance } from '../../stores/getInstance.svelte.js';
26
- import { applyPortOrder } from '../../utils/portUtils.js';
27
+ import { orderPortsFor, isPortVisible } from '../../utils/portUtils.js';
27
28
  import { m } from '../../messages/index.js';
28
29
 
29
30
  interface Props {
31
+ id: string;
30
32
  data: WorkflowNode['data'] & {
31
- nodeId?: string;
32
33
  onConfigOpen?: (node: { id: string; type: string; data: WorkflowNode['data'] }) => void;
33
34
  };
34
35
  selected?: boolean;
@@ -61,30 +62,11 @@
61
62
  );
62
63
 
63
64
  /**
64
- * Get the hideUnconnectedHandles setting from extensions
65
- * Merges node type defaults with instance overrides
65
+ * Per-instance port order + exposure, in config. Order overrides the metadata
66
+ * default; exposure is semantic (a not-exposed port is hidden, not wireable,
67
+ * not runtime-overridable).
66
68
  */
67
- const hideUnconnectedHandles = $derived(
68
- props.data.extensions?.ui?.hideUnconnectedHandles ??
69
- props.data.metadata?.extensions?.ui?.hideUnconnectedHandles ??
70
- false
71
- );
72
-
73
- /**
74
- * Get the portOrder setting from extensions (visual-only, no effect on execution)
75
- * Merges node type defaults with instance overrides
76
- */
77
- const portOrder = $derived(
78
- props.data.extensions?.ui?.portOrder ?? props.data.metadata?.extensions?.ui?.portOrder ?? {}
79
- );
80
-
81
- /**
82
- * Get the hiddenPorts setting from extensions (visual-only, no effect on execution)
83
- * Merges node type defaults with instance overrides
84
- */
85
- const hiddenPorts = $derived(
86
- props.data.extensions?.ui?.hiddenPorts ?? props.data.metadata?.extensions?.ui?.hiddenPorts ?? {}
87
- );
69
+ const portsConfig = $derived((props.data.config?.ports as PortsConfig | undefined) ?? {});
88
70
 
89
71
  /**
90
72
  * Dynamic inputs from config - user-defined input ports
@@ -108,70 +90,34 @@
108
90
 
109
91
  /**
110
92
  * Combined input ports: static metadata inputs + dynamic config inputs,
111
- * sorted by portOrder if set (visual-only)
93
+ * in effective order (metadata default, then config override; cosmetic).
112
94
  */
113
95
  const allInputPorts = $derived(
114
- applyPortOrder([...props.data.metadata.inputs, ...dynamicInputs], portOrder.inputs)
96
+ orderPortsFor([...props.data.metadata.inputs, ...dynamicInputs], portsConfig.inputs)
115
97
  );
116
98
 
117
99
  /**
118
100
  * Combined output ports: static metadata outputs + dynamic config outputs,
119
- * sorted by portOrder if set (visual-only)
101
+ * in effective order (metadata default, then config override; cosmetic).
120
102
  */
121
103
  const allOutputPorts = $derived(
122
- applyPortOrder([...props.data.metadata.outputs, ...dynamicOutputs], portOrder.outputs)
104
+ orderPortsFor([...props.data.metadata.outputs, ...dynamicOutputs], portsConfig.outputs)
123
105
  );
124
106
 
125
107
  /**
126
- * Check if a port should be visible based on connection state and settings
127
- * @param port - The port to check
128
- * @param type - Whether this is an 'input' or 'output' port
129
- * @returns true if the port should be visible
108
+ * Derived list of exposed input ports (static + dynamic).
130
109
  */
131
- function isPortVisible(port: NodePort, type: 'input' | 'output'): boolean {
132
- // Manual hide takes precedence (required ports are prevented from being hidden in ConfigForm)
133
- const manuallyHidden =
134
- type === 'input'
135
- ? hiddenPorts.inputs?.includes(port.id)
136
- : hiddenPorts.outputs?.includes(port.id);
137
- if (manuallyHidden) return false;
138
-
139
- // Always show if hideUnconnectedHandles is disabled
140
- if (!hideUnconnectedHandles) {
141
- return true;
142
- }
143
-
144
- // Always show required ports
145
- if (port.required) {
146
- return true;
147
- }
148
-
149
- // Check if port is connected
150
- const handleId = `${props.data.nodeId}-${type}-${port.id}`;
151
- return fd.workflow.connectedHandles.has(handleId);
152
- }
153
-
154
- /**
155
- * Derived list of visible input ports based on hideUnconnectedHandles setting
156
- * Now includes both static and dynamic inputs
157
- */
158
- const visibleInputPorts = $derived(allInputPorts.filter((port) => isPortVisible(port, 'input')));
110
+ const visibleInputPorts = $derived(
111
+ allInputPorts.filter((port) => isPortVisible(port, 'input', portsConfig))
112
+ );
159
113
 
160
114
  /**
161
- * Derived list of visible output ports based on hideUnconnectedHandles setting
162
- * Now includes both static and dynamic outputs
115
+ * Derived list of exposed output ports (static + dynamic).
163
116
  */
164
117
  const visibleOutputPorts = $derived(
165
- allOutputPorts.filter((port) => isPortVisible(port, 'output'))
118
+ allOutputPorts.filter((port) => isPortVisible(port, 'output', portsConfig))
166
119
  );
167
120
 
168
- /**
169
- * Handle node click - only handle selection, no config opening
170
- */
171
- function handleNodeClick(): void {
172
- // Node selection is handled by Svelte Flow
173
- }
174
-
175
121
  /**
176
122
  * Handle double-click to open config
177
123
  */
@@ -186,7 +132,7 @@
186
132
  if (props.data.onConfigOpen) {
187
133
  // Create a WorkflowNodeType-like object for the global ConfigSidebar
188
134
  const nodeForConfig = {
189
- id: props.data.nodeId || 'unknown',
135
+ id: props.id,
190
136
  type: 'workflowNode',
191
137
  data: props.data
192
138
  };
@@ -196,25 +142,19 @@
196
142
  </script>
197
143
 
198
144
  <!-- Node Container -->
145
+ <!-- Presentational: focus, keyboard and selection live on xyflow's node
146
+ wrapper (see UniversalNode). double-click is a mouse convenience. -->
147
+ <!-- svelte-ignore a11y_no_static_element_interactions -->
199
148
  <div
200
149
  class="flowdrop-workflow-node"
201
150
  class:flowdrop-workflow-node--selected={props.selected}
202
- onclick={handleNodeClick}
203
151
  ondblclick={handleDoubleClick}
204
152
  onmouseup={() => {
205
153
  isHandleInteraction = false;
206
154
  }}
207
155
  data-handle-interaction={isHandleInteraction}
208
- role="button"
209
- tabindex="0"
210
- onkeydown={(e) => {
211
- if (e.key === 'Enter' || e.key === ' ') {
212
- e.preventDefault();
213
- handleDoubleClick();
214
- }
215
- }}
216
156
  aria-label={graph.workflowNode({ name: props.data.metadata.name })}
217
- aria-describedby="node-description-{props.data.nodeId || 'unknown'}"
157
+ aria-describedby="node-description-{props.id}"
218
158
  >
219
159
  <!-- Default Node Header: expands in multiples of 10 (title row 40px + gap 10px + description 20px per line) -->
220
160
  <div class="flowdrop-workflow-node__header">
@@ -236,7 +176,7 @@
236
176
  ></span>
237
177
 
238
178
  <!-- Node Title - Icon and Title on same line -->
239
- <h3 class="flowdrop-text--sm flowdrop-font--medium flowdrop-truncate flowdrop-flex--1">
179
+ <h3 class="flowdrop-text--sm flowdrop-font--medium flowdrop-flex--1">
240
180
  {displayTitle}
241
181
  </h3>
242
182
 
@@ -244,10 +184,7 @@
244
184
  <div class="flowdrop-flex flowdrop-gap--2 flowdrop-items--center"></div>
245
185
  </div>
246
186
  <!-- Node Description - line-height 20px so header grows in steps of 10 -->
247
- <p
248
- class="flowdrop-workflow-node__header-desc"
249
- id="node-description-{props.data.nodeId || 'unknown'}"
250
- >
187
+ <p class="flowdrop-workflow-node__header-desc" id="node-description-{props.id}">
251
188
  {displayDescription}
252
189
  </p>
253
190
  </div>
@@ -258,15 +195,15 @@
258
195
  <div class="flowdrop-workflow-node__ports-list">
259
196
  {#each visibleInputPorts as port (port.id)}
260
197
  <div class="flowdrop-workflow-node__port">
261
- <!-- Input Handle: centered in row, at node edge (ports have no padding) -->
198
+ <!-- Input Handle: one grid row (20px) from the top so it aligns with the label, at node edge -->
262
199
  <Handle
263
200
  type="target"
264
201
  position={Position.Left}
265
- id={`${props.data.nodeId}-input-${port.id}`}
202
+ id={`${props.id}-input-${port.id}`}
266
203
  class="flowdrop-workflow-node__handle"
267
- style="top: 50%; transform: translateY(-50%); --fd-handle-fill: var(--fd-port-skin-color, {getDataTypeColorToken(
204
+ style="top: var(--fd-node-port-row-height); transform: translateY(-50%); --fd-handle-fill: var(--fd-port-skin-color, {getPortColorToken(
268
205
  checker,
269
- port.dataType
206
+ port
270
207
  )}); --fd-handle-border-color: var(--fd-handle-border);"
271
208
  tabindex={-1}
272
209
  />
@@ -277,14 +214,14 @@
277
214
  <span class="flowdrop-text--xs flowdrop-font--medium">{port.name}</span>
278
215
  <span
279
216
  class="flowdrop-badge flowdrop-badge--sm"
280
- style="background-color: {getPortBackgroundColor(
217
+ style="background-color: {getPortBackgroundColorForPort(
281
218
  checker,
282
- port.dataType,
219
+ port,
283
220
  15
284
- )}; color: {getDataTypeColorToken(
221
+ )}; color: {getPortColorToken(
285
222
  checker,
286
- port.dataType
287
- )}; border: 1px solid {getPortBackgroundColor(checker, port.dataType, 30)};"
223
+ port
224
+ )}; border: 1px solid {getPortBackgroundColorForPort(checker, port, 30)};"
288
225
  >
289
226
  {port.dataType}
290
227
  </span>
@@ -320,14 +257,14 @@
320
257
  <span class="flowdrop-text--xs flowdrop-font--medium">{port.name}</span>
321
258
  <span
322
259
  class="flowdrop-badge flowdrop-badge--sm"
323
- style="background-color: {getPortBackgroundColor(
260
+ style="background-color: {getPortBackgroundColorForPort(
324
261
  checker,
325
- port.dataType,
262
+ port,
326
263
  15
327
- )}; color: {getDataTypeColorToken(
264
+ )}; color: {getPortColorToken(
328
265
  checker,
329
- port.dataType
330
- )}; border: 1px solid {getPortBackgroundColor(checker, port.dataType, 30)};"
266
+ port
267
+ )}; border: 1px solid {getPortBackgroundColorForPort(checker, port, 30)};"
331
268
  >
332
269
  {port.dataType}
333
270
  </span>
@@ -339,15 +276,15 @@
339
276
  {/if}
340
277
  </div>
341
278
 
342
- <!-- Output Handle: centered in row, at node edge (ports have no padding) -->
279
+ <!-- Output Handle: one grid row (20px) from the top so it aligns with the label, at node edge -->
343
280
  <Handle
344
281
  type="source"
345
282
  position={Position.Right}
346
- id={`${props.data.nodeId}-output-${port.id}`}
283
+ id={`${props.id}-output-${port.id}`}
347
284
  class="flowdrop-workflow-node__handle"
348
- style="top: 50%; transform: translateY(-50%); --fd-handle-fill: var(--fd-port-skin-color, {getDataTypeColorToken(
285
+ style="top: var(--fd-node-port-row-height); transform: translateY(-50%); --fd-handle-fill: var(--fd-port-skin-color, {getPortColorToken(
349
286
  checker,
350
- port.dataType
287
+ port
351
288
  )}); --fd-handle-border-color: var(--fd-handle-border);"
352
289
  tabindex={-1}
353
290
  />
@@ -358,22 +295,17 @@
358
295
  {/if}
359
296
 
360
297
  <!-- Config button -->
361
- <button
362
- class="flowdrop-workflow-node__config-btn"
363
- onclick={openConfigSidebar}
364
- title="Configure node"
365
- >
366
- <CogIcon />
367
- </button>
298
+ <NodeConfigButton onclick={openConfigSidebar} title="Configure node" />
368
299
  </div>
369
300
 
370
301
  <style>
371
302
  .flowdrop-workflow-node {
372
303
  position: relative;
373
- background-color: var(--fd-card);
374
- border: 1.5px solid var(--fd-node-border);
375
- border-radius: var(--fd-radius-xl);
376
- box-shadow: var(--fd-shadow-md);
304
+ background-color: var(--fd-node-bg);
305
+ backdrop-filter: var(--fd-node-backdrop-filter);
306
+ border: var(--fd-node-border-width) solid var(--fd-node-border);
307
+ border-radius: var(--fd-node-radius);
308
+ box-shadow: var(--fd-node-shadow);
377
309
  width: var(--fd-node-default-width);
378
310
  z-index: 10;
379
311
  color: var(--fd-foreground);
@@ -381,42 +313,49 @@
381
313
  }
382
314
 
383
315
  .flowdrop-workflow-node:hover {
384
- box-shadow: var(--fd-shadow-lg);
316
+ box-shadow: var(--fd-node-shadow-hover);
385
317
  border-color: var(--fd-node-border-hover);
386
318
  }
387
319
 
388
320
  .flowdrop-workflow-node--selected {
389
321
  box-shadow:
390
322
  0 0 0 2px var(--fd-primary-muted),
391
- var(--fd-shadow-lg);
323
+ var(--fd-node-shadow-hover);
392
324
  border-color: var(--fd-primary);
393
325
  }
394
326
 
395
327
  .flowdrop-workflow-node--selected:hover {
396
328
  box-shadow:
397
329
  0 0 0 2px var(--fd-primary-muted),
398
- var(--fd-shadow-lg);
330
+ var(--fd-node-shadow-hover);
399
331
  border-color: var(--fd-primary);
400
332
  }
401
333
 
402
- .flowdrop-workflow-node:focus-visible {
403
- outline: 2px solid var(--fd-ring);
404
- outline-offset: 2px;
405
- }
334
+ /* Focus ring is centralized in base.css (drawn on the .svelte-flow__node
335
+ wrapper, which is the focusable element). */
406
336
 
407
337
  .flowdrop-workflow-node__header {
408
338
  box-sizing: border-box;
409
- padding: var(--fd-node-header-gap) var(--fd-space-xl);
410
- border-bottom: 1px solid var(--fd-border-muted);
411
- background: var(--fd-header);
412
- border-top-left-radius: var(--fd-radius-xl);
413
- border-top-right-radius: var(--fd-radius-xl);
339
+ /* Bottom padding absorbs BOTH the node's own top border and the header
340
+ divider, so the body below the header lands on the 20px grid measured
341
+ from the node's outer top edge: node-border + header = 100/120/140. */
342
+ padding: var(--fd-node-header-gap) var(--fd-space-xl)
343
+ calc(
344
+ var(--fd-node-header-gap) - var(--fd-node-border-width) -
345
+ var(--fd-node-header-divider-width)
346
+ );
347
+ border-bottom: var(--fd-node-header-divider-width) solid var(--fd-node-header-divider-color);
348
+ background: var(--fd-node-header-bg);
349
+ border-top-left-radius: var(--fd-node-radius);
350
+ border-top-right-radius: var(--fd-node-radius);
414
351
  display: flex;
415
352
  flex-direction: column;
416
- gap: var(--fd-node-header-gap);
353
+ gap: calc(var(--fd-node-header-gap) * 2);
354
+ /* node-border (1.5) + header = 100/120/140. Header itself is
355
+ 4*gap + title + desc-line - node-border; each extra desc line adds 20. */
417
356
  min-height: calc(
418
- var(--fd-node-header-gap) * 2 + var(--fd-node-header-title-height) +
419
- var(--fd-node-header-desc-line)
357
+ var(--fd-node-header-gap) * 4 + var(--fd-node-header-title-height) +
358
+ var(--fd-node-header-desc-line) - var(--fd-node-border-width)
420
359
  );
421
360
  }
422
361
 
@@ -447,9 +386,10 @@
447
386
  display: var(--fd-node-icon-display, flex);
448
387
  align-items: center;
449
388
  justify-content: center;
450
- width: 2.25rem;
451
- height: 2.25rem;
452
- border-radius: 0.5rem;
389
+ /* px (not rem) so the icon stays grid-locked regardless of root font-size */
390
+ width: 36px;
391
+ height: 36px;
392
+ border-radius: 8px;
453
393
  background: color-mix(in srgb, var(--_icon-color) var(--fd-node-icon-bg-opacity), transparent);
454
394
  flex-shrink: 0;
455
395
  transition: all var(--fd-transition-normal);
@@ -465,8 +405,8 @@
465
405
  }
466
406
 
467
407
  .flowdrop-workflow-node__icon-wrapper :global(.flowdrop-workflow-node__icon) {
468
- width: 1.25rem;
469
- height: 1.25rem;
408
+ width: 20px;
409
+ height: 20px;
470
410
  color: var(--fd-node-icon);
471
411
  }
472
412
 
@@ -481,7 +421,14 @@
481
421
 
482
422
  .flowdrop-workflow-node__header-title h3 {
483
423
  margin: 0;
484
- line-height: 1;
424
+ /* half the title block so two lines fill it exactly on the 20px grid */
425
+ line-height: calc(var(--fd-node-header-title-height) / 2);
426
+ display: -webkit-box;
427
+ -webkit-line-clamp: 2;
428
+ line-clamp: 2;
429
+ -webkit-box-orient: vertical;
430
+ overflow: hidden;
431
+ min-width: 0;
485
432
  }
486
433
 
487
434
  @keyframes pulse {
@@ -501,27 +448,52 @@
501
448
  .flowdrop-workflow-node__ports-list {
502
449
  display: flex;
503
450
  flex-direction: column;
504
- gap: var(--fd-node-header-gap);
505
- padding: var(--fd-node-header-gap) 0;
451
+ gap: 0;
452
+ /* No vertical padding: sections stack flush and node height stays a
453
+ multiple of 20. The one exception is the clearance below the header
454
+ divider, applied to the first section only (below). */
455
+ padding: 0;
456
+ }
457
+
458
+ /* The first port section sits directly below the header divider; give it a
459
+ full 20px grid row of clearance so the first port lands on the grid. */
460
+ .flowdrop-workflow-node__header
461
+ + .flowdrop-workflow-node__ports
462
+ .flowdrop-workflow-node__ports-list {
463
+ padding-top: calc(var(--fd-node-header-gap) * 2);
506
464
  }
507
465
 
508
466
  .flowdrop-workflow-node__port {
509
467
  display: flex;
510
- align-items: center;
468
+ align-items: flex-start;
511
469
  gap: 0;
512
- min-height: var(--fd-node-port-row-height);
513
- padding: var(--fd-space-3xs) 0;
470
+ /* Fixed three-row (60px) height for every port — node height stays
471
+ predictable whether or not a port carries a description. */
472
+ height: calc(var(--fd-node-port-row-height) * 3);
473
+ padding: 0;
514
474
  position: relative;
515
475
  }
516
476
 
517
477
  .flowdrop-workflow-node__port-content {
518
- padding: 0 var(--fd-space-xl);
478
+ padding: var(--fd-node-header-gap) var(--fd-space-xl) 0;
479
+ }
480
+
481
+ /* Each line in a port occupies one 20px grid row: a label-only port
482
+ centers its single row, a label + description fills both. */
483
+ .flowdrop-workflow-node__port-content > div {
484
+ min-height: var(--fd-node-port-row-height);
485
+ align-items: center;
486
+ }
487
+
488
+ .flowdrop-workflow-node__port-content > p {
489
+ min-height: var(--fd-node-port-row-height);
490
+ line-height: var(--fd-node-port-row-height);
519
491
  }
520
492
 
521
493
  .flowdrop-badge {
522
- padding: 0.125rem var(--fd-space-3xs);
494
+ padding: 2px 4px;
523
495
  border-radius: var(--fd-radius-sm);
524
- font-size: 0.625rem;
496
+ font-size: 10px;
525
497
  font-weight: 500;
526
498
  text-transform: uppercase;
527
499
  letter-spacing: 0.05em;
@@ -533,8 +505,8 @@
533
505
  }
534
506
 
535
507
  .flowdrop-badge--sm {
536
- font-size: 0.625rem;
537
- padding: 0.125rem var(--fd-space-3xs);
508
+ font-size: 10px;
509
+ padding: 2px 4px;
538
510
  }
539
511
 
540
512
  /* Handle overrides: hover scale (base 20px/12px from base.css) */
@@ -569,12 +541,12 @@
569
541
 
570
542
  .flowdrop-text--xs {
571
543
  font-size: var(--fd-text-xs);
572
- line-height: 1rem;
544
+ line-height: 16px;
573
545
  }
574
546
 
575
547
  .flowdrop-text--sm {
576
548
  font-size: var(--fd-text-sm);
577
- line-height: 1.25rem;
549
+ line-height: 20px;
578
550
  }
579
551
 
580
552
  .flowdrop-text--gray {
@@ -595,39 +567,8 @@
595
567
  text-align: right;
596
568
  }
597
569
 
598
- .flowdrop-workflow-node__config-btn :global(svg) {
599
- width: 14px;
600
- height: 14px;
601
- }
602
-
603
- .flowdrop-workflow-node__config-btn {
604
- position: absolute;
605
- top: var(--fd-space-xs);
606
- right: var(--fd-space-xs);
607
- width: 1.5rem;
608
- height: 1.5rem;
609
- background-color: var(--fd-backdrop);
610
- border: 1px solid var(--fd-border);
611
- border-radius: var(--fd-radius-sm);
612
- color: var(--fd-muted-foreground);
613
- cursor: pointer;
614
- display: flex;
615
- align-items: center;
616
- justify-content: center;
617
- opacity: 0;
618
- transition: all var(--fd-transition-normal);
619
- backdrop-filter: var(--fd-backdrop-blur);
620
- z-index: 15;
621
- font-size: var(--fd-text-sm);
622
- }
623
-
624
- .flowdrop-workflow-node:hover .flowdrop-workflow-node__config-btn {
625
- opacity: 1;
626
- }
627
-
628
- .flowdrop-workflow-node__config-btn:hover {
629
- background-color: var(--fd-muted);
630
- border-color: var(--fd-border-strong);
631
- color: var(--fd-foreground);
570
+ /* Reveal the NodeConfigButton (gear) when the node is hovered. */
571
+ .flowdrop-workflow-node:hover {
572
+ --fd-config-btn-opacity: 1;
632
573
  }
633
574
  </style>
@@ -1,7 +1,7 @@
1
1
  import type { WorkflowNode } from '../../types/index.js';
2
2
  interface Props {
3
+ id: string;
3
4
  data: WorkflowNode['data'] & {
4
- nodeId?: string;
5
5
  onConfigOpen?: (node: {
6
6
  id: string;
7
7
  type: string;
@@ -232,7 +232,6 @@
232
232
 
233
233
  .chat-input__wrapper:focus-within {
234
234
  border-color: var(--fd-primary);
235
- box-shadow: 0 0 0 3px var(--fd-primary-muted);
236
235
  }
237
236
 
238
237
  .chat-input__textarea {