@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
@@ -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
  }, {
@@ -1,10 +1,16 @@
1
1
  <!--
2
- LoopbackLanes Component
3
- Renderless. Derives the return lane of every loopback in one pass (track
4
- assignment needs the whole graph) whenever the nodes, edges or measured sizes
5
- change, and lets the edges read them through the instance's loopbackLanes
6
- store. Yields no lanes while the setting is off or the canvas has no measurement.
7
- Must be rendered inside <SvelteFlow> so the canvas measurement is registered.
2
+ @component
3
+ Works out the return lane of every loopback in one pass. Draws nothing itself.
4
+
5
+ Track assignment needs the whole graph, so the lanes are derived together whenever the
6
+ nodes, the edges or the measured sizes change. The edges read them through the instance's
7
+ `loopbackLanes` store. There are no lanes while the canvas has no measurement; the edges
8
+ then stay beziers.
9
+
10
+ Render it inside `<SvelteFlow>`, so the canvas measurement is registered.
11
+
12
+ **Use it for** a canvas that has loopbacks.
13
+ **Not for** drawing a single wire; that is `FlowDropEdge`.
8
14
  -->
9
15
 
10
16
  <script lang="ts">
@@ -3,6 +3,19 @@ interface Props {
3
3
  nodes: readonly WorkflowNode[];
4
4
  edges: readonly WorkflowEdge[];
5
5
  }
6
+ /**
7
+ * Works out the return lane of every loopback in one pass. Draws nothing itself.
8
+ *
9
+ * Track assignment needs the whole graph, so the lanes are derived together whenever the
10
+ * nodes, the edges or the measured sizes change. The edges read them through the instance's
11
+ * `loopbackLanes` store. There are no lanes while the canvas has no measurement; the edges
12
+ * then stay beziers.
13
+ *
14
+ * Render it inside `<SvelteFlow>`, so the canvas measurement is registered.
15
+ *
16
+ * **Use it for** a canvas that has loopbacks.
17
+ * **Not for** drawing a single wire; that is `FlowDropEdge`.
18
+ */
6
19
  declare const LoopbackLanes: import("svelte").Component<Props, {}, "">;
7
20
  type LoopbackLanes = ReturnType<typeof LoopbackLanes>;
8
21
  export default LoopbackLanes;
@@ -1,7 +1,12 @@
1
1
  <!--
2
- MarkdownDisplay Component
3
- Reusable component for rendering markdown content with consistent styling
4
- Supports all standard markdown elements with proper typography
2
+ @component
3
+ MarkdownDisplay: renders a markdown string as formatted text.
4
+
5
+ Headings, lists, tables, quotes, code blocks and links are all styled. The editor uses it for
6
+ AI chat replies and for note nodes. `className` replaces the default class.
7
+
8
+ **Use it for** text written by a person or a model that may contain markdown.
9
+ **Not for** plain labels; print them as text.
5
10
  -->
6
11
 
7
12
  <script lang="ts">
@@ -9,7 +14,9 @@
9
14
  import { sanitizeHtml } from '../utils/sanitize.js';
10
15
 
11
16
  interface Props {
17
+ /** The markdown source. */
12
18
  content: string;
19
+ /** Class on the wrapper. Defaults to `markdown-display`. */
13
20
  className?: string;
14
21
  }
15
22
 
@@ -1,7 +1,18 @@
1
1
  interface Props {
2
+ /** The markdown source. */
2
3
  content: string;
4
+ /** Class on the wrapper. Defaults to `markdown-display`. */
3
5
  className?: string;
4
6
  }
7
+ /**
8
+ * MarkdownDisplay: renders a markdown string as formatted text.
9
+ *
10
+ * Headings, lists, tables, quotes, code blocks and links are all styled. The editor uses it for
11
+ * AI chat replies and for note nodes. `className` replaces the default class.
12
+ *
13
+ * **Use it for** text written by a person or a model that may contain markdown.
14
+ * **Not for** plain labels; print them as text.
15
+ */
5
16
  declare const MarkdownDisplay: import("svelte").Component<Props, {}, "">;
6
17
  type MarkdownDisplay = ReturnType<typeof MarkdownDisplay>;
7
18
  export default MarkdownDisplay;
@@ -1,9 +1,17 @@
1
1
  <!--
2
- FlowDrop Navbar Component
3
- Reusable navigation bar with customizable primary actions
4
- - Logo and branding on the left
5
- - Primary actions in the center
6
- - Status indicator on the right
2
+ @component
3
+ The bar along the top of the editor: logo and breadcrumbs on the left, actions in the middle,
4
+ status, workflow settings and the app settings on the right.
5
+
6
+ The first primary action is the main button; the others go in the menu beside it. A skin can instead
7
+ show every action as its own button (the "split" layout, set with `--fd-navbar-split-display`).
8
+ The logo is FlowDrop's wordmark unless `branding` gives an image or a component.
9
+ `onWorkflowSettings` adds the Workflow button, `status` adds the Problems indicator before the actions,
10
+ and `end` adds your own controls before the settings gear.
11
+ `saveShortcut` binds Ctrl/Cmd+S to the first action.
12
+
13
+ **Use it for** the editor's top bar.
14
+ **Not for** controls that act on the canvas (those live in `CanvasToolbar`).
7
15
  -->
8
16
 
9
17
  <script lang="ts">
@@ -45,6 +45,20 @@ interface Props {
45
45
  */
46
46
  status?: Snippet;
47
47
  }
48
+ /**
49
+ * The bar along the top of the editor: logo and breadcrumbs on the left, actions in the middle,
50
+ * status, workflow settings and the app settings on the right.
51
+ *
52
+ * The first primary action is the main button; the others go in the menu beside it. A skin can instead
53
+ * show every action as its own button (the "split" layout, set with `--fd-navbar-split-display`).
54
+ * The logo is FlowDrop's wordmark unless `branding` gives an image or a component.
55
+ * `onWorkflowSettings` adds the Workflow button, `status` adds the Problems indicator before the actions,
56
+ * and `end` adds your own controls before the settings gear.
57
+ * `saveShortcut` binds Ctrl/Cmd+S to the first action.
58
+ *
59
+ * **Use it for** the editor's top bar.
60
+ * **Not for** controls that act on the canvas (those live in `CanvasToolbar`).
61
+ */
48
62
  declare const Navbar: import("svelte").Component<Props, {}, "">;
49
63
  type Navbar = ReturnType<typeof Navbar>;
50
64
  export default Navbar;
@@ -1,14 +1,13 @@
1
1
  <!--
2
- NodeInspector — what the inspector shows for an open node.
2
+ @component
3
+ What the right-hand panel shows for an open node: a 40px tab row (Config, Ports, Execution, and Last run in Test mode) over the node's form.
3
4
 
4
- A 40px tab row under the meta lines: Config | Ports | Execution, plus Last run
5
- in Test mode. The form tabs come from the form itself (ConfigForm reports the
6
- sections it has through the inspector context), so a node without ports or an
7
- Execution group simply has fewer tabs, and a node with a single tab shows no
8
- strip at all. The form stays mounted behind every tab, so an edit in progress
9
- survives looking at another tab or at the last run.
5
+ The form tabs come from the form itself. A node without ports or an Execution group has fewer tabs, and a node with one tab shows no strip.
6
+ The form stays mounted behind every tab, so an edit in progress survives a look at the last run.
7
+ A node that points to another workflow shows a link row above the tabs.
10
8
 
11
- The external-workflow link ("Runs Calculator ↗") is a row above the tabs.
9
+ **Use it for** the content of `ConfigPanel` when a node is open.
10
+ **Not for** other panels (workflow settings use the panel without it).
12
11
  -->
13
12
 
14
13
  <script lang="ts">
@@ -14,6 +14,16 @@ interface Props {
14
14
  /** Actions under the Last run facts. */
15
15
  lastRunActions?: Snippet;
16
16
  }
17
+ /**
18
+ * What the right-hand panel shows for an open node: a 40px tab row (Config, Ports, Execution, and Last run in Test mode) over the node's form.
19
+ *
20
+ * The form tabs come from the form itself. A node without ports or an Execution group has fewer tabs, and a node with one tab shows no strip.
21
+ * The form stays mounted behind every tab, so an edit in progress survives a look at the last run.
22
+ * A node that points to another workflow shows a link row above the tabs.
23
+ *
24
+ * **Use it for** the content of `ConfigPanel` when a node is open.
25
+ * **Not for** other panels (workflow settings use the panel without it).
26
+ */
17
27
  declare const NodeInspector: import("svelte").Component<Props, {}, "">;
18
28
  type NodeInspector = ReturnType<typeof NodeInspector>;
19
29
  export default NodeInspector;
@@ -1,7 +1,13 @@
1
1
  <!--
2
- Node Sidebar Component
3
- Displays available node types organized by category with accordion-style groups
4
- Styled with BEM syntax
2
+ @component
3
+ The node palette: every node type the editor knows, grouped by category in accordions, with a search field.
4
+ Drag a node onto the canvas to add it. In Test mode the same list opens as a popover.
5
+
6
+ Nodes that do not fit the workflow's format are left out. The list keeps the order the backend sent. The look
7
+ (cards, flat or rows) follows the theme's `display.sidebarList`.
8
+
9
+ **Use it for** finding and adding nodes.
10
+ **Not for** changing a node that is already on the canvas (that is the config panel).
5
11
  -->
6
12
 
7
13
  <script lang="ts">
@@ -19,6 +19,16 @@ interface Props {
19
19
  */
20
20
  listStyle?: 'cards' | 'flat' | 'rows';
21
21
  }
22
+ /**
23
+ * The node palette: every node type the editor knows, grouped by category in accordions, with a search field.
24
+ * Drag a node onto the canvas to add it. In Test mode the same list opens as a popover.
25
+ *
26
+ * Nodes that do not fit the workflow's format are left out. The list keeps the order the backend sent. The look
27
+ * (cards, flat or rows) follows the theme's `display.sidebarList`.
28
+ *
29
+ * **Use it for** finding and adding nodes.
30
+ * **Not for** changing a node that is already on the canvas (that is the config panel).
31
+ */
22
32
  declare const NodeSidebar: import("svelte").Component<Props, {}, "">;
23
33
  type NodeSidebar = ReturnType<typeof NodeSidebar>;
24
34
  export default NodeSidebar;
@@ -1,21 +1,22 @@
1
1
  <!--
2
- Node Status Overlay Component
3
- The run status of a node: a StatusPill (icon + label, plus a count when the
4
- node has more than one run) centred on the node's top edge, growing upward off
5
- the node. Each zoom tier draws it at a fixed size in flow px (a multiplier per
6
- tier, tokens `--fd-node-zoom-status-scale-*`), never divided by the zoom. In
7
- the map tier (`data-fd-zoom='map'` on the editor root) the pill gives way to a
8
- status-coloured outline around the node and a count badge; both are in the DOM
9
- and CSS picks one, so crossing a boundary re-renders nothing.
10
-
11
- Hover shows the count and the last error line, nothing else; durations and
12
- job history live in the inspector's Last run tab.
13
-
14
- Execution statuses map onto the five pill statuses with `toPillStatus()`
15
- (utils/nodeStatus.ts); a node whose status maps to nothing (idle, pending)
16
- draws nothing.
17
-
18
- Styled with BEM syntax
2
+ @component
3
+ The run status of a node: a pill with an icon and a label (and a count when the node ran
4
+ more than once), centred on the node's top edge and growing upward off the node.
5
+
6
+ Each zoom tier draws it at a fixed size in flow px, never divided by the zoom. In the map tier
7
+ (`data-fd-zoom="map"` on the editor root) the pill gives way to an outline in the status
8
+ colour and a count badge. Both are in the DOM and CSS picks one, so crossing a boundary
9
+ re-renders nothing. In Test mode `UniversalNode` also thickens the node's border in the status
10
+ colour; the frame for that is drawn here, behind the card so the ports stay on top.
11
+
12
+ Hover shows the count and the last error line. Durations and job history live in the
13
+ inspector's Last run tab.
14
+
15
+ Execution statuses map onto five pill statuses with `toPillStatus()` (`utils/nodeStatus.ts`).
16
+ A node whose status maps to nothing (idle, pending) draws nothing.
17
+
18
+ **Use it for** run state on a node. `UniversalNode` mounts it; you rarely need to.
19
+ **Not for** a status in a list or a toolbar; use `StatusPill`.
19
20
  -->
20
21
 
21
22
  <script lang="ts">
@@ -102,11 +103,19 @@
102
103
  --_frame: 0 0 0 var(--fd-node-status-edge) var(--_status);
103
104
  position: absolute;
104
105
  inset: 0;
105
- z-index: 1000;
106
+ /* No z-index here: that would make the overlay one stacking context and lift
107
+ the frame over the ports. The pill, badge and outline sit on top; the
108
+ frame goes behind the card. */
106
109
  /* Clicks go through to the node; only the pill itself takes hover. */
107
110
  pointer-events: none;
108
111
  }
109
112
 
113
+ .node-status-overlay__pill,
114
+ .node-status-overlay__outline,
115
+ .node-status-overlay__badge {
116
+ z-index: 1000;
117
+ }
118
+
110
119
  .node-status-overlay--running {
111
120
  --_status: var(--fd-status-running);
112
121
  --_soft: var(--fd-status-running-soft);
@@ -154,10 +163,12 @@
154
163
  }
155
164
 
156
165
  /* Carries the shadows that thicken the node's status-coloured border (and
157
- draw the waiting halo); UniversalNode sets them, in Test mode only. */
166
+ draw the waiting halo); UniversalNode sets them, in Test mode only. Behind
167
+ the card, so the ports on its edge stay on top of the halo. */
158
168
  .node-status-overlay__frame {
159
169
  position: absolute;
160
170
  inset: 0;
171
+ z-index: -1;
161
172
  border-radius: var(--fd-node-radius, 8px);
162
173
  pointer-events: none;
163
174
  }
@@ -9,6 +9,25 @@ interface Props {
9
9
  /** @deprecated No effect: hover shows the count and last error only. Removed in 3.0. */
10
10
  showDetails?: boolean;
11
11
  }
12
+ /**
13
+ * The run status of a node: a pill with an icon and a label (and a count when the node ran
14
+ * more than once), centred on the node's top edge and growing upward off the node.
15
+ *
16
+ * Each zoom tier draws it at a fixed size in flow px, never divided by the zoom. In the map tier
17
+ * (`data-fd-zoom="map"` on the editor root) the pill gives way to an outline in the status
18
+ * colour and a count badge. Both are in the DOM and CSS picks one, so crossing a boundary
19
+ * re-renders nothing. In Test mode `UniversalNode` also thickens the node's border in the status
20
+ * colour; the frame for that is drawn here, behind the card so the ports stay on top.
21
+ *
22
+ * Hover shows the count and the last error line. Durations and job history live in the
23
+ * inspector's Last run tab.
24
+ *
25
+ * Execution statuses map onto five pill statuses with `toPillStatus()` (`utils/nodeStatus.ts`).
26
+ * A node whose status maps to nothing (idle, pending) draws nothing.
27
+ *
28
+ * **Use it for** run state on a node. `UniversalNode` mounts it; you rarely need to.
29
+ * **Not for** a status in a list or a toolbar; use `StatusPill`.
30
+ */
12
31
  declare const NodeStatusOverlay: import("svelte").Component<Props, {}, "">;
13
32
  type NodeStatusOverlay = ReturnType<typeof NodeStatusOverlay>;
14
33
  export default NodeStatusOverlay;
@@ -157,7 +157,7 @@
157
157
  </div>
158
158
  </div>
159
159
 
160
- <!-- Card style: icon + name + desc rows (shown in default skin) -->
160
+ <!-- Card style: icon + name + desc rows (shown in the Classic theme) -->
161
161
  <div class="swap-picker__card-section">
162
162
  <div class="swap-picker__category-header">
163
163
  <span
@@ -1,21 +1,18 @@
1
1
  <!--
2
- RunBar — the run pill in the canvas toolbar (`CanvasToolbar` renders it).
2
+ @component
3
+ The run pill in the canvas toolbar (`CanvasToolbar` draws it).
3
4
 
4
- Shown only while the instance has a run (`fd.runs.activeRun`): there is no
5
- idle pill. It says where the run stands, offers Stop while the run is live and
6
- Open (to Test mode) when it waits for a person, and, in Edit mode, fades out
7
- a few seconds after the run ends. The node status badges fade with it:
8
- dismissing the run clears `fd.playground.nodeStatuses`.
5
+ It shows only while the instance has a run (`fd.runs.activeRun`); there is no idle pill. It says where the run
6
+ stands, offers Stop while the run is live and Open (to Test mode) when it waits for a person. In Edit mode it
7
+ fades out a few seconds after the run ends, and the status badges on the nodes fade with it.
9
8
 
10
- In Test mode (`mode="test"`) the pill shows only while the run is live (status
11
- and Stop; no Open, you are already there) and never dismisses the run: the
12
- Playground owns the run's record there.
9
+ In Test mode (`mode="test"`) the pill shows only while the run is live (status and Stop, no Open because you are
10
+ already there) and never dismisses the run: the Playground owns the run's record there.
13
11
 
14
- Node statuses are not loaded here: `App` owns that (one coalesced
15
- `fd.runs.requestNodeStatuses()` for Test mode and the Edit-mode run).
12
+ Node statuses are not loaded here. `App` loads them once for Test mode and for the Edit-mode run.
16
13
 
17
- Renders the pill as a floating control of its own (status dot, label, Stop),
18
- meant to sit inside a `Toolbar`.
14
+ **Use it for** seeing the current run at a glance. It is a floating control meant to sit inside a `Toolbar`.
15
+ **Not for** a list of runs (that is `RunsMenu`) or run details (those live in the Playground).
19
16
  -->
20
17
 
21
18
  <script lang="ts">
@@ -15,6 +15,21 @@ interface Props {
15
15
  /** Editor mode the pill is shown in. @default 'edit' */
16
16
  mode?: 'edit' | 'test';
17
17
  }
18
+ /**
19
+ * The run pill in the canvas toolbar (`CanvasToolbar` draws it).
20
+ *
21
+ * It shows only while the instance has a run (`fd.runs.activeRun`); there is no idle pill. It says where the run
22
+ * stands, offers Stop while the run is live and Open (to Test mode) when it waits for a person. In Edit mode it
23
+ * fades out a few seconds after the run ends, and the status badges on the nodes fade with it.
24
+ *
25
+ * In Test mode (`mode="test"`) the pill shows only while the run is live (status and Stop, no Open because you are
26
+ * already there) and never dismisses the run: the Playground owns the run's record there.
27
+ *
28
+ * Node statuses are not loaded here. `App` loads them once for Test mode and for the Edit-mode run.
29
+ *
30
+ * **Use it for** seeing the current run at a glance. It is a floating control meant to sit inside a `Toolbar`.
31
+ * **Not for** a list of runs (that is `RunsMenu`) or run details (those live in the Playground).
32
+ */
18
33
  declare const RunBar: import("svelte").Component<Props, {}, "">;
19
34
  type RunBar = ReturnType<typeof RunBar>;
20
35
  export default RunBar;
@@ -1,17 +1,18 @@
1
1
  <!--
2
- RunsMenu — the Runs list of Test mode: a "Runs" control in the canvas toolbar
3
- that opens a popover listing the workflow's past runs (newest first, paged).
4
-
5
- Read-only apart from two actions: Re-run (a finished run) and Cancel (one
6
- that has not finished). Opening a run shows it on the canvas: its node
7
- statuses become the badges (`fd.runs.openRun`). Everything else (delete,
8
- generate or clear jobs, filters) lives in the host's admin; the footer link
9
- and the per-row link are drawn only when the host gave a URL template
10
- (`features.adminLinks`), so no host path is hard-coded here.
11
-
12
- The list is a plain `<ul>`; each row is a button that opens the run, with its
13
- actions beside it (shown on hover and focus, always on touch). Escape closes
14
- the popover and returns focus to its trigger.
2
+ @component
3
+ The Runs list of Test mode: a "Runs" control in the canvas toolbar that opens a popover with the workflow's
4
+ past runs, newest first, paged.
5
+
6
+ It reads the list from the backend's pipelines endpoint. Each row opens that run on the canvas
7
+ (`fd.runs.openRun`): its node statuses become the badges. A finished run can be run again; one that has not
8
+ finished can be cancelled. Delete, filters and the rest live in the host's admin. The footer link and the
9
+ per-row link are drawn only when the host gave a URL template (`adminLinks`), so no host path is hard-coded here.
10
+
11
+ The list is a plain `<ul>`. Each row is a button, with its actions beside it (shown on hover and focus, always
12
+ on touch). Escape closes the popover and returns focus to its trigger.
13
+
14
+ **Use it for** going back to an earlier run while testing.
15
+ **Not for** the run that is going now (that is `RunBar`).
15
16
  -->
16
17
 
17
18
  <script lang="ts">
@@ -9,6 +9,21 @@ interface Props {
9
9
  run?: string;
10
10
  };
11
11
  }
12
+ /**
13
+ * The Runs list of Test mode: a "Runs" control in the canvas toolbar that opens a popover with the workflow's
14
+ * past runs, newest first, paged.
15
+ *
16
+ * It reads the list from the backend's pipelines endpoint. Each row opens that run on the canvas
17
+ * (`fd.runs.openRun`): its node statuses become the badges. A finished run can be run again; one that has not
18
+ * finished can be cancelled. Delete, filters and the rest live in the host's admin. The footer link and the
19
+ * per-row link are drawn only when the host gave a URL template (`adminLinks`), so no host path is hard-coded here.
20
+ *
21
+ * The list is a plain `<ul>`. Each row is a button, with its actions beside it (shown on hover and focus, always
22
+ * on touch). Escape closes the popover and returns focus to its trigger.
23
+ *
24
+ * **Use it for** going back to an earlier run while testing.
25
+ * **Not for** the run that is going now (that is `RunBar`).
26
+ */
12
27
  declare const RunsMenu: import("svelte").Component<Props, {}, "">;
13
28
  type RunsMenu = ReturnType<typeof RunsMenu>;
14
29
  export default RunsMenu;