@flowdrop/flowdrop 2.11.0 → 2.13.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 (455) hide show
  1. package/CHANGELOG.md +233 -0
  2. package/dist/adapters/agentspec/autoLayout.d.ts +18 -36
  3. package/dist/adapters/agentspec/autoLayout.js +75 -93
  4. package/dist/chat/activity.d.ts +49 -0
  5. package/dist/chat/activity.js +65 -0
  6. package/dist/chat/commandClassifier.js +2 -1
  7. package/dist/commands/executor.js +186 -27
  8. package/dist/commands/index.d.ts +2 -1
  9. package/dist/commands/index.js +2 -0
  10. package/dist/commands/parser.js +43 -3
  11. package/dist/commands/session.d.ts +60 -0
  12. package/dist/commands/session.js +332 -0
  13. package/dist/commands/storeIntegration.svelte.js +18 -1
  14. package/dist/commands/types.d.ts +77 -4
  15. package/dist/components/App.svelte +976 -226
  16. package/dist/components/App.svelte.d.ts +34 -2
  17. package/dist/components/BindablePortListbox.svelte +68 -369
  18. package/dist/components/Button.svelte +17 -14
  19. package/dist/components/Button.svelte.d.ts +2 -2
  20. package/dist/components/CanvasContextMenu.svelte +31 -10
  21. package/dist/components/CanvasController.svelte +146 -3
  22. package/dist/components/CanvasController.svelte.d.ts +25 -33
  23. package/dist/components/CanvasIconButton.svelte +6 -6
  24. package/dist/components/CanvasToolbar.svelte +103 -0
  25. package/dist/components/CanvasToolbar.svelte.d.ts +23 -0
  26. package/dist/components/CanvasZoomControls.svelte +122 -0
  27. package/dist/components/CanvasZoomControls.svelte.d.ts +15 -0
  28. package/dist/components/ConfigForm.svelte +159 -121
  29. package/dist/components/ConfigModal.svelte +11 -54
  30. package/dist/components/ConfigPanel.svelte +98 -228
  31. package/dist/components/ConfigPanel.svelte.d.ts +2 -2
  32. package/dist/components/ConnectPortPicker.svelte +153 -0
  33. package/dist/components/ConnectPortPicker.svelte.d.ts +22 -0
  34. package/dist/components/DoctorMenu.svelte +422 -0
  35. package/dist/components/DoctorMenu.svelte.d.ts +7 -0
  36. package/dist/components/ExternalLinkRow.svelte +82 -0
  37. package/dist/components/ExternalLinkRow.svelte.d.ts +14 -0
  38. package/dist/components/FlowDropEdge.svelte +52 -2
  39. package/dist/components/FlowDropEdge.svelte.d.ts +5 -1
  40. package/dist/components/InterfaceNameInput.svelte +103 -0
  41. package/dist/components/InterfaceNameInput.svelte.d.ts +13 -0
  42. package/dist/components/InterfaceTag.svelte +215 -0
  43. package/dist/components/InterfaceTag.svelte.d.ts +20 -0
  44. package/dist/components/InterfaceTagAnchor.svelte +103 -0
  45. package/dist/components/InterfaceTagAnchor.svelte.d.ts +12 -0
  46. package/dist/components/InterfaceTagLayer.svelte +314 -0
  47. package/dist/components/InterfaceTagLayer.svelte.d.ts +28 -0
  48. package/dist/components/LogsSidebar.svelte +43 -43
  49. package/dist/components/LoopbackLanes.svelte +54 -0
  50. package/dist/components/LoopbackLanes.svelte.d.ts +8 -0
  51. package/dist/components/Navbar.svelte +539 -169
  52. package/dist/components/Navbar.svelte.d.ts +20 -1
  53. package/dist/components/NodeInspector.svelte +153 -0
  54. package/dist/components/NodeInspector.svelte.d.ts +19 -0
  55. package/dist/components/NodeLastRun.svelte +212 -0
  56. package/dist/components/NodeLastRun.svelte.d.ts +13 -0
  57. package/dist/components/NodeSidebar.svelte +279 -23
  58. package/dist/components/NodeSidebar.svelte.d.ts +11 -0
  59. package/dist/components/NodeStatusOverlay.svelte +144 -353
  60. package/dist/components/NodeStatusOverlay.svelte.d.ts +4 -1
  61. package/dist/components/PortMappingRow.svelte +28 -44
  62. package/dist/components/PortPickerListbox.svelte +475 -0
  63. package/dist/components/PortPickerListbox.svelte.d.ts +73 -0
  64. package/dist/components/ReadOnlyDetails.svelte +52 -89
  65. package/dist/components/RunBar.svelte +222 -0
  66. package/dist/components/RunBar.svelte.d.ts +20 -0
  67. package/dist/components/RunsMenu.svelte +649 -0
  68. package/dist/components/RunsMenu.svelte.d.ts +14 -0
  69. package/dist/components/SettingsModal.svelte +27 -59
  70. package/dist/components/SettingsPanel.svelte +515 -241
  71. package/dist/components/StraightGuides.svelte +46 -0
  72. package/dist/components/StraightGuides.svelte.d.ts +7 -0
  73. package/dist/components/ThemeToggle.svelte +14 -4
  74. package/dist/components/UniversalNode.svelte +152 -51
  75. package/dist/components/WebMCPBridgeMenu.svelte +336 -0
  76. package/dist/components/WebMCPBridgeMenu.svelte.d.ts +3 -0
  77. package/dist/components/WorkflowEditor.svelte +789 -136
  78. package/dist/components/WorkflowEditor.svelte.d.ts +43 -1
  79. package/dist/components/WorkflowInterfaceEditor.svelte +63 -92
  80. package/dist/components/WorkflowInterfaceEntryCard.svelte +478 -549
  81. package/dist/components/WorkflowInterfaceEntryComposer.svelte +23 -67
  82. package/dist/components/WorkflowPlaygroundSettings.svelte +48 -85
  83. package/dist/components/WorkflowSettingsPanel.svelte +311 -0
  84. package/dist/components/WorkflowSettingsPanel.svelte.d.ts +20 -0
  85. package/dist/components/ZoomTier.svelte +56 -0
  86. package/dist/components/ZoomTier.svelte.d.ts +4 -0
  87. package/dist/components/chat/AIChatPanel.svelte +463 -312
  88. package/dist/components/chat/ActivityList.svelte +130 -0
  89. package/dist/components/chat/ActivityList.svelte.d.ts +11 -0
  90. package/dist/components/chat/ActivityRow.svelte +179 -0
  91. package/dist/components/chat/ActivityRow.svelte.d.ts +16 -0
  92. package/dist/components/chat/CommandPreview.svelte +42 -64
  93. package/dist/components/console/CommandConsole.svelte +106 -41
  94. package/dist/components/console/CommandConsole.svelte.d.ts +2 -0
  95. package/dist/components/console/ConsoleAutocomplete.svelte +14 -13
  96. package/dist/components/console/ConsoleInput.svelte +60 -27
  97. package/dist/components/console/ConsoleOutput.svelte +86 -24
  98. package/dist/components/console/ConsoleStrip.svelte +80 -0
  99. package/dist/components/console/ConsoleStrip.svelte.d.ts +13 -0
  100. package/dist/components/form/FieldFactory.svelte +30 -4
  101. package/dist/components/form/FormArray.svelte +306 -339
  102. package/dist/components/form/FormArray.svelte.d.ts +10 -0
  103. package/dist/components/form/FormArrayRows.svelte +443 -0
  104. package/dist/components/form/FormArrayRows.svelte.d.ts +18 -0
  105. package/dist/components/form/FormAutocomplete.svelte +2 -2
  106. package/dist/components/form/FormCheckboxGroup.svelte +10 -85
  107. package/dist/components/form/FormCodeEditor.svelte +3 -3
  108. package/dist/components/form/FormFieldWrapper.svelte +98 -18
  109. package/dist/components/form/FormFieldWrapper.svelte.d.ts +10 -0
  110. package/dist/components/form/FormFieldset.svelte +44 -28
  111. package/dist/components/form/FormMarkdownEditor.svelte +6 -6
  112. package/dist/components/form/FormPorts.svelte +437 -141
  113. package/dist/components/form/FormSelect.svelte +1 -1
  114. package/dist/components/form/FormTemplateEditor.svelte +22 -26
  115. package/dist/components/form/FormToggle.svelte +15 -106
  116. package/dist/components/form/FormToggle.svelte.d.ts +3 -2
  117. package/dist/components/form/FormUISchemaRenderer.svelte +38 -3
  118. package/dist/components/form/humanizeKey.d.ts +7 -0
  119. package/dist/components/form/humanizeKey.js +21 -0
  120. package/dist/components/form/types.d.ts +6 -0
  121. package/dist/components/icons/MenuOpenIcon.svelte +8 -1
  122. package/dist/components/interrupt/ChoicePrompt.svelte +51 -152
  123. package/dist/components/interrupt/ChoicePrompt.svelte.d.ts +0 -2
  124. package/dist/components/interrupt/ConfirmationPrompt.svelte +18 -201
  125. package/dist/components/interrupt/ConfirmationPrompt.svelte.d.ts +0 -4
  126. package/dist/components/interrupt/FormPrompt.svelte +22 -147
  127. package/dist/components/interrupt/FormPrompt.svelte.d.ts +0 -4
  128. package/dist/components/interrupt/InterruptBubble.svelte +198 -355
  129. package/dist/components/interrupt/InterruptBubble.svelte.d.ts +0 -2
  130. package/dist/components/interrupt/ReviewPrompt.svelte +0 -10
  131. package/dist/components/interrupt/TextInputPrompt.svelte +23 -120
  132. package/dist/components/interrupt/TextInputPrompt.svelte.d.ts +0 -2
  133. package/dist/components/layouts/MainLayout.svelte +110 -75
  134. package/dist/components/layouts/MainLayout.svelte.d.ts +17 -0
  135. package/dist/components/nodes/CaptionNode.svelte +7 -0
  136. package/dist/components/nodes/GatewayNode.svelte +66 -431
  137. package/dist/components/nodes/IdeaNode.svelte +6 -5
  138. package/dist/components/nodes/NodeCard.svelte +1051 -0
  139. package/dist/components/nodes/NodeCard.svelte.d.ts +30 -0
  140. package/dist/components/nodes/NodeConfigButton.svelte +28 -9
  141. package/dist/components/nodes/NodeProblemMark.svelte +113 -0
  142. package/dist/components/nodes/NodeProblemMark.svelte.d.ts +8 -0
  143. package/dist/components/nodes/NodeTip.svelte +104 -0
  144. package/dist/components/nodes/NodeTip.svelte.d.ts +15 -0
  145. package/dist/components/nodes/NotesNode.svelte +183 -150
  146. package/dist/components/nodes/SimpleNode.svelte +176 -44
  147. package/dist/components/nodes/SquareNode.svelte +127 -34
  148. package/dist/components/nodes/TerminalNode.svelte +232 -88
  149. package/dist/components/nodes/ToolNode.svelte +49 -381
  150. package/dist/components/nodes/WorkflowNode.svelte +40 -399
  151. package/dist/components/playground/ChatBubble.svelte +248 -62
  152. package/dist/components/playground/ChatInput.svelte +134 -297
  153. package/dist/components/playground/ChatInput.svelte.d.ts +17 -0
  154. package/dist/components/playground/ControlPanel.svelte +290 -190
  155. package/dist/components/playground/ControlPanel.svelte.d.ts +10 -2
  156. package/dist/components/playground/DockedPlayground.svelte +82 -0
  157. package/dist/components/playground/DockedPlayground.svelte.d.ts +30 -0
  158. package/dist/components/playground/ExecutionConsole.svelte +54 -36
  159. package/dist/components/playground/ExecutionConsole.svelte.d.ts +12 -0
  160. package/dist/components/playground/ExecutionLogs.svelte +4 -0
  161. package/dist/components/playground/HeaderMenu.svelte +170 -0
  162. package/dist/components/playground/HeaderMenu.svelte.d.ts +22 -0
  163. package/dist/components/playground/InputCollector.svelte +8 -32
  164. package/dist/components/playground/InputFields.svelte +246 -0
  165. package/dist/components/playground/InputFields.svelte.d.ts +16 -0
  166. package/dist/components/playground/InterfaceInputForm.svelte +285 -30
  167. package/dist/components/playground/InterfaceInputForm.svelte.d.ts +20 -0
  168. package/dist/components/playground/InterfaceJsonInput.svelte +92 -0
  169. package/dist/components/playground/InterfaceJsonInput.svelte.d.ts +10 -0
  170. package/dist/components/playground/LogRow.svelte +12 -12
  171. package/dist/components/playground/MessageMarkdown.svelte +11 -11
  172. package/dist/components/playground/MessageStream.svelte +154 -182
  173. package/dist/components/playground/Playground.svelte +17 -1139
  174. package/dist/components/playground/PlaygroundApp.svelte +12 -2
  175. package/dist/components/playground/PlaygroundApp.svelte.d.ts +2 -1
  176. package/dist/components/playground/PlaygroundHeader.svelte +309 -0
  177. package/dist/components/playground/PlaygroundHeader.svelte.d.ts +22 -0
  178. package/dist/components/playground/PlaygroundModal.svelte +6 -0
  179. package/dist/components/playground/PlaygroundStudio.svelte +30 -32
  180. package/dist/components/playground/PlaygroundSurface.svelte +648 -0
  181. package/dist/components/playground/PlaygroundSurface.svelte.d.ts +79 -0
  182. package/dist/components/playground/StepsSummary.svelte +312 -0
  183. package/dist/components/playground/StepsSummary.svelte.d.ts +11 -0
  184. package/dist/components/playground/messageDisplay.d.ts +9 -0
  185. package/dist/components/playground/messageDisplay.js +24 -2
  186. package/dist/components/playground/stepSummary.d.ts +71 -0
  187. package/dist/components/playground/stepSummary.js +152 -0
  188. package/dist/components/ports/PortTypeBadge.svelte +13 -1
  189. package/dist/components/primitives/Button.svelte +226 -0
  190. package/dist/components/primitives/Button.svelte.d.ts +31 -0
  191. package/dist/components/primitives/Card.svelte +110 -0
  192. package/dist/components/primitives/Card.svelte.d.ts +20 -0
  193. package/dist/components/primitives/Checkbox.svelte +126 -0
  194. package/dist/components/primitives/Checkbox.svelte.d.ts +15 -0
  195. package/dist/components/primitives/Chip.svelte +143 -0
  196. package/dist/components/primitives/Chip.svelte.d.ts +22 -0
  197. package/dist/components/primitives/Combobox.svelte +444 -0
  198. package/dist/components/primitives/Combobox.svelte.d.ts +22 -0
  199. package/dist/components/primitives/Composer.svelte +293 -0
  200. package/dist/components/primitives/Composer.svelte.d.ts +47 -0
  201. package/dist/components/primitives/EmptyState.svelte +113 -0
  202. package/dist/components/primitives/EmptyState.svelte.d.ts +18 -0
  203. package/dist/components/primitives/Field.svelte +178 -0
  204. package/dist/components/primitives/Field.svelte.d.ts +30 -0
  205. package/dist/components/primitives/IconButton.svelte +156 -0
  206. package/dist/components/primitives/IconButton.svelte.d.ts +27 -0
  207. package/dist/components/primitives/Menu.svelte +435 -0
  208. package/dist/components/primitives/Menu.svelte.d.ts +61 -0
  209. package/dist/components/primitives/Notice.svelte +161 -0
  210. package/dist/components/primitives/Notice.svelte.d.ts +22 -0
  211. package/dist/components/primitives/PanelHeader.svelte +134 -0
  212. package/dist/components/primitives/PanelHeader.svelte.d.ts +23 -0
  213. package/dist/components/primitives/Segmented.svelte +198 -0
  214. package/dist/components/primitives/Segmented.svelte.d.ts +32 -0
  215. package/dist/components/primitives/Select.svelte +130 -0
  216. package/dist/components/primitives/Select.svelte.d.ts +26 -0
  217. package/dist/components/primitives/StatusPill.svelte +218 -0
  218. package/dist/components/primitives/StatusPill.svelte.d.ts +24 -0
  219. package/dist/components/primitives/Switch.svelte +113 -0
  220. package/dist/components/primitives/Switch.svelte.d.ts +14 -0
  221. package/dist/components/primitives/Tabs.svelte +209 -0
  222. package/dist/components/primitives/Tabs.svelte.d.ts +32 -0
  223. package/dist/components/primitives/Toolbar.svelte +94 -0
  224. package/dist/components/primitives/Toolbar.svelte.d.ts +14 -0
  225. package/dist/components/primitives/ToolbarSeparator.svelte +40 -0
  226. package/dist/components/primitives/ToolbarSeparator.svelte.d.ts +7 -0
  227. package/dist/components/surfaces/SurfaceOverlay.svelte +10 -40
  228. package/dist/components/surfaces/TabbedSurface.svelte +49 -39
  229. package/dist/components/surfaces/TabbedSurface.svelte.d.ts +8 -0
  230. package/dist/components/toast/DismissibleToast.svelte +94 -32
  231. package/dist/components/toast/DismissibleToast.svelte.d.ts +17 -7
  232. package/dist/config/endpoints.d.ts +43 -1
  233. package/dist/config/endpoints.js +21 -3
  234. package/dist/core/index.d.ts +8 -5
  235. package/dist/core/index.js +1 -1
  236. package/dist/editor/connectCandidates.d.ts +56 -0
  237. package/dist/editor/connectCandidates.js +131 -0
  238. package/dist/editor/contextMenu.d.ts +31 -2
  239. package/dist/editor/contextMenu.js +96 -9
  240. package/dist/editor/index.d.ts +4 -1
  241. package/dist/editor/index.js +1 -0
  242. package/dist/editor/interfaceMenu.d.ts +35 -0
  243. package/dist/editor/interfaceMenu.js +47 -0
  244. package/dist/editor/portMenu.d.ts +23 -0
  245. package/dist/editor/portMenu.js +34 -0
  246. package/dist/editor/tidy.d.ts +30 -0
  247. package/dist/editor/tidy.js +66 -0
  248. package/dist/helpers/workflowEditorHelper.d.ts +3 -0
  249. package/dist/helpers/workflowEditorHelper.js +8 -3
  250. package/dist/layout/fromWorkflow.d.ts +42 -0
  251. package/dist/layout/fromWorkflow.js +135 -0
  252. package/dist/layout/geometry.d.ts +102 -0
  253. package/dist/layout/geometry.js +317 -0
  254. package/dist/layout/index.d.ts +21 -0
  255. package/dist/layout/index.js +14 -0
  256. package/dist/layout/inspect.d.ts +18 -0
  257. package/dist/layout/inspect.js +81 -0
  258. package/dist/layout/lanePath.d.ts +23 -0
  259. package/dist/layout/lanePath.js +47 -0
  260. package/dist/layout/measure.d.ts +141 -0
  261. package/dist/layout/measure.js +477 -0
  262. package/dist/layout/primitives.d.ts +124 -0
  263. package/dist/layout/primitives.js +461 -0
  264. package/dist/layout/sweep.d.ts +59 -0
  265. package/dist/layout/sweep.js +257 -0
  266. package/dist/layout/toWorkflow.d.ts +43 -0
  267. package/dist/layout/toWorkflow.js +131 -0
  268. package/dist/layout/types.d.ts +93 -0
  269. package/dist/layout/types.js +35 -0
  270. package/dist/messages/defaults.d.ts +641 -26
  271. package/dist/messages/defaults.js +578 -25
  272. package/dist/messages/types.d.ts +21 -1
  273. package/dist/openapi/v1/openapi.yaml +109 -0
  274. package/dist/playground/index.d.ts +28 -1
  275. package/dist/playground/index.js +29 -0
  276. package/dist/playground/mount.d.ts +28 -2
  277. package/dist/playground/mount.js +41 -15
  278. package/dist/playground/runAction.d.ts +29 -0
  279. package/dist/playground/runAction.js +38 -0
  280. package/dist/services/doctorService.d.ts +52 -0
  281. package/dist/services/doctorService.js +113 -0
  282. package/dist/services/globalSave.js +12 -29
  283. package/dist/services/nodeExecutionService.d.ts +12 -1
  284. package/dist/services/nodeExecutionService.js +58 -58
  285. package/dist/services/playgroundService.d.ts +17 -2
  286. package/dist/services/playgroundService.js +48 -5
  287. package/dist/services/runsService.d.ts +42 -0
  288. package/dist/services/runsService.js +87 -0
  289. package/dist/services/toastQueue.d.ts +33 -0
  290. package/dist/services/toastQueue.js +38 -0
  291. package/dist/services/toastService.d.ts +30 -9
  292. package/dist/services/toastService.js +81 -46
  293. package/dist/settings/index.d.ts +1 -0
  294. package/dist/skins/graphite.d.ts +26 -0
  295. package/dist/skins/graphite.js +473 -0
  296. package/dist/skins/index.d.ts +2 -1
  297. package/dist/skins/index.js +4 -2
  298. package/dist/skins/slate.js +4 -4
  299. package/dist/stores/attachedRunStore.svelte.d.ts +35 -0
  300. package/dist/stores/attachedRunStore.svelte.js +47 -0
  301. package/dist/stores/connectDragStore.svelte.d.ts +39 -0
  302. package/dist/stores/connectDragStore.svelte.js +42 -0
  303. package/dist/stores/doctorStore.svelte.d.ts +79 -0
  304. package/dist/stores/doctorStore.svelte.js +244 -0
  305. package/dist/stores/editedNodesStore.svelte.d.ts +42 -0
  306. package/dist/stores/editedNodesStore.svelte.js +84 -0
  307. package/dist/stores/editorModeStore.svelte.d.ts +34 -0
  308. package/dist/stores/editorModeStore.svelte.js +55 -0
  309. package/dist/stores/instanceContainer.svelte.d.ts +53 -0
  310. package/dist/stores/instanceContainer.svelte.js +38 -1
  311. package/dist/stores/loopbackLanesStore.svelte.d.ts +18 -0
  312. package/dist/stores/loopbackLanesStore.svelte.js +25 -0
  313. package/dist/stores/nodeHighlightStore.svelte.d.ts +34 -0
  314. package/dist/stores/nodeHighlightStore.svelte.js +56 -0
  315. package/dist/stores/playgroundStore.svelte.d.ts +66 -2
  316. package/dist/stores/playgroundStore.svelte.js +164 -2
  317. package/dist/stores/runController.svelte.d.ts +382 -0
  318. package/dist/stores/runController.svelte.js +1217 -0
  319. package/dist/stores/settingsStore.svelte.d.ts +80 -18
  320. package/dist/stores/settingsStore.svelte.js +180 -62
  321. package/dist/stores/workflowStore.svelte.d.ts +14 -0
  322. package/dist/stores/workflowStore.svelte.js +22 -1
  323. package/dist/styles/base.css +286 -25
  324. package/dist/styles/fonts/Inter-LICENSE.txt +93 -0
  325. package/dist/styles/fonts/inter-latin-wght-normal.woff2 +0 -0
  326. package/dist/styles/fonts/inter.css +19 -0
  327. package/dist/styles/toast.css +100 -20
  328. package/dist/styles/tokenAliases.js +118 -1
  329. package/dist/styles/tokens.css +586 -14
  330. package/dist/svelte-app.d.ts +47 -5
  331. package/dist/svelte-app.js +15 -3
  332. package/dist/themes/graphite.d.ts +2 -0
  333. package/dist/themes/graphite.js +15 -0
  334. package/dist/themes/index.d.ts +2 -1
  335. package/dist/themes/index.js +22 -3
  336. package/dist/themes/minimal.js +10 -0
  337. package/dist/themes/scopedSkinCss.d.ts +22 -5
  338. package/dist/themes/scopedSkinCss.js +136 -11
  339. package/dist/types/chat.d.ts +6 -0
  340. package/dist/types/doctor.d.ts +82 -0
  341. package/dist/types/doctor.js +11 -0
  342. package/dist/types/events.d.ts +35 -0
  343. package/dist/types/events.js +4 -1
  344. package/dist/types/index.d.ts +17 -2
  345. package/dist/types/navbar.d.ts +36 -0
  346. package/dist/types/playground.d.ts +75 -0
  347. package/dist/types/settings.d.ts +120 -7
  348. package/dist/types/settings.js +35 -3
  349. package/dist/types/skin.d.ts +21 -8
  350. package/dist/types/theme.d.ts +40 -2
  351. package/dist/utils/appearance.d.ts +19 -0
  352. package/dist/utils/appearance.js +13 -0
  353. package/dist/utils/canvasFit.d.ts +41 -0
  354. package/dist/utils/canvasFit.js +44 -0
  355. package/dist/utils/chipTitles.d.ts +9 -0
  356. package/dist/utils/chipTitles.js +19 -0
  357. package/dist/utils/connections.js +8 -0
  358. package/dist/utils/consoleHighlight.d.ts +28 -0
  359. package/dist/utils/consoleHighlight.js +269 -0
  360. package/dist/utils/deprecation.d.ts +17 -0
  361. package/dist/utils/deprecation.js +29 -0
  362. package/dist/utils/doctorOperations.d.ts +40 -0
  363. package/dist/utils/doctorOperations.js +237 -0
  364. package/dist/utils/duration.d.ts +13 -0
  365. package/dist/utils/duration.js +40 -0
  366. package/dist/utils/inspectorContext.d.ts +19 -0
  367. package/dist/utils/inspectorContext.js +12 -0
  368. package/dist/utils/inspectorSections.d.ts +20 -0
  369. package/dist/utils/inspectorSections.js +44 -0
  370. package/dist/utils/inspectorSurface.d.ts +46 -0
  371. package/dist/utils/inspectorSurface.js +51 -0
  372. package/dist/utils/interfaceTags.d.ts +102 -0
  373. package/dist/utils/interfaceTags.js +211 -0
  374. package/dist/utils/itemRef.d.ts +86 -0
  375. package/dist/utils/itemRef.js +106 -0
  376. package/dist/utils/lastRun.d.ts +35 -0
  377. package/dist/utils/lastRun.js +73 -0
  378. package/dist/utils/messageNodeLink.d.ts +17 -0
  379. package/dist/utils/messageNodeLink.js +16 -0
  380. package/dist/utils/minimapVisibility.d.ts +28 -0
  381. package/dist/utils/minimapVisibility.js +34 -0
  382. package/dist/utils/nodeAriaLabel.d.ts +12 -0
  383. package/dist/utils/nodeAriaLabel.js +17 -0
  384. package/dist/utils/nodeFingerprint.d.ts +27 -0
  385. package/dist/utils/nodeFingerprint.js +66 -0
  386. package/dist/utils/nodeFormSchema.d.ts +10 -0
  387. package/dist/utils/nodeFormSchema.js +2 -2
  388. package/dist/utils/nodeGeometry.d.ts +168 -0
  389. package/dist/utils/nodeGeometry.js +204 -0
  390. package/dist/utils/nodeProblem.d.ts +19 -0
  391. package/dist/utils/nodeProblem.js +9 -0
  392. package/dist/utils/nodeStatus.d.ts +38 -3
  393. package/dist/utils/nodeStatus.js +67 -39
  394. package/dist/utils/nodeSwap.js +9 -1
  395. package/dist/utils/nodeWrapper.d.ts +1 -0
  396. package/dist/utils/playgroundHistory.d.ts +48 -0
  397. package/dist/utils/playgroundHistory.js +38 -0
  398. package/dist/utils/playgroundInputRuns.d.ts +26 -0
  399. package/dist/utils/playgroundInputRuns.js +50 -0
  400. package/dist/utils/portExposure.d.ts +49 -0
  401. package/dist/utils/portExposure.js +122 -0
  402. package/dist/utils/portUtils.d.ts +16 -0
  403. package/dist/utils/portUtils.js +37 -0
  404. package/dist/utils/portal.d.ts +0 -19
  405. package/dist/utils/portal.js +8 -1
  406. package/dist/utils/reservedPorts.d.ts +59 -0
  407. package/dist/utils/reservedPorts.js +60 -0
  408. package/dist/utils/runEdges.d.ts +24 -0
  409. package/dist/utils/runEdges.js +35 -0
  410. package/dist/utils/runsList.d.ts +69 -0
  411. package/dist/utils/runsList.js +134 -0
  412. package/dist/utils/selectOptions.d.ts +62 -0
  413. package/dist/utils/selectOptions.js +137 -0
  414. package/dist/utils/sessionRuns.d.ts +62 -0
  415. package/dist/utils/sessionRuns.js +123 -0
  416. package/dist/utils/sheetWidths.d.ts +29 -0
  417. package/dist/utils/sheetWidths.js +41 -0
  418. package/dist/utils/sidebarWidths.d.ts +34 -0
  419. package/dist/utils/sidebarWidths.js +47 -0
  420. package/dist/utils/straightWires.d.ts +73 -0
  421. package/dist/utils/straightWires.js +99 -0
  422. package/dist/utils/themeScope.svelte.d.ts +10 -0
  423. package/dist/utils/themeScope.svelte.js +80 -0
  424. package/dist/utils/wiredHandles.d.ts +10 -0
  425. package/dist/utils/wiredHandles.js +14 -0
  426. package/dist/utils/workflowDraft.d.ts +9 -0
  427. package/dist/utils/workflowDraft.js +39 -0
  428. package/dist/utils/workflowInterface.d.ts +40 -7
  429. package/dist/utils/workflowInterface.js +66 -16
  430. package/dist/utils/zoomTier.d.ts +43 -0
  431. package/dist/utils/zoomTier.js +107 -0
  432. package/dist/utils/zoomTierRows.d.ts +41 -0
  433. package/dist/utils/zoomTierRows.js +103 -0
  434. package/dist/webmcp/WebMCPConfirm.svelte +1 -1
  435. package/dist/webmcp/bridge.d.ts +5 -0
  436. package/dist/webmcp/bridge.js +8 -0
  437. package/dist/webmcp/bridgeController.svelte.d.ts +84 -0
  438. package/dist/webmcp/bridgeController.svelte.js +224 -0
  439. package/dist/webmcp/descriptors.d.ts +1 -1
  440. package/dist/webmcp/descriptors.js +66 -5
  441. package/dist/webmcp/fakeWidget.d.ts +34 -0
  442. package/dist/webmcp/fakeWidget.js +75 -0
  443. package/dist/webmcp/gate.js +4 -0
  444. package/dist/webmcp/index.d.ts +2 -0
  445. package/dist/webmcp/index.js +1 -0
  446. package/dist/webmcp/runtime.js +4 -1
  447. package/dist/webmcp/types.d.ts +2 -0
  448. package/dist/webmcp/validate.js +5 -1
  449. package/package.json +8 -2
  450. package/dist/components/Select.svelte +0 -53
  451. package/dist/components/Select.svelte.d.ts +0 -15
  452. package/dist/components/icons/CommandLineIcon.svelte +0 -15
  453. package/dist/components/icons/CommandLineIcon.svelte.d.ts +0 -26
  454. package/dist/components/toast/WarningIcon.svelte +0 -28
  455. package/dist/components/toast/WarningIcon.svelte.d.ts +0 -26
@@ -186,6 +186,31 @@ export declare function describeInterfaceEntryStatus(resolved: ResolvedInterface
186
186
  * port names is the failure mode DN1 exists to prevent.
187
187
  */
188
188
  export declare function pullEntryFieldsFromPort(port: NodePort): Partial<WorkflowInterfaceEntry>;
189
+ /**
190
+ * Whether a port is intra-graph control flow — the reserved `trigger`
191
+ * dataType, the loopback input, or a `tool` *output* — and therefore never
192
+ * publishable in a workflow's interface.
193
+ *
194
+ * A `tool` **input** is deliberately not control flow here. Tools are a typed
195
+ * argument of a workflow's execution (fddo DF9): exposing a consumer's `tool`
196
+ * input (a ToolBox's `tools`, an LLM node's `tools`) in the interface is how a
197
+ * parent hands its tools to a sub-workflow, so the picker must offer it. A
198
+ * `tool` output is the inverse — a workflow *producing* a tool — which is not
199
+ * a composition the runtime supports through the interface (a workflow is
200
+ * made a tool by a different mechanism), so it stays excluded.
201
+ */
202
+ export declare function isControlFlowPort(port: NodePort, direction: 'input' | 'output'): boolean;
203
+ /**
204
+ * The name a node shows on the canvas: the instance title the author gave it
205
+ * ("Final Chat Output"), else the node type's label, else its id.
206
+ */
207
+ export declare function nodeCanvasLabel(node: {
208
+ id: string;
209
+ data?: {
210
+ label?: string;
211
+ config?: Record<string, unknown>;
212
+ };
213
+ }): string;
189
214
  /** One inner port a `WorkflowInterfaceEntry` could bind to, plus its owning node. */
190
215
  export interface BindablePort {
191
216
  nodeId: string;
@@ -381,22 +406,30 @@ export declare function interfaceFormSchema(entries: readonly WorkflowInterfaceE
381
406
  /**
382
407
  * The inputs a form turn sends: the values of the given entries, without
383
408
  * blank optional values (an empty string or `undefined` is "not given", so
384
- * the server's default applies). Keys outside the entries are dropped.
409
+ * the server's default applies). Keys outside the entries are dropped. An
410
+ * array or object entry typed as JSON text is sent parsed; text that is not
411
+ * JSON of that shape is left out (see {@link collectInterfaceInputs}).
385
412
  */
386
413
  export declare function interfaceFormInputs(entries: readonly WorkflowInterfaceEntry[], values: Record<string, unknown>): Record<string, unknown>;
387
- /** What {@link collectInterfaceInputs} found. */
414
+ /**
415
+ * What {@link collectInterfaceInputs} found. On failure, `missing` lists the
416
+ * blank required entries and `invalid` the array or object entries whose
417
+ * text is not JSON of their shape; either may be empty, not both.
418
+ */
388
419
  export type InterfaceInputsResult = {
389
420
  ok: true;
390
421
  inputs: Record<string, unknown>;
391
422
  } | {
392
423
  ok: false;
393
424
  missing: WorkflowInterfaceEntry[];
425
+ invalid: WorkflowInterfaceEntry[];
394
426
  };
395
427
  /**
396
- * The inputs a form turn would send, or the required entries that are still
397
- * blank. An entry is missing when it is required, has no default for the
398
- * server to fall back on, and has no value (see {@link interfaceFormInputs}
399
- * for what counts as blank). Missing inputs are data, not an exception, so
400
- * a Run control can open the form instead of failing.
428
+ * The inputs a form turn would send, or the entries that stop it. An entry is
429
+ * missing when it is required, has no default for the server to fall back on,
430
+ * and has no value (see {@link interfaceFormInputs} for what counts as
431
+ * blank); it is invalid when it is an array or object entry holding text that
432
+ * does not parse to that shape. Both are data, not an exception, so a Run
433
+ * control can point at the field instead of failing.
401
434
  */
402
435
  export declare function collectInterfaceInputs(entries: readonly WorkflowInterfaceEntry[], values: Record<string, unknown>): InterfaceInputsResult;
@@ -12,6 +12,7 @@
12
12
  *
13
13
  * @module utils/workflowInterface
14
14
  */
15
+ import { isTriggerEventInput } from './reservedPorts.js';
15
16
  import { dynamicPortToNodePort, WORKFLOW_INTERFACE_INPUT_TURNS, WORKFLOW_INTERFACE_OUTPUT_TURNS } from '../types/index.js';
16
17
  import { isPortExposed } from './portUtils.js';
17
18
  import { LOOPBACK_PORT_NAME } from './connections.js';
@@ -398,11 +399,19 @@ export function pullEntryFieldsFromPort(port) {
398
399
  * a composition the runtime supports through the interface (a workflow is
399
400
  * made a tool by a different mechanism), so it stays excluded.
400
401
  */
401
- function isControlFlowPort(port, direction) {
402
+ export function isControlFlowPort(port, direction) {
402
403
  if (port.dataType === 'trigger' || port.id === LOOPBACK_PORT_NAME)
403
404
  return true;
404
405
  return port.dataType === 'tool' && direction === 'output';
405
406
  }
407
+ /**
408
+ * The name a node shows on the canvas: the instance title the author gave it
409
+ * ("Final Chat Output"), else the node type's label, else its id.
410
+ */
411
+ export function nodeCanvasLabel(node) {
412
+ const title = node.data?.config?.instanceTitle;
413
+ return (typeof title === 'string' && title) || node.data?.label || node.id;
414
+ }
406
415
  /**
407
416
  * Every canvas-exposed port of a workflow, for one direction — the candidate
408
417
  * set a binding picker offers (design decision 3: external ⊂ internal, so an
@@ -432,8 +441,11 @@ export function listBindablePorts(workflow, direction) {
432
441
  for (const port of [...staticPorts, ...dynamicPorts]) {
433
442
  if (isControlFlowPort(port, direction))
434
443
  continue;
444
+ // A trigger's event input is never part of the contract (MAN-27).
445
+ if (direction === 'input' && isTriggerEventInput(node, port.id))
446
+ continue;
435
447
  if (isPortExposed(port, entries)) {
436
- result.push({ nodeId: node.id, nodeLabel: node.data?.label ?? node.id, port });
448
+ result.push({ nodeId: node.id, nodeLabel: nodeCanvasLabel(node), port });
437
449
  }
438
450
  }
439
451
  }
@@ -736,7 +748,7 @@ function nodeOutputPortIds(node) {
736
748
  export function findReplyPort(workflow, reply) {
737
749
  const node = workflow.nodes.find((candidate) => candidate.id === reply.node_id);
738
750
  const port = node && nodeOutputPorts(node)?.find((candidate) => candidate.id === reply.port);
739
- return node && port ? { nodeLabel: node.data?.label ?? node.id, port } : null;
751
+ return node && port ? { nodeLabel: nodeCanvasLabel(node), port } : null;
740
752
  }
741
753
  /** JSON Schema `type` for an interface entry's lane, when its schema states none. */
742
754
  function formFieldType(dataType) {
@@ -761,6 +773,33 @@ const FORM_FIELD_TYPES = [
761
773
  'object',
762
774
  'integer'
763
775
  ];
776
+ /** The field type an entry renders as: its schema's own type, else its lane's. */
777
+ function formEntryType(entry) {
778
+ const fragmentType = entry.schema?.type;
779
+ return typeof fragmentType === 'string' && FORM_FIELD_TYPES.includes(fragmentType)
780
+ ? fragmentType
781
+ : formFieldType(entry.dataType);
782
+ }
783
+ /**
784
+ * An array or object entry's value as the server wants it. A form may hold
785
+ * one as typed text (`[2, 3]`, a field with no item schema renders as a text
786
+ * box): text that parses to the entry's shape is sent parsed. `undefined`
787
+ * when it does not parse to that shape; any other value is sent as is.
788
+ */
789
+ function structuredFormValue(entry, value) {
790
+ const type = formEntryType(entry);
791
+ if ((type !== 'array' && type !== 'object') || typeof value !== 'string')
792
+ return value;
793
+ try {
794
+ const parsed = JSON.parse(value);
795
+ const isArray = Array.isArray(parsed);
796
+ const fits = type === 'array' ? isArray : parsed !== null && typeof parsed === 'object' && !isArray;
797
+ return fits ? parsed : undefined;
798
+ }
799
+ catch {
800
+ return undefined;
801
+ }
802
+ }
764
803
  /**
765
804
  * The object schema a form renders for the given entries: one property per
766
805
  * entry, keyed by its `id` (the name the server matches inputs on). The
@@ -772,10 +811,7 @@ export function interfaceFormSchema(entries) {
772
811
  const required = [];
773
812
  for (const entry of entries) {
774
813
  const fragment = (entry.schema ?? {});
775
- const fragmentType = typeof fragment.type === 'string' ? fragment.type : undefined;
776
- const type = fragmentType && FORM_FIELD_TYPES.includes(fragmentType)
777
- ? fragmentType
778
- : formFieldType(entry.dataType);
814
+ const type = formEntryType(entry);
779
815
  const property = { ...fragment, type, title: entry.name ?? entry.id };
780
816
  if (entry.description !== undefined)
781
817
  property.description = entry.description;
@@ -792,7 +828,9 @@ export function interfaceFormSchema(entries) {
792
828
  /**
793
829
  * The inputs a form turn sends: the values of the given entries, without
794
830
  * blank optional values (an empty string or `undefined` is "not given", so
795
- * the server's default applies). Keys outside the entries are dropped.
831
+ * the server's default applies). Keys outside the entries are dropped. An
832
+ * array or object entry typed as JSON text is sent parsed; text that is not
833
+ * JSON of that shape is left out (see {@link collectInterfaceInputs}).
796
834
  */
797
835
  export function interfaceFormInputs(entries, values) {
798
836
  const inputs = {};
@@ -800,19 +838,31 @@ export function interfaceFormInputs(entries, values) {
800
838
  const value = values[entry.id];
801
839
  if (value === undefined || value === '')
802
840
  continue;
803
- inputs[entry.id] = value;
841
+ const sent = structuredFormValue(entry, value);
842
+ if (sent !== undefined)
843
+ inputs[entry.id] = sent;
804
844
  }
805
845
  return inputs;
806
846
  }
807
847
  /**
808
- * The inputs a form turn would send, or the required entries that are still
809
- * blank. An entry is missing when it is required, has no default for the
810
- * server to fall back on, and has no value (see {@link interfaceFormInputs}
811
- * for what counts as blank). Missing inputs are data, not an exception, so
812
- * a Run control can open the form instead of failing.
848
+ * The inputs a form turn would send, or the entries that stop it. An entry is
849
+ * missing when it is required, has no default for the server to fall back on,
850
+ * and has no value (see {@link interfaceFormInputs} for what counts as
851
+ * blank); it is invalid when it is an array or object entry holding text that
852
+ * does not parse to that shape. Both are data, not an exception, so a Run
853
+ * control can point at the field instead of failing.
813
854
  */
814
855
  export function collectInterfaceInputs(entries, values) {
815
856
  const inputs = interfaceFormInputs(entries, values);
816
- const missing = entries.filter((entry) => entry.required && entry.defaultValue === undefined && !(entry.id in inputs));
817
- return missing.length > 0 ? { ok: false, missing } : { ok: true, inputs };
857
+ const invalid = entries.filter((entry) => {
858
+ const value = values[entry.id];
859
+ return value !== undefined && value !== '' && structuredFormValue(entry, value) === undefined;
860
+ });
861
+ const missing = entries.filter((entry) => entry.required &&
862
+ entry.defaultValue === undefined &&
863
+ !(entry.id in inputs) &&
864
+ !invalid.includes(entry));
865
+ return missing.length > 0 || invalid.length > 0
866
+ ? { ok: false, missing, invalid }
867
+ : { ok: true, inputs };
818
868
  }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Zoom tiers.
3
+ *
4
+ * The canvas shows a node at up to four levels of detail, chosen from the
5
+ * viewport zoom: `full` (the whole card), `outline` (header and unlabelled port
6
+ * bars), `glyph` (a category tile and a title) and `map` (the tile alone). Which
7
+ * tiers are on, and where each starts, is the `editor.zoomTiers` setting. The
8
+ * tier is published as `data-fd-zoom` on `.flowdrop-root`, so every node
9
+ * restyles itself in CSS and nothing re-renders. Geometry never depends on the
10
+ * tier: parts are hidden with `visibility`/`display`, never resized or moved.
11
+ */
12
+ export type ZoomTierName = 'full' | 'outline' | 'glyph' | 'map';
13
+ /** Alias kept for callers that name the tier a zoom resolves to. */
14
+ export type ZoomTier = ZoomTierName;
15
+ /** For each tier that is on, the zoom at which it starts. A tier left out is off. */
16
+ export type ZoomTierConfig = Partial<Record<ZoomTierName, number>>;
17
+ /** Highest to lowest. */
18
+ export declare const ZOOM_TIER_ORDER: readonly ZoomTierName[];
19
+ /** The library default: all four tiers. */
20
+ export declare const DEFAULT_ZOOM_TIERS: Readonly<ZoomTierConfig>;
21
+ /**
22
+ * Hysteresis: a tier boundary is crossed only once the zoom is this far past
23
+ * it (in zoom units, so 0.025 is 2.5 points of the percentage on each side of a
24
+ * threshold, a 5% dead band), so a zoom that rests on a threshold does not
25
+ * flicker between tiers.
26
+ */
27
+ export declare const ZOOM_HYSTERESIS = 0.025;
28
+ /** Why a config is invalid, or `null` when it is valid. */
29
+ export declare function zoomTiersProblem(config: unknown): string | null;
30
+ /**
31
+ * A valid config: the one given, or the library default (with one console
32
+ * warning per page) when it is not valid. Never throws.
33
+ */
34
+ export declare function normalizeZoomTiers(config: unknown): ZoomTierConfig;
35
+ /** Test hook: let the next invalid config warn again. */
36
+ export declare function resetZoomTiersWarning(): void;
37
+ /**
38
+ * The tier for a zoom. Without `previous` the thresholds are exact; with it, a
39
+ * boundary is crossed only past the hysteresis band. A tier shows from its own
40
+ * value up to the next higher tier that is on; the lowest tier that is on
41
+ * extends down to any zoom.
42
+ */
43
+ export declare function zoomTier(zoom: number, previous?: ZoomTierName, config?: ZoomTierConfig): ZoomTierName;
@@ -0,0 +1,107 @@
1
+ /**
2
+ * Zoom tiers.
3
+ *
4
+ * The canvas shows a node at up to four levels of detail, chosen from the
5
+ * viewport zoom: `full` (the whole card), `outline` (header and unlabelled port
6
+ * bars), `glyph` (a category tile and a title) and `map` (the tile alone). Which
7
+ * tiers are on, and where each starts, is the `editor.zoomTiers` setting. The
8
+ * tier is published as `data-fd-zoom` on `.flowdrop-root`, so every node
9
+ * restyles itself in CSS and nothing re-renders. Geometry never depends on the
10
+ * tier: parts are hidden with `visibility`/`display`, never resized or moved.
11
+ */
12
+ /** Highest to lowest. */
13
+ export const ZOOM_TIER_ORDER = ['full', 'outline', 'glyph', 'map'];
14
+ /** The library default: all four tiers. */
15
+ export const DEFAULT_ZOOM_TIERS = Object.freeze({
16
+ full: 0.75,
17
+ outline: 0.45,
18
+ glyph: 0.25,
19
+ map: 0
20
+ });
21
+ /**
22
+ * Hysteresis: a tier boundary is crossed only once the zoom is this far past
23
+ * it (in zoom units, so 0.025 is 2.5 points of the percentage on each side of a
24
+ * threshold, a 5% dead band), so a zoom that rests on a threshold does not
25
+ * flicker between tiers.
26
+ */
27
+ export const ZOOM_HYSTERESIS = 0.025;
28
+ /** The largest value a tier may start at (the editor's maximum zoom). */
29
+ const ZOOM_MAX = 4;
30
+ /** The tiers that are on, highest first, with their start zoom. Assumes a valid config. */
31
+ function active(config) {
32
+ const out = [];
33
+ for (const name of ZOOM_TIER_ORDER) {
34
+ const v = config[name];
35
+ if (typeof v === 'number')
36
+ out.push([name, v]);
37
+ }
38
+ return out;
39
+ }
40
+ /** Why a config is invalid, or `null` when it is valid. */
41
+ export function zoomTiersProblem(config) {
42
+ if (config === null || typeof config !== 'object' || Array.isArray(config)) {
43
+ return 'not an object';
44
+ }
45
+ const c = config;
46
+ for (const key of Object.keys(c)) {
47
+ if (!ZOOM_TIER_ORDER.includes(key))
48
+ return `unknown tier "${key}"`;
49
+ }
50
+ if (c.full === undefined)
51
+ return '"full" is required';
52
+ let last = Infinity;
53
+ for (const name of ZOOM_TIER_ORDER) {
54
+ const v = c[name];
55
+ if (v === undefined)
56
+ continue;
57
+ if (typeof v !== 'number' || !Number.isFinite(v) || v < 0 || v > ZOOM_MAX) {
58
+ return `"${name}" must be a number from 0 to ${ZOOM_MAX}`;
59
+ }
60
+ if (v >= last)
61
+ return `"${name}" must start below the tier above it`;
62
+ last = v;
63
+ }
64
+ return null;
65
+ }
66
+ let warned = false;
67
+ /**
68
+ * A valid config: the one given, or the library default (with one console
69
+ * warning per page) when it is not valid. Never throws.
70
+ */
71
+ export function normalizeZoomTiers(config) {
72
+ if (config === undefined)
73
+ return { ...DEFAULT_ZOOM_TIERS };
74
+ const problem = zoomTiersProblem(config);
75
+ if (problem === null)
76
+ return { ...config };
77
+ if (!warned) {
78
+ warned = true;
79
+ // eslint-disable-next-line no-console
80
+ console.warn(`[flowdrop] editor.zoomTiers is invalid (${problem}); using the default.`);
81
+ }
82
+ return { ...DEFAULT_ZOOM_TIERS };
83
+ }
84
+ /** Test hook: let the next invalid config warn again. */
85
+ export function resetZoomTiersWarning() {
86
+ warned = false;
87
+ }
88
+ /**
89
+ * The tier for a zoom. Without `previous` the thresholds are exact; with it, a
90
+ * boundary is crossed only past the hysteresis band. A tier shows from its own
91
+ * value up to the next higher tier that is on; the lowest tier that is on
92
+ * extends down to any zoom.
93
+ */
94
+ export function zoomTier(zoom, previous, config = DEFAULT_ZOOM_TIERS) {
95
+ const tiers = active(normalizeZoomTiers(config));
96
+ const prevIndex = previous ? tiers.findIndex(([n]) => n === previous) : -1;
97
+ // Walk down: tier i holds while the zoom is at or above its start. The
98
+ // boundary below tier i is the start of tier i, shifted by the band toward
99
+ // wherever the zoom came from.
100
+ for (let i = 0; i < tiers.length - 1; i++) {
101
+ const start = tiers[i][1];
102
+ const h = prevIndex === -1 ? 0 : prevIndex <= i ? -ZOOM_HYSTERESIS : ZOOM_HYSTERESIS;
103
+ if (zoom >= start + h)
104
+ return tiers[i][0];
105
+ }
106
+ return tiers[tiers.length - 1][0];
107
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * The settings panel's view of `editor.zoomTiers`: one row per tier below full,
3
+ * each with an on/off switch and a "starts below N%" value.
4
+ *
5
+ * A row's "starts below" is where its tier begins as the canvas zooms out, which
6
+ * is the stored start of the tier above it (the first row's value is the stored
7
+ * `full`). The lowest tier that is on is stored with 0: it extends down to any
8
+ * zoom. Options are limited by the neighbouring rows that are on, so a
9
+ * combination that is not strictly decreasing cannot be picked.
10
+ */
11
+ import { type ZoomTierConfig, type ZoomTierName } from './zoomTier.js';
12
+ /** The tiers that have a row. Full has none. */
13
+ export type ZoomRowTier = Exclude<ZoomTierName, 'full'>;
14
+ export declare const ZOOM_ROW_TIERS: readonly ZoomRowTier[];
15
+ /** The lowest and highest percentage a row offers, and the step. */
16
+ export declare const ZOOM_BELOW_MIN = 20;
17
+ export declare const ZOOM_BELOW_MAX = 90;
18
+ export declare const ZOOM_BELOW_STEP = 5;
19
+ export interface ZoomRow {
20
+ tier: ZoomRowTier;
21
+ on: boolean;
22
+ /** Percent: the zoom below which this tier starts. Kept while the row is off. */
23
+ below: number;
24
+ }
25
+ /**
26
+ * The rows for a config. `remembered` supplies the percentage of a row that is
27
+ * off (so switching it back on restores what the user had).
28
+ */
29
+ export declare function zoomRows(config: unknown, remembered?: Partial<Record<ZoomRowTier, number>>): ZoomRow[];
30
+ /** The config for rows. No row on is `{ full: 0 }`. */
31
+ export declare function zoomConfigFromRows(rows: readonly ZoomRow[]): ZoomTierConfig;
32
+ /** The percentages a row may take: the grid between its neighbours, plus its own value. */
33
+ export declare function zoomBelowOptions(rows: readonly ZoomRow[], tier: ZoomRowTier): number[];
34
+ /**
35
+ * The percentage for a row being switched on: what it had if that still fits
36
+ * between its neighbours, otherwise the grid value nearest the middle of the
37
+ * gap. `null` when there is no room (the neighbours leave no step between them).
38
+ */
39
+ export declare function zoomBelowForEnable(rows: readonly ZoomRow[], tier: ZoomRowTier): number | null;
40
+ /** The library default's rows (for tests and the panel's reset path). */
41
+ export declare const DEFAULT_ZOOM_ROWS: readonly ZoomRow[];
@@ -0,0 +1,103 @@
1
+ /**
2
+ * The settings panel's view of `editor.zoomTiers`: one row per tier below full,
3
+ * each with an on/off switch and a "starts below N%" value.
4
+ *
5
+ * A row's "starts below" is where its tier begins as the canvas zooms out, which
6
+ * is the stored start of the tier above it (the first row's value is the stored
7
+ * `full`). The lowest tier that is on is stored with 0: it extends down to any
8
+ * zoom. Options are limited by the neighbouring rows that are on, so a
9
+ * combination that is not strictly decreasing cannot be picked.
10
+ */
11
+ import { ZOOM_TIER_ORDER, DEFAULT_ZOOM_TIERS, normalizeZoomTiers } from './zoomTier.js';
12
+ export const ZOOM_ROW_TIERS = ['outline', 'glyph', 'map'];
13
+ /** The lowest and highest percentage a row offers, and the step. */
14
+ export const ZOOM_BELOW_MIN = 20;
15
+ export const ZOOM_BELOW_MAX = 90;
16
+ export const ZOOM_BELOW_STEP = 5;
17
+ /** The percentage a row starts at when it has never been on. */
18
+ const DEFAULT_BELOW = {
19
+ outline: 75,
20
+ glyph: 45,
21
+ map: 25
22
+ };
23
+ const pct = (zoom) => Math.round(zoom * 100);
24
+ /**
25
+ * The rows for a config. `remembered` supplies the percentage of a row that is
26
+ * off (so switching it back on restores what the user had).
27
+ */
28
+ export function zoomRows(config, remembered = {}) {
29
+ const valid = normalizeZoomTiers(config);
30
+ const on = ZOOM_TIER_ORDER.filter((t) => typeof valid[t] === 'number');
31
+ return ZOOM_ROW_TIERS.map((tier) => {
32
+ const i = on.indexOf(tier);
33
+ if (i > 0)
34
+ return { tier, on: true, below: pct(valid[on[i - 1]]) };
35
+ return { tier, on: false, below: remembered[tier] ?? DEFAULT_BELOW[tier] };
36
+ });
37
+ }
38
+ /** The config for rows. No row on is `{ full: 0 }`. */
39
+ export function zoomConfigFromRows(rows) {
40
+ const on = ZOOM_ROW_TIERS.map((t) => rows.find((r) => r.tier === t)).filter((r) => !!r && r.on);
41
+ if (on.length === 0)
42
+ return { full: 0 };
43
+ const config = { full: on[0].below / 100 };
44
+ on.forEach((row, i) => {
45
+ config[row.tier] = i + 1 < on.length ? on[i + 1].below / 100 : 0;
46
+ });
47
+ return config;
48
+ }
49
+ /** The nearest row above (higher rank) and below that is on, as percentages. */
50
+ function neighbours(rows, tier) {
51
+ const at = ZOOM_ROW_TIERS.indexOf(tier);
52
+ let above = Infinity;
53
+ let below = -Infinity;
54
+ for (const r of rows) {
55
+ if (!r.on || r.tier === tier)
56
+ continue;
57
+ const i = ZOOM_ROW_TIERS.indexOf(r.tier);
58
+ if (i < at)
59
+ above = Math.min(above, r.below);
60
+ else
61
+ below = Math.max(below, r.below);
62
+ }
63
+ return { above, below };
64
+ }
65
+ /** The percentages a row may take: the grid between its neighbours, plus its own value. */
66
+ export function zoomBelowOptions(rows, tier) {
67
+ const row = rows.find((r) => r.tier === tier);
68
+ const { above, below } = neighbours(rows, tier);
69
+ const out = [];
70
+ for (let n = ZOOM_BELOW_MIN; n <= ZOOM_BELOW_MAX; n += ZOOM_BELOW_STEP) {
71
+ if (n > below && n < above)
72
+ out.push(n);
73
+ }
74
+ if (row?.on && !out.includes(row.below)) {
75
+ out.push(row.below);
76
+ out.sort((a, b) => b - a);
77
+ }
78
+ else {
79
+ out.sort((a, b) => b - a);
80
+ }
81
+ return out;
82
+ }
83
+ /**
84
+ * The percentage for a row being switched on: what it had if that still fits
85
+ * between its neighbours, otherwise the grid value nearest the middle of the
86
+ * gap. `null` when there is no room (the neighbours leave no step between them).
87
+ */
88
+ export function zoomBelowForEnable(rows, tier) {
89
+ const row = rows.find((r) => r.tier === tier);
90
+ const { above, below } = neighbours(rows, tier);
91
+ const fits = (n) => n > below && n < above;
92
+ const grid = [];
93
+ for (let n = ZOOM_BELOW_MIN; n <= ZOOM_BELOW_MAX; n += ZOOM_BELOW_STEP)
94
+ if (fits(n))
95
+ grid.push(n);
96
+ if (grid.length === 0)
97
+ return null;
98
+ if (row && fits(row.below))
99
+ return row.below;
100
+ return grid[Math.floor((grid.length - 1) / 2)];
101
+ }
102
+ /** The library default's rows (for tests and the panel's reset path). */
103
+ export const DEFAULT_ZOOM_ROWS = zoomRows(DEFAULT_ZOOM_TIERS);
@@ -124,7 +124,7 @@
124
124
  /* Mounted on document.body, outside the editor tree. Tokens come from :root
125
125
  (tokens.css) and, for a skinned editor, from the editor's scope, which the
126
126
  gate copies onto the host element; the dark palette follows
127
- [data-theme='dark'] on <html>; the buttons are .flowdrop-btn from
127
+ [data-theme='dark'] on the host element (gate.ts); the buttons are .flowdrop-btn from
128
128
  base.css. Everything else is set here, because the host page's own
129
129
  element rules (h2, p, ol, li, label) reach a dialog on <body>: every
130
130
  element below states its margin, padding, font and list style rather than
@@ -31,6 +31,11 @@
31
31
  * that expect slow approvals should say so in the dialog copy or use a custom
32
32
  * `approval` callback.
33
33
  *
34
+ * The widget's own floating UI is hidden once installed: the editor shows a
35
+ * connect button and popover of its own, driven by the controller in
36
+ * `./bridgeController.svelte.ts`. If the widget's private surface is not
37
+ * recognised (a vendored upgrade), the widget's UI stays visible instead.
38
+ *
34
39
  * Nothing here decides *who* may reach the page: the bridge is localhost-only
35
40
  * and token-gated by design, and the adapter's confirm dialog and the
36
41
  * server's permissions still gate every mutation. Hosts should still make the
@@ -31,6 +31,11 @@
31
31
  * that expect slow approvals should say so in the dialog copy or use a custom
32
32
  * `approval` callback.
33
33
  *
34
+ * The widget's own floating UI is hidden once installed: the editor shows a
35
+ * connect button and popover of its own, driven by the controller in
36
+ * `./bridgeController.svelte.ts`. If the widget's private surface is not
37
+ * recognised (a vendored upgrade), the widget's UI stays visible instead.
38
+ *
34
39
  * Nothing here decides *who* may reach the page: the bridge is localhost-only
35
40
  * and token-gated by design, and the adapter's confirm dialog and the
36
41
  * server's permissions still gate every mutation. Hosts should still make the
@@ -38,6 +43,7 @@
38
43
  *
39
44
  * @module webmcp/bridge
40
45
  */
46
+ import { createBridgeController, setBridgeController } from './bridgeController.svelte.js';
41
47
  function unavailable(name) {
42
48
  return {
43
49
  content: [
@@ -101,6 +107,8 @@ export function installBridgedModelContext(widget, target = typeof document ===
101
107
  if (nav?.modelContext)
102
108
  return nav.modelContext;
103
109
  const bridged = createBridgedModelContext(widget);
110
+ // The editor draws the bridge's UI itself (a button in the zoom controls) from this.
111
+ setBridgeController(createBridgeController(widget));
104
112
  Object.defineProperty(target, 'modelContext', { value: bridged, configurable: true });
105
113
  return bridged;
106
114
  }
@@ -0,0 +1,84 @@
1
+ /**
2
+ * WebMCP desktop bridge — a typed controller over the vendored widget.
3
+ *
4
+ * The bridge's page-side script (`@jason.today/webmcp`, vendored by the Drupal
5
+ * module, written against **0.1.13**) draws its own unstyled floating widget and
6
+ * keeps its connection state inside it. This controller lets the editor draw
7
+ * the bridge UI with its own components instead: it hides the widget's DOM and
8
+ * mirrors its state into a small reactive surface (`status`, `registeredTools`,
9
+ * `connect`, `disconnect`, `subscribe`).
10
+ *
11
+ * What it relies on in the widget (0.1.13):
12
+ * - public: `connect(token)`, `disconnect()`, `registerTool(...)`,
13
+ * `isConnected`, `availableTools` (a `Map`), `elementId`;
14
+ * - private, hooked on the *instance* (never the prototype): `_updateStatus(status,
15
+ * message)` and `_updateConnectionUI(isConnected)`.
16
+ *
17
+ * The private methods are feature-detected. When any is missing (an upgrade
18
+ * renamed them) the controller is **unmanaged**: the widget's own UI stays
19
+ * visible, nothing is wrapped, a warning is logged once, and the editor draws
20
+ * no bridge button — connecting keeps working through the widget.
21
+ *
22
+ * @module webmcp/bridgeController
23
+ */
24
+ /** Where the bridge connection stands. */
25
+ export type BridgeStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
26
+ /** A tool the editor offered through the bridge. */
27
+ export interface BridgeTool {
28
+ name: string;
29
+ description: string;
30
+ }
31
+ /** The immutable view `subscribe` listeners receive. */
32
+ export interface BridgeSnapshot {
33
+ status: BridgeStatus;
34
+ /** The widget's own words for the last status (shown for errors). */
35
+ detail: string;
36
+ tools: readonly BridgeTool[];
37
+ }
38
+ export interface WebMCPBridgeController {
39
+ /** Connection state. Reactive in a Svelte `$derived` / template. */
40
+ readonly status: BridgeStatus;
41
+ /** The widget's last status message; the reason when `status` is `error`. */
42
+ readonly detail: string;
43
+ /** Tools offered through the bridge. Reactive. */
44
+ readonly registeredTools: readonly BridgeTool[];
45
+ /** False when the widget's private surface was not recognised (its own UI is left visible). */
46
+ readonly managed: boolean;
47
+ /** Connect with a token pasted from the desktop bridge. */
48
+ connect(token: string): void;
49
+ /** Drop the connection and forget the token. */
50
+ disconnect(): void;
51
+ /** Call `listener` on every change of status or tools. Returns the unsubscribe function. */
52
+ subscribe(listener: (snapshot: BridgeSnapshot) => void): () => void;
53
+ /** Restore the widget's methods and its own UI. */
54
+ dispose(): void;
55
+ }
56
+ /**
57
+ * The widget surface the controller reads. Everything is optional: what is
58
+ * missing decides whether the controller can manage the widget.
59
+ */
60
+ export interface BridgeWidgetInternals {
61
+ connect?(token: string): unknown;
62
+ disconnect?(): unknown;
63
+ registerTool?(...args: unknown[]): unknown;
64
+ _updateStatus?(status: string, message?: string): unknown;
65
+ _updateConnectionUI?(isConnected: boolean): unknown;
66
+ isConnected?: boolean;
67
+ availableTools?: Map<string, {
68
+ name?: string;
69
+ description?: string;
70
+ }>;
71
+ elementId?: string;
72
+ SESSION_STORAGE_KEY?: string;
73
+ }
74
+ /** Test hook: forget that the unmanaged warning was already logged. */
75
+ export declare function resetBridgeWarning(): void;
76
+ /**
77
+ * Wrap a bridge widget in a controller. Hooks the instance's own methods, so
78
+ * other widgets and the prototype are untouched.
79
+ */
80
+ export declare function createBridgeController(widget: BridgeWidgetInternals): WebMCPBridgeController;
81
+ /** The controller of the bridge `installBridgedModelContext` installed, or null. */
82
+ export declare function getBridgeController(): WebMCPBridgeController | null;
83
+ /** Make `controller` the editor's bridge (null clears it). Replaces and disposes a previous one. */
84
+ export declare function setBridgeController(controller: WebMCPBridgeController | null): void;