@flowdrop/flowdrop 2.13.0 → 2.14.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 (294) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/dist/commands/executor.js +58 -8
  3. package/dist/commands/parser.js +3 -3
  4. package/dist/commands/types.d.ts +2 -0
  5. package/dist/components/App.svelte +1 -1
  6. package/dist/components/App.svelte.d.ts +1 -1
  7. package/dist/components/Button.svelte +7 -7
  8. package/dist/components/Button.svelte.d.ts +10 -0
  9. package/dist/components/CanvasBanner.svelte +19 -6
  10. package/dist/components/CanvasBanner.svelte.d.ts +15 -3
  11. package/dist/components/CanvasContextMenu.svelte +9 -9
  12. package/dist/components/CanvasContextMenu.svelte.d.ts +10 -0
  13. package/dist/components/CanvasToolbar.svelte +8 -7
  14. package/dist/components/CanvasToolbar.svelte.d.ts +10 -0
  15. package/dist/components/CanvasZoomControls.svelte +10 -9
  16. package/dist/components/CanvasZoomControls.svelte.d.ts +13 -0
  17. package/dist/components/ConfigForm.svelte +9 -17
  18. package/dist/components/ConfigForm.svelte.d.ts +10 -0
  19. package/dist/components/ConfigPanel.svelte +9 -5
  20. package/dist/components/ConfigPanel.svelte.d.ts +10 -0
  21. package/dist/components/EditorStatusBar.svelte +6 -5
  22. package/dist/components/EditorStatusBar.svelte.d.ts +7 -0
  23. package/dist/components/FlowDropEdge.svelte +15 -12
  24. package/dist/components/FlowDropEdge.svelte.d.ts +16 -0
  25. package/dist/components/InterfaceTag.svelte +13 -15
  26. package/dist/components/InterfaceTag.svelte.d.ts +19 -0
  27. package/dist/components/LoadingSpinner.svelte +8 -2
  28. package/dist/components/LoadingSpinner.svelte.d.ts +9 -0
  29. package/dist/components/Logo.svelte +11 -0
  30. package/dist/components/Logo.svelte.d.ts +9 -0
  31. package/dist/components/LogoWordmark.svelte +8 -3
  32. package/dist/components/LogoWordmark.svelte.d.ts +9 -0
  33. package/dist/components/LoopbackLanes.svelte +12 -6
  34. package/dist/components/LoopbackLanes.svelte.d.ts +13 -0
  35. package/dist/components/MarkdownDisplay.svelte +10 -3
  36. package/dist/components/MarkdownDisplay.svelte.d.ts +11 -0
  37. package/dist/components/Navbar.svelte +13 -5
  38. package/dist/components/Navbar.svelte.d.ts +14 -0
  39. package/dist/components/NodeInspector.svelte +7 -8
  40. package/dist/components/NodeInspector.svelte.d.ts +10 -0
  41. package/dist/components/NodeSidebar.svelte +9 -3
  42. package/dist/components/NodeSidebar.svelte.d.ts +10 -0
  43. package/dist/components/NodeStatusOverlay.svelte +30 -19
  44. package/dist/components/NodeStatusOverlay.svelte.d.ts +19 -0
  45. package/dist/components/NodeSwapPicker.svelte +1 -1
  46. package/dist/components/RunBar.svelte +10 -13
  47. package/dist/components/RunBar.svelte.d.ts +15 -0
  48. package/dist/components/RunsMenu.svelte +14 -13
  49. package/dist/components/RunsMenu.svelte.d.ts +15 -0
  50. package/dist/components/SchemaForm.svelte +10 -13
  51. package/dist/components/SchemaForm.svelte.d.ts +51 -0
  52. package/dist/components/SettingsPanel.svelte +5 -5
  53. package/dist/components/StatusIcon.svelte +14 -3
  54. package/dist/components/StatusIcon.svelte.d.ts +15 -0
  55. package/dist/components/StatusLabel.svelte +10 -2
  56. package/dist/components/StatusLabel.svelte.d.ts +11 -0
  57. package/dist/components/ThemeToggle.svelte +8 -5
  58. package/dist/components/ThemeToggle.svelte.d.ts +10 -0
  59. package/dist/components/UniversalNode.svelte +13 -5
  60. package/dist/components/UniversalNode.svelte.d.ts +15 -0
  61. package/dist/components/WorkflowInterfaceEntryCard.svelte +1 -1
  62. package/dist/components/WorkflowInterfaceEntryComposer.svelte +1 -2
  63. package/dist/components/ZoomTier.svelte +13 -10
  64. package/dist/components/ZoomTier.svelte.d.ts +14 -0
  65. package/dist/components/console/CommandConsole.svelte +9 -3
  66. package/dist/components/console/CommandConsole.svelte.d.ts +10 -0
  67. package/dist/components/console/ConsoleAutocomplete.svelte +4 -4
  68. package/dist/components/console/ConsoleAutocomplete.svelte.d.ts +5 -0
  69. package/dist/components/console/ConsoleInput.svelte +6 -4
  70. package/dist/components/console/ConsoleInput.svelte.d.ts +7 -0
  71. package/dist/components/console/ConsoleOutput.svelte +5 -3
  72. package/dist/components/console/ConsoleOutput.svelte.d.ts +6 -0
  73. package/dist/components/console/ConsoleStrip.svelte +9 -5
  74. package/dist/components/console/ConsoleStrip.svelte.d.ts +10 -0
  75. package/dist/components/form/FieldFactory.svelte +6 -2
  76. package/dist/components/form/FieldFactory.svelte.d.ts +46 -0
  77. package/dist/components/form/FormArray.svelte +9 -16
  78. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  79. package/dist/components/form/FormArrayRows.svelte +8 -8
  80. package/dist/components/form/FormArrayRows.svelte.d.ts +11 -0
  81. package/dist/components/form/FormAutocomplete.svelte +6 -3
  82. package/dist/components/form/FormAutocomplete.svelte.d.ts +23 -0
  83. package/dist/components/form/FormCheckboxGroup.svelte +5 -5
  84. package/dist/components/form/FormCheckboxGroup.svelte.d.ts +6 -0
  85. package/dist/components/form/FormCodeEditor.svelte +8 -13
  86. package/dist/components/form/FormCodeEditor.svelte.d.ts +9 -0
  87. package/dist/components/form/FormField.svelte +7 -8
  88. package/dist/components/form/FormField.svelte.d.ts +10 -0
  89. package/dist/components/form/FormFieldLight.svelte +6 -5
  90. package/dist/components/form/FormFieldLight.svelte.d.ts +8 -0
  91. package/dist/components/form/FormFieldWrapper.svelte +8 -8
  92. package/dist/components/form/FormFieldWrapper.svelte.d.ts +9 -0
  93. package/dist/components/form/FormFieldset.svelte +6 -12
  94. package/dist/components/form/FormFieldset.svelte.d.ts +7 -0
  95. package/dist/components/form/FormMarkdownEditor.svelte +8 -15
  96. package/dist/components/form/FormMarkdownEditor.svelte.d.ts +9 -0
  97. package/dist/components/form/FormNumberField.svelte +5 -7
  98. package/dist/components/form/FormNumberField.svelte.d.ts +6 -0
  99. package/dist/components/form/FormPorts.svelte +133 -27
  100. package/dist/components/form/FormPorts.svelte.d.ts +19 -0
  101. package/dist/components/form/FormRangeField.svelte +5 -9
  102. package/dist/components/form/FormRangeField.svelte.d.ts +6 -0
  103. package/dist/components/form/FormSelect.svelte +5 -7
  104. package/dist/components/form/FormSelect.svelte.d.ts +6 -0
  105. package/dist/components/form/FormTemplateEditor.svelte +8 -16
  106. package/dist/components/form/FormTemplateEditor.svelte.d.ts +9 -0
  107. package/dist/components/form/FormTextField.svelte +5 -7
  108. package/dist/components/form/FormTextField.svelte.d.ts +6 -0
  109. package/dist/components/form/FormTextarea.svelte +5 -7
  110. package/dist/components/form/FormTextarea.svelte.d.ts +6 -0
  111. package/dist/components/form/FormToggle.svelte +6 -8
  112. package/dist/components/form/FormToggle.svelte.d.ts +7 -0
  113. package/dist/components/form/FormUISchemaRenderer.svelte +5 -9
  114. package/dist/components/form/FormUISchemaRenderer.svelte.d.ts +7 -0
  115. package/dist/components/interrupt/ChoicePrompt.svelte +6 -6
  116. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +7 -0
  117. package/dist/components/interrupt/ConfirmationPrompt.svelte +6 -5
  118. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +7 -0
  119. package/dist/components/interrupt/FormPrompt.svelte +6 -6
  120. package/dist/components/interrupt/FormPrompt.svelte.d.ts +7 -0
  121. package/dist/components/interrupt/InterruptBubble.svelte +10 -9
  122. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +11 -0
  123. package/dist/components/interrupt/ReviewPrompt.svelte +5 -6
  124. package/dist/components/interrupt/ReviewPrompt.svelte.d.ts +7 -0
  125. package/dist/components/interrupt/TextInputPrompt.svelte +6 -6
  126. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +7 -0
  127. package/dist/components/nodes/AtomNode.svelte +31 -6
  128. package/dist/components/nodes/AtomNode.svelte.d.ts +15 -0
  129. package/dist/components/nodes/CaptionNode.svelte +50 -7
  130. package/dist/components/nodes/CaptionNode.svelte.d.ts +13 -0
  131. package/dist/components/nodes/GatewayNode.svelte +18 -11
  132. package/dist/components/nodes/GatewayNode.svelte.d.ts +21 -0
  133. package/dist/components/nodes/IdeaNode.svelte +47 -6
  134. package/dist/components/nodes/IdeaNode.svelte.d.ts +17 -0
  135. package/dist/components/nodes/NodeCard.svelte +26 -18
  136. package/dist/components/nodes/NodeCard.svelte.d.ts +20 -0
  137. package/dist/components/nodes/NodeConfigButton.svelte +15 -2
  138. package/dist/components/nodes/NodeConfigButton.svelte.d.ts +11 -0
  139. package/dist/components/nodes/NodeProblemMark.svelte +15 -10
  140. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +16 -0
  141. package/dist/components/nodes/NodeTip.svelte +10 -7
  142. package/dist/components/nodes/NodeTip.svelte.d.ts +13 -0
  143. package/dist/components/nodes/NotesNode.svelte +30 -0
  144. package/dist/components/nodes/NotesNode.svelte.d.ts +14 -0
  145. package/dist/components/nodes/SimpleNode.svelte +35 -8
  146. package/dist/components/nodes/SimpleNode.svelte.d.ts +17 -0
  147. package/dist/components/nodes/SquareNode.svelte +38 -8
  148. package/dist/components/nodes/SquareNode.svelte.d.ts +17 -0
  149. package/dist/components/nodes/TerminalNode.svelte +24 -10
  150. package/dist/components/nodes/TerminalNode.svelte.d.ts +17 -0
  151. package/dist/components/nodes/ToolNode.svelte +14 -5
  152. package/dist/components/nodes/ToolNode.svelte.d.ts +15 -0
  153. package/dist/components/nodes/WorkflowNode.svelte +18 -15
  154. package/dist/components/nodes/WorkflowNode.svelte.d.ts +21 -0
  155. package/dist/components/playground/ChatBubble.svelte +4 -3
  156. package/dist/components/playground/ChatBubble.svelte.d.ts +5 -0
  157. package/dist/components/playground/ChatInput.svelte +11 -6
  158. package/dist/components/playground/ChatInput.svelte.d.ts +14 -0
  159. package/dist/components/playground/ChatPanel.svelte +15 -7
  160. package/dist/components/playground/ChatPanel.svelte.d.ts +17 -0
  161. package/dist/components/playground/ControlPanel.svelte +26 -9
  162. package/dist/components/playground/ControlPanel.svelte.d.ts +29 -0
  163. package/dist/components/playground/DockedPlayground.svelte +7 -10
  164. package/dist/components/playground/DockedPlayground.svelte.d.ts +10 -0
  165. package/dist/components/playground/ExecutionConsole.svelte +10 -5
  166. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  167. package/dist/components/playground/ExecutionList.svelte +13 -0
  168. package/dist/components/playground/ExecutionList.svelte.d.ts +11 -0
  169. package/dist/components/playground/ExecutionLogs.svelte +6 -9
  170. package/dist/components/playground/ExecutionLogs.svelte.d.ts +7 -0
  171. package/dist/components/playground/HeaderMenu.svelte +6 -8
  172. package/dist/components/playground/HeaderMenu.svelte.d.ts +9 -0
  173. package/dist/components/playground/HierarchyTrail.svelte +6 -6
  174. package/dist/components/playground/HierarchyTrail.svelte.d.ts +8 -0
  175. package/dist/components/playground/InputCollector.svelte +6 -5
  176. package/dist/components/playground/InputCollector.svelte.d.ts +7 -0
  177. package/dist/components/playground/InputFields.svelte +8 -12
  178. package/dist/components/playground/InputFields.svelte.d.ts +9 -0
  179. package/dist/components/playground/InterfaceInputForm.svelte +6 -13
  180. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +9 -0
  181. package/dist/components/playground/InterfaceJsonInput.svelte +6 -5
  182. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +8 -0
  183. package/dist/components/playground/LogRow.svelte +4 -5
  184. package/dist/components/playground/LogRow.svelte.d.ts +6 -0
  185. package/dist/components/playground/MessageBubble.svelte +13 -7
  186. package/dist/components/playground/MessageBubble.svelte.d.ts +15 -0
  187. package/dist/components/playground/MessageCard.svelte +5 -2
  188. package/dist/components/playground/MessageCard.svelte.d.ts +6 -0
  189. package/dist/components/playground/MessageMarkdown.svelte +8 -9
  190. package/dist/components/playground/MessageMarkdown.svelte.d.ts +11 -0
  191. package/dist/components/playground/MessageNotice.svelte +7 -0
  192. package/dist/components/playground/MessageNotice.svelte.d.ts +5 -0
  193. package/dist/components/playground/MessageStream.svelte +8 -6
  194. package/dist/components/playground/MessageStream.svelte.d.ts +11 -0
  195. package/dist/components/playground/MessageTagChip.svelte +7 -7
  196. package/dist/components/playground/MessageTagChip.svelte.d.ts +10 -0
  197. package/dist/components/playground/MessageTagStrip.svelte +6 -3
  198. package/dist/components/playground/MessageTagStrip.svelte.d.ts +8 -0
  199. package/dist/components/playground/OriginBadge.svelte +7 -4
  200. package/dist/components/playground/OriginBadge.svelte.d.ts +8 -0
  201. package/dist/components/playground/PipelineKanbanView.svelte +14 -0
  202. package/dist/components/playground/PipelineKanbanView.svelte.d.ts +12 -0
  203. package/dist/components/playground/PipelinePanel.svelte +14 -0
  204. package/dist/components/playground/PipelinePanel.svelte.d.ts +12 -0
  205. package/dist/components/playground/PipelineTableView.svelte +14 -0
  206. package/dist/components/playground/PipelineTableView.svelte.d.ts +12 -0
  207. package/dist/components/playground/Playground.svelte +17 -11
  208. package/dist/components/playground/Playground.svelte.d.ts +20 -0
  209. package/dist/components/playground/PlaygroundApp.svelte +24 -10
  210. package/dist/components/playground/PlaygroundApp.svelte.d.ts +26 -0
  211. package/dist/components/playground/PlaygroundHeader.svelte +8 -12
  212. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +11 -0
  213. package/dist/components/playground/PlaygroundModal.svelte +6 -8
  214. package/dist/components/playground/PlaygroundModal.svelte.d.ts +7 -0
  215. package/dist/components/playground/PlaygroundStudio.svelte +9 -0
  216. package/dist/components/playground/PlaygroundStudio.svelte.d.ts +7 -0
  217. package/dist/components/playground/PlaygroundSurface.svelte +19 -14
  218. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +20 -0
  219. package/dist/components/playground/SessionManager.svelte +6 -5
  220. package/dist/components/playground/SessionManager.svelte.d.ts +7 -0
  221. package/dist/components/playground/StepsSummary.svelte +8 -9
  222. package/dist/components/playground/StepsSummary.svelte.d.ts +10 -0
  223. package/dist/components/primitives/Button.svelte +15 -7
  224. package/dist/components/primitives/Button.svelte.d.ts +18 -1
  225. package/dist/components/primitives/Card.svelte +8 -6
  226. package/dist/components/primitives/Card.svelte.d.ts +11 -0
  227. package/dist/components/primitives/Checkbox.svelte +8 -5
  228. package/dist/components/primitives/Checkbox.svelte.d.ts +11 -0
  229. package/dist/components/primitives/Chip.svelte +8 -4
  230. package/dist/components/primitives/Chip.svelte.d.ts +11 -0
  231. package/dist/components/primitives/Combobox.svelte +27 -18
  232. package/dist/components/primitives/Combobox.svelte.d.ts +33 -0
  233. package/dist/components/primitives/Composer.svelte +15 -16
  234. package/dist/components/primitives/Composer.svelte.d.ts +20 -0
  235. package/dist/components/primitives/EmptyState.svelte +9 -3
  236. package/dist/components/primitives/EmptyState.svelte.d.ts +11 -0
  237. package/dist/components/primitives/Field.svelte +12 -9
  238. package/dist/components/primitives/Field.svelte.d.ts +16 -0
  239. package/dist/components/primitives/IconButton.svelte +10 -5
  240. package/dist/components/primitives/IconButton.svelte.d.ts +13 -0
  241. package/dist/components/primitives/Menu.svelte +15 -14
  242. package/dist/components/primitives/Menu.svelte.d.ts +20 -0
  243. package/dist/components/primitives/Notice.svelte +11 -8
  244. package/dist/components/primitives/Notice.svelte.d.ts +14 -0
  245. package/dist/components/primitives/PanelHeader.svelte +10 -7
  246. package/dist/components/primitives/PanelHeader.svelte.d.ts +13 -0
  247. package/dist/components/primitives/Segmented.svelte +11 -4
  248. package/dist/components/primitives/Segmented.svelte.d.ts +14 -0
  249. package/dist/components/primitives/Select.svelte +13 -16
  250. package/dist/components/primitives/Select.svelte.d.ts +18 -0
  251. package/dist/components/primitives/StatusPill.svelte +11 -8
  252. package/dist/components/primitives/StatusPill.svelte.d.ts +15 -0
  253. package/dist/components/primitives/Switch.svelte +9 -6
  254. package/dist/components/primitives/Switch.svelte.d.ts +12 -0
  255. package/dist/components/primitives/Tabs.svelte +16 -15
  256. package/dist/components/primitives/Tabs.svelte.d.ts +22 -0
  257. package/dist/components/primitives/Toolbar.svelte +14 -13
  258. package/dist/components/primitives/Toolbar.svelte.d.ts +18 -0
  259. package/dist/components/primitives/ToolbarSeparator.svelte +5 -4
  260. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  261. package/dist/core/index.d.ts +1 -1
  262. package/dist/core/index.js +1 -1
  263. package/dist/layout/index.d.ts +1 -1
  264. package/dist/layout/index.js +1 -1
  265. package/dist/layout/toWorkflow.d.ts +8 -7
  266. package/dist/layout/toWorkflow.js +20 -40
  267. package/dist/messages/defaults.d.ts +24 -0
  268. package/dist/messages/defaults.js +15 -0
  269. package/dist/skins/graphite.d.ts +1 -1
  270. package/dist/skins/graphite.js +1 -1
  271. package/dist/stores/settingsStore.svelte.js +3 -0
  272. package/dist/stores/workflowStore.svelte.js +24 -7
  273. package/dist/styles/base.css +2 -126
  274. package/dist/styles/tokenAliases.js +1 -0
  275. package/dist/styles/tokens.css +9 -5
  276. package/dist/svelte-app.d.ts +1 -1
  277. package/dist/themes/classic.d.ts +9 -0
  278. package/dist/themes/classic.js +16 -0
  279. package/dist/themes/index.d.ts +7 -2
  280. package/dist/themes/index.js +20 -10
  281. package/dist/types/index.d.ts +7 -0
  282. package/dist/types/settings.d.ts +6 -2
  283. package/dist/types/theme.d.ts +6 -2
  284. package/dist/utils/playgroundChat.d.ts +10 -0
  285. package/dist/utils/playgroundChat.js +25 -0
  286. package/dist/utils/portExposure.d.ts +24 -1
  287. package/dist/utils/portExposure.js +46 -13
  288. package/dist/utils/portUtils.d.ts +5 -1
  289. package/dist/utils/portUtils.js +15 -4
  290. package/package.json +2 -1
  291. package/dist/components/IconButton.svelte +0 -80
  292. package/dist/components/IconButton.svelte.d.ts +0 -30
  293. package/dist/themes/default.d.ts +0 -2
  294. package/dist/themes/default.js +0 -9
package/CHANGELOG.md CHANGED
@@ -5,6 +5,50 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [2.14.0] - 2026-10-16
9
+
10
+ ### Added
11
+
12
+ - **Console `clear --all`.** Removes everything `clear` does and also the workflow's interface and the
13
+ Playground chat settings.
14
+ - **`NodePort.exposureLocked`.** Port metadata for a node type that always shows a port: the instance
15
+ `ports` config can't hide it, and `exposedByDefault` is ignored for it. The Ports tab shows the port's
16
+ "on" eye with a lock badge and no toggle.
17
+
18
+ ### Changed
19
+
20
+ - **The "Default" theme is now called "Classic".** It was never the default: the editor opens in
21
+ Graphite. Its id is `'classic'` (`classicTheme`), and Settings → Theme lists Graphite first. A
22
+ settings snapshot or Drupal config that says `'default'` loads as `'classic'`, and
23
+ `resolveTheme('default')` still returns it.
24
+ - **Console `clear` keeps the interface.** Its entries stay, with their bindings dropped, and the Playground
25
+ replies are removed, all in one undo step.
26
+ - **A wired port can't be hidden in the Ports tab.** A shown port that still has connections keeps its eye,
27
+ with a link badge; activating it says to remove the connections on the canvas first. Locked ports use the
28
+ same eye with a lock badge. A port on the workflow interface can't be hidden either: its eye gets a tag
29
+ badge and says to remove it from the interface first.
30
+
31
+ ### Deprecated
32
+
33
+ - The theme name `'default'` and the `defaultTheme` export. Use `'classic'` and `classicTheme`;
34
+ the old names are removed in 3.0.
35
+
36
+ ### Removed
37
+
38
+ - **The `.flowdrop-btn--icon*` classes in `base.css`.** Every icon button in the library uses the
39
+ `IconButton` primitive, which has its own styles.
40
+
41
+ ### Fixed
42
+
43
+ - **Deleting a node drops the Playground replies that named it.** A workflow with such a reply was refused
44
+ when saved. The replies are dropped whichever way the node is removed (canvas, console, `clear`), and when
45
+ that empties the chat settings, the interface's old `turn` marks no longer take over as the chat.
46
+ - **"Hide unconnected ports" no longer counts a locked port.** A port the node type always shows is left
47
+ alone, as in the Ports tab.
48
+ - **Editing ports keeps entries for ports the node doesn't have.** The Ports tab and bulk Show/Hide used to
49
+ drop a stored `ports` entry whose port the node type no longer lists; they now keep it, as Tidy up already
50
+ did. All three write `ports` the same way.
51
+
8
52
  ## [2.13.0] - 2026-10-14
9
53
 
10
54
  ### Added
@@ -15,6 +15,7 @@ import { applyConnectionStyling } from '../utils/edgeStyling.js';
15
15
  import { computeSwapPreview, executeSwap } from '../utils/nodeSwap.js';
16
16
  import { computeAutoLayout } from '../adapters/agentspec/autoLayout.js';
17
17
  import { interfaceTagReserve } from '../utils/interfaceTags.js';
18
+ import { normalizePlaygroundChat, withPlaygroundChat } from '../utils/playgroundChat.js';
18
19
  // ============================================================================
19
20
  // Internal Helpers
20
21
  // ============================================================================
@@ -1011,7 +1012,11 @@ export const COMMAND_HELP = [
1011
1012
  syntax: 'help [<command>]',
1012
1013
  description: 'Show help for all or a specific command'
1013
1014
  },
1014
- { name: 'clear', syntax: 'clear', description: 'Remove all nodes and edges' },
1015
+ {
1016
+ name: 'clear',
1017
+ syntax: 'clear [--all]',
1018
+ description: 'Remove all nodes and edges; the interface stays, unbound. --all also removes the interface and the Playground chat settings'
1019
+ },
1015
1020
  {
1016
1021
  name: 'canvas',
1017
1022
  syntax: 'canvas fitview',
@@ -1089,18 +1094,63 @@ function executeRedo(context) {
1089
1094
  }
1090
1095
  return { ok: true, message: 'Redone' };
1091
1096
  }
1092
- function executeClear(context) {
1097
+ /**
1098
+ * Empty the canvas. The interface is the workflow's contract and outlives its
1099
+ * body, so plain `clear` keeps every entry and only unbinds it (the store drops
1100
+ * the Playground replies on the removed nodes). `clear --all` removes the
1101
+ * interface and the Playground chat settings too. Either is one undo step.
1102
+ */
1103
+ function executeClear(command, context) {
1093
1104
  const workflow = context.getWorkflow();
1094
1105
  if (!workflow) {
1095
1106
  return { ok: false, error: 'No workflow loaded', code: 'NO_WORKFLOW' };
1096
1107
  }
1097
1108
  const nodeCount = workflow.nodes.length;
1098
1109
  const edgeCount = workflow.edges.length;
1099
- context.dispatch.batchUpdate({ nodes: [], edges: [] });
1100
- return {
1101
- ok: true,
1102
- message: `Cleared ${nodeCount} node(s) and ${edgeCount} edge(s)`
1103
- };
1110
+ const cleared = `Cleared ${nodeCount} node(s) and ${edgeCount} edge(s)`;
1111
+ const inputs = workflow.interface?.inputs ?? [];
1112
+ const outputs = workflow.interface?.outputs ?? [];
1113
+ if (command.all) {
1114
+ const hadInterface = inputs.length + outputs.length > 0;
1115
+ const hadChat = Boolean(workflow.playground?.chat);
1116
+ context.dispatch.batchUpdate({
1117
+ nodes: [],
1118
+ edges: [],
1119
+ // An empty contract, not `undefined`: a save omits an absent interface,
1120
+ // and the server would keep the stored one.
1121
+ ...(hadInterface && { interface: { inputs: [], outputs: [] } }),
1122
+ ...(hadChat && { playground: withPlaygroundChat(workflow.playground, null) })
1123
+ });
1124
+ const also = [hadInterface && 'the interface', hadChat && 'the Playground chat settings'];
1125
+ const extra = also.filter(Boolean).join(' and ');
1126
+ return { ok: true, message: extra ? `${cleared}, and removed ${extra}` : cleared };
1127
+ }
1128
+ const unbind = (entry) => entry.bindings.length === 0 ? entry : { ...entry, bindings: [] };
1129
+ const bound = [...inputs, ...outputs].some((entry) => entry.bindings.length > 0);
1130
+ // The store drops the Playground replies on the removed nodes.
1131
+ const hadReplies = normalizePlaygroundChat(workflow.playground?.chat).replies.length > 0;
1132
+ context.dispatch.batchUpdate({
1133
+ nodes: [],
1134
+ edges: [],
1135
+ ...(bound && {
1136
+ interface: {
1137
+ ...workflow.interface,
1138
+ ...(workflow.interface?.inputs && { inputs: workflow.interface.inputs.map(unbind) }),
1139
+ ...(workflow.interface?.outputs && { outputs: workflow.interface.outputs.map(unbind) })
1140
+ }
1141
+ })
1142
+ });
1143
+ const notes = [];
1144
+ const kept = inputs.length + outputs.length > 0;
1145
+ if (kept) {
1146
+ notes.push(`Kept the interface (${inputs.length} input(s), ${outputs.length} output(s))` +
1147
+ (bound ? ', now unbound' : ''));
1148
+ }
1149
+ if (hadReplies)
1150
+ notes.push('Dropped the Playground replies');
1151
+ if (kept)
1152
+ notes.push('`clear --all` removes the interface too');
1153
+ return { ok: true, message: [cleared, ...notes].join('. ') };
1104
1154
  }
1105
1155
  function executeConfigOpen(command, context) {
1106
1156
  const workflow = context.getWorkflow();
@@ -1570,7 +1620,7 @@ export function executeCommand(command, context) {
1570
1620
  case 'redo':
1571
1621
  return executeRedo(context);
1572
1622
  case 'clear':
1573
- return executeClear(context);
1623
+ return executeClear(command, context);
1574
1624
  case 'config_open':
1575
1625
  return executeConfigOpen(command, context);
1576
1626
  case 'select_node':
@@ -223,10 +223,10 @@ const rules = [
223
223
  pattern: /^help$/i,
224
224
  parse: () => ({ type: 'help' })
225
225
  },
226
- // clear
226
+ // clear [--all]
227
227
  {
228
- pattern: /^clear$/i,
229
- parse: () => ({ type: 'clear' })
228
+ pattern: /^clear(\s+--all)?$/i,
229
+ parse: (m) => (m[1] ? { type: 'clear', all: true } : { type: 'clear' })
230
230
  },
231
231
  // swap <nodeId> with <type> (Phase 2)
232
232
  {
@@ -101,6 +101,8 @@ export interface HelpCommand {
101
101
  }
102
102
  export interface ClearCommand {
103
103
  type: 'clear';
104
+ /** Also remove the interface and the Playground chat settings. */
105
+ all?: boolean;
104
106
  }
105
107
  /** Phase 2 commands */
106
108
  export interface SwapNodeCommand {
@@ -216,7 +216,7 @@
216
216
  onAfterSwap?: FlowDropEventHandlers['onAfterSwap'];
217
217
  /** Feature configuration */
218
218
  features?: FlowDropFeatures;
219
- /** Visual theme — named built-in ('default' | 'minimal') or custom theme object */
219
+ /** Visual theme — named built-in ('graphite' | 'classic' | 'minimal' | 'drafter') or custom theme object */
220
220
  theme?: FlowDropTheme | FlowDropThemeName;
221
221
  /** Which settings tabs to show in the modal */
222
222
  settingsCategories?: SettingsCategory[];
@@ -130,7 +130,7 @@ interface Props {
130
130
  onAfterSwap?: FlowDropEventHandlers['onAfterSwap'];
131
131
  /** Feature configuration */
132
132
  features?: FlowDropFeatures;
133
- /** Visual theme — named built-in ('default' | 'minimal') or custom theme object */
133
+ /** Visual theme — named built-in ('graphite' | 'classic' | 'minimal' | 'drafter') or custom theme object */
134
134
  theme?: FlowDropTheme | FlowDropThemeName;
135
135
  /** Which settings tabs to show in the modal */
136
136
  settingsCategories?: SettingsCategory[];
@@ -1,13 +1,13 @@
1
1
  <!--
2
- Button — typed wrapper over the Button primitive (`primitives/Button.svelte`).
2
+ @component
3
+ **Legacy.** Use the primitive Button (`components/primitives/Button.svelte`) instead.
3
4
 
4
- Keeps the original public prop API (variants primary/secondary/outline/ghost,
5
- sizes sm/md/lg) so existing callers are untouched; everything maps onto the
6
- primitive: outline -> secondary (bordered surface), lg -> md. Heights are
7
- now the control tokens (sm 24px, md 28px), not the old 28/40/48.
5
+ A thin wrapper over the primitive that keeps the original prop API. It maps onto the
6
+ primitive: `outline` becomes `secondary`, and `lg` becomes `md`. So Outline looks the same
7
+ as Secondary, and Large the same as Medium. Heights are the control tokens (sm 24px, md 28px).
8
8
 
9
- Internal for now (not exported from any public entry) so the API isn't frozen
10
- before GA. New code should use the primitive directly.
9
+ Not exported from the package. New code should use the primitive, which also has `loading`,
10
+ icons and the `danger` variants.
11
11
  -->
12
12
 
13
13
  <script lang="ts">
@@ -19,6 +19,16 @@ interface Props {
19
19
  /** Button contents (icon, label, or both) */
20
20
  children: Snippet;
21
21
  }
22
+ /**
23
+ * **Legacy.** Use the primitive Button (`components/primitives/Button.svelte`) instead.
24
+ *
25
+ * A thin wrapper over the primitive that keeps the original prop API. It maps onto the
26
+ * primitive: `outline` becomes `secondary`, and `lg` becomes `md`. So Outline looks the same
27
+ * as Secondary, and Large the same as Medium. Heights are the control tokens (sm 24px, md 28px).
28
+ *
29
+ * Not exported from the package. New code should use the primitive, which also has `loading`,
30
+ * icons and the `danger` variants.
31
+ */
22
32
  declare const Button: import("svelte").Component<Props, {}, "">;
23
33
  type Button = ReturnType<typeof Button>;
24
34
  export default Button;
@@ -1,14 +1,27 @@
1
+ <!--
2
+ @component
3
+ The message in the middle of an empty canvas: an icon, a title and a line of help.
4
+
5
+ It fills the canvas and lets clicks through, so the canvas under it still takes drops. The editor shows it
6
+ while the workflow has no nodes and removes it with the first node.
7
+
8
+ **Use it for** telling a person what to do on a canvas with nothing on it.
9
+ **Not for** errors or progress (use `EditorStatusBar` or a notice).
10
+ -->
11
+
1
12
  <script lang="ts">
2
13
  import type { Snippet } from 'svelte';
3
- let {
4
- title,
5
- description,
6
- icon
7
- }: {
14
+
15
+ interface Props {
16
+ /** The headline, for example "Drag components here to start building". */
8
17
  title: string;
18
+ /** One line of help under the title. */
9
19
  description: string;
20
+ /** The icon above the title. Nothing is drawn when it is left out. */
10
21
  icon?: Snippet;
11
- } = $props();
22
+ }
23
+
24
+ let { title, description, icon }: Props = $props();
12
25
  </script>
13
26
 
14
27
  <div class="flowdrop-canvas-banner">
@@ -1,9 +1,21 @@
1
1
  import type { Snippet } from 'svelte';
2
- type $$ComponentProps = {
2
+ interface Props {
3
+ /** The headline, for example "Drag components here to start building". */
3
4
  title: string;
5
+ /** One line of help under the title. */
4
6
  description: string;
7
+ /** The icon above the title. Nothing is drawn when it is left out. */
5
8
  icon?: Snippet;
6
- };
7
- declare const CanvasBanner: import("svelte").Component<$$ComponentProps, {}, "">;
9
+ }
10
+ /**
11
+ * The message in the middle of an empty canvas: an icon, a title and a line of help.
12
+ *
13
+ * It fills the canvas and lets clicks through, so the canvas under it still takes drops. The editor shows it
14
+ * while the workflow has no nodes and removes it with the first node.
15
+ *
16
+ * **Use it for** telling a person what to do on a canvas with nothing on it.
17
+ * **Not for** errors or progress (use `EditorStatusBar` or a notice).
18
+ */
19
+ declare const CanvasBanner: import("svelte").Component<Props, {}, "">;
8
20
  type CanvasBanner = ReturnType<typeof CanvasBanner>;
9
21
  export default CanvasBanner;
@@ -1,13 +1,13 @@
1
1
  <!--
2
- CanvasContextMenu Component
3
- The editor's right-click / Shift+F10 menu. Renders already-resolved entries
4
- (see editor/contextMenu.ts) as an ARIA menu positioned at the pointer and
5
- clamped inside the viewport. It is a manual popover, so it sits in the top
6
- layer and no ancestor's overflow or stacking context can clip or cover it;
7
- that is also why it is positioned in viewport coordinates. A manual popover
8
- does not light-dismiss, so it closes itself on outside pointerdown, wheel
9
- (zoom/pan), window blur, Escape, and after an entry runs.
10
- Styled with BEM syntax.
2
+ @component
3
+ The right-click menu of the canvas (also Shift+F10). It draws entries that are already resolved
4
+ (see `editor/contextMenu.ts`) as an ARIA menu at the pointer, kept inside the window.
5
+
6
+ It is a manual popover, so it sits above everything and no parent can clip it. For that reason it uses
7
+ window coordinates. It closes on a click elsewhere, wheel, window blur, Escape, and after an entry runs.
8
+
9
+ **Use it for** actions on a node, a selection or the empty canvas.
10
+ **Not for** menus that hang off a button (use the `Menu` primitive).
11
11
  -->
12
12
 
13
13
  <script lang="ts">
@@ -11,6 +11,16 @@ interface Props {
11
11
  /** Close without running anything. */
12
12
  onclose: () => void;
13
13
  }
14
+ /**
15
+ * The right-click menu of the canvas (also Shift+F10). It draws entries that are already resolved
16
+ * (see `editor/contextMenu.ts`) as an ARIA menu at the pointer, kept inside the window.
17
+ *
18
+ * It is a manual popover, so it sits above everything and no parent can clip it. For that reason it uses
19
+ * window coordinates. It closes on a click elsewhere, wheel, window blur, Escape, and after an entry runs.
20
+ *
21
+ * **Use it for** actions on a node, a selection or the empty canvas.
22
+ * **Not for** menus that hang off a button (use the `Menu` primitive).
23
+ */
14
24
  declare const CanvasContextMenu: import("svelte").Component<Props, {}, "">;
15
25
  type CanvasContextMenu = ReturnType<typeof CanvasContextMenu>;
16
26
  export default CanvasContextMenu;
@@ -1,12 +1,13 @@
1
1
  <!--
2
- CanvasToolbar — the top-left canvas toolbar: Edit | Test, the Runs list (Test
3
- mode) and the run pill.
4
- (The Console toggle is a strip along the canvas's bottom edge, ConsoleStrip.)
2
+ @component
3
+ The floating toolbar in the top-left corner of the canvas: the Edit | Test switch, the Runs list and the run pill.
5
4
 
6
- Replaces the navbar's Edit | Test switch, the dot on "Test" and the Edit-mode
7
- run bar's top-edge notch. Each group renders only when its prop is given:
8
- the mode switch needs `onEditorModeChange`. Without it and with no live
9
- run the toolbar is not drawn.
5
+ Each group draws only when its prop is given. The switch needs `onEditorModeChange`;
6
+ the Runs list needs `showRuns` (the host turns it on in Test mode); the pill shows while the instance has a run.
7
+ With no switch and no run, the toolbar is not drawn at all.
8
+
9
+ **Use it for** switching between building and testing, and for seeing the run at a glance.
10
+ **Not for** the Console toggle (that is `ConsoleStrip`, along the bottom edge) or the zoom buttons (`CanvasZoomControls`).
10
11
  -->
11
12
 
12
13
  <script lang="ts">
@@ -18,6 +18,16 @@ interface Props {
18
18
  run?: string;
19
19
  };
20
20
  }
21
+ /**
22
+ * The floating toolbar in the top-left corner of the canvas: the Edit | Test switch, the Runs list and the run pill.
23
+ *
24
+ * Each group draws only when its prop is given. The switch needs `onEditorModeChange`;
25
+ * the Runs list needs `showRuns` (the host turns it on in Test mode); the pill shows while the instance has a run.
26
+ * With no switch and no run, the toolbar is not drawn at all.
27
+ *
28
+ * **Use it for** switching between building and testing, and for seeing the run at a glance.
29
+ * **Not for** the Console toggle (that is `ConsoleStrip`, along the bottom edge) or the zoom buttons (`CanvasZoomControls`).
30
+ */
21
31
  declare const CanvasToolbar: import("svelte").Component<Props, {}, "">;
22
32
  type CanvasToolbar = ReturnType<typeof CanvasToolbar>;
23
33
  export default CanvasToolbar;
@@ -1,17 +1,18 @@
1
1
  <!--
2
- CanvasZoomControls
2
+ @component
3
+ The corner control of the canvas: zoom in, zoom out, fit the view, lock, the "Tidy up" broom (when the canvas
4
+ offers it) and a read-only count of what is on the canvas ("6 nodes").
3
5
 
4
- The canvas's zoom / fit / lock buttons, the "Tidy up" broom (when the canvas offers it), and a
5
- read-only count of what is on the
6
- canvas ("6 nodes") beside them. The count replaced the editor's status bar; the
7
- full "6 nodes · 6 connections" is its title and accessible name. A cycle warning,
8
- also formerly in the status bar, appears next to the count when the graph loops.
6
+ The full "6 nodes · 6 connections" is the count's title and accessible name. A cycle warning appears next to the
7
+ count when the graph loops. When the WebMCP desktop bridge is installed and offers tools, its button is the
8
+ group's last segment, behind a divider (`WebMCPBridgeMenu`).
9
9
 
10
- When the WebMCP desktop bridge is installed and offers tools, its button is the group's last
11
- segment, behind a divider (WebMCPBridgeMenu): one island for the corner.
10
+ Must render inside `<SvelteFlow>`: it reads xyflow's store.
12
11
 
13
- Must render inside <SvelteFlow>: xyflow's Controls reads the flow store.
12
+ **Use it for** moving around the canvas.
13
+ **Not for** switching Edit | Test (that is `CanvasToolbar`).
14
14
  -->
15
+
15
16
  <script lang="ts">
16
17
  import { ControlButton, Controls, Panel, useStore } from '@xyflow/svelte';
17
18
  import Icon from '@iconify/svelte';
@@ -10,6 +10,19 @@ interface Props {
10
10
  /** Tidy up the whole graph. No broom without it (read-only canvas). */
11
11
  ontidy?: () => void;
12
12
  }
13
+ /**
14
+ * The corner control of the canvas: zoom in, zoom out, fit the view, lock, the "Tidy up" broom (when the canvas
15
+ * offers it) and a read-only count of what is on the canvas ("6 nodes").
16
+ *
17
+ * The full "6 nodes · 6 connections" is the count's title and accessible name. A cycle warning appears next to the
18
+ * count when the graph loops. When the WebMCP desktop bridge is installed and offers tools, its button is the
19
+ * group's last segment, behind a divider (`WebMCPBridgeMenu`).
20
+ *
21
+ * Must render inside `<SvelteFlow>`: it reads xyflow's store.
22
+ *
23
+ * **Use it for** moving around the canvas.
24
+ * **Not for** switching Edit | Test (that is `CanvasToolbar`).
25
+ */
13
26
  declare const CanvasZoomControls: import("svelte").Component<Props, {}, "">;
14
27
  type CanvasZoomControls = ReturnType<typeof CanvasZoomControls>;
15
28
  export default CanvasZoomControls;
@@ -1,21 +1,13 @@
1
1
  <!--
2
- ConfigForm Component
3
- Handles dynamic form rendering for node or entity configuration
4
- Supports both node-based config and direct schema/values
5
- Uses reactive $state for proper Svelte 5 reactivity
6
-
7
- Features:
8
- - Dynamic form generation from JSON Schema using modular form components
9
- - Node-level settings the editor contributes for every node (port order +
10
- exposure), rendered even when the node type declares no config schema
11
- - Extensible architecture for complex schema types (array, object)
12
- - Admin/Edit support for external configuration links and dynamic schema fetching
13
-
14
- Accessibility features:
15
- - Proper label associations with for/id attributes
16
- - ARIA describedby for field descriptions
17
- - Focus-visible states for keyboard navigation
18
- - Required field indicators
2
+ @component
3
+ The form for one node's configuration. It draws the fields from the node type's `configSchema` (or a fetched schema),
4
+ adds the settings every node has (port order and exposure), splits them into the inspector's Config, Ports and Execution tabs,
5
+ and reports edits through `onChange`.
6
+
7
+ It can also run on its own with a direct `schema` and `values`. It shows an external edit link, or fetches its schema, when the node type asks for it.
8
+
9
+ **Use it for** editing a node, inside `NodeInspector`.
10
+ **Not for** a plain schema with no node (use `SchemaForm`).
19
11
  -->
20
12
 
21
13
  <script lang="ts">
@@ -56,6 +56,16 @@ interface Props {
56
56
  /** Callback when form is cancelled */
57
57
  onCancel?: () => void;
58
58
  }
59
+ /**
60
+ * The form for one node's configuration. It draws the fields from the node type's `configSchema` (or a fetched schema),
61
+ * adds the settings every node has (port order and exposure), splits them into the inspector's Config, Ports and Execution tabs,
62
+ * and reports edits through `onChange`.
63
+ *
64
+ * It can also run on its own with a direct `schema` and `values`. It shows an external edit link, or fetches its schema, when the node type asks for it.
65
+ *
66
+ * **Use it for** editing a node, inside `NodeInspector`.
67
+ * **Not for** a plain schema with no node (use `SchemaForm`).
68
+ */
59
69
  declare const ConfigForm: import("svelte").Component<Props, {}, "">;
60
70
  type ConfigForm = ReturnType<typeof ConfigForm>;
61
71
  export default ConfigForm;
@@ -1,9 +1,13 @@
1
1
  <!--
2
- ConfigPanel Component
3
- A generic panel for displaying details and configuration
4
- Can be used for node config, workflow settings, or any entity with an ID
5
- Accepts a slot for custom form content
6
- Styled with BEM syntax
2
+ @component
3
+ The right-hand panel of the editor: a header with the title, id and close button, a few read-only details,
4
+ and the content you pass in as children.
5
+
6
+ For a node, the children are the `NodeInspector` with the node's config form. The same panel also hosts
7
+ workflow settings and any other entity that has an id.
8
+
9
+ **Use it for** showing one thing the person selected and letting them edit it.
10
+ **Not for** the form itself (use `ConfigForm` for a node, `SchemaForm` for a plain schema).
7
11
  -->
8
12
 
9
13
  <script lang="ts">
@@ -35,6 +35,16 @@ interface Props {
35
35
  /** Slot content for the configuration form */
36
36
  children?: Snippet;
37
37
  }
38
+ /**
39
+ * The right-hand panel of the editor: a header with the title, id and close button, a few read-only details,
40
+ * and the content you pass in as children.
41
+ *
42
+ * For a node, the children are the `NodeInspector` with the node's config form. The same panel also hosts
43
+ * workflow settings and any other entity that has an id.
44
+ *
45
+ * **Use it for** showing one thing the person selected and letting them edit it.
46
+ * **Not for** the form itself (use `ConfigForm` for a node, `SchemaForm` for a plain schema).
47
+ */
38
48
  declare const ConfigPanel: import("svelte").Component<Props, {}, "">;
39
49
  type ConfigPanel = ReturnType<typeof ConfigPanel>;
40
50
  export default ConfigPanel;
@@ -1,11 +1,12 @@
1
1
  <!--
2
- EditorStatusBar — the dismissible error banner shown above the editor canvas
3
- when node types fail to load (endpoint missing or unreachable).
2
+ @component
3
+ A red banner above the canvas that says the editor could not load its node types
4
+ (the endpoint is missing or unreachable). It offers Retry, Set API URL, Test API and Dismiss.
4
5
 
5
- Extracted from App.svelte so it can be storied/tested in isolation. The action
6
- buttons route through the shared Button primitive; all colours come from design
7
- tokens, so the banner stays in sync with the rest of the editor chrome.
6
+ **Use it for** a failed node-type load. The person sees it as soon as the editor opens without a working backend.
7
+ **Not for** errors in a single run or a single node (those show on the node and in Test mode).
8
8
  -->
9
+
9
10
  <script lang="ts">
10
11
  import Button from './Button.svelte';
11
12
  import CloseIcon from './icons/CloseIcon.svelte';
@@ -10,6 +10,13 @@ interface Props {
10
10
  /** Dismiss the banner. */
11
11
  onDismiss: () => void;
12
12
  }
13
+ /**
14
+ * A red banner above the canvas that says the editor could not load its node types
15
+ * (the endpoint is missing or unreachable). It offers Retry, Set API URL, Test API and Dismiss.
16
+ *
17
+ * **Use it for** a failed node-type load. The person sees it as soon as the editor opens without a working backend.
18
+ * **Not for** errors in a single run or a single node (those show on the node and in Test mode).
19
+ */
13
20
  declare const EditorStatusBar: import("svelte").Component<Props, {}, "">;
14
21
  type EditorStatusBar = ReturnType<typeof EditorStatusBar>;
15
22
  export default EditorStatusBar;
@@ -1,16 +1,19 @@
1
1
  <!--
2
- FlowDropEdge Component
3
- Custom bezier edge that draws its own arrowhead so the line stroke ends
4
- at the arrow base instead of poking through to the tip.
5
-
6
- Approach:
7
- 1. Compute the full bezier path (xyflow's getBezierPath)
8
- 2. Parse the SVG path to extract the cubic bezier control points
9
- 3. Compute exact tangent at endpoint via bezier derivative P'(1) = 3(P3-P2)
10
- 4. Shorten the path along that tangent and draw the arrowhead at the target
11
-
12
- With the loopback lanes setting on, a loopback that has a lane in
13
- fd.loopbackLanes is drawn along it instead (rounded corners, same arrowhead).
2
+ @component
3
+ The wire between two ports: a bezier curve that draws its own arrowhead, so the stroke ends
4
+ at the arrow base and does not poke through the tip.
5
+
6
+ It computes the full bezier path, takes the control points from it, finds the exact
7
+ tangent at the end (P'(1) = 3(P3 - P2)), shortens the path along it and draws the arrowhead
8
+ at the target. A loopback that has a return lane in `fd.loopbackLanes` is drawn along the
9
+ lane instead, with rounded corners and the same arrowhead.
10
+
11
+ A wire is hot, drawn in the success colour, when the shown run passed it (see
12
+ `utils/runEdges.ts`). The colour of a wire comes from its category (trigger, tool, loopback
13
+ or data), set when the connection is made (`utils/edgeStyling.ts`).
14
+
15
+ **Use it for** the edge type of the canvas (`edgeTypes.default`).
16
+ **Not for** the line you drag while connecting; that is `ConnectionLine`.
14
17
  -->
15
18
 
16
19
  <script lang="ts">
@@ -3,6 +3,22 @@ type $$ComponentProps = BezierEdgeProps & {
3
3
  source?: string;
4
4
  target?: string;
5
5
  };
6
+ /**
7
+ * The wire between two ports: a bezier curve that draws its own arrowhead, so the stroke ends
8
+ * at the arrow base and does not poke through the tip.
9
+ *
10
+ * It computes the full bezier path, takes the control points from it, finds the exact
11
+ * tangent at the end (P'(1) = 3(P3 - P2)), shortens the path along it and draws the arrowhead
12
+ * at the target. A loopback that has a return lane in `fd.loopbackLanes` is drawn along the
13
+ * lane instead, with rounded corners and the same arrowhead.
14
+ *
15
+ * A wire is hot, drawn in the success colour, when the shown run passed it (see
16
+ * `utils/runEdges.ts`). The colour of a wire comes from its category (trigger, tool, loopback
17
+ * or data), set when the connection is made (`utils/edgeStyling.ts`).
18
+ *
19
+ * **Use it for** the edge type of the canvas (`edgeTypes.default`).
20
+ * **Not for** the line you drag while connecting; that is `ConnectionLine`.
21
+ */
6
22
  declare const FlowDropEdge: import("svelte").Component<$$ComponentProps, {}, "">;
7
23
  type FlowDropEdge = ReturnType<typeof FlowDropEdge>;
8
24
  export default FlowDropEdge;