@emuanalytics/flow-rdf-ui 4.2.1 → 4.3.1

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 (411) hide show
  1. package/README.md +58 -0
  2. package/THIRD_PARTY_NOTICES.md +220 -0
  3. package/dist/components/alert/alert.component.mjs +13 -10
  4. package/dist/components/animation/animation.component.mjs +3 -2
  5. package/dist/components/autocomplete/autocomplete.component.mjs +21 -20
  6. package/dist/components/avatar/avatar.component.mjs +10 -12
  7. package/dist/components/badge/badge.component.mjs +1 -0
  8. package/dist/components/base-control/base-control.component.mjs +3 -0
  9. package/dist/components/breadcrumb/breadcrumb.component.mjs +3 -0
  10. package/dist/components/breadcrumb-item/breadcrumb-item.component.mjs +15 -14
  11. package/dist/components/busy-overlay/busy-overlay.component.mjs +3 -0
  12. package/dist/components/button/button.component.mjs +7 -3
  13. package/dist/components/button/button.styles.mjs +5 -5
  14. package/dist/components/button-group/button-group.component.mjs +1 -0
  15. package/dist/components/calendar/calendar.component.mjs +29 -6
  16. package/dist/components/card/card.component.mjs +5 -4
  17. package/dist/components/carousel/carousel.component.mjs +45 -42
  18. package/dist/components/carousel-item/carousel-item.component.mjs +2 -0
  19. package/dist/components/chart/chart.component.mjs +5 -4
  20. package/dist/components/chart/chartjs-plugins/luxon.adapter.mjs +78 -0
  21. package/dist/components/chart/chartjs-plugins/plugin.flow-ui-colors.mjs +1 -1
  22. package/dist/components/chart/chartjs-support.mjs +2 -0
  23. package/dist/components/checkbox/checkbox.component.mjs +21 -18
  24. package/dist/components/checkbox-group/checkbox-group.component.mjs +3 -0
  25. package/dist/components/color-mapper/color-mapper.component.mjs +27 -6
  26. package/dist/components/color-picker/color-picker.component.mjs +79 -71
  27. package/dist/components/color-picker/color-picker.styles.mjs +4 -2
  28. package/dist/components/color-stop/color-stop.component.mjs +19 -2
  29. package/dist/components/date-time-picker/date-time-picker.component.mjs +35 -29
  30. package/dist/components/details/details.component.mjs +3 -0
  31. package/dist/components/diagram/diagram-panel.styles.mjs +44 -0
  32. package/dist/components/diagram/diagram-tokens.styles.mjs +148 -0
  33. package/dist/components/diagram/diagram.component.mjs +355 -0
  34. package/dist/components/diagram/diagram.mjs +5 -0
  35. package/dist/components/diagram/diagram.styles.mjs +95 -0
  36. package/dist/components/diagram-background/diagram-background.component.mjs +163 -0
  37. package/dist/components/diagram-background/diagram-background.mjs +5 -0
  38. package/dist/components/diagram-background/diagram-background.styles.mjs +58 -0
  39. package/dist/components/diagram-base-edge/diagram-base-edge.component.mjs +326 -0
  40. package/dist/components/diagram-base-edge/diagram-base-edge.mjs +5 -0
  41. package/dist/components/diagram-base-edge/diagram-base-edge.styles.mjs +147 -0
  42. package/dist/components/diagram-base-node/diagram-base-node.component.mjs +84 -0
  43. package/dist/components/diagram-base-node/diagram-base-node.mjs +5 -0
  44. package/dist/components/diagram-base-node/diagram-base-node.styles.mjs +37 -0
  45. package/dist/components/diagram-edge/diagram-edge.component.mjs +56 -0
  46. package/dist/components/diagram-edge/diagram-edge.mjs +5 -0
  47. package/dist/components/diagram-edge/diagram-edge.styles.mjs +37 -0
  48. package/dist/components/diagram-edge-label/diagram-edge-label.component.mjs +202 -0
  49. package/dist/components/diagram-edge-label/diagram-edge-label.mjs +5 -0
  50. package/dist/components/diagram-edge-label/diagram-edge-label.styles.mjs +54 -0
  51. package/dist/components/diagram-marker/diagram-marker.component.mjs +84 -0
  52. package/dist/components/diagram-marker/diagram-marker.mjs +5 -0
  53. package/dist/components/diagram-marker/diagram-marker.styles.mjs +9 -0
  54. package/dist/components/diagram-minimap/diagram-minimap.component.mjs +298 -0
  55. package/dist/components/diagram-minimap/diagram-minimap.mjs +5 -0
  56. package/dist/components/diagram-minimap/diagram-minimap.styles.mjs +83 -0
  57. package/dist/components/diagram-node/diagram-node-template.styles.mjs +36 -0
  58. package/dist/components/diagram-node/diagram-node.component.mjs +183 -0
  59. package/dist/components/diagram-node/diagram-node.mjs +6 -0
  60. package/dist/components/diagram-node/diagram-node.styles.mjs +29 -0
  61. package/dist/components/diagram-palette-item/diagram-palette-item.component.mjs +168 -0
  62. package/dist/components/diagram-palette-item/diagram-palette-item.mjs +5 -0
  63. package/dist/components/diagram-palette-item/diagram-palette-item.styles.mjs +20 -0
  64. package/dist/components/diagram-palette-item-preview/diagram-palette-item-preview.component.mjs +245 -0
  65. package/dist/components/diagram-palette-item-preview/diagram-palette-item-preview.mjs +6 -0
  66. package/dist/components/diagram-palette-item-preview/diagram-palette-item-preview.styles.mjs +41 -0
  67. package/dist/components/diagram-port/diagram-port.component.mjs +273 -0
  68. package/dist/components/diagram-port/diagram-port.mjs +5 -0
  69. package/dist/components/diagram-port/diagram-port.styles.mjs +116 -0
  70. package/dist/components/diagram-resize-adornment/diagram-resize-adornment.component.mjs +124 -0
  71. package/dist/components/diagram-resize-adornment/diagram-resize-adornment.mjs +5 -0
  72. package/dist/components/diagram-resize-adornment/diagram-resize-adornment.styles.mjs +136 -0
  73. package/dist/components/diagram-rotate-adornment/diagram-rotate-adornment.component.mjs +125 -0
  74. package/dist/components/diagram-rotate-adornment/diagram-rotate-adornment.mjs +5 -0
  75. package/dist/components/diagram-rotate-adornment/diagram-rotate-adornment.styles.mjs +65 -0
  76. package/dist/components/diagram-zoom-controls/diagram-zoom-controls.component.mjs +158 -0
  77. package/dist/components/diagram-zoom-controls/diagram-zoom-controls.mjs +5 -0
  78. package/dist/components/diagram-zoom-controls/diagram-zoom-controls.styles.mjs +68 -0
  79. package/dist/components/dialog/dialog.component.mjs +5 -1
  80. package/dist/components/divider/divider.component.mjs +1 -0
  81. package/dist/components/drawer/drawer.component.mjs +22 -19
  82. package/dist/components/dropdown/dropdown.component.mjs +2 -1
  83. package/dist/components/form-group/form-group.component.mjs +1 -0
  84. package/dist/components/gauge/gauge.component.mjs +10 -2
  85. package/dist/components/icon/icon.component.mjs +1 -0
  86. package/dist/components/icon/library.mjs +7 -4
  87. package/dist/components/icon/library.system.mjs +2 -0
  88. package/dist/components/icon-button/icon-button.component.mjs +5 -0
  89. package/dist/components/input/input.component.mjs +21 -11
  90. package/dist/components/list/list.component.mjs +1 -0
  91. package/dist/components/list-item/list-item.component.mjs +34 -17
  92. package/dist/components/map/map.component.mjs +3 -0
  93. package/dist/components/map/map.styles.mjs +10 -0
  94. package/dist/components/menu/menu.component.mjs +1 -0
  95. package/dist/components/menu-item/menu-item.component.mjs +3 -0
  96. package/dist/components/menu-label/menu-label.component.mjs +1 -0
  97. package/dist/components/mutation-observer/mutation-observer.component.mjs +5 -6
  98. package/dist/components/option/option.component.mjs +2 -1
  99. package/dist/components/panel/panel.component.mjs +85 -1
  100. package/dist/components/panel/panel.styles.mjs +29 -0
  101. package/dist/components/panel-header/panel-header.component.mjs +14 -8
  102. package/dist/components/popup/popup.component.mjs +12 -11
  103. package/dist/components/progress-bar/progress-bar.component.mjs +3 -2
  104. package/dist/components/progress-ring/progress-ring.component.mjs +1 -0
  105. package/dist/components/query-builder/converters/javascript-filter-converter.mjs +0 -4
  106. package/dist/components/query-builder/converters/map-layer-filter-converter.mjs +0 -4
  107. package/dist/components/query-builder/query-builder.component.mjs +42 -15
  108. package/dist/components/radio/radio.component.mjs +10 -7
  109. package/dist/components/radio-group/radio-group.component.mjs +4 -1
  110. package/dist/components/range/range.component.mjs +4 -0
  111. package/dist/components/resize-observer/resize-observer.component.mjs +2 -1
  112. package/dist/components/scroll-view/scroll-view.component.mjs +1 -0
  113. package/dist/components/scroll-view/scroll-view.styles.mjs +20 -7
  114. package/dist/components/select/select.component.mjs +19 -21
  115. package/dist/components/split-view/split-view-layout-registry.mjs +44 -0
  116. package/dist/components/split-view/split-view-layout.mjs +607 -0
  117. package/dist/components/split-view/split-view.component.mjs +502 -468
  118. package/dist/components/split-view/split-view.styles.mjs +25 -0
  119. package/dist/components/split-view-divider/split-view-divider.component.mjs +2 -53
  120. package/dist/components/split-view-divider/split-view-divider.styles.mjs +28 -16
  121. package/dist/components/split-view-pane/split-view-pane.component.mjs +197 -18
  122. package/dist/components/split-view-pane/split-view-pane.styles.mjs +52 -0
  123. package/dist/components/split-view-toggle-button/split-view-toggle-button.component.mjs +5 -0
  124. package/dist/components/split-view-toggle-button/split-view-toggle-button.styles.mjs +3 -3
  125. package/dist/components/stepper/stepper.component.mjs +3 -2
  126. package/dist/components/stepper-panel/stepper-panel.component.mjs +4 -3
  127. package/dist/components/switch/switch.component.mjs +9 -8
  128. package/dist/components/tab/tab.component.mjs +21 -17
  129. package/dist/components/tab-group/tab-group.component.mjs +218 -44
  130. package/dist/components/tab-group/tab-group.styles.mjs +44 -0
  131. package/dist/components/tab-panel/tab-panel.component.mjs +1 -0
  132. package/dist/components/tag/tag.component.mjs +13 -12
  133. package/dist/components/textarea/textarea.component.mjs +11 -4
  134. package/dist/components/timer/ticker.mjs +7 -0
  135. package/dist/components/timer/timer.component.mjs +44 -3
  136. package/dist/components/timer/timer.styles.mjs +6 -2
  137. package/dist/components/tool-button/tool-button.component.mjs +4 -0
  138. package/dist/components/tool-button-group/tool-button-group.component.mjs +3 -0
  139. package/dist/components/tooltip/tooltip.component.mjs +3 -0
  140. package/dist/components/tree/tree.component.mjs +5 -2
  141. package/dist/components/tree-item/tree-item.component.mjs +5 -0
  142. package/dist/components/visually-hidden/visually-hidden.component.mjs +1 -0
  143. package/dist/custom-elements.json +7890 -1741
  144. package/dist/diagram/api/diagram-api-base.mjs +16 -0
  145. package/dist/diagram/api/diagram-api.mjs +399 -0
  146. package/dist/diagram/api/diagram-clipboard-api.mjs +52 -0
  147. package/dist/diagram/api/diagram-groups-api.mjs +46 -0
  148. package/dist/diagram/api/diagram-model-api.mjs +447 -0
  149. package/dist/diagram/api/diagram-nodes-api.mjs +61 -0
  150. package/dist/diagram/api/diagram-selection-api.mjs +56 -0
  151. package/dist/diagram/api/diagram-viewport-api.mjs +169 -0
  152. package/dist/diagram/api/emit-with-measurement-option.mjs +21 -0
  153. package/dist/diagram/input/box-selection-controller.mjs +104 -0
  154. package/dist/diagram/input/context-menu-controller.mjs +196 -0
  155. package/dist/diagram/input/cursor-position-tracker-controller.mjs +18 -0
  156. package/dist/diagram/input/input-controller.mjs +31 -0
  157. package/dist/diagram/input/keyboard-actions/moving-action.mjs +27 -0
  158. package/dist/diagram/input/keyboard-actions/panning-action.mjs +27 -0
  159. package/dist/diagram/input/keyboard-actions/paste-action.mjs +17 -0
  160. package/dist/diagram/input/keyboard-actions/zoom-action.mjs +30 -0
  161. package/dist/diagram/input/keyboard-inputs-controller.mjs +121 -0
  162. package/dist/diagram/input/linking-controller.mjs +127 -0
  163. package/dist/diagram/input/linking-events.mjs +61 -0
  164. package/dist/diagram/input/manual-linking.mjs +101 -0
  165. package/dist/diagram/input/mobile-box-selection-controller.mjs +133 -0
  166. package/dist/diagram/input/mobile-panning-controller.mjs +114 -0
  167. package/dist/diagram/input/mobile-zooming-controller.mjs +110 -0
  168. package/dist/diagram/input/object-selection-controller.mjs +152 -0
  169. package/dist/diagram/input/palette-drop-controller.mjs +92 -0
  170. package/dist/diagram/input/panning-controller.mjs +147 -0
  171. package/dist/diagram/input/pointer-move-selection-controller.mjs +191 -0
  172. package/dist/diagram/input/relinking-gesture.mjs +182 -0
  173. package/dist/diagram/input/resize-controller.mjs +122 -0
  174. package/dist/diagram/input/rotate-controller.mjs +126 -0
  175. package/dist/diagram/input/zooming-wheel-controller.mjs +55 -0
  176. package/dist/diagram/minimap/minimap-calculations.mjs +83 -0
  177. package/dist/diagram/minimap/minimap-navigation-controller.mjs +150 -0
  178. package/dist/diagram/minimap/minimap-node-cache.mjs +19 -0
  179. package/dist/diagram/minimap/minimap-strategies.mjs +44 -0
  180. package/dist/diagram/model/diagram-model-adapter.mjs +97 -0
  181. package/dist/diagram/model/initialize-model.mjs +31 -0
  182. package/dist/diagram/model/strip-runtime-properties.mjs +30 -0
  183. package/dist/diagram/runtime/attribute-converters.mjs +11 -0
  184. package/dist/diagram/runtime/batched-resize-observer.mjs +168 -0
  185. package/dist/diagram/runtime/box-selection-provider.mjs +9 -0
  186. package/dist/diagram/runtime/context.mjs +132 -0
  187. package/dist/diagram/runtime/contexts.mjs +8 -0
  188. package/dist/diagram/runtime/cursor-position-tracker.mjs +20 -0
  189. package/dist/diagram/runtime/default-edge-templates.mjs +21 -0
  190. package/dist/diagram/runtime/default-node-templates.mjs +20 -0
  191. package/dist/diagram/runtime/diagram-reference.mjs +126 -0
  192. package/dist/diagram/runtime/diagram-runtime.mjs +214 -0
  193. package/dist/diagram/runtime/dom-input-events-router.mjs +88 -0
  194. package/dist/diagram/runtime/environment.mjs +59 -0
  195. package/dist/diagram/runtime/event-bridge.mjs +31 -0
  196. package/dist/diagram/runtime/flow-offset.mjs +45 -0
  197. package/dist/diagram/runtime/group-highlighted.mjs +25 -0
  198. package/dist/diagram/runtime/hidden.mjs +147 -0
  199. package/dist/diagram/runtime/lit-renderer.mjs +33 -0
  200. package/dist/diagram/runtime/marker-registry.mjs +108 -0
  201. package/dist/diagram/runtime/middlewares.mjs +14 -0
  202. package/dist/diagram/runtime/model-owner.mjs +11 -0
  203. package/dist/diagram/runtime/node-selected.mjs +25 -0
  204. package/dist/diagram/runtime/observable.mjs +205 -0
  205. package/dist/diagram/runtime/palette-drag.mjs +56 -0
  206. package/dist/diagram/runtime/port-hover.mjs +27 -0
  207. package/dist/diagram/runtime/port-registry.mjs +87 -0
  208. package/dist/diagram/runtime/resize-processor.mjs +207 -0
  209. package/dist/diagram/runtime/template-resolver.mjs +98 -0
  210. package/dist/diagram/runtime/touch-events-state.mjs +52 -0
  211. package/dist/diagram/utilities.mjs +27 -0
  212. package/dist/diagram-core/action-state-manager/action-state-manager.mjs +238 -0
  213. package/dist/diagram-core/batch-processor/batch-processor.mjs +144 -0
  214. package/dist/diagram-core/command-handler/command-handler.mjs +62 -0
  215. package/dist/diagram-core/command-handler/commands/add-to-group.mjs +32 -0
  216. package/dist/diagram-core/command-handler/commands/add-update-delete.mjs +196 -0
  217. package/dist/diagram-core/command-handler/commands/centering.mjs +73 -0
  218. package/dist/diagram-core/command-handler/commands/copy-paste.mjs +223 -0
  219. package/dist/diagram-core/command-handler/commands/cut.mjs +9 -0
  220. package/dist/diagram-core/command-handler/commands/delete-selection.mjs +32 -0
  221. package/dist/diagram-core/command-handler/commands/detach-on-node-delete.mjs +77 -0
  222. package/dist/diagram-core/command-handler/commands/highlight-group.mjs +45 -0
  223. package/dist/diagram-core/command-handler/commands/index.mjs +88 -0
  224. package/dist/diagram-core/command-handler/commands/init.mjs +11 -0
  225. package/dist/diagram-core/command-handler/commands/linking/cancel-linking.mjs +26 -0
  226. package/dist/diagram-core/command-handler/commands/linking/finish-linking-to-position.mjs +33 -0
  227. package/dist/diagram-core/command-handler/commands/linking/finish-linking.mjs +108 -0
  228. package/dist/diagram-core/command-handler/commands/linking/finish-relinking.mjs +91 -0
  229. package/dist/diagram-core/command-handler/commands/linking/linking-gesture.mjs +13 -0
  230. package/dist/diagram-core/command-handler/commands/linking/move-temporary-edge.mjs +98 -0
  231. package/dist/diagram-core/command-handler/commands/linking/start-linking-from-position.mjs +23 -0
  232. package/dist/diagram-core/command-handler/commands/linking/start-linking.mjs +47 -0
  233. package/dist/diagram-core/command-handler/commands/linking/start-relinking.mjs +51 -0
  234. package/dist/diagram-core/command-handler/commands/linking/utils.mjs +103 -0
  235. package/dist/diagram-core/command-handler/commands/move-nodes-lifecycle.mjs +14 -0
  236. package/dist/diagram-core/command-handler/commands/move-viewport.mjs +48 -0
  237. package/dist/diagram-core/command-handler/commands/move.mjs +90 -0
  238. package/dist/diagram-core/command-handler/commands/remove-from-group.mjs +22 -0
  239. package/dist/diagram-core/command-handler/commands/resize-node-lifecycle.mjs +14 -0
  240. package/dist/diagram-core/command-handler/commands/resize-node.mjs +214 -0
  241. package/dist/diagram-core/command-handler/commands/rotate-node-lifecycle.mjs +14 -0
  242. package/dist/diagram-core/command-handler/commands/rotate-node.mjs +53 -0
  243. package/dist/diagram-core/command-handler/commands/selection.mjs +69 -0
  244. package/dist/diagram-core/command-handler/commands/z-order.mjs +125 -0
  245. package/dist/diagram-core/command-handler/commands/zoom-to-fit.mjs +118 -0
  246. package/dist/diagram-core/command-handler/commands/zoom.mjs +26 -0
  247. package/dist/diagram-core/edge-routing-manager/edge-routing-manager.mjs +253 -0
  248. package/dist/diagram-core/edge-routing-manager/resolve-label-position.mjs +13 -0
  249. package/dist/diagram-core/edge-routing-manager/routings/bezier/bezier-routing.mjs +73 -0
  250. package/dist/diagram-core/edge-routing-manager/routings/bezier/compute-bezier-path.mjs +24 -0
  251. package/dist/diagram-core/edge-routing-manager/routings/bezier/compute-bezier-point-at-distance.mjs +37 -0
  252. package/dist/diagram-core/edge-routing-manager/routings/bezier/compute-bezier-point-on-path.mjs +33 -0
  253. package/dist/diagram-core/edge-routing-manager/routings/bezier/compute-bezier-points.mjs +31 -0
  254. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/compute-orthogonal-path.mjs +56 -0
  255. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/compute-orthogonal-point-at-distance.mjs +12 -0
  256. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/compute-orthogonal-point-on-path.mjs +38 -0
  257. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/compute-orthogonal-points.mjs +26 -0
  258. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/orthogonal-routing.mjs +69 -0
  259. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/utils/get-offset-point.mjs +14 -0
  260. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/utils/pathpoints/get-pathpoints-from-bottom.mjs +104 -0
  261. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/utils/pathpoints/get-pathpoints-from-left.mjs +91 -0
  262. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/utils/pathpoints/get-pathpoints-from-right.mjs +88 -0
  263. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/utils/pathpoints/get-pathpoints-from-top.mjs +168 -0
  264. package/dist/diagram-core/edge-routing-manager/routings/orthogonal/utils/pathpoints/get-pathpoints.mjs +23 -0
  265. package/dist/diagram-core/edge-routing-manager/routings/polyline/compute-polyline-point-at-distance.mjs +12 -0
  266. package/dist/diagram-core/edge-routing-manager/routings/polyline/compute-polyline-point-on-path.mjs +41 -0
  267. package/dist/diagram-core/edge-routing-manager/routings/polyline/polyline-routing.mjs +81 -0
  268. package/dist/diagram-core/edge-routing-manager/utils/linear-segment-utils.mjs +27 -0
  269. package/dist/diagram-core/edge-routing-manager/utils/normalize-distance.mjs +6 -0
  270. package/dist/diagram-core/event-manager/event-manager.mjs +164 -0
  271. package/dist/diagram-core/flow-config/default-flow-config.mjs +143 -0
  272. package/dist/diagram-core/flow-core.mjs +541 -0
  273. package/dist/diagram-core/input-events/handlers/box-selection/box-selection.handler.mjs +69 -0
  274. package/dist/diagram-core/input-events/handlers/cancel-interaction/cancel-interaction.handler.mjs +9 -0
  275. package/dist/diagram-core/input-events/handlers/copy/copy.handler.mjs +9 -0
  276. package/dist/diagram-core/input-events/handlers/cut/cut.handler.mjs +9 -0
  277. package/dist/diagram-core/input-events/handlers/delete-selection/delete-selection.handler.mjs +9 -0
  278. package/dist/diagram-core/input-events/handlers/event-handler.mjs +29 -0
  279. package/dist/diagram-core/input-events/handlers/keyboard-move-selection/keyboard-move-selection.handler.mjs +130 -0
  280. package/dist/diagram-core/input-events/handlers/keyboard-panning/keyboard-panning.handler.mjs +31 -0
  281. package/dist/diagram-core/input-events/handlers/linking/linking.handler.mjs +77 -0
  282. package/dist/diagram-core/input-events/handlers/movable-selection.mjs +26 -0
  283. package/dist/diagram-core/input-events/handlers/palette-drop/palette-drop.handler.mjs +20 -0
  284. package/dist/diagram-core/input-events/handlers/panning/panning-handler-factory.mjs +8 -0
  285. package/dist/diagram-core/input-events/handlers/panning/panning.handler.mjs +41 -0
  286. package/dist/diagram-core/input-events/handlers/panning/virtualized-panning.handler.mjs +77 -0
  287. package/dist/diagram-core/input-events/handlers/paste/paste.handler.mjs +17 -0
  288. package/dist/diagram-core/input-events/handlers/pointer-move-selection/pointer-move-selection.handler.mjs +220 -0
  289. package/dist/diagram-core/input-events/handlers/redo/redo.handler.mjs +14 -0
  290. package/dist/diagram-core/input-events/handlers/relinking/relinking.handler.mjs +62 -0
  291. package/dist/diagram-core/input-events/handlers/resize/resize.handler.mjs +174 -0
  292. package/dist/diagram-core/input-events/handlers/rotate/rotate.handler.mjs +107 -0
  293. package/dist/diagram-core/input-events/handlers/select/select.handler.mjs +42 -0
  294. package/dist/diagram-core/input-events/handlers/select-all/select-all.handler.mjs +10 -0
  295. package/dist/diagram-core/input-events/handlers/undo/undo.handler.mjs +14 -0
  296. package/dist/diagram-core/input-events/handlers/wheel-panning/wheel-panning.handler.mjs +25 -0
  297. package/dist/diagram-core/input-events/handlers/zooming/zooming.handler.mjs +28 -0
  298. package/dist/diagram-core/input-events/input-events.router.mjs +75 -0
  299. package/dist/diagram-core/interaction-coordinator/interaction-coordinator.mjs +75 -0
  300. package/dist/diagram-core/label-batch-processor/label-batch-processor.mjs +19 -0
  301. package/dist/diagram-core/math/angle-between-points/angle-between-points.mjs +5 -0
  302. package/dist/diagram-core/math/angle-to-side/angle-to-side.mjs +27 -0
  303. package/dist/diagram-core/math/calculate-edge-panning-force/calculate-edge-panning-force.mjs +34 -0
  304. package/dist/diagram-core/math/clamp/clamp.mjs +5 -0
  305. package/dist/diagram-core/math/distance-between-points/distance-between-points.mjs +5 -0
  306. package/dist/diagram-core/math/ng-diagram-math.mjs +25 -0
  307. package/dist/diagram-core/math/normalize-angle/normalize-angle.mjs +5 -0
  308. package/dist/diagram-core/math/snap-angle/snap-angle.mjs +43 -0
  309. package/dist/diagram-core/math/snap-number/snap-number.mjs +3 -0
  310. package/dist/diagram-core/math/snap-point/snap-point.mjs +8 -0
  311. package/dist/diagram-core/math/subtract-points/subtract-points.mjs +5 -0
  312. package/dist/diagram-core/measurement-tracker/measurement-tracker.mjs +182 -0
  313. package/dist/diagram-core/middleware-manager/middleware-executor.mjs +246 -0
  314. package/dist/diagram-core/middleware-manager/middleware-manager.mjs +93 -0
  315. package/dist/diagram-core/middleware-manager/middlewares/edges-routing/edges-routing.mjs +149 -0
  316. package/dist/diagram-core/middleware-manager/middlewares/edges-routing/get-edge-points.mjs +93 -0
  317. package/dist/diagram-core/middleware-manager/middlewares/edges-routing/get-source-target-positions.mjs +90 -0
  318. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/clipboard-paste.emitter.mjs +34 -0
  319. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/diagram-init.emitter.mjs +190 -0
  320. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/edge-draw-ended.emitter.mjs +51 -0
  321. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/edge-drawn.emitter.mjs +35 -0
  322. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/edge-relink.emitter.mjs +58 -0
  323. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/group-membership-changed.emitter.mjs +49 -0
  324. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/node-drag-lifecycle.emitter.mjs +54 -0
  325. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/node-resize-lifecycle.emitter.mjs +44 -0
  326. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/node-rotate-lifecycle.emitter.mjs +44 -0
  327. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/palette-item-dropped.emitter.mjs +26 -0
  328. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/selection-changed.emitter.mjs +61 -0
  329. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/selection-gesture-ended.emitter.mjs +32 -0
  330. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/selection-moved.emitter.mjs +57 -0
  331. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/selection-removed.emitter.mjs +40 -0
  332. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/selection-rotated.emitter.mjs +33 -0
  333. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/size-changed.emitter.mjs +33 -0
  334. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/emitters/viewport-changed.emitter.mjs +19 -0
  335. package/dist/diagram-core/middleware-manager/middlewares/event-emitter/event-emitter.middleware.mjs +69 -0
  336. package/dist/diagram-core/middleware-manager/middlewares/hidden-computation/hidden-computation.mjs +66 -0
  337. package/dist/diagram-core/middleware-manager/middlewares/internal-id-assignment/internal-id-assignment.mjs +24 -0
  338. package/dist/diagram-core/middleware-manager/middlewares/logger/logger.mjs +18 -0
  339. package/dist/diagram-core/middleware-manager/middlewares/measured-bounds-assignment/is-node-fully-measured.mjs +20 -0
  340. package/dist/diagram-core/middleware-manager/middlewares/measured-bounds-assignment/measured-bounds-assignment.mjs +59 -0
  341. package/dist/diagram-core/middleware-manager/middlewares/measurement-tracking/measurement-tracking.middleware.mjs +55 -0
  342. package/dist/diagram-core/middleware-manager/middlewares/z-index-assignment/utils/assign-edges-z-index.mjs +12 -0
  343. package/dist/diagram-core/middleware-manager/middlewares/z-index-assignment/utils/assign-node-z-index.mjs +61 -0
  344. package/dist/diagram-core/middleware-manager/middlewares/z-index-assignment/utils/create-group-children-map.mjs +14 -0
  345. package/dist/diagram-core/middleware-manager/middlewares/z-index-assignment/utils/initialize-z-index.mjs +30 -0
  346. package/dist/diagram-core/middleware-manager/middlewares/z-index-assignment/utils/sort-children.mjs +36 -0
  347. package/dist/diagram-core/middleware-manager/middlewares/z-index-assignment/z-index-assignment.mjs +240 -0
  348. package/dist/diagram-core/middleware-manager/pass-settlement.mjs +68 -0
  349. package/dist/diagram-core/model-lookup/model-lookup.mjs +394 -0
  350. package/dist/diagram-core/port-batch-processor/port-batch-processor.mjs +20 -0
  351. package/dist/diagram-core/render-strategy/base-render-strategy.mjs +26 -0
  352. package/dist/diagram-core/render-strategy/direct/direct-render-strategy.mjs +33 -0
  353. package/dist/diagram-core/render-strategy/render-performance-logger.mjs +42 -0
  354. package/dist/diagram-core/render-strategy/virtualized/idle-render-scheduler.mjs +43 -0
  355. package/dist/diagram-core/render-strategy/virtualized/result-cache.mjs +63 -0
  356. package/dist/diagram-core/render-strategy/virtualized/viewport-utils.mjs +40 -0
  357. package/dist/diagram-core/render-strategy/virtualized/virtualized-render-strategy.mjs +91 -0
  358. package/dist/diagram-core/render-strategy/virtualized/visible-elements-resolver.mjs +120 -0
  359. package/dist/diagram-core/render-strategy/virtualized/zoom-tracker.mjs +38 -0
  360. package/dist/diagram-core/set.polyfill.mjs +24 -0
  361. package/dist/diagram-core/shortcut-manager/default-shortcuts.mjs +99 -0
  362. package/dist/diagram-core/shortcut-manager/shortcut-manager.mjs +140 -0
  363. package/dist/diagram-core/spatial-hash/collision-detection.mjs +74 -0
  364. package/dist/diagram-core/spatial-hash/spatial-hash.mjs +161 -0
  365. package/dist/diagram-core/spatial-hash/utils.mjs +92 -0
  366. package/dist/diagram-core/transaction-manager/transaction-context.mjs +40 -0
  367. package/dist/diagram-core/transaction-manager/transaction-manager.mjs +94 -0
  368. package/dist/diagram-core/transaction-manager/transaction.mjs +179 -0
  369. package/dist/diagram-core/types/edge.interface.mjs +3 -0
  370. package/dist/diagram-core/types/node.interface.mjs +3 -0
  371. package/dist/diagram-core/types/utils.mjs +3 -0
  372. package/dist/diagram-core/updater/init-updater/init-state.mjs +356 -0
  373. package/dist/diagram-core/updater/init-updater/init-updater.mjs +275 -0
  374. package/dist/diagram-core/updater/init-updater/late-arrival-queue.mjs +71 -0
  375. package/dist/diagram-core/updater/init-updater/stability-detector.mjs +63 -0
  376. package/dist/diagram-core/updater/internal-updater/internal-updater.mjs +166 -0
  377. package/dist/diagram-core/utils/change-generation.mjs +13 -0
  378. package/dist/diagram-core/utils/compute-floating-edge-side.mjs +35 -0
  379. package/dist/diagram-core/utils/constants.mjs +3 -0
  380. package/dist/diagram-core/utils/dangling-edges.mjs +89 -0
  381. package/dist/diagram-core/utils/deep-merge.mjs +22 -0
  382. package/dist/diagram-core/utils/dimensions.mjs +52 -0
  383. package/dist/diagram-core/utils/get-node-border-intersection.mjs +99 -0
  384. package/dist/diagram-core/utils/get-port-flow-position.mjs +55 -0
  385. package/dist/diagram-core/utils/group-size.mjs +32 -0
  386. package/dist/diagram-core/utils/is-group.mjs +5 -0
  387. package/dist/diagram-core/utils/measurement-validation.mjs +11 -0
  388. package/dist/diagram-core/utils/object-properties.mjs +22 -0
  389. package/dist/diagram-core/utils/rects-points-sizes.mjs +148 -0
  390. package/dist/diagram-core/utils/relinking.mjs +6 -0
  391. package/dist/diagram-core/utils/semaphore.mjs +43 -0
  392. package/dist/diagram-core/utils/snap-node-position.mjs +11 -0
  393. package/dist/diagram-core/utils/sort-nodes-by-z-index.mjs +22 -0
  394. package/dist/diagram-core/visibility/effective-visibility.mjs +28 -0
  395. package/dist/diagram-core/visibility/template-visibility-registry.mjs +87 -0
  396. package/dist/index.d.mts +13296 -3667
  397. package/dist/index.d.ts +13296 -3667
  398. package/dist/index.mjs +34 -0
  399. package/dist/internal/content-size.mjs +14 -0
  400. package/dist/internal/custom-boolean-converter.mjs +18 -0
  401. package/dist/internal/flow-ui-rdf-element.mjs +57 -5
  402. package/dist/internal/form.mjs +1 -1
  403. package/dist/internal/on-off-converter.mjs +21 -0
  404. package/dist/package.json.mjs +1 -1
  405. package/dist/utilities/register-components.mjs +77 -142
  406. package/dist/vscode.html-custom-data.json +426 -156
  407. package/package.json +35 -40
  408. package/themes/dark.css +7 -5
  409. package/themes/dark.styles.js +7 -5
  410. package/themes/light.css +7 -5
  411. package/themes/light.styles.js +7 -5
@@ -0,0 +1,16 @@
1
+ class DiagramApiBase {
2
+ /** @internal */
3
+ constructor(runtime) {
4
+ this.runtime = runtime;
5
+ }
6
+ /**
7
+ * The current engine. Throws before the diagram has a model.
8
+ *
9
+ * @internal
10
+ */
11
+ get flowCore() {
12
+ return this.runtime.provide();
13
+ }
14
+ }
15
+
16
+ export { DiagramApiBase };
@@ -0,0 +1,399 @@
1
+ import { DiagramApiBase } from './diagram-api-base.mjs';
2
+ import { DiagramClipboardApi } from './diagram-clipboard-api.mjs';
3
+ import { DiagramGroupsApi } from './diagram-groups-api.mjs';
4
+ import { DiagramModelApi } from './diagram-model-api.mjs';
5
+ import { DiagramNodesApi } from './diagram-nodes-api.mjs';
6
+ import { DiagramSelectionApi } from './diagram-selection-api.mjs';
7
+ import { DiagramViewportApi } from './diagram-viewport-api.mjs';
8
+
9
+ class DiagramApi extends DiagramApiBase {
10
+ /** @internal */
11
+ constructor(runtime) {
12
+ super(runtime);
13
+ this.listeners = [];
14
+ this.model = new DiagramModelApi(runtime);
15
+ this.nodes = new DiagramNodesApi(runtime);
16
+ this.selection = new DiagramSelectionApi(runtime, this.model);
17
+ this.viewport = new DiagramViewportApi(runtime);
18
+ this.groups = new DiagramGroupsApi(runtime);
19
+ this.clipboard = new DiagramClipboardApi(runtime);
20
+ }
21
+ // ==============================
22
+ // Reactive state
23
+ // ==============================
24
+ /**
25
+ * Whether the diagram is initialized: every node, port and label has been measured. It turns `true` when
26
+ * `flow-ui-diagram-init` fires, and back to `false` while a new model initializes.
27
+ */
28
+ get isInitialized() {
29
+ return this.runtime.isInitialized;
30
+ }
31
+ /**
32
+ * The resolved configuration, or `null` before the diagram has a model. Change it with
33
+ * {@link DiagramApi.updateConfig}.
34
+ */
35
+ get config() {
36
+ return this.runtime.config;
37
+ }
38
+ /**
39
+ * The state of the gesture in progress (resizing, rotating, linking and so on). The diagram manages it; it
40
+ * changes when a gesture starts or ends.
41
+ */
42
+ get actionState() {
43
+ return this.runtime.actionState;
44
+ }
45
+ // ==============================
46
+ // Configuration
47
+ // ==============================
48
+ /**
49
+ * Merges a partial configuration into the current configuration.
50
+ *
51
+ * @example
52
+ * Enable debug mode:
53
+ * ```ts
54
+ * diagram.api.updateConfig({ debugMode: true });
55
+ * ```
56
+ *
57
+ * @param config - Configuration properties to change.
58
+ */
59
+ updateConfig(config) {
60
+ this.runtime.updateConfig(config);
61
+ }
62
+ /**
63
+ * Returns information about the environment the diagram runs in (operating system, browser and so on).
64
+ *
65
+ * @returns The environment information.
66
+ */
67
+ getEnvironment() {
68
+ return this.runtime.environment;
69
+ }
70
+ // ==============================
71
+ // Middleware
72
+ // ==============================
73
+ /**
74
+ * Adds a middleware to the end of the middleware chain. Use with care: a faulty middleware can slow down or
75
+ * break every state update.
76
+ *
77
+ * @param middleware - Middleware to add.
78
+ * @returns A function that removes the middleware again.
79
+ */
80
+ registerMiddleware(middleware) {
81
+ return this.flowCore.registerMiddleware(middleware);
82
+ }
83
+ /**
84
+ * Removes a middleware from the middleware chain.
85
+ *
86
+ * @param name - Name of the middleware to remove.
87
+ */
88
+ unregisterMiddleware(name) {
89
+ this.flowCore.unregisterMiddleware(name);
90
+ }
91
+ // ==============================
92
+ // Edge routing
93
+ // ==============================
94
+ /**
95
+ * Registers a custom edge routing. Edges use it when their `routing` is its name.
96
+ *
97
+ * @example
98
+ * Register a routing that draws straight lines:
99
+ * ```ts
100
+ * diagram.api.registerRouting({
101
+ * name: 'straight',
102
+ * computePoints: ({ sourcePoint, targetPoint }) => [sourcePoint, targetPoint],
103
+ * computeSvgPath: (points) => points.map(({ x, y }, i) => `${i ? 'L' : 'M'} ${x},${y}`).join(' ')
104
+ * });
105
+ * ```
106
+ *
107
+ * @param routing - Routing implementation.
108
+ */
109
+ registerRouting(routing) {
110
+ this.flowCore.edgeRoutingManager.registerRouting(routing);
111
+ }
112
+ /**
113
+ * Unregisters an edge routing.
114
+ *
115
+ * @param name - Name of the routing to unregister.
116
+ */
117
+ unregisterRouting(name) {
118
+ this.flowCore.edgeRoutingManager.unregisterRouting(name);
119
+ }
120
+ /**
121
+ * Returns the names of the registered edge routings.
122
+ *
123
+ * @returns The routing names.
124
+ */
125
+ getRegisteredRoutings() {
126
+ return this.flowCore.edgeRoutingManager.getRegisteredRoutings();
127
+ }
128
+ /**
129
+ * Sets the routing of edges that do not specify one.
130
+ *
131
+ * @param name - Name of a registered routing.
132
+ */
133
+ setDefaultRouting(name) {
134
+ this.flowCore.edgeRoutingManager.setDefaultRouting(name);
135
+ }
136
+ /**
137
+ * Returns the name of the routing used by edges that do not specify one.
138
+ *
139
+ * @returns The default routing name.
140
+ */
141
+ getDefaultRouting() {
142
+ return this.flowCore.edgeRoutingManager.getDefaultRouting();
143
+ }
144
+ // ==============================
145
+ // Manual linking
146
+ // ==============================
147
+ /**
148
+ * Starts drawing an edge from a node, for example from a context menu action. The free end of the edge starts
149
+ * at the last known pointer position and follows the pointer until a click finishes the draw: a click on a port
150
+ * connects the edge to it, as when dragging from a port. Escape cancels the draw.
151
+ *
152
+ * The call is ignored with a warning while another edge is being drawn or relinked, and when the node does not
153
+ * exist or is hidden.
154
+ *
155
+ * @param node - Node the edge starts from.
156
+ * @param portId - ID of the port the edge starts from. If not specified, the edge starts from the node itself.
157
+ */
158
+ startLinking(node, portId) {
159
+ this.manualLinking()?.startLinking(node, portId);
160
+ }
161
+ /**
162
+ * Starts drawing an edge from a position on the canvas instead of from a node, for example from a context menu
163
+ * action. The free end of the edge follows the pointer until a click finishes the draw: a click on a port
164
+ * connects the edge to that port, and a click on empty canvas leaves both ends free, which is kept when
165
+ * `danglingEdges.shouldKeepOnDrop` allows it.
166
+ *
167
+ * This requires `danglingEdges.enabled` in the configuration, because an edge drawn from a position has no
168
+ * source node. Otherwise the call is ignored with a warning.
169
+ *
170
+ * @param position - Start position in flow coordinates.
171
+ */
172
+ startLinkingFromPosition(position) {
173
+ this.manualLinking()?.startLinkingFromPosition(position);
174
+ }
175
+ // ==============================
176
+ // Interaction control
177
+ // ==============================
178
+ /**
179
+ * Aborts the gesture in progress (linking, dragging, resizing, rotating or panning). It removes the gesture's
180
+ * listeners, restores the state the gesture changed (positions, size, angle and the temporary edge, but not the
181
+ * viewport) and fires the matching "ended" event with the `cancelled` reason.
182
+ *
183
+ * It does nothing when no gesture is active or the gesture is already completing, and while a transaction is
184
+ * active (with a warning). The Escape key calls it by default, through the `cancelInteraction` shortcut.
185
+ *
186
+ * @returns A promise of whether a gesture was aborted.
187
+ */
188
+ cancelActiveInteraction() {
189
+ return this.flowCore.cancelActiveInteraction();
190
+ }
191
+ // ==============================
192
+ // Event management
193
+ // ==============================
194
+ /**
195
+ * Adds a listener for a diagram engine event. Every engine event is also dispatched on the element as a
196
+ * `flow-ui-diagram-*` DOM event.
197
+ *
198
+ * The listener can be added before the diagram has a model, and it is kept when a new model re-creates the
199
+ * engine. A `diagramInit` listener runs when `isInitialized` turns `true`.
200
+ *
201
+ * @example
202
+ * Log selection changes:
203
+ * ```ts
204
+ * const unsubscribe = diagram.api.addEventListener('selectionChanged', (event) => {
205
+ * console.log('Selection changed', event.selectedNodes);
206
+ * });
207
+ * ```
208
+ *
209
+ * @param event - Event name.
210
+ * @param callback - Function called with the event payload.
211
+ * @returns A function that removes the listener.
212
+ */
213
+ addEventListener(event, callback) {
214
+ return this.addListener(event, callback, false);
215
+ }
216
+ /**
217
+ * Adds a listener for a diagram engine event that is removed after it has been called once. See
218
+ * {@link DiagramApi.addEventListener}.
219
+ *
220
+ * @example
221
+ * Run code once the diagram is initialized:
222
+ * ```ts
223
+ * diagram.api.addEventListenerOnce('diagramInit', (event) => console.log('Diagram initialized', event));
224
+ * ```
225
+ *
226
+ * @param event - Event name.
227
+ * @param callback - Function called with the event payload.
228
+ * @returns A function that removes the listener.
229
+ */
230
+ addEventListenerOnce(event, callback) {
231
+ return this.addListener(event, callback, true);
232
+ }
233
+ /**
234
+ * Removes listeners added with {@link DiagramApi.addEventListener} or {@link DiagramApi.addEventListenerOnce}.
235
+ * The `flow-ui-diagram-*` DOM events are not affected.
236
+ *
237
+ * @example
238
+ * Remove one listener, or every listener for an event:
239
+ * ```ts
240
+ * diagram.api.removeEventListener('selectionChanged', onSelectionChanged);
241
+ * diagram.api.removeEventListener('selectionChanged');
242
+ * ```
243
+ *
244
+ * @param event - Event name.
245
+ * @param callback - Listener to remove. If not specified, every listener for the event is removed.
246
+ */
247
+ removeEventListener(event, callback) {
248
+ for (const listener of [...this.listeners]) {
249
+ if (listener.event === event && (!callback || listener.callback === callback)) {
250
+ this.removeListener(listener);
251
+ }
252
+ }
253
+ }
254
+ /**
255
+ * Removes every listener added with {@link DiagramApi.addEventListener} or
256
+ * {@link DiagramApi.addEventListenerOnce}. The `flow-ui-diagram-*` DOM events are not affected.
257
+ */
258
+ removeAllEventListeners() {
259
+ for (const listener of [...this.listeners]) {
260
+ this.removeListener(listener);
261
+ }
262
+ }
263
+ /**
264
+ * Enables or disables diagram engine events. While they are disabled, neither API listeners nor the
265
+ * `flow-ui-diagram-*` DOM events are called. A new model re-creates the engine with events enabled.
266
+ *
267
+ * @param enabled - Set to `true` to enable events, or `false` to disable them.
268
+ */
269
+ setEventsEnabled(enabled) {
270
+ this.flowCore.eventManager.setEnabled(enabled);
271
+ }
272
+ /**
273
+ * Returns whether diagram engine events are enabled.
274
+ *
275
+ * @returns `true` if events are enabled.
276
+ */
277
+ areEventsEnabled() {
278
+ return this.flowCore.eventManager.isEnabled();
279
+ }
280
+ /**
281
+ * Returns whether an event has listeners added with {@link DiagramApi.addEventListener} or
282
+ * {@link DiagramApi.addEventListenerOnce}.
283
+ *
284
+ * @param event - Event name.
285
+ * @returns `true` if the event has API listeners.
286
+ */
287
+ hasEventListeners(event) {
288
+ return this.listeners.some((listener) => listener.event === event);
289
+ }
290
+ // ==============================
291
+ // Transactions
292
+ // ==============================
293
+ /**
294
+ * Runs a function, which may be async, in a transaction: every model change made inside it through the API is
295
+ * applied at once, as one update, when the function returns (or its promise resolves).
296
+ *
297
+ * @example
298
+ * Add nodes and edges in one update, and wait until they are measured:
299
+ * ```ts
300
+ * await diagram.api.transaction(
301
+ * async () => {
302
+ * const { nodes, edges } = await fetchDiagram();
303
+ * diagram.api.model.addNodes(nodes);
304
+ * diagram.api.model.addEdges(edges);
305
+ * },
306
+ * { waitForMeasurements: true }
307
+ * );
308
+ * await diagram.api.viewport.zoomToFit();
309
+ * ```
310
+ *
311
+ * @param callback - Function that makes the changes.
312
+ * @param options - Transaction options. Set `waitForMeasurements` to `true` to resolve only after the added
313
+ * or changed elements have been measured.
314
+ * @returns A promise of the transaction result, which resolves once the transaction has been committed to the
315
+ * model.
316
+ */
317
+ transaction(callback, options) {
318
+ const wrappedCallback = () => callback();
319
+ return this.flowCore.transaction(wrappedCallback, options ?? {});
320
+ }
321
+ // ==============================
322
+ // Measurements
323
+ // ==============================
324
+ /**
325
+ * Measures diagram elements again. Without options, every node, port and edge label is measured again;
326
+ * otherwise only the specified nodes (with their ports) and edge labels. Use this method when a template
327
+ * changes size in a way the diagram cannot observe.
328
+ *
329
+ * The returned promise resolves once the measurements have settled, so the elements' `size`, `measuredPorts`
330
+ * and `measuredLabels` are up to date. It never hangs: an element that delivers no new measurement (removed,
331
+ * zero-size or unchanged) settles when the discovery window expires, and when nothing matching the options is
332
+ * observed, it resolves immediately. Measurements running at the same time settle together.
333
+ *
334
+ * :::warning
335
+ * Do not `await` this method inside an active transaction (measurements are applied only at commit, so the
336
+ * promise resolves before the new geometry lands) or inside a middleware (the update pipeline is not
337
+ * re-entrant, so the `await` deadlocks). Calling it without `await` is safe in both.
338
+ * :::
339
+ *
340
+ * @example
341
+ * Measure one node again and wait for its new geometry:
342
+ * ```ts
343
+ * await diagram.api.invalidateMeasurements({ nodes: [{ nodeId: 'node-1' }] });
344
+ * ```
345
+ *
346
+ * @param options - Elements to measure again.
347
+ * @returns A promise that resolves once the new measurements have been applied.
348
+ */
349
+ invalidateMeasurements(options) {
350
+ const entityIds = this.invalidateObservedElements(options);
351
+ if (entityIds.length === 0) {
352
+ return Promise.resolve();
353
+ }
354
+ return this.flowCore.trackMeasurements(entityIds);
355
+ }
356
+ // Re-observes the targeted elements and returns the entity IDs (`node:<id>` / `edge:<id>`) that had observed
357
+ // elements
358
+ invalidateObservedElements(options) {
359
+ const resizeObserver = this.runtime.resizeObserver;
360
+ if (!options) {
361
+ return resizeObserver.invalidateAll();
362
+ }
363
+ const entityIds = [];
364
+ for (const { nodeId } of options.nodes ?? []) {
365
+ entityIds.push(...resizeObserver.invalidateNode(nodeId));
366
+ }
367
+ for (const { edgeId } of options.edges ?? []) {
368
+ entityIds.push(...resizeObserver.invalidateEdgeLabels(edgeId));
369
+ }
370
+ return entityIds;
371
+ }
372
+ manualLinking() {
373
+ void this.flowCore;
374
+ const manualLinking = this.runtime.manualLinking;
375
+ if (!manualLinking) {
376
+ console.warn("[flow-ui-diagram] Manual linking is not available yet.");
377
+ }
378
+ return manualLinking;
379
+ }
380
+ addListener(event, callback, once) {
381
+ const listener = { event, callback, unsubscribe: () => void 0 };
382
+ const handler = once ? (payload) => {
383
+ this.removeListener(listener);
384
+ callback(payload);
385
+ } : callback;
386
+ listener.unsubscribe = this.runtime.on(event, handler);
387
+ this.listeners.push(listener);
388
+ return () => this.removeListener(listener);
389
+ }
390
+ removeListener(listener) {
391
+ const index = this.listeners.indexOf(listener);
392
+ if (index >= 0) {
393
+ this.listeners.splice(index, 1);
394
+ listener.unsubscribe();
395
+ }
396
+ }
397
+ }
398
+
399
+ export { DiagramApi };
@@ -0,0 +1,52 @@
1
+ import { DiagramApiBase } from './diagram-api-base.mjs';
2
+ import { emitWithMeasurementOption } from './emit-with-measurement-option.mjs';
3
+
4
+ class DiagramClipboardApi extends DiagramApiBase {
5
+ /**
6
+ * Copies the selection to the clipboard.
7
+ *
8
+ * Copying a node also copies all of its descendants (including the hidden children of a collapsed group) and
9
+ * the edges between the copied nodes. Selected nodes and edges that are effectively hidden are skipped, as in
10
+ * `deleteSelection()`.
11
+ *
12
+ * A selected edge is copied even when the nodes at its ends are not. {@link DiagramClipboardApi.paste} then
13
+ * recreates it with a free end in place of each node that was not copied.
14
+ *
15
+ * @returns A promise that resolves once the selection has been copied.
16
+ */
17
+ copy() {
18
+ return this.flowCore.commandHandler.emit("copy");
19
+ }
20
+ /**
21
+ * Cuts the selection to the clipboard. It works like {@link DiagramClipboardApi.copy}: cutting a collapsed group
22
+ * also cuts its hidden children, and pasting restores them.
23
+ *
24
+ * @returns A promise that resolves once the change has been applied to the model. Inside a transaction, it
25
+ * resolves right away and the change is applied when the transaction commits.
26
+ */
27
+ cut() {
28
+ return this.flowCore.commandHandler.emit("cut");
29
+ }
30
+ /**
31
+ * Pastes the clipboard content, centered at a position.
32
+ *
33
+ * An edge end whose node was copied together with the edge connects to the pasted copy of the node. An end whose
34
+ * node was **not** copied is pasted as a free end: `source` or `target` is set to `''`, and
35
+ * `sourcePosition` or `targetPosition` holds the last position where the edge was attached, moved together with
36
+ * the pasted content. So pasting a single edge never duplicates the connection between the original nodes.
37
+ * Ends that were already free stay free. Free ends count like node positions when the content is
38
+ * centered, so pasting only edges centers them at `position`. An edge whose free end has no known position (the
39
+ * edge was never routed) is skipped.
40
+ *
41
+ * @param position - Paste position in flow coordinates.
42
+ * @param options - Measurement options. Set `waitForMeasurements` to `true` to resolve only after the pasted
43
+ * elements have been measured. Use this before calling `zoomToFit()` or `centerOnNode()`.
44
+ * @returns A promise that resolves once the change has been applied to the model. Inside a transaction, it
45
+ * resolves right away and the change is applied when the transaction commits.
46
+ */
47
+ paste(position, options) {
48
+ return emitWithMeasurementOption(this.flowCore, "paste", { position }, options);
49
+ }
50
+ }
51
+
52
+ export { DiagramClipboardApi };
@@ -0,0 +1,46 @@
1
+ import { DiagramApiBase } from './diagram-api-base.mjs';
2
+
3
+ class DiagramGroupsApi extends DiagramApiBase {
4
+ /**
5
+ * Adds nodes to a group.
6
+ *
7
+ * @param groupId - Group node ID.
8
+ * @param nodeIds - IDs of the nodes to add.
9
+ * @returns A promise that resolves once the change has been applied to the model. Inside a transaction, it
10
+ * resolves right away and the change is applied when the transaction commits.
11
+ */
12
+ addToGroup(groupId, nodeIds) {
13
+ return this.flowCore.commandHandler.emit("addToGroup", { groupId, nodeIds });
14
+ }
15
+ /**
16
+ * Highlights a group, for example to show where dragged nodes would be dropped.
17
+ *
18
+ * @param groupId - Group node ID.
19
+ * @param nodes - Nodes to highlight as part of the group.
20
+ * @returns A promise that resolves once the change has been applied.
21
+ */
22
+ highlightGroup(groupId, nodes) {
23
+ return this.flowCore.commandHandler.emit("highlightGroup", { groupId, nodes });
24
+ }
25
+ /**
26
+ * Clears every group highlight.
27
+ *
28
+ * @returns A promise that resolves once the change has been applied.
29
+ */
30
+ highlightGroupClear() {
31
+ return this.flowCore.commandHandler.emit("highlightGroupClear");
32
+ }
33
+ /**
34
+ * Removes nodes from a group.
35
+ *
36
+ * @param groupId - Group node ID.
37
+ * @param nodeIds - IDs of the nodes to remove.
38
+ * @returns A promise that resolves once the change has been applied to the model. Inside a transaction, it
39
+ * resolves right away and the change is applied when the transaction commits.
40
+ */
41
+ removeFromGroup(groupId, nodeIds) {
42
+ return this.flowCore.commandHandler.emit("removeFromGroup", { groupId, nodeIds });
43
+ }
44
+ }
45
+
46
+ export { DiagramGroupsApi };