@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,7 +1,18 @@
1
1
  interface Props {
2
+ /** The text to show. */
2
3
  label: string;
4
+ /** Extra classes on the root. */
3
5
  class?: string;
4
6
  }
7
+ /**
8
+ * StatusLabel: a small text label for a status.
9
+ *
10
+ * Exported for host apps; the editor uses `StatusPill` instead. It only styles the text you
11
+ * pass, so get the word from your own status mapping.
12
+ *
13
+ * **Use it for** a plain status word in your own list.
14
+ * **Not for** a status with an icon or colour; use `StatusPill`.
15
+ */
5
16
  declare const StatusLabel: import("svelte").Component<Props, {}, "">;
6
17
  type StatusLabel = ReturnType<typeof StatusLabel>;
7
18
  export default StatusLabel;
@@ -1,10 +1,13 @@
1
1
  <!--
2
- Theme Toggle Component
3
- A button that cycles through light, dark, and auto theme modes.
4
- Displays the icon for the current theme state.
2
+ @component
3
+ ThemeToggle: a button that cycles the theme: light, dark, auto (and host, when the host app
4
+ sets a colour scheme). The icon shows the current choice and the tooltip says what a click does.
5
5
 
6
- Built on the shared Button primitive so it stays visually and dimensionally
7
- aligned with every other control (height, focus ring, hover) for free.
6
+ Exported for host apps; the editor sets the theme in its settings panel instead. It is built on the primitive
7
+ Button, so height and focus ring match other controls. The choice is stored in the settings store.
8
+
9
+ **Use it for** a theme switch in your own toolbar.
10
+ **Not for** the editor's own settings; those have their own theme picker.
8
11
  -->
9
12
 
10
13
  <script lang="ts">
@@ -9,6 +9,16 @@ interface Props {
9
9
  /** Custom class name for styling */
10
10
  class?: string;
11
11
  }
12
+ /**
13
+ * ThemeToggle: a button that cycles the theme: light, dark, auto (and host, when the host app
14
+ * sets a colour scheme). The icon shows the current choice and the tooltip says what a click does.
15
+ *
16
+ * Exported for host apps; the editor sets the theme in its settings panel instead. It is built on the primitive
17
+ * Button, so height and focus ring match other controls. The choice is stored in the settings store.
18
+ *
19
+ * **Use it for** a theme switch in your own toolbar.
20
+ * **Not for** the editor's own settings; those have their own theme picker.
21
+ */
12
22
  declare const ThemeToggle: import("svelte").Component<Props, {}, "">;
13
23
  type ThemeToggle = ReturnType<typeof ThemeToggle>;
14
24
  export default ThemeToggle;
@@ -1,10 +1,18 @@
1
1
  <!--
2
- Universal Node Component
3
- Renders any node type with automatic status overlay injection.
4
- This component can replace individual node components in SvelteFlow.
2
+ @component
3
+ The one node type the canvas registers. It picks the card for a node and adds what every
4
+ card shares.
5
5
 
6
- Uses the node component registry to resolve which component to render,
7
- enabling custom node types to be registered and used dynamically.
6
+ It resolves the card from the node type registry: `config.nodeType` first, then
7
+ `metadata.type`, then the standard card. It then adds the run status (pill, and in Test mode
8
+ the status border, a dim for nodes the run did not reach, and the `edited` mark), the
9
+ Doctor's finding, and Enter/Space to open the config.
10
+
11
+ The status comes from the instance's playground store (`nodeStatusFor`), keyed by node id.
12
+ `data.executionInfo` is a deprecated fallback.
13
+
14
+ **Use it for** `nodeTypes.universalNode` in a canvas.
15
+ **Not for** a card of your own; register it with the node type registry instead.
8
16
  -->
9
17
 
10
18
  <script lang="ts">
@@ -10,6 +10,21 @@ type $$ComponentProps = {
10
10
  };
11
11
  selected?: boolean;
12
12
  };
13
+ /**
14
+ * The one node type the canvas registers. It picks the card for a node and adds what every
15
+ * card shares.
16
+ *
17
+ * It resolves the card from the node type registry: `config.nodeType` first, then
18
+ * `metadata.type`, then the standard card. It then adds the run status (pill, and in Test mode
19
+ * the status border, a dim for nodes the run did not reach, and the `edited` mark), the
20
+ * Doctor's finding, and Enter/Space to open the config.
21
+ *
22
+ * The status comes from the instance's playground store (`nodeStatusFor`), keyed by node id.
23
+ * `data.executionInfo` is a deprecated fallback.
24
+ *
25
+ * **Use it for** `nodeTypes.universalNode` in a canvas.
26
+ * **Not for** a card of your own; register it with the node type registry instead.
27
+ */
13
28
  declare const UniversalNode: import("svelte").Component<$$ComponentProps, {}, "">;
14
29
  type UniversalNode = ReturnType<typeof UniversalNode>;
15
30
  export default UniversalNode;
@@ -21,7 +21,7 @@
21
21
  <script lang="ts">
22
22
  import Icon from '@iconify/svelte';
23
23
  import Button from './Button.svelte';
24
- import IconButton from './IconButton.svelte';
24
+ import IconButton from './primitives/IconButton.svelte';
25
25
  import Input from './Input.svelte';
26
26
  import Select from './primitives/Select.svelte';
27
27
  import Checkbox from './primitives/Checkbox.svelte';
@@ -18,7 +18,7 @@
18
18
  <script lang="ts">
19
19
  import Icon from '@iconify/svelte';
20
20
  import Button from './Button.svelte';
21
- import IconButton from './IconButton.svelte';
21
+ import IconButton from './primitives/IconButton.svelte';
22
22
  import { m } from '../messages/index.js';
23
23
  import type { RankedBindablePort } from '../utils/workflowInterface.js';
24
24
  import BindablePortListbox from './BindablePortListbox.svelte';
@@ -83,7 +83,6 @@
83
83
  </div>
84
84
  </div>
85
85
  <IconButton
86
- size="sm"
87
86
  class="wf-composer__close"
88
87
  ariaLabel={m().workflowInterface.composerClose}
89
88
  onclick={onCancel}
@@ -1,14 +1,17 @@
1
1
  <!--
2
- Zoom Tier Component
3
- Renderless. Publishes the canvas zoom tier as `data-fd-zoom` (full | outline |
4
- glyph | map) on the editor root, so nodes, status overlays and interface tags
5
- restyle themselves in CSS (see utils/zoomTier.ts). The tiers that are on, and
6
- where each starts, come from `editor.zoomTiers`; the tier is recomputed when
7
- that setting changes. The root is `.flowdrop-root`, or the canvas itself when
8
- the editor is mounted without one. Must be rendered inside <SvelteFlow>.
9
-
10
- Only the tier is published, never the zoom: every drawing is in fixed flow px
11
- and Svelte Flow scales the canvas, so nothing in CSS needs the zoom value.
2
+ @component
3
+ Publishes the canvas zoom tier as `data-fd-zoom` (`full`, `outline`, `glyph` or `map`) on the
4
+ editor root, so nodes, status overlays and interface tags restyle themselves in CSS.
5
+
6
+ Where each tier starts comes from the `editor.zoomTiers` setting; the tier is recomputed when
7
+ the setting changes. The root is `.flowdrop-root`, or the canvas itself when the editor is
8
+ mounted without one. Only the tier is published, never the zoom: every drawing is in fixed
9
+ flow px and Svelte Flow scales the canvas.
10
+
11
+ Renders nothing. Render it inside `<SvelteFlow>`.
12
+
13
+ **Use it for** a canvas that should draw less detail as it zooms out.
14
+ **Not for** the zoom buttons; those are `CanvasZoomControls`.
12
15
  -->
13
16
 
14
17
  <script lang="ts">
@@ -1,4 +1,18 @@
1
1
  import { type ZoomTier } from '../utils/zoomTier.js';
2
+ /**
3
+ * Publishes the canvas zoom tier as `data-fd-zoom` (`full`, `outline`, `glyph` or `map`) on the
4
+ * editor root, so nodes, status overlays and interface tags restyle themselves in CSS.
5
+ *
6
+ * Where each tier starts comes from the `editor.zoomTiers` setting; the tier is recomputed when
7
+ * the setting changes. The root is `.flowdrop-root`, or the canvas itself when the editor is
8
+ * mounted without one. Only the tier is published, never the zoom: every drawing is in fixed
9
+ * flow px and Svelte Flow scales the canvas.
10
+ *
11
+ * Renders nothing. Render it inside `<SvelteFlow>`.
12
+ *
13
+ * **Use it for** a canvas that should draw less detail as it zooms out.
14
+ * **Not for** the zoom buttons; those are `CanvasZoomControls`.
15
+ */
2
16
  declare const ZoomTier: import("svelte").Component<Record<string, never>, {}, "">;
3
17
  type ZoomTier = ReturnType<typeof ZoomTier>;
4
18
  export default ZoomTier;
@@ -1,7 +1,13 @@
1
1
  <!--
2
- CommandConsole Component
3
- Bottom-panel REPL shell for the FlowDrop Command DSL
4
- Styled with BEM syntax matching ConfigPanel pattern
2
+ @component
3
+ The editor's Console: a terminal-style panel for the FlowDrop command language (`list nodes`, `add ...`,
4
+ `help`) and for `session` commands that drive runs.
5
+
6
+ Commands act on the workflow open in the instance (`getInstance()`). With no workflow loaded they answer
7
+ "No workflow loaded". An empty Console offers a few read-only example commands to click.
8
+
9
+ **Use it for** inspecting and editing the workflow by typing, and for scripted batches.
10
+ **Not for** the open/close toggle (that is `ConsoleStrip`).
5
11
  -->
6
12
 
7
13
  <script lang="ts">
@@ -8,6 +8,16 @@ interface Props {
8
8
  /** Id of the panel element, so the toggle strip can point `aria-controls` at it */
9
9
  id?: string;
10
10
  }
11
+ /**
12
+ * The editor's Console: a terminal-style panel for the FlowDrop command language (`list nodes`, `add ...`,
13
+ * `help`) and for `session` commands that drive runs.
14
+ *
15
+ * Commands act on the workflow open in the instance (`getInstance()`). With no workflow loaded they answer
16
+ * "No workflow loaded". An empty Console offers a few read-only example commands to click.
17
+ *
18
+ * **Use it for** inspecting and editing the workflow by typing, and for scripted batches.
19
+ * **Not for** the open/close toggle (that is `ConsoleStrip`).
20
+ */
11
21
  declare const CommandConsole: import("svelte").Component<Props, {}, "">;
12
22
  type CommandConsole = ReturnType<typeof CommandConsole>;
13
23
  export default CommandConsole;
@@ -1,8 +1,8 @@
1
1
  <!--
2
- ConsoleAutocomplete Component
3
- Dropdown suggestion list for command verbs and node type IDs
4
- Positioned above the input, max 8 visible items, scrollable
5
- Styled with BEM syntax matching console component pattern
2
+ @component
3
+ The suggestion list above the Console input: command verbs and node type ids, at most eight rows visible, scrollable.
4
+
5
+ **Use it for** completing a command while typing in `ConsoleInput`.
6
6
  -->
7
7
 
8
8
  <script lang="ts">
@@ -22,6 +22,11 @@ interface Props {
22
22
  */
23
23
  listboxId: string;
24
24
  }
25
+ /**
26
+ * The suggestion list above the Console input: command verbs and node type ids, at most eight rows visible, scrollable.
27
+ *
28
+ * **Use it for** completing a command while typing in `ConsoleInput`.
29
+ */
25
30
  declare const ConsoleAutocomplete: import("svelte").Component<Props, {}, "">;
26
31
  type ConsoleAutocomplete = ReturnType<typeof ConsoleAutocomplete>;
27
32
  export default ConsoleAutocomplete;
@@ -1,8 +1,10 @@
1
1
  <!--
2
- ConsoleInput Component
3
- Single-line command input with prompt prefix, Enter-to-submit, Escape-to-close
4
- Includes autocomplete for command verbs and node type IDs
5
- Styled with BEM syntax matching CommandConsole pattern
2
+ @component
3
+ The one-line command input of the Console: a prompt, Enter to run, Escape to close, history, multi-line paste
4
+ as a batch, and autocomplete for command verbs and node type ids.
5
+
6
+ **Use it for** typing a command inside `CommandConsole`.
7
+ **Not for** general text entry (use the `Input` primitive).
6
8
  -->
7
9
 
8
10
  <script lang="ts">
@@ -11,6 +11,13 @@ interface Props {
11
11
  /** Called when user presses Escape to close the console */
12
12
  onClose: () => void;
13
13
  }
14
+ /**
15
+ * The one-line command input of the Console: a prompt, Enter to run, Escape to close, history, multi-line paste
16
+ * as a batch, and autocomplete for command verbs and node type ids.
17
+ *
18
+ * **Use it for** typing a command inside `CommandConsole`.
19
+ * **Not for** general text entry (use the `Input` primitive).
20
+ */
14
21
  declare const ConsoleInput: import("svelte").Component<Props, {}, "">;
15
22
  type ConsoleInput = ReturnType<typeof ConsoleInput>;
16
23
  export default ConsoleInput;
@@ -1,7 +1,9 @@
1
1
  <!--
2
- ConsoleOutput Component
3
- Scrollable output area for displaying command results in the console
4
- Styled with BEM syntax matching CommandConsole pattern
2
+ @component
3
+ The scrolling output area of the Console. It draws the lines you typed, results, errors and formatted tables,
4
+ with the command language highlighted, and stays scrolled to the newest line.
5
+
6
+ **Use it for** showing command results inside `CommandConsole`.
5
7
  -->
6
8
 
7
9
  <script lang="ts">
@@ -6,6 +6,12 @@ interface Props {
6
6
  /** Output entries to display */
7
7
  entries: ConsoleEntry[];
8
8
  }
9
+ /**
10
+ * The scrolling output area of the Console. It draws the lines you typed, results, errors and formatted tables,
11
+ * with the command language highlighted, and stays scrolled to the newest line.
12
+ *
13
+ * **Use it for** showing command results inside `CommandConsole`.
14
+ */
9
15
  declare const ConsoleOutput: import("svelte").Component<Props, {}, "">;
10
16
  type ConsoleOutput = ReturnType<typeof ConsoleOutput>;
11
17
  export default ConsoleOutput;
@@ -1,9 +1,13 @@
1
1
  <!--
2
- ConsoleStrip — the slim bar along the canvas's bottom edge that opens the
3
- Command Console. Closed, it is the whole control ("›_ Console"; the ` shortcut
4
- is in its tooltip); open, it
5
- becomes the panel's header, so the panel needs no close button of its own.
6
- One button: `aria-expanded` says which, `aria-controls` names the panel.
2
+ @component
3
+ The slim bar along the canvas's bottom edge that opens the Command Console.
4
+
5
+ Closed, it is the whole control ("›_ Console"; its tooltip shows the backquote shortcut). Open, it becomes the panel's
6
+ header, so the panel needs no close button of its own. It is one button: `aria-expanded` says which state it is
7
+ in and `aria-controls` names the panel.
8
+
9
+ **Use it for** opening and closing the Console.
10
+ **Not for** the Console itself (that is `CommandConsole`).
7
11
  -->
8
12
 
9
13
  <script lang="ts">
@@ -8,6 +8,16 @@ interface Props {
8
8
  /** Toggle the panel. */
9
9
  onToggle: () => void;
10
10
  }
11
+ /**
12
+ * The slim bar along the canvas's bottom edge that opens the Command Console.
13
+ *
14
+ * Closed, it is the whole control ("›_ Console"; its tooltip shows the backquote shortcut). Open, it becomes the panel's
15
+ * header, so the panel needs no close button of its own. It is one button: `aria-expanded` says which state it is
16
+ * in and `aria-controls` names the panel.
17
+ *
18
+ * **Use it for** opening and closing the Console.
19
+ * **Not for** the Console itself (that is `CommandConsole`).
20
+ */
11
21
  declare const ConsoleStrip: import("svelte").Component<Props, {}, "">;
12
22
  type ConsoleStrip = ReturnType<typeof ConsoleStrip>;
13
23
  export default ConsoleStrip;
@@ -1,6 +1,10 @@
1
1
  <!--
2
- FieldFactory Component (internal — not exported)
3
- Factory component that renders the appropriate field based on schema type.
2
+ @component
3
+ The one field factory: it looks at a field's schema and draws the matching control inside a `FormFieldWrapper`.
4
+ Not exported; `FormField` and `FormFieldLight` are its public wrappers.
5
+
6
+ **Use it for** nothing directly. Use `FormField` or `FormFieldLight`.
7
+ **Not for** a whole form (use `SchemaForm` or `ConfigForm`).
4
8
 
5
9
  The one field factory. The public components are thin wrappers around it:
6
10
  - FormFieldLight (exported as `FormField` from "@flowdrop/flowdrop/form")
@@ -9,6 +9,52 @@ interface Props extends FormFieldFactoryProps {
9
9
  */
10
10
  editors?: Partial<Record<HeavyEditorKind, FieldComponent>>;
11
11
  }
12
+ /**
13
+ * The one field factory: it looks at a field's schema and draws the matching control inside a `FormFieldWrapper`.
14
+ * Not exported; `FormField` and `FormFieldLight` are its public wrappers.
15
+ *
16
+ * **Use it for** nothing directly. Use `FormField` or `FormFieldLight`.
17
+ * **Not for** a whole form (use `SchemaForm` or `ConfigForm`).
18
+ *
19
+ * The one field factory. The public components are thin wrappers around it:
20
+ * - FormFieldLight (exported as `FormField` from "@flowdrop/flowdrop/form")
21
+ * passes no editors, so CodeMirror stays out of the light entry
22
+ * - FormField (exported as `FormFieldFull` from "@flowdrop/flowdrop/form/full")
23
+ * passes the statically imported code, markdown and template editors
24
+ *
25
+ * Heavy editors (code, markdown, template) are not imported here; they come
26
+ * from, in order:
27
+ * - the instance's field registry — `registerCodeEditorField()` from
28
+ * "@flowdrop/flowdrop/form/code", `registerMarkdownEditorField()` from
29
+ * "@flowdrop/flowdrop/form/markdown", or any host override
30
+ * - the `editors` prop, which only the two wrappers above set
31
+ * - otherwise a plain textarea with a hint naming the registration call
32
+ *
33
+ * Features:
34
+ * - Automatically selects the correct field component based on schema
35
+ * - Wraps fields with FormFieldWrapper for consistent layout
36
+ * - Supports all basic field types (string, number, boolean, checkbox group, range)
37
+ * - Uses standard JSON Schema patterns (enum, oneOf) for select fields
38
+ * - schema.readOnly disables every input, built-in or registered
39
+ *
40
+ * Type Resolution Order:
41
+ * 1. Check field registry for custom/heavy components (highest priority)
42
+ * 2. format: 'hidden' -> skip rendering (return nothing)
43
+ * 3. format: 'autocomplete' with autocomplete.url -> FormAutocomplete
44
+ * 4. format: 'json' | 'code' | 'markdown' | 'template', or type: 'object' with
45
+ * no format of its own -> `editors` prop, else the textarea fallback
46
+ * 5. format: 'ports' -> FormPorts
47
+ * 6. enum with multiple: true -> FormCheckboxGroup
48
+ * 7. enum -> FormSelect (simple values without labels)
49
+ * 8. oneOf with const/title (labeled options) -> FormSelect
50
+ * 9. format: 'multiline' -> FormTextarea
51
+ * 10. format: 'range' (number/integer) -> FormRangeField
52
+ * 11. type: 'string' -> FormTextField
53
+ * 12. type: 'number' or 'integer' -> FormNumberField
54
+ * 13. type: 'boolean' -> FormToggle
55
+ * 14. type: 'array' -> FormArray
56
+ * 15. fallback -> FormTextField
57
+ */
12
58
  declare const FieldFactory: import("svelte").Component<Props, {}, "">;
13
59
  type FieldFactory = ReturnType<typeof FieldFactory>;
14
60
  export default FieldFactory;
@@ -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;