bpmn-js 17.1.0 → 17.2.0

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

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-navigated-viewer v17.1.0
+ * bpmn-js - bpmn-navigated-viewer v17.2.0
  *
  * Copyright (c) 2014-present, camunda Services GmbH
  *
@@ -8,7 +8,7 @@
  *
  * Source Code: https://github.com/bpmn-io/bpmn-js
  *
- * Date: 2024-03-18
+ * Date: 2024-03-22
  */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -5149,8 +5149,8 @@
    * @typedef { number | Partial<Padding> } PaddingConfig
    *
    * @typedef { {
-   *   horizontal: 'center' | 'left';
-   *   vertical: 'top' | 'center';
+   *   horizontal: 'center' | 'left' | 'right';
+   *   vertical: 'top' | 'middle';
    * } } Alignment
    *
    *  @typedef { 'center-middle' | 'center-top' } AlignmentConfig
@@ -5414,7 +5414,7 @@
   /**
    * Creates a new label utility
    *
-   * @param {TextConfig} config
+   * @param {TextConfig} [config]
    */
   function Text(config) {
 
@@ -6793,7 +6793,7 @@
    *
    * @return {boolean}
    */
-  function isButton(event, button) {
+  function isButton$1(event, button) {
     return (getOriginal(event) || event).button === button;
   }
 
@@ -6805,7 +6805,7 @@
   function isPrimaryButton(event) {
 
     // button === 0 -> left áka primary mouse button
-    return isButton(event, 0);
+    return isButton$1(event, 0);
   }
 
   /**
@@ -6816,7 +6816,7 @@
   function isAuxiliaryButton(event) {
 
     // button === 1 -> auxiliary áka wheel button
-    return isButton(event, 1);
+    return isButton$1(event, 1);
   }
 
   /**
@@ -7424,6 +7424,7 @@
   /**
    * @typedef {import('../../model/Types').Element} Element
    *
+   * @typedef {import('./OutlineProvider').default} OutlineProvider
    * @typedef {import('../../core/EventBus').default} EventBus
    * @typedef {import('../../draw/Styles').default} Styles
    */
@@ -7582,7 +7583,7 @@
    * Returns the outline for an element.
    *
    * @param {Element} element
-   **/
+   */
   Outline.prototype.getOutline = function(element) {
     var outline;
     var providers = this._getProviders();
@@ -8163,7 +8164,7 @@
     }, config && config.defaults);
 
     /**
-     * @type {Map<string, Overlay>}
+     * @type {Record<string, Overlay>}
      */
     this._overlays = {};
 
@@ -8232,8 +8233,7 @@
       } else {
         return [];
       }
-    } else
-    if (search.type) {
+    } else if (search.type) {
       return filter(this._overlays, matchPattern({ type: search.type }));
     } else {
 
@@ -9989,16 +9989,19 @@
    * @typedef { import('./index.js').ModuleDeclaration } ModuleDeclaration
    * @typedef { import('./index.js').ModuleDefinition } ModuleDefinition
    * @typedef { import('./index.js').InjectorContext } InjectorContext
+   *
+   * @typedef { import('./index.js').TypedDeclaration<any, any> } TypedDeclaration
    */
 
   /**
    * Create a new injector with the given modules.
    *
    * @param {ModuleDefinition[]} modules
-   * @param {InjectorContext} [parent]
+   * @param {InjectorContext} [_parent]
    */
-  function Injector(modules, parent) {
-    parent = parent || {
+  function Injector(modules, _parent) {
+
+    const parent = _parent || /** @type InjectorContext */ ({
       get: function(name, strict) {
         currentlyResolving.push(name);
 
@@ -10008,7 +10011,7 @@
           throw error(`No provider for "${ name }"!`);
         }
       }
-    };
+    });
 
     const currentlyResolving = [];
     const providers = this._providers = Object.create(parent._providers || null);
@@ -10031,12 +10034,13 @@
      * @return {any}
      */
     function get(name, strict) {
-      if (!providers[name] && name.indexOf('.') !== -1) {
+      if (!providers[name] && name.includes('.')) {
+
         const parts = name.split('.');
-        let pivot = get(parts.shift());
+        let pivot = get(/** @type { string } */ (parts.shift()));
 
         while (parts.length) {
-          pivot = pivot[parts.shift()];
+          pivot = pivot[/** @type { string } */ (parts.shift())];
         }
 
         return pivot;
@@ -10076,6 +10080,9 @@
         }
       }
 
+      /**
+       * @type {string[]}
+       */
       const inject = fn.$inject || parseAnnotations(fn);
       const dependencies = inject.map(dep => {
         if (hasOwnProp(locals, dep)) {
@@ -10087,7 +10094,7 @@
 
       return {
         fn: fn,
-        dependencies: dependencies
+        dependencies
       };
     }
 
@@ -10107,7 +10114,7 @@
       } = fnDef(type);
 
       // instantiate var args constructor
-      const Constructor = Function.prototype.bind.apply(fn, [ null ].concat(dependencies));
+      const Constructor = Function.prototype.bind.call(fn, null, ...dependencies);
 
       return new Constructor();
     }
@@ -10287,13 +10294,17 @@
           return;
         }
 
-        if (moduleDefinition[key][2] === 'private') {
-          providers[key] = moduleDefinition[key];
+        const typeDeclaration = /** @type { TypedDeclaration } */ (
+          moduleDefinition[key]
+        );
+
+        if (typeDeclaration[2] === 'private') {
+          providers[key] = typeDeclaration;
           return;
         }
 
-        const type = moduleDefinition[key][0];
-        const value = moduleDefinition[key][1];
+        const type = typeDeclaration[0];
+        const value = typeDeclaration[1];
 
         providers[key] = [ factoryMap[type], arrayUnwrap(type, value), type ];
       });
@@ -10681,6 +10692,7 @@
    * @typedef {import('../util/Types').Point} Point
    * @typedef {import('../util/Types').Rect} Rect
    * @typedef {import('../util/Types').RectTRBL} RectTRBL
+   * @typedef {import('../util/Types').ScrollDelta} ScrollDelta
    */
 
   function round(number, resolution) {
@@ -11381,7 +11393,7 @@
   Canvas.prototype.setRootElement = function(rootElement) {
 
     if (rootElement === this._rootElement) {
-      return;
+      return rootElement;
     }
 
     let plane;
@@ -11816,7 +11828,7 @@
   /**
    * Gets or sets the scroll of the canvas.
    *
-   * @param {Point} [delta] The scroll to be set.
+   * @param {ScrollDelta} [delta] The scroll to be set.
    *
    * @return {Point}
    */
@@ -13187,6 +13199,8 @@
    * var sum = eventBus.fire('sum', 1, 2);
    * console.log(sum); // 3
    * ```
+   *
+   * @template [EventMap=null]
    */
   function EventBus() {
 
@@ -13200,8 +13214,9 @@
     this.on('diagram.destroy', 1, this._destroy, this);
   }
 
-
   /**
+   * @overlord
+   *
    * Register an event listener for events with the given name.
    *
    * The callback will be invoked with `event, ...additionalArguments`
@@ -13220,6 +13235,25 @@
    * @param {EventBusEventCallback<T>} callback
    * @param {any} [that] callback context
    */
+  /**
+   * 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} EventName
+   *
+   * @param {EventName} events to subscribe to
+   * @param {number} [priority=1000] listen priority
+   * @param {EventBusEventCallback<EventMap[EventName]>} callback
+   * @param {any} [that] callback context
+   */
   EventBus.prototype.on = function(events, priority, callback, that) {
 
     events = isArray$2(events) ? events : [ events ];
@@ -13257,6 +13291,8 @@
   };
 
   /**
+   * @overlord
+   *
    * Register an event listener that is called only once.
    *
    * @template T
@@ -13266,6 +13302,16 @@
    * @param {EventBusEventCallback<T>} callback
    * @param {any} [that] callback context
    */
+  /**
+   * Register an event listener that is called only once.
+   *
+   * @template {keyof EventMap} EventName
+   *
+   * @param {EventName} events to subscribe to
+   * @param {number} [priority=1000] listen priority
+   * @param {EventBusEventCallback<EventMap[EventName]>} callback
+   * @param {any} [that] callback context
+   */
   EventBus.prototype.once = function(events, priority, callback, that) {
     var self = this;
 
@@ -13928,8 +13974,7 @@
 
       // update positioning
       translate$1(gfx, element.x, element.y);
-    } else
-    if (type === 'connection') {
+    } else if (type === 'connection') {
       this.drawConnection(visual, element);
     } else {
       throw new Error('unknown type: ' + type);
@@ -13992,6 +14037,16 @@
    * } & Record<string, any> } DiagramOptions
    */
 
+  /**
+   * @template T
+   * @typedef {import('didi').FactoryFunction<T>} FactoryFunction
+   */
+
+  /**
+   * @template T
+   * @typedef {import('didi').ArrayFunc<T>} ArrayFunc
+   */
+
   /**
    * Bootstrap an injector from a list of modules, instantiating a number of default components
    *
@@ -14010,9 +14065,10 @@
   /**
    * Creates an injector from passed options.
    *
+   * @template ServiceMap
    * @param {DiagramOptions} [options]
    *
-   * @return {Injector}
+   * @return {Injector<ServiceMap>}
    */
   function createInjector(options) {
 
@@ -14039,6 +14095,7 @@
    *
    * @class
    * @constructor
+   * @template [ServiceMap=null]
    *
    * @example Creating a plug-in that logs whenever a shape is added to the canvas.
    *
@@ -14077,44 +14134,17 @@
    * ```
    *
    * @param {DiagramOptions} [options]
-   * @param {Injector} [injector] An (optional) injector to bootstrap the diagram with.
+   * @param {Injector<ServiceMap>} [injector] An (optional) injector to bootstrap the diagram with.
    */
   function Diagram(options, injector) {
 
-    this._injector = injector = injector || createInjector(options);
-
-    // API
-
-    /**
-     * Resolves a diagram service.
-     *
-     * @template T
-     *
-     * @param {string} name The name of the service to get.
-     * @param {boolean} [strict=true] If false, resolve missing services to null.
-     *
-     * @return {T|null}
-     */
-    this.get = injector.get;
-
     /**
-     * Executes a function with its dependencies injected.
-     *
-     * @template T
-     *
-     * @param {Function} func function to be invoked
-     * @param {InjectionContext} [context] context of the invocation
-     * @param {LocalsMap} [locals] locals provided
-     *
-     * @return {T|null}
+     * @type {Injector<ServiceMap>}
      */
-    this.invoke = injector.invoke;
+    this._injector = injector || createInjector(options);
 
     // init
 
-    // indicate via event
-
-
     /**
      * An event indicating that all plug-ins are loaded.
      *
@@ -14137,6 +14167,82 @@
     this.get('eventBus').fire('diagram.init');
   }
 
+  /**
+   * @overlord
+   *
+   * Resolves a diagram service.
+   *
+   * @template T
+   *
+   * @param {string} name The name of the service to get.
+   *
+   * @return {T}
+   */
+  /**
+   * @overlord
+   *
+   * Resolves a diagram service.
+   *
+   * @template T
+   *
+   * @param {string} name The name of the service to get.
+   * @param {true} strict If false, resolve missing services to null.
+   *
+   * @return {T}
+   */
+  /**
+   * @overlord
+   *
+   * Resolves a diagram service.
+   *
+   * @template T
+   *
+   * @param {string} name The name of the service to get.
+   * @param {boolean} strict If false, resolve missing services to null.
+   *
+   * @return {T|null}
+   */
+  /**
+   * Resolves a diagram service.
+   *
+   * @template {keyof ServiceMap} Name
+   *
+   * @param {Name} name The name of the service to get.
+   *
+   * @return {ServiceMap[Name]}
+   */
+  Diagram.prototype.get = function(name, strict) {
+    return this._injector.get(name, strict);
+  };
+
+  /**
+   * @overlord
+   *
+   * Invoke the given function, injecting dependencies. Return the result.
+   *
+   * @template T
+   *
+   * @param {FactoryFunction<T>} func
+   * @param {InjectionContext} [context]
+   * @param {LocalsMap} [locals]
+   *
+   * @return {T}
+   */
+  /**
+   * Invoke the given function, injecting dependencies provided in
+   * array notation. Return the result.
+   *
+   * @template T
+   *
+   * @param {ArrayFunc<T>} func function to be invoked
+   * @param {InjectionContext} [context] context of the invocation
+   * @param {LocalsMap} [locals] locals provided
+   *
+   * @return {T}
+   */
+  Diagram.prototype.invoke = function(func, context, locals) {
+    return this._injector.invoke(func, context, locals);
+  };
 
   /**
    * Destroys the diagram
@@ -23560,7 +23666,11 @@
       return true;
     }
 
-    return isInput(event.target) && this._isModifiedKeyIgnored(event);
+    return (
+      isInput(event.target) || (
+        isButton(event.target) && isKey([ ' ', 'Enter' ], event)
+      )
+    ) && this._isModifiedKeyIgnored(event);
   };
 
   Keyboard.prototype._isModifiedKeyIgnored = function(event) {
@@ -23671,6 +23781,10 @@
     return target && (matches(target, 'input, textarea') || target.contentEditable === 'true');
   }
 
+  function isButton(target) {
+    return target && matches(target, 'button, input[type=submit], input[type=button], a[href], [aria-role=button]');
+  }
+
   var LOW_PRIORITY = 500;
 
 
@@ -24001,7 +24115,7 @@
   }
 
   /**
-   * @typedef {import('../core/EventBus').EventBus} EventBus
+   * @typedef {import('../core/EventBus').default} EventBus
    */
 
   var TRAP_PRIORITY = 5000;
@@ -24215,6 +24329,7 @@
    * @typedef {import('../../core/EventBus').default} EventBus
    *
    * @typedef {import('../../util/Types').Point} Point
+   * @typedef {import('../../util/Types').ScrollDelta} ScrollDelta
    */
 
   var sign = Math.sign || function(n) {
@@ -24269,7 +24384,7 @@
   ];
 
   /**
-   * @param {Point} delta
+   * @param {ScrollDelta} delta
    */
   ZoomScroll.prototype.scroll = function scroll(delta) {
     this._canvas.scroll(delta);
@@ -24369,7 +24484,7 @@
    * Zoom with fixed step size.
    *
    * @param {number} delta Zoom delta (1 for zooming in, -1 for zooming out).
-   * @param {Point} position
+   * @param {Point} [position]
    */
   ZoomScroll.prototype.stepZoom = function stepZoom(delta, position) {
 
@@ -24383,7 +24498,7 @@
    * Zoom in/out given a step size.
    *
    * @param {number} delta
-   * @param {Point} position
+   * @param {Point} [position]
    * @param {number} stepSize
    */
   ZoomScroll.prototype._zoom = function(delta, position, stepSize) {