bpmn-js 17.5.0 → 17.6.0

package/dist/bpmn-modeler.development.js

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-modeler v17.5.0
+ * bpmn-js - bpmn-modeler v17.6.0
  *
  * Copyright (c) 2014-present, camunda Services GmbH
  *
@@ -8,7 +8,7 @@
  *
  * Source Code: https://github.com/bpmn-io/bpmn-js
  *
- * Date: 2024-04-26
+ * Date: 2024-04-30
  */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -16321,7 +16321,7 @@
       // avoid multiple rendering of elements
       if (gfx) {
         throw new Error(
-          'already rendered ${ elementToString(element) }'
+          `already rendered ${ elementToString(element) }`
         );
       }
 
@@ -17053,6 +17053,12 @@
    * @see http://bpmn.io/license for more information.
    */
 
+  /**
+   * @template T
+   *
+   * @typedef { import('diagram-js/lib/core/EventBus').default<T> } EventBus
+   */
+
   /**
    * @template T
    *
@@ -17138,12 +17144,22 @@
    * } } SaveSVGDoneEvent
    */
 
+  /**
+   * @template Type
+   *
+   * @typedef { Type extends { eventBus: EventBus<infer X> } ? X : never } EventMap
+   */
+
   /**
    * A base viewer for BPMN 2.0 diagrams.
    *
-   * Have a look at {@link Viewer}, {@link NavigatedViewer} or {@link Modeler} for
+   * Have a look at {@link bpmn-js/lib/Viewer}, {@link bpmn-js/lib/NavigatedViewer} or {@link bpmn-js/lib/Modeler} for
    * bundles that include actual features.
    *
+   * @template [ServiceMap=null]
+   *
+   * @extends Diagram<ServiceMap>
+   *
    * @param {BaseViewerOptions} [options] The options to configure the viewer.
    */
   function BaseViewer(options) {
@@ -17564,9 +17580,18 @@
   };
 
   /**
-   * Register an event listener.
+   * @overlord
    *
-   * Remove an event listener via {@link BaseViewer#off}.
+   * Register an event listener for events with the given name.
+   *
+   * The callback will be invoked with `event, ...additionalArguments`
+   * that have been passed to {@link EventBus#fire}.
+   *
+   * Returning false from a listener will prevent the events default action
+   * (if any is specified). To stop an event from being processed further in
+   * other listeners execute {@link Event#stopPropagation}.
+   *
+   * Returning anything but `undefined` from a listener will stop the listener propagation.
    *
    * @template T
    *
@@ -17575,6 +17600,25 @@
    * @param {EventBusEventCallback<T>} callback The callback.
    * @param {any} [that] Value of `this` the callback will be called with.
    */
+  /**
+   * Register an event listener for events with the given name.
+   *
+   * The callback will be invoked with `event, ...additionalArguments`
+   * that have been passed to {@link EventBus#fire}.
+   *
+   * Returning false from a listener will prevent the events default action
+   * (if any is specified). To stop an event from being processed further in
+   * other listeners execute {@link Event#stopPropagation}.
+   *
+   * Returning anything but `undefined` from a listener will stop the listener propagation.
+   *
+   * @template {keyof EventMap<ServiceMap>} EventName
+   *
+   * @param {EventName} events to subscribe to
+   * @param {number} [priority=1000] listen priority
+   * @param {EventBusEventCallback<(EventMap<ServiceMap>)[EventName]>} callback
+   * @param {any} [that] callback context
+   */
   BaseViewer.prototype.on = function(events, priority, callback, that) {
     return this.get('eventBus').on(events, priority, callback, that);
   };
@@ -17831,7 +17875,11 @@
   /**
    * A base modeler for BPMN 2.0 diagrams.
    *
-   * See {@link Modeler} for a fully-featured modeler.
+   * See {@link bpmn-js/lib/Modeler} for a fully-featured modeler.
+   *
+   * @template [ServiceMap=null]
+   *
+   * @extends BaseViewer<ServiceMap>
    *
    * @param {BaseViewerOptions} [options] The options to configure the modeler.
    */
@@ -25540,7 +25588,7 @@
   /**
    * A viewer for BPMN 2.0 diagrams.
    *
-   * Have a look at {@link NavigatedViewer} or {@link Modeler} for bundles that include
+   * Have a look at {@link bpmn-js/lib/NavigatedViewer} or {@link bpmn-js/lib/Modeler} for bundles that include
    * additional features.
    *
    *
@@ -25576,6 +25624,10 @@
    * bpmnViewer.importXML(...);
    * ```
    *
+   * @template [ServiceMap=null]
+   *
+   * @extends BaseViewer<ServiceMap>
+   *
    * @param {BaseViewerOptions} [options] The options to configure the viewer.
    */
   function Viewer(options) {
@@ -26698,6 +26750,10 @@
   /**
    * A viewer with mouse and keyboard navigation features.
    *
+   * @template [ServiceMap=null]
+   *
+   * @extends Viewer<ServiceMap>
+   *
    * @param {BaseViewerOptions} [options]
    */
   function NavigatedViewer(options) {
@@ -42395,7 +42451,7 @@
       }
 
       if (!order) {
-        throw new Error('no order for <' + element.id + '>');
+        throw new Error(`no order for <${ element.id }>`);
       }
 
       return order;
@@ -42415,7 +42471,7 @@
       }
 
       if (!actualParent) {
-        throw new Error('no parent for <' + element.id + '> in <' + (newParent && newParent.id) + '>');
+        throw new Error(`no parent for <${ element.id }> in <${ newParent && newParent.id }>`);
       }
 
       return actualParent;
@@ -51699,7 +51755,7 @@
         existingLanesCount = childLanes.length;
 
     if (existingLanesCount > newLanesCount) {
-      throw new Error(`more than <${newLanesCount}> child lanes`);
+      throw new Error(`more than <${ newLanesCount }> child lanes`);
     }
 
     var isHorizontalLane = isHorizontal$3(shape);
@@ -52173,7 +52229,7 @@
         }
       }
 
-      throw new Error('invalid color value: ' + color);
+      throw new Error(`invalid color value: ${ color }`);
     };
   }
 
@@ -56553,6 +56609,10 @@
         entries.replace.action.click(event, shape);
       }
     });
+
+    eventBus.on('contextPad.close', function() {
+      appendPreview.cleanUp();
+    });
   }
 
   ContextPadProvider.$inject = [
@@ -56687,16 +56747,12 @@
         create.start(event, shape, {
           source: element
         });
-
-        appendPreview.cleanUp();
       }
 
       var append = autoPlace ? function(_, element) {
         var shape = elementFactory.createShape(assign$1({ type: type }, options));
 
         autoPlace.append(element, shape);
-
-        appendPreview.cleanUp();
       } : appendStart;
 
       var previewAppend = autoPlace ? function(_, element) {
@@ -56930,7 +56986,6 @@
           'bpmn-icon-text-annotation',
           translate('Add text annotation')
         ),
-
         'connect': {
           group: 'connect',
           className: 'bpmn-icon-connection-multi',
@@ -64949,7 +65004,6 @@
   /**
    * A modeler for BPMN 2.0 diagrams.
    *
-   *
    * ## Extending the Modeler
    *
    * In order to extend the viewer pass extension modules to bootstrap via the
@@ -65010,6 +65064,10 @@
    * var bpmnModeler = new Modeler({ additionalModules: [ overrideModule ]});
    * ```
    *
+   * @template [ServiceMap=null]
+   *
+   * @extends BaseModeler<ServiceMap>
+   *
    * @param {BaseViewerOptions} [options] The options to configure the modeler.
    */
   function Modeler(options) {