bpmn-js 17.4.0 → 17.6.0

package/dist/bpmn-navigated-viewer.development.js

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-navigated-viewer v17.4.0
+ * bpmn-js - bpmn-navigated-viewer 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() :
@@ -6398,7 +6398,6 @@
    * @typedef {import('diagram-js/lib/core/Canvas').default} Canvas
    * @typedef {import('diagram-js/lib/core/ElementRegistry').default} ElementRegistry
    * @typedef {import('diagram-js/lib/core/EventBus').default} EventBus
-   * @typedef {import('diagram-js/lib/i18n/translate/translate').default} Translate
    *
    * @typedef {import('../features/modeling/ElementFactory').default} ElementFactory
    * @typedef {import('../draw/TextRenderer').default} TextRenderer
@@ -6440,12 +6439,10 @@
     });
   }
 
-  function notYetDrawn(translate, semantic, refSemantic, property) {
-    return new Error(translate('element {element} referenced by {referenced}#{property} not yet drawn', {
-      element: elementToString(refSemantic),
-      referenced: elementToString(semantic),
-      property: property
-    }));
+  function notYetDrawn(semantic, refSemantic, property) {
+    return new Error(
+      `element ${ elementToString(refSemantic) } referenced by ${ elementToString(semantic) }#${ property } not yet drawn`
+    );
   }
 
 
@@ -6456,18 +6453,16 @@
    * @param {Canvas} canvas
    * @param {ElementFactory} elementFactory
    * @param {ElementRegistry} elementRegistry
-   * @param {Function} translate
    * @param {TextRenderer} textRenderer
    */
   function BpmnImporter(
       eventBus, canvas, elementFactory,
-      elementRegistry, translate, textRenderer) {
+      elementRegistry, textRenderer) {
 
     this._eventBus = eventBus;
     this._canvas = canvas;
     this._elementFactory = elementFactory;
     this._elementRegistry = elementRegistry;
-    this._translate = translate;
     this._textRenderer = textRenderer;
   }
 
@@ -6476,7 +6471,6 @@
     'canvas',
     'elementFactory',
     'elementRegistry',
-    'translate',
     'textRenderer'
   ];
 
@@ -6493,7 +6487,6 @@
    */
   BpmnImporter.prototype.add = function(semantic, di, parentElement) {
     var element,
-        translate = this._translate,
         hidden;
 
     var parentIndex;
@@ -6579,10 +6572,9 @@
 
       this._canvas.addConnection(element, parentElement, parentIndex);
     } else {
-      throw new Error(translate('unknown di {di} for element {semantic}', {
-        di: elementToString(di),
-        semantic: elementToString(semantic)
-      }));
+      throw new Error(
+        `unknown di ${ elementToString(di) } for element ${ elementToString(semantic) }`
+      );
     }
 
     // (optional) LABEL
@@ -6590,7 +6582,6 @@
       this.addLabel(semantic, di, element);
     }
 
-
     this._eventBus.fire('bpmnElement.added', { element: element });
 
     return element;
@@ -6604,20 +6595,19 @@
    * @param {Shape} boundaryElement
    */
   BpmnImporter.prototype._attachBoundary = function(boundarySemantic, boundaryElement) {
-    var translate = this._translate;
     var hostSemantic = boundarySemantic.attachedToRef;
 
     if (!hostSemantic) {
-      throw new Error(translate('missing {semantic}#attachedToRef', {
-        semantic: elementToString(boundarySemantic)
-      }));
+      throw new Error(
+        `missing ${ elementToString(boundarySemantic) }#attachedToRef`
+      );
     }
 
     var host = this._elementRegistry.get(hostSemantic.id),
         attachers = host && host.attachers;
 
     if (!host) {
-      throw notYetDrawn(translate, boundarySemantic, hostSemantic, 'attachedToRef');
+      throw notYetDrawn(boundarySemantic, hostSemantic, 'attachedToRef');
     }
 
     // wire element.host <> host.attachers
@@ -6683,8 +6673,7 @@
 
     var element,
         refSemantic,
-        type = semantic.$type,
-        translate = this._translate;
+        type = semantic.$type;
 
     refSemantic = semantic[side + 'Ref'];
 
@@ -6707,12 +6696,11 @@
     }
 
     if (refSemantic) {
-      throw notYetDrawn(translate, semantic, refSemantic, side + 'Ref');
+      throw notYetDrawn(semantic, refSemantic, side + 'Ref');
     } else {
-      throw new Error(translate('{semantic}#{side} Ref not specified', {
-        semantic: elementToString(semantic),
-        side: side
-      }));
+      throw new Error(
+        `${ elementToString(semantic) }#${ side } Ref not specified`
+      );
     }
   };
 
@@ -22097,8 +22085,6 @@
   }
 
   /**
-   * @typedef {import('diagram-js/lib/i18n/translate/translate').default} Translate
-   *
    * @typedef {import('../model/Types').ModdleElement} ModdleElement
    */
 
@@ -22131,9 +22117,8 @@
 
   /**
    * @param {Record<'element' | 'root' | 'error', Function>} handler
-   * @param {Translate} translate
    */
-  function BpmnTreeWalker(handler, translate) {
+  function BpmnTreeWalker(handler) {
 
     // list of containers already walked
     var handledElements = {};
@@ -22167,7 +22152,7 @@
       // avoid multiple rendering of elements
       if (gfx) {
         throw new Error(
-          translate('already rendered {element}', { element: elementToString(element) })
+          `already rendered ${ elementToString(element) }`
         );
       }
 
@@ -22187,11 +22172,10 @@
         handled(element);
 
         return gfx;
-      } catch (e) {
-        logError(e.message, { element: element, error: e });
+      } catch (error) {
+        logError(error.message, { element, error });
 
-        console.error(translate('failed to import {element}', { element: elementToString(element) }));
-        console.error(e);
+        console.error(`failed to import ${ elementToString(element) }`, error);
       }
     }
 
@@ -22207,9 +22191,7 @@
       if (bpmnElement) {
         if (diMap[bpmnElement.id]) {
           logError(
-            translate('multiple DI elements defined for {element}', {
-              element: elementToString(bpmnElement)
-            }),
+            `multiple DI elements defined for ${ elementToString(bpmnElement) }`,
             { element: bpmnElement }
           );
         } else {
@@ -22219,9 +22201,7 @@
         }
       } else {
         logError(
-          translate('no bpmnElement referenced in {element}', {
-            element: elementToString(di)
-          }),
+          `no bpmnElement referenced in ${ elementToString(di) }`,
           { element: di }
         );
       }
@@ -22259,7 +22239,7 @@
       var diagrams = definitions.diagrams;
 
       if (diagram && diagrams.indexOf(diagram) === -1) {
-        throw new Error(translate('diagram not part of bpmn:Definitions'));
+        throw new Error('diagram not part of <bpmn:Definitions />');
       }
 
       if (!diagram && diagrams && diagrams.length) {
@@ -22268,7 +22248,7 @@
 
       // no diagram -> nothing to import
       if (!diagram) {
-        throw new Error(translate('no diagram to display'));
+        throw new Error('no diagram to display');
       }
 
       // load DI from selected diagram only
@@ -22279,10 +22259,9 @@
       var plane = diagram.plane;
 
       if (!plane) {
-        throw new Error(translate(
-          'no plane for {element}',
-          { element: elementToString(diagram) }
-        ));
+        throw new Error(
+          `no plane for ${ elementToString(diagram) }`
+        );
       }
 
       var rootElement = plane.bpmnElement;
@@ -22293,14 +22272,11 @@
         rootElement = findDisplayCandidate(definitions);
 
         if (!rootElement) {
-          throw new Error(translate('no process or collaboration to display'));
+          throw new Error('no process or collaboration to display');
         } else {
 
           logError(
-            translate('correcting missing bpmnElement on {plane} to {rootElement}', {
-              plane: elementToString(plane),
-              rootElement: elementToString(rootElement)
-            })
+            `correcting missing bpmnElement on ${ elementToString(plane) } to ${ elementToString(rootElement) }`
           );
 
           // correct DI on the fly
@@ -22321,10 +22297,7 @@
         handleUnhandledProcesses(definitions.rootElements, ctx);
       } else {
         throw new Error(
-          translate('unsupported bpmnElement for {plane}: {rootElement}', {
-            plane: elementToString(plane),
-            rootElement: elementToString(rootElement)
-          })
+          `unsupported bpmnElement for ${ elementToString(plane) }: ${ elementToString(rootElement) }`
         );
       }
 
@@ -22486,28 +22459,28 @@
     }
 
     function handleFlowElements(flowElements, context) {
-      forEach$1(flowElements, function(e) {
-        if (is(e, 'bpmn:SequenceFlow')) {
+      forEach$1(flowElements, function(flowElement) {
+        if (is(flowElement, 'bpmn:SequenceFlow')) {
           deferred.push(function() {
-            handleSequenceFlow(e, context);
+            handleSequenceFlow(flowElement, context);
           });
-        } else if (is(e, 'bpmn:BoundaryEvent')) {
+        } else if (is(flowElement, 'bpmn:BoundaryEvent')) {
           deferred.unshift(function() {
-            handleFlowNode(e, context);
+            handleFlowNode(flowElement, context);
           });
-        } else if (is(e, 'bpmn:FlowNode')) {
-          handleFlowNode(e, context);
-        } else if (is(e, 'bpmn:DataObject')) ; else if (is(e, 'bpmn:DataStoreReference')) {
-          handleDataElement(e, context);
-        } else if (is(e, 'bpmn:DataObjectReference')) {
-          handleDataElement(e, context);
+        } else if (is(flowElement, 'bpmn:FlowNode')) {
+          handleFlowNode(flowElement, context);
+        } else if (is(flowElement, 'bpmn:DataObject')) ; else if (is(flowElement, 'bpmn:DataStoreReference')) {
+          handleDataElement(flowElement, context);
+        } else if (is(flowElement, 'bpmn:DataObjectReference')) {
+          handleDataElement(flowElement, context);
         } else {
           logError(
-            translate('unrecognized flowElement {element} in context {context}', {
-              element: elementToString(e),
-              context: (context ? elementToString(context.businessObject) : 'null')
-            }),
-            { element: e, context: context }
+            `unrecognized flowElement ${ elementToString(flowElement) } in context ${ elementToString(context && context.businessObject) }`,
+            {
+              element: flowElement,
+              context
+            }
           );
         }
       });
@@ -22574,7 +22547,6 @@
 
     var importer,
         eventBus,
-        translate,
         canvas;
 
     var error,
@@ -22604,7 +22576,7 @@
         }
       };
 
-      var walker = new BpmnTreeWalker(visitor, translate);
+      var walker = new BpmnTreeWalker(visitor);
 
 
       bpmnDiagram = bpmnDiagram || (definitions.diagrams && definitions.diagrams[0]);
@@ -22612,7 +22584,7 @@
       var diagramsToImport = getDiagramsToImport(definitions, bpmnDiagram);
 
       if (!diagramsToImport) {
-        throw new Error(translate('no diagram to display'));
+        throw new Error('no diagram to display');
       }
 
       // traverse BPMN 2.0 document model,
@@ -22635,7 +22607,6 @@
       try {
         importer = diagram.get('bpmnImporter');
         eventBus = diagram.get('eventBus');
-        translate = diagram.get('translate');
         canvas = diagram.get('canvas');
 
         eventBus.fire('import.render.start', { definitions: definitions });
@@ -22857,6 +22828,12 @@
    * @see http://bpmn.io/license for more information.
    */
 
+  /**
+   * @template T
+   *
+   * @typedef { import('diagram-js/lib/core/EventBus').default<T> } EventBus
+   */
+
   /**
    * @template T
    *
@@ -22942,12 +22919,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) {
@@ -23368,9 +23355,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
    *
@@ -23379,6 +23375,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);
   };
@@ -23632,7 +23647,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.
    *
    *
@@ -23668,6 +23683,10 @@
    * bpmnViewer.importXML(...);
    * ```
    *
+   * @template [ServiceMap=null]
+   *
+   * @extends BaseViewer<ServiceMap>
+   *
    * @param {BaseViewerOptions} [options] The options to configure the viewer.
    */
   function Viewer(options) {
@@ -24779,6 +24798,10 @@
   /**
    * A viewer with mouse and keyboard navigation features.
    *
+   * @template [ServiceMap=null]
+   *
+   * @extends Viewer<ServiceMap>
+   *
    * @param {BaseViewerOptions} [options]
    */
   function NavigatedViewer(options) {