@flowdrop/flowdrop 1.15.0 → 2.0.0-beta.10

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 (323) hide show
  1. package/CHANGELOG.md +648 -0
  2. package/MIGRATION-2.0.md +642 -0
  3. package/README.md +28 -28
  4. package/dist/adapters/WorkflowAdapter.d.ts +1 -1
  5. package/dist/adapters/WorkflowAdapter.js +18 -13
  6. package/dist/adapters/agentspec/AgentSpecAdapter.js +10 -10
  7. package/dist/adapters/agentspec/defaultNodeTypes.js +9 -9
  8. package/dist/api/enhanced-client.js +6 -11
  9. package/dist/chat/batchFeedback.d.ts +39 -0
  10. package/dist/chat/batchFeedback.js +51 -0
  11. package/dist/commands/executor.js +66 -27
  12. package/dist/commands/storeIntegration.svelte.d.ts +4 -1
  13. package/dist/commands/storeIntegration.svelte.js +36 -21
  14. package/dist/commands/types.d.ts +2 -0
  15. package/dist/commands/types.js +5 -5
  16. package/dist/components/App.svelte +696 -565
  17. package/dist/components/App.svelte.d.ts +63 -16
  18. package/dist/components/Button.stories.svelte +65 -0
  19. package/dist/components/Button.stories.svelte.d.ts +19 -0
  20. package/dist/components/Button.svelte +62 -0
  21. package/dist/components/Button.svelte.d.ts +24 -0
  22. package/dist/components/CanvasIconButton.svelte +76 -0
  23. package/dist/components/CanvasIconButton.svelte.d.ts +18 -0
  24. package/dist/components/ConfigForm.svelte +181 -552
  25. package/dist/components/ConfigForm.svelte.d.ts +24 -7
  26. package/dist/components/ConfigModal.svelte +16 -3
  27. package/dist/components/ConfigPanel.svelte +234 -15
  28. package/dist/components/ConfigPanel.svelte.d.ts +6 -0
  29. package/dist/components/ConnectionLine.svelte +4 -2
  30. package/dist/components/EditorStatusBar.stories.svelte +44 -0
  31. package/dist/components/EditorStatusBar.stories.svelte.d.ts +27 -0
  32. package/dist/components/EditorStatusBar.svelte +99 -0
  33. package/dist/components/EditorStatusBar.svelte.d.ts +15 -0
  34. package/dist/components/IconButton.svelte +80 -0
  35. package/dist/components/IconButton.svelte.d.ts +30 -0
  36. package/dist/components/Input.svelte +74 -0
  37. package/dist/components/Input.svelte.d.ts +17 -0
  38. package/dist/components/LogoWordmark.svelte +113 -0
  39. package/dist/components/LogoWordmark.svelte.d.ts +26 -0
  40. package/dist/components/Navbar.svelte +78 -64
  41. package/dist/components/Navbar.svelte.d.ts +3 -0
  42. package/dist/components/NodeSidebar.svelte +48 -171
  43. package/dist/components/NodeStatusOverlay.svelte +94 -6
  44. package/dist/components/NodeSwapPicker.svelte +22 -38
  45. package/dist/components/PipelineStatus.svelte +22 -68
  46. package/dist/components/PipelineStatus.svelte.d.ts +3 -0
  47. package/dist/components/PortCoordinateTracker.svelte +5 -6
  48. package/dist/components/PortMappingRow.svelte +0 -2
  49. package/dist/components/SchemaForm.stories.svelte +1 -3
  50. package/dist/components/SchemaForm.svelte +22 -39
  51. package/dist/components/SchemaForm.svelte.d.ts +0 -8
  52. package/dist/components/Select.svelte +53 -0
  53. package/dist/components/Select.svelte.d.ts +15 -0
  54. package/dist/components/SettingsModal.svelte +8 -8
  55. package/dist/components/SettingsPanel.svelte +44 -10
  56. package/dist/components/SwapMappingEditor.svelte +67 -49
  57. package/dist/components/SwapMappingEditor.svelte.d.ts +0 -2
  58. package/dist/components/Textarea.svelte +39 -0
  59. package/dist/components/Textarea.svelte.d.ts +12 -0
  60. package/dist/components/ThemeToggle.svelte +15 -94
  61. package/dist/components/UniversalNode.svelte +45 -11
  62. package/dist/components/UniversalNode.svelte.d.ts +1 -1
  63. package/dist/components/WorkflowEditor.svelte +183 -162
  64. package/dist/components/WorkflowEditor.svelte.d.ts +39 -10
  65. package/dist/components/chat/AIChatPanel.svelte +99 -90
  66. package/dist/components/chat/AIChatPanel.svelte.d.ts +0 -4
  67. package/dist/components/chat/CommandPreview.svelte +2 -1
  68. package/dist/components/console/CommandConsole.svelte +7 -5
  69. package/dist/components/console/ConsoleAutocomplete.svelte +11 -12
  70. package/dist/components/console/ConsoleAutocomplete.svelte.d.ts +6 -0
  71. package/dist/components/console/ConsoleInput.svelte +18 -9
  72. package/dist/components/console/ConsoleOutput.svelte +4 -3
  73. package/dist/components/form/FormArray.svelte +42 -182
  74. package/dist/components/form/FormArray.svelte.d.ts +2 -1
  75. package/dist/components/form/FormAutocomplete.svelte +26 -21
  76. package/dist/components/form/FormCheckboxGroup.svelte +1 -5
  77. package/dist/components/form/FormCodeEditor.svelte +9 -7
  78. package/dist/components/form/FormField.svelte +22 -44
  79. package/dist/components/form/FormFieldLight.svelte +56 -50
  80. package/dist/components/form/FormFieldLight.svelte.d.ts +12 -0
  81. package/dist/components/form/FormFieldset.svelte +45 -11
  82. package/dist/components/form/FormMarkdownEditor.svelte +17 -9
  83. package/dist/components/form/FormNumberField.svelte +4 -36
  84. package/dist/components/form/FormPorts.svelte +262 -0
  85. package/dist/components/form/FormPorts.svelte.d.ts +13 -0
  86. package/dist/components/form/FormRangeField.svelte +62 -30
  87. package/dist/components/form/FormSelect.svelte +13 -75
  88. package/dist/components/form/FormTemplateEditor.svelte +17 -7
  89. package/dist/components/form/FormTextField.svelte +3 -35
  90. package/dist/components/form/FormTextarea.svelte +4 -39
  91. package/dist/components/form/FormToggle.svelte +5 -16
  92. package/dist/components/form/FormToggle.svelte.d.ts +4 -2
  93. package/dist/components/form/FormUISchemaRenderer.svelte +3 -1
  94. package/dist/components/form/resolveFieldType.d.ts +24 -0
  95. package/dist/components/form/resolveFieldType.js +55 -0
  96. package/dist/components/form/templateAutocomplete.js +1 -5
  97. package/dist/components/form/types.d.ts +1 -14
  98. package/dist/components/icons/CloseIcon.svelte +6 -0
  99. package/dist/components/icons/CloseIcon.svelte.d.ts +26 -0
  100. package/dist/components/icons/CommandLineIcon.svelte +15 -0
  101. package/dist/components/icons/CommandLineIcon.svelte.d.ts +26 -0
  102. package/dist/components/icons/MenuIcon.svelte +4 -0
  103. package/dist/components/icons/MenuIcon.svelte.d.ts +26 -0
  104. package/dist/components/icons/MenuOpenIcon.svelte +6 -0
  105. package/dist/components/icons/MenuOpenIcon.svelte.d.ts +26 -0
  106. package/dist/components/interrupt/ChoicePrompt.svelte +0 -10
  107. package/dist/components/interrupt/ConfirmationPrompt.svelte +0 -5
  108. package/dist/components/interrupt/FormPrompt.svelte +3 -2
  109. package/dist/components/interrupt/InterruptBubble.svelte +25 -27
  110. package/dist/components/interrupt/ReviewPrompt.svelte +10 -23
  111. package/dist/components/interrupt/TextInputPrompt.svelte +2 -7
  112. package/dist/components/layouts/MainLayout.svelte +24 -18
  113. package/dist/components/layouts/MainLayout.svelte.d.ts +4 -0
  114. package/dist/components/nodes/AtomNode.svelte +70 -72
  115. package/dist/components/nodes/AtomNode.svelte.d.ts +1 -1
  116. package/dist/components/nodes/GatewayNode.svelte +134 -172
  117. package/dist/components/nodes/GatewayNode.svelte.d.ts +1 -1
  118. package/dist/components/nodes/IdeaNode.svelte +79 -98
  119. package/dist/components/nodes/IdeaNode.svelte.d.ts +8 -4
  120. package/dist/components/nodes/NodeConfigButton.svelte +86 -0
  121. package/dist/components/nodes/NodeConfigButton.svelte.d.ts +15 -0
  122. package/dist/components/nodes/NotesNode.svelte +76 -85
  123. package/dist/components/nodes/NotesNode.svelte.d.ts +8 -4
  124. package/dist/components/nodes/SimpleNode.svelte +68 -137
  125. package/dist/components/nodes/SimpleNode.svelte.d.ts +4 -4
  126. package/dist/components/nodes/SquareNode.svelte +122 -169
  127. package/dist/components/nodes/SquareNode.svelte.d.ts +4 -4
  128. package/dist/components/nodes/TerminalNode.svelte +70 -127
  129. package/dist/components/nodes/TerminalNode.svelte.d.ts +4 -4
  130. package/dist/components/nodes/ToolNode.svelte +99 -104
  131. package/dist/components/nodes/ToolNode.svelte.d.ts +6 -6
  132. package/dist/components/nodes/WorkflowNode.svelte +145 -195
  133. package/dist/components/nodes/WorkflowNode.svelte.d.ts +1 -1
  134. package/dist/components/playground/ChatInput.svelte +11 -15
  135. package/dist/components/playground/ChatPanel.svelte +6 -49
  136. package/dist/components/playground/ChatPanel.svelte.d.ts +0 -14
  137. package/dist/components/playground/ControlPanel.svelte +134 -123
  138. package/dist/components/playground/ControlPanel.svelte.d.ts +3 -0
  139. package/dist/components/playground/ExecutionLogs.svelte +11 -9
  140. package/dist/components/playground/InputCollector.svelte +22 -57
  141. package/dist/components/playground/MessageStream.svelte +17 -23
  142. package/dist/components/playground/PipelineKanbanView.svelte +69 -8
  143. package/dist/components/playground/PipelineKanbanView.svelte.d.ts +2 -0
  144. package/dist/components/playground/PipelinePanel.svelte +31 -8
  145. package/dist/components/playground/PipelinePanel.svelte.d.ts +2 -0
  146. package/dist/components/playground/PipelineTableView.svelte +188 -44
  147. package/dist/components/playground/PipelineTableView.svelte.d.ts +2 -0
  148. package/dist/components/playground/Playground.svelte +154 -105
  149. package/dist/components/playground/Playground.svelte.d.ts +5 -0
  150. package/dist/components/playground/PlaygroundApp.svelte +12 -2
  151. package/dist/components/playground/PlaygroundApp.svelte.d.ts +6 -0
  152. package/dist/components/playground/PlaygroundModal.svelte +18 -3
  153. package/dist/components/playground/PlaygroundModal.svelte.d.ts +6 -0
  154. package/dist/components/playground/PlaygroundStudio.svelte +40 -37
  155. package/dist/components/playground/PlaygroundStudio.svelte.d.ts +6 -0
  156. package/dist/components/playground/SessionManager.svelte +9 -12
  157. package/dist/components/playground/pipelineViewUtils.svelte.d.ts +30 -1
  158. package/dist/components/playground/pipelineViewUtils.svelte.js +40 -3
  159. package/dist/components/surfaces/SurfaceOverlay.svelte +153 -0
  160. package/dist/components/surfaces/SurfaceOverlay.svelte.d.ts +14 -0
  161. package/dist/components/surfaces/TabbedSurface.svelte +133 -0
  162. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +27 -0
  163. package/dist/config/endpoints.d.ts +23 -7
  164. package/dist/config/endpoints.js +30 -10
  165. package/dist/core/index.d.ts +6 -7
  166. package/dist/core/index.js +8 -12
  167. package/dist/display/index.d.ts +6 -3
  168. package/dist/display/index.js +7 -5
  169. package/dist/editor/index.d.ts +20 -21
  170. package/dist/editor/index.js +26 -36
  171. package/dist/form/code.d.ts +25 -15
  172. package/dist/form/code.js +44 -41
  173. package/dist/form/fieldRegistry.d.ts +17 -13
  174. package/dist/form/fieldRegistry.js +32 -12
  175. package/dist/form/full.d.ts +19 -14
  176. package/dist/form/full.js +26 -28
  177. package/dist/form/index.d.ts +3 -4
  178. package/dist/form/index.js +6 -5
  179. package/dist/form/markdown.d.ts +13 -8
  180. package/dist/form/markdown.js +22 -23
  181. package/dist/helpers/proximityConnect.d.ts +3 -2
  182. package/dist/helpers/proximityConnect.js +2 -5
  183. package/dist/helpers/workflowEditorHelper.d.ts +14 -5
  184. package/dist/helpers/workflowEditorHelper.js +32 -30
  185. package/dist/index.d.ts +28 -24
  186. package/dist/index.js +27 -50
  187. package/dist/messages/defaults.d.ts +2 -5
  188. package/dist/messages/defaults.js +3 -6
  189. package/dist/messages/index.d.ts +1 -2
  190. package/dist/messages/index.js +1 -2
  191. package/dist/mocks/app-forms.d.ts +6 -2
  192. package/dist/mocks/app-forms.js +11 -4
  193. package/dist/openapi/v1/openapi.yaml +38 -26
  194. package/dist/playground/index.d.ts +4 -5
  195. package/dist/playground/index.js +4 -32
  196. package/dist/playground/mount.d.ts +34 -5
  197. package/dist/playground/mount.js +58 -24
  198. package/dist/registry/{BaseRegistry.d.ts → BaseRegistry.svelte.d.ts} +22 -1
  199. package/dist/registry/{BaseRegistry.js → BaseRegistry.svelte.js} +37 -1
  200. package/dist/registry/builtinFormats.d.ts +9 -18
  201. package/dist/registry/builtinFormats.js +9 -39
  202. package/dist/registry/builtinNodeTypes.d.ts +53 -0
  203. package/dist/registry/builtinNodeTypes.js +67 -0
  204. package/dist/registry/builtinNodes.d.ts +2 -64
  205. package/dist/registry/builtinNodes.js +7 -103
  206. package/dist/registry/index.d.ts +3 -4
  207. package/dist/registry/index.js +4 -6
  208. package/dist/registry/nodeComponentRegistry.d.ts +184 -16
  209. package/dist/registry/nodeComponentRegistry.js +235 -17
  210. package/dist/registry/workflowFormatRegistry.d.ts +14 -9
  211. package/dist/registry/workflowFormatRegistry.js +24 -8
  212. package/dist/{schema → schemas}/index.d.ts +2 -2
  213. package/dist/{schema → schemas}/index.js +2 -2
  214. package/dist/schemas/v1/workflow.schema.json +19 -17
  215. package/dist/services/agentSpecExecutionService.d.ts +0 -2
  216. package/dist/services/agentSpecExecutionService.js +0 -3
  217. package/dist/services/apiVariableService.d.ts +2 -1
  218. package/dist/services/apiVariableService.js +16 -47
  219. package/dist/services/autoSaveService.d.ts +7 -0
  220. package/dist/services/autoSaveService.js +6 -4
  221. package/dist/services/categoriesApi.js +3 -6
  222. package/dist/services/chatService.d.ts +9 -4
  223. package/dist/services/chatService.js +23 -28
  224. package/dist/services/draftStorage.d.ts +129 -13
  225. package/dist/services/draftStorage.js +185 -37
  226. package/dist/services/dynamicSchemaService.d.ts +33 -5
  227. package/dist/services/dynamicSchemaService.js +67 -55
  228. package/dist/services/globalSave.d.ts +13 -12
  229. package/dist/services/globalSave.js +29 -51
  230. package/dist/services/historyService.d.ts +39 -11
  231. package/dist/services/historyService.js +60 -18
  232. package/dist/services/interruptService.d.ts +15 -9
  233. package/dist/services/interruptService.js +35 -37
  234. package/dist/services/nodeExecutionService.d.ts +18 -3
  235. package/dist/services/nodeExecutionService.js +71 -45
  236. package/dist/services/playgroundService.d.ts +16 -10
  237. package/dist/services/playgroundService.js +42 -43
  238. package/dist/services/portConfigApi.js +3 -6
  239. package/dist/services/settingsService.d.ts +9 -4
  240. package/dist/services/settingsService.js +23 -12
  241. package/dist/services/variableService.d.ts +2 -1
  242. package/dist/services/variableService.js +2 -2
  243. package/dist/services/workflowStorage.js +6 -6
  244. package/dist/skins/drafter.d.ts +30 -0
  245. package/dist/skins/drafter.js +198 -0
  246. package/dist/skins/index.d.ts +2 -1
  247. package/dist/skins/index.js +4 -2
  248. package/dist/stores/apiContext.d.ts +56 -0
  249. package/dist/stores/apiContext.js +80 -0
  250. package/dist/stores/categoriesStore.svelte.d.ts +28 -23
  251. package/dist/stores/categoriesStore.svelte.js +69 -64
  252. package/dist/stores/getInstance.svelte.d.ts +39 -0
  253. package/dist/stores/getInstance.svelte.js +65 -0
  254. package/dist/stores/historyStore.svelte.d.ts +89 -91
  255. package/dist/stores/historyStore.svelte.js +159 -158
  256. package/dist/stores/instanceContainer.svelte.d.ts +111 -0
  257. package/dist/stores/instanceContainer.svelte.js +119 -0
  258. package/dist/stores/interruptStore.svelte.d.ts +112 -82
  259. package/dist/stores/interruptStore.svelte.js +253 -226
  260. package/dist/stores/pipelinePanelStore.svelte.d.ts +27 -3
  261. package/dist/stores/pipelinePanelStore.svelte.js +61 -14
  262. package/dist/stores/playgroundStore.svelte.d.ts +169 -222
  263. package/dist/stores/playgroundStore.svelte.js +513 -580
  264. package/dist/stores/portCoordinateStore.svelte.d.ts +57 -51
  265. package/dist/stores/portCoordinateStore.svelte.js +109 -98
  266. package/dist/stores/settingsStore.svelte.d.ts +17 -1
  267. package/dist/stores/settingsStore.svelte.js +79 -12
  268. package/dist/stores/workflowStore.svelte.d.ts +212 -210
  269. package/dist/stores/workflowStore.svelte.js +527 -502
  270. package/dist/stories/EdgeDecorator.svelte +5 -2
  271. package/dist/stories/NodeDecorator.svelte +5 -3
  272. package/dist/styles/base.css +285 -14
  273. package/dist/styles/tokens.css +60 -2
  274. package/dist/svelte-app.d.ts +78 -11
  275. package/dist/svelte-app.js +210 -141
  276. package/dist/themes/drafter.d.ts +2 -0
  277. package/dist/themes/drafter.js +15 -0
  278. package/dist/themes/index.d.ts +2 -1
  279. package/dist/themes/index.js +8 -2
  280. package/dist/types/auth.d.ts +9 -51
  281. package/dist/types/auth.js +4 -54
  282. package/dist/types/events.d.ts +24 -3
  283. package/dist/types/events.js +2 -1
  284. package/dist/types/index.d.ts +117 -32
  285. package/dist/types/index.js +0 -1
  286. package/dist/types/navbar.d.ts +7 -0
  287. package/dist/types/playground.d.ts +18 -3
  288. package/dist/types/settings.d.ts +30 -1
  289. package/dist/types/settings.js +5 -2
  290. package/dist/types/skin.d.ts +1 -1
  291. package/dist/types/theme.d.ts +16 -2
  292. package/dist/types/uischema.d.ts +5 -0
  293. package/dist/utils/colors.d.ts +74 -21
  294. package/dist/utils/colors.js +92 -68
  295. package/dist/utils/connections.d.ts +9 -15
  296. package/dist/utils/connections.js +33 -88
  297. package/dist/utils/duration.d.ts +13 -0
  298. package/dist/utils/duration.js +45 -0
  299. package/dist/utils/edgeStyling.js +9 -5
  300. package/dist/utils/fetchWithAuth.d.ts +36 -15
  301. package/dist/utils/fetchWithAuth.js +53 -23
  302. package/dist/utils/icons.d.ts +5 -2
  303. package/dist/utils/icons.js +6 -5
  304. package/dist/utils/nodeIds.d.ts +1 -1
  305. package/dist/utils/nodeIds.js +1 -1
  306. package/dist/utils/nodeSwap.d.ts +6 -2
  307. package/dist/utils/nodeSwap.js +62 -129
  308. package/dist/utils/nodeTypes.d.ts +17 -8
  309. package/dist/utils/nodeTypes.js +27 -20
  310. package/dist/utils/performanceUtils.js +7 -0
  311. package/dist/utils/portUtils.d.ts +47 -11
  312. package/dist/utils/portUtils.js +67 -14
  313. package/dist/utils/portal.d.ts +18 -0
  314. package/dist/utils/portal.js +34 -0
  315. package/dist/utils/schemaMerge.d.ts +25 -0
  316. package/dist/utils/schemaMerge.js +61 -0
  317. package/package.json +7 -5
  318. package/dist/messages/deprecation.d.ts +0 -20
  319. package/dist/messages/deprecation.js +0 -33
  320. package/dist/registry/plugin.d.ts +0 -215
  321. package/dist/registry/plugin.js +0 -249
  322. package/dist/services/api.d.ts +0 -129
  323. package/dist/services/api.js +0 -217
@@ -10,15 +10,16 @@
10
10
  */
11
11
  import type { Component } from 'svelte';
12
12
  import type { WorkflowNode } from '../types/index.js';
13
- import { BaseRegistry } from './BaseRegistry.js';
13
+ import { BaseRegistry } from './BaseRegistry.svelte.js';
14
14
  /**
15
15
  * Props interface that all node components must accept.
16
16
  * Any component registered in the registry must be compatible with these props.
17
17
  */
18
18
  export interface NodeComponentProps {
19
+ /** The SvelteFlow node id */
20
+ id: string;
19
21
  /** Node data containing label, config, metadata, executionInfo */
20
22
  data: WorkflowNode['data'] & {
21
- nodeId?: string;
22
23
  onConfigOpen?: (node: {
23
24
  id: string;
24
25
  type: string;
@@ -86,6 +87,73 @@ export interface NodeRegistrationFilter {
86
87
  /** Custom filter function */
87
88
  predicate?: (registration: NodeComponentRegistration) => boolean;
88
89
  }
90
+ /**
91
+ * Plugin configuration for external libraries.
92
+ * Use this to register multiple node types from a library.
93
+ */
94
+ export interface FlowDropPluginConfig {
95
+ /**
96
+ * Unique namespace for this plugin.
97
+ * Used to prefix all node types (e.g., "mylib" -> "mylib:nodename").
98
+ * Should be lowercase, alphanumeric with optional hyphens.
99
+ */
100
+ namespace: string;
101
+ /** Display name for the plugin (for UI/debugging purposes) */
102
+ name: string;
103
+ /** Plugin version (optional, for debugging) */
104
+ version?: string;
105
+ /** Description of what this plugin provides */
106
+ description?: string;
107
+ /** Node components to register */
108
+ nodes: PluginNodeDefinition[];
109
+ }
110
+ /**
111
+ * Simplified node definition for plugins.
112
+ * Provides a cleaner API than full NodeComponentRegistration.
113
+ */
114
+ export interface PluginNodeDefinition {
115
+ /**
116
+ * Type identifier for this node.
117
+ * Will be prefixed with the plugin namespace (e.g., "fancy" -> "mylib:fancy").
118
+ */
119
+ type: string;
120
+ /** Display name shown in UI */
121
+ displayName: string;
122
+ /** Description of what this node does */
123
+ description?: string;
124
+ /** The Svelte component to render */
125
+ component: Component<NodeComponentProps>;
126
+ /** Icon in iconify format (e.g., "mdi:star") */
127
+ icon?: string;
128
+ /** Category for organizing in UI */
129
+ category?: NodeComponentCategory;
130
+ /** Status overlay position */
131
+ statusPosition?: StatusPosition;
132
+ /** Status overlay size */
133
+ statusSize?: StatusSize;
134
+ }
135
+ /**
136
+ * Result of plugin registration.
137
+ * Contains information about what was registered and any errors.
138
+ */
139
+ export interface PluginRegistrationResult {
140
+ /** Whether all nodes were registered successfully */
141
+ success: boolean;
142
+ /** The plugin namespace */
143
+ namespace: string;
144
+ /** Array of successfully registered type identifiers (namespaced) */
145
+ registeredTypes: string[];
146
+ /** Array of error messages for failed registrations */
147
+ errors: string[];
148
+ }
149
+ /**
150
+ * Check if a namespace is valid.
151
+ * Must be lowercase alphanumeric with optional hyphens.
152
+ *
153
+ * @param namespace - The namespace to validate
154
+ * @returns true if valid
155
+ */
156
+ export declare function isValidNamespace(namespace: string): boolean;
89
157
  /**
90
158
  * Central registry for node component types.
91
159
  * Allows built-in and third-party components to be registered and resolved.
@@ -95,7 +163,7 @@ export interface NodeRegistrationFilter {
95
163
  * @example
96
164
  * ```typescript
97
165
  * // Register a custom node
98
- * nodeComponentRegistry.register({
166
+ * fd.nodes.register({
99
167
  * type: "myCustomNode",
100
168
  * displayName: "My Custom Node",
101
169
  * component: MyCustomNodeComponent,
@@ -104,14 +172,28 @@ export interface NodeRegistrationFilter {
104
172
  * });
105
173
  *
106
174
  * // Get a component
107
- * const component = nodeComponentRegistry.getComponent("myCustomNode");
175
+ * const component = fd.nodes.getComponent("myCustomNode");
108
176
  * ```
109
177
  */
110
- declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRegistration> {
178
+ export declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRegistration> {
111
179
  /** Default type to use when requested type is not found */
112
180
  private defaultType;
113
181
  /** Initial default type, restored on clear() */
114
182
  private static readonly INITIAL_DEFAULT_TYPE;
183
+ /**
184
+ * @param seed - Optional initial registrations and default type. When
185
+ * omitted the registry starts empty; instances created via
186
+ * `createFlowDropInstance` pass the built-in node components (see
187
+ * `builtinNodes.ts`).
188
+ */
189
+ constructor(seed?: {
190
+ registrations?: NodeComponentRegistration[];
191
+ defaultType?: string;
192
+ });
193
+ /**
194
+ * Clear all registrations and reset default type.
195
+ */
196
+ clear(): void;
115
197
  /**
116
198
  * Register a node component type.
117
199
  *
@@ -121,7 +203,7 @@ declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRe
121
203
  *
122
204
  * @example
123
205
  * ```typescript
124
- * nodeComponentRegistry.register({
206
+ * fd.nodes.register({
125
207
  * type: "fancy",
126
208
  * displayName: "Fancy Node",
127
209
  * component: FancyNode,
@@ -129,10 +211,6 @@ declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRe
129
211
  * });
130
212
  * ```
131
213
  */
132
- /**
133
- * Clear all registrations and reset default type.
134
- */
135
- clear(): void;
136
214
  register(registration: NodeComponentRegistration, overwrite?: boolean): void;
137
215
  /**
138
216
  * Register multiple components at once.
@@ -171,10 +249,10 @@ declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRe
171
249
  * @example
172
250
  * ```typescript
173
251
  * // Get all visual nodes
174
- * const visualNodes = nodeComponentRegistry.filter({ category: "visual" });
252
+ * const visualNodes = fd.nodes.filter({ category: "visual" });
175
253
  *
176
254
  * // Get nodes from a specific library
177
- * const libNodes = nodeComponentRegistry.filter({ source: "mylib" });
255
+ * const libNodes = fd.nodes.filter({ source: "mylib" });
178
256
  * ```
179
257
  */
180
258
  filter(filter: NodeRegistrationFilter): NodeComponentRegistration[];
@@ -214,7 +292,7 @@ declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRe
214
292
  *
215
293
  * @example
216
294
  * ```typescript
217
- * const oneOf = nodeComponentRegistry.getOneOfOptions();
295
+ * const oneOf = fd.nodes.getOneOfOptions();
218
296
  * // Use in configSchema: { type: "string", oneOf }
219
297
  * ```
220
298
  */
@@ -236,9 +314,100 @@ declare class NodeComponentRegistry extends BaseRegistry<string, NodeComponentRe
236
314
  * @returns The status size, or default "md"
237
315
  */
238
316
  getStatusSize(type: string): StatusSize;
317
+ /**
318
+ * Register a single custom node without a full plugin.
319
+ * Useful for project-specific custom nodes.
320
+ *
321
+ * @param type - Type identifier (can be namespaced or plain)
322
+ * @param displayName - Display name for UI
323
+ * @param component - Svelte component
324
+ * @param options - Additional options
325
+ *
326
+ * @example
327
+ * ```typescript
328
+ * fd.nodes.registerCustom("myproject:special", "Special Node", MyNode, {
329
+ * icon: "mdi:star",
330
+ * description: "A special node for my project"
331
+ * });
332
+ * ```
333
+ */
334
+ registerCustom(type: string, displayName: string, component: Component<NodeComponentProps>, options?: {
335
+ description?: string;
336
+ icon?: string;
337
+ category?: NodeComponentCategory;
338
+ source?: string;
339
+ statusPosition?: StatusPosition;
340
+ statusSize?: StatusSize;
341
+ }): void;
342
+ /**
343
+ * Register a FlowDrop plugin with custom node components.
344
+ * All node types are automatically namespaced with the plugin namespace.
345
+ *
346
+ * @param config - Plugin configuration with namespace and node definitions
347
+ * @returns Result object with registered types and any errors
348
+ */
349
+ registerPlugin(config: FlowDropPluginConfig): PluginRegistrationResult;
350
+ /**
351
+ * Unregister all nodes from a plugin by namespace.
352
+ *
353
+ * @param namespace - The plugin namespace to unregister
354
+ * @returns Array of unregistered type identifiers
355
+ */
356
+ unregisterPlugin(namespace: string): string[];
357
+ /**
358
+ * Get all registered plugins (unique namespaces).
359
+ *
360
+ * @returns Array of namespace strings
361
+ */
362
+ getRegisteredPlugins(): string[];
363
+ /**
364
+ * Get the count of nodes registered by a plugin.
365
+ *
366
+ * @param namespace - The plugin namespace
367
+ * @returns Number of nodes registered by this plugin
368
+ */
369
+ getPluginNodeCount(namespace: string): number;
239
370
  }
240
- /** Singleton instance of the node component registry */
241
- export declare const nodeComponentRegistry: NodeComponentRegistry;
371
+ /**
372
+ * Create a plugin builder for a fluent API experience.
373
+ *
374
+ * @param namespace - Plugin namespace
375
+ * @param name - Plugin name
376
+ * @returns Plugin builder with chainable methods
377
+ *
378
+ * @example
379
+ * ```typescript
380
+ * import { createPlugin } from "@flowdrop/flowdrop/editor";
381
+ *
382
+ * createPlugin("awesome", "Awesome Nodes")
383
+ * .version("1.0.0")
384
+ * .node("fancy", "Fancy Node", FancyNode)
385
+ * .node("glow", "Glowing Node", GlowNode, { icon: "mdi:lightbulb" })
386
+ * .register(fd.nodes);
387
+ * ```
388
+ */
389
+ export declare function createPlugin(namespace: string, name: string): {
390
+ /**
391
+ * Set plugin version
392
+ */
393
+ version(v: string): /*elided*/ any;
394
+ /**
395
+ * Set plugin description
396
+ */
397
+ description(desc: string): /*elided*/ any;
398
+ /**
399
+ * Add a node to the plugin
400
+ */
401
+ node(type: string, displayName: string, component: Component<NodeComponentProps>, options?: Partial<Omit<PluginNodeDefinition, "type" | "displayName" | "component">>): /*elided*/ any;
402
+ /**
403
+ * Register the plugin into a node component registry (e.g. `fd.nodes`).
404
+ */
405
+ register(registry: NodeComponentRegistry): PluginRegistrationResult;
406
+ /**
407
+ * Get the config without registering (for testing/inspection)
408
+ */
409
+ getConfig(): FlowDropPluginConfig;
410
+ };
242
411
  /**
243
412
  * Helper function to create a namespaced type identifier.
244
413
  * Use this to avoid conflicts when registering custom nodes.
@@ -273,4 +442,3 @@ export declare function parseNamespacedType(namespacedType: string): {
273
442
  namespace: string;
274
443
  type: string;
275
444
  } | null;
276
- export {};
@@ -8,7 +8,17 @@
8
8
  * - External libraries to contribute node types via plugins
9
9
  * - Runtime switching between different node visualizations
10
10
  */
11
- import { BaseRegistry } from './BaseRegistry.js';
11
+ import { BaseRegistry } from './BaseRegistry.svelte.js';
12
+ /**
13
+ * Check if a namespace is valid.
14
+ * Must be lowercase alphanumeric with optional hyphens.
15
+ *
16
+ * @param namespace - The namespace to validate
17
+ * @returns true if valid
18
+ */
19
+ export function isValidNamespace(namespace) {
20
+ return /^[a-z][a-z0-9-]*$/.test(namespace);
21
+ }
12
22
  /**
13
23
  * Central registry for node component types.
14
24
  * Allows built-in and third-party components to be registered and resolved.
@@ -18,7 +28,7 @@ import { BaseRegistry } from './BaseRegistry.js';
18
28
  * @example
19
29
  * ```typescript
20
30
  * // Register a custom node
21
- * nodeComponentRegistry.register({
31
+ * fd.nodes.register({
22
32
  * type: "myCustomNode",
23
33
  * displayName: "My Custom Node",
24
34
  * component: MyCustomNodeComponent,
@@ -27,14 +37,37 @@ import { BaseRegistry } from './BaseRegistry.js';
27
37
  * });
28
38
  *
29
39
  * // Get a component
30
- * const component = nodeComponentRegistry.getComponent("myCustomNode");
40
+ * const component = fd.nodes.getComponent("myCustomNode");
31
41
  * ```
32
42
  */
33
- class NodeComponentRegistry extends BaseRegistry {
43
+ export class NodeComponentRegistry extends BaseRegistry {
34
44
  /** Default type to use when requested type is not found */
35
45
  defaultType = 'workflowNode';
36
46
  /** Initial default type, restored on clear() */
37
47
  static INITIAL_DEFAULT_TYPE = 'workflowNode';
48
+ /**
49
+ * @param seed - Optional initial registrations and default type. When
50
+ * omitted the registry starts empty; instances created via
51
+ * `createFlowDropInstance` pass the built-in node components (see
52
+ * `builtinNodes.ts`).
53
+ */
54
+ constructor(seed) {
55
+ super();
56
+ if (seed?.registrations) {
57
+ this.registerAll(seed.registrations, true);
58
+ }
59
+ if (seed?.defaultType) {
60
+ this.defaultType = seed.defaultType;
61
+ }
62
+ }
63
+ /**
64
+ * Clear all registrations and reset default type.
65
+ */
66
+ clear() {
67
+ super.clear();
68
+ this.defaultType = NodeComponentRegistry.INITIAL_DEFAULT_TYPE;
69
+ this.touch(); // defaultType changed — invalidate getComponent/getDefaultType reads
70
+ }
38
71
  /**
39
72
  * Register a node component type.
40
73
  *
@@ -44,7 +77,7 @@ class NodeComponentRegistry extends BaseRegistry {
44
77
  *
45
78
  * @example
46
79
  * ```typescript
47
- * nodeComponentRegistry.register({
80
+ * fd.nodes.register({
48
81
  * type: "fancy",
49
82
  * displayName: "Fancy Node",
50
83
  * component: FancyNode,
@@ -52,19 +85,13 @@ class NodeComponentRegistry extends BaseRegistry {
52
85
  * });
53
86
  * ```
54
87
  */
55
- /**
56
- * Clear all registrations and reset default type.
57
- */
58
- clear() {
59
- super.clear();
60
- this.defaultType = NodeComponentRegistry.INITIAL_DEFAULT_TYPE;
61
- }
62
88
  register(registration, overwrite = false) {
63
89
  if (this.items.has(registration.type) && !overwrite) {
64
90
  throw new Error(`Node type "${registration.type}" is already registered. ` +
65
91
  `Use overwrite: true to replace it, or use a namespaced type like "mylib:${registration.type}".`);
66
92
  }
67
93
  this.items.set(registration.type, registration);
94
+ this.touch();
68
95
  this.notifyListeners();
69
96
  }
70
97
  /**
@@ -86,6 +113,7 @@ class NodeComponentRegistry extends BaseRegistry {
86
113
  * @returns The component if found, or the default component
87
114
  */
88
115
  getComponent(type) {
116
+ this.trackVersion(); // reactive dependency (reads items + defaultType directly)
89
117
  const registration = this.items.get(type) ?? this.items.get(this.defaultType);
90
118
  return registration?.component;
91
119
  }
@@ -96,6 +124,7 @@ class NodeComponentRegistry extends BaseRegistry {
96
124
  * @returns The metadata if found, undefined otherwise
97
125
  */
98
126
  getMetadata(type) {
127
+ this.trackVersion(); // reactive dependency (reads items directly)
99
128
  const reg = this.items.get(type);
100
129
  if (!reg)
101
130
  return undefined;
@@ -119,10 +148,10 @@ class NodeComponentRegistry extends BaseRegistry {
119
148
  * @example
120
149
  * ```typescript
121
150
  * // Get all visual nodes
122
- * const visualNodes = nodeComponentRegistry.filter({ category: "visual" });
151
+ * const visualNodes = fd.nodes.filter({ category: "visual" });
123
152
  *
124
153
  * // Get nodes from a specific library
125
- * const libNodes = nodeComponentRegistry.filter({ source: "mylib" });
154
+ * const libNodes = fd.nodes.filter({ source: "mylib" });
126
155
  * ```
127
156
  */
128
157
  filter(filter) {
@@ -168,6 +197,7 @@ class NodeComponentRegistry extends BaseRegistry {
168
197
  throw new Error(`Cannot set default to unregistered type: ${type}`);
169
198
  }
170
199
  this.defaultType = type;
200
+ this.touch(); // defaultType changed — invalidate getComponent/getDefaultType reads
171
201
  }
172
202
  /**
173
203
  * Get the current default type.
@@ -175,6 +205,7 @@ class NodeComponentRegistry extends BaseRegistry {
175
205
  * @returns The default type identifier
176
206
  */
177
207
  getDefaultType() {
208
+ this.trackVersion(); // reactive dependency (reads defaultType directly)
178
209
  return this.defaultType;
179
210
  }
180
211
  /**
@@ -186,7 +217,7 @@ class NodeComponentRegistry extends BaseRegistry {
186
217
  *
187
218
  * @example
188
219
  * ```typescript
189
- * const oneOf = nodeComponentRegistry.getOneOfOptions();
220
+ * const oneOf = fd.nodes.getOneOfOptions();
190
221
  * // Use in configSchema: { type: "string", oneOf }
191
222
  * ```
192
223
  */
@@ -204,6 +235,7 @@ class NodeComponentRegistry extends BaseRegistry {
204
235
  * @returns The status position, or default "top-right"
205
236
  */
206
237
  getStatusPosition(type) {
238
+ this.trackVersion(); // reactive dependency (reads items directly)
207
239
  return this.items.get(type)?.statusPosition ?? 'top-right';
208
240
  }
209
241
  /**
@@ -213,11 +245,197 @@ class NodeComponentRegistry extends BaseRegistry {
213
245
  * @returns The status size, or default "md"
214
246
  */
215
247
  getStatusSize(type) {
248
+ this.trackVersion(); // reactive dependency (reads items directly)
216
249
  return this.items.get(type)?.statusSize ?? 'md';
217
250
  }
251
+ // ==========================================================================
252
+ // Plugin system
253
+ // ==========================================================================
254
+ /**
255
+ * Register a single custom node without a full plugin.
256
+ * Useful for project-specific custom nodes.
257
+ *
258
+ * @param type - Type identifier (can be namespaced or plain)
259
+ * @param displayName - Display name for UI
260
+ * @param component - Svelte component
261
+ * @param options - Additional options
262
+ *
263
+ * @example
264
+ * ```typescript
265
+ * fd.nodes.registerCustom("myproject:special", "Special Node", MyNode, {
266
+ * icon: "mdi:star",
267
+ * description: "A special node for my project"
268
+ * });
269
+ * ```
270
+ */
271
+ registerCustom(type, displayName, component, options = {}) {
272
+ this.register({
273
+ type,
274
+ displayName,
275
+ component,
276
+ description: options.description,
277
+ icon: options.icon,
278
+ category: options.category ?? 'custom',
279
+ source: options.source ?? 'custom',
280
+ statusPosition: options.statusPosition,
281
+ statusSize: options.statusSize
282
+ });
283
+ }
284
+ /**
285
+ * Register a FlowDrop plugin with custom node components.
286
+ * All node types are automatically namespaced with the plugin namespace.
287
+ *
288
+ * @param config - Plugin configuration with namespace and node definitions
289
+ * @returns Result object with registered types and any errors
290
+ */
291
+ registerPlugin(config) {
292
+ const result = {
293
+ success: true,
294
+ namespace: config.namespace,
295
+ registeredTypes: [],
296
+ errors: []
297
+ };
298
+ // Validate namespace
299
+ if (!isValidNamespace(config.namespace)) {
300
+ result.success = false;
301
+ result.errors.push(`Invalid namespace "${config.namespace}". ` +
302
+ `Namespace must be lowercase alphanumeric with optional hyphens.`);
303
+ return result;
304
+ }
305
+ // Register each node
306
+ for (const nodeDef of config.nodes) {
307
+ try {
308
+ const namespacedType = createNamespacedType(config.namespace, nodeDef.type);
309
+ const registration = {
310
+ type: namespacedType,
311
+ displayName: nodeDef.displayName,
312
+ description: nodeDef.description,
313
+ component: nodeDef.component,
314
+ icon: nodeDef.icon,
315
+ category: nodeDef.category ?? 'custom',
316
+ source: config.namespace,
317
+ statusPosition: nodeDef.statusPosition,
318
+ statusSize: nodeDef.statusSize
319
+ };
320
+ this.register(registration);
321
+ result.registeredTypes.push(namespacedType);
322
+ }
323
+ catch (error) {
324
+ result.success = false;
325
+ const errorMessage = error instanceof Error ? error.message : String(error);
326
+ result.errors.push(`Failed to register ${config.namespace}:${nodeDef.type}: ${errorMessage}`);
327
+ }
328
+ }
329
+ return result;
330
+ }
331
+ /**
332
+ * Unregister all nodes from a plugin by namespace.
333
+ *
334
+ * @param namespace - The plugin namespace to unregister
335
+ * @returns Array of unregistered type identifiers
336
+ */
337
+ unregisterPlugin(namespace) {
338
+ const unregistered = [];
339
+ const types = this.getTypes();
340
+ for (const type of types) {
341
+ if (type.startsWith(`${namespace}:`)) {
342
+ if (this.unregister(type)) {
343
+ unregistered.push(type);
344
+ }
345
+ }
346
+ }
347
+ return unregistered;
348
+ }
349
+ /**
350
+ * Get all registered plugins (unique namespaces).
351
+ *
352
+ * @returns Array of namespace strings
353
+ */
354
+ getRegisteredPlugins() {
355
+ const sources = new Set();
356
+ for (const reg of this.getAll()) {
357
+ if (reg.source && reg.source !== 'flowdrop') {
358
+ sources.add(reg.source);
359
+ }
360
+ }
361
+ return Array.from(sources);
362
+ }
363
+ /**
364
+ * Get the count of nodes registered by a plugin.
365
+ *
366
+ * @param namespace - The plugin namespace
367
+ * @returns Number of nodes registered by this plugin
368
+ */
369
+ getPluginNodeCount(namespace) {
370
+ return this.getBySource(namespace).length;
371
+ }
372
+ }
373
+ /**
374
+ * Create a plugin builder for a fluent API experience.
375
+ *
376
+ * @param namespace - Plugin namespace
377
+ * @param name - Plugin name
378
+ * @returns Plugin builder with chainable methods
379
+ *
380
+ * @example
381
+ * ```typescript
382
+ * import { createPlugin } from "@flowdrop/flowdrop/editor";
383
+ *
384
+ * createPlugin("awesome", "Awesome Nodes")
385
+ * .version("1.0.0")
386
+ * .node("fancy", "Fancy Node", FancyNode)
387
+ * .node("glow", "Glowing Node", GlowNode, { icon: "mdi:lightbulb" })
388
+ * .register(fd.nodes);
389
+ * ```
390
+ */
391
+ export function createPlugin(namespace, name) {
392
+ const config = {
393
+ namespace,
394
+ name,
395
+ nodes: []
396
+ };
397
+ const builder = {
398
+ /**
399
+ * Set plugin version
400
+ */
401
+ version(v) {
402
+ config.version = v;
403
+ return builder;
404
+ },
405
+ /**
406
+ * Set plugin description
407
+ */
408
+ description(desc) {
409
+ config.description = desc;
410
+ return builder;
411
+ },
412
+ /**
413
+ * Add a node to the plugin
414
+ */
415
+ node(type, displayName, component, options = {}) {
416
+ config.nodes.push({
417
+ type,
418
+ displayName,
419
+ component,
420
+ ...options
421
+ });
422
+ return builder;
423
+ },
424
+ /**
425
+ * Register the plugin into a node component registry (e.g. `fd.nodes`).
426
+ */
427
+ register(registry) {
428
+ return registry.registerPlugin(config);
429
+ },
430
+ /**
431
+ * Get the config without registering (for testing/inspection)
432
+ */
433
+ getConfig() {
434
+ return { ...config };
435
+ }
436
+ };
437
+ return builder;
218
438
  }
219
- /** Singleton instance of the node component registry */
220
- export const nodeComponentRegistry = new NodeComponentRegistry();
221
439
  /**
222
440
  * Helper function to create a namespaced type identifier.
223
441
  * Use this to avoid conflicts when registering custom nodes.
@@ -13,7 +13,7 @@
13
13
  */
14
14
  import type { StandardWorkflow } from '../adapters/WorkflowAdapter.js';
15
15
  import type { NodeMetadata, WorkflowFormat } from '../types/index.js';
16
- import { BaseRegistry } from './BaseRegistry.js';
16
+ import { BaseRegistry } from './BaseRegistry.svelte.js';
17
17
  /**
18
18
  * Validation result returned by format adapters.
19
19
  */
@@ -60,13 +60,15 @@ export interface WorkflowFormatAdapter {
60
60
  validate?(workflow: StandardWorkflow): FormatValidationResult;
61
61
  }
62
62
  /**
63
- * Central registry for workflow format adapters.
64
- * Singleton — extends BaseRegistry for shared mechanics.
63
+ * Per-instance registry for workflow format adapters.
64
+ * Extends BaseRegistry for shared mechanics; seeded with the built-in
65
+ * adapters at construction (see `createFlowDropInstance`). Reach it via
66
+ * `fd.formats`, or supply adapters through the `formatAdapters` mount option.
65
67
  *
66
68
  * @example
67
69
  * ```typescript
68
70
  * // Register a custom format
69
- * workflowFormatRegistry.register({
71
+ * fd.formats.register({
70
72
  * id: 'n8n',
71
73
  * name: 'n8n Workflow',
72
74
  * export: (workflow) => JSON.stringify(convertToN8n(workflow)),
@@ -74,10 +76,16 @@ export interface WorkflowFormatAdapter {
74
76
  * });
75
77
  *
76
78
  * // Get an adapter
77
- * const adapter = workflowFormatRegistry.get('n8n');
79
+ * const adapter = fd.formats.get('n8n');
78
80
  * ```
79
81
  */
80
- declare class WorkflowFormatRegistry extends BaseRegistry<string, WorkflowFormatAdapter> {
82
+ export declare class WorkflowFormatRegistry extends BaseRegistry<string, WorkflowFormatAdapter> {
83
+ /**
84
+ * @param seed - Optional initial format adapters. When omitted the registry
85
+ * starts empty; instances created via `createFlowDropInstance` pass the
86
+ * built-in flowdrop + agentspec adapters (see `builtinFormats.ts`).
87
+ */
88
+ constructor(seed?: WorkflowFormatAdapter[]);
81
89
  /**
82
90
  * Register a workflow format adapter.
83
91
  *
@@ -117,6 +125,3 @@ declare class WorkflowFormatRegistry extends BaseRegistry<string, WorkflowFormat
117
125
  title: string;
118
126
  }>;
119
127
  }
120
- /** Singleton instance of the workflow format registry */
121
- export declare const workflowFormatRegistry: WorkflowFormatRegistry;
122
- export {};