bpmn-js 13.0.3 → 13.0.5

package/dist/bpmn-modeler.development.js

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-modeler v13.0.3
+ * bpmn-js - bpmn-modeler v13.0.5
  *
  * Copyright (c) 2014-present, camunda Services GmbH
  *
@@ -8,7 +8,7 @@
  *
  * Source Code: https://github.com/bpmn-io/bpmn-js
  *
- * Date: 2023-04-24
+ * Date: 2023-05-09
  */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -2704,7 +2704,7 @@
    */
 
   /**
-   * @param {Component[]} elements
+   * @param {Component[] | Component[][]} elements
    *
    * @return {string}
    */
@@ -2741,6 +2741,11 @@
     return [ 'C', p1.x, p1.y, p2.x, p2.y, p3.x, p3.y ];
   }
 
+  /**
+   * @param {Point[]} waypoints
+   * @param {number} [cornerRadius]
+   * @return {Component[][]}
+   */
   function drawPath(waypoints, cornerRadius) {
     const pointCount = waypoints.length;
 
@@ -2804,7 +2809,7 @@
 
   /**
    * @param {Point[]} points
-   * @param {any} [attrs]
+   * @param {number|Object} [attrs]
    * @param {number} [radius]
    *
    * @return {SVGElement}
@@ -2847,10 +2852,19 @@
   }
 
   /**
-   * @typedef {import('../../model/Types').Element} Element
-   * @typedef {import('../../model/Types').Shape} Shape
+   * @typedef {import('../model/Types').Connection} Connection
+   * @typedef {import('../model/Types').Element} Element
+   * @typedef {import('../model/Types').Shape} Shape
    *
    * @typedef {import('../../type/Types').Rect} Rect
+   *
+   * @typedef { {
+   *   allShapes: Record<string, Shape>,
+   *   allConnections: Record<string, Connection>,
+   *   topLevel: Record<string, Element>,
+   *   enclosedConnections: Record<string, Connection>,
+   *   enclosedElements: Record<string, Element>
+   * } } Closure
    */
 
   /**
@@ -2893,14 +2907,14 @@
    * element was added.
    *
    * @param {Object[]} elements
-   * @param {Object} e
-   * @param {boolean} unique
+   * @param {Object} element
+   * @param {boolean} [unique]
    */
-  function add$1(elements, e, unique) {
-    var canAdd = !unique || elements.indexOf(e) === -1;
+  function add$1(elements, element, unique) {
+    var canAdd = !unique || elements.indexOf(element) === -1;
 
     if (canAdd) {
-      elements.push(e);
+      elements.push(element);
     }
 
     return canAdd;
@@ -2913,8 +2927,8 @@
    *
    * Recurse into all elements that are returned by `fn`.
    *
-   * @param {Object|Object[]} elements
-   * @param {Function} fn iterator function called with (element, index, recursionDepth)
+   * @param {Element|Element[]} elements
+   * @param {(element: Element, index: number, depth: number) => Element[] | boolean | undefined} fn
    * @param {number} [depth] maximum recursion depth
    */
   function eachElement(elements, fn, depth) {
@@ -2971,7 +2985,7 @@
    * Return self + ALL children for a number of elements
    *
    * @param {Element[]} elements to query
-   * @param {boolean} allowDuplicates to allow duplicates in the result set
+   * @param {boolean} [allowDuplicates] to allow duplicates in the result set
    *
    * @return {Element[]} the collected elements
    */
@@ -2986,9 +3000,9 @@
    *
    * @param {Element[]} elements
    * @param {boolean} [isTopLevel=true]
-   * @param {Object} [closure]
+   * @param {Closure} [closure]
    *
-   * @return {Object} newClosure
+   * @return {Closure} newClosure
    */
   function getClosure(elements, isTopLevel, closure) {
 
@@ -3167,7 +3181,13 @@
     return filteredElements;
   }
 
-
+  /**
+   * Get the element's type
+   *
+   * @param {Element} element
+   *
+   * @return {'connection' | 'shape' | 'root'}
+   */
   function getType(element) {
 
     if ('waypoints' in element) {
@@ -3181,8 +3201,12 @@
     return 'root';
   }
 
+  /**
+   * @param {Element} element
+   *
+   * @return {boolean}
+   */
   function isFrameElement$1(element) {
-
     return !!(element && element.isFrame);
   }
 
@@ -3325,13 +3349,14 @@
     var self = this;
 
     /**
-     * Builds a style definition from a className, a list of traits and an object of additional attributes.
+     * Builds a style definition from a className, a list of traits and an object
+     * of additional attributes.
      *
      * @param {string} className
-     * @param {string[]} traits
-     * @param {Object} additionalAttrs
+     * @param {string[]} [traits]
+     * @param {Object} [additionalAttrs]
      *
-     * @return {Object} the style defintion
+     * @return {Object} the style definition
      */
     this.cls = function(className, traits, additionalAttrs) {
       var attrs = this.style(traits, additionalAttrs);
@@ -3340,12 +3365,13 @@
     };
 
     /**
-     * Builds a style definition from a list of traits and an object of additional attributes.
+     * Builds a style definition from a list of traits and an object of additional
+     * attributes.
      *
-     * @param {string[]} traits
+     * @param {string[]} [traits]
      * @param {Object} additionalAttrs
      *
-     * @return {Object} the style defintion
+     * @return {Object} the style definition
      */
     this.style = function(traits, additionalAttrs) {
 
@@ -3361,6 +3387,17 @@
       return additionalAttrs ? assign$1(attrs, additionalAttrs) : attrs;
     };
 
+
+    /**
+     * Computes a style definition from a list of traits and an object of
+     * additional attributes, with custom style definition object.
+     *
+     * @param {Object} custom
+     * @param {string[]} [traits]
+     * @param {Object} defaultStyles
+     *
+     * @return {Object} the style definition
+     */
     this.computeStyle = function(custom, traits, defaultStyles) {
       if (!isArray$3(traits)) {
         defaultStyles = traits;
@@ -3409,7 +3446,7 @@
    *
    * @param {Array<Object>} collection
    * @param {Object} element
-   * @param {number} idx
+   * @param {number} [idx]
    */
   function add(collection, element, idx) {
 
@@ -4533,6 +4570,28 @@
 
   var intersectPaths = intersect;
 
+  /**
+   * Checks whether a value is an instance of Connection.
+   *
+   * @param {any} value
+   *
+   * @return {boolean}
+   */
+  function isConnection$4(value) {
+    return isObject(value) && has$1(value, 'waypoints');
+  }
+
+  /**
+   * Checks whether a value is an instance of Label.
+   *
+   * @param {any} value
+   *
+   * @return {boolean}
+   */
+  function isLabel$1(value) {
+    return isObject(value) && has$1(value, 'labelTarget');
+  }
+
   /**
    * @typedef {import('../core/Types').ElementLike} Element
    * @typedef {import('../core/Types').ConnectionLike} Connection
@@ -4543,6 +4602,11 @@
    * @typedef {import('../util/Types').RectTRBL} RectTRBL
    */
 
+  /**
+   * @param {Rect} bounds
+   *
+   * @returns {Rect}
+   */
   function roundBounds(bounds) {
     return {
       x: Math.round(bounds.x),
@@ -4552,7 +4616,11 @@
     };
   }
 
-
+  /**
+   * @param {Point} point
+   *
+   * @returns {Point}
+   */
   function roundPoint(point) {
 
     return {
@@ -4678,7 +4746,7 @@
    * @return {Point}
    */
   function getMid(element) {
-    if (isConnection$f(element)) {
+    if (isConnection$4(element)) {
       return getConnectionMid(element);
     }
 
@@ -4818,10 +4886,6 @@
     return Math.sqrt(Math.pow(a.x - b.x, 2) + Math.pow(a.y - b.y, 2));
   }
 
-  function isConnection$f(element) {
-    return !!element.waypoints;
-  }
-
   /**
    * @typedef {import('./Types').ConnectionLike} ConnectionLike
    * @typedef {import('./Types').RootLike} RootLike
@@ -5386,11 +5450,13 @@
    *
    * @example
    *
+   * ```javascript
    * canvas.addMarker('foo', 'some-marker');
    *
    * const fooGfx = canvas.getGraphics('foo');
    *
    * fooGfx; // <g class="... some-marker"> ... </g>
+   * ```
    *
    * @param {ShapeLike|ConnectionLike|string} element The element or its ID.
    * @param {string} marker The marker.
@@ -5796,7 +5862,7 @@
      *
      * @memberOf Canvas
      *
-     * @event ShapeRemoved
+     * @event ShapeRemovedEvent
      * @type {Object}
      * @property {ShapeLike} element The shape.
      * @property {SVGElement} gfx The graphical element.
@@ -5833,7 +5899,7 @@
      *
      * @memberOf Canvas
      *
-     * @event connection.removed
+     * @event ConnectionRemovedEvent
      * @type {Object}
      * @property {ConnectionLike} element The connection.
      * @property {SVGElement} gfx The graphical element.
@@ -5892,6 +5958,7 @@
    *
    * @example
    *
+   * ```javascript
    * canvas.viewbox({ x: 100, y: 100, width: 500, height: 500 })
    *
    * // sets the visible area of the diagram to (100|100) -> (600|100)
@@ -5919,6 +5986,7 @@
    *   width: zoomedAndScrolledViewbox.outer.width,
    *   height: zoomedAndScrolledViewbox.outer.height
    * });
+   * ```
    *
    * @param {Rect} [box] The viewbox to be set.
    *
@@ -6426,9 +6494,11 @@
    *
    * @example
    *
+   * ```javascript
    * elementRegistry.get('SomeElementId_1');
    *
    * elementRegistry.get(gfx);
+   * ```
    *
    * @param {string|SVGElement} filter The elements ID or graphical representation.
    *
@@ -6522,11 +6592,13 @@
    *
    * @example
    *
+   * ```javascript
    * elementRegistry.getGraphics('SomeElementId_1');
    *
    * elementRegistry.getGraphics(rootElement); // <g ...>
    *
    * elementRegistry.getGraphics(rootElement, true); // <svg ...>
+   * ```
    *
    * @param {ElementLike|string} filter The element or its ID.
    * @param {boolean} [secondary=false] Whether to return the secondary graphical representation.
@@ -7106,7 +7178,7 @@
    *
    * @example
    *
-   * ```
+   * ```javascript
    * import * as Model from 'diagram-js/lib/model';
    *
    * const root = Model.create('root', {
@@ -7122,6 +7194,7 @@
    *
    * @return {Root}
    */
+
   /**
    * Creates a connection.
    *
@@ -7129,7 +7202,7 @@
    *
    * @example
    *
-   * ```
+   * ```javascript
    * import * as Model from 'diagram-js/lib/model';
    *
    * const connection = Model.create('connection', {
@@ -7145,6 +7218,7 @@
    *
    * @return {Connection}
    */
+
   /**
    * Creates a shape.
    *
@@ -7152,7 +7226,7 @@
    *
    * @example
    *
-   * ```
+   * ```javascript
    * import * as Model from 'diagram-js/lib/model';
    *
    * const shape = Model.create('shape', {
@@ -7168,12 +7242,13 @@
    *
    * @return {Shape}
    */
+
   /**
    * Creates a label.
    *
    * @example
    *
-   * ```
+   * ```javascript
    * import * as Model from 'diagram-js/lib/model';
    *
    * const label = Model.create('label', {
@@ -7186,7 +7261,8 @@
    * ```
    *
    * @param {'label'} type
-   * @param {any} [attrs]
+   * @param {Object} [attrs]
+   *
    * @return {Label}
    */
   function create(type, attrs) {
@@ -7201,6 +7277,7 @@
    * Checks whether an object is a model instance.
    *
    * @param {any} obj
+   *
    * @return {boolean}
    */
   function isModelElement(obj) {
@@ -7494,7 +7571,6 @@
     });
   };
 
-
   /**
    * Register an event listener that is called only once.
    *
@@ -7765,7 +7841,7 @@
    *    * after: [ 1500, 1500, (new=1300), 1000, 1000, (new=1000) ]
    *
    * @param {string} event
-   * @param {EventBusListener} listener
+   * @param {EventBusListener} newListener
    */
   EventBus.prototype._addListener = function(event, newListener) {
 
@@ -7920,8 +7996,8 @@
    * @param {SVGElement} gfx
    * @param {number} x
    * @param {number} y
-   * @param {number} angle
-   * @param {number} amount
+   * @param {number} [angle]
+   * @param {number} [amount]
    */
   function transform(gfx, x, y, angle, amount) {
     var translate = createTransform();
@@ -8408,9 +8484,11 @@
      *
      * @example
      *
+     * ```javascript
      * eventBus.on('diagram.init', function() {
      *   eventBus.fire('my-custom-event', { foo: 'BAR' });
      * });
+     * ```
      *
      * @type {Object}
      */
@@ -17901,7 +17979,7 @@
    * @return {boolean}
    */
   function hasExternalLabel(element) {
-    return isLabel$5(element.label);
+    return isLabel(element.label);
   }
 
   /**
@@ -18029,15 +18107,15 @@
    *
    * @return {boolean}
    */
-  function isLabel$5(element) {
+  function isLabel(element) {
     return element && !!element.labelTarget;
   }
 
-
   /**
-   * @typedef { import('../model').DiagramElement } DiagramElement
+   * @param {ModdleElement} semantic
+   *
+   * @returns {string}
    */
-
   function getLabelAttr(semantic) {
     if (
       is$1(semantic, 'bpmn:FlowElement') ||
@@ -18060,6 +18138,11 @@
     }
   }
 
+  /**
+   * @param {ModdleElement} semantic
+   *
+   * @returns {string}
+   */
   function getCategoryValue(semantic) {
     var categoryValueRef = semantic['categoryValueRef'];
 
@@ -18072,9 +18155,9 @@
   }
 
   /**
-   * @param {DiagramElement} element
+   * @param {Element} element
    *
-   * @return {string} label
+   * @return {string}
    */
   function getLabel(element) {
     var semantic = element.businessObject,
@@ -18093,10 +18176,10 @@
 
 
   /**
-   * @param {DiagramElement} element
+   * @param {Element} element
    * @param {string} text
    *
-   * @return {DiagramElement} element
+   * @return {Element}
    */
   function setLabel(element, text) {
     var semantic = element.businessObject,
@@ -18161,7 +18244,7 @@
   // color access //////////////////////
 
   /**
-   * @param {DiagramElement} element
+   * @param {Element} element
    * @param {string} [defaultColor]
    *
    * @return {string}
@@ -18173,7 +18256,7 @@
   }
 
   /**
-   * @param {DiagramElement} element
+   * @param {Element} element
    * @param {string} [defaultColor]
    *
    * @return {string}
@@ -18185,9 +18268,9 @@
   }
 
   /**
-   * @param {DiagramElement} element
-   * @param {string} defaultColor
-   * @param {string} defaultStrokeColor
+   * @param {Element} element
+   * @param {string} [defaultColor]
+   * @param {string} [defaultStrokeColor]
    *
    * @return {string}
    */
@@ -18318,7 +18401,7 @@
    */
 
   /**
-   * @typedef { import('../model').DiagramElement } DiagramElement
+   * @typedef { import('../model/Types').Element } Element
    */
 
   /**
@@ -20159,7 +20242,7 @@
 
 
   /**
-   * @param {DiagramElement} element
+   * @param {Element} element
    *
    * @return {boolean}
    */
@@ -20171,7 +20254,7 @@
    * Draw shape into parentGfx.
    *
    * @param {SVGElement} parentGfx
-   * @param {DiagramElement} element
+   * @param {Element} element
    *
    * @return {SVGElement} mainGfx
    */
@@ -20187,7 +20270,7 @@
    * Draw connection into parentGfx.
    *
    * @param {SVGElement} parentGfx
-   * @param {DiagramElement} element
+   * @param {Element} element
    *
    * @return {SVGElement} mainGfx
    */
@@ -20202,7 +20285,7 @@
   /**
    * Get shape path.
    *
-   * @param {DiagramElement} element
+   * @param {Element} element
    *
    * @return {string} path
    */
@@ -20244,7 +20327,7 @@
    *
    * @typedef { Partial<{
    *   align: AlignmentConfig;
-   *   style: Record<string, any>;
+   *   style: Record<string, number | string>;
    *   padding: PaddingConfig;
    * }> } BaseTextConfig
    *
@@ -20351,6 +20434,8 @@
    * Alters the lines passed.
    *
    * @param {string[]} lines
+   * @param {number} maxWidth
+   * @param {SVGTextElement} fakeText
    *
    * @return {LineDescriptor} the line descriptor
    */
@@ -21683,6 +21768,10 @@
     ]
   };
 
+  /**
+   * @typedef {import('../util/Types').Point} Point
+   */
+
   function __stopPropagation(event) {
     if (!event || typeof event.stopPropagation !== 'function') {
       return;
@@ -21691,18 +21780,28 @@
     event.stopPropagation();
   }
 
-
+  /**
+   * @param {import('../core/EventBus').Event} event
+   *
+   * @return {Event}
+   */
   function getOriginal$1(event) {
     return event.originalEvent || event.srcEvent;
   }
 
-
-  function stopPropagation$1(event, immediate) {
+  /**
+   * @param {Event|import('../core/EventBus').Event} event
+   */
+  function stopPropagation$1(event) {
     __stopPropagation(event);
     __stopPropagation(getOriginal$1(event));
   }
 
-
+  /**
+   * @param {Event} event
+   *
+   * @return {Point|null}
+   */
   function toPoint(event) {
 
     if (event.pointers && event.pointers.length) {
@@ -21723,22 +21822,43 @@
     return (/mac/i).test(navigator.platform);
   }
 
+  /**
+   * @param {MouseEvent} event
+   * @param {string} button
+   *
+   * @return {boolean}
+   */
   function isButton(event, button) {
     return (getOriginal$1(event) || event).button === button;
   }
 
+  /**
+   * @param {MouseEvent} event
+   *
+   * @return {boolean}
+   */
   function isPrimaryButton(event) {
 
     // button === 0 -> left áka primary mouse button
     return isButton(event, 0);
   }
 
+  /**
+   * @param {MouseEvent} event
+   *
+   * @return {boolean}
+   */
   function isAuxiliaryButton(event) {
 
     // button === 1 -> auxiliary áka wheel button
     return isButton(event, 1);
   }
 
+  /**
+   * @param {MouseEvent} event
+   *
+   * @return {boolean}
+   */
   function hasPrimaryModifier(event) {
     var originalEvent = getOriginal$1(event) || event;
 
@@ -21754,7 +21874,11 @@
     }
   }
 
-
+  /**
+   * @param {MouseEvent} event
+   *
+   * @return {boolean}
+   */
   function hasSecondaryModifier(event) {
     var originalEvent = getOriginal$1(event) || event;
 
@@ -22773,7 +22897,7 @@
    *
    * The ids can be customized via a given prefix and contain a random value to avoid collisions.
    *
-   * @param {string} prefix a prefix to prepend to generated ids (for better readability)
+   * @param {string} [prefix] a prefix to prepend to generated ids (for better readability)
    */
   function IdGenerator(prefix) {
 
@@ -23881,6 +24005,7 @@
 
   /**
    * @param {string} str
+   *
    * @return {string}
    */
   function escapeCSS(str) {
@@ -23895,6 +24020,11 @@
     '\'': '&#39;'
   };
 
+  /**
+   * @param {string} str
+   *
+   * @return {string}
+   */
   function escapeHTML(str) {
     str = '' + str;
 
@@ -24775,6 +24905,7 @@
 
   /**
    * @param {KeyboardEvent} event
+   * @return {boolean}
    */
   function isCmd(event) {
 
@@ -24792,6 +24923,7 @@
    *
    * @param {string|string[]} keys
    * @param {KeyboardEvent} event
+   * @return {boolean}
    */
   function isKey(keys, event) {
     keys = isArray$3(keys) ? keys : [ keys ];
@@ -24806,18 +24938,30 @@
     return event.shiftKey;
   }
 
+  /**
+   * @param {KeyboardEvent} event
+   */
   function isCopy(event) {
     return isCmd(event) && isKey(KEYS_COPY, event);
   }
 
+  /**
+   * @param {KeyboardEvent} event
+   */
   function isPaste(event) {
     return isCmd(event) && isKey(KEYS_PASTE, event);
   }
 
+  /**
+   * @param {KeyboardEvent} event
+   */
   function isUndo(event) {
     return isCmd(event) && !isShift(event) && isKey(KEYS_UNDO, event);
   }
 
+  /**
+   * @param {KeyboardEvent} event
+   */
   function isRedo(event) {
     return isCmd(event) && (
       isKey(KEYS_REDO, event) || (
@@ -24828,6 +24972,8 @@
 
   /**
    * @typedef {import('../../core/EventBus').default} EventBus
+   *
+   * @typedef {({ keyEvent: KeyboardEvent }) => any} Listener
    */
 
   var KEYDOWN_EVENT = 'keyboard.keydown',
@@ -24859,6 +25005,7 @@
    * `keyboard.bindTo` configuration option.
    *
    * @param {Object} config
+   * @param {EventTarget} [config.bindTo]
    * @param {EventBus} eventBus
    */
   function Keyboard(config, eventBus) {
@@ -24950,6 +25097,11 @@
     return modifierContainer.getAttribute(HANDLE_MODIFIER_ATTRIBUTE).split(',');
   };
 
+  /**
+   * Bind keyboard events to the given DOM node.
+   *
+   * @param {EventTarget} node
+   */
   Keyboard.prototype.bind = function(node) {
 
     // make sure that the keyboard is only bound once to the DOM
@@ -24964,6 +25116,9 @@
     this._fire('bind');
   };
 
+  /**
+   * @return {EventTarget}
+   */
   Keyboard.prototype.getBinding = function() {
     return this._node;
   };
@@ -24982,6 +25137,9 @@
     this._node = null;
   };
 
+  /**
+   * @param {string} event
+   */
   Keyboard.prototype._fire = function(event) {
     this._eventBus.fire('keyboard.' + event, { node: this._node });
   };
@@ -24992,8 +25150,8 @@
    * provided, the default value of 1000 is used.
    *
    * @param {number} [priority]
-   * @param {Function} listener
-   * @param {string} type
+   * @param {Listener} listener
+   * @param {string} [type='keyboard.keydown']
    */
   Keyboard.prototype.addListener = function(priority, listener, type) {
     if (isFunction(priority)) {
@@ -25005,6 +25163,12 @@
     this._eventBus.on(type || KEYDOWN_EVENT, priority, listener);
   };
 
+  /**
+   * Remove a listener function.
+   *
+   * @param {Listener} listener
+   * @param {string} [type='keyboard.keydown']
+   */
   Keyboard.prototype.removeListener = function(listener, type) {
     this._eventBus.off(type || KEYDOWN_EVENT, listener);
   };
@@ -25277,15 +25441,21 @@
       }
     }
 
-    this.moveCanvas = function(opts) {
+    /**
+     * @param {{
+     *   direction: 'up' | 'down' | 'left' | 'right';
+     *   speed: number;
+     * }} options
+     */
+    this.moveCanvas = function(options) {
 
       var dx = 0,
           dy = 0,
-          speed = opts.speed;
+          speed = options.speed;
 
       var actualSpeed = speed / Math.min(Math.sqrt(canvas.viewbox().scale), 1);
 
-      switch (opts.direction) {
+      switch (options.direction) {
       case 'left': // Left
         dx = actualSpeed;
         break;
@@ -25328,7 +25498,9 @@
 
   var CURSOR_CLS_PATTERN = /^djs-cursor-.*$/;
 
-
+  /**
+   * @param {string} mode
+   */
   function set(mode) {
     var classes = classes$1(document.body);
 
@@ -25343,12 +25515,19 @@
     set(null);
   }
 
+  /**
+   * @typedef {import('../core/EventBus').EventBus} EventBus
+   */
+
   var TRAP_PRIORITY = 5000;
 
   /**
    * Installs a click trap that prevents a ghost click following a dragging operation.
    *
-   * @return {Function} a function to immediately remove the installed trap.
+   * @param {EventBus} eventBus
+   * @param {string} [eventName='element.click']
+   *
+   * @return {() => void} a function to immediately remove the installed trap.
    */
   function install(eventBus, eventName) {
 
@@ -25365,6 +25544,15 @@
     };
   }
 
+  /**
+   * @typedef {import('../util/Types').Point} Point
+   * @typedef {import('../util/Types').Rect} Rect
+   */
+
+  /**
+   * @param {Rect} bounds
+   * @return {Point}
+   */
   function center(bounds) {
     return {
       x: bounds.x + (bounds.width / 2),
@@ -25373,6 +25561,11 @@
   }
 
 
+  /**
+   * @param {Point} a
+   * @param {Point} b
+   * @return {Point}
+   */
   function delta(a, b) {
     return {
       x: a.x - b.x,
@@ -25521,6 +25714,7 @@
    * @param {Object} range
    * @param {number} range.min
    * @param {number} range.max
+   * @param {number} steps
    */
   function getStepSize(range, steps) {
 
@@ -25532,6 +25726,12 @@
     return absoluteLinearRange / steps;
   }
 
+  /**
+   * @param {Object} range
+   * @param {number} range.min
+   * @param {number} range.max
+   * @param {number} scale
+   */
   function cap(range, scale) {
     return Math.max(range.min, Math.min(range.max, scale));
   }
@@ -29588,16 +29788,20 @@
 
   function r(e){var t,f,n="";if("string"==typeof e||"number"==typeof e)n+=e;else if("object"==typeof e)if(Array.isArray(e))for(t=0;t<e.length;t++)e[t]&&(f=r(e[t]))&&(n&&(n+=" "),n+=f);else for(t in e)e[t]&&(n&&(n+=" "),n+=t);return n}function clsx(){for(var e,t,f=0,n="";f<arguments.length;)(e=arguments[f++])&&(t=r(e))&&(n&&(n+=" "),n+=t);return n}
 
+  /**
+   * @typedef {import('./PopupMenuProvider').PopupMenuEntry} PopupMenuEntry
+   */
+
   /**
    * Component that renders a popup menu entry.
    *
    * @param {Object} props
    * @param {string} props.key
-   * @param {Object} props.entry
+   * @param {PopupMenuEntry} props.entry
    * @param {boolean} props.selected
-   * @param {Function} props.onMouseEnter
-   * @param {Function} props.onMouseLeave
-   * @param {Function} props.onAction
+   * @param {(event: MouseEvent) => void} props.onMouseEnter
+   * @param {(event: MouseEvent) => void} props.onMouseLeave
+   * @param {(event: MouseEvent, entry?: PopupMenuEntry, action?: string) => void} props.onAction
    */
   function PopupMenuItem(props) {
     const {
@@ -29661,15 +29865,17 @@
   `;
   }
 
+  /**
+   * @typedef {import('./PopupMenuProvider').PopupMenuEntry} PopupMenuEntry
+   */
+
   /**
    * Component that renders a popup menu entry list.
    *
    * @param {Object} props
-   * @param {Array} props.entries
-   * @param {Object} props.selectedEntry
-   * @param {Function} props.setSelectedEntry
-   * @param {Function} props.onAction
-   * @param {Object} props.resultsRef
+   * @param {PopupMenuEntry[]} props.entries
+   * @param {PopupMenuEntry} props.selectedEntry
+   * @param {(entry: PopupMenuEntry | null) => void} props.setSelectedEntry
    */
   function PopupMenuList(props) {
     const {
@@ -29763,15 +29969,22 @@
     }
   }
 
+  /**
+   * @typedef {import('./PopupMenuProvider').PopupMenuEntry} PopupMenuEntry
+   * @typedef {import('./PopupMenuProvider').PopupMenuHeaderEntry} PopupMenuHeaderEntry
+   *
+   * @typedef {import('../../util/Types').Point} Point
+   */
+
   /**
    * A component that renders the popup menus.
    *
    * @param {Object} props
-   * @param {function} props.onClose
-   * @param {function} props.position
+   * @param {() => void} props.onClose
+   * @param {(element: HTMLElement) => Point} props.position
    * @param {string} props.className
-   * @param {Array} props.entries
-   * @param {Array} props.headerEntries
+   * @param {PopupMenuEntry[]} props.entries
+   * @param {PopupMenuHeaderEntry[]} props.headerEntries
    * @param {number} props.scale
    * @param {string} [props.title]
    * @param {boolean} [props.search]
@@ -30585,7 +30798,7 @@
       let element = closest(event.delegateTarget || event.target, '.entry', true);
       let entryId = attr$1(element, DATA_REF);
 
-      entry = this._getEntry(entryId);
+      entry = { id: entryId, ...this._getEntry(entryId) };
     }
 
     const handler = entry.action;
@@ -30988,6 +31201,8 @@
   };
 
   /**
+   * @typedef {import('../../model/Types').Connection} Connection
+   * @typedef {import('../../model/Types').Element} Element
    * @typedef {import('../../model/Types').Shape} Shape
    *
    * @typedef {import('../../util/Types').Point} Point
@@ -31007,7 +31222,7 @@
    * @param {Shape} source
    * @param {Shape} element
    * @param {Point} position
-   * @param {Function} getNextPosition
+   * @param {(element: Element, position: Point, connectedAtPosition: Element) => Element} getNextPosition
    *
    * @return {Point}
    */
@@ -31028,7 +31243,7 @@
    * @param {Object} [nextPositionDirection.x]
    * @param {Object} [nextPositionDirection.y]
    *
-   * @return {Function}
+   * @return {(element: Element, previousPosition: Point, connectedAtPosition: Element) => Point}
    */
   function generateGetNextPosition(nextPositionDirection) {
     return function(element, previousPosition, connectedAtPosition) {
@@ -31104,8 +31319,8 @@
   * @param {Object} [hints]
   * @param {number} [hints.defaultDistance]
   * @param {string} [hints.direction]
-  * @param {Function} [hints.filter]
-  * @param {Function} [hints.getWeight]
+  * @param {(connection: Connection) => boolean} [hints.filter]
+  * @param {(connection: Connection) => number} [hints.getWeight]
   * @param {number} [hints.maxDistance]
   * @param {string} [hints.reference]
   *
@@ -31556,7 +31771,7 @@
       y: sourceTrbl.top - 50 - element.height / 2
     };
 
-    if (isConnection$e(source)) {
+    if (isConnection$3(source)) {
       position = getMid(source);
       position.x += 100;
       position.y -= 50;
@@ -31601,7 +31816,7 @@
     return findFreePosition(source, element, position, generateGetNextPosition(nextPositionDirection));
   }
 
-  function isConnection$e(element) {
+  function isConnection$3(element) {
     return !!element.waypoints;
   }
 
@@ -32042,7 +32257,7 @@
 
     forEach$1(elements, function(element) {
 
-      if (is$1(element, 'bpmn:Lane') || isLabel$5(element)) {
+      if (is$1(element, 'bpmn:Lane') || isLabel(element)) {
         canResize = false;
         return;
       }
@@ -32309,6 +32524,7 @@
    *
    * @example
    *
+   * ```javascript
    * function MyDragComponent(eventBus, dragging) {
    *
    *   eventBus.on('mydrag.start', function(event) {
@@ -32336,6 +32552,7 @@
    *     });
    *   });
    * }
+   * ```
    *
    * @param {EventBus} eventBus
    * @param {Canvas} canvas
@@ -32645,7 +32862,7 @@
      * relative to it.
      *
      * @param {MouseEvent|TouchEvent} [event]
-     * @param {Point} [localPosition] actual diagram local position this drag operation should start at
+     * @param {Point} [relativeTo] actual diagram local position this drag operation should start at
      * @param {string} prefix
      * @param {Object} [options]
      */
@@ -33011,6 +33228,12 @@
 
   /**
    * @typedef {import('../util/Types').Point} Point
+   *
+   * @typedef { {
+   *   bendpoint?: boolean;
+   *   index: number;
+   *   point: Point;
+   * } } Intersection
    */
 
   var round$9 = Math.round,
@@ -33043,6 +33266,12 @@
 
   var INTERSECTION_THRESHOLD$1 = 10;
 
+  /**
+   * @param {Point[]} waypoints
+   * @param {Point} reference
+   *
+   * @return {Intersection|null}
+   */
   function getBendpointIntersection(waypoints, reference) {
 
     var i, w;
@@ -33061,6 +33290,12 @@
     return null;
   }
 
+  /**
+   * @param {Point[]} waypoints
+   * @param {Point} reference
+   *
+   * @return {Intersection|null}
+   */
   function getPathIntersection(waypoints, reference) {
 
     var intersections = intersectPaths(circlePath(reference, INTERSECTION_THRESHOLD$1), linePath(waypoints));
@@ -33115,7 +33350,7 @@
    * @param {Point[]} waypoints
    * @param {Point} reference
    *
-   * @return {Object} intersection data (segment, point)
+   * @return {Intersection|null}
    */
   function getApproxIntersection(waypoints, reference) {
     return getBendpointIntersection(waypoints, reference) || getPathIntersection(waypoints, reference);
@@ -35036,7 +35271,7 @@
           hoverMid = hover && getSnapPoint(hover, event);
 
       // only snap on connections, elements can have multiple connect endpoints
-      if (!isConnection$d(hover) || !hoverMid || !hoverMid.x || !hoverMid.y) {
+      if (!isConnection$4(hover) || !hoverMid || !hoverMid.x || !hoverMid.y) {
         return;
       }
 
@@ -35088,13 +35323,6 @@
 
   BendpointSnapping.$inject = [ 'eventBus' ];
 
-
-  // helpers //////////////////////
-
-  function isConnection$d(element) {
-    return element && !!element.waypoints;
-  }
-
   /**
    * @type { import('didi').ModuleDeclaration }
    */
@@ -36621,11 +36849,11 @@
       elements = filter(elements, function(element) {
         var labelTarget = element.labelTarget;
 
-        return !element.parent && !(isLabel$4(element) && elements.indexOf(labelTarget) !== -1);
+        return !element.parent && !(isLabel$1(element) && elements.indexOf(labelTarget) !== -1);
       });
 
       var shape = find(elements, function(element) {
-        return !isConnection$c(element);
+        return !isConnection$4(element);
       });
 
       var attach = false,
@@ -36780,7 +37008,7 @@
 
         // update shape
         shape = find(elements, function(element) {
-          return !isConnection$c(element);
+          return !isConnection$4(element);
         });
       }
 
@@ -36821,7 +37049,7 @@
       }
 
       var shape = find(elements, function(element) {
-        return !isConnection$c(element);
+        return !isConnection$4(element);
       });
 
       if (!shape) {
@@ -36855,7 +37083,7 @@
 
       // center elements around cursor
       forEach$1(elements, function(element) {
-        if (isConnection$c(element)) {
+        if (isConnection$4(element)) {
           element.waypoints = map$1(element.waypoints, function(waypoint) {
             return {
               x: waypoint.x - bbox.x - bbox.width / 2,
@@ -36917,16 +37145,8 @@
     }
   }
 
-  function isConnection$c(element) {
-    return !!element.waypoints;
-  }
-
   function isSingleShape(elements) {
-    return elements && elements.length === 1 && !isConnection$c(elements[0]);
-  }
-
-  function isLabel$4(element) {
-    return !!element.labelTarget;
+    return elements && elements.length === 1 && !isConnection$4(elements[ 0 ]);
   }
 
   /**
@@ -37259,7 +37479,7 @@
       }
 
       // connections (priority = 3)
-      if (isConnection$b(element)) {
+      if (isConnection$4(element)) {
         descriptor.priority = 3;
 
         descriptor.source = element.source.id;
@@ -37269,7 +37489,7 @@
       }
 
       // labels (priority = 4)
-      if (isLabel$3(element)) {
+      if (isLabel$1(element)) {
         descriptor.priority = 4;
 
         descriptor.labelTarget = element.labelTarget.id;
@@ -37402,7 +37622,7 @@
 
     // center elements around cursor
     forEach$1(elements, function(element) {
-      if (isConnection$b(element)) {
+      if (isConnection$4(element)) {
         element.waypoints = map$1(element.waypoints, function(waypoint) {
           return {
             x: waypoint.x - bbox.x - bbox.width / 2,
@@ -37455,7 +37675,7 @@
 
         var element;
 
-        if (isConnection$b(attrs)) {
+        if (isConnection$4(attrs)) {
           attrs.source = cache[ descriptor.source ];
           attrs.target = cache[ descriptor.target ];
 
@@ -37466,7 +37686,7 @@
           return;
         }
 
-        if (isLabel$3(attrs)) {
+        if (isLabel$1(attrs)) {
           attrs.labelTarget = cache[ attrs.labelTarget ];
 
           element = cache[ descriptor.id ] = self.createLabel(attrs);
@@ -37521,7 +37741,7 @@
         source,
         target;
 
-    if (isConnection$b(element)) {
+    if (isConnection$4(element)) {
       source = find(elements, matchPattern({ id: element.source.id }));
       target = find(elements, matchPattern({ id: element.target.id }));
 
@@ -37530,7 +37750,7 @@
       }
     }
 
-    if (isLabel$3(element)) {
+    if (isLabel$1(element)) {
       labelTarget = find(elements, matchPattern({ id: element.labelTarget.id }));
 
       if (!labelTarget) {
@@ -37545,6 +37765,8 @@
    * Create a tree-like structure from elements.
    *
    * @example
+   *
+   * ```javascript
    * tree: {
    *  0: [
    *    { id: 'Shape_1', priority: 1, ... },
@@ -37557,6 +37779,7 @@
    *    ...
    *  ]
    * };
+   * ```
    *
    * @param {Element[]} elements
    *
@@ -37620,7 +37843,7 @@
     eachElement(parents, function(element, _index, depth) {
 
       // do NOT add external labels directly
-      if (isLabel$3(element)) {
+      if (isLabel$1(element)) {
         return;
       }
 
@@ -37718,14 +37941,6 @@
     return !!element.host;
   }
 
-  function isConnection$b(element) {
-    return !!element.waypoints;
-  }
-
-  function isLabel$3(element) {
-    return !!element.labelTarget;
-  }
-
   function copyWaypoints$1(element) {
     return map$1(element.waypoints, function(waypoint) {
 
@@ -37809,7 +38024,7 @@
 
       // do not copy business object + di for labels;
       // will be pulled from the referenced label target
-      if (isLabel$5(element)) {
+      if (isLabel(element)) {
         return descriptor;
       }
 
@@ -37877,7 +38092,7 @@
           di = descriptor.di;
 
       // wire existing di + businessObject for external label
-      if (isLabel$5(descriptor)) {
+      if (isLabel(descriptor)) {
         descriptor.businessObject = getBusinessObject(cache[ descriptor.labelTarget ]);
         descriptor.di = getDi(cache[ descriptor.labelTarget ]);
 
@@ -41208,18 +41423,24 @@
   };
 
   /**
-   * @typedef {Object} Range
-   * @property {number} min
-   * @property {number} max
-   */
-
-  /**
+   * @typedef {import('../../model/Types').Element} Element
+   *
    * @typedef {import('../../util/Types').Axis} Axis
    * @typedef {import('../../util/Types').Dimension} Dimension
    * @typedef {import('../../util/Types').Rect} Rect
    *
    * @typedef {import('../modeling/Modeling').default} Modeling
    * @typedef {import('../rules/Rules').default} Rules
+   *
+   * @typedef { {
+   *   min: number;
+   *   max: number;
+   * } } Range
+   *
+   * @typedef { {
+   *   elements: Element[];
+   *   range: Range;
+   * } } Group
    */
 
   var AXIS_DIMENSIONS = {
@@ -41259,7 +41480,7 @@
    * Registers filter functions that allow external parties to filter
    * out certain elements.
    *
-   * @param {Function} filterFn
+   * @param {(distributableElements: Element[], axis: Axis, dimension: Dimension) => Element[]} filterFn
    */
   DistributeElements$1.prototype.registerFilter = function(filterFn) {
     if (typeof filterFn !== 'function') {
@@ -41272,7 +41493,7 @@
   /**
    * Distributes the elements with a given orientation
    *
-   * @param {Array} elements
+   * @param {Element[]} elements
    * @param {string} orientation
    */
   DistributeElements$1.prototype.trigger = function(elements, orientation) {
@@ -41304,9 +41525,9 @@
   /**
    * Filters the elements with provided filters by external parties
    *
-   * @param {Array[Elements]} elements
+   * @param {Element[]} elements
    *
-   * @return {Array[Elements]}
+   * @return {Element[]}
    */
   DistributeElements$1.prototype._filterElements = function(elements) {
     var filters = this._filters,
@@ -41331,19 +41552,19 @@
    * together that share the same range.
    *
    * @example
-   * 	var distributableElements = [
-   * 		{
-   * 			range: {
-   * 				min: 100,
-   * 				max: 200
-   * 			},
-   * 			elements: [ { id: 'shape1', .. }]
-   * 		}
-   * 	]
    *
-   * @param {Array} elements
+   * ```javascript
+   *   const groups = [
+   *     {
+   *       range: { min: 100, max: 200 },
+   *       elements: [ { id: 'shape1', ... } ]
+   *     }
+   *   ]
+   * ```
    *
-   * @return {Array[Objects]}
+   * @param {Element[]} elements
+   *
+   * @return {Group[]}
    */
   DistributeElements$1.prototype._createGroups = function(elements) {
     var rangeGroups = [],
@@ -41378,9 +41599,9 @@
 
 
   /**
-   * Maps a direction to the according axis and dimension
+   * Maps a direction to the according axis and dimension.
    *
-   * @param {string} direction 'horizontal' or 'vertical'
+   * @param {'horizontal' | 'vertical'} direction 'horizontal' or 'vertical'
    */
   DistributeElements$1.prototype._setOrientation = function(direction) {
     var orientation = AXIS_DIMENSIONS[direction];
@@ -41391,10 +41612,10 @@
 
 
   /**
-   * Checks if the two ranges intercept each other
+   * Checks if the two ranges intercept each other.
    *
-   * @param {Object} rangeA {min, max}
-   * @param {Object} rangeB {min, max}
+   * @param {Range} rangeA
+   * @param {Range} rangeB
    *
    * @return {boolean}
    */
@@ -41407,9 +41628,7 @@
   /**
    * Returns the min and max values for an element
    *
-   * @param {Rect} element
-   * @param {Axis} axis
-   * @param {Dimension} dimension
+   * @param {Element} element
    *
    * @return {Range}
    */
@@ -41773,7 +41992,8 @@
    * The key of the object will be the name of the action.
    *
    * @example
-   * ´´´
+   *
+   * ```javascript
    * var actions = {
    *   spaceTool: function() {
    *     spaceTool.activateSelection();
@@ -41786,7 +42006,7 @@
    * editorActions.register(actions);
    *
    * editorActions.isRegistered('spaceTool'); // true
-   * ´´´
+   * ```
    *
    * @param {Object} actions
    */
@@ -43953,7 +44173,7 @@
   ResizeHandles.prototype.addResizer = function(element) {
     var self = this;
 
-    if (isConnection$a(element) || !this._resize.canResize({ shape: element })) {
+    if (isConnection$4(element) || !this._resize.canResize({ shape: element })) {
       return;
     }
 
@@ -44005,10 +44225,6 @@
     return offset;
   }
 
-  function isConnection$a(element) {
-    return !!element.waypoints;
-  }
-
   /**
    * @type { import('didi').ModuleDeclaration }
    */
@@ -44368,7 +44584,7 @@
     // external label not yet created
     if (isLabelExternal(target)
         && !hasExternalLabel(target)
-        && !isLabel$5(target)) {
+        && !isLabel(target)) {
 
       var externalLabelMid = getExternalLabelMid(element);
 
@@ -45045,7 +45261,7 @@
   }
 
   function shouldReplace$1(shape, host) {
-    return !isLabel$5(shape) &&
+    return !isLabel(shape) &&
       isAny(shape, [ 'bpmn:IntermediateThrowEvent', 'bpmn:IntermediateCatchEvent' ]) && !!host;
   }
 
@@ -45222,8 +45438,8 @@
       // ignore connections, groups and labels
       var children = rootElement.children.filter(function(element) {
         return !is$1(element, 'bpmn:Group') &&
-          !isLabel$5(element) &&
-          !isConnection$9(element);
+          !isLabel(element) &&
+          !isConnection$2(element);
       });
 
       // ensure for available children to calculate bounds
@@ -45394,7 +45610,7 @@
     };
   }
 
-  function isConnection$9(element) {
+  function isConnection$2(element) {
     return !!element.waypoints;
   }
 
@@ -46002,7 +46218,7 @@
   }
 
   function shouldReplace(shape, host) {
-    return !isLabel$5(shape) && is$1(shape, 'bpmn:BoundaryEvent') && !host;
+    return !isLabel(shape) && is$1(shape, 'bpmn:BoundaryEvent') && !host;
   }
 
   function includes$6(array, item) {
@@ -47709,7 +47925,7 @@
 
       var element = context.shape || context.connection;
 
-      if (isLabel$5(element) || !isLabelExternal(element)) {
+      if (isLabel(element) || !isLabelExternal(element)) {
         return;
       }
 
@@ -50248,7 +50464,7 @@
           shape = context.shape,
           shapeBo = shape.businessObject;
 
-      if (isLabel$5(shape)) {
+      if (isLabel(shape)) {
         return;
       }
 
@@ -50697,12 +50913,12 @@
           position = context.position,
           target = context.target;
 
-      if (isConnection$8(target) && !canInsert(elements, target)) {
+      if (isConnection$1(target) && !canInsert(elements, target)) {
         return false;
       }
 
       return every(elements, function(element) {
-        if (isConnection$8(element)) {
+        if (isConnection$1(element)) {
           return canConnect(element.source, element.target, element);
         }
 
@@ -50811,7 +51027,7 @@
    * @return {boolean}
    */
   function nonExistingOrLabel(element) {
-    return !element || isLabel$5(element);
+    return !element || isLabel(element);
   }
 
   function isSame$1(a, b) {
@@ -51050,7 +51266,7 @@
    *
    * @return {boolean}
    */
-  function isConnection$8(element) {
+  function isConnection$1(element) {
     return element.waypoints;
   }
 
@@ -51144,7 +51360,7 @@
   function canDrop(element, target) {
 
     // can move labels and groups everywhere
-    if (isLabel$5(element) || isGroup(element)) {
+    if (isLabel(element) || isGroup(element)) {
       return true;
     }
 
@@ -51234,7 +51450,7 @@
    * @return {boolean}
    */
   function isBoundaryEvent(element) {
-    return !isLabel$5(element) && is$1(element, 'bpmn:BoundaryEvent');
+    return !isLabel(element) && is$1(element, 'bpmn:BoundaryEvent');
   }
 
   /**
@@ -51343,7 +51559,7 @@
     var element = elements[0];
 
     // do not attach labels
-    if (isLabel$5(element)) {
+    if (isLabel(element)) {
       return false;
     }
 
@@ -51515,7 +51731,7 @@
       return false;
     }
 
-    if (isLabel$5(shape) || isGroup(shape)) {
+    if (isLabel(shape) || isGroup(shape)) {
       return true;
     }
 
@@ -51696,7 +51912,7 @@
     // return true if shape can be inserted into connection parent
     return (
       isAny(connection, [ 'bpmn:SequenceFlow', 'bpmn:MessageFlow' ]) &&
-      !isLabel$5(connection) &&
+      !isLabel(connection) &&
       is$1(shape, 'bpmn:FlowNode') &&
       !is$1(shape, 'bpmn:BoundaryEvent') &&
       canDrop(shape, connection.parent));
@@ -51719,7 +51935,7 @@
    * @return {boolean}
    */
   function canCopy(elements, element) {
-    if (isLabel$5(element)) {
+    if (isLabel(element)) {
       return true;
     }
 
@@ -52627,12 +52843,12 @@
     }
 
     forEach$1(elements, function(element) {
-      if (!element.parent || isLabel$2(element)) {
+      if (!element.parent || isLabel$1(element)) {
         return;
       }
 
       // handle connections separately
-      if (isConnection$7(element)) {
+      if (isConnection$4(element)) {
         connections.push(element);
 
         return;
@@ -52803,15 +53019,15 @@
 
       // find children that are not moving or resizing
       var nonMovingResizingChildren = filter(children, function(child) {
-        return !isConnection$7(child) &&
-          !isLabel$2(child) &&
+        return !isConnection$4(child) &&
+          !isLabel$1(child) &&
           !includes$3(movingShapes, child) &&
           !includes$3(resizingShapes, child);
       });
 
       // find children that are moving
       var movingChildren = filter(children, function(child) {
-        return !isConnection$7(child) && !isLabel$2(child) && includes$3(movingShapes, child);
+        return !isConnection$4(child) && !isLabel$1(child) && includes$3(movingShapes, child);
       });
 
       var minOrMax,
@@ -52945,14 +53161,6 @@
     return !!element.host;
   }
 
-  function isConnection$7(element) {
-    return !!element.waypoints;
-  }
-
-  function isLabel$2(element) {
-    return !!element.labelTarget;
-  }
-
   var MARKER_DRAGGING$1 = 'djs-dragging',
       MARKER_RESIZING = 'djs-resizing';
 
@@ -53111,7 +53319,7 @@
             });
           });
 
-          return isConnection$6(element)
+          return isConnection$4(element)
             && (sourceIsMoving || sourceIsResizing)
             && (targetIsMoving || targetIsResizing);
         });
@@ -53241,16 +53449,6 @@
     'previewSupport'
   ];
 
-
-  // helpers //////////////////////
-
-  /**
-   * Checks if an element is a connection.
-   */
-  function isConnection$6(element) {
-    return element.waypoints;
-  }
-
   /**
    * @type { import('didi').ModuleDeclaration }
    */
@@ -54120,7 +54318,7 @@
   /**
    * Remove tooltip with given ID.
    *
-   * @param {string} id
+   * @param {string | Tooltip} id
    */
   Tooltips.prototype.remove = function(id) {
 
@@ -54270,7 +54468,7 @@
    * at a time.
    *
    * @param {Object[]} [collection]
-   * @param {Function} removeFn
+   * @param {(element: Object) => void} removeFn
    *
    * @return {Object[]} the cleared collection
    */
@@ -55290,7 +55488,7 @@
   BpmnUpdater.prototype.updateParent = function(element, oldParent) {
 
     // do not update BPMN 2.0 label parent
-    if (isLabel$5(element)) {
+    if (isLabel(element)) {
       return;
     }
 
@@ -55355,7 +55553,7 @@
       });
     }
 
-    var target = isLabel$5(shape) ? this._getLabel(di) : di;
+    var target = isLabel(shape) ? this._getLabel(di) : di;
 
     var bounds = target.bounds;
 
@@ -56416,7 +56614,7 @@
 
     // center elements around position
     forEach$1(elements, function(element) {
-      if (isConnection$5(element)) {
+      if (isConnection$4(element)) {
         element.waypoints = map$1(element.waypoints, function(waypoint) {
           return {
             x: round$3(waypoint.x - bbox.x - bbox.width / 2 + position.x),
@@ -56436,7 +56634,7 @@
     var cache = {};
 
     forEach$1(elements, function(element) {
-      if (isConnection$5(element)) {
+      if (isConnection$4(element)) {
         cache[ element.id ] = isNumber(parentIndex) ?
           modeling.createConnection(
             cache[ element.source.id ],
@@ -56463,6 +56661,10 @@
         createShapeHints.autoResize = false;
       }
 
+      if (isLabel$1(element)) {
+        createShapeHints = omit(createShapeHints, [ 'attach' ]);
+      }
+
       cache[ element.id ] = isNumber(parentIndex) ?
         modeling.createShape(
           element,
@@ -56480,13 +56682,7 @@
     });
 
     context.elements = values(cache);
-  };
-
-  // helpers //////////
-
-  function isConnection$5(element) {
-    return !!element.waypoints;
-  }
+  };
 
   /**
    * @typedef {import('../../../model/Types').Element} Element
@@ -56857,10 +57053,6 @@
     return shape;
   };
 
-  function isConnection$4(element) {
-    return element.waypoints;
-  }
-
   /**
    * @typedef {import('../Modeling').default} Modeling
    */
@@ -57131,23 +57323,56 @@
     return connection;
   };
 
+  /**
+   * @typedef {import('../../../../model/Types').Connection} Connection
+   * @typedef {import('../../../../model/Types').Element} Element
+   * @typedef {import('../../../../model/Types').Shape} Shape
+   */
+
   function MoveClosure() {
 
+    /**
+     * @type {Record<string, Shape>}
+     */
     this.allShapes = {};
+
+    /**
+     * @type {Record<string, Connection>}
+     */
     this.allConnections = {};
 
+    /**
+     * @type {Record<string, Element>}
+     */
     this.enclosedElements = {};
+
+    /**
+     * @type {Record<string, Connection>}
+     */
     this.enclosedConnections = {};
 
+    /**
+     * @type {Record<string, Element>}
+     */
     this.topLevel = {};
   }
 
-
+  /**
+   * @param {Element} element
+   * @param {boolean} [isTopLevel]
+   *
+   * @return {MoveClosure}
+   */
   MoveClosure.prototype.add = function(element, isTopLevel) {
     return this.addAll([ element ], isTopLevel);
   };
 
-
+  /**
+   * @param {Element[]} elements
+   * @param {boolean} [isTopLevel]
+   *
+   * @return {MoveClosure}
+   */
   MoveClosure.prototype.addAll = function(elements, isTopLevel) {
 
     var newClosure = getClosure(elements, !!isTopLevel, this);
@@ -59958,13 +60183,13 @@
     }
 
     forEach$1(elements, function(element) {
-      var assignedDi = isConnection$3(element) ? pick(di, [ 'border-color' ]) : di,
+      var assignedDi = isConnection(element) ? pick(di, [ 'border-color' ]) : di,
           elementDi = getDi(element);
 
       // TODO @barmac: remove once we drop bpmn.io properties
       ensureLegacySupport(assignedDi);
 
-      if (isLabel$5(element)) {
+      if (isLabel(element)) {
 
         // set label colors as bpmndi:BPMNLabel#color
         self._commandStack.execute('element.updateModdleProperties', {
@@ -60024,7 +60249,7 @@
     return /^#[0-9a-fA-F]{6}$/.test(context.fillStyle) ? context.fillStyle : null;
   }
 
-  function isConnection$3(element) {
+  function isConnection(element) {
     return !!element.waypoints;
   }
 
@@ -60090,7 +60315,7 @@
           businessObject = element.businessObject,
           newLabel = ctx.newLabel;
 
-      if (!isLabel$5(element)
+      if (!isLabel(element)
           && isLabelExternal(element)
           && !hasExternalLabel(element)
           && !isEmptyText(newLabel)) {
@@ -60130,11 +60355,11 @@
           hints = ctx.hints || {};
 
       // ignore internal labels for elements except text annotations
-      if (!isLabel$5(label) && !is$1(label, 'bpmn:TextAnnotation')) {
+      if (!isLabel(label) && !is$1(label, 'bpmn:TextAnnotation')) {
         return;
       }
 
-      if (isLabel$5(label) && isEmptyText(newLabel)) {
+      if (isLabel(label) && isEmptyText(newLabel)) {
 
         if (hints.removeShape !== false) {
           modeling.removeShape(label, { unsetLabel: false });
@@ -60781,7 +61006,6 @@
    * @param {Rect} target target rectangle
    * @param {Point} [start] source docking
    * @param {Point} [end] target docking
-   *
    * @param {Object} [hints]
    * @param {string} [hints.preserveDocking=source] preserve docking on selected side
    * @param {string[]} [hints.preferredLayouts]
@@ -60904,6 +61128,7 @@
    * @param {Point} start
    * @param {Point} end
    * @param {Object} [hints]
+   * @param {string} [hints.preserveDocking]
    *
    * @return {Point[]|null} The waypoints or null if layout isn't possible.
    */
@@ -61119,12 +61344,13 @@
    *
    * @example
    *
+   * ```javascript
    * getDirections('top'); // -> 'v:v'
    * getDirections('intersect'); // -> 't:t'
    *
    * getDirections('top-right', 'v:h'); // -> 'v:h'
    * getDirections('top-right', 'h:h'); // -> 'h:h'
-   *
+   * ```
    *
    * @param {string} orientation
    * @param {string} defaultLayout
@@ -61955,7 +62181,7 @@
      * Start move.
      *
      * @param {MouseEvent|TouchEvent} event
-     * @param {Shape} shape
+     * @param {Shape} element
      * @param {boolean} [activate]
      * @param {Object} [context]
      */
@@ -62242,7 +62468,7 @@
 
     var filteredElements = filter(elements, function(element) {
 
-      if (!isConnection$2(element)) {
+      if (!isConnection$4(element)) {
         return true;
       } else {
 
@@ -62260,13 +62486,6 @@
     return size(groupBy(elements, function(e) { return e.parent && e.parent.id; })) !== 1;
   }
 
-  /**
-   * Checks if an element is a connection.
-   */
-  function isConnection$2(element) {
-    return element.waypoints;
-  }
-
   /**
    * @type { import('didi').ModuleDeclaration }
    */
@@ -64356,7 +64575,7 @@
       }
 
       // handle connections
-      if (isConnection$1(snapTarget)) {
+      if (isConnection$4(snapTarget)) {
 
         // ignore single segment connections
         if (snapTarget.waypoints.length < 3) {
@@ -64397,16 +64616,8 @@
 
   // helpers //////////
 
-  function isConnection$1(element) {
-    return !!element.waypoints;
-  }
-
   function isHidden$1(element) {
     return !!element.hidden;
-  }
-
-  function isLabel$1(element) {
-    return !!element.labelTarget;
   }
 
   /**
@@ -64779,9 +64990,9 @@
   ResizeSnapping.prototype.getSnapTargets = function(shape, target) {
     return getChildren(target).filter(function(child) {
       return !isAttached(child, shape)
-        && !isConnection(child)
+        && !isConnection$4(child)
         && !isHidden(child)
-        && !isLabel(child);
+        && !isLabel$1(child);
     });
   };
 
@@ -64815,18 +65026,10 @@
     return element.host === host;
   }
 
-  function isConnection(element) {
-    return !!element.waypoints;
-  }
-
   function isHidden(element) {
     return !!element.hidden;
   }
 
-  function isLabel(element) {
-    return !!element.labelTarget;
-  }
-
   function isHorizontal(direction) {
     return direction === 'n' || direction === 's';
   }