bpmn-js 18.9.0 → 18.10.0

package/dist/bpmn-modeler.development.js

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-modeler v18.9.0
+ * bpmn-js - bpmn-modeler v18.10.0
  *
  * Copyright (c) 2014-present, camunda Services GmbH
  *
@@ -8,7 +8,7 @@
  *
  * Source Code: https://github.com/bpmn-io/bpmn-js
  *
- * Date: 2025-11-18
+ * Date: 2026-01-08
  */
 (function (global, factory) {
   typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -1830,7 +1830,7 @@
     return element;
   }
 
-  function clone$1(element) {
+  function clone(element) {
     return element.cloneNode(true);
   }
 
@@ -3675,6 +3675,12 @@
 
   /* eslint no-fallthrough: "off" */
 
+  /**
+   * @typedef { import('./intersect.js').Path } Path
+   * @typedef { import('./intersect.js').PathComponent } PathComponent
+   */
+
+
   var p2s = /,?([a-z]),?/gi,
       toFloat = parseFloat,
       math = Math,
@@ -3692,23 +3698,6 @@
     return Object.prototype.hasOwnProperty.call(obj, property);
   }
 
-  function clone(obj) {
-
-    if (typeof obj == 'function' || Object(obj) !== obj) {
-      return obj;
-    }
-
-    var res = new obj.constructor;
-
-    for (var key in obj) {
-      if (hasProperty(obj, key)) {
-        res[key] = clone(obj[key]);
-      }
-    }
-
-    return res;
-  }
-
   function repush(array, item) {
     for (var i = 0, ii = array.length; i < ii; i++) if (array[i] === item) {
       return array.push(array.splice(i, 1)[0]);
@@ -3738,77 +3727,84 @@
     return newf;
   }
 
+  /**
+   * Parse SVG path string and return an array of path components.
+   *
+   * @param {string} pathString
+   *
+   * @return {PathComponent[]}
+   */
   function parsePathString(pathString) {
 
     if (!pathString) {
       return null;
     }
 
-    var pth = paths(pathString);
-
-    if (pth.arr) {
-      return clone(pth.arr);
-    }
-
     var paramCounts = { a: 7, c: 6, h: 1, l: 2, m: 2, q: 4, s: 4, t: 2, v: 1, z: 0 },
-        data = [];
-
-    if (isArray(pathString) && isArray(pathString[0])) { // rough assumption
-      data = clone(pathString);
-    }
-
-    if (!data.length) {
+        pathComponents = [];
 
-      String(pathString).replace(pathCommand, function(a, b, c) {
-        var params = [],
-            name = b.toLowerCase();
+    String(pathString).replace(pathCommand, function(a, b, c) {
+      var params = [],
+          name = b.toLowerCase();
 
-        c.replace(pathValues, function(a, b) {
-          b && params.push(+b);
-        });
+      c.replace(pathValues, function(a, b) {
+        b && params.push(+b);
+      });
 
-        if (name == 'm' && params.length > 2) {
-          data.push([ b, ...params.splice(0, 2) ]);
-          name = 'l';
-          b = b == 'm' ? 'l' : 'L';
-        }
+      if (name == 'm' && params.length > 2) {
+        pathComponents.push([ b, ...params.splice(0, 2) ]);
+        name = 'l';
+        b = b == 'm' ? 'l' : 'L';
+      }
 
-        while (params.length >= paramCounts[name]) {
-          data.push([ b, ...params.splice(0, paramCounts[name]) ]);
-          if (!paramCounts[name]) {
-            break;
-          }
+      while (params.length >= paramCounts[name]) {
+        pathComponents.push([ b, ...params.splice(0, paramCounts[name]) ]);
+        if (!paramCounts[name]) {
+          break;
         }
-      });
-    }
+      }
+    });
 
-    data.toString = paths.toString;
-    pth.arr = clone(data);
+    pathComponents.toString = pathToString;
 
-    return data;
+    return pathComponents;
   }
 
-  function paths(ps) {
-    var p = paths.ps = paths.ps || {};
-
-    if (p[ps]) {
-      p[ps].sleep = 100;
-    } else {
-      p[ps] = {
-        sleep: 100
-      };
+  /**
+   * Checks if a path is already in absolute format.
+   * An absolute path has all uppercase commands.
+   *
+   * @param {PathComponent[]} pathComponents
+   * @return {boolean}
+   */
+  function isPathAbsolute(pathComponents) {
+    for (var i = 0, ii = pathComponents.length; i < ii; i++) {
+      var command = pathComponents[i][0];
+      if (typeof command === 'string' && command !== command.toUpperCase()) {
+        return false;
+      }
     }
 
-    setTimeout(function() {
-      for (var key in p) {
-        if (hasProperty(p, key) && key != ps) {
-          p[key].sleep--;
-          !p[key].sleep && delete p[key];
-        }
+    return true;
+  }
+
+  /**
+   * Checks if a path is already in curve format.
+   * A curve path only contains 'M' and 'C' commands.
+   *
+   * @param {PathComponent[]} pathComponents
+   *
+   * @return {boolean}
+   */
+  function isPathCurve(pathComponents) {
+    for (var i = 0, ii = pathComponents.length; i < ii; i++) {
+      var command = pathComponents[i][0];
+      if (command !== 'M' && command !== 'C') {
+        return false;
       }
-    });
+    }
 
-    return p[ps];
+    return true;
   }
 
   function rectBBox(x, y, width, height) {
@@ -3834,10 +3830,27 @@
     return this.join(',').replace(p2s, '$1');
   }
 
-  function pathClone(pathArray) {
-    var res = clone(pathArray);
-    res.toString = pathToString;
-    return res;
+  /**
+   * @param {PathComponent[]} pathComponents
+   *
+   * @return {PathComponent[]}
+   */
+  function pathClone(pathComponents) {
+
+    var pathComponentsClone = new Array(pathComponents.length);
+
+    for (var i = 0, ii = pathComponents.length; i < ii; i++) {
+      var component = pathComponents[i];
+      var componentClone = pathComponentsClone[i] = new Array(component.length);
+
+      for (var j = 0, jj = component.length; j < jj; j++) {
+        componentClone[j] = component[j];
+      }
+    }
+
+    pathComponentsClone.toString = pathToString;
+
+    return pathComponentsClone;
   }
 
   function findDotsAtSegment(p1x, p1y, c1x, c1y, c2x, c2y, p2x, p2y, t) {
@@ -3980,26 +3993,29 @@
 
     var l1 = bezlen(...bez1),
         l2 = bezlen(...bez2),
+        // eslint-disable-next-line no-bitwise
         n1 = isLine(bez1) ? 1 : ~~(l1 / 5) || 1,
+        // eslint-disable-next-line no-bitwise
         n2 = isLine(bez2) ? 1 : ~~(l2 / 5) || 1,
-        dots1 = [],
-        dots2 = [],
+        dots1 = new Array(n1 + 1),
+        dots2 = new Array(n2 + 1),
         xy = {},
-        res = [];
+        res = [],
+        i, j;
 
-    for (var i = 0; i < n1 + 1; i++) {
+    for (i = 0; i < n1 + 1; i++) {
       var p = findDotsAtSegment(...bez1, i / n1);
-      dots1.push({ x: p.x, y: p.y, t: i / n1 });
+      dots1[i] = { x: p.x, y: p.y, t: i / n1 };
     }
 
     for (i = 0; i < n2 + 1; i++) {
       p = findDotsAtSegment(...bez2, i / n2);
-      dots2.push({ x: p.x, y: p.y, t: i / n2 });
+      dots2[i] = { x: p.x, y: p.y, t: i / n2 };
     }
 
     for (i = 0; i < n1; i++) {
 
-      for (var j = 0; j < n2; j++) {
+      for (j = 0; j < n2; j++) {
         var di = dots1[i],
             di1 = dots1[i + 1],
             dj = dots2[j],
@@ -4050,11 +4066,16 @@
    * on each path (segment1, segment2) and the relative location of the
    * intersection on these segments (t1, t2).
    *
-   * The path may be an SVG path string or a list of path components
+   * The path may be an SVG path string or an array of path components
    * such as `[ [ 'M', 0, 10 ], [ 'L', 20, 0 ] ]`.
    *
+   * For performance optimization, pre-parsed paths can be passed directly,
+   * {@link parsePath | the parsePath utility} can be used to pre-parse any path.
+   *
    * @example
    *
+   * import findPathIntersections from 'path-intersection';
+   *
    * var intersections = findPathIntersections(
    *   'M0,0L100,100',
    *   [ [ 'M', 0, 100 ], [ 'L', 100, 0 ] ]
@@ -4064,11 +4085,11 @@
    * //   { x: 50, y: 50, segment1: 1, segment2: 1, t1: 0.5, t2: 0.5 }
    * // ]
    *
-   * @param {String|Array<PathDef>} path1
-   * @param {String|Array<PathDef>} path2
-   * @param {Boolean} [justCount=false]
+   * @param {Path} path1
+   * @param {Path} path2
+   * @param {boolean} [justCount=false]
    *
-   * @return {Array<Intersection>|Number}
+   * @return {Intersection[]|number}
    */
   function findPathIntersections(path1, path2, justCount) {
     path1 = pathToCurve(path1);
@@ -4134,23 +4155,30 @@
     return res;
   }
 
+  /**
+   * Test if path is a set of path components of the form
+   * `[ ['M', 0, 0 ], ['L', 100, 100], ...]`.
+   *
+   * @param {Path} path
+   *
+   * @return {boolean}
+   */
+  function isPathComponents(path) {
+    return isArray(path) && isArray(path[0]);
+  }
 
-  function pathToAbsolute(pathArray) {
-    var pth = paths(pathArray);
-
-    if (pth.abs) {
-      return pathClone(pth.abs);
-    }
-
-    if (!isArray(pathArray) || !isArray(pathArray && pathArray[0])) { // rough assumption
-      pathArray = parsePathString(pathArray);
-    }
+  /**
+   * @param {PathComponent[]} pathComponents
+   *
+   * @return {PathComponent[]}
+   */
+  function pathToAbsolute(pathComponents) {
 
-    if (!pathArray || !pathArray.length) {
-      return [ [ 'M', 0, 0 ] ];
+    if (isPathAbsolute(pathComponents)) {
+      return pathComponents;
     }
 
-    var res = [],
+    var res = new Array(pathComponents.length),
         x = 0,
         y = 0,
         mx = 0,
@@ -4158,19 +4186,19 @@
         start = 0,
         pa0;
 
-    if (pathArray[0][0] == 'M') {
-      x = +pathArray[0][1];
-      y = +pathArray[0][2];
+    if (pathComponents[0][0] == 'M') {
+      x = +pathComponents[0][1];
+      y = +pathComponents[0][2];
       mx = x;
       my = y;
       start++;
       res[0] = [ 'M', x, y ];
     }
 
-    for (var r, pa, i = start, ii = pathArray.length; i < ii; i++) {
-      res.push(r = []);
-      pa = pathArray[i];
+    for (var r, pa, i = start, ii = pathComponents.length; i < ii; i++) {
+      pa = pathComponents[i];
       pa0 = pa[0];
+      res[i] = (r = new Array(pa.length));
 
       if (pa0 != pa0.toUpperCase()) {
         r[0] = pa0.toUpperCase();
@@ -4227,7 +4255,6 @@
     }
 
     res.toString = pathToString;
-    pth.abs = pathClone(res);
 
     return res;
   }
@@ -4448,16 +4475,24 @@
     };
   }
 
+  /**
+   * Convert path to a curve.
+   *
+   * @param {Path} path
+   *
+   * @return {PathComponent[]}
+   */
   function pathToCurve(path) {
 
-    var pth = paths(path);
+    if (!isPathComponents(path)) {
+      path = parsePathString(path);
+    }
 
-    // return cached curve, if existing
-    if (pth.curve) {
-      return pathClone(pth.curve);
+    if (isPathCurve(path)) {
+      return path;
     }
 
-    var curvedPath = pathToAbsolute(path),
+    var curvedPath = pathClone(pathToAbsolute(path)),
         attrs = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null },
         processPath = function(path, d, pathCommand) {
           var nx, ny;
@@ -4581,9 +4616,6 @@
       attrs.by = toFloat(seg[seglen - 3]) || attrs.y;
     }
 
-    // cache curve
-    pth.curve = pathClone(curvedPath);
-
     return curvedPath;
   }
 
@@ -25356,6 +25388,7 @@
 
   var KEYS_COPY = [ 'c', 'C' ];
   var KEYS_PASTE = [ 'v', 'V' ];
+  var KEYS_DUPLICATE = [ 'd', 'D' ];
   var KEYS_REDO = [ 'y', 'Y' ];
   var KEYS_UNDO = [ 'z', 'Z' ];
 
@@ -25416,6 +25449,13 @@
     return isCmd(event) && isKey(KEYS_PASTE, event);
   }
 
+  /**
+   * @param {KeyboardEvent} event
+   */
+  function isDuplicate(event) {
+    return isCmd(event) && isKey(KEYS_DUPLICATE, event);
+  }
+
   /**
    * @param {KeyboardEvent} event
    */
@@ -25741,6 +25781,20 @@
       }
     });
 
+    // duplicate
+    // CTRL/CMD + D
+    addListener('duplicate', function(context) {
+
+      var event = context.keyEvent;
+
+      if (isDuplicate(event)) {
+        editorActions.trigger('duplicate');
+
+        return true;
+      }
+    });
+
+
     // zoom in one step
     // CTRL/CMD + +
     addListener('stepZoom', function(context) {
@@ -30690,7 +30744,7 @@
    * @typedef {import('../../core/EventBus').default} EventBus
    */
 
-  var HIGH_PRIORITY$j = 1500;
+  var HIGH_PRIORITY$k = 1500;
 
 
   /**
@@ -30758,7 +30812,7 @@
        */
       eventBus.on('drag.start', function(event) {
 
-        eventBus.once('drag.move', HIGH_PRIORITY$j, function(event) {
+        eventBus.once('drag.move', HIGH_PRIORITY$k, function(event) {
 
           ensureHover(event);
 
@@ -30789,7 +30843,7 @@
         hover = event.element;
       });
 
-      eventBus.on('element.hover', HIGH_PRIORITY$j, function(event) {
+      eventBus.on('element.hover', HIGH_PRIORITY$k, function(event) {
 
         // (3) am I on an element still?
         if (hover) {
@@ -32740,7 +32794,7 @@
       MARKER_CONNECT_UPDATING$1 = 'djs-updating',
       MARKER_DRAGGER = 'djs-dragging';
 
-  var HIGH_PRIORITY$i = 1100;
+  var HIGH_PRIORITY$j = 1100;
 
   /**
    * Preview connection while moving bendpoints.
@@ -32808,7 +32862,7 @@
     eventBus.on([
       'bendpoint.move.out',
       'bendpoint.move.cleanup'
-    ], HIGH_PRIORITY$i, function(event) {
+    ], HIGH_PRIORITY$j, function(event) {
       var context = event.context,
           hover = context.hover,
           target = context.target;
@@ -32894,7 +32948,7 @@
     eventBus.on([
       'bendpoint.move.end',
       'bendpoint.move.cancel'
-    ], HIGH_PRIORITY$i, function(event) {
+    ], HIGH_PRIORITY$j, function(event) {
       var context = event.context,
           connection = context.connection,
           draggerGfx = context.draggerGfx,
@@ -33910,7 +33964,7 @@
    * @typedef {import('../../core/EventBus').default} EventBus
    */
 
-  var HIGH_PRIORITY$h = 1100,
+  var HIGH_PRIORITY$i = 1100,
       LOW_PRIORITY$k = 900;
 
   var MARKER_OK$3 = 'connect-ok',
@@ -33971,7 +34025,7 @@
     eventBus.on([
       'connect.out',
       'connect.cleanup'
-    ], HIGH_PRIORITY$h, function(event) {
+    ], HIGH_PRIORITY$i, function(event) {
       var hover = event.hover;
 
       if (hover) {
@@ -34383,7 +34437,7 @@
   PreviewSupport.prototype.addDragger = function(element, group, gfx, className = 'djs-dragger') {
     gfx = gfx || this.getGfx(element);
 
-    var dragger = clone$1(gfx);
+    var dragger = clone(gfx);
     var bbox = gfx.getBoundingClientRect();
 
     this._cloneMarkers(getVisual(dragger), className);
@@ -34474,7 +34528,7 @@
 
     parentGfx = parentGfx || this._canvas._svg;
 
-    var clonedMarker = copiedMarker || clone$1(marker);
+    var clonedMarker = copiedMarker || clone(marker);
 
     clonedMarker.id = clonedMarkerId;
 
@@ -35505,7 +35559,7 @@
 
   var PARTICIPANT_BORDER_WIDTH = 30;
 
-  var HIGH_PRIORITY$g = 2000;
+  var HIGH_PRIORITY$h = 2000;
 
 
   /**
@@ -35522,7 +35576,7 @@
     eventBus.on([
       'create.start',
       'shape.move.start'
-    ], HIGH_PRIORITY$g, function(event) {
+    ], HIGH_PRIORITY$h, function(event) {
       var context = event.context,
           shape = context.shape,
           rootElement = canvas.getRootElement();
@@ -35557,7 +35611,7 @@
     });
 
     // force hovering process when creating first participant
-    eventBus.on('create.start', HIGH_PRIORITY$g, function(event) {
+    eventBus.on('create.start', HIGH_PRIORITY$h, function(event) {
       var context = event.context,
           shape = context.shape,
           rootElement = canvas.getRootElement(),
@@ -35569,7 +35623,7 @@
       }
 
       if (is(shape, 'bpmn:Participant') && is(rootElement, 'bpmn:Process')) {
-        eventBus.on('element.hover', HIGH_PRIORITY$g, ensureHoveringProcess);
+        eventBus.on('element.hover', HIGH_PRIORITY$h, ensureHoveringProcess);
 
         eventBus.once('create.cleanup', function() {
           eventBus.off('element.hover', ensureHoveringProcess);
@@ -35590,7 +35644,7 @@
 
     // when creating mutliple elements through `elements.create` parent must be set to collaboration
     // and passed to `shape.create` as hint
-    this.preExecute('elements.create', HIGH_PRIORITY$g, function(context) {
+    this.preExecute('elements.create', HIGH_PRIORITY$h, function(context) {
       var elements = context.elements,
           parent = context.parent,
           participant = findParticipant(elements),
@@ -37075,7 +37129,7 @@
    * @typedef {import('diagram-js/lib/core/Canvas').default} Canvas
    */
 
-  var HIGH_PRIORITY$f = 1500;
+  var HIGH_PRIORITY$g = 1500;
   var HIGHEST_PRIORITY = 2000;
 
 
@@ -37097,7 +37151,7 @@
       'shape.move.move',
       'shape.move.out',
       'shape.move.end'
-    ], HIGH_PRIORITY$f, function(event) {
+    ], HIGH_PRIORITY$g, function(event) {
       var context = event.context,
           shape = context.shape || event.shape,
           hover = event.hover;
@@ -37128,7 +37182,7 @@
       'global-connect.out',
       'global-connect.end',
       'global-connect.cleanup'
-    ], HIGH_PRIORITY$f, function(event) {
+    ], HIGH_PRIORITY$g, function(event) {
       var hover = event.hover;
 
       // ensure connections start/end on bpmn:Participant,
@@ -37142,7 +37196,7 @@
 
     eventBus.on([
       'bendpoint.move.hover'
-    ], HIGH_PRIORITY$f, function(event) {
+    ], HIGH_PRIORITY$g, function(event) {
       var context = event.context,
           hover = event.hover,
           type = context.type;
@@ -37158,7 +37212,7 @@
 
     eventBus.on([
       'connect.start'
-    ], HIGH_PRIORITY$f, function(event) {
+    ], HIGH_PRIORITY$g, function(event) {
       var context = event.context,
           start = context.start;
 
@@ -39616,7 +39670,7 @@
     'selection'
   ];
 
-  var HIGH_PRIORITY$e = 1500;
+  var HIGH_PRIORITY$f = 1500;
 
   /**
    * @typedef {import('diagram-js/lib/core/EventBus').default} EventBus
@@ -39669,7 +39723,7 @@
    * @param {EventBus} eventBus
    */
   function ResizeBehavior$1(eventBus) {
-    eventBus.on('resize.start', HIGH_PRIORITY$e, function(event) {
+    eventBus.on('resize.start', HIGH_PRIORITY$f, function(event) {
       var context = event.context,
           shape = context.shape,
           direction = context.direction,
@@ -40317,7 +40371,7 @@
    */
 
   var LOW_PRIORITY$f = 400;
-  var HIGH_PRIORITY$d = 600;
+  var HIGH_PRIORITY$e = 600;
 
   var DEFAULT_POSITION = {
     x: 180,
@@ -40604,7 +40658,7 @@
     }, true);
 
     // move elements between planes
-    this.postExecuted('shape.toggleCollapse', HIGH_PRIORITY$d, function(context) {
+    this.postExecuted('shape.toggleCollapse', HIGH_PRIORITY$e, function(context) {
       var shape = context.shape;
 
       if (!is(shape, 'bpmn:SubProcess')) {
@@ -41290,7 +41344,7 @@
    */
 
   var LOW_PRIORITY$d = 500,
-      HIGH_PRIORITY$c = 5000;
+      HIGH_PRIORITY$d = 5000;
 
 
   /**
@@ -41363,7 +41417,7 @@
 
     // listen to a lot of stuff to group lane updates
 
-    this.preExecute(laneRefUpdateEvents, HIGH_PRIORITY$c, function(event) {
+    this.preExecute(laneRefUpdateEvents, HIGH_PRIORITY$d, function(event) {
       initContext();
     });
 
@@ -42773,7 +42827,7 @@
    * @typedef {import('diagram-js/lib/core/Canvas').default} Canvas
    */
 
-  var HIGH_PRIORITY$b = 2000;
+  var HIGH_PRIORITY$c = 2000;
 
   /**
    * @param {EventBus} eventBus
@@ -42781,7 +42835,7 @@
    */
   function BpmnDiOrdering(eventBus, canvas) {
 
-    eventBus.on('saveXML.start', HIGH_PRIORITY$b, orderDi);
+    eventBus.on('saveXML.start', HIGH_PRIORITY$c, orderDi);
 
     function orderDi() {
       var rootElements = canvas.getRootElements();
@@ -43149,7 +43203,7 @@
 
   var PREFIX = 'create';
 
-  var HIGH_PRIORITY$a = 2000;
+  var HIGH_PRIORITY$b = 2000;
 
 
   /**
@@ -43377,7 +43431,7 @@
     eventBus.on('create.init', function() {
       eventBus.on('elements.changed', cancel);
 
-      eventBus.once([ 'create.cancel', 'create.end' ], HIGH_PRIORITY$a, function() {
+      eventBus.once([ 'create.cancel', 'create.end' ], HIGH_PRIORITY$b, function() {
         eventBus.off('elements.changed', cancel);
       });
     });
@@ -43733,6 +43787,33 @@
    * @typedef { (event: { hints: any }) => void } CopyPastePasteElementsListener
    */
 
+  /**
+   * @typedef { any } Tree
+   */
+
+  /**
+   * @typedef { {
+   *   element: Shape,
+   *   point: Point
+   * } } DirectPasteContext
+   *
+   * @typedef { {
+   *   hints?: Object,
+   *   tree?: Tree
+   * } } BasePasteContext
+   *
+   * @typedef { {
+   *   hints?: Object
+   * } } BaseDuplicateContext
+   *
+   * @typedef { BasePasteContext & (DirectPasteContext | {}) } PasteContext
+   *
+   * @typedef { BaseDuplicateContext & (DirectPasteContext | {}) } DuplicateContext
+   */
+
+
+  var HIGH_PRIORITY$a = 2000;
+
   /**
    * Copy and paste elements.
    *
@@ -43758,7 +43839,6 @@
 
     this._canvas = canvas;
     this._create = create;
-    this._clipboard = clipboard;
     this._elementFactory = elementFactory;
     this._eventBus = eventBus;
     this._modeling = modeling;
@@ -43819,6 +43899,22 @@
 
     });
 
+    eventBus.on('copyPaste.elementsCopied', HIGH_PRIORITY$a, function(context) {
+
+      if (context.hints?.clip !== false) {
+
+        // we set an empty tree, selection of elements
+        // to copy was empty.
+        clipboard.set(context.tree);
+      }
+    });
+
+    eventBus.on('copyPaste.pasteElements', HIGH_PRIORITY$a, function(context) {
+      if (!context.tree) {
+        context.tree = clipboard.get();
+      }
+    });
+
     eventBus.on('copyPaste.pasteElements', function(context) {
       var hints = context.hints;
 
@@ -43841,13 +43937,15 @@
 
 
   /**
-   * Copy elements.
+   * Copy elements. Will put elements into a {@link Clipboard} unless
+   * specified otherwise.
    *
    * @param {Element[]} elements
+   * @param {{ clip: boolean }} [hints]
    *
-   * @return {Object}
+   * @return { Tree }
    */
-  CopyPaste.prototype.copy = function(elements) {
+  CopyPaste.prototype.copy = function(elements, hints = {}) {
     var allowed,
         tree;
 
@@ -43865,13 +43963,10 @@
       tree = this.createTree(isArray$3(allowed) ? allowed : elements);
     }
 
-    // we set an empty tree, selection of elements
-    // to copy was empty.
-    this._clipboard.set(tree);
-
     this._eventBus.fire('copyPaste.elementsCopied', {
       elements: elements,
-      tree: tree
+      tree: tree,
+      hints: hints
     });
 
     return tree;
@@ -43880,36 +43975,61 @@
   /**
    * Paste elements.
    *
-   * @param {Object} [context]
-   * @param {Shape} [context.element] The optional parent.
-   * @param {Point} [context.point] The optional position.
-   * @param {Object} [context.hints] The optional hints.
+   * @param {PasteContext} [context]
    */
-  CopyPaste.prototype.paste = function(context) {
-    var tree = this._clipboard.get();
+  CopyPaste.prototype.paste = function(context = {}) {
 
-    if (this._clipboard.isEmpty()) {
+    var pasteEvent = this._eventBus.createEvent({
+      type: 'copyPaste.pasteElements',
+      hints: { },
+      ...context
+    });
+
+    var canPaste = this._eventBus.fire(pasteEvent);
+
+    if (canPaste === false) {
       return;
     }
 
-    var hints = context && context.hints || {};
+    var tree = pasteEvent.tree;
 
-    this._eventBus.fire('copyPaste.pasteElements', {
-      hints: hints
-    });
+    if (!tree) {
+      return;
+    }
+
+    var hints = pasteEvent.hints;
 
     var elements = this._createElements(tree);
 
     // paste directly
-    if (context && context.element && context.point) {
-      return this._paste(elements, context.element, context.point, hints);
+    if (pasteEvent.element && pasteEvent.point) {
+      return this._paste(elements, pasteEvent.element, pasteEvent.point, hints);
     }
 
     this._create.start(this._mouse.getLastMoveEvent(), elements, {
-      hints: hints || {}
+      hints: hints
+    });
+  };
+
+  /**
+   * Duplicate the given elements into the specified paste context.
+   *
+   * @param {Element[]} elements
+   * @param {DuplicateContext} pasteContext
+   *
+   * @return {Element[]|undefined} the pasted elements, if direct paste happened.
+   */
+  CopyPaste.prototype.duplicate = function(elements, pasteContext = {}) {
+
+    var tree = this.copy(elements, { clip: false });
+
+    return this.paste({
+      ...pasteContext,
+      tree
     });
   };
 
+
   /**
    * Paste elements directly.
    *
@@ -43955,6 +44075,10 @@
 
   /**
    * Create elements from tree.
+   *
+   * @param {Tree} tree
+   *
+   * @return {Element[]} elements
    */
   CopyPaste.prototype._createElements = function(tree) {
     var self = this;
@@ -58455,6 +58579,16 @@
       });
     }
 
+    if (copyPaste && selection) {
+      this.register('duplicate', function() {
+        var selectedElements = selection.get();
+
+        if (selectedElements.length) {
+          return copyPaste.duplicate(selectedElements);
+        }
+      });
+    }
+
     if (copyPaste) {
       this.register('paste', function() {
         copyPaste.paste();
@@ -61776,7 +61910,7 @@
 
     eventBus.on('shape.changed', function({ element }) {
 
-      if (!isAny(element, ALLOWED_ELEMENTS)) {
+      if (!isAny(element, ALLOWED_ELEMENTS) || !isElementSelected(element)) {
         return;
       }
 
@@ -61878,6 +62012,10 @@
     function getElementPath(element) {
       return graphicsFactory.getShapePath(element);
     }
+
+    function isElementSelected(element) {
+      return selection.get().includes(element);
+    }
   }
 
   LabelLink$1.$inject = [