@flowdrop/flowdrop 2.13.0 → 2.15.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 (308) hide show
  1. package/CHANGELOG.md +82 -0
  2. package/dist/commands/executor.js +58 -8
  3. package/dist/commands/parser.js +3 -3
  4. package/dist/commands/types.d.ts +8 -2
  5. package/dist/commands/uiActionTarget.d.ts +24 -0
  6. package/dist/commands/uiActionTarget.js +31 -0
  7. package/dist/commands/validate.d.ts +15 -0
  8. package/dist/commands/validate.js +115 -0
  9. package/dist/components/App.svelte +44 -2
  10. package/dist/components/App.svelte.d.ts +3 -1
  11. package/dist/components/Button.svelte +7 -7
  12. package/dist/components/Button.svelte.d.ts +10 -0
  13. package/dist/components/CanvasBanner.svelte +19 -6
  14. package/dist/components/CanvasBanner.svelte.d.ts +15 -3
  15. package/dist/components/CanvasContextMenu.svelte +9 -9
  16. package/dist/components/CanvasContextMenu.svelte.d.ts +10 -0
  17. package/dist/components/CanvasToolbar.svelte +8 -7
  18. package/dist/components/CanvasToolbar.svelte.d.ts +10 -0
  19. package/dist/components/CanvasZoomControls.svelte +10 -9
  20. package/dist/components/CanvasZoomControls.svelte.d.ts +13 -0
  21. package/dist/components/ConfigForm.svelte +51 -18
  22. package/dist/components/ConfigForm.svelte.d.ts +20 -1
  23. package/dist/components/ConfigPanel.svelte +9 -5
  24. package/dist/components/ConfigPanel.svelte.d.ts +10 -0
  25. package/dist/components/EditorStatusBar.svelte +6 -5
  26. package/dist/components/EditorStatusBar.svelte.d.ts +7 -0
  27. package/dist/components/ExternalLinkRow.svelte +16 -1
  28. package/dist/components/ExternalLinkRow.svelte.d.ts +5 -0
  29. package/dist/components/FlowDropEdge.svelte +15 -12
  30. package/dist/components/FlowDropEdge.svelte.d.ts +16 -0
  31. package/dist/components/InterfaceTag.svelte +13 -15
  32. package/dist/components/InterfaceTag.svelte.d.ts +19 -0
  33. package/dist/components/LoadingSpinner.svelte +8 -2
  34. package/dist/components/LoadingSpinner.svelte.d.ts +9 -0
  35. package/dist/components/Logo.svelte +11 -0
  36. package/dist/components/Logo.svelte.d.ts +9 -0
  37. package/dist/components/LogoWordmark.svelte +8 -3
  38. package/dist/components/LogoWordmark.svelte.d.ts +9 -0
  39. package/dist/components/LoopbackLanes.svelte +12 -6
  40. package/dist/components/LoopbackLanes.svelte.d.ts +13 -0
  41. package/dist/components/MarkdownDisplay.svelte +10 -3
  42. package/dist/components/MarkdownDisplay.svelte.d.ts +11 -0
  43. package/dist/components/Navbar.svelte +13 -5
  44. package/dist/components/Navbar.svelte.d.ts +14 -0
  45. package/dist/components/NodeInspector.svelte +7 -8
  46. package/dist/components/NodeInspector.svelte.d.ts +10 -0
  47. package/dist/components/NodeSidebar.svelte +9 -3
  48. package/dist/components/NodeSidebar.svelte.d.ts +10 -0
  49. package/dist/components/NodeStatusOverlay.svelte +30 -19
  50. package/dist/components/NodeStatusOverlay.svelte.d.ts +19 -0
  51. package/dist/components/NodeSwapPicker.svelte +1 -1
  52. package/dist/components/RunBar.svelte +10 -13
  53. package/dist/components/RunBar.svelte.d.ts +15 -0
  54. package/dist/components/RunsMenu.svelte +14 -13
  55. package/dist/components/RunsMenu.svelte.d.ts +15 -0
  56. package/dist/components/SchemaForm.svelte +10 -13
  57. package/dist/components/SchemaForm.svelte.d.ts +51 -0
  58. package/dist/components/SettingsPanel.svelte +5 -5
  59. package/dist/components/StatusIcon.svelte +14 -3
  60. package/dist/components/StatusIcon.svelte.d.ts +15 -0
  61. package/dist/components/StatusLabel.svelte +10 -2
  62. package/dist/components/StatusLabel.svelte.d.ts +11 -0
  63. package/dist/components/ThemeToggle.svelte +8 -5
  64. package/dist/components/ThemeToggle.svelte.d.ts +10 -0
  65. package/dist/components/UniversalNode.svelte +13 -5
  66. package/dist/components/UniversalNode.svelte.d.ts +15 -0
  67. package/dist/components/WorkflowInterfaceEntryCard.svelte +1 -1
  68. package/dist/components/WorkflowInterfaceEntryComposer.svelte +1 -2
  69. package/dist/components/ZoomTier.svelte +13 -10
  70. package/dist/components/ZoomTier.svelte.d.ts +14 -0
  71. package/dist/components/console/CommandConsole.svelte +9 -3
  72. package/dist/components/console/CommandConsole.svelte.d.ts +10 -0
  73. package/dist/components/console/ConsoleAutocomplete.svelte +4 -4
  74. package/dist/components/console/ConsoleAutocomplete.svelte.d.ts +5 -0
  75. package/dist/components/console/ConsoleInput.svelte +6 -4
  76. package/dist/components/console/ConsoleInput.svelte.d.ts +7 -0
  77. package/dist/components/console/ConsoleOutput.svelte +5 -3
  78. package/dist/components/console/ConsoleOutput.svelte.d.ts +6 -0
  79. package/dist/components/console/ConsoleStrip.svelte +9 -5
  80. package/dist/components/console/ConsoleStrip.svelte.d.ts +10 -0
  81. package/dist/components/form/FieldFactory.svelte +6 -2
  82. package/dist/components/form/FieldFactory.svelte.d.ts +46 -0
  83. package/dist/components/form/FormArray.svelte +9 -16
  84. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  85. package/dist/components/form/FormArrayRows.svelte +8 -8
  86. package/dist/components/form/FormArrayRows.svelte.d.ts +11 -0
  87. package/dist/components/form/FormAutocomplete.svelte +6 -3
  88. package/dist/components/form/FormAutocomplete.svelte.d.ts +23 -0
  89. package/dist/components/form/FormCheckboxGroup.svelte +5 -5
  90. package/dist/components/form/FormCheckboxGroup.svelte.d.ts +6 -0
  91. package/dist/components/form/FormCodeEditor.svelte +8 -13
  92. package/dist/components/form/FormCodeEditor.svelte.d.ts +9 -0
  93. package/dist/components/form/FormField.svelte +7 -8
  94. package/dist/components/form/FormField.svelte.d.ts +10 -0
  95. package/dist/components/form/FormFieldLight.svelte +6 -5
  96. package/dist/components/form/FormFieldLight.svelte.d.ts +8 -0
  97. package/dist/components/form/FormFieldWrapper.svelte +8 -8
  98. package/dist/components/form/FormFieldWrapper.svelte.d.ts +9 -0
  99. package/dist/components/form/FormFieldset.svelte +6 -12
  100. package/dist/components/form/FormFieldset.svelte.d.ts +7 -0
  101. package/dist/components/form/FormMarkdownEditor.svelte +8 -15
  102. package/dist/components/form/FormMarkdownEditor.svelte.d.ts +9 -0
  103. package/dist/components/form/FormNumberField.svelte +5 -7
  104. package/dist/components/form/FormNumberField.svelte.d.ts +6 -0
  105. package/dist/components/form/FormPorts.svelte +133 -27
  106. package/dist/components/form/FormPorts.svelte.d.ts +19 -0
  107. package/dist/components/form/FormRangeField.svelte +5 -9
  108. package/dist/components/form/FormRangeField.svelte.d.ts +6 -0
  109. package/dist/components/form/FormSelect.svelte +5 -7
  110. package/dist/components/form/FormSelect.svelte.d.ts +6 -0
  111. package/dist/components/form/FormTemplateEditor.svelte +8 -16
  112. package/dist/components/form/FormTemplateEditor.svelte.d.ts +9 -0
  113. package/dist/components/form/FormTextField.svelte +5 -7
  114. package/dist/components/form/FormTextField.svelte.d.ts +6 -0
  115. package/dist/components/form/FormTextarea.svelte +5 -7
  116. package/dist/components/form/FormTextarea.svelte.d.ts +6 -0
  117. package/dist/components/form/FormToggle.svelte +6 -8
  118. package/dist/components/form/FormToggle.svelte.d.ts +7 -0
  119. package/dist/components/form/FormUISchemaRenderer.svelte +5 -9
  120. package/dist/components/form/FormUISchemaRenderer.svelte.d.ts +7 -0
  121. package/dist/components/interrupt/ChoicePrompt.svelte +6 -6
  122. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +7 -0
  123. package/dist/components/interrupt/ConfirmationPrompt.svelte +6 -5
  124. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +7 -0
  125. package/dist/components/interrupt/FormPrompt.svelte +6 -6
  126. package/dist/components/interrupt/FormPrompt.svelte.d.ts +7 -0
  127. package/dist/components/interrupt/InterruptBubble.svelte +10 -9
  128. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +11 -0
  129. package/dist/components/interrupt/ReviewPrompt.svelte +5 -6
  130. package/dist/components/interrupt/ReviewPrompt.svelte.d.ts +7 -0
  131. package/dist/components/interrupt/TextInputPrompt.svelte +6 -6
  132. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +7 -0
  133. package/dist/components/nodes/AtomNode.svelte +31 -6
  134. package/dist/components/nodes/AtomNode.svelte.d.ts +15 -0
  135. package/dist/components/nodes/CaptionNode.svelte +50 -7
  136. package/dist/components/nodes/CaptionNode.svelte.d.ts +13 -0
  137. package/dist/components/nodes/GatewayNode.svelte +18 -11
  138. package/dist/components/nodes/GatewayNode.svelte.d.ts +21 -0
  139. package/dist/components/nodes/IdeaNode.svelte +47 -6
  140. package/dist/components/nodes/IdeaNode.svelte.d.ts +17 -0
  141. package/dist/components/nodes/NodeCard.svelte +26 -18
  142. package/dist/components/nodes/NodeCard.svelte.d.ts +20 -0
  143. package/dist/components/nodes/NodeConfigButton.svelte +15 -2
  144. package/dist/components/nodes/NodeConfigButton.svelte.d.ts +11 -0
  145. package/dist/components/nodes/NodeProblemMark.svelte +15 -10
  146. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +16 -0
  147. package/dist/components/nodes/NodeTip.svelte +10 -7
  148. package/dist/components/nodes/NodeTip.svelte.d.ts +13 -0
  149. package/dist/components/nodes/NotesNode.svelte +30 -0
  150. package/dist/components/nodes/NotesNode.svelte.d.ts +14 -0
  151. package/dist/components/nodes/SimpleNode.svelte +35 -8
  152. package/dist/components/nodes/SimpleNode.svelte.d.ts +17 -0
  153. package/dist/components/nodes/SquareNode.svelte +38 -8
  154. package/dist/components/nodes/SquareNode.svelte.d.ts +17 -0
  155. package/dist/components/nodes/TerminalNode.svelte +24 -10
  156. package/dist/components/nodes/TerminalNode.svelte.d.ts +17 -0
  157. package/dist/components/nodes/ToolNode.svelte +14 -5
  158. package/dist/components/nodes/ToolNode.svelte.d.ts +15 -0
  159. package/dist/components/nodes/WorkflowNode.svelte +18 -15
  160. package/dist/components/nodes/WorkflowNode.svelte.d.ts +21 -0
  161. package/dist/components/playground/ChatBubble.svelte +4 -3
  162. package/dist/components/playground/ChatBubble.svelte.d.ts +5 -0
  163. package/dist/components/playground/ChatInput.svelte +11 -6
  164. package/dist/components/playground/ChatInput.svelte.d.ts +14 -0
  165. package/dist/components/playground/ChatPanel.svelte +15 -7
  166. package/dist/components/playground/ChatPanel.svelte.d.ts +17 -0
  167. package/dist/components/playground/ControlPanel.svelte +26 -9
  168. package/dist/components/playground/ControlPanel.svelte.d.ts +29 -0
  169. package/dist/components/playground/DockedPlayground.svelte +7 -10
  170. package/dist/components/playground/DockedPlayground.svelte.d.ts +10 -0
  171. package/dist/components/playground/ExecutionConsole.svelte +10 -5
  172. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  173. package/dist/components/playground/ExecutionList.svelte +13 -0
  174. package/dist/components/playground/ExecutionList.svelte.d.ts +11 -0
  175. package/dist/components/playground/ExecutionLogs.svelte +6 -9
  176. package/dist/components/playground/ExecutionLogs.svelte.d.ts +7 -0
  177. package/dist/components/playground/HeaderMenu.svelte +6 -8
  178. package/dist/components/playground/HeaderMenu.svelte.d.ts +9 -0
  179. package/dist/components/playground/HierarchyTrail.svelte +6 -6
  180. package/dist/components/playground/HierarchyTrail.svelte.d.ts +8 -0
  181. package/dist/components/playground/InputCollector.svelte +6 -5
  182. package/dist/components/playground/InputCollector.svelte.d.ts +7 -0
  183. package/dist/components/playground/InputFields.svelte +8 -12
  184. package/dist/components/playground/InputFields.svelte.d.ts +9 -0
  185. package/dist/components/playground/InterfaceInputForm.svelte +6 -13
  186. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +9 -0
  187. package/dist/components/playground/InterfaceJsonInput.svelte +6 -5
  188. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +8 -0
  189. package/dist/components/playground/LogRow.svelte +4 -5
  190. package/dist/components/playground/LogRow.svelte.d.ts +6 -0
  191. package/dist/components/playground/MessageBubble.svelte +13 -7
  192. package/dist/components/playground/MessageBubble.svelte.d.ts +15 -0
  193. package/dist/components/playground/MessageCard.svelte +5 -2
  194. package/dist/components/playground/MessageCard.svelte.d.ts +6 -0
  195. package/dist/components/playground/MessageMarkdown.svelte +8 -9
  196. package/dist/components/playground/MessageMarkdown.svelte.d.ts +11 -0
  197. package/dist/components/playground/MessageNotice.svelte +7 -0
  198. package/dist/components/playground/MessageNotice.svelte.d.ts +5 -0
  199. package/dist/components/playground/MessageStream.svelte +8 -6
  200. package/dist/components/playground/MessageStream.svelte.d.ts +11 -0
  201. package/dist/components/playground/MessageTagChip.svelte +7 -7
  202. package/dist/components/playground/MessageTagChip.svelte.d.ts +10 -0
  203. package/dist/components/playground/MessageTagStrip.svelte +6 -3
  204. package/dist/components/playground/MessageTagStrip.svelte.d.ts +8 -0
  205. package/dist/components/playground/OriginBadge.svelte +7 -4
  206. package/dist/components/playground/OriginBadge.svelte.d.ts +8 -0
  207. package/dist/components/playground/PipelineKanbanView.svelte +14 -0
  208. package/dist/components/playground/PipelineKanbanView.svelte.d.ts +12 -0
  209. package/dist/components/playground/PipelinePanel.svelte +14 -0
  210. package/dist/components/playground/PipelinePanel.svelte.d.ts +12 -0
  211. package/dist/components/playground/PipelineTableView.svelte +14 -0
  212. package/dist/components/playground/PipelineTableView.svelte.d.ts +12 -0
  213. package/dist/components/playground/Playground.svelte +17 -11
  214. package/dist/components/playground/Playground.svelte.d.ts +20 -0
  215. package/dist/components/playground/PlaygroundApp.svelte +24 -10
  216. package/dist/components/playground/PlaygroundApp.svelte.d.ts +26 -0
  217. package/dist/components/playground/PlaygroundHeader.svelte +8 -12
  218. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +11 -0
  219. package/dist/components/playground/PlaygroundModal.svelte +6 -8
  220. package/dist/components/playground/PlaygroundModal.svelte.d.ts +7 -0
  221. package/dist/components/playground/PlaygroundStudio.svelte +9 -0
  222. package/dist/components/playground/PlaygroundStudio.svelte.d.ts +7 -0
  223. package/dist/components/playground/PlaygroundSurface.svelte +19 -14
  224. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +20 -0
  225. package/dist/components/playground/SessionManager.svelte +6 -5
  226. package/dist/components/playground/SessionManager.svelte.d.ts +7 -0
  227. package/dist/components/playground/StepsSummary.svelte +8 -9
  228. package/dist/components/playground/StepsSummary.svelte.d.ts +10 -0
  229. package/dist/components/primitives/Button.svelte +15 -7
  230. package/dist/components/primitives/Button.svelte.d.ts +18 -1
  231. package/dist/components/primitives/Card.svelte +8 -6
  232. package/dist/components/primitives/Card.svelte.d.ts +11 -0
  233. package/dist/components/primitives/Checkbox.svelte +8 -5
  234. package/dist/components/primitives/Checkbox.svelte.d.ts +11 -0
  235. package/dist/components/primitives/Chip.svelte +8 -4
  236. package/dist/components/primitives/Chip.svelte.d.ts +11 -0
  237. package/dist/components/primitives/Combobox.svelte +27 -18
  238. package/dist/components/primitives/Combobox.svelte.d.ts +33 -0
  239. package/dist/components/primitives/Composer.svelte +15 -16
  240. package/dist/components/primitives/Composer.svelte.d.ts +20 -0
  241. package/dist/components/primitives/EmptyState.svelte +9 -3
  242. package/dist/components/primitives/EmptyState.svelte.d.ts +11 -0
  243. package/dist/components/primitives/Field.svelte +12 -9
  244. package/dist/components/primitives/Field.svelte.d.ts +16 -0
  245. package/dist/components/primitives/IconButton.svelte +10 -5
  246. package/dist/components/primitives/IconButton.svelte.d.ts +13 -0
  247. package/dist/components/primitives/Menu.svelte +15 -14
  248. package/dist/components/primitives/Menu.svelte.d.ts +20 -0
  249. package/dist/components/primitives/Notice.svelte +11 -8
  250. package/dist/components/primitives/Notice.svelte.d.ts +14 -0
  251. package/dist/components/primitives/PanelHeader.svelte +10 -7
  252. package/dist/components/primitives/PanelHeader.svelte.d.ts +13 -0
  253. package/dist/components/primitives/Segmented.svelte +11 -4
  254. package/dist/components/primitives/Segmented.svelte.d.ts +14 -0
  255. package/dist/components/primitives/Select.svelte +13 -16
  256. package/dist/components/primitives/Select.svelte.d.ts +18 -0
  257. package/dist/components/primitives/StatusPill.svelte +11 -8
  258. package/dist/components/primitives/StatusPill.svelte.d.ts +15 -0
  259. package/dist/components/primitives/Switch.svelte +9 -6
  260. package/dist/components/primitives/Switch.svelte.d.ts +12 -0
  261. package/dist/components/primitives/Tabs.svelte +16 -15
  262. package/dist/components/primitives/Tabs.svelte.d.ts +22 -0
  263. package/dist/components/primitives/Toolbar.svelte +14 -13
  264. package/dist/components/primitives/Toolbar.svelte.d.ts +18 -0
  265. package/dist/components/primitives/ToolbarSeparator.svelte +5 -4
  266. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  267. package/dist/core/index.d.ts +2 -2
  268. package/dist/core/index.js +1 -1
  269. package/dist/editor/index.d.ts +3 -3
  270. package/dist/index.d.ts +3 -2
  271. package/dist/layout/index.d.ts +1 -1
  272. package/dist/layout/index.js +1 -1
  273. package/dist/layout/toWorkflow.d.ts +8 -7
  274. package/dist/layout/toWorkflow.js +20 -40
  275. package/dist/messages/defaults.d.ts +24 -0
  276. package/dist/messages/defaults.js +15 -0
  277. package/dist/skins/graphite.d.ts +1 -1
  278. package/dist/skins/graphite.js +1 -1
  279. package/dist/stores/settingsStore.svelte.js +3 -0
  280. package/dist/stores/workflowStore.svelte.d.ts +10 -0
  281. package/dist/stores/workflowStore.svelte.js +65 -20
  282. package/dist/styles/base.css +2 -126
  283. package/dist/styles/tokenAliases.js +1 -0
  284. package/dist/styles/tokens.css +9 -5
  285. package/dist/svelte-app.d.ts +63 -2
  286. package/dist/svelte-app.js +144 -1
  287. package/dist/themes/classic.d.ts +9 -0
  288. package/dist/themes/classic.js +16 -0
  289. package/dist/themes/index.d.ts +7 -2
  290. package/dist/themes/index.js +20 -10
  291. package/dist/types/events.d.ts +18 -1
  292. package/dist/types/index.d.ts +10 -0
  293. package/dist/types/settings.d.ts +6 -2
  294. package/dist/types/theme.d.ts +6 -2
  295. package/dist/utils/externalEdit.svelte.d.ts +48 -0
  296. package/dist/utils/externalEdit.svelte.js +62 -0
  297. package/dist/utils/inspectorContext.d.ts +5 -0
  298. package/dist/utils/playgroundChat.d.ts +10 -0
  299. package/dist/utils/playgroundChat.js +25 -0
  300. package/dist/utils/portExposure.d.ts +24 -1
  301. package/dist/utils/portExposure.js +46 -13
  302. package/dist/utils/portUtils.d.ts +5 -1
  303. package/dist/utils/portUtils.js +15 -4
  304. package/package.json +2 -1
  305. package/dist/components/IconButton.svelte +0 -80
  306. package/dist/components/IconButton.svelte.d.ts +0 -30
  307. package/dist/themes/default.d.ts +0 -2
  308. package/dist/themes/default.js +0 -9
@@ -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">
@@ -26,6 +18,7 @@
26
18
  WorkflowNode,
27
19
  WorkflowEdge,
28
20
  ConfigEditOptions,
21
+ ExternalEditLink,
29
22
  AuthProvider
30
23
  } from '../types/index.js';
31
24
  import type { UISchemaElement } from '../types/uischema.js';
@@ -115,6 +108,15 @@
115
108
  config: Record<string, unknown>,
116
109
  meta?: { fieldKey?: string; commit?: boolean }
117
110
  ) => void;
111
+ /**
112
+ * Called instead of opening the node's external edit link, when set, with
113
+ * copies of the node and the link, after committing field edits still
114
+ * pending (as a blur would). The host opens its own form; ConfigForm awaits
115
+ * the call (a second click while one is pending is ignored) and logs a
116
+ * rejection. Writing the config the
117
+ * handler resolves with is the caller's job: ConfigForm passes it on as is.
118
+ */
119
+ onExternalEdit?: (node: WorkflowNode, link: ExternalEditLink) => unknown;
118
120
  /** Callback when form is saved */
119
121
  onSave?: (config: Record<string, unknown>) => void;
120
122
  /** Callback when form is cancelled */
@@ -133,6 +135,7 @@
133
135
  authProvider,
134
136
  commitMode = 'blur',
135
137
  onChange,
138
+ onExternalEdit,
136
139
  onSave,
137
140
  onCancel
138
141
  }: Props = $props();
@@ -407,7 +410,8 @@
407
410
  : { name: link.label ?? 'Configure externally' }),
408
411
  title: link.description,
409
412
  href: getExternalEditUrl(),
410
- newTab: link.openInNewTab !== false
413
+ newTab: link.openInNewTab !== false,
414
+ ...(onExternalEdit ? { onActivate: handleExternalEditClick } : {})
411
415
  };
412
416
  });
413
417
 
@@ -426,9 +430,38 @@
426
430
  /**
427
431
  * Handle opening external edit link
428
432
  */
433
+ const externalEditPending = new Set<string>();
434
+
435
+ /** A plain copy of reactive state. Typed as `T`: `Snapshot<WorkflowNode>` is too deep for tsc. */
436
+ const copyOf = <T,>(value: T): T => $state.snapshot(value) as T;
437
+
429
438
  function handleExternalEditClick(): void {
430
439
  if (!node || !configEditOptions?.externalEditLink) return;
431
440
 
441
+ if (onExternalEdit) {
442
+ const link = configEditOptions.externalEditLink;
443
+ const nodeId = node.id;
444
+ // One host form per node at a time.
445
+ if (externalEditPending.has(nodeId)) return;
446
+ externalEditPending.add(nodeId);
447
+ // Commit what is still in the edit buffer first: the host then sees it,
448
+ // and a stale buffered value cannot shadow, and later overwrite, the
449
+ // config the host writes back. A click on a link does not always blur the
450
+ // field (Safari does not focus links).
451
+ if (Object.keys(edits).length > 0) handleFormBlur();
452
+ void (async () => {
453
+ try {
454
+ // Copies: the host must not write into the live workflow behind the editor's back.
455
+ await onExternalEdit(copyOf(node), copyOf(link));
456
+ } catch (error) {
457
+ logger.warn('onExternalEdit failed:', error);
458
+ } finally {
459
+ externalEditPending.delete(nodeId);
460
+ }
461
+ })();
462
+ return;
463
+ }
464
+
432
465
  const url = getExternalEditUrl();
433
466
  const openInNewTab = configEditOptions.externalEditLink.openInNewTab !== false;
434
467
 
@@ -1,4 +1,4 @@
1
- import type { ConfigSchema, WorkflowNode, WorkflowEdge, AuthProvider } from '../types/index.js';
1
+ import type { ConfigSchema, WorkflowNode, WorkflowEdge, ExternalEditLink, AuthProvider } from '../types/index.js';
2
2
  import type { UISchemaElement } from '../types/uischema.js';
3
3
  interface Props {
4
4
  /** Optional workflow node (if provided, schema and values are derived from it) */
@@ -51,11 +51,30 @@ interface Props {
51
51
  fieldKey?: string;
52
52
  commit?: boolean;
53
53
  }) => void;
54
+ /**
55
+ * Called instead of opening the node's external edit link, when set, with
56
+ * copies of the node and the link, after committing field edits still
57
+ * pending (as a blur would). The host opens its own form; ConfigForm awaits
58
+ * the call (a second click while one is pending is ignored) and logs a
59
+ * rejection. Writing the config the
60
+ * handler resolves with is the caller's job: ConfigForm passes it on as is.
61
+ */
62
+ onExternalEdit?: (node: WorkflowNode, link: ExternalEditLink) => unknown;
54
63
  /** Callback when form is saved */
55
64
  onSave?: (config: Record<string, unknown>) => void;
56
65
  /** Callback when form is cancelled */
57
66
  onCancel?: () => void;
58
67
  }
68
+ /**
69
+ * The form for one node's configuration. It draws the fields from the node type's `configSchema` (or a fetched schema),
70
+ * adds the settings every node has (port order and exposure), splits them into the inspector's Config, Ports and Execution tabs,
71
+ * and reports edits through `onChange`.
72
+ *
73
+ * 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.
74
+ *
75
+ * **Use it for** editing a node, inside `NodeInspector`.
76
+ * **Not for** a plain schema with no node (use `SchemaForm`).
77
+ */
59
78
  declare const ConfigForm: import("svelte").Component<Props, {}, "">;
60
79
  type ConfigForm = ReturnType<typeof ConfigForm>;
61
80
  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;
@@ -17,9 +17,23 @@
17
17
  href: string;
18
18
  /** Open in a new tab */
19
19
  newTab?: boolean;
20
+ /**
21
+ * Handle a plain left click instead of following the link. The href stays,
22
+ * so middle-click, modified clicks and "copy link" work as for any link.
23
+ */
24
+ onActivate?: () => void;
20
25
  }
21
26
 
22
- let { prefix, name, title, href, newTab = true }: Props = $props();
27
+ let { prefix, name, title, href, newTab = true, onActivate }: Props = $props();
28
+
29
+ function handleClick(event: MouseEvent): void {
30
+ if (!onActivate) return;
31
+ if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
32
+ return;
33
+ }
34
+ event.preventDefault();
35
+ onActivate();
36
+ }
23
37
  </script>
24
38
 
25
39
  <div class="external-link-row">
@@ -30,6 +44,7 @@
30
44
  target={newTab ? '_blank' : undefined}
31
45
  rel={newTab ? 'noopener noreferrer' : undefined}
32
46
  title={title ?? name}
47
+ onclick={handleClick}
33
48
  data-testid="external-config-link"
34
49
  >
35
50
  <span class="external-link-row__name">{name}</span>
@@ -8,6 +8,11 @@ interface Props {
8
8
  href: string;
9
9
  /** Open in a new tab */
10
10
  newTab?: boolean;
11
+ /**
12
+ * Handle a plain left click instead of following the link. The href stays,
13
+ * so middle-click, modified clicks and "copy link" work as for any link.
14
+ */
15
+ onActivate?: () => void;
11
16
  }
12
17
  declare const ExternalLinkRow: import("svelte").Component<Props, {}, "">;
13
18
  type ExternalLinkRow = ReturnType<typeof ExternalLinkRow>;
@@ -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;
@@ -1,24 +1,22 @@
1
1
  <!--
2
- InterfaceTag
2
+ @component
3
+ The `[id · Type>` tag of a workflow interface entry: a type swatch, the id in mono and the
4
+ type in muted text, in a tag that points right, the way the canvas flows.
3
5
 
4
- The `[id · Type>` glyph of a workflow-interface entry: a type swatch, the id
5
- in mono and the type in muted text, in a tag that points right (the canvas's
6
- direction of flow). One glyph for the canvas, the Ports tab and the Interface
7
- tab, so a published port reads the same everywhere.
6
+ It is one glyph for the canvas, the Ports tab and the Interface tab, so a published port
7
+ reads the same everywhere. It is a view only: the data stays in `workflow.interface`. Ids
8
+ longer than `INTERFACE_TAG_MAX_ID_CHARS` are shortened and the full id is the tooltip.
8
9
 
9
- - `mismatch`: the entry declares another type than its bound port. The
10
- outline turns amber and the type reads "Array ≠ String".
11
- - `ghost`: a name being typed. Dashed outline in the ring colour; pass the
12
- input as `children`.
13
- - `readonly`: a derived entry nobody can rename or remove (a trigger's
14
- `event:<node-id>`). Muted fill and id, default cursor.
15
- - `compact`: far zoom (the editor sets it through the `data-fd-zoom` tier; the prop forces it). The text drops, the shape and swatch stay.
10
+ - `mismatch`: the entry declares another type than its bound port. The outline turns
11
+ amber and the type reads "Array ≠ String".
12
+ - `ghost`: a name being typed. Dashed outline; pass the input as `children`.
13
+ - `readonly`: a derived entry nobody can rename or remove (a trigger's `event:<node-id>`).
14
+ - `compact`: far zoom. The editor sets it through the `data-fd-zoom` tier; the prop forces it.
16
15
 
17
16
  `title=""` drops the native tooltip (the canvas shows a richer popover).
18
17
 
19
- A view only: the data stays in `workflow.interface`. Ids longer than
20
- `INTERFACE_TAG_MAX_ID_CHARS` are shortened; the full id is the tooltip.
21
- Styled with BEM syntax, from the `--fd-iface-tag-*` tokens.
18
+ **Use it for** showing a published workflow port.
19
+ **Not for** an ordinary label; use `Chip`.
22
20
  -->
23
21
 
24
22
  <script lang="ts">
@@ -15,6 +15,25 @@ interface Props {
15
15
  class?: string;
16
16
  [key: string]: unknown;
17
17
  }
18
+ /**
19
+ * The `[id · Type>` tag of a workflow interface entry: a type swatch, the id in mono and the
20
+ * type in muted text, in a tag that points right, the way the canvas flows.
21
+ *
22
+ * It is one glyph for the canvas, the Ports tab and the Interface tab, so a published port
23
+ * reads the same everywhere. It is a view only: the data stays in `workflow.interface`. Ids
24
+ * longer than `INTERFACE_TAG_MAX_ID_CHARS` are shortened and the full id is the tooltip.
25
+ *
26
+ * - `mismatch`: the entry declares another type than its bound port. The outline turns
27
+ * amber and the type reads "Array ≠ String".
28
+ * - `ghost`: a name being typed. Dashed outline; pass the input as `children`.
29
+ * - `readonly`: a derived entry nobody can rename or remove (a trigger's `event:<node-id>`).
30
+ * - `compact`: far zoom. The editor sets it through the `data-fd-zoom` tier; the prop forces it.
31
+ *
32
+ * `title=""` drops the native tooltip (the canvas shows a richer popover).
33
+ *
34
+ * **Use it for** showing a published workflow port.
35
+ * **Not for** an ordinary label; use `Chip`.
36
+ */
18
37
  declare const InterfaceTag: import("svelte").Component<Props, {}, "">;
19
38
  type InterfaceTag = ReturnType<typeof InterfaceTag>;
20
39
  export default InterfaceTag;
@@ -1,12 +1,18 @@
1
1
  <!--
2
- Loading Spinner Component
3
- Reusable loading indicator with customizable size and text
2
+ @component
3
+ LoadingSpinner: a spinner with a short text under it.
4
+
5
+ **Use it for** a block of the page that is still loading, such as the node sidebar.
6
+ **Not for** a button that is busy; use `Button` with `loading`.
4
7
  -->
5
8
 
6
9
  <script lang="ts">
7
10
  interface Props {
11
+ /** Spinner size. */
8
12
  size?: 'xs' | 'sm' | 'md' | 'lg';
13
+ /** Text under the spinner. Defaults to "Loading...". */
9
14
  text?: string;
15
+ /** Set to false to show the spinner alone. */
10
16
  showText?: boolean;
11
17
  }
12
18
 
@@ -1,8 +1,17 @@
1
1
  interface Props {
2
+ /** Spinner size. */
2
3
  size?: 'xs' | 'sm' | 'md' | 'lg';
4
+ /** Text under the spinner. Defaults to "Loading...". */
3
5
  text?: string;
6
+ /** Set to false to show the spinner alone. */
4
7
  showText?: boolean;
5
8
  }
9
+ /**
10
+ * LoadingSpinner: a spinner with a short text under it.
11
+ *
12
+ * **Use it for** a block of the page that is still loading, such as the node sidebar.
13
+ * **Not for** a button that is busy; use `Button` with `loading`.
14
+ */
6
15
  declare const LoadingSpinner: import("svelte").Component<Props, {}, "">;
7
16
  type LoadingSpinner = ReturnType<typeof LoadingSpinner>;
8
17
  export default LoadingSpinner;
@@ -1,3 +1,14 @@
1
+ <!--
2
+ @component
3
+ Logo: the FlowDrop mark (the rocket in a rounded square).
4
+
5
+ It fills the box you give it, so size it with the parent. Colours come from the
6
+ `--fd-logo-*` tokens, so a skin can recolour it, and it switches to an outline in dark mode.
7
+
8
+ **Use it for** a square mark, such as an app icon or a favicon-sized spot.
9
+ **Not for** the navbar; the editor uses `LogoWordmark`, the mark with the name.
10
+ -->
11
+
1
12
  <div class="flowdrop-logo">
2
13
  <svg
3
14
  viewBox="0 0 500 499.99999"
@@ -6,6 +6,15 @@ type Logo = SvelteComponent<{
6
6
  }, {}> & {
7
7
  $$bindings?: string | undefined;
8
8
  };
9
+ /**
10
+ * Logo: the FlowDrop mark (the rocket in a rounded square).
11
+ *
12
+ * It fills the box you give it, so size it with the parent. Colours come from the
13
+ * `--fd-logo-*` tokens, so a skin can recolour it, and it switches to an outline in dark mode.
14
+ *
15
+ * **Use it for** a square mark, such as an app icon or a favicon-sized spot.
16
+ * **Not for** the navbar; the editor uses `LogoWordmark`, the mark with the name.
17
+ */
9
18
  declare const Logo: $$__sveltets_2_IsomorphicComponent<{
10
19
  [x: string]: never;
11
20
  }, {
@@ -1,7 +1,12 @@
1
1
  <!--
2
- FlowDrop horizontal lockup: rocket mark + "FlowDrop" wordmark.
3
- Theme-aware via the same --fd-logo-* variables as Logo.svelte, plus
4
- --fd-logo-text for the wordmark glyphs.
2
+ @component
3
+ LogoWordmark: the FlowDrop mark with the "FlowDrop" name next to it, as one wide logo.
4
+
5
+ It fills the box you give it (five times wider than tall). It uses the same `--fd-logo-*`
6
+ tokens as `Logo`, plus `--fd-logo-text` for the letters.
7
+
8
+ **Use it for** the navbar and other headers. The editor shows it at the top left.
9
+ **Not for** a small square spot; use `Logo`.
5
10
  -->
6
11
  <div class="flowdrop-logo-wordmark">
7
12
  <svg viewBox="0 0 2500 499.99999" version="1.1" xmlns="http://www.w3.org/2000/svg">
@@ -6,6 +6,15 @@ type LogoWordmark = SvelteComponent<{
6
6
  }, {}> & {
7
7
  $$bindings?: string | undefined;
8
8
  };
9
+ /**
10
+ * LogoWordmark: the FlowDrop mark with the "FlowDrop" name next to it, as one wide logo.
11
+ *
12
+ * It fills the box you give it (five times wider than tall). It uses the same `--fd-logo-*`
13
+ * tokens as `Logo`, plus `--fd-logo-text` for the letters.
14
+ *
15
+ * **Use it for** the navbar and other headers. The editor shows it at the top left.
16
+ * **Not for** a small square spot; use `Logo`.
17
+ */
9
18
  declare const LogoWordmark: $$__sveltets_2_IsomorphicComponent<{
10
19
  [x: string]: never;
11
20
  }, {