@flowdrop/flowdrop 1.15.0 → 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 (323) hide show
  1. package/CHANGELOG.md +648 -0
  2. package/MIGRATION-2.0.md +642 -0
  3. package/README.md +28 -28
  4. package/dist/adapters/WorkflowAdapter.d.ts +1 -1
  5. package/dist/adapters/WorkflowAdapter.js +18 -13
  6. package/dist/adapters/agentspec/AgentSpecAdapter.js +10 -10
  7. package/dist/adapters/agentspec/defaultNodeTypes.js +9 -9
  8. package/dist/api/enhanced-client.js +6 -11
  9. package/dist/chat/batchFeedback.d.ts +39 -0
  10. package/dist/chat/batchFeedback.js +51 -0
  11. package/dist/commands/executor.js +66 -27
  12. package/dist/commands/storeIntegration.svelte.d.ts +4 -1
  13. package/dist/commands/storeIntegration.svelte.js +36 -21
  14. package/dist/commands/types.d.ts +2 -0
  15. package/dist/commands/types.js +5 -5
  16. package/dist/components/App.svelte +696 -565
  17. package/dist/components/App.svelte.d.ts +63 -16
  18. package/dist/components/Button.stories.svelte +65 -0
  19. package/dist/components/Button.stories.svelte.d.ts +19 -0
  20. package/dist/components/Button.svelte +62 -0
  21. package/dist/components/Button.svelte.d.ts +24 -0
  22. package/dist/components/CanvasIconButton.svelte +76 -0
  23. package/dist/components/CanvasIconButton.svelte.d.ts +18 -0
  24. package/dist/components/ConfigForm.svelte +181 -552
  25. package/dist/components/ConfigForm.svelte.d.ts +24 -7
  26. package/dist/components/ConfigModal.svelte +16 -3
  27. package/dist/components/ConfigPanel.svelte +234 -15
  28. package/dist/components/ConfigPanel.svelte.d.ts +6 -0
  29. package/dist/components/ConnectionLine.svelte +4 -2
  30. package/dist/components/EditorStatusBar.stories.svelte +44 -0
  31. package/dist/components/EditorStatusBar.stories.svelte.d.ts +27 -0
  32. package/dist/components/EditorStatusBar.svelte +99 -0
  33. package/dist/components/EditorStatusBar.svelte.d.ts +15 -0
  34. package/dist/components/IconButton.svelte +80 -0
  35. package/dist/components/IconButton.svelte.d.ts +30 -0
  36. package/dist/components/Input.svelte +74 -0
  37. package/dist/components/Input.svelte.d.ts +17 -0
  38. package/dist/components/LogoWordmark.svelte +113 -0
  39. package/dist/components/LogoWordmark.svelte.d.ts +26 -0
  40. package/dist/components/Navbar.svelte +78 -64
  41. package/dist/components/Navbar.svelte.d.ts +3 -0
  42. package/dist/components/NodeSidebar.svelte +48 -171
  43. package/dist/components/NodeStatusOverlay.svelte +94 -6
  44. package/dist/components/NodeSwapPicker.svelte +22 -38
  45. package/dist/components/PipelineStatus.svelte +22 -68
  46. package/dist/components/PipelineStatus.svelte.d.ts +3 -0
  47. package/dist/components/PortCoordinateTracker.svelte +5 -6
  48. package/dist/components/PortMappingRow.svelte +0 -2
  49. package/dist/components/SchemaForm.stories.svelte +1 -3
  50. package/dist/components/SchemaForm.svelte +22 -39
  51. package/dist/components/SchemaForm.svelte.d.ts +0 -8
  52. package/dist/components/Select.svelte +53 -0
  53. package/dist/components/Select.svelte.d.ts +15 -0
  54. package/dist/components/SettingsModal.svelte +8 -8
  55. package/dist/components/SettingsPanel.svelte +44 -10
  56. package/dist/components/SwapMappingEditor.svelte +67 -49
  57. package/dist/components/SwapMappingEditor.svelte.d.ts +0 -2
  58. package/dist/components/Textarea.svelte +39 -0
  59. package/dist/components/Textarea.svelte.d.ts +12 -0
  60. package/dist/components/ThemeToggle.svelte +15 -94
  61. package/dist/components/UniversalNode.svelte +45 -11
  62. package/dist/components/UniversalNode.svelte.d.ts +1 -1
  63. package/dist/components/WorkflowEditor.svelte +183 -162
  64. package/dist/components/WorkflowEditor.svelte.d.ts +39 -10
  65. package/dist/components/chat/AIChatPanel.svelte +99 -90
  66. package/dist/components/chat/AIChatPanel.svelte.d.ts +0 -4
  67. package/dist/components/chat/CommandPreview.svelte +2 -1
  68. package/dist/components/console/CommandConsole.svelte +7 -5
  69. package/dist/components/console/ConsoleAutocomplete.svelte +11 -12
  70. package/dist/components/console/ConsoleAutocomplete.svelte.d.ts +6 -0
  71. package/dist/components/console/ConsoleInput.svelte +18 -9
  72. package/dist/components/console/ConsoleOutput.svelte +4 -3
  73. package/dist/components/form/FormArray.svelte +42 -182
  74. package/dist/components/form/FormArray.svelte.d.ts +2 -1
  75. package/dist/components/form/FormAutocomplete.svelte +26 -21
  76. package/dist/components/form/FormCheckboxGroup.svelte +1 -5
  77. package/dist/components/form/FormCodeEditor.svelte +9 -7
  78. package/dist/components/form/FormField.svelte +22 -44
  79. package/dist/components/form/FormFieldLight.svelte +56 -50
  80. package/dist/components/form/FormFieldLight.svelte.d.ts +12 -0
  81. package/dist/components/form/FormFieldset.svelte +45 -11
  82. package/dist/components/form/FormMarkdownEditor.svelte +17 -9
  83. package/dist/components/form/FormNumberField.svelte +4 -36
  84. package/dist/components/form/FormPorts.svelte +262 -0
  85. package/dist/components/form/FormPorts.svelte.d.ts +13 -0
  86. package/dist/components/form/FormRangeField.svelte +62 -30
  87. package/dist/components/form/FormSelect.svelte +13 -75
  88. package/dist/components/form/FormTemplateEditor.svelte +17 -7
  89. package/dist/components/form/FormTextField.svelte +3 -35
  90. package/dist/components/form/FormTextarea.svelte +4 -39
  91. package/dist/components/form/FormToggle.svelte +5 -16
  92. package/dist/components/form/FormToggle.svelte.d.ts +4 -2
  93. package/dist/components/form/FormUISchemaRenderer.svelte +3 -1
  94. package/dist/components/form/resolveFieldType.d.ts +24 -0
  95. package/dist/components/form/resolveFieldType.js +55 -0
  96. package/dist/components/form/templateAutocomplete.js +1 -5
  97. package/dist/components/form/types.d.ts +1 -14
  98. package/dist/components/icons/CloseIcon.svelte +6 -0
  99. package/dist/components/icons/CloseIcon.svelte.d.ts +26 -0
  100. package/dist/components/icons/CommandLineIcon.svelte +15 -0
  101. package/dist/components/icons/CommandLineIcon.svelte.d.ts +26 -0
  102. package/dist/components/icons/MenuIcon.svelte +4 -0
  103. package/dist/components/icons/MenuIcon.svelte.d.ts +26 -0
  104. package/dist/components/icons/MenuOpenIcon.svelte +6 -0
  105. package/dist/components/icons/MenuOpenIcon.svelte.d.ts +26 -0
  106. package/dist/components/interrupt/ChoicePrompt.svelte +0 -10
  107. package/dist/components/interrupt/ConfirmationPrompt.svelte +0 -5
  108. package/dist/components/interrupt/FormPrompt.svelte +3 -2
  109. package/dist/components/interrupt/InterruptBubble.svelte +25 -27
  110. package/dist/components/interrupt/ReviewPrompt.svelte +10 -23
  111. package/dist/components/interrupt/TextInputPrompt.svelte +2 -7
  112. package/dist/components/layouts/MainLayout.svelte +24 -18
  113. package/dist/components/layouts/MainLayout.svelte.d.ts +4 -0
  114. package/dist/components/nodes/AtomNode.svelte +70 -72
  115. package/dist/components/nodes/AtomNode.svelte.d.ts +1 -1
  116. package/dist/components/nodes/GatewayNode.svelte +134 -172
  117. package/dist/components/nodes/GatewayNode.svelte.d.ts +1 -1
  118. package/dist/components/nodes/IdeaNode.svelte +79 -98
  119. package/dist/components/nodes/IdeaNode.svelte.d.ts +8 -4
  120. package/dist/components/nodes/NodeConfigButton.svelte +86 -0
  121. package/dist/components/nodes/NodeConfigButton.svelte.d.ts +15 -0
  122. package/dist/components/nodes/NotesNode.svelte +76 -85
  123. package/dist/components/nodes/NotesNode.svelte.d.ts +8 -4
  124. package/dist/components/nodes/SimpleNode.svelte +68 -137
  125. package/dist/components/nodes/SimpleNode.svelte.d.ts +4 -4
  126. package/dist/components/nodes/SquareNode.svelte +122 -169
  127. package/dist/components/nodes/SquareNode.svelte.d.ts +4 -4
  128. package/dist/components/nodes/TerminalNode.svelte +70 -127
  129. package/dist/components/nodes/TerminalNode.svelte.d.ts +4 -4
  130. package/dist/components/nodes/ToolNode.svelte +99 -104
  131. package/dist/components/nodes/ToolNode.svelte.d.ts +6 -6
  132. package/dist/components/nodes/WorkflowNode.svelte +145 -195
  133. package/dist/components/nodes/WorkflowNode.svelte.d.ts +1 -1
  134. package/dist/components/playground/ChatInput.svelte +11 -15
  135. package/dist/components/playground/ChatPanel.svelte +6 -49
  136. package/dist/components/playground/ChatPanel.svelte.d.ts +0 -14
  137. package/dist/components/playground/ControlPanel.svelte +134 -123
  138. package/dist/components/playground/ControlPanel.svelte.d.ts +3 -0
  139. package/dist/components/playground/ExecutionLogs.svelte +11 -9
  140. package/dist/components/playground/InputCollector.svelte +22 -57
  141. package/dist/components/playground/MessageStream.svelte +17 -23
  142. package/dist/components/playground/PipelineKanbanView.svelte +69 -8
  143. package/dist/components/playground/PipelineKanbanView.svelte.d.ts +2 -0
  144. package/dist/components/playground/PipelinePanel.svelte +31 -8
  145. package/dist/components/playground/PipelinePanel.svelte.d.ts +2 -0
  146. package/dist/components/playground/PipelineTableView.svelte +188 -44
  147. package/dist/components/playground/PipelineTableView.svelte.d.ts +2 -0
  148. package/dist/components/playground/Playground.svelte +154 -105
  149. package/dist/components/playground/Playground.svelte.d.ts +5 -0
  150. package/dist/components/playground/PlaygroundApp.svelte +12 -2
  151. package/dist/components/playground/PlaygroundApp.svelte.d.ts +6 -0
  152. package/dist/components/playground/PlaygroundModal.svelte +18 -3
  153. package/dist/components/playground/PlaygroundModal.svelte.d.ts +6 -0
  154. package/dist/components/playground/PlaygroundStudio.svelte +40 -37
  155. package/dist/components/playground/PlaygroundStudio.svelte.d.ts +6 -0
  156. package/dist/components/playground/SessionManager.svelte +9 -12
  157. package/dist/components/playground/pipelineViewUtils.svelte.d.ts +30 -1
  158. package/dist/components/playground/pipelineViewUtils.svelte.js +40 -3
  159. package/dist/components/surfaces/SurfaceOverlay.svelte +153 -0
  160. package/dist/components/surfaces/SurfaceOverlay.svelte.d.ts +14 -0
  161. package/dist/components/surfaces/TabbedSurface.svelte +133 -0
  162. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +27 -0
  163. package/dist/config/endpoints.d.ts +23 -7
  164. package/dist/config/endpoints.js +30 -10
  165. package/dist/core/index.d.ts +6 -7
  166. package/dist/core/index.js +8 -12
  167. package/dist/display/index.d.ts +6 -3
  168. package/dist/display/index.js +7 -5
  169. package/dist/editor/index.d.ts +20 -21
  170. package/dist/editor/index.js +26 -36
  171. package/dist/form/code.d.ts +25 -15
  172. package/dist/form/code.js +44 -41
  173. package/dist/form/fieldRegistry.d.ts +17 -13
  174. package/dist/form/fieldRegistry.js +32 -12
  175. package/dist/form/full.d.ts +19 -14
  176. package/dist/form/full.js +26 -28
  177. package/dist/form/index.d.ts +3 -4
  178. package/dist/form/index.js +6 -5
  179. package/dist/form/markdown.d.ts +13 -8
  180. package/dist/form/markdown.js +22 -23
  181. package/dist/helpers/proximityConnect.d.ts +3 -2
  182. package/dist/helpers/proximityConnect.js +2 -5
  183. package/dist/helpers/workflowEditorHelper.d.ts +14 -5
  184. package/dist/helpers/workflowEditorHelper.js +32 -30
  185. package/dist/index.d.ts +28 -24
  186. package/dist/index.js +27 -50
  187. package/dist/messages/defaults.d.ts +2 -5
  188. package/dist/messages/defaults.js +3 -6
  189. package/dist/messages/index.d.ts +1 -2
  190. package/dist/messages/index.js +1 -2
  191. package/dist/mocks/app-forms.d.ts +6 -2
  192. package/dist/mocks/app-forms.js +11 -4
  193. package/dist/openapi/v1/openapi.yaml +38 -26
  194. package/dist/playground/index.d.ts +4 -5
  195. package/dist/playground/index.js +4 -32
  196. package/dist/playground/mount.d.ts +34 -5
  197. package/dist/playground/mount.js +58 -24
  198. package/dist/registry/{BaseRegistry.d.ts → BaseRegistry.svelte.d.ts} +22 -1
  199. package/dist/registry/{BaseRegistry.js → BaseRegistry.svelte.js} +37 -1
  200. package/dist/registry/builtinFormats.d.ts +9 -18
  201. package/dist/registry/builtinFormats.js +9 -39
  202. package/dist/registry/builtinNodeTypes.d.ts +53 -0
  203. package/dist/registry/builtinNodeTypes.js +67 -0
  204. package/dist/registry/builtinNodes.d.ts +2 -64
  205. package/dist/registry/builtinNodes.js +7 -103
  206. package/dist/registry/index.d.ts +3 -4
  207. package/dist/registry/index.js +4 -6
  208. package/dist/registry/nodeComponentRegistry.d.ts +184 -16
  209. package/dist/registry/nodeComponentRegistry.js +235 -17
  210. package/dist/registry/workflowFormatRegistry.d.ts +14 -9
  211. package/dist/registry/workflowFormatRegistry.js +24 -8
  212. package/dist/{schema → schemas}/index.d.ts +2 -2
  213. package/dist/{schema → schemas}/index.js +2 -2
  214. package/dist/schemas/v1/workflow.schema.json +19 -17
  215. package/dist/services/agentSpecExecutionService.d.ts +0 -2
  216. package/dist/services/agentSpecExecutionService.js +0 -3
  217. package/dist/services/apiVariableService.d.ts +2 -1
  218. package/dist/services/apiVariableService.js +16 -47
  219. package/dist/services/autoSaveService.d.ts +7 -0
  220. package/dist/services/autoSaveService.js +6 -4
  221. package/dist/services/categoriesApi.js +3 -6
  222. package/dist/services/chatService.d.ts +9 -4
  223. package/dist/services/chatService.js +23 -28
  224. package/dist/services/draftStorage.d.ts +129 -13
  225. package/dist/services/draftStorage.js +185 -37
  226. package/dist/services/dynamicSchemaService.d.ts +33 -5
  227. package/dist/services/dynamicSchemaService.js +67 -55
  228. package/dist/services/globalSave.d.ts +13 -12
  229. package/dist/services/globalSave.js +29 -51
  230. package/dist/services/historyService.d.ts +39 -11
  231. package/dist/services/historyService.js +60 -18
  232. package/dist/services/interruptService.d.ts +15 -9
  233. package/dist/services/interruptService.js +35 -37
  234. package/dist/services/nodeExecutionService.d.ts +18 -3
  235. package/dist/services/nodeExecutionService.js +71 -45
  236. package/dist/services/playgroundService.d.ts +16 -10
  237. package/dist/services/playgroundService.js +42 -43
  238. package/dist/services/portConfigApi.js +3 -6
  239. package/dist/services/settingsService.d.ts +9 -4
  240. package/dist/services/settingsService.js +23 -12
  241. package/dist/services/variableService.d.ts +2 -1
  242. package/dist/services/variableService.js +2 -2
  243. package/dist/services/workflowStorage.js +6 -6
  244. package/dist/skins/drafter.d.ts +30 -0
  245. package/dist/skins/drafter.js +198 -0
  246. package/dist/skins/index.d.ts +2 -1
  247. package/dist/skins/index.js +4 -2
  248. package/dist/stores/apiContext.d.ts +56 -0
  249. package/dist/stores/apiContext.js +80 -0
  250. package/dist/stores/categoriesStore.svelte.d.ts +28 -23
  251. package/dist/stores/categoriesStore.svelte.js +69 -64
  252. package/dist/stores/getInstance.svelte.d.ts +39 -0
  253. package/dist/stores/getInstance.svelte.js +65 -0
  254. package/dist/stores/historyStore.svelte.d.ts +89 -91
  255. package/dist/stores/historyStore.svelte.js +159 -158
  256. package/dist/stores/instanceContainer.svelte.d.ts +111 -0
  257. package/dist/stores/instanceContainer.svelte.js +119 -0
  258. package/dist/stores/interruptStore.svelte.d.ts +112 -82
  259. package/dist/stores/interruptStore.svelte.js +253 -226
  260. package/dist/stores/pipelinePanelStore.svelte.d.ts +27 -3
  261. package/dist/stores/pipelinePanelStore.svelte.js +61 -14
  262. package/dist/stores/playgroundStore.svelte.d.ts +169 -222
  263. package/dist/stores/playgroundStore.svelte.js +513 -580
  264. package/dist/stores/portCoordinateStore.svelte.d.ts +57 -51
  265. package/dist/stores/portCoordinateStore.svelte.js +109 -98
  266. package/dist/stores/settingsStore.svelte.d.ts +17 -1
  267. package/dist/stores/settingsStore.svelte.js +79 -12
  268. package/dist/stores/workflowStore.svelte.d.ts +212 -210
  269. package/dist/stores/workflowStore.svelte.js +527 -502
  270. package/dist/stories/EdgeDecorator.svelte +5 -2
  271. package/dist/stories/NodeDecorator.svelte +5 -3
  272. package/dist/styles/base.css +285 -14
  273. package/dist/styles/tokens.css +60 -2
  274. package/dist/svelte-app.d.ts +78 -11
  275. package/dist/svelte-app.js +210 -141
  276. package/dist/themes/drafter.d.ts +2 -0
  277. package/dist/themes/drafter.js +15 -0
  278. package/dist/themes/index.d.ts +2 -1
  279. package/dist/themes/index.js +8 -2
  280. package/dist/types/auth.d.ts +9 -51
  281. package/dist/types/auth.js +4 -54
  282. package/dist/types/events.d.ts +24 -3
  283. package/dist/types/events.js +2 -1
  284. package/dist/types/index.d.ts +117 -32
  285. package/dist/types/index.js +0 -1
  286. package/dist/types/navbar.d.ts +7 -0
  287. package/dist/types/playground.d.ts +18 -3
  288. package/dist/types/settings.d.ts +30 -1
  289. package/dist/types/settings.js +5 -2
  290. package/dist/types/skin.d.ts +1 -1
  291. package/dist/types/theme.d.ts +16 -2
  292. package/dist/types/uischema.d.ts +5 -0
  293. package/dist/utils/colors.d.ts +74 -21
  294. package/dist/utils/colors.js +92 -68
  295. package/dist/utils/connections.d.ts +9 -15
  296. package/dist/utils/connections.js +33 -88
  297. package/dist/utils/duration.d.ts +13 -0
  298. package/dist/utils/duration.js +45 -0
  299. package/dist/utils/edgeStyling.js +9 -5
  300. package/dist/utils/fetchWithAuth.d.ts +36 -15
  301. package/dist/utils/fetchWithAuth.js +53 -23
  302. package/dist/utils/icons.d.ts +5 -2
  303. package/dist/utils/icons.js +6 -5
  304. package/dist/utils/nodeIds.d.ts +1 -1
  305. package/dist/utils/nodeIds.js +1 -1
  306. package/dist/utils/nodeSwap.d.ts +6 -2
  307. package/dist/utils/nodeSwap.js +62 -129
  308. package/dist/utils/nodeTypes.d.ts +17 -8
  309. package/dist/utils/nodeTypes.js +27 -20
  310. package/dist/utils/performanceUtils.js +7 -0
  311. package/dist/utils/portUtils.d.ts +47 -11
  312. package/dist/utils/portUtils.js +67 -14
  313. package/dist/utils/portal.d.ts +18 -0
  314. package/dist/utils/portal.js +34 -0
  315. package/dist/utils/schemaMerge.d.ts +25 -0
  316. package/dist/utils/schemaMerge.js +61 -0
  317. package/package.json +7 -5
  318. package/dist/messages/deprecation.d.ts +0 -20
  319. package/dist/messages/deprecation.js +0 -33
  320. package/dist/registry/plugin.d.ts +0 -215
  321. package/dist/registry/plugin.js +0 -249
  322. package/dist/services/api.d.ts +0 -129
  323. package/dist/services/api.js +0 -217
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * @module utils/nodeSwap
8
8
  */
9
- import { buildHandleId, extractPortId, extractDirection } from './handleIds.js';
9
+ import { buildHandleId, extractPortId } from './handleIds.js';
10
10
  import { generateNodeId } from './nodeIds.js';
11
11
  /** Error class for swap validation failures. */
12
12
  export class SwapValidationError extends Error {
@@ -86,16 +86,17 @@ export function mapConfig(oldConfig, newConfigSchema, newDefaults = {}) {
86
86
  }
87
87
  return { config, carriedOver, reset };
88
88
  }
89
- // =========================================================================
90
- // Port matching
91
- // =========================================================================
92
89
  /**
93
90
  * Find the best matching port on the new node for a given old port.
94
91
  *
95
- * Three-pass strategy:
92
+ * Two-pass strategy — exact matches only:
96
93
  * 1. Exact port ID match with compatible dataType
97
- * 2. Port name match (case-insensitive) with compatible dataType
98
- * 3. First available port with compatible dataType
94
+ * 2. Exact port name match (case-insensitive) with compatible dataType
95
+ *
96
+ * There is deliberately no fuzzy "first compatible dataType" fallback:
97
+ * it silently rewired edges to the wrong port (e.g. a `text` edge landing
98
+ * on `assistant_message`). If neither ID nor name matches, the edge is
99
+ * dropped and reported instead.
99
100
  */
100
101
  function findMatchingPort(oldPort, newPorts, usedPortIds, checker) {
101
102
  const available = newPorts.filter((p) => p.type === oldPort.type && !usedPortIds.has(p.id));
@@ -116,11 +117,7 @@ function findMatchingPort(oldPort, newPorts, usedPortIds, checker) {
116
117
  // Pass 2: name match (case-insensitive)
117
118
  const oldNameLower = oldPort.name.toLowerCase();
118
119
  const nameMatch = available.find((p) => p.name.toLowerCase() === oldNameLower && isCompatible(oldPort, p));
119
- if (nameMatch)
120
- return nameMatch;
121
- // Pass 3: first compatible dataType
122
- const typeMatch = available.find((p) => isCompatible(oldPort, p));
123
- return typeMatch ?? null;
120
+ return nameMatch ?? null;
124
121
  }
125
122
  /**
126
123
  * Resolve the port metadata for an edge endpoint on a given node.
@@ -142,65 +139,13 @@ function resolvePort(node, handleId, direction) {
142
139
  *
143
140
  * This does NOT mutate anything — it returns a preview that can be displayed
144
141
  * to the user for confirmation before executing the swap.
142
+ *
143
+ * Thin wrapper over {@link computeSwapPreviewWithOptions} — with no strategies
144
+ * or overrides the cascade reduces to the built-in exact matching, so both
145
+ * entry points share one implementation.
145
146
  */
146
147
  export function computeSwapPreview(oldNode, newMetadata, edges, allNodes, checker = null) {
147
- const oldNodeId = oldNode.id;
148
- const newNodeId = generateNodeId(newMetadata.id, allNodes);
149
- // Collect all edges connected to the old node
150
- const connectedEdges = edges.filter((e) => e.source === oldNodeId || e.target === oldNodeId);
151
- // Track which ports on the new node have been claimed
152
- const usedInputPortIds = new Set();
153
- const usedOutputPortIds = new Set();
154
- const keptEdges = [];
155
- const droppedEdges = [];
156
- for (const edge of connectedEdges) {
157
- const isSource = edge.source === oldNodeId;
158
- const direction = isSource ? 'output' : 'input';
159
- const handleId = isSource ? edge.sourceHandle : edge.targetHandle;
160
- const usedPorts = isSource ? usedOutputPortIds : usedInputPortIds;
161
- // Resolve the old port
162
- const oldPort = resolvePort(oldNode, handleId, direction);
163
- if (!oldPort) {
164
- droppedEdges.push({
165
- edge,
166
- reason: `Port not found on original node`
167
- });
168
- continue;
169
- }
170
- // Find matching port on new node
171
- const newPorts = direction === 'input' ? newMetadata.inputs : newMetadata.outputs;
172
- const match = findMatchingPort(oldPort, newPorts, usedPorts, checker);
173
- if (!match) {
174
- droppedEdges.push({
175
- edge,
176
- reason: `No compatible ${direction} port found on "${newMetadata.name}"`
177
- });
178
- continue;
179
- }
180
- usedPorts.add(match.id);
181
- // Build the rewritten edge
182
- const newHandleId = buildHandleId(newNodeId, direction, match.id);
183
- const newEdge = { ...edge };
184
- if (isSource) {
185
- newEdge.source = newNodeId;
186
- newEdge.sourceHandle = newHandleId;
187
- }
188
- else {
189
- newEdge.target = newNodeId;
190
- newEdge.targetHandle = newHandleId;
191
- }
192
- keptEdges.push({ edge, newEdge });
193
- }
194
- // Config mapping preview
195
- const { carriedOver, reset } = mapConfig(oldNode.data.config, newMetadata.configSchema, newMetadata.config);
196
- return {
197
- keptEdges,
198
- droppedEdges,
199
- hasDataLoss: droppedEdges.length > 0,
200
- newNodeId,
201
- configCarriedOver: carriedOver,
202
- configReset: reset
203
- };
148
+ return computeSwapPreviewWithOptions(oldNode, newMetadata, edges, allNodes, { checker });
204
149
  }
205
150
  // =========================================================================
206
151
  // Swap execution
@@ -270,7 +215,7 @@ export function executeSwap(oldNode, newMetadata, preview, allNodes, allEdges) {
270
215
  * @returns The newer NodeMetadata if an upgrade is available, null otherwise
271
216
  */
272
217
  export function getVersionUpgrade(currentMetadata, allNodeTypes) {
273
- const available = allNodeTypes.find((n) => n.id === currentMetadata.id);
218
+ const available = allNodeTypes.find((n) => n.node_type_id === currentMetadata.node_type_id);
274
219
  if (!available)
275
220
  return null;
276
221
  if (compareSemver(available.version, currentMetadata.version) > 0) {
@@ -298,14 +243,14 @@ function classifyMatch(oldPort, matchedPort) {
298
243
  *
299
244
  * Resolution order:
300
245
  * 1. Check strategies — first canHandle() match wins for mapPorts()/mapConfig()
301
- * 2. Fall through to built-in 3-pass for ports not covered by strategy
246
+ * 2. Fall through to built-in exact matching (ID, then name) for ports not covered by strategy
302
247
  * 3. Apply portOverrides on top (highest priority — user's manual overrides)
303
248
  * 4. Same cascade for config
304
249
  */
305
250
  export function computeSwapPreviewWithOptions(oldNode, newMetadata, edges, allNodes, options) {
306
251
  const checker = options.checker ?? null;
307
252
  const oldNodeId = oldNode.id;
308
- const newNodeId = generateNodeId(newMetadata.id, allNodes);
253
+ const newNodeId = generateNodeId(newMetadata.node_type_id, allNodes);
309
254
  // Collect connected edges
310
255
  const connectedEdges = edges.filter((e) => e.source === oldNodeId || e.target === oldNodeId);
311
256
  // Try strategy-based port mapping
@@ -332,84 +277,73 @@ export function computeSwapPreviewWithOptions(oldNode, newMetadata, edges, allNo
332
277
  for (const override of options.portOverrides ?? []) {
333
278
  portOverrideLookup.set(`${override.direction}:${override.oldPortId}`, override.newPortId);
334
279
  }
335
- // Track used ports
280
+ // Track ports on the new node claimed by a DIFFERENT old port
336
281
  const usedInputPortIds = new Set();
337
282
  const usedOutputPortIds = new Set();
338
- const keptEdges = [];
339
- const droppedEdges = [];
340
- for (const edge of connectedEdges) {
341
- const isSource = edge.source === oldNodeId;
342
- const direction = isSource ? 'output' : 'input';
343
- const handleId = isSource ? edge.sourceHandle : edge.targetHandle;
344
- const usedPorts = isSource ? usedOutputPortIds : usedInputPortIds;
345
- const oldPort = resolvePort(oldNode, handleId, direction);
346
- if (!oldPort) {
347
- droppedEdges.push({ edge, reason: 'Port not found on original node' });
348
- continue;
349
- }
283
+ // Memoized old-port → new-port resolutions so every edge anchored on the
284
+ // same old port maps to the same new port (multi-connection ports, fan-outs).
285
+ const portResolutions = new Map();
286
+ /** Resolve a new port for an old port through the priority cascade. */
287
+ const resolveNewPort = (oldPort, direction, usedPorts) => {
288
+ const newPorts = direction === 'input' ? newMetadata.inputs : newMetadata.outputs;
350
289
  // Priority 1: Manual port override
351
290
  const overrideKey = `${direction}:${oldPort.id}`;
352
291
  if (portOverrideLookup.has(overrideKey)) {
353
292
  const overrideNewPortId = portOverrideLookup.get(overrideKey);
354
293
  if (overrideNewPortId === null) {
355
- droppedEdges.push({ edge, reason: 'Manually dropped' });
356
- continue;
294
+ return { port: null, reason: 'Manually dropped' };
357
295
  }
358
- const newPorts = direction === 'input' ? newMetadata.inputs : newMetadata.outputs;
359
296
  const overridePort = newPorts.find((p) => p.id === overrideNewPortId);
360
297
  if (overridePort) {
361
- usedPorts.add(overridePort.id);
362
- const newHandleId = buildHandleId(newNodeId, direction, overridePort.id);
363
- const newEdge = { ...edge };
364
- if (isSource) {
365
- newEdge.source = newNodeId;
366
- newEdge.sourceHandle = newHandleId;
367
- }
368
- else {
369
- newEdge.target = newNodeId;
370
- newEdge.targetHandle = newHandleId;
371
- }
372
- keptEdges.push({ edge, newEdge });
373
- continue;
298
+ return { port: overridePort };
374
299
  }
375
300
  }
376
301
  // Priority 2: Strategy port mapping
377
302
  if (strategyPortMap && oldPort.id in strategyPortMap) {
378
303
  const strategyNewPortId = strategyPortMap[oldPort.id];
379
304
  if (strategyNewPortId === null) {
380
- droppedEdges.push({ edge, reason: 'Dropped by strategy' });
381
- continue;
305
+ return { port: null, reason: 'Dropped by strategy' };
382
306
  }
383
- const newPorts = direction === 'input' ? newMetadata.inputs : newMetadata.outputs;
384
307
  const strategyPort = newPorts.find((p) => p.id === strategyNewPortId);
385
308
  if (strategyPort && !usedPorts.has(strategyPort.id)) {
386
- usedPorts.add(strategyPort.id);
387
- const newHandleId = buildHandleId(newNodeId, direction, strategyPort.id);
388
- const newEdge = { ...edge };
389
- if (isSource) {
390
- newEdge.source = newNodeId;
391
- newEdge.sourceHandle = newHandleId;
392
- }
393
- else {
394
- newEdge.target = newNodeId;
395
- newEdge.targetHandle = newHandleId;
396
- }
397
- keptEdges.push({ edge, newEdge });
398
- continue;
309
+ return { port: strategyPort };
399
310
  }
400
311
  }
401
- // Priority 3: Built-in 3-pass matching
402
- const newPorts = direction === 'input' ? newMetadata.inputs : newMetadata.outputs;
312
+ // Priority 3: Built-in exact matching (ID, then name)
403
313
  const match = findMatchingPort(oldPort, newPorts, usedPorts, checker);
404
314
  if (!match) {
405
- droppedEdges.push({
406
- edge,
407
- reason: `No compatible ${direction} port found on "${newMetadata.name}"`
408
- });
315
+ return {
316
+ port: null,
317
+ reason: `No matching ${direction} port for "${oldPort.id}" on "${newMetadata.name}"`
318
+ };
319
+ }
320
+ return { port: match };
321
+ };
322
+ const keptEdges = [];
323
+ const droppedEdges = [];
324
+ for (const edge of connectedEdges) {
325
+ const isSource = edge.source === oldNodeId;
326
+ const direction = isSource ? 'output' : 'input';
327
+ const handleId = isSource ? edge.sourceHandle : edge.targetHandle;
328
+ const usedPorts = isSource ? usedOutputPortIds : usedInputPortIds;
329
+ const oldPort = resolvePort(oldNode, handleId, direction);
330
+ if (!oldPort) {
331
+ droppedEdges.push({ edge, reason: 'Port not found on original node' });
409
332
  continue;
410
333
  }
411
- usedPorts.add(match.id);
412
- const newHandleId = buildHandleId(newNodeId, direction, match.id);
334
+ const matchKey = `${direction}:${oldPort.id}`;
335
+ let resolved = portResolutions.get(matchKey);
336
+ if (!resolved) {
337
+ resolved = resolveNewPort(oldPort, direction, usedPorts);
338
+ portResolutions.set(matchKey, resolved);
339
+ if (resolved.port)
340
+ usedPorts.add(resolved.port.id);
341
+ }
342
+ if (!resolved.port) {
343
+ droppedEdges.push({ edge, reason: resolved.reason });
344
+ continue;
345
+ }
346
+ const newHandleId = buildHandleId(newNodeId, direction, resolved.port.id);
413
347
  const newEdge = { ...edge };
414
348
  if (isSource) {
415
349
  newEdge.source = newNodeId;
@@ -422,7 +356,7 @@ export function computeSwapPreviewWithOptions(oldNode, newMetadata, edges, allNo
422
356
  keptEdges.push({ edge, newEdge });
423
357
  }
424
358
  // Config mapping — apply strategy then overrides
425
- const { config: baseConfig, carriedOver, reset } = mapConfig(oldNode.data.config, newMetadata.configSchema, newMetadata.config);
359
+ const { carriedOver, reset } = mapConfig(oldNode.data.config, newMetadata.configSchema, newMetadata.config);
426
360
  // Apply strategy config overrides
427
361
  if (strategyConfigMap) {
428
362
  for (const [key, mapping] of Object.entries(strategyConfigMap)) {
@@ -482,9 +416,8 @@ export function computeSwapPreviewWithOptions(oldNode, newMetadata, edges, allNo
482
416
  * with match quality annotations and isFlat flags.
483
417
  */
484
418
  export function computeInteractiveState(oldNode, newMetadata, edges, allNodes, options = {}) {
485
- const checker = options.checker ?? null;
486
419
  const oldNodeId = oldNode.id;
487
- const newNodeId = generateNodeId(newMetadata.id, allNodes);
420
+ const newNodeId = generateNodeId(newMetadata.node_type_id, allNodes);
488
421
  const connectedEdges = edges.filter((e) => e.source === oldNodeId || e.target === oldNodeId);
489
422
  // Compute the base preview to get auto-matched ports
490
423
  const preview = computeSwapPreviewWithOptions(oldNode, newMetadata, edges, allNodes, options);
@@ -567,7 +500,7 @@ function isPrimitive(value) {
567
500
  * Convert user-edited InteractiveSwapState back into a SwapPreview
568
501
  * for executeSwap(). Pure function, no side effects.
569
502
  */
570
- export function buildSwapPreviewFromState(state, allEdges) {
503
+ export function buildSwapPreviewFromState(state, _allEdges) {
571
504
  const keptEdges = [];
572
505
  const droppedEdges = [];
573
506
  for (const mapping of state.portMappings) {
@@ -10,14 +10,16 @@
10
10
  * Works with both built-in types and custom registered types.
11
11
  */
12
12
  import type { NodeType, NodeMetadata } from '../types/index.js';
13
+ import type { NodeComponentRegistry } from '../registry/nodeComponentRegistry.js';
13
14
  /**
14
15
  * Gets the SvelteFlow component name for a given NodeType.
15
16
  * Uses the node component registry to resolve types.
16
17
  *
18
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
17
19
  * @param nodeType - The node type identifier
18
20
  * @returns The component name to use
19
21
  */
20
- export declare function getComponentNameForNodeType(nodeType: NodeType | string): string;
22
+ export declare function getComponentNameForNodeType(registry: NodeComponentRegistry, nodeType: NodeType | string): string;
21
23
  /**
22
24
  * Gets the available node types for a given NodeMetadata.
23
25
  * Priority: supportedTypes > type > "default"
@@ -43,28 +45,31 @@ export declare function getPrimaryNodeType(metadata: NodeMetadata): NodeType | s
43
45
  * 3. First supportedType
44
46
  * 4. "default"
45
47
  *
48
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
46
49
  * @param metadata - The node metadata
47
50
  * @param configNodeType - Optional type from user config
48
51
  * @returns The resolved node type
49
52
  */
50
- export declare function resolveNodeType(metadata: NodeMetadata, configNodeType?: string): NodeType | string;
53
+ export declare function resolveNodeType(registry: NodeComponentRegistry, metadata: NodeMetadata, configNodeType?: string): NodeType | string;
51
54
  /**
52
55
  * Gets the SvelteFlow component name for resolved node type.
53
56
  * This is the main function used by UniversalNode to determine which component to render.
54
57
  *
58
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
55
59
  * @param metadata - The node metadata
56
60
  * @param configNodeType - Optional type from user config
57
61
  * @returns The component name to use
58
62
  */
59
- export declare function resolveComponentName(metadata: NodeMetadata, configNodeType?: string): string;
63
+ export declare function resolveComponentName(registry: NodeComponentRegistry, metadata: NodeMetadata, configNodeType?: string): string;
60
64
  /**
61
65
  * Validates if a node type is supported by the given metadata.
62
66
  *
67
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
63
68
  * @param metadata - The node metadata
64
69
  * @param nodeType - The type to check
65
70
  * @returns true if the type is supported
66
71
  */
67
- export declare function isNodeTypeSupported(metadata: NodeMetadata, nodeType: NodeType | string): boolean;
72
+ export declare function isNodeTypeSupported(registry: NodeComponentRegistry, metadata: NodeMetadata, nodeType: NodeType | string): boolean;
68
73
  /**
69
74
  * Gets oneOf options for node type configuration.
70
75
  * Used in config schemas to show available options with labels.
@@ -73,11 +78,12 @@ export declare function isNodeTypeSupported(metadata: NodeMetadata, nodeType: No
73
78
  * - Types specified in metadata.supportedTypes
74
79
  * - Registered custom types (optionally filtered)
75
80
  *
81
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
76
82
  * @param metadata - The node metadata
77
83
  * @param includeCustomTypes - Whether to include registered custom types
78
84
  * @returns Array of oneOf items with const (type value) and title (display name)
79
85
  */
80
- export declare function getNodeTypeOneOfOptions(metadata: NodeMetadata, includeCustomTypes?: boolean): Array<{
86
+ export declare function getNodeTypeOneOfOptions(registry: NodeComponentRegistry, metadata: NodeMetadata, includeCustomTypes?: boolean): Array<{
81
87
  const: string;
82
88
  title: string;
83
89
  }>;
@@ -88,11 +94,12 @@ export declare function getNodeTypeOneOfOptions(metadata: NodeMetadata, includeC
88
94
  * Uses JSON Schema `oneOf` pattern with `const`/`title` for labeled options,
89
95
  * which is the standard approach supported by form components.
90
96
  *
97
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
91
98
  * @param metadata - The node metadata
92
99
  * @param defaultType - Optional default type override
93
100
  * @returns Config schema property object with oneOf for labeled options
94
101
  */
95
- export declare function createNodeTypeConfigProperty(metadata: NodeMetadata, defaultType?: NodeType | string): {
102
+ export declare function createNodeTypeConfigProperty(registry: NodeComponentRegistry, metadata: NodeMetadata, defaultType?: NodeType | string): {
96
103
  type: "string";
97
104
  title: string;
98
105
  description: string;
@@ -105,13 +112,15 @@ export declare function createNodeTypeConfigProperty(metadata: NodeMetadata, def
105
112
  /**
106
113
  * Check if a type string represents a valid registered or built-in type.
107
114
  *
115
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
108
116
  * @param type - The type to check
109
117
  * @returns true if the type is valid
110
118
  */
111
- export declare function isValidNodeType(type: string): boolean;
119
+ export declare function isValidNodeType(registry: NodeComponentRegistry, type: string): boolean;
112
120
  /**
113
121
  * Get all available node types (built-in + registered).
114
122
  *
123
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
115
124
  * @returns Array of all valid node type identifiers
116
125
  */
117
- export declare function getAllNodeTypes(): string[];
126
+ export declare function getAllNodeTypes(registry: NodeComponentRegistry): string[];
@@ -9,8 +9,7 @@
9
9
  *
10
10
  * Works with both built-in types and custom registered types.
11
11
  */
12
- import { nodeComponentRegistry } from '../registry/nodeComponentRegistry.js';
13
- import { resolveBuiltinAlias, isBuiltinType } from '../registry/builtinNodes.js';
12
+ import { resolveBuiltinAlias, isBuiltinType } from '../registry/builtinNodeTypes.js';
14
13
  /**
15
14
  * Display names for built-in node types.
16
15
  */
@@ -28,14 +27,15 @@ const TYPE_DISPLAY_NAMES = {
28
27
  * Gets the SvelteFlow component name for a given NodeType.
29
28
  * Uses the node component registry to resolve types.
30
29
  *
30
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
31
31
  * @param nodeType - The node type identifier
32
32
  * @returns The component name to use
33
33
  */
34
- export function getComponentNameForNodeType(nodeType) {
34
+ export function getComponentNameForNodeType(registry, nodeType) {
35
35
  // Resolve aliases first (e.g., "default" -> "workflowNode")
36
36
  const resolvedType = resolveBuiltinAlias(nodeType);
37
37
  // Check if it's registered in the registry
38
- if (nodeComponentRegistry.has(resolvedType)) {
38
+ if (registry.has(resolvedType)) {
39
39
  return resolvedType;
40
40
  }
41
41
  // Unknown type - return workflowNode as default
@@ -77,11 +77,12 @@ export function getPrimaryNodeType(metadata) {
77
77
  * 3. First supportedType
78
78
  * 4. "default"
79
79
  *
80
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
80
81
  * @param metadata - The node metadata
81
82
  * @param configNodeType - Optional type from user config
82
83
  * @returns The resolved node type
83
84
  */
84
- export function resolveNodeType(metadata, configNodeType) {
85
+ export function resolveNodeType(registry, metadata, configNodeType) {
85
86
  const availableTypes = getAvailableNodeTypes(metadata);
86
87
  // Check if configNodeType is valid for this metadata
87
88
  if (configNodeType) {
@@ -93,7 +94,7 @@ export function resolveNodeType(metadata, configNodeType) {
93
94
  return configNodeType;
94
95
  }
95
96
  // Check if it's a registered custom type
96
- if (nodeComponentRegistry.has(configNodeType) || nodeComponentRegistry.has(resolvedConfig)) {
97
+ if (registry.has(configNodeType) || registry.has(resolvedConfig)) {
97
98
  return configNodeType;
98
99
  }
99
100
  }
@@ -104,22 +105,24 @@ export function resolveNodeType(metadata, configNodeType) {
104
105
  * Gets the SvelteFlow component name for resolved node type.
105
106
  * This is the main function used by UniversalNode to determine which component to render.
106
107
  *
108
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
107
109
  * @param metadata - The node metadata
108
110
  * @param configNodeType - Optional type from user config
109
111
  * @returns The component name to use
110
112
  */
111
- export function resolveComponentName(metadata, configNodeType) {
112
- const nodeType = resolveNodeType(metadata, configNodeType);
113
- return getComponentNameForNodeType(nodeType);
113
+ export function resolveComponentName(registry, metadata, configNodeType) {
114
+ const nodeType = resolveNodeType(registry, metadata, configNodeType);
115
+ return getComponentNameForNodeType(registry, nodeType);
114
116
  }
115
117
  /**
116
118
  * Validates if a node type is supported by the given metadata.
117
119
  *
120
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
118
121
  * @param metadata - The node metadata
119
122
  * @param nodeType - The type to check
120
123
  * @returns true if the type is supported
121
124
  */
122
- export function isNodeTypeSupported(metadata, nodeType) {
125
+ export function isNodeTypeSupported(registry, metadata, nodeType) {
123
126
  const availableTypes = getAvailableNodeTypes(metadata);
124
127
  // Check direct match
125
128
  if (availableTypes.includes(nodeType)) {
@@ -131,7 +134,7 @@ export function isNodeTypeSupported(metadata, nodeType) {
131
134
  return true;
132
135
  }
133
136
  // Check if it's a registered custom type that's in the available list
134
- if (nodeComponentRegistry.has(nodeType)) {
137
+ if (registry.has(nodeType)) {
135
138
  return availableTypes.some((t) => t === nodeType || resolveBuiltinAlias(t) === nodeType);
136
139
  }
137
140
  return false;
@@ -144,18 +147,19 @@ export function isNodeTypeSupported(metadata, nodeType) {
144
147
  * - Types specified in metadata.supportedTypes
145
148
  * - Registered custom types (optionally filtered)
146
149
  *
150
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
147
151
  * @param metadata - The node metadata
148
152
  * @param includeCustomTypes - Whether to include registered custom types
149
153
  * @returns Array of oneOf items with const (type value) and title (display name)
150
154
  */
151
- export function getNodeTypeOneOfOptions(metadata, includeCustomTypes = false) {
155
+ export function getNodeTypeOneOfOptions(registry, metadata, includeCustomTypes = false) {
152
156
  const availableTypes = getAvailableNodeTypes(metadata);
153
157
  const options = [];
154
158
  const includedTypes = new Set();
155
159
  for (const type of availableTypes) {
156
160
  includedTypes.add(type);
157
161
  // Get display name from registry or fallback to built-in names
158
- const registration = nodeComponentRegistry.get(type);
162
+ const registration = registry.get(type);
159
163
  let title;
160
164
  if (registration) {
161
165
  title = registration.displayName;
@@ -171,7 +175,7 @@ export function getNodeTypeOneOfOptions(metadata, includeCustomTypes = false) {
171
175
  }
172
176
  // Optionally include all registered custom types
173
177
  if (includeCustomTypes) {
174
- const registrations = nodeComponentRegistry.filter({
178
+ const registrations = registry.filter({
175
179
  predicate: (reg) => !isBuiltinType(reg.type) && !includedTypes.has(reg.type)
176
180
  });
177
181
  for (const reg of registrations) {
@@ -187,12 +191,13 @@ export function getNodeTypeOneOfOptions(metadata, includeCustomTypes = false) {
187
191
  * Uses JSON Schema `oneOf` pattern with `const`/`title` for labeled options,
188
192
  * which is the standard approach supported by form components.
189
193
  *
194
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
190
195
  * @param metadata - The node metadata
191
196
  * @param defaultType - Optional default type override
192
197
  * @returns Config schema property object with oneOf for labeled options
193
198
  */
194
- export function createNodeTypeConfigProperty(metadata, defaultType) {
195
- const oneOf = getNodeTypeOneOfOptions(metadata);
199
+ export function createNodeTypeConfigProperty(registry, metadata, defaultType) {
200
+ const oneOf = getNodeTypeOneOfOptions(registry, metadata);
196
201
  const primaryType = defaultType ?? getPrimaryNodeType(metadata);
197
202
  return {
198
203
  type: 'string',
@@ -205,19 +210,21 @@ export function createNodeTypeConfigProperty(metadata, defaultType) {
205
210
  /**
206
211
  * Check if a type string represents a valid registered or built-in type.
207
212
  *
213
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
208
214
  * @param type - The type to check
209
215
  * @returns true if the type is valid
210
216
  */
211
- export function isValidNodeType(type) {
212
- return isBuiltinType(type) || nodeComponentRegistry.has(type);
217
+ export function isValidNodeType(registry, type) {
218
+ return isBuiltinType(type) || registry.has(type);
213
219
  }
214
220
  /**
215
221
  * Get all available node types (built-in + registered).
216
222
  *
223
+ * @param registry - The instance's node component registry (e.g. `fd.nodes`)
217
224
  * @returns Array of all valid node type identifiers
218
225
  */
219
- export function getAllNodeTypes() {
220
- return nodeComponentRegistry.getTypes();
226
+ export function getAllNodeTypes(registry) {
227
+ return registry.getTypes();
221
228
  }
222
229
  /**
223
230
  * Format a type name for display when no display name is registered.
@@ -51,6 +51,9 @@ export function areEdgeArraysEqual(edges1, edges2) {
51
51
  * Throttle function execution to reduce frequency
52
52
  * Uses requestAnimationFrame for smooth UI updates
53
53
  */
54
+ // `any[]` in a generic constraint is the variance-correct idiom (it's how the TS
55
+ // stdlib types Parameters<T>); `unknown[]` would reject every concrete callback.
56
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
54
57
  export function throttle(func, wait) {
55
58
  let timeout = null;
56
59
  let lastRan = 0;
@@ -75,6 +78,8 @@ export function throttle(func, wait) {
75
78
  * Debounce function execution to reduce frequency
76
79
  * Waits for a pause in calls before executing
77
80
  */
81
+ // `any[]` constraint: see throttle() above.
82
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
78
83
  export function debounce(func, wait) {
79
84
  let timeout = null;
80
85
  return function (...args) {
@@ -90,6 +95,8 @@ export function debounce(func, wait) {
90
95
  * RequestAnimationFrame-based throttle for smooth animations
91
96
  * Better for visual updates like node dragging
92
97
  */
98
+ // `any[]` constraint: see throttle() above.
99
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
93
100
  export function rafThrottle(func) {
94
101
  let rafId = null;
95
102
  let lastArgs = null;
@@ -1,9 +1,46 @@
1
- import type { NodePort } from '../types/index.js';
1
+ import type { NodePort, PortConfigEntry, PortsConfig } from '../types/index.js';
2
+ /**
3
+ * Default sort weight applied to reserved ports (the `error` output and the
4
+ * `trigger`/`tool` control-flow ports) that don't set an explicit
5
+ * `displayOrder`. High enough to sink them below author-declared ports, which
6
+ * default to `0`. The single home for the "high weight" the docs refer to — an
7
+ * explicit `displayOrder` on the port still overrides it.
8
+ */
9
+ export declare const RESERVED_PORT_DISPLAY_ORDER = 100;
10
+ /**
11
+ * Whether a port is a reserved one that should default to the bottom of its
12
+ * direction: the reserved `error` output, or a `trigger`/`tool` control-flow
13
+ * port (identified by data type, mirroring the port config's control types).
14
+ */
15
+ export declare function isReservedPort(port: {
16
+ id: string;
17
+ type?: string;
18
+ dataType?: string;
19
+ }): boolean;
2
20
  /**
3
21
  * Sort ports by an ordered array of port IDs.
4
22
  * Ports not listed appear at the end in their original order.
5
23
  */
6
24
  export declare function applyPortOrder(ports: NodePort[], orderedIds: string[] | undefined): NodePort[];
25
+ /**
26
+ * Sort ports by their effective `displayOrder` weight (ascending), breaking ties
27
+ * on declaration order (stable). This is the default order before any
28
+ * instance-level reordering — reserved ports (trigger/tool/error) carry a high
29
+ * default weight so they land at the bottom without authors hand-setting it.
30
+ */
31
+ export declare function byDefaultOrder(ports: NodePort[]): NodePort[];
32
+ /**
33
+ * Effective render order for a direction: the metadata default order, then the
34
+ * instance's `ports` config override (listed ports first in their stored order,
35
+ * the rest following in default order).
36
+ */
37
+ export declare function orderPortsFor(ports: NodePort[], entries: PortConfigEntry[] | undefined): NodePort[];
38
+ /**
39
+ * Effective exposure for a port: the instance's explicit `exposed` override if
40
+ * present, else the port's metadata `exposedByDefault` (which itself defaults to
41
+ * exposed).
42
+ */
43
+ export declare function isPortExposed(port: NodePort, entries: PortConfigEntry[] | undefined): boolean;
7
44
  /**
8
45
  * Compute the CSS `top` offset (px) for a port handle.
9
46
  * - 1 port: centered at 40px
@@ -11,14 +48,13 @@ export declare function applyPortOrder(ports: NodePort[], orderedIds: string[] |
11
48
  */
12
49
  export declare function getPortTop(index: number, count: number): number;
13
50
  /**
14
- * Determine whether a port should be rendered.
51
+ * Whether a port is exposed, and so rendered on the canvas.
52
+ *
53
+ * In v2 exposure is semantic, not cosmetic: a not-exposed port is hidden, not
54
+ * wireable, and not runtime-overridable. Effective exposure is the instance's
55
+ * explicit `data.config.ports` override for the port, falling back to the port's
56
+ * metadata `exposedByDefault` (which itself defaults to exposed).
15
57
  *
16
- * Priority:
17
- * 1. Manual hide (`hiddenPorts`) — always wins, regardless of connections
18
- * 2. `hideUnconnectedHandles` — hide if not present in the connected handles set
19
- * 3. Default — visible
20
- */
21
- export declare function isPortVisible(port: NodePort, direction: 'input' | 'output', hiddenPorts: {
22
- inputs?: string[];
23
- outputs?: string[];
24
- }, hideUnconnectedHandles: boolean, connectedHandles: Set<string>, nodeId: string | undefined): boolean;
58
+ * @see .claude/plans/exposed-ports.md
59
+ */
60
+ export declare function isPortVisible(port: NodePort, direction: 'input' | 'output', ports: PortsConfig | undefined): boolean;