@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,20 +1,13 @@
1
1
  <!--
2
- FormArray Component
3
- Dynamic array field that allows adding, removing, and reordering items
4
- Generates sub-forms for each item based on the schema's items property
5
-
6
- Features:
7
- - Add/remove items with animated transitions
8
- - Supports simple types (string, number, boolean) and complex types (objects)
9
- - Recursively uses FormField for item rendering
10
- - Drag handle for future reordering support
11
- - Collapsible items for complex object arrays
12
- - Empty state with helpful prompt
13
-
14
- Accessibility:
15
- - Proper ARIA labels for add/remove buttons
16
- - Keyboard navigation support
17
- - Screen reader friendly item descriptions
2
+ @component
3
+ A list field where the person adds, removes and reorders items. Each item is drawn from the schema's `items`:
4
+ simple types as one control, objects as a small sub-form. Arrays of small objects (up to two scalar fields)
5
+ draw as compact rows through `FormArrayRows`.
6
+
7
+ An empty list shows a short prompt. `minItems` and `maxItems` limit the list. `readOnly` shows the items as a plain list.
8
+
9
+ **Use it for** a config value that is a list: headers, tags, branches.
10
+ **Not for** a fixed set of choices (use `FormCheckboxGroup`).
18
11
  -->
19
12
 
20
13
  <script lang="ts">
@@ -30,6 +30,16 @@ interface Props {
30
30
  /** Callback when value changes */
31
31
  onChange: (value: unknown[]) => void;
32
32
  }
33
+ /**
34
+ * A list field where the person adds, removes and reorders items. Each item is drawn from the schema's `items`:
35
+ * simple types as one control, objects as a small sub-form. Arrays of small objects (up to two scalar fields)
36
+ * draw as compact rows through `FormArrayRows`.
37
+ *
38
+ * An empty list shows a short prompt. `minItems` and `maxItems` limit the list. `readOnly` shows the items as a plain list.
39
+ *
40
+ * **Use it for** a config value that is a list: headers, tags, branches.
41
+ * **Not for** a fixed set of choices (use `FormCheckboxGroup`).
42
+ */
33
43
  declare const FormArray: import("svelte").Component<Props, {}, "">;
34
44
  type FormArray = ReturnType<typeof FormArray>;
35
45
  export default FormArray;
@@ -1,14 +1,14 @@
1
1
  <!--
2
- FormArrayRows — an array of small objects (up to two scalar fields) as a row
3
- list: column headers once, one row per item (a hover grip, a control per
4
- field, a ⋯ menu), nothing boxed.
2
+ @component
3
+ The row layout of `FormArray`, used when each item is a small object with at most two scalar fields: column headers once,
4
+ one row per item with a grip, a control per field and a menu. Nothing is boxed.
5
5
 
6
- Reorder by dragging the grip, with Alt+Up / Alt+Down on a row's control, or
7
- from the ⋯ menu. When the array is the target of an `x-item-ref` field, one row
8
- carries a "default" badge, "Make default" sits in the ⋯ menu, and a line under
9
- the list says what an empty, wired or dangling reference means.
6
+ Rows reorder by dragging the grip, with Alt+Up and Alt+Down, or from the row menu. When another field names one
7
+ of the rows (`x-item-ref`), that row shows a "default" mark and the menu offers "Make default".
8
+ It holds no data of its own; every change goes through the callbacks.
10
9
 
11
- Used by FormArray; it owns no data, every change goes through the callbacks.
10
+ **Use it for** nothing directly. `FormArray` picks it.
11
+ **Not for** arrays of larger objects (`FormArray` draws those as cards).
12
12
  -->
13
13
 
14
14
  <script lang="ts">
@@ -13,6 +13,17 @@ interface Props {
13
13
  /** The reference an item can be marked by (see utils/itemRef.ts). */
14
14
  itemRef?: ItemRef;
15
15
  }
16
+ /**
17
+ * The row layout of `FormArray`, used when each item is a small object with at most two scalar fields: column headers once,
18
+ * one row per item with a grip, a control per field and a menu. Nothing is boxed.
19
+ *
20
+ * Rows reorder by dragging the grip, with Alt+Up and Alt+Down, or from the row menu. When another field names one
21
+ * of the rows (`x-item-ref`), that row shows a "default" mark and the menu offers "Make default".
22
+ * It holds no data of its own; every change goes through the callbacks.
23
+ *
24
+ * **Use it for** nothing directly. `FormArray` picks it.
25
+ * **Not for** arrays of larger objects (`FormArray` draws those as cards).
26
+ */
16
27
  declare const FormArrayRows: import("svelte").Component<Props, {}, "">;
17
28
  type FormArrayRows = ReturnType<typeof FormArrayRows>;
18
29
  export default FormArrayRows;
@@ -1,7 +1,10 @@
1
1
  <!--
2
- FormAutocomplete Component
3
- Text input with autocomplete suggestions fetched from a callback URL
4
-
2
+ @component
3
+ A text input with suggestions fetched from a URL as the person types, for one value or several (shown as removable tags).
4
+
5
+ **Use it for** values that come from a server list, such as users or content types.
6
+ **Not for** a short fixed list (use `FormSelect`).
7
+
5
8
  Features:
6
9
  - Single or multiple selection support
7
10
  - Selected values displayed as removable tags with light blue background
@@ -20,6 +20,29 @@ interface Props {
20
20
  /** Callback when value changes */
21
21
  onChange: (value: string | string[]) => void;
22
22
  }
23
+ /**
24
+ * A text input with suggestions fetched from a URL as the person types, for one value or several (shown as removable tags).
25
+ *
26
+ * **Use it for** values that come from a server list, such as users or content types.
27
+ * **Not for** a short fixed list (use `FormSelect`).
28
+ *
29
+ * Features:
30
+ * - Single or multiple selection support
31
+ * - Selected values displayed as removable tags with light blue background
32
+ * - Debounced fetching on input
33
+ * - Optional fetch on focus
34
+ * - Loading state indicator
35
+ * - Keyboard navigation (arrow keys, enter, escape, backspace to remove)
36
+ * - Click-away to close dropdown
37
+ * - Response mapping with labelField/valueField
38
+ * - Error handling with retry
39
+ * - Full accessibility support (ARIA combobox pattern)
40
+ *
41
+ * Usage:
42
+ * - For single selection: autocomplete.multiple = false (default)
43
+ * - For multiple selection: autocomplete.multiple = true
44
+ * - Selected values appear as tags with "x" button to remove
45
+ */
23
46
  declare const FormAutocomplete: import("svelte").Component<Props, {}, "">;
24
47
  type FormAutocomplete = ReturnType<typeof FormAutocomplete>;
25
48
  export default FormAutocomplete;
@@ -1,9 +1,9 @@
1
1
  <!--
2
- FormCheckboxGroup Component
3
- Checkbox group for multiple value selection (enum with multiple=true)
4
-
5
- Features:
6
- - Checkbox primitive per option: no box around the group
2
+ @component
3
+ A list of checkboxes for choosing several values from a fixed set.
4
+
5
+ **Use it for** an `enum` with `multiple: true`.
6
+ **Not for** one choice (use `FormSelect`) or a single yes or no (use `FormToggle`).
7
7
  -->
8
8
 
9
9
  <script lang="ts">
@@ -12,6 +12,12 @@ interface Props {
12
12
  /** Callback when value changes */
13
13
  onChange: (value: string[]) => void;
14
14
  }
15
+ /**
16
+ * A list of checkboxes for choosing several values from a fixed set.
17
+ *
18
+ * **Use it for** an `enum` with `multiple: true`.
19
+ * **Not for** one choice (use `FormSelect`) or a single yes or no (use `FormToggle`).
20
+ */
15
21
  declare const FormCheckboxGroup: import("svelte").Component<Props, {}, "">;
16
22
  type FormCheckboxGroup = ReturnType<typeof FormCheckboxGroup>;
17
23
  export default FormCheckboxGroup;
@@ -1,17 +1,12 @@
1
1
  <!--
2
- FormCodeEditor Component
3
- CodeMirror-based code editor for JSON and other structured data
4
-
5
- Features:
6
- - JSON syntax highlighting with CodeMirror 6
7
- - Real-time JSON validation with error display
8
- - Auto-formatting on blur (optional)
9
- - Dark/light theme support
10
- - Consistent styling with other form components
11
- - Proper ARIA attributes for accessibility
12
-
13
- Usage:
14
- Use with schema format: "json" or format: "code" to render this editor
2
+ @component
3
+ A code editor for JSON and other structured values, built on CodeMirror 6. It checks the JSON as the person types,
4
+ shows the error under the editor, and can format on blur.
5
+
6
+ Schema fields with `format: "json"` or `format: "code"` draw this. It is bundled only in `form/full` or when registered with `registerCodeEditorField()`.
7
+
8
+ **Use it for** an object or a block of JSON in a node's config.
9
+ **Not for** prose (use `FormTextarea` or `FormMarkdownEditor`).
15
10
  -->
16
11
 
17
12
  <script lang="ts">
@@ -20,6 +20,15 @@ interface Props {
20
20
  /** Callback when value changes */
21
21
  onChange: (value: unknown) => void;
22
22
  }
23
+ /**
24
+ * A code editor for JSON and other structured values, built on CodeMirror 6. It checks the JSON as the person types,
25
+ * shows the error under the editor, and can format on blur.
26
+ *
27
+ * Schema fields with `format: "json"` or `format: "code"` draw this. It is bundled only in `form/full` or when registered with `registerCodeEditorField()`.
28
+ *
29
+ * **Use it for** an object or a block of JSON in a node's config.
30
+ * **Not for** prose (use `FormTextarea` or `FormMarkdownEditor`).
31
+ */
23
32
  declare const FormCodeEditor: import("svelte").Component<Props, {}, "">;
24
33
  type FormCodeEditor = ReturnType<typeof FormCodeEditor>;
25
34
  export default FormCodeEditor;
@@ -1,14 +1,13 @@
1
1
  <!--
2
- FormField Component (exported as `FormFieldFull` from "@flowdrop/flowdrop/form/full")
2
+ @component
3
+ The field factory with every editor built in. Give it a field schema and a value and it draws the right control
4
+ inside a `FormFieldWrapper`: text, number, switch, select, range, checkboxes, code, markdown or template.
3
5
 
4
- The field factory with every heavy editor statically bundled, so code,
5
- markdown and template fields work without registering anything. All field
6
- resolution lives in FieldFactory; this file only hands it the editors. A component
7
- registered on the instance's field registry still wins over these.
6
+ It is exported as `FormFieldFull` from `@flowdrop/flowdrop/form/full`. The editor itself uses the lighter `FormFieldLight`.
7
+ A component registered on the instance's field registry wins over the built-in ones.
8
8
 
9
- It used to be a second, parallel factory. The two drifted: the light one lost
10
- the built-in autocomplete and readOnly handling, and since the config panel
11
- renders the light one, those bugs were the ones users saw.
9
+ **Use it for** rendering one field from a schema when you want code, markdown and template editors without registering anything.
10
+ **Not for** a whole form (use `SchemaForm` or `ConfigForm`).
12
11
  -->
13
12
 
14
13
  <script lang="ts">
@@ -1,4 +1,14 @@
1
1
  import type { FormFieldFactoryProps } from './types.js';
2
+ /**
3
+ * The field factory with every editor built in. Give it a field schema and a value and it draws the right control
4
+ * inside a `FormFieldWrapper`: text, number, switch, select, range, checkboxes, code, markdown or template.
5
+ *
6
+ * It is exported as `FormFieldFull` from `@flowdrop/flowdrop/form/full`. The editor itself uses the lighter `FormFieldLight`.
7
+ * A component registered on the instance's field registry wins over the built-in ones.
8
+ *
9
+ * **Use it for** rendering one field from a schema when you want code, markdown and template editors without registering anything.
10
+ * **Not for** a whole form (use `SchemaForm` or `ConfigForm`).
11
+ */
2
12
  declare const FormField: import("svelte").Component<FormFieldFactoryProps, {}, "">;
3
13
  type FormField = ReturnType<typeof FormField>;
4
14
  export default FormField;
@@ -1,10 +1,11 @@
1
1
  <!--
2
- FormFieldLight Component (exported as `FormField` from "@flowdrop/flowdrop/form")
2
+ @component
3
+ The field factory without the heavy editors. It is exported as `FormField` from `@flowdrop/flowdrop/form`, and the editor's
4
+ config form uses it. Code, markdown and template fields draw through the instance's field registry,
5
+ or as a plain textarea with a hint when nothing is registered.
3
6
 
4
- The field factory without heavy editors: code, markdown and template fields
5
- render through the instance's field registry, or as a plain textarea with a
6
- hint naming the registration call. All field resolution lives in
7
- FieldFactory; see its header for the order.
7
+ **Use it for** rendering one field from a schema while keeping CodeMirror out of your bundle.
8
+ **Not for** a whole form (use `SchemaForm` or `ConfigForm`).
8
9
  -->
9
10
 
10
11
  <script lang="ts">
@@ -1,4 +1,12 @@
1
1
  import type { FormFieldFactoryProps } from './types.js';
2
+ /**
3
+ * The field factory without the heavy editors. It is exported as `FormField` from `@flowdrop/flowdrop/form`, and the editor's
4
+ * config form uses it. Code, markdown and template fields draw through the instance's field registry,
5
+ * or as a plain textarea with a hint when nothing is registered.
6
+ *
7
+ * **Use it for** rendering one field from a schema while keeping CodeMirror out of your bundle.
8
+ * **Not for** a whole form (use `SchemaForm` or `ConfigForm`).
9
+ */
2
10
  declare const FormFieldLight: import("svelte").Component<FormFieldFactoryProps, {}, "">;
3
11
  type FormFieldLight = ReturnType<typeof FormFieldLight>;
4
12
  export default FormFieldLight;
@@ -1,12 +1,12 @@
1
1
  <!--
2
- FormFieldWrapper Component
3
- Provides consistent layout for form fields with label, description, and animations
4
-
5
- Features:
6
- - Proper label associations with for/id attributes
7
- - ARIA describedby for field descriptions
8
- - Staggered fade-in animations
9
- - Required field indicators
2
+ @component
3
+ The frame around one form field: the label, a required mark, the help text under the field, and the field itself as children.
4
+
5
+ `inline` puts a switch on the label's row. `plain` is for section-style fields such as the ports list,
6
+ where the label is for screen readers only. `aside` adds a short muted note on the label row.
7
+
8
+ **Use it for** giving a custom field the same label and help text as the built-in ones.
9
+ **Not for** choosing which control to draw from a schema (that is `FormField`, which wraps its fields in this).
10
10
  -->
11
11
 
12
12
  <script lang="ts">
@@ -23,6 +23,15 @@ interface Props {
23
23
  /** Slot content for the field input */
24
24
  children: Snippet;
25
25
  }
26
+ /**
27
+ * The frame around one form field: the label, a required mark, the help text under the field, and the field itself as children.
28
+ *
29
+ * `inline` puts a switch on the label's row. `plain` is for section-style fields such as the ports list,
30
+ * where the label is for screen readers only. `aside` adds a short muted note on the label row.
31
+ *
32
+ * **Use it for** giving a custom field the same label and help text as the built-in ones.
33
+ * **Not for** choosing which control to draw from a schema (that is `FormField`, which wraps its fields in this).
34
+ */
26
35
  declare const FormFieldWrapper: import("svelte").Component<Props, {}, "">;
27
36
  type FormFieldWrapper = ReturnType<typeof FormFieldWrapper>;
28
37
  export default FormFieldWrapper;
@@ -1,16 +1,10 @@
1
1
  <!--
2
- FormFieldset Component
3
- Renders a UISchema Group element as a collapsible or static fieldset.
4
-
5
- Two rendering modes:
6
- - Collapsible (default): Uses HTML5 <details>/<summary> with .flowdrop-details CSS
7
- - Static (collapsible: false): Uses a styled <fieldset> with <legend>
8
-
9
- Features:
10
- - HTML5 <details> for native accessible collapse behavior
11
- - Reuses existing .flowdrop-details CSS pattern from base.css
12
- - Optional description text below the group title
13
- - Chevron rotation animation on open/close
2
+ @component
3
+ A titled group of fields, drawn from a `Group` in a node's UI schema. By default it folds open and closed;
4
+ with `collapsible: false` it is a plain fieldset with a legend.
5
+
6
+ **Use it for** splitting a long config form into sections.
7
+ **Not for** the tabs of the inspector (those are `NodeInspector`).
14
8
  -->
15
9
 
16
10
  <script lang="ts">
@@ -6,6 +6,13 @@ interface Props {
6
6
  /** Slot content for the group's child elements */
7
7
  children: Snippet;
8
8
  }
9
+ /**
10
+ * A titled group of fields, drawn from a `Group` in a node's UI schema. By default it folds open and closed;
11
+ * with `collapsible: false` it is a plain fieldset with a legend.
12
+ *
13
+ * **Use it for** splitting a long config form into sections.
14
+ * **Not for** the tabs of the inspector (those are `NodeInspector`).
15
+ */
9
16
  declare const FormFieldset: import("svelte").Component<Props, {}, "">;
10
17
  type FormFieldset = ReturnType<typeof FormFieldset>;
11
18
  export default FormFieldset;
@@ -1,19 +1,12 @@
1
1
  <!--
2
- FormMarkdownEditor Component
3
- CodeMirror 6-based Markdown editor for rich text content
4
-
5
- Features:
6
- - Full Markdown editing with CodeMirror 6
7
- - Markdown syntax highlighting via @codemirror/lang-markdown
8
- - Toolbar with common formatting options + keyboard shortcuts
9
- - Autosave support (optional, localStorage)
10
- - Status bar with word/line/character count
11
- - Consistent styling with other form components
12
- - Proper ARIA attributes for accessibility
13
- - Dark/light theme support
14
-
15
- Usage:
16
- Use with schema format: "markdown" to render this editor
2
+ @component
3
+ A Markdown editor built on CodeMirror 6: syntax colours, a formatting toolbar with shortcuts, a status bar with word and line
4
+ counts, and optional autosave to the browser.
5
+
6
+ Schema fields with `format: "markdown"` draw this. It is bundled only in `form/full` or when registered with `registerMarkdownEditorField()`.
7
+
8
+ **Use it for** longer formatted text such as a note or an instruction.
9
+ **Not for** one-line text (use `FormTextField`).
17
10
  -->
18
11
 
19
12
  <script lang="ts">
@@ -28,6 +28,15 @@ interface Props {
28
28
  /** Callback when value changes */
29
29
  onChange: (value: string) => void;
30
30
  }
31
+ /**
32
+ * A Markdown editor built on CodeMirror 6: syntax colours, a formatting toolbar with shortcuts, a status bar with word and line
33
+ * counts, and optional autosave to the browser.
34
+ *
35
+ * Schema fields with `format: "markdown"` draw this. It is bundled only in `form/full` or when registered with `registerMarkdownEditorField()`.
36
+ *
37
+ * **Use it for** longer formatted text such as a note or an instruction.
38
+ * **Not for** one-line text (use `FormTextField`).
39
+ */
31
40
  declare const FormMarkdownEditor: import("svelte").Component<Props, {}, "">;
32
41
  type FormMarkdownEditor = ReturnType<typeof FormMarkdownEditor>;
33
42
  export default FormMarkdownEditor;
@@ -1,11 +1,9 @@
1
1
  <!--
2
- FormNumberField Component
3
- Number input field for numeric values
4
-
5
- Features:
6
- - Tabular numeric font for alignment
7
- - Min/max/step support
8
- - Proper ARIA attributes for accessibility
2
+ @component
3
+ A number input with optional `min`, `max` and `step`. The value is a number, or an empty string when the box is cleared.
4
+
5
+ **Use it for** counts, limits and timeouts. The factory picks it for `type: "number"` and `"integer"`.
6
+ **Not for** a value the person should drag within a range (use `FormRangeField`).
9
7
  -->
10
8
 
11
9
  <script lang="ts">
@@ -20,6 +20,12 @@ interface Props {
20
20
  /** Callback when value changes */
21
21
  onChange: (value: number | string) => void;
22
22
  }
23
+ /**
24
+ * A number input with optional `min`, `max` and `step`. The value is a number, or an empty string when the box is cleared.
25
+ *
26
+ * **Use it for** counts, limits and timeouts. The factory picks it for `type: "number"` and `"integer"`.
27
+ * **Not for** a value the person should drag within a range (use `FormRangeField`).
28
+ */
23
29
  declare const FormNumberField: import("svelte").Component<Props, {}, "">;
24
30
  type FormNumberField = ReturnType<typeof FormNumberField>;
25
31
  export default FormNumberField;