@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,15 +1,10 @@
1
1
  <!--
2
- PlaygroundApp Component
2
+ @component
3
+ **Legacy.** A full-page Playground with the FlowDrop navbar on top. It is deprecated in favour of the editor's Test mode and removed in 3.0. It warns once per page when mounted.
4
+ It pairs the navbar with `PlaygroundStudio`. When you import it directly (not through `mountPlaygroundApp`), call `initializeSettings()` first, because the navbar's settings modal reads the settings store.
3
5
 
4
- Full-page playground wrapper that pairs the FlowDrop Navbar with
5
- PlaygroundStudio.
6
-
7
- When importing this component directly (rather than via mountPlaygroundApp),
8
- call initializeSettings() before mount — the navbar's settings modal reads
9
- from the settings store.
10
-
11
- @deprecated The standalone Playground is deprecated in favour of the editor's
12
- Test mode and removed in 3.0. It warns once per page when mounted.
6
+ **Use it for** existing full-page standalone Playgrounds.
7
+ **Not for** new work; use the editor's Test mode (`DockedPlayground`) instead.
13
8
  -->
14
9
 
15
10
  <script lang="ts">
@@ -28,26 +23,45 @@
28
23
  warnStandalonePlaygroundDeprecated();
29
24
 
30
25
  interface Props {
26
+ /** Id of the workflow to test. */
31
27
  workflowId: string;
28
+ /** A pre-loaded workflow. Default: fetched by id. */
32
29
  workflow?: Workflow;
30
+ /** Display mode. Default: standalone. */
33
31
  mode?: 'standalone' | 'embedded';
32
+ /** API endpoints. Default: the page default. */
34
33
  endpointConfig?: EndpointConfig;
35
34
  /** Auth provider applied to this instance's API requests. */
36
35
  authProvider?: AuthProvider;
36
+ /** Playground options. Default: none. */
37
37
  config?: PlaygroundConfig;
38
+ /** Show the navbar on top. Default: false. */
38
39
  showNavbar?: boolean;
40
+ /** Title in the navbar. Default: none. */
39
41
  navbarTitle?: string;
42
+ /** Extra action buttons in the navbar. Default: none. */
40
43
  primaryActions?: NavbarAction[];
44
+ /** Logo and name for the navbar. Default: none. */
41
45
  branding?: NavbarBranding;
46
+ /** Show the settings button. Default: true. */
42
47
  showSettings?: boolean;
48
+ /** Settings categories to offer. Default: all. */
43
49
  settingsCategories?: SettingsCategory[];
50
+ /** Show the sync button in settings. Default: the settings default. */
44
51
  showSettingsSyncButton?: boolean;
52
+ /** Show the reset button in settings. Default: the settings default. */
45
53
  showSettingsResetButton?: boolean;
54
+ /** Session to open on mount. Default: none. */
46
55
  initialSessionId?: string;
56
+ /** Whether the pipeline panel starts open. Default: the stored choice. */
47
57
  initialPipelineOpen?: boolean;
58
+ /** Minimum width of the chat side in px. Default: 760. */
48
59
  minChatWidth?: number;
60
+ /** Starting width of the pipeline panel in px. Default: 500. */
49
61
  initialPipelineWidth?: number;
62
+ /** Called when the user closes the Playground. */
50
63
  onClose?: () => void;
64
+ /** Called with the session id after a switch, so a host can update its URL. */
51
65
  onSessionNavigate?: (sessionId: string) => void;
52
66
  /** Per-instance state container — forwarded to the inner PlaygroundStudio */
53
67
  instance?: FlowDropInstance;
@@ -6,30 +6,56 @@ import type { PlaygroundConfig } from '../../types/playground.js';
6
6
  import type { SettingsCategory } from '../../types/settings.js';
7
7
  import type { NavbarAction, NavbarBranding } from '../../types/navbar.js';
8
8
  interface Props {
9
+ /** Id of the workflow to test. */
9
10
  workflowId: string;
11
+ /** A pre-loaded workflow. Default: fetched by id. */
10
12
  workflow?: Workflow;
13
+ /** Display mode. Default: standalone. */
11
14
  mode?: 'standalone' | 'embedded';
15
+ /** API endpoints. Default: the page default. */
12
16
  endpointConfig?: EndpointConfig;
13
17
  /** Auth provider applied to this instance's API requests. */
14
18
  authProvider?: AuthProvider;
19
+ /** Playground options. Default: none. */
15
20
  config?: PlaygroundConfig;
21
+ /** Show the navbar on top. Default: false. */
16
22
  showNavbar?: boolean;
23
+ /** Title in the navbar. Default: none. */
17
24
  navbarTitle?: string;
25
+ /** Extra action buttons in the navbar. Default: none. */
18
26
  primaryActions?: NavbarAction[];
27
+ /** Logo and name for the navbar. Default: none. */
19
28
  branding?: NavbarBranding;
29
+ /** Show the settings button. Default: true. */
20
30
  showSettings?: boolean;
31
+ /** Settings categories to offer. Default: all. */
21
32
  settingsCategories?: SettingsCategory[];
33
+ /** Show the sync button in settings. Default: the settings default. */
22
34
  showSettingsSyncButton?: boolean;
35
+ /** Show the reset button in settings. Default: the settings default. */
23
36
  showSettingsResetButton?: boolean;
37
+ /** Session to open on mount. Default: none. */
24
38
  initialSessionId?: string;
39
+ /** Whether the pipeline panel starts open. Default: the stored choice. */
25
40
  initialPipelineOpen?: boolean;
41
+ /** Minimum width of the chat side in px. Default: 760. */
26
42
  minChatWidth?: number;
43
+ /** Starting width of the pipeline panel in px. Default: 500. */
27
44
  initialPipelineWidth?: number;
45
+ /** Called when the user closes the Playground. */
28
46
  onClose?: () => void;
47
+ /** Called with the session id after a switch, so a host can update its URL. */
29
48
  onSessionNavigate?: (sessionId: string) => void;
30
49
  /** Per-instance state container — forwarded to the inner PlaygroundStudio */
31
50
  instance?: FlowDropInstance;
32
51
  }
52
+ /**
53
+ * **Legacy.** A full-page Playground with the FlowDrop navbar on top. It is deprecated in favour of the editor's Test mode and removed in 3.0. It warns once per page when mounted.
54
+ * It pairs the navbar with `PlaygroundStudio`. When you import it directly (not through `mountPlaygroundApp`), call `initializeSettings()` first, because the navbar's settings modal reads the settings store.
55
+ *
56
+ * **Use it for** existing full-page standalone Playgrounds.
57
+ * **Not for** new work; use the editor's Test mode (`DockedPlayground`) instead.
58
+ */
33
59
  declare const PlaygroundApp: import("svelte").Component<Props, {}, "">;
34
60
  type PlaygroundApp = ReturnType<typeof PlaygroundApp>;
35
61
  export default PlaygroundApp;
@@ -1,18 +1,13 @@
1
1
  <!--
2
- PlaygroundHeader
2
+ @component
3
+ The header of the docked Playground in Test mode: a chip for the open conversation, a plus for a new one, and a menu.
3
4
 
4
- The docked Playground's header (Test mode): the history chip, a + for a new
5
- conversation and the ⋯ menu, and nothing else:
5
+ The chip lists the conversations and, under them, the runs of the open one (newest first, older versions marked).
6
+ Picking a run shows it and the canvas follows. The menu has Expand steps by default, JSON view (for a form
7
+ workflow), Refresh, Reset, Playground settings, and anything the host adds with `menuItems`.
6
8
 
7
- - the history chip: which conversation (and run) the view is on. Its menu
8
- lists the Conversations (the sessions the Playground created) and the
9
- Runs of the open one, newest first, older-version runs marked. Picking a
10
- conversation opens it; picking a run shows that run (the canvas follows).
11
- - the ⋯ menu: Expand steps by default, JSON view (a form workflow), Refresh, Reset,
12
- Playground settings, and whatever a host adds through `menuItems`.
13
-
14
- Each fact has one home: which conversation or run is shown lives in the
15
- chip; the recovery actions live in the menu. No link to the standalone page.
9
+ **Use it for** the top of the Test mode panel.
10
+ **Not for** the editor's own navbar (use `Navbar`).
16
11
  -->
17
12
 
18
13
  <script lang="ts">
@@ -33,6 +28,7 @@
33
28
  hasForm?: boolean;
34
29
  /** The form is shown as JSON. */
35
30
  jsonView?: boolean;
31
+ /** Switch between the typed form and the JSON view. */
36
32
  onToggleJsonView?: () => void;
37
33
  /** Opens the workflow's Playground settings (the editor's inspector). */
38
34
  onOpenSettings?: () => void;
@@ -4,6 +4,7 @@ interface Props {
4
4
  hasForm?: boolean;
5
5
  /** The form is shown as JSON. */
6
6
  jsonView?: boolean;
7
+ /** Switch between the typed form and the JSON view. */
7
8
  onToggleJsonView?: () => void;
8
9
  /** Opens the workflow's Playground settings (the editor's inspector). */
9
10
  onOpenSettings?: () => void;
@@ -17,6 +18,16 @@ interface Props {
17
18
  close: () => void;
18
19
  }]>;
19
20
  }
21
+ /**
22
+ * The header of the docked Playground in Test mode: a chip for the open conversation, a plus for a new one, and a menu.
23
+ *
24
+ * The chip lists the conversations and, under them, the runs of the open one (newest first, older versions marked).
25
+ * Picking a run shows it and the canvas follows. The menu has Expand steps by default, JSON view (for a form
26
+ * workflow), Refresh, Reset, Playground settings, and anything the host adds with `menuItems`.
27
+ *
28
+ * **Use it for** the top of the Test mode panel.
29
+ * **Not for** the editor's own navbar (use `Navbar`).
30
+ */
20
31
  declare const PlaygroundHeader: import("svelte").Component<Props, {}, "">;
21
32
  type PlaygroundHeader = ReturnType<typeof PlaygroundHeader>;
22
33
  export default PlaygroundHeader;
@@ -1,12 +1,10 @@
1
1
  <!--
2
- PlaygroundModal Component
3
-
4
- Modal wrapper for the Playground component.
5
- Provides a centered modal dialog with backdrop, similar to Langflow's implementation.
6
- Supports closing via backdrop click, Escape key, or close button.
7
-
8
- @deprecated The standalone Playground is deprecated in favour of the editor's
9
- Test mode and removed in 3.0. It warns once per page when mounted.
2
+ @component
3
+ **Legacy.** The Playground in a centred modal. It is deprecated in favour of the editor's Test mode and removed in 3.0. It warns once per page when mounted.
4
+ The user sees a dialog over a dimmed page that holds the `Playground`. It closes on a backdrop click, the Escape key or the close button.
5
+
6
+ **Use it for** existing apps that open the Playground as a pop-up.
7
+ **Not for** new work; use the editor's Test mode (`DockedPlayground`) instead.
10
8
  -->
11
9
 
12
10
  <script lang="ts">
@@ -26,6 +26,13 @@ interface Props {
26
26
  /** Callback when modal is closed */
27
27
  onClose: () => void;
28
28
  }
29
+ /**
30
+ * **Legacy.** The Playground in a centred modal. It is deprecated in favour of the editor's Test mode and removed in 3.0. It warns once per page when mounted.
31
+ * The user sees a dialog over a dimmed page that holds the `Playground`. It closes on a backdrop click, the Escape key or the close button.
32
+ *
33
+ * **Use it for** existing apps that open the Playground as a pop-up.
34
+ * **Not for** new work; use the editor's Test mode (`DockedPlayground`) instead.
35
+ */
29
36
  declare const PlaygroundModal: import("svelte").Component<Props, {}, "">;
30
37
  type PlaygroundModal = ReturnType<typeof PlaygroundModal>;
31
38
  export default PlaygroundModal;
@@ -1,3 +1,12 @@
1
+ <!--
2
+ @component
3
+ **Legacy.** The standalone Playground page: the chat (`Playground`) beside a resizable `PipelinePanel`. Deprecated in favour of the editor's Test mode and removed in 3.0. It warns once per page when mounted.
4
+ The user sees the conversation on one side and the run's pipeline on the other. The panel width and open state are remembered.
5
+
6
+ **Use it for** existing standalone Playground pages and `PlaygroundApp`.
7
+ **Not for** new work; use the editor's Test mode (`DockedPlayground`) instead.
8
+ -->
9
+
1
10
  <script lang="ts">
2
11
  import { warnStandalonePlaygroundDeprecated } from '../../utils/deprecation.js';
3
12
  import { onMount, untrack } from 'svelte';
@@ -33,6 +33,13 @@ interface Props {
33
33
  /** Explicit FlowDrop instance; defaults to context or the page-default instance. */
34
34
  instance?: FlowDropInstance;
35
35
  }
36
+ /**
37
+ * **Legacy.** The standalone Playground page: the chat (`Playground`) beside a resizable `PipelinePanel`. Deprecated in favour of the editor's Test mode and removed in 3.0. It warns once per page when mounted.
38
+ * The user sees the conversation on one side and the run's pipeline on the other. The panel width and open state are remembered.
39
+ *
40
+ * **Use it for** existing standalone Playground pages and `PlaygroundApp`.
41
+ * **Not for** new work; use the editor's Test mode (`DockedPlayground`) instead.
42
+ */
36
43
  declare const PlaygroundStudio: import("svelte").Component<Props, {}, "">;
37
44
  type PlaygroundStudio = ReturnType<typeof PlaygroundStudio>;
38
45
  export default PlaygroundStudio;
@@ -1,18 +1,12 @@
1
1
  <!--
2
- PlaygroundSurface
3
-
4
- The Playground's conversation surface: ExecutionConsole (top) and
5
- ControlPanel (bottom, or on top for a form-first workflow) and the session
6
- and run wiring around them. It holds no layout opinion of its
7
- own beyond that: no pipeline panel, no minimum width.
8
-
9
- Two kinds of caller:
10
- - the standalone Playground (`Playground.svelte`, used by PlaygroundStudio,
11
- PlaygroundModal and the /workflow/[id]/playground/[sessionId] route),
12
- which is deprecated in favour of Test mode and removed in 3.0;
13
- - the docked Playground of the editor's Test mode (`DockedPlayground.svelte`),
14
- which must keep working when the standalone one goes. Everything both
15
- need lives here.
2
+ @component
3
+ The Playground's conversation surface, shared by the editor and the standalone page.
4
+ The user sees `ExecutionConsole` (the flow's messages) and `ControlPanel` (typing, Run, sessions), with the session and run handling around them. For a form-first workflow the inputs are on top. It has no layout of its own: no pipeline panel and no minimum width.
5
+
6
+ Two callers use it. The docked Playground of the editor's Test mode (`DockedPlayground`) must keep working when the standalone one goes. The standalone `Playground` is deprecated and removed in 3.0. Everything both need lives here.
7
+
8
+ **Use it for** the Playground conversation inside a container you lay out yourself.
9
+ **Not for** the Test mode panel with its header; use `DockedPlayground` instead.
16
10
  -->
17
11
 
18
12
  <script lang="ts">
@@ -37,18 +31,29 @@
37
31
  import { isPlaygroundChatHalfSet, isPlaygroundChatSet } from '../../utils/playgroundChat.js';
38
32
 
39
33
  interface Props {
34
+ /** Id of the workflow to test. */
40
35
  workflowId: string;
36
+ /** A pre-loaded workflow. Default: fetched by id. */
41
37
  workflow?: Workflow;
38
+ /** Display mode. Default: standalone. */
42
39
  mode?: PlaygroundMode;
40
+ /** Session to open on mount. Default: none. */
43
41
  initialSessionId?: string;
42
+ /** API endpoints. Default: the page default. */
44
43
  endpointConfig?: EndpointConfig;
45
44
  /** Auth provider applied to this instance's API requests. */
46
45
  authProvider?: AuthProvider;
46
+ /** Playground options. Default: none. */
47
47
  config?: PlaygroundConfig;
48
+ /** Called when the user closes the Playground. */
48
49
  onClose?: () => void;
50
+ /** Called when the user presses the Pipeline button. */
49
51
  onTogglePanel?: () => void;
52
+ /** Whether the pipeline panel is open. Default: false. */
50
53
  isPipelinePanelOpen?: boolean;
54
+ /** Called with the session id after a switch, so a host can update its URL. */
51
55
  onSessionNavigate?: (sessionId: string) => void;
56
+ /** FlowDrop instance to use. Default: from context or the page default. */
52
57
  instance?: FlowDropInstance;
53
58
  /**
54
59
  * Keep the instance's session, messages and polling when this surface goes
@@ -5,18 +5,29 @@ import type { AuthProvider } from '../../types/auth.js';
5
5
  import type { PlaygroundMode, PlaygroundConfig } from '../../types/playground.js';
6
6
  import type { FlowDropInstance } from '../../stores/instanceContainer.svelte.js';
7
7
  interface Props {
8
+ /** Id of the workflow to test. */
8
9
  workflowId: string;
10
+ /** A pre-loaded workflow. Default: fetched by id. */
9
11
  workflow?: Workflow;
12
+ /** Display mode. Default: standalone. */
10
13
  mode?: PlaygroundMode;
14
+ /** Session to open on mount. Default: none. */
11
15
  initialSessionId?: string;
16
+ /** API endpoints. Default: the page default. */
12
17
  endpointConfig?: EndpointConfig;
13
18
  /** Auth provider applied to this instance's API requests. */
14
19
  authProvider?: AuthProvider;
20
+ /** Playground options. Default: none. */
15
21
  config?: PlaygroundConfig;
22
+ /** Called when the user closes the Playground. */
16
23
  onClose?: () => void;
24
+ /** Called when the user presses the Pipeline button. */
17
25
  onTogglePanel?: () => void;
26
+ /** Whether the pipeline panel is open. Default: false. */
18
27
  isPipelinePanelOpen?: boolean;
28
+ /** Called with the session id after a switch, so a host can update its URL. */
19
29
  onSessionNavigate?: (sessionId: string) => void;
30
+ /** FlowDrop instance to use. Default: from context or the page default. */
20
31
  instance?: FlowDropInstance;
21
32
  /**
22
33
  * Keep the instance's session, messages and polling when this surface goes
@@ -74,6 +85,15 @@ interface Props {
74
85
  close: () => void;
75
86
  }]>;
76
87
  }
88
+ /**
89
+ * The Playground's conversation surface, shared by the editor and the standalone page.
90
+ * The user sees `ExecutionConsole` (the flow's messages) and `ControlPanel` (typing, Run, sessions), with the session and run handling around them. For a form-first workflow the inputs are on top. It has no layout of its own: no pipeline panel and no minimum width.
91
+ *
92
+ * Two callers use it. The docked Playground of the editor's Test mode (`DockedPlayground`) must keep working when the standalone one goes. The standalone `Playground` is deprecated and removed in 3.0. Everything both need lives here.
93
+ *
94
+ * **Use it for** the Playground conversation inside a container you lay out yourself.
95
+ * **Not for** the Test mode panel with its header; use `DockedPlayground` instead.
96
+ */
77
97
  declare const PlaygroundSurface: import("svelte").Component<Props, {}, "">;
78
98
  type PlaygroundSurface = ReturnType<typeof PlaygroundSurface>;
79
99
  export default PlaygroundSurface;
@@ -1,9 +1,10 @@
1
1
  <!--
2
- SessionManager Component
3
-
4
- Manages playground sessions: list, create, switch, and delete.
5
- Displayed as a sidebar or dropdown.
6
- Styled with BEM syntax.
2
+ @component
3
+ **Exported for host apps; the editor does not render it.** A list of Playground sessions; no surface renders it any more. `ControlPanel` and the history menu in `PlaygroundHeader` replaced it.
4
+ It lists sessions with a relative time, lets the user create, switch and delete (delete asks to press again within 3 seconds), and works as a sidebar or a dropdown.
5
+
6
+ **Use it for** a host app's own sessions sidebar.
7
+ **Not for** the editor; use `ControlPanel` or `PlaygroundHeader` instead.
7
8
  -->
8
9
 
9
10
  <script lang="ts">
@@ -15,6 +15,13 @@ interface Props {
15
15
  /** Display mode: sidebar or dropdown */
16
16
  mode?: 'sidebar' | 'dropdown';
17
17
  }
18
+ /**
19
+ * **Exported for host apps; the editor does not render it.** A list of Playground sessions; no surface renders it any more. `ControlPanel` and the history menu in `PlaygroundHeader` replaced it.
20
+ * It lists sessions with a relative time, lets the user create, switch and delete (delete asks to press again within 3 seconds), and works as a sidebar or a dropdown.
21
+ *
22
+ * **Use it for** a host app's own sessions sidebar.
23
+ * **Not for** the editor; use `ControlPanel` or `PlaygroundHeader` instead.
24
+ */
18
25
  declare const SessionManager: import("svelte").Component<Props, {}, "isExpanded">;
19
26
  type SessionManager = ReturnType<typeof SessionManager>;
20
27
  export default SessionManager;
@@ -1,14 +1,10 @@
1
1
  <!--
2
- StepsSummary — one row for the steps of a turn.
2
+ @component
3
+ One row that sums up the steps of a turn.
4
+ The user sees it in the conversation, such as "4 steps - 46 ms - 1 waiting". Opening it shows a compact list (status dot, node, runs, time). A failed step's error stays visible under the row, open or closed. Steps from sub-workflows are indented, and their full path is the cell's title.
3
5
 
4
- "4 steps · 46 ms · 1 waiting ▸" opens a compact list (status dot · node · runs ·
5
- time). A failed step's error stays visible under the row, folded or not,
6
- because that is what people look for. Nested (sub-workflow) steps are indented
7
- in the node column; their full path is the cell's title. The origin chip and
8
- the per-node breadcrumb rows of the old log rows are gone: the Playground is
9
- where the reader already is, and the table says which node it was.
10
-
11
- @internal Used by MessageStream.
6
+ **Use it for** showing what a run did, in place of one log line per step.
7
+ **Not for** a full run view; use `PipelinePanel` instead.
12
8
  -->
13
9
 
14
10
  <script lang="ts">
@@ -19,8 +15,11 @@
19
15
  import type { StepsSummary } from './stepSummary.js';
20
16
 
21
17
  interface Props {
18
+ /** The steps of the turn to sum up. */
22
19
  summary: StepsSummary;
20
+ /** Whether the step list is open. */
23
21
  expanded: boolean;
22
+ /** Called when the user opens or closes the list. */
24
23
  onToggle: () => void;
25
24
  /** Used to tie the toggle to the table it opens. */
26
25
  id: string;
@@ -1,11 +1,21 @@
1
1
  import type { StepsSummary } from './stepSummary.js';
2
2
  interface Props {
3
+ /** The steps of the turn to sum up. */
3
4
  summary: StepsSummary;
5
+ /** Whether the step list is open. */
4
6
  expanded: boolean;
7
+ /** Called when the user opens or closes the list. */
5
8
  onToggle: () => void;
6
9
  /** Used to tie the toggle to the table it opens. */
7
10
  id: string;
8
11
  }
12
+ /**
13
+ * One row that sums up the steps of a turn.
14
+ * The user sees it in the conversation, such as "4 steps - 46 ms - 1 waiting". Opening it shows a compact list (status dot, node, runs, time). A failed step's error stays visible under the row, open or closed. Steps from sub-workflows are indented, and their full path is the cell's title.
15
+ *
16
+ * **Use it for** showing what a run did, in place of one log line per step.
17
+ * **Not for** a full run view; use `PipelinePanel` instead.
18
+ */
9
19
  declare const StepsSummary: import("svelte").Component<Props, {}, "">;
10
20
  type StepsSummary = ReturnType<typeof StepsSummary>;
11
21
  export default StepsSummary;
@@ -1,12 +1,17 @@
1
1
  <!--
2
- Button primitive — the design-system button (variant x size x state).
2
+ @component
3
+ Button: the editor's text button, with a variant, a size and optional icons.
3
4
 
4
- Scoped styles built only on --fd-* tokens; heights come from --fd-control-sm
5
- (24) / --fd-control-md (28). The focus ring is the library-wide one in
6
- base.css (never declared here). The legacy `components/Button.svelte` is a thin
7
- wrapper over this component.
5
+ Sizes are the control heights: `sm` is 24px, `md` is 28px, `lg` is 32px. The editor
6
+ uses `sm` almost everywhere. `loading` shows a spinner and blocks clicks but keeps focus.
7
+ The focus ring comes from base.css, never from this file.
8
8
 
9
- @internal Not exported from any package entry; not public API yet.
9
+ **Use it for** any labelled action: Save, Run, Retry, Cancel.
10
+ **Not for** icon-only actions; use `IconButton`. For a list of actions behind one
11
+ trigger use `Menu`.
12
+
13
+ Not exported from the package; internal to the editor. The wrapper `components/Button.svelte`
14
+ is the old API on top of this.
10
15
  -->
11
16
 
12
17
  <script lang="ts">
@@ -14,7 +19,10 @@
14
19
  import type { HTMLButtonAttributes } from 'svelte/elements';
15
20
 
16
21
  interface Props extends Omit<HTMLButtonAttributes, 'children' | 'class' | 'type' | 'title'> {
17
- /** Visual style */
22
+ /**
23
+ * Visual style. `danger` follows the theme. `destructive` is always the red fill (a final
24
+ * confirm). `danger-ghost` is red text with no fill, for a quiet delete.
25
+ */
18
26
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'destructive' | 'danger-ghost';
19
27
  /** Height: `sm` = --fd-control-sm (24), `md` = --fd-control-md (28), `lg` = --fd-control-lg (32) */
20
28
  size?: 'sm' | 'md' | 'lg';
@@ -1,7 +1,10 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { HTMLButtonAttributes } from 'svelte/elements';
3
3
  interface Props extends Omit<HTMLButtonAttributes, 'children' | 'class' | 'type' | 'title'> {
4
- /** Visual style */
4
+ /**
5
+ * Visual style. `danger` follows the theme. `destructive` is always the red fill (a final
6
+ * confirm). `danger-ghost` is red text with no fill, for a quiet delete.
7
+ */
5
8
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'destructive' | 'danger-ghost';
6
9
  /** Height: `sm` = --fd-control-sm (24), `md` = --fd-control-md (28), `lg` = --fd-control-lg (32) */
7
10
  size?: 'sm' | 'md' | 'lg';
@@ -26,6 +29,20 @@ interface Props extends Omit<HTMLButtonAttributes, 'children' | 'class' | 'type'
26
29
  /** Button label */
27
30
  children?: Snippet;
28
31
  }
32
+ /**
33
+ * Button: the editor's text button, with a variant, a size and optional icons.
34
+ *
35
+ * Sizes are the control heights: `sm` is 24px, `md` is 28px, `lg` is 32px. The editor
36
+ * uses `sm` almost everywhere. `loading` shows a spinner and blocks clicks but keeps focus.
37
+ * The focus ring comes from base.css, never from this file.
38
+ *
39
+ * **Use it for** any labelled action: Save, Run, Retry, Cancel.
40
+ * **Not for** icon-only actions; use `IconButton`. For a list of actions behind one
41
+ * trigger use `Menu`.
42
+ *
43
+ * Not exported from the package; internal to the editor. The wrapper `components/Button.svelte`
44
+ * is the old API on top of this.
45
+ */
29
46
  declare const Button: import("svelte").Component<Props, {}, "">;
30
47
  type Button = ReturnType<typeof Button>;
31
48
  export default Button;
@@ -1,12 +1,14 @@
1
1
  <!--
2
- Card — a surface container with an optional header and footer row.
2
+ @component
3
+ Card: a surface with an optional header row and footer row.
3
4
 
4
- `variant="attention"` is the amber "needs you" frame (interrupts): the
5
- waiting-status border on its soft background. It is a plain `<section>`
6
- (named by `ariaLabel`, which makes it a landmark-ish region) or a `<div>`
7
- when no label is given.
5
+ `variant="attention"` is the amber "needs you" frame. It is a plain `<section>` named by
6
+ `ariaLabel`, or a `<div>` when no label is given.
8
7
 
9
- @internal Not exported from any package entry; the API may still change.
8
+ **Use it for** a bordered group of content, such as an input form or a prompt that waits for an answer.
9
+ **Not for** a whole panel; use `PanelHeader` for the top strip of a panel.
10
+
11
+ Not exported from the package; the API may still change.
10
12
  -->
11
13
 
12
14
  <script lang="ts">
@@ -15,6 +15,17 @@ interface Props {
15
15
  /** Content. */
16
16
  children?: Snippet;
17
17
  }
18
+ /**
19
+ * Card: a surface with an optional header row and footer row.
20
+ *
21
+ * `variant="attention"` is the amber "needs you" frame. It is a plain `<section>` named by
22
+ * `ariaLabel`, or a `<div>` when no label is given.
23
+ *
24
+ * **Use it for** a bordered group of content, such as an input form or a prompt that waits for an answer.
25
+ * **Not for** a whole panel; use `PanelHeader` for the top strip of a panel.
26
+ *
27
+ * Not exported from the package; the API may still change.
28
+ */
18
29
  declare const Card: import("svelte").Component<Props, {}, "">;
19
30
  type Card = ReturnType<typeof Card>;
20
31
  export default Card;
@@ -1,11 +1,14 @@
1
1
  <!--
2
- Checkbox — a 16px box with a check, replacing the native control.
2
+ @component
3
+ Checkbox: a 16px box with a check mark, in place of the native control.
3
4
 
4
- A real checkbox underneath (keyboard, forms, screen readers). The label is
5
- optional: pass `label` for visible text, or `ariaLabel` when the row around it
6
- already names it.
5
+ A real checkbox sits underneath, so keyboard, forms and screen readers work as usual.
6
+ Pass `label` for visible text, or `aria-label` when the row around it already names it.
7
7
 
8
- @internal Not exported from any package entry; the API may still change.
8
+ **Use it for** a yes/no option in a form or a list of choices.
9
+ **Not for** an instant on/off setting; use `Switch`.
10
+
11
+ Not exported from the package; the API may still change.
9
12
  -->
10
13
 
11
14
  <script lang="ts">
@@ -10,6 +10,17 @@ interface Props extends Omit<HTMLInputAttributes, 'type' | 'checked' | 'onchange
10
10
  /** Extra classes on the root. */
11
11
  class?: string;
12
12
  }
13
+ /**
14
+ * Checkbox: a 16px box with a check mark, in place of the native control.
15
+ *
16
+ * A real checkbox sits underneath, so keyboard, forms and screen readers work as usual.
17
+ * Pass `label` for visible text, or `aria-label` when the row around it already names it.
18
+ *
19
+ * **Use it for** a yes/no option in a form or a list of choices.
20
+ * **Not for** an instant on/off setting; use `Switch`.
21
+ *
22
+ * Not exported from the package; the API may still change.
23
+ */
13
24
  declare const Checkbox: import("svelte").Component<Props, {}, "">;
14
25
  type Checkbox = ReturnType<typeof Checkbox>;
15
26
  export default Checkbox;
@@ -1,10 +1,14 @@
1
1
  <!--
2
- Chip primitive — a small label (not interactive by default).
2
+ @component
3
+ Chip: a small, rounded label. Not interactive unless you give it `onremove`.
3
4
 
4
- Tones map to the semantic muted/solid token pairs. `onremove` adds a trailing
5
- x IconButton with an accessible label.
5
+ Tones map to the muted/solid colour pairs. `onremove` adds a trailing x button with an
6
+ accessible label.
6
7
 
7
- @internal Not exported from any package entry; not public API yet.
8
+ **Use it for** tags and short status words next to a title.
9
+ **Not for** run status; use `StatusPill`. Not used in the editor yet.
10
+
11
+ Not exported from the package; not public API yet.
8
12
  -->
9
13
 
10
14
  <script lang="ts">
@@ -17,6 +17,17 @@ interface Props {
17
17
  /** Chip text */
18
18
  children: Snippet;
19
19
  }
20
+ /**
21
+ * Chip: a small, rounded label. Not interactive unless you give it `onremove`.
22
+ *
23
+ * Tones map to the muted/solid colour pairs. `onremove` adds a trailing x button with an
24
+ * accessible label.
25
+ *
26
+ * **Use it for** tags and short status words next to a title.
27
+ * **Not for** run status; use `StatusPill`. Not used in the editor yet.
28
+ *
29
+ * Not exported from the package; not public API yet.
30
+ */
20
31
  declare const Chip: import("svelte").Component<Props, {}, "">;
21
32
  type Chip = ReturnType<typeof Chip>;
22
33
  export default Chip;