bpmn-js 12.0.0 → 12.1.1

package/dist/bpmn-modeler.development.js

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-modeler v12.0.0
+ * bpmn-js - bpmn-modeler v12.1.1
  *
  * Copyright (c) 2014-present, camunda Services GmbH
  *
@@ -8,7 +8,7 @@
  *
  * Source Code: https://github.com/bpmn-io/bpmn-js
  *
- * Date: 2023-03-29
+ * Date: 2023-04-12
  */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -184,9 +184,11 @@
   /**
    * Flatten array, one level deep.
    *
-   * @param {Array<?>} arr
+   * @template T
    *
-   * @return {Array<?>}
+   * @param {T[][]} arr
+   *
+   * @return {T[]}
    */
   function flatten(arr) {
     return Array.prototype.concat.apply([], arr);
@@ -219,6 +221,11 @@
     return nativeToString$1.call(obj) === '[object Number]';
   }
 
+  /**
+   * @param {any} obj
+   *
+   * @return {boolean}
+   */
   function isFunction(obj) {
     const tag = nativeToString$1.call(obj);
 
@@ -262,22 +269,74 @@
     return nativeHasOwnProperty$1.call(target, key);
   }
 
+  /**
+   * @template T
+   * @typedef { (
+   *   ((e: T) => boolean) |
+   *   ((e: T, idx: number) => boolean) |
+   *   ((e: T, key: string) => boolean) |
+   *   string |
+   *   number
+   * ) } Matcher
+   */
+
+  /**
+   * @template T
+   * @template U
+   *
+   * @typedef { (
+   *   ((e: T) => U) | string | number
+   * ) } Extractor
+   */
+
+
+  /**
+   * @template T
+   * @typedef { (val: T, key: any) => boolean } MatchFn
+   */
+
+  /**
+   * @template T
+   * @typedef { T[] } ArrayCollection
+   */
+
+  /**
+   * @template T
+   * @typedef { { [key: string]: T } } StringKeyValueCollection
+   */
+
+  /**
+   * @template T
+   * @typedef { { [key: number]: T } } NumberKeyValueCollection
+   */
+
+  /**
+   * @template T
+   * @typedef { StringKeyValueCollection<T> | NumberKeyValueCollection<T> } KeyValueCollection
+   */
+
+  /**
+   * @template T
+   * @typedef { KeyValueCollection<T> | ArrayCollection<T> } Collection
+   */
+
   /**
    * Find element in collection.
    *
-   * @param  {Array|Object} collection
-   * @param  {Function|Object} matcher
+   * @template T
+   * @param {Collection<T>} collection
+   * @param {Matcher<T>} matcher
    *
    * @return {Object}
    */
   function find(collection, matcher) {
 
-    matcher = toMatcher(matcher);
+    const matchFn = toMatcher(matcher);
 
     let match;
 
     forEach$1(collection, function(val, key) {
-      if (matcher(val, key)) {
+      if (matchFn(val, key)) {
         match = val;
 
         return false;
@@ -292,19 +351,20 @@
   /**
    * Find element index in collection.
    *
-   * @param  {Array|Object} collection
-   * @param  {Function} matcher
+   * @template T
+   * @param {Collection<T>} collection
+   * @param {Matcher<T>} matcher
    *
-   * @return {Object}
+   * @return {number}
    */
   function findIndex(collection, matcher) {
 
-    matcher = toMatcher(matcher);
+    const matchFn = toMatcher(matcher);
 
     let idx = isArray$3(collection) ? -1 : undefined;
 
     forEach$1(collection, function(val, key) {
-      if (matcher(val, key)) {
+      if (matchFn(val, key)) {
         idx = key;
 
         return false;
@@ -316,19 +376,22 @@
 
 
   /**
-   * Find element in collection.
+   * Filter elements in collection.
    *
-   * @param  {Array|Object} collection
-   * @param  {Function} matcher
+   * @template T
+   * @param {Collection<T>} collection
+   * @param {Matcher<T>} matcher
    *
-   * @return {Array} result
+   * @return {T[]} result
    */
   function filter(collection, matcher) {
 
+    const matchFn = toMatcher(matcher);
+
     let result = [];
 
     forEach$1(collection, function(val, key) {
-      if (matcher(val, key)) {
+      if (matchFn(val, key)) {
         result.push(val);
       }
     });
@@ -341,10 +404,11 @@
    * Iterate over collection; returning something
    * (non-undefined) will stop iteration.
    *
-   * @param  {Array|Object} collection
-   * @param  {Function} iterator
+   * @template T
+   * @param {Collection<T>} collection
+   * @param { ((item: T, idx: number) => (boolean|void)) | ((item: T, key: string) => (boolean|void)) } iterator
    *
-   * @return {Object} return result that stopped the iteration
+   * @return {T} return result that stopped the iteration
    */
   function forEach$1(collection, iterator) {
 
@@ -374,10 +438,11 @@
   /**
    * Return collection without element.
    *
-   * @param  {Array} arr
-   * @param  {Function} matcher
+   * @template T
+   * @param {ArrayCollection<T>} arr
+   * @param {Matcher<T>} matcher
    *
-   * @return {Array}
+   * @return {T[]}
    */
   function without(arr, matcher) {
 
@@ -387,10 +452,10 @@
 
     ensureArray(arr);
 
-    matcher = toMatcher(matcher);
+    const matchFn = toMatcher(matcher);
 
     return arr.filter(function(el, idx) {
-      return !matcher(el, idx);
+      return !matchFn(el, idx);
     });
 
   }
@@ -399,11 +464,14 @@
   /**
    * Reduce collection, returning a single result.
    *
-   * @param  {Object|Array} collection
-   * @param  {Function} iterator
-   * @param  {Any} result
+   * @template T
+   * @template V
    *
-   * @return {Any} result returned from last iterator
+   * @param {Collection<T>} collection
+   * @param {(result: V, entry: T, index: any) => V} iterator
+   * @param {V} result
+   *
+   * @return {V} result returned from last iterator
    */
   function reduce(collection, iterator, result) {
 
@@ -507,8 +575,8 @@
   /**
    * Group collection members by attribute.
    *
-   * @param  {Object|Array} collection
-   * @param  {Function} extractor
+   * @param {Object|Array} collection
+   * @param {Extractor} extractor
    *
    * @return {Object} map with { attrValue => [ a, b, c ] }
    */
@@ -555,8 +623,10 @@
   /**
    * Sort collection by criteria.
    *
-   * @param  {Object|Array} collection
-   * @param  {String|Function} extractor
+   * @template T
+   *
+   * @param {Collection<T>} collection
+   * @param {Extractor<T, number | string>} extractor
    *
    * @return {Array}
    */
@@ -596,13 +666,17 @@
    *
    * @example
    *
+   * ```javascript
    * const matcher = matchPattern({ id: 1 });
    *
    * let element = find(elements, matcher);
+   * ```
    *
-   * @param  {Object} pattern
+   * @template T
+   *
+   * @param {T} pattern
    *
-   * @return {Function} matcherFn
+   * @return { (el: any) =>  boolean } matcherFn
    */
   function matchPattern(pattern) {
 
@@ -616,13 +690,30 @@
   }
 
 
+  /**
+   * @param {string | ((e: any) => any) } extractor
+   *
+   * @return { (e: any) => any }
+   */
   function toExtractor(extractor) {
+
+    /**
+     * @satisfies { (e: any) => any }
+     */
     return isFunction(extractor) ? extractor : (e) => {
+
+      // @ts-ignore: just works
       return e[extractor];
     };
   }
 
 
+  /**
+   * @template T
+   * @param {Matcher<T>} matcher
+   *
+   * @return {MatchFn<T>}
+   */
   function toMatcher(matcher) {
     return isFunction(matcher) ? matcher : (e) => {
       return e === matcher;
@@ -638,6 +729,16 @@
     return Number(arg);
   }
 
+  /* global setTimeout clearTimeout */
+
+  /**
+   * @typedef { {
+   *   (...args: any[]): any;
+   *   flush: () => void;
+   *   cancel: () => void;
+   * } } DebouncedFunction
+   */
+
   /**
    * Debounce fn, calling it only once if the given time
    * elapsed between calls.
@@ -648,7 +749,7 @@
    * @param  {Function} fn
    * @param  {Number} timeout
    *
-   * @return {Function} debounced function
+   * @return {DebouncedFunction} debounced function
    */
   function debounce(fn, timeout) {
 
@@ -694,6 +795,9 @@
       clear();
     }
 
+    /**
+     * @type { DebouncedFunction }
+     */
     function callback(...args) {
       lastNow = Date.now();
 
@@ -737,12 +841,15 @@
   }
 
   /**
-   * Pick given properties from the target object.
+   * Pick properties from the given target.
    *
-   * @param {Object} target
-   * @param {Array} properties
+   * @template T
+   * @template {any[]} V
+   *
+   * @param {T} target
+   * @param {V} properties
    *
-   * @return {Object} target
+   * @return Pick<T, V>
    */
   function pick(target, properties) {
 
@@ -763,10 +870,13 @@
   /**
    * Pick all target properties, excluding the given ones.
    *
-   * @param {Object} target
-   * @param {Array} properties
+   * @template T
+   * @template {any[]} V
+   *
+   * @param {T} target
+   * @param {V} properties
    *
-   * @return {Object} target
+   * @return {Omit<T, V>} target
    */
   function omit(target, properties) {
 
@@ -1110,9 +1220,13 @@
 
   var componentEvent = {};
 
-  var bind$1 = window.addEventListener ? 'addEventListener' : 'attachEvent',
-      unbind$1 = window.removeEventListener ? 'removeEventListener' : 'detachEvent',
-      prefix$6 = bind$1 !== 'addEventListener' ? 'on' : '';
+  var bind$1, unbind$1, prefix$6;
+
+  function detect () {
+    bind$1 = window.addEventListener ? 'addEventListener' : 'attachEvent';
+    unbind$1 = window.removeEventListener ? 'removeEventListener' : 'detachEvent';
+    prefix$6 = bind$1 !== 'addEventListener' ? 'on' : '';
+  }
 
   /**
    * Bind `el` event `type` to `fn`.
@@ -1126,6 +1240,7 @@
    */
 
   var bind_1 = componentEvent.bind = function(el, type, fn, capture){
+    if (!bind$1) detect();
     el[bind$1](prefix$6 + type, fn, capture || false);
     return fn;
   };
@@ -1142,6 +1257,7 @@
    */
 
   var unbind_1 = componentEvent.unbind = function(el, type, fn, capture){
+    if (!unbind$1) detect();
     el[unbind$1](prefix$6 + type, fn, capture || false);
     return fn;
   };
@@ -16479,7 +16595,7 @@
           BPMNIO_IMG +
         '</a>' +
         '<span>' +
-          'Web-based tooling for BPMN, DMN and CMMN diagrams ' +
+          'Web-based tooling for BPMN, DMN and forms ' +
           'powered by <a href="https://bpmn.io" target="_blank" rel="noopener">bpmn.io</a>.' +
         '</span>' +
       '</div>' +
@@ -28266,6 +28382,10 @@
 
     var handler = entry.action;
 
+    if (this._eventBus.fire('contextPad.trigger', { entry, event }) === false) {
+      return;
+    }
+
     // simple action (via callback function)
     if (isFunction(handler)) {
       if (action === 'click') {
@@ -29533,6 +29653,10 @@
 
     const handler = entry.action;
 
+    if (this._emit('trigger', { entry, event }) === false) {
+      return;
+    }
+
     if (isFunction(handler)) {
       if (action === 'click') {
         return handler(event, entry);
@@ -59725,6 +59849,10 @@
 
     handler = entry.action;
 
+    if (this._eventBus.fire('palette.trigger', { entry, event }) === false) {
+      return;
+    }
+
     // simple action (via callback function)
     if (isFunction(handler)) {
       if (action === 'click') {