@flowdrop/flowdrop 2.11.0 → 2.12.0

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 (455) hide show
  1. package/CHANGELOG.md +223 -0
  2. package/dist/adapters/agentspec/autoLayout.d.ts +18 -36
  3. package/dist/adapters/agentspec/autoLayout.js +75 -93
  4. package/dist/chat/activity.d.ts +49 -0
  5. package/dist/chat/activity.js +65 -0
  6. package/dist/chat/commandClassifier.js +2 -1
  7. package/dist/commands/executor.js +186 -27
  8. package/dist/commands/index.d.ts +2 -1
  9. package/dist/commands/index.js +2 -0
  10. package/dist/commands/parser.js +43 -3
  11. package/dist/commands/session.d.ts +60 -0
  12. package/dist/commands/session.js +332 -0
  13. package/dist/commands/storeIntegration.svelte.js +18 -1
  14. package/dist/commands/types.d.ts +77 -4
  15. package/dist/components/App.svelte +966 -226
  16. package/dist/components/App.svelte.d.ts +26 -2
  17. package/dist/components/BindablePortListbox.svelte +68 -369
  18. package/dist/components/Button.svelte +17 -14
  19. package/dist/components/Button.svelte.d.ts +2 -2
  20. package/dist/components/CanvasContextMenu.svelte +31 -10
  21. package/dist/components/CanvasController.svelte +146 -3
  22. package/dist/components/CanvasController.svelte.d.ts +25 -33
  23. package/dist/components/CanvasIconButton.svelte +6 -6
  24. package/dist/components/CanvasToolbar.svelte +103 -0
  25. package/dist/components/CanvasToolbar.svelte.d.ts +23 -0
  26. package/dist/components/CanvasZoomControls.svelte +122 -0
  27. package/dist/components/CanvasZoomControls.svelte.d.ts +15 -0
  28. package/dist/components/ConfigForm.svelte +159 -121
  29. package/dist/components/ConfigModal.svelte +11 -54
  30. package/dist/components/ConfigPanel.svelte +98 -228
  31. package/dist/components/ConfigPanel.svelte.d.ts +2 -2
  32. package/dist/components/ConnectPortPicker.svelte +153 -0
  33. package/dist/components/ConnectPortPicker.svelte.d.ts +22 -0
  34. package/dist/components/DoctorMenu.svelte +422 -0
  35. package/dist/components/DoctorMenu.svelte.d.ts +7 -0
  36. package/dist/components/ExternalLinkRow.svelte +82 -0
  37. package/dist/components/ExternalLinkRow.svelte.d.ts +14 -0
  38. package/dist/components/FlowDropEdge.svelte +52 -2
  39. package/dist/components/FlowDropEdge.svelte.d.ts +5 -1
  40. package/dist/components/InterfaceNameInput.svelte +103 -0
  41. package/dist/components/InterfaceNameInput.svelte.d.ts +13 -0
  42. package/dist/components/InterfaceTag.svelte +215 -0
  43. package/dist/components/InterfaceTag.svelte.d.ts +20 -0
  44. package/dist/components/InterfaceTagAnchor.svelte +103 -0
  45. package/dist/components/InterfaceTagAnchor.svelte.d.ts +12 -0
  46. package/dist/components/InterfaceTagLayer.svelte +314 -0
  47. package/dist/components/InterfaceTagLayer.svelte.d.ts +28 -0
  48. package/dist/components/LogsSidebar.svelte +43 -43
  49. package/dist/components/LoopbackLanes.svelte +54 -0
  50. package/dist/components/LoopbackLanes.svelte.d.ts +8 -0
  51. package/dist/components/Navbar.svelte +539 -169
  52. package/dist/components/Navbar.svelte.d.ts +20 -1
  53. package/dist/components/NodeInspector.svelte +153 -0
  54. package/dist/components/NodeInspector.svelte.d.ts +19 -0
  55. package/dist/components/NodeLastRun.svelte +212 -0
  56. package/dist/components/NodeLastRun.svelte.d.ts +13 -0
  57. package/dist/components/NodeSidebar.svelte +279 -23
  58. package/dist/components/NodeSidebar.svelte.d.ts +11 -0
  59. package/dist/components/NodeStatusOverlay.svelte +144 -353
  60. package/dist/components/NodeStatusOverlay.svelte.d.ts +4 -1
  61. package/dist/components/PortMappingRow.svelte +28 -44
  62. package/dist/components/PortPickerListbox.svelte +475 -0
  63. package/dist/components/PortPickerListbox.svelte.d.ts +73 -0
  64. package/dist/components/ReadOnlyDetails.svelte +52 -89
  65. package/dist/components/RunBar.svelte +222 -0
  66. package/dist/components/RunBar.svelte.d.ts +20 -0
  67. package/dist/components/RunsMenu.svelte +649 -0
  68. package/dist/components/RunsMenu.svelte.d.ts +14 -0
  69. package/dist/components/SettingsModal.svelte +27 -59
  70. package/dist/components/SettingsPanel.svelte +515 -241
  71. package/dist/components/StraightGuides.svelte +46 -0
  72. package/dist/components/StraightGuides.svelte.d.ts +7 -0
  73. package/dist/components/ThemeToggle.svelte +14 -4
  74. package/dist/components/UniversalNode.svelte +152 -51
  75. package/dist/components/WebMCPBridgeMenu.svelte +336 -0
  76. package/dist/components/WebMCPBridgeMenu.svelte.d.ts +3 -0
  77. package/dist/components/WorkflowEditor.svelte +789 -136
  78. package/dist/components/WorkflowEditor.svelte.d.ts +43 -1
  79. package/dist/components/WorkflowInterfaceEditor.svelte +63 -92
  80. package/dist/components/WorkflowInterfaceEntryCard.svelte +478 -549
  81. package/dist/components/WorkflowInterfaceEntryComposer.svelte +23 -67
  82. package/dist/components/WorkflowPlaygroundSettings.svelte +48 -85
  83. package/dist/components/WorkflowSettingsPanel.svelte +311 -0
  84. package/dist/components/WorkflowSettingsPanel.svelte.d.ts +20 -0
  85. package/dist/components/ZoomTier.svelte +56 -0
  86. package/dist/components/ZoomTier.svelte.d.ts +4 -0
  87. package/dist/components/chat/AIChatPanel.svelte +463 -312
  88. package/dist/components/chat/ActivityList.svelte +130 -0
  89. package/dist/components/chat/ActivityList.svelte.d.ts +11 -0
  90. package/dist/components/chat/ActivityRow.svelte +179 -0
  91. package/dist/components/chat/ActivityRow.svelte.d.ts +16 -0
  92. package/dist/components/chat/CommandPreview.svelte +42 -64
  93. package/dist/components/console/CommandConsole.svelte +106 -41
  94. package/dist/components/console/CommandConsole.svelte.d.ts +2 -0
  95. package/dist/components/console/ConsoleAutocomplete.svelte +14 -13
  96. package/dist/components/console/ConsoleInput.svelte +60 -27
  97. package/dist/components/console/ConsoleOutput.svelte +86 -24
  98. package/dist/components/console/ConsoleStrip.svelte +80 -0
  99. package/dist/components/console/ConsoleStrip.svelte.d.ts +13 -0
  100. package/dist/components/form/FieldFactory.svelte +30 -4
  101. package/dist/components/form/FormArray.svelte +306 -339
  102. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  103. package/dist/components/form/FormArrayRows.svelte +443 -0
  104. package/dist/components/form/FormArrayRows.svelte.d.ts +18 -0
  105. package/dist/components/form/FormAutocomplete.svelte +2 -2
  106. package/dist/components/form/FormCheckboxGroup.svelte +10 -85
  107. package/dist/components/form/FormCodeEditor.svelte +3 -3
  108. package/dist/components/form/FormFieldWrapper.svelte +98 -18
  109. package/dist/components/form/FormFieldWrapper.svelte.d.ts +10 -0
  110. package/dist/components/form/FormFieldset.svelte +44 -28
  111. package/dist/components/form/FormMarkdownEditor.svelte +6 -6
  112. package/dist/components/form/FormPorts.svelte +437 -141
  113. package/dist/components/form/FormSelect.svelte +1 -1
  114. package/dist/components/form/FormTemplateEditor.svelte +22 -26
  115. package/dist/components/form/FormToggle.svelte +15 -106
  116. package/dist/components/form/FormToggle.svelte.d.ts +3 -2
  117. package/dist/components/form/FormUISchemaRenderer.svelte +38 -3
  118. package/dist/components/form/humanizeKey.d.ts +7 -0
  119. package/dist/components/form/humanizeKey.js +21 -0
  120. package/dist/components/form/types.d.ts +6 -0
  121. package/dist/components/icons/MenuOpenIcon.svelte +8 -1
  122. package/dist/components/interrupt/ChoicePrompt.svelte +51 -152
  123. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +0 -2
  124. package/dist/components/interrupt/ConfirmationPrompt.svelte +18 -201
  125. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +0 -4
  126. package/dist/components/interrupt/FormPrompt.svelte +22 -147
  127. package/dist/components/interrupt/FormPrompt.svelte.d.ts +0 -4
  128. package/dist/components/interrupt/InterruptBubble.svelte +198 -355
  129. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +0 -2
  130. package/dist/components/interrupt/ReviewPrompt.svelte +0 -10
  131. package/dist/components/interrupt/TextInputPrompt.svelte +23 -120
  132. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +0 -2
  133. package/dist/components/layouts/MainLayout.svelte +110 -75
  134. package/dist/components/layouts/MainLayout.svelte.d.ts +17 -0
  135. package/dist/components/nodes/CaptionNode.svelte +7 -0
  136. package/dist/components/nodes/GatewayNode.svelte +66 -431
  137. package/dist/components/nodes/IdeaNode.svelte +6 -5
  138. package/dist/components/nodes/NodeCard.svelte +1051 -0
  139. package/dist/components/nodes/NodeCard.svelte.d.ts +30 -0
  140. package/dist/components/nodes/NodeConfigButton.svelte +28 -9
  141. package/dist/components/nodes/NodeProblemMark.svelte +113 -0
  142. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +8 -0
  143. package/dist/components/nodes/NodeTip.svelte +104 -0
  144. package/dist/components/nodes/NodeTip.svelte.d.ts +15 -0
  145. package/dist/components/nodes/NotesNode.svelte +183 -150
  146. package/dist/components/nodes/SimpleNode.svelte +176 -44
  147. package/dist/components/nodes/SquareNode.svelte +127 -34
  148. package/dist/components/nodes/TerminalNode.svelte +232 -88
  149. package/dist/components/nodes/ToolNode.svelte +49 -381
  150. package/dist/components/nodes/WorkflowNode.svelte +40 -399
  151. package/dist/components/playground/ChatBubble.svelte +248 -62
  152. package/dist/components/playground/ChatInput.svelte +134 -297
  153. package/dist/components/playground/ChatInput.svelte.d.ts +17 -0
  154. package/dist/components/playground/ControlPanel.svelte +290 -190
  155. package/dist/components/playground/ControlPanel.svelte.d.ts +10 -2
  156. package/dist/components/playground/DockedPlayground.svelte +75 -0
  157. package/dist/components/playground/DockedPlayground.svelte.d.ts +24 -0
  158. package/dist/components/playground/ExecutionConsole.svelte +54 -36
  159. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  160. package/dist/components/playground/ExecutionLogs.svelte +4 -0
  161. package/dist/components/playground/HeaderMenu.svelte +170 -0
  162. package/dist/components/playground/HeaderMenu.svelte.d.ts +22 -0
  163. package/dist/components/playground/InputCollector.svelte +8 -32
  164. package/dist/components/playground/InputFields.svelte +246 -0
  165. package/dist/components/playground/InputFields.svelte.d.ts +16 -0
  166. package/dist/components/playground/InterfaceInputForm.svelte +285 -30
  167. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +20 -0
  168. package/dist/components/playground/InterfaceJsonInput.svelte +92 -0
  169. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +10 -0
  170. package/dist/components/playground/LogRow.svelte +12 -12
  171. package/dist/components/playground/MessageMarkdown.svelte +11 -11
  172. package/dist/components/playground/MessageStream.svelte +154 -182
  173. package/dist/components/playground/Playground.svelte +17 -1139
  174. package/dist/components/playground/PlaygroundApp.svelte +12 -2
  175. package/dist/components/playground/PlaygroundApp.svelte.d.ts +2 -1
  176. package/dist/components/playground/PlaygroundHeader.svelte +309 -0
  177. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +22 -0
  178. package/dist/components/playground/PlaygroundModal.svelte +6 -0
  179. package/dist/components/playground/PlaygroundStudio.svelte +30 -32
  180. package/dist/components/playground/PlaygroundSurface.svelte +648 -0
  181. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +79 -0
  182. package/dist/components/playground/StepsSummary.svelte +312 -0
  183. package/dist/components/playground/StepsSummary.svelte.d.ts +11 -0
  184. package/dist/components/playground/messageDisplay.d.ts +9 -0
  185. package/dist/components/playground/messageDisplay.js +24 -2
  186. package/dist/components/playground/stepSummary.d.ts +71 -0
  187. package/dist/components/playground/stepSummary.js +152 -0
  188. package/dist/components/ports/PortTypeBadge.svelte +13 -1
  189. package/dist/components/primitives/Button.svelte +226 -0
  190. package/dist/components/primitives/Button.svelte.d.ts +31 -0
  191. package/dist/components/primitives/Card.svelte +110 -0
  192. package/dist/components/primitives/Card.svelte.d.ts +20 -0
  193. package/dist/components/primitives/Checkbox.svelte +126 -0
  194. package/dist/components/primitives/Checkbox.svelte.d.ts +15 -0
  195. package/dist/components/primitives/Chip.svelte +143 -0
  196. package/dist/components/primitives/Chip.svelte.d.ts +22 -0
  197. package/dist/components/primitives/Combobox.svelte +444 -0
  198. package/dist/components/primitives/Combobox.svelte.d.ts +22 -0
  199. package/dist/components/primitives/Composer.svelte +293 -0
  200. package/dist/components/primitives/Composer.svelte.d.ts +47 -0
  201. package/dist/components/primitives/EmptyState.svelte +113 -0
  202. package/dist/components/primitives/EmptyState.svelte.d.ts +18 -0
  203. package/dist/components/primitives/Field.svelte +178 -0
  204. package/dist/components/primitives/Field.svelte.d.ts +30 -0
  205. package/dist/components/primitives/IconButton.svelte +156 -0
  206. package/dist/components/primitives/IconButton.svelte.d.ts +27 -0
  207. package/dist/components/primitives/Menu.svelte +435 -0
  208. package/dist/components/primitives/Menu.svelte.d.ts +61 -0
  209. package/dist/components/primitives/Notice.svelte +161 -0
  210. package/dist/components/primitives/Notice.svelte.d.ts +22 -0
  211. package/dist/components/primitives/PanelHeader.svelte +134 -0
  212. package/dist/components/primitives/PanelHeader.svelte.d.ts +23 -0
  213. package/dist/components/primitives/Segmented.svelte +198 -0
  214. package/dist/components/primitives/Segmented.svelte.d.ts +32 -0
  215. package/dist/components/primitives/Select.svelte +130 -0
  216. package/dist/components/primitives/Select.svelte.d.ts +26 -0
  217. package/dist/components/primitives/StatusPill.svelte +218 -0
  218. package/dist/components/primitives/StatusPill.svelte.d.ts +24 -0
  219. package/dist/components/primitives/Switch.svelte +113 -0
  220. package/dist/components/primitives/Switch.svelte.d.ts +14 -0
  221. package/dist/components/primitives/Tabs.svelte +209 -0
  222. package/dist/components/primitives/Tabs.svelte.d.ts +32 -0
  223. package/dist/components/primitives/Toolbar.svelte +94 -0
  224. package/dist/components/primitives/Toolbar.svelte.d.ts +14 -0
  225. package/dist/components/primitives/ToolbarSeparator.svelte +40 -0
  226. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  227. package/dist/components/surfaces/SurfaceOverlay.svelte +10 -40
  228. package/dist/components/surfaces/TabbedSurface.svelte +49 -39
  229. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +8 -0
  230. package/dist/components/toast/DismissibleToast.svelte +94 -32
  231. package/dist/components/toast/DismissibleToast.svelte.d.ts +17 -7
  232. package/dist/config/endpoints.d.ts +43 -1
  233. package/dist/config/endpoints.js +21 -3
  234. package/dist/core/index.d.ts +8 -5
  235. package/dist/core/index.js +1 -1
  236. package/dist/editor/connectCandidates.d.ts +56 -0
  237. package/dist/editor/connectCandidates.js +131 -0
  238. package/dist/editor/contextMenu.d.ts +31 -2
  239. package/dist/editor/contextMenu.js +96 -9
  240. package/dist/editor/index.d.ts +3 -1
  241. package/dist/editor/index.js +1 -0
  242. package/dist/editor/interfaceMenu.d.ts +35 -0
  243. package/dist/editor/interfaceMenu.js +47 -0
  244. package/dist/editor/portMenu.d.ts +23 -0
  245. package/dist/editor/portMenu.js +34 -0
  246. package/dist/editor/tidy.d.ts +30 -0
  247. package/dist/editor/tidy.js +66 -0
  248. package/dist/helpers/workflowEditorHelper.d.ts +3 -0
  249. package/dist/helpers/workflowEditorHelper.js +8 -3
  250. package/dist/layout/fromWorkflow.d.ts +42 -0
  251. package/dist/layout/fromWorkflow.js +135 -0
  252. package/dist/layout/geometry.d.ts +102 -0
  253. package/dist/layout/geometry.js +317 -0
  254. package/dist/layout/index.d.ts +21 -0
  255. package/dist/layout/index.js +14 -0
  256. package/dist/layout/inspect.d.ts +18 -0
  257. package/dist/layout/inspect.js +81 -0
  258. package/dist/layout/lanePath.d.ts +23 -0
  259. package/dist/layout/lanePath.js +47 -0
  260. package/dist/layout/measure.d.ts +141 -0
  261. package/dist/layout/measure.js +477 -0
  262. package/dist/layout/primitives.d.ts +124 -0
  263. package/dist/layout/primitives.js +461 -0
  264. package/dist/layout/sweep.d.ts +59 -0
  265. package/dist/layout/sweep.js +257 -0
  266. package/dist/layout/toWorkflow.d.ts +43 -0
  267. package/dist/layout/toWorkflow.js +131 -0
  268. package/dist/layout/types.d.ts +93 -0
  269. package/dist/layout/types.js +35 -0
  270. package/dist/messages/defaults.d.ts +641 -26
  271. package/dist/messages/defaults.js +578 -25
  272. package/dist/messages/types.d.ts +21 -1
  273. package/dist/openapi/v1/openapi.yaml +109 -0
  274. package/dist/playground/index.d.ts +28 -1
  275. package/dist/playground/index.js +29 -0
  276. package/dist/playground/mount.d.ts +28 -2
  277. package/dist/playground/mount.js +41 -15
  278. package/dist/playground/runAction.d.ts +29 -0
  279. package/dist/playground/runAction.js +38 -0
  280. package/dist/services/doctorService.d.ts +52 -0
  281. package/dist/services/doctorService.js +113 -0
  282. package/dist/services/globalSave.js +12 -29
  283. package/dist/services/nodeExecutionService.d.ts +12 -1
  284. package/dist/services/nodeExecutionService.js +58 -58
  285. package/dist/services/playgroundService.d.ts +17 -2
  286. package/dist/services/playgroundService.js +48 -5
  287. package/dist/services/runsService.d.ts +42 -0
  288. package/dist/services/runsService.js +87 -0
  289. package/dist/services/toastQueue.d.ts +33 -0
  290. package/dist/services/toastQueue.js +38 -0
  291. package/dist/services/toastService.d.ts +30 -9
  292. package/dist/services/toastService.js +81 -46
  293. package/dist/settings/index.d.ts +1 -0
  294. package/dist/skins/graphite.d.ts +26 -0
  295. package/dist/skins/graphite.js +473 -0
  296. package/dist/skins/index.d.ts +2 -1
  297. package/dist/skins/index.js +4 -2
  298. package/dist/skins/slate.js +4 -4
  299. package/dist/stores/attachedRunStore.svelte.d.ts +35 -0
  300. package/dist/stores/attachedRunStore.svelte.js +47 -0
  301. package/dist/stores/connectDragStore.svelte.d.ts +39 -0
  302. package/dist/stores/connectDragStore.svelte.js +42 -0
  303. package/dist/stores/doctorStore.svelte.d.ts +79 -0
  304. package/dist/stores/doctorStore.svelte.js +244 -0
  305. package/dist/stores/editedNodesStore.svelte.d.ts +42 -0
  306. package/dist/stores/editedNodesStore.svelte.js +84 -0
  307. package/dist/stores/editorModeStore.svelte.d.ts +34 -0
  308. package/dist/stores/editorModeStore.svelte.js +55 -0
  309. package/dist/stores/instanceContainer.svelte.d.ts +53 -0
  310. package/dist/stores/instanceContainer.svelte.js +38 -1
  311. package/dist/stores/loopbackLanesStore.svelte.d.ts +18 -0
  312. package/dist/stores/loopbackLanesStore.svelte.js +25 -0
  313. package/dist/stores/nodeHighlightStore.svelte.d.ts +34 -0
  314. package/dist/stores/nodeHighlightStore.svelte.js +56 -0
  315. package/dist/stores/playgroundStore.svelte.d.ts +66 -2
  316. package/dist/stores/playgroundStore.svelte.js +164 -2
  317. package/dist/stores/runController.svelte.d.ts +382 -0
  318. package/dist/stores/runController.svelte.js +1217 -0
  319. package/dist/stores/settingsStore.svelte.d.ts +80 -18
  320. package/dist/stores/settingsStore.svelte.js +180 -62
  321. package/dist/stores/workflowStore.svelte.d.ts +14 -0
  322. package/dist/stores/workflowStore.svelte.js +22 -1
  323. package/dist/styles/base.css +286 -25
  324. package/dist/styles/fonts/Inter-LICENSE.txt +93 -0
  325. package/dist/styles/fonts/inter-latin-wght-normal.woff2 +0 -0
  326. package/dist/styles/fonts/inter.css +19 -0
  327. package/dist/styles/toast.css +100 -20
  328. package/dist/styles/tokenAliases.js +118 -1
  329. package/dist/styles/tokens.css +586 -14
  330. package/dist/svelte-app.d.ts +38 -5
  331. package/dist/svelte-app.js +14 -3
  332. package/dist/themes/graphite.d.ts +2 -0
  333. package/dist/themes/graphite.js +15 -0
  334. package/dist/themes/index.d.ts +2 -1
  335. package/dist/themes/index.js +22 -3
  336. package/dist/themes/minimal.js +10 -0
  337. package/dist/themes/scopedSkinCss.d.ts +22 -5
  338. package/dist/themes/scopedSkinCss.js +136 -11
  339. package/dist/types/chat.d.ts +6 -0
  340. package/dist/types/doctor.d.ts +82 -0
  341. package/dist/types/doctor.js +11 -0
  342. package/dist/types/events.d.ts +35 -0
  343. package/dist/types/events.js +4 -1
  344. package/dist/types/index.d.ts +17 -2
  345. package/dist/types/navbar.d.ts +36 -0
  346. package/dist/types/playground.d.ts +66 -0
  347. package/dist/types/settings.d.ts +120 -7
  348. package/dist/types/settings.js +35 -3
  349. package/dist/types/skin.d.ts +21 -8
  350. package/dist/types/theme.d.ts +40 -2
  351. package/dist/utils/appearance.d.ts +19 -0
  352. package/dist/utils/appearance.js +13 -0
  353. package/dist/utils/canvasFit.d.ts +41 -0
  354. package/dist/utils/canvasFit.js +44 -0
  355. package/dist/utils/chipTitles.d.ts +9 -0
  356. package/dist/utils/chipTitles.js +19 -0
  357. package/dist/utils/connections.js +8 -0
  358. package/dist/utils/consoleHighlight.d.ts +28 -0
  359. package/dist/utils/consoleHighlight.js +269 -0
  360. package/dist/utils/deprecation.d.ts +17 -0
  361. package/dist/utils/deprecation.js +29 -0
  362. package/dist/utils/doctorOperations.d.ts +40 -0
  363. package/dist/utils/doctorOperations.js +237 -0
  364. package/dist/utils/duration.d.ts +13 -0
  365. package/dist/utils/duration.js +40 -0
  366. package/dist/utils/inspectorContext.d.ts +19 -0
  367. package/dist/utils/inspectorContext.js +12 -0
  368. package/dist/utils/inspectorSections.d.ts +20 -0
  369. package/dist/utils/inspectorSections.js +44 -0
  370. package/dist/utils/inspectorSurface.d.ts +46 -0
  371. package/dist/utils/inspectorSurface.js +51 -0
  372. package/dist/utils/interfaceTags.d.ts +102 -0
  373. package/dist/utils/interfaceTags.js +211 -0
  374. package/dist/utils/itemRef.d.ts +86 -0
  375. package/dist/utils/itemRef.js +106 -0
  376. package/dist/utils/lastRun.d.ts +35 -0
  377. package/dist/utils/lastRun.js +73 -0
  378. package/dist/utils/messageNodeLink.d.ts +17 -0
  379. package/dist/utils/messageNodeLink.js +16 -0
  380. package/dist/utils/minimapVisibility.d.ts +28 -0
  381. package/dist/utils/minimapVisibility.js +34 -0
  382. package/dist/utils/nodeAriaLabel.d.ts +12 -0
  383. package/dist/utils/nodeAriaLabel.js +17 -0
  384. package/dist/utils/nodeFingerprint.d.ts +27 -0
  385. package/dist/utils/nodeFingerprint.js +66 -0
  386. package/dist/utils/nodeFormSchema.d.ts +10 -0
  387. package/dist/utils/nodeFormSchema.js +2 -2
  388. package/dist/utils/nodeGeometry.d.ts +168 -0
  389. package/dist/utils/nodeGeometry.js +204 -0
  390. package/dist/utils/nodeProblem.d.ts +19 -0
  391. package/dist/utils/nodeProblem.js +9 -0
  392. package/dist/utils/nodeStatus.d.ts +38 -3
  393. package/dist/utils/nodeStatus.js +67 -39
  394. package/dist/utils/nodeSwap.js +9 -1
  395. package/dist/utils/nodeWrapper.d.ts +1 -0
  396. package/dist/utils/playgroundHistory.d.ts +48 -0
  397. package/dist/utils/playgroundHistory.js +38 -0
  398. package/dist/utils/playgroundInputRuns.d.ts +26 -0
  399. package/dist/utils/playgroundInputRuns.js +50 -0
  400. package/dist/utils/portExposure.d.ts +49 -0
  401. package/dist/utils/portExposure.js +122 -0
  402. package/dist/utils/portUtils.d.ts +16 -0
  403. package/dist/utils/portUtils.js +37 -0
  404. package/dist/utils/portal.d.ts +0 -19
  405. package/dist/utils/portal.js +8 -1
  406. package/dist/utils/reservedPorts.d.ts +59 -0
  407. package/dist/utils/reservedPorts.js +60 -0
  408. package/dist/utils/runEdges.d.ts +24 -0
  409. package/dist/utils/runEdges.js +35 -0
  410. package/dist/utils/runsList.d.ts +69 -0
  411. package/dist/utils/runsList.js +134 -0
  412. package/dist/utils/selectOptions.d.ts +62 -0
  413. package/dist/utils/selectOptions.js +137 -0
  414. package/dist/utils/sessionRuns.d.ts +62 -0
  415. package/dist/utils/sessionRuns.js +123 -0
  416. package/dist/utils/sheetWidths.d.ts +29 -0
  417. package/dist/utils/sheetWidths.js +41 -0
  418. package/dist/utils/sidebarWidths.d.ts +34 -0
  419. package/dist/utils/sidebarWidths.js +47 -0
  420. package/dist/utils/straightWires.d.ts +73 -0
  421. package/dist/utils/straightWires.js +99 -0
  422. package/dist/utils/themeScope.svelte.d.ts +10 -0
  423. package/dist/utils/themeScope.svelte.js +80 -0
  424. package/dist/utils/wiredHandles.d.ts +10 -0
  425. package/dist/utils/wiredHandles.js +14 -0
  426. package/dist/utils/workflowDraft.d.ts +9 -0
  427. package/dist/utils/workflowDraft.js +39 -0
  428. package/dist/utils/workflowInterface.d.ts +40 -7
  429. package/dist/utils/workflowInterface.js +66 -16
  430. package/dist/utils/zoomTier.d.ts +43 -0
  431. package/dist/utils/zoomTier.js +107 -0
  432. package/dist/utils/zoomTierRows.d.ts +41 -0
  433. package/dist/utils/zoomTierRows.js +103 -0
  434. package/dist/webmcp/WebMCPConfirm.svelte +1 -1
  435. package/dist/webmcp/bridge.d.ts +5 -0
  436. package/dist/webmcp/bridge.js +8 -0
  437. package/dist/webmcp/bridgeController.svelte.d.ts +84 -0
  438. package/dist/webmcp/bridgeController.svelte.js +224 -0
  439. package/dist/webmcp/descriptors.d.ts +1 -1
  440. package/dist/webmcp/descriptors.js +66 -5
  441. package/dist/webmcp/fakeWidget.d.ts +34 -0
  442. package/dist/webmcp/fakeWidget.js +75 -0
  443. package/dist/webmcp/gate.js +4 -0
  444. package/dist/webmcp/index.d.ts +2 -0
  445. package/dist/webmcp/index.js +1 -0
  446. package/dist/webmcp/runtime.js +4 -1
  447. package/dist/webmcp/types.d.ts +2 -0
  448. package/dist/webmcp/validate.js +5 -1
  449. package/package.json +8 -2
  450. package/dist/components/Select.svelte +0 -53
  451. package/dist/components/Select.svelte.d.ts +0 -15
  452. package/dist/components/icons/CommandLineIcon.svelte +0 -15
  453. package/dist/components/icons/CommandLineIcon.svelte.d.ts +0 -26
  454. package/dist/components/toast/WarningIcon.svelte +0 -28
  455. package/dist/components/toast/WarningIcon.svelte.d.ts +0 -26
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Svelte action: give every inline `code` span inside a rendered reply a
3
+ * `title` with its full text. Node references in Assistant replies are inline
4
+ * code, drawn as chips that truncate with an ellipsis, so the title is the way
5
+ * to read a long id in full. Code inside `pre` blocks is left alone.
6
+ */
7
+ export declare function chipTitles(node: HTMLElement, _content?: unknown): {
8
+ update: () => void;
9
+ };
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Svelte action: give every inline `code` span inside a rendered reply a
3
+ * `title` with its full text. Node references in Assistant replies are inline
4
+ * code, drawn as chips that truncate with an ellipsis, so the title is the way
5
+ * to read a long id in full. Code inside `pre` blocks is left alone.
6
+ */
7
+ export function chipTitles(node, _content) {
8
+ const apply = () => {
9
+ for (const code of node.querySelectorAll('code')) {
10
+ if (code.closest('pre'))
11
+ continue;
12
+ const text = code.textContent ?? '';
13
+ if (text && code.title !== text)
14
+ code.title = text;
15
+ }
16
+ };
17
+ apply();
18
+ return { update: apply };
19
+ }
@@ -1,6 +1,7 @@
1
1
  /**
2
2
  * Connection validation utilities for FlowDrop
3
3
  */
4
+ import { isTriggerEventInput } from './reservedPorts.js';
4
5
  /**
5
6
  * Loopback port name constant
6
7
  * This is the standard input port name used for loop iteration triggers
@@ -169,6 +170,13 @@ export function validateConnection(checker, sourceNodeId, sourcePortId, targetNo
169
170
  if (sourceNodeId === targetNodeId) {
170
171
  return { valid: false, error: 'Cannot connect node to itself' };
171
172
  }
173
+ // A trigger's event comes only from what starts the run (R16).
174
+ if (isTriggerEventInput(targetNode, targetPortId)) {
175
+ return {
176
+ valid: false,
177
+ error: "A trigger's event input cannot be connected: it is filled when the trigger fires"
178
+ };
179
+ }
172
180
  // Get node metadata
173
181
  const sourceMetadata = nodeTypes.find((nt) => nt.node_type_id === sourceNode.data.metadata.node_type_id);
174
182
  const targetMetadata = nodeTypes.find((nt) => nt.node_type_id === targetNode.data.metadata.node_type_id);
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Console output highlighting.
3
+ *
4
+ * `highlightConsoleEntry` splits one console entry into role-tagged segments
5
+ * for the terminal surface. It is purely presentational:
6
+ *
7
+ * - The segments' text, joined, is always exactly `entry.text`. It never adds,
8
+ * drops or reorders a character, so what the panel's `innerText` shows (and
9
+ * what an AI agent reads from it) is the plain output.
10
+ * - Every output shape the command layer produces is handled by a rule below.
11
+ * A line that fits no rule stays plain (`role: null`); nothing is guessed.
12
+ * - Roles are semantic, not colours. The colours are `--fd-console-*` tokens.
13
+ */
14
+ export type ConsoleRole = 'prompt' | 'verb' | 'arg' | 'id' | 'header' | 'rule' | 'key' | 'eq' | 'string' | 'number' | 'punct' | 'error' | 'muted';
15
+ export interface ConsoleSegment {
16
+ role: ConsoleRole | null;
17
+ text: string;
18
+ }
19
+ /** The shape of a console entry this util reads (see `ConsoleOutput.svelte`). */
20
+ export interface ConsoleEntryLike {
21
+ type: 'input' | 'success' | 'error' | 'formatted';
22
+ text: string;
23
+ }
24
+ /**
25
+ * Role-tagged segments for one console entry. `segments.map(s => s.text).join('')`
26
+ * is always `entry.text`.
27
+ */
28
+ export declare function highlightConsoleEntry(entry: ConsoleEntryLike): ConsoleSegment[];
@@ -0,0 +1,269 @@
1
+ /**
2
+ * Console output highlighting.
3
+ *
4
+ * `highlightConsoleEntry` splits one console entry into role-tagged segments
5
+ * for the terminal surface. It is purely presentational:
6
+ *
7
+ * - The segments' text, joined, is always exactly `entry.text`. It never adds,
8
+ * drops or reorders a character, so what the panel's `innerText` shows (and
9
+ * what an AI agent reads from it) is the plain output.
10
+ * - Every output shape the command layer produces is handled by a rule below.
11
+ * A line that fits no rule stays plain (`role: null`); nothing is guessed.
12
+ * - Roles are semantic, not colours. The colours are `--fd-console-*` tokens.
13
+ */
14
+ /** Node ids are `type.N` (`data_shaper.1`); not part of a longer word or number. */
15
+ const NODE_ID = /(?<![\w.])(?!v\d+\.\d)[a-z][a-z0-9_]*\.\d+(?![\w]|\.\d)/g;
16
+ const RULE_LINE = /^-+(?: {2}-+)*$/;
17
+ /** Section headings: `Inputs:`, `Config:`, `Session (editor Console only):`, ` Outputs:`. */
18
+ const HEADING_LINE = /^(\s*)([A-Z][^:\n]*:)$/;
19
+ function push(out, role, text) {
20
+ if (text === '')
21
+ return;
22
+ const last = out[out.length - 1];
23
+ if (last && last.role === role)
24
+ last.text += text;
25
+ else
26
+ out.push({ role, text });
27
+ }
28
+ /** Text with node ids picked out; everything else keeps `base`. */
29
+ function withIds(out, text, base) {
30
+ let last = 0;
31
+ for (const m of text.matchAll(NODE_ID)) {
32
+ push(out, base, text.slice(last, m.index));
33
+ push(out, 'id', m[0]);
34
+ last = m.index + m[0].length;
35
+ }
36
+ push(out, base, text.slice(last));
37
+ }
38
+ /**
39
+ * A JSON-ish value as the commands print it (`JSON.stringify` output, or a
40
+ * quoted string). Unbalanced quotes and any other character fall through to
41
+ * plain `arg` text, so the lexer is total.
42
+ */
43
+ function valueTokens(out, text) {
44
+ const re = /("(?:[^"\\]|\\.)*")|((?<![\w.])-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?(?![\w.]))|([{}[\],:])|([^"{}[\],:\d-]+|[\s\S])/g;
45
+ for (const m of text.matchAll(re)) {
46
+ if (m[1] !== undefined)
47
+ push(out, 'string', m[0]);
48
+ else if (m[2] !== undefined)
49
+ push(out, 'number', m[0]);
50
+ else if (m[3] !== undefined)
51
+ push(out, 'punct', m[0]);
52
+ else
53
+ push(out, 'arg', m[0]);
54
+ }
55
+ }
56
+ /** `> verb args`: the first word is the verb, node ids in the rest stand out. */
57
+ function inputLine(out, text) {
58
+ const m = /^(\s*)(\S+)([\s\S]*)$/.exec(text);
59
+ if (!m) {
60
+ push(out, null, text);
61
+ return;
62
+ }
63
+ push(out, null, m[1]);
64
+ push(out, 'verb', m[2]);
65
+ withIds(out, m[3], 'arg');
66
+ }
67
+ /** Per-table cell roles, keyed by the header's column names. */
68
+ function columnRoles(names) {
69
+ const key = names.join('|').toLowerCase();
70
+ switch (key) {
71
+ case 'id|label|type': // list nodes
72
+ case 'type id|name|category': // list types, search types
73
+ return ['id', null, 'muted'];
74
+ case 'name|syntax|description': // help
75
+ return ['verb', 'arg', 'muted'];
76
+ case 'source|port||target|port': // list edges
77
+ return ['id', null, 'punct', 'id', null];
78
+ default:
79
+ return null;
80
+ }
81
+ }
82
+ /** One data row, cut at the rule's column starts so nothing is re-parsed. */
83
+ function tableRow(out, line, starts, roles) {
84
+ if (!roles) {
85
+ withIds(out, line, null);
86
+ return;
87
+ }
88
+ starts.forEach((start, i) => {
89
+ const end = i + 1 < starts.length ? starts[i + 1] : line.length;
90
+ const cell = line.slice(start, end);
91
+ const content = cell.trimEnd();
92
+ push(out, roles[i] ?? null, content);
93
+ push(out, null, cell.slice(content.length));
94
+ });
95
+ }
96
+ /** A single prose line (messages, key/value blocks, port lists, edge lists). */
97
+ function proseLine(out, line, section) {
98
+ if (line === '')
99
+ return section;
100
+ const heading = HEADING_LINE.exec(line);
101
+ if (heading) {
102
+ push(out, null, heading[1]);
103
+ push(out, 'header', heading[2]);
104
+ const name = heading[2].slice(0, -1);
105
+ return name === 'Config' ? 'config' : name === 'Edges' ? 'edges' : 'other';
106
+ }
107
+ if (/^\s*\(none\)$/.test(line)) {
108
+ push(out, 'muted', line);
109
+ return section;
110
+ }
111
+ // `config: key = value, key = value` (get <id> with no key); the id is whatever the node is called
112
+ const cfg = /^(\S+)( config: )([\s\S]*)$/.exec(line);
113
+ if (cfg) {
114
+ push(out, 'id', cfg[1]);
115
+ push(out, 'key', cfg[2]);
116
+ configPairs(out, cfg[3]);
117
+ return section;
118
+ }
119
+ // `Set id:key = value` (any id) / `id:key = value` (ids of the `type.N` form)
120
+ const set = /^Set ([^\s:]+):(\S+)( = )([\s\S]*)$/.exec(line) ??
121
+ new RegExp(`^(${NODE_ID.source}):(\\S+)( = )([\\s\\S]*)$`).exec(line);
122
+ if (set) {
123
+ const withSet = line.startsWith('Set ');
124
+ push(out, null, withSet ? 'Set ' : '');
125
+ push(out, 'id', set[1]);
126
+ push(out, 'punct', ':');
127
+ push(out, 'key', set[2]);
128
+ push(out, 'eq', set[3]);
129
+ valueTokens(out, set[4]);
130
+ return section;
131
+ }
132
+ // Header fields of describe / info: `Node: id`
133
+ const field = /^(Type|Name|Category|Description|Tags|Confirmation|Node|Label|Position):(\s+)(.*)$/.exec(line);
134
+ if (field) {
135
+ push(out, 'key', field[1] + ':');
136
+ push(out, null, field[2]);
137
+ const value = field[3];
138
+ if (field[1] === 'Node' || field[1] === 'Type')
139
+ push(out, 'id', value);
140
+ else
141
+ push(out, null, value);
142
+ return section;
143
+ }
144
+ // Port and config-schema lines: ` portId (dataType) required — help`
145
+ const port = /^(\s+)(\S+) (\([^)]*\))([\s\S]*)$/.exec(line);
146
+ if (port) {
147
+ push(out, null, port[1]);
148
+ push(out, section === 'config' ? 'key' : 'arg', port[2]);
149
+ push(out, null, ' ');
150
+ push(out, 'muted', port[3]);
151
+ const rest = port[4];
152
+ const dash = rest.indexOf(' — ');
153
+ if (dash < 0)
154
+ push(out, null, rest);
155
+ else {
156
+ push(out, null, rest.slice(0, dash));
157
+ push(out, 'muted', rest.slice(dash));
158
+ }
159
+ return section;
160
+ }
161
+ // info config values: ` key: "value"`
162
+ if (section === 'config') {
163
+ const kv = /^(\s+)([^\s:]+)(:)( )([\s\S]*)$/.exec(line);
164
+ if (kv) {
165
+ push(out, null, kv[1]);
166
+ push(out, 'key', kv[2]);
167
+ push(out, 'punct', kv[3]);
168
+ push(out, null, kv[4]);
169
+ valueTokens(out, kv[5]);
170
+ return section;
171
+ }
172
+ }
173
+ // info edges: ` remote:port -> local` / ` local -> remote:port`
174
+ if (section === 'edges') {
175
+ const edge = /^(\s+)(\S+) -> (\S+)$/.exec(line);
176
+ if (edge) {
177
+ push(out, null, edge[1]);
178
+ edgeEnd(out, edge[2]);
179
+ push(out, null, ' ');
180
+ push(out, 'punct', '->');
181
+ push(out, null, ' ');
182
+ edgeEnd(out, edge[3]);
183
+ return section;
184
+ }
185
+ }
186
+ // `a.1:out → b.1:in`, `Deleted node a.1`, `Renamed a.1 to "x"` …
187
+ withIds(out, line, null);
188
+ return section;
189
+ }
190
+ function edgeEnd(out, end) {
191
+ const i = end.indexOf(':');
192
+ if (i < 0) {
193
+ push(out, 'arg', end);
194
+ return;
195
+ }
196
+ push(out, 'id', end.slice(0, i));
197
+ push(out, 'punct', ':');
198
+ push(out, 'arg', end.slice(i + 1));
199
+ }
200
+ /** `key = value, key = value`, values being JSON. */
201
+ function configPairs(out, body) {
202
+ const re = /(\w+)( = )([\s\S]*?)(?=(?:, \w+ = )|$)/g;
203
+ let last = 0;
204
+ for (const m of body.matchAll(re)) {
205
+ if (m[0] === '')
206
+ continue;
207
+ push(out, null, body.slice(last, m.index));
208
+ push(out, 'key', m[1]);
209
+ push(out, 'eq', m[2]);
210
+ valueTokens(out, m[3]);
211
+ last = m.index + m[0].length;
212
+ }
213
+ push(out, null, body.slice(last));
214
+ }
215
+ function blockText(out, text) {
216
+ const lines = text.split('\n');
217
+ let section = 'other';
218
+ let i = 0;
219
+ while (i < lines.length) {
220
+ if (i > 0)
221
+ push(out, null, '\n');
222
+ const line = lines[i];
223
+ const next = lines[i + 1];
224
+ if (line.trim() !== '' && next !== undefined && RULE_LINE.test(next) && !RULE_LINE.test(line)) {
225
+ // A table: header, rule, rows up to the next blank line.
226
+ const starts = [...next.matchAll(/-+/g)].map((m) => m.index);
227
+ const names = starts.map((start, c) => line.slice(start, c + 1 < starts.length ? starts[c + 1] : line.length).trim());
228
+ const roles = columnRoles(names);
229
+ push(out, 'header', line);
230
+ push(out, null, '\n');
231
+ push(out, 'rule', next);
232
+ i += 2;
233
+ while (i < lines.length && lines[i] !== '') {
234
+ push(out, null, '\n');
235
+ tableRow(out, lines[i], starts, roles);
236
+ i++;
237
+ }
238
+ section = 'other';
239
+ continue;
240
+ }
241
+ section = proseLine(out, line, section);
242
+ i++;
243
+ }
244
+ }
245
+ /**
246
+ * Role-tagged segments for one console entry. `segments.map(s => s.text).join('')`
247
+ * is always `entry.text`.
248
+ */
249
+ export function highlightConsoleEntry(entry) {
250
+ const text = entry.text;
251
+ if (text === '')
252
+ return [];
253
+ const out = [];
254
+ try {
255
+ if (entry.type === 'input')
256
+ inputLine(out, text);
257
+ else if (entry.type === 'error')
258
+ push(out, 'error', text);
259
+ else
260
+ blockText(out, text);
261
+ }
262
+ catch {
263
+ return [{ role: null, text }];
264
+ }
265
+ // The invariant is the contract: if a rule ever lost a character, show plain.
266
+ if (out.map((s) => s.text).join('') !== text)
267
+ return [{ role: null, text }];
268
+ return out;
269
+ }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * One-time deprecation warnings.
3
+ *
4
+ * The standalone Playground (`Playground`, `PlaygroundStudio`, `PlaygroundApp`,
5
+ * `PlaygroundModal` and the `mountPlayground*` entries) is deprecated in
6
+ * favour of the editor's Test mode and goes in 3.0. It says so once per page,
7
+ * not once per instance. The flag lives on `globalThis` so two copies of the
8
+ * library on one page (an IIFE next to a bundler build) still warn once.
9
+ *
10
+ * @module utils/deprecation
11
+ */
12
+ /** The message the standalone Playground warns with. */
13
+ export declare const STANDALONE_PLAYGROUND_DEPRECATION: string;
14
+ /** Warn, once per page, that the standalone Playground is deprecated. */
15
+ export declare function warnStandalonePlaygroundDeprecated(): void;
16
+ /** Forget that the warning was given. For tests. */
17
+ export declare function resetStandalonePlaygroundDeprecation(): void;
@@ -0,0 +1,29 @@
1
+ /**
2
+ * One-time deprecation warnings.
3
+ *
4
+ * The standalone Playground (`Playground`, `PlaygroundStudio`, `PlaygroundApp`,
5
+ * `PlaygroundModal` and the `mountPlayground*` entries) is deprecated in
6
+ * favour of the editor's Test mode and goes in 3.0. It says so once per page,
7
+ * not once per instance. The flag lives on `globalThis` so two copies of the
8
+ * library on one page (an IIFE next to a bundler build) still warn once.
9
+ *
10
+ * @module utils/deprecation
11
+ */
12
+ const STANDALONE_PLAYGROUND_FLAG = Symbol.for('flowdrop.standalonePlaygroundDeprecationWarned');
13
+ /** The message the standalone Playground warns with. */
14
+ export const STANDALONE_PLAYGROUND_DEPRECATION = '[FlowDrop] The standalone Playground (Playground, PlaygroundStudio, PlaygroundApp, ' +
15
+ 'PlaygroundModal and mountPlayground*) is deprecated and will be removed in 3.0. ' +
16
+ "Use the editor's Test mode instead.";
17
+ /** Warn, once per page, that the standalone Playground is deprecated. */
18
+ export function warnStandalonePlaygroundDeprecated() {
19
+ const scope = globalThis;
20
+ if (scope[STANDALONE_PLAYGROUND_FLAG])
21
+ return;
22
+ scope[STANDALONE_PLAYGROUND_FLAG] = true;
23
+ // eslint-disable-next-line no-console -- the one-time deprecation notice is the point
24
+ console.warn(STANDALONE_PLAYGROUND_DEPRECATION);
25
+ }
26
+ /** Forget that the warning was given. For tests. */
27
+ export function resetStandalonePlaygroundDeprecation() {
28
+ delete globalThis[STANDALONE_PLAYGROUND_FLAG];
29
+ }
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Maps the Doctor's remedy operations onto the editor's workflow.
3
+ *
4
+ * Pure: it never touches a store. `applyDoctorOperations` validates every
5
+ * operation first and applies them, in order, to a copy; it either answers the
6
+ * whole result or a refusal, so a remedy is never half applied. The caller then
7
+ * commits the result with ONE store update, which is one undo step.
8
+ *
9
+ * @module utils/doctorOperations
10
+ */
11
+ import type { Workflow, WorkflowEdge, WorkflowNode } from '../types/index.js';
12
+ export interface DoctorApplyInput {
13
+ nodes: WorkflowNode[];
14
+ edges: WorkflowEdge[];
15
+ }
16
+ export type DoctorApplyResult = {
17
+ ok: true;
18
+ nodes: WorkflowNode[];
19
+ edges: WorkflowEdge[];
20
+ /** Present only when an operation set it. */
21
+ interface?: Workflow['interface'];
22
+ playground?: Workflow['playground'];
23
+ /** Which of the optional parts an operation set (a cleared one is `undefined` but changed). */
24
+ touched: {
25
+ interface: boolean;
26
+ playground: boolean;
27
+ };
28
+ } | {
29
+ ok: false;
30
+ reason: 'unknown-op' | 'bad-op' | 'missing-target';
31
+ message: string;
32
+ };
33
+ /**
34
+ * Apply a remedy's operations to a copy of `input`.
35
+ *
36
+ * Refuses, without applying anything, when an operation is not in the
37
+ * vocabulary, is malformed, names a node or edge the workflow does not have, or
38
+ * addresses a payload key the editor does not know.
39
+ */
40
+ export declare function applyDoctorOperations(input: DoctorApplyInput, operations: unknown): DoctorApplyResult;
@@ -0,0 +1,237 @@
1
+ /**
2
+ * Maps the Doctor's remedy operations onto the editor's workflow.
3
+ *
4
+ * Pure: it never touches a store. `applyDoctorOperations` validates every
5
+ * operation first and applies them, in order, to a copy; it either answers the
6
+ * whole result or a refusal, so a remedy is never half applied. The caller then
7
+ * commits the result with ONE store update, which is one undo step.
8
+ *
9
+ * @module utils/doctorOperations
10
+ */
11
+ /** The workflow-level payload keys a `setWorkflowPayload` may address. */
12
+ const PAYLOAD_KEYS = ['playground'];
13
+ /**
14
+ * Deep copy of plain data. Works on Svelte `$state` proxies too, which
15
+ * `structuredClone` refuses.
16
+ */
17
+ function clone(value) {
18
+ if (Array.isArray(value))
19
+ return value.map(clone);
20
+ if (isObject(value)) {
21
+ const out = {};
22
+ for (const key of Object.keys(value))
23
+ out[key] = clone(value[key]);
24
+ return out;
25
+ }
26
+ return value;
27
+ }
28
+ const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
29
+ const isString = (value) => typeof value === 'string' && value !== '';
30
+ const isStringList = (value) => Array.isArray(value) && value.every((v) => typeof v === 'string');
31
+ /** `{patch, unset}` as the vocabulary sends them (`unset` may be left out). */
32
+ function patchOf(op) {
33
+ const patch = op.patch ?? {};
34
+ const unset = op.unset ?? [];
35
+ if (!isObject(patch) || !isStringList(unset))
36
+ return null;
37
+ return { patch, unset };
38
+ }
39
+ /** Whether an operation has the fields its kind needs. */
40
+ function isWellFormed(op) {
41
+ switch (op.op) {
42
+ case 'removeEdge':
43
+ return isString(op.edgeId);
44
+ case 'removeNode':
45
+ return isString(op.nodeId);
46
+ case 'addNode':
47
+ return isObject(op.node) && isString(op.node.id);
48
+ case 'addEdge':
49
+ return isObject(op.edge) && isString(op.edge.id);
50
+ case 'updateNodeConfig':
51
+ case 'updateNodeData':
52
+ case 'updateNode':
53
+ return isString(op.nodeId) && patchOf(op) !== null;
54
+ case 'updateEdge':
55
+ return isString(op.edgeId) && patchOf(op) !== null;
56
+ case 'setInterface':
57
+ return isObject(op.interface);
58
+ case 'setWorkflowPayload':
59
+ return isString(op.key);
60
+ default:
61
+ return false;
62
+ }
63
+ }
64
+ const KNOWN = new Set([
65
+ 'removeEdge',
66
+ 'removeNode',
67
+ 'addNode',
68
+ 'updateNodeConfig',
69
+ 'updateNodeData',
70
+ 'updateNode',
71
+ 'updateEdge',
72
+ 'addEdge',
73
+ 'setInterface',
74
+ 'setWorkflowPayload'
75
+ ]);
76
+ /** Index of an `#<n>` address (an item the draft carried without an id), else -1. */
77
+ function indexAddress(id) {
78
+ const match = /^#(\d+)$/.exec(id);
79
+ return match ? Number(match[1]) : -1;
80
+ }
81
+ function find(list, id) {
82
+ const at = indexAddress(id);
83
+ if (at !== -1)
84
+ return at < list.length ? at : -1;
85
+ return list.findIndex((item) => item.id === id);
86
+ }
87
+ function assign(target, { patch, unset }) {
88
+ for (const key of unset)
89
+ delete target[key];
90
+ Object.assign(target, patch);
91
+ }
92
+ /**
93
+ * Apply a remedy's operations to a copy of `input`.
94
+ *
95
+ * Refuses, without applying anything, when an operation is not in the
96
+ * vocabulary, is malformed, names a node or edge the workflow does not have, or
97
+ * addresses a payload key the editor does not know.
98
+ */
99
+ export function applyDoctorOperations(input, operations) {
100
+ if (!Array.isArray(operations)) {
101
+ return {
102
+ ok: false,
103
+ reason: 'bad-op',
104
+ message: 'The remedy did not answer a list of operations.'
105
+ };
106
+ }
107
+ // Validate all first: an unknown operation anywhere aborts the whole remedy.
108
+ for (const raw of operations) {
109
+ const name = isObject(raw) ? raw.op : undefined;
110
+ if (typeof name !== 'string' || !KNOWN.has(name)) {
111
+ return {
112
+ ok: false,
113
+ reason: 'unknown-op',
114
+ message: `Unknown operation "${String(name)}".`
115
+ };
116
+ }
117
+ if (!isWellFormed(raw)) {
118
+ return { ok: false, reason: 'bad-op', message: `Malformed operation "${name}".` };
119
+ }
120
+ }
121
+ // Copy on write: only a node or edge an operation touches is cloned, so the
122
+ // others keep their identity (the canvas does not re-measure them).
123
+ const nodes = [...input.nodes];
124
+ const edges = [...input.edges];
125
+ const ownNodes = new Set();
126
+ const ownEdges = new Set();
127
+ const ownNode = (at) => {
128
+ if (!ownNodes.has(nodes[at])) {
129
+ nodes[at] = clone(nodes[at]);
130
+ ownNodes.add(nodes[at]);
131
+ }
132
+ return nodes[at];
133
+ };
134
+ const ownEdge = (at) => {
135
+ if (!ownEdges.has(edges[at])) {
136
+ edges[at] = clone(edges[at]);
137
+ ownEdges.add(edges[at]);
138
+ }
139
+ return edges[at];
140
+ };
141
+ let next = undefined;
142
+ let playground = undefined;
143
+ const touched = { interface: false, playground: false };
144
+ const missing = (what, id) => ({
145
+ ok: false,
146
+ reason: 'missing-target',
147
+ message: `The workflow has no ${what} "${id}".`
148
+ });
149
+ for (const raw of operations) {
150
+ switch (raw.op) {
151
+ case 'removeEdge': {
152
+ const at = find(edges, raw.edgeId);
153
+ if (at === -1)
154
+ return missing('edge', raw.edgeId);
155
+ edges.splice(at, 1);
156
+ break;
157
+ }
158
+ case 'removeNode': {
159
+ const at = find(nodes, raw.nodeId);
160
+ if (at === -1)
161
+ return missing('node', raw.nodeId);
162
+ nodes.splice(at, 1);
163
+ break;
164
+ }
165
+ case 'addNode':
166
+ nodes.push(clone(raw.node));
167
+ break;
168
+ case 'addEdge':
169
+ edges.push(clone(raw.edge));
170
+ break;
171
+ case 'updateNodeConfig': {
172
+ const at = find(nodes, raw.nodeId);
173
+ if (at === -1)
174
+ return missing('node', raw.nodeId);
175
+ const node = ownNode(at);
176
+ const config = { ...node.data.config };
177
+ assign(config, patchOf(raw));
178
+ node.data = { ...node.data, config };
179
+ break;
180
+ }
181
+ case 'updateNodeData': {
182
+ const at = find(nodes, raw.nodeId);
183
+ if (at === -1)
184
+ return missing('node', raw.nodeId);
185
+ const node = ownNode(at);
186
+ const data = { ...node.data };
187
+ assign(data, patchOf(raw));
188
+ // `config` has its own operation; a data update never replaces it.
189
+ data.config = node.data.config;
190
+ node.data = data;
191
+ break;
192
+ }
193
+ case 'updateNode': {
194
+ const at = find(nodes, raw.nodeId);
195
+ if (at === -1)
196
+ return missing('node', raw.nodeId);
197
+ const node = ownNode(at);
198
+ const data = node.data;
199
+ assign(node, patchOf(raw));
200
+ // `data` has its own operations; a node update never replaces it.
201
+ node.data = data;
202
+ break;
203
+ }
204
+ case 'updateEdge': {
205
+ const at = find(edges, raw.edgeId);
206
+ if (at === -1)
207
+ return missing('edge', raw.edgeId);
208
+ assign(ownEdge(at), patchOf(raw));
209
+ break;
210
+ }
211
+ case 'setInterface':
212
+ next = clone(raw.interface);
213
+ touched.interface = true;
214
+ break;
215
+ case 'setWorkflowPayload': {
216
+ if (!PAYLOAD_KEYS.includes(raw.key)) {
217
+ return {
218
+ ok: false,
219
+ reason: 'bad-op',
220
+ message: `The editor does not know the workflow key "${raw.key}".`
221
+ };
222
+ }
223
+ playground = raw.value === null ? undefined : clone(raw.value);
224
+ touched.playground = true;
225
+ break;
226
+ }
227
+ }
228
+ }
229
+ return {
230
+ ok: true,
231
+ nodes,
232
+ edges,
233
+ ...(touched.interface && { interface: next }),
234
+ ...(touched.playground && { playground }),
235
+ touched
236
+ };
237
+ }