bpmn-js 9.0.0-subprocesses.3 → 9.0.2

package/dist/bpmn-viewer.development.js

@@ -1,5 +1,5 @@
 /*!
- * bpmn-js - bpmn-viewer v9.0.0-subprocesses.3
+ * bpmn-js - bpmn-viewer v9.0.2
  *
  * Copyright (c) 2014-present, camunda Services GmbH
  *
@@ -8,7 +8,7 @@
  *
  * Source Code: https://github.com/bpmn-io/bpmn-js
  *
- * Date: 2021-11-19
+ * Date: 2022-02-23
  */
 (function (global, factory) {
 	typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -207,6 +207,23 @@
 	function some(collection, matcher) {
 	  return !!find(collection, matcher);
 	}
+	/**
+	 * Transform a collection into another collection
+	 * by piping each member through the given fn.
+	 *
+	 * @param  {Object|Array}   collection
+	 * @param  {Function} fn
+	 *
+	 * @return {Array} transformed collection
+	 */
+
+	function map$1(collection, fn) {
+	  var result = [];
+	  forEach(collection, function (val, key) {
+	    result.push(fn(val, key));
+	  });
+	  return result;
+	}
 	/**
 	 * Create an object pattern matcher.
 	 *
@@ -214,7 +231,7 @@
 	 *
 	 * const matcher = matchPattern({ id: 1 });
 	 *
-	 * var element = find(elements, matcher);
+	 * let element = find(elements, matcher);
 	 *
 	 * @param  {Object} pattern
 	 *
@@ -244,8 +261,11 @@
 	}
 
 	/**
-	 * Debounce fn, calling it only once if
-	 * the given time elapsed between calls.
+	 * Debounce fn, calling it only once if the given time
+	 * elapsed between calls.
+	 *
+	 * Lodash-style the function exposes methods to `#clear`
+	 * and `#flush` to control internal behavior.
 	 *
 	 * @param  {Function} fn
 	 * @param  {Number} timeout
@@ -258,23 +278,39 @@
 	  var lastThis;
 	  var lastNow;
 
-	  function fire() {
+	  function fire(force) {
 	    var now = Date.now();
-	    var scheduledDiff = lastNow + timeout - now;
+	    var scheduledDiff = force ? 0 : lastNow + timeout - now;
 
 	    if (scheduledDiff > 0) {
 	      return schedule(scheduledDiff);
 	    }
 
 	    fn.apply(lastThis, lastArgs);
-	    timer = lastNow = lastArgs = lastThis = undefined;
+	    clear();
 	  }
 
 	  function schedule(timeout) {
 	    timer = setTimeout(fire, timeout);
 	  }
 
-	  return function () {
+	  function clear() {
+	    if (timer) {
+	      clearTimeout(timer);
+	    }
+
+	    timer = lastNow = lastArgs = lastThis = undefined;
+	  }
+
+	  function flush() {
+	    if (timer) {
+	      fire(true);
+	    }
+
+	    clear();
+	  }
+
+	  function callback() {
 	    lastNow = Date.now();
 
 	    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
@@ -287,7 +323,11 @@
 	    if (!timer) {
 	      schedule(timeout);
 	    }
-	  };
+	  }
+
+	  callback.flush = flush;
+	  callback.cancel = clear;
+	  return callback;
 	}
 	/**
 	 * Bind function against target <this>.
@@ -476,7 +516,6 @@
 	  return bo && (typeof bo.$instanceOf === 'function') && bo.$instanceOf(type);
 	}
 
-
 	/**
 	 * Return the business object for a given element.
 	 *
@@ -2530,16 +2569,16 @@
 	    return drawPath(parentGfx, path, assign({ 'data-marker': type }, attrs));
 	  }
 
+	  function renderer(type) {
+	    return handlers[type];
+	  }
+
 	  function as(type) {
 	    return function(parentGfx, element) {
-	      return handlers[type](parentGfx, element);
+	      return renderer(type)(parentGfx, element);
 	    };
 	  }
 
-	  function renderer(type) {
-	    return handlers[type];
-	  }
-
 	  function renderEventContent(element, parentGfx) {
 
 	    var event = getSemantic(element);
@@ -4020,6 +4059,7 @@
 	  // extension API, use at your own risk
 	  this._drawPath = drawPath;
 
+	  this._renderer = renderer;
 	}
 
 
@@ -4041,7 +4081,7 @@
 
 	BpmnRenderer.prototype.drawShape = function(parentGfx, element) {
 	  var type = element.type;
-	  var h = this.handlers[type];
+	  var h = this._renderer(type);
 
 	  /* jshint -W040 */
 	  return h(parentGfx, element);
@@ -4049,7 +4089,7 @@
 
 	BpmnRenderer.prototype.drawConnection = function(parentGfx, element) {
 	  var type = element.type;
-	  var h = this.handlers[type];
+	  var h = this._renderer(type);
 
 	  /* jshint -W040 */
 	  return h(parentGfx, element);
@@ -5259,6 +5299,13 @@
 	  return '<' + e.$type + (e.id ? ' id="' + e.id : '') + '" />';
 	}
 
+	/**
+	 * @param {ModdleElement} semantic
+	 * @param {ModdleElement} di
+	 * @param {Object} [attrs=null]
+	 *
+	 * @return {Object}
+	 */
 	function elementData(semantic, di, attrs) {
 	  return assign({
 	    id: semantic.id,
@@ -5338,15 +5385,14 @@
 	  // invisible root element (process, subprocess or collaboration)
 	  if (is$1(di, 'bpmndi:BPMNPlane')) {
 
-	    // add a virtual element (not being drawn)
-	    element = this._elementFactory.createRoot(elementData(semantic, di));
+	    var attrs = is$1(semantic, 'bpmn:SubProcess')
+	      ? { id: semantic.id + '_plane' }
+	      : {};
 
-	    // for subprocesses, the id is already defined on the collapsed shape
-	    if (is$1(semantic, 'bpmn:SubProcess')) {
-	      element.id = element.id + '_plane';
-	    }
+	    // add a virtual element (not being drawn)
+	    element = this._elementFactory.createRoot(elementData(semantic, di, attrs));
 
-	    this._canvas.createPlane(semantic.id, element);
+	    this._canvas.addRootElement(element);
 	  }
 
 	  // SHAPE
@@ -5382,7 +5428,7 @@
 
 	      // check whether data store is inside our outside of its semantic parent
 	      if (!isPointInsideBBox(parentElement, getMid(bounds))) {
-	        parentElement = this._canvas.findPlane(parentElement).rootElement;
+	        parentElement = this._canvas.findRoot(parentElement);
 	      }
 	    }
 
@@ -5410,7 +5456,7 @@
 	      // are rendered correctly across different "hacks" people
 	      // love to model such as cross participant / sub process
 	      // associations
-	      parentElement = this._canvas.findPlane(parentElement).rootElement;
+	      parentElement = this._canvas.findRoot(parentElement);
 	    }
 
 	    // insert sequence flows behind other flow nodes (cf. #727)
@@ -5644,7 +5690,7 @@
 	  return isPrimaryButton(event) || isAuxiliaryButton(event);
 	}
 
-	var LOW_PRIORITY$2 = 500;
+	var LOW_PRIORITY$3 = 500;
 
 
 	/**
@@ -5839,7 +5885,7 @@
 	  eventBus.on([
 	    'shape.changed',
 	    'connection.changed'
-	  ], LOW_PRIORITY$2, function(event) {
+	  ], LOW_PRIORITY$3, function(event) {
 
 	    var element = event.element,
 	        gfx = event.gfx;
@@ -5847,7 +5893,7 @@
 	    eventBus.fire('interactionEvents.updateHit', { element: element, gfx: gfx });
 	  });
 
-	  eventBus.on('interactionEvents.createHit', LOW_PRIORITY$2, function(event) {
+	  eventBus.on('interactionEvents.createHit', LOW_PRIORITY$3, function(event) {
 	    var element = event.element,
 	        gfx = event.gfx;
 
@@ -6195,7 +6241,7 @@
 	  return !!(element && element.isFrame);
 	}
 
-	var LOW_PRIORITY$1 = 500;
+	var LOW_PRIORITY$2 = 500;
 
 
 	/**
@@ -6233,7 +6279,7 @@
 
 	  // A low priortity is necessary, because outlines of labels have to be updated
 	  // after the label bounds have been updated in the renderer.
-	  eventBus.on([ 'shape.added', 'shape.changed' ], LOW_PRIORITY$1, function(event) {
+	  eventBus.on([ 'shape.added', 'shape.changed' ], LOW_PRIORITY$2, function(event) {
 	    var element = event.element,
 	        gfx = event.gfx;
 
@@ -6330,7 +6376,7 @@
 	    self.deselect(element);
 	  });
 
-	  eventBus.on([ 'diagram.clear', 'plane.set' ], function(e) {
+	  eventBus.on([ 'diagram.clear', 'root.set' ], function(e) {
 	    self.select(null);
 	  });
 	}
@@ -6383,10 +6429,12 @@
 
 	  var canvas = this._canvas;
 
+	  var rootElement = canvas.getRootElement();
+
 	  elements = elements.filter(function(element) {
-	    var plane = canvas.findPlane(element);
+	    var elementRoot = canvas.findRoot(element);
 
-	    return plane === canvas.getActivePlane();
+	    return rootElement === elementRoot;
 	  });
 
 	  // selection may be cleared by passing an empty array or null
@@ -6627,7 +6675,7 @@
 	// document wide unique overlay ids
 	var ids = new IdGenerator('ov');
 
-	var LOW_PRIORITY = 500;
+	var LOW_PRIORITY$1 = 500;
 
 
 	/**
@@ -6857,8 +6905,7 @@
 	 *
 	 * @see Overlays#get for filter options.
 	 *
-	 * @param {string} [id]
-	 * @param {Object} [filter]
+	 * @param {string|object} [filter]
 	 */
 	Overlays.prototype.remove = function(filter) {
 
@@ -6974,6 +7021,7 @@
 	  }
 
 	  setPosition(htmlContainer, left || 0, top || 0);
+	  this._updateOverlayVisibilty(overlay, this._canvas.viewbox());
 	};
 
 
@@ -7057,12 +7105,10 @@
 	    classes(htmlContainer).add('djs-overlay-' + overlay.type);
 	  }
 
-	  var plane = this._canvas.findPlane(element);
-	  var activePlane = this._canvas.getActivePlane();
-	  overlay.plane = plane;
-	  if (plane !== activePlane) {
-	    setVisible(htmlContainer, false);
-	  }
+	  var elementRoot = this._canvas.findRoot(element);
+	  var activeRoot = this._canvas.getRootElement();
+
+	  setVisible(htmlContainer, elementRoot === activeRoot);
 
 	  overlay.htmlContainer = htmlContainer;
 
@@ -7078,14 +7124,14 @@
 
 	Overlays.prototype._updateOverlayVisibilty = function(overlay, viewbox) {
 	  var show = overlay.show,
-	      plane = overlay.plane,
+	      rootElement = this._canvas.findRoot(overlay.element),
 	      minZoom = show && show.minZoom,
 	      maxZoom = show && show.maxZoom,
 	      htmlContainer = overlay.htmlContainer,
-	      activePlane = this._canvas.getActivePlane(),
+	      activeRootElement = this._canvas.getRootElement(),
 	      visible = true;
 
-	  if (plane !== activePlane) {
+	  if (rootElement !== activeRootElement) {
 	    visible = false;
 	  } else if (show) {
 	    if (
@@ -7196,7 +7242,7 @@
 
 	  // move integration
 
-	  eventBus.on('element.changed', LOW_PRIORITY, function(e) {
+	  eventBus.on('element.changed', LOW_PRIORITY$1, function(e) {
 	    var element = e.element;
 
 	    var container = self._getOverlayContainer(element, true);
@@ -7221,10 +7267,8 @@
 	  });
 
 
-	  eventBus.on('plane.set', function(e) {
-	    forEach(self._overlays, function(el) {
-	      setVisible(el.htmlContainer, el.plane === e.plane);
-	    });
+	  eventBus.on('root.set', function() {
+	    self._updateOverlaysVisibilty(self._canvas.viewbox());
 	  });
 
 	  // clear overlays with diagram
@@ -7337,6 +7381,181 @@
 	  changeSupport: [ 'type', ChangeSupport ]
 	};
 
+	var DEFAULT_PRIORITY$1 = 1000;
+
+	/**
+	 * A utility that can be used to plug-in into the command execution for
+	 * extension and/or validation.
+	 *
+	 * @param {EventBus} eventBus
+	 *
+	 * @example
+	 *
+	 * import inherits from 'inherits';
+	 *
+	 * import CommandInterceptor from 'diagram-js/lib/command/CommandInterceptor';
+	 *
+	 * function CommandLogger(eventBus) {
+	 *   CommandInterceptor.call(this, eventBus);
+	 *
+	 *   this.preExecute(function(event) {
+	 *     console.log('command pre-execute', event);
+	 *   });
+	 * }
+	 *
+	 * inherits(CommandLogger, CommandInterceptor);
+	 *
+	 */
+	function CommandInterceptor(eventBus) {
+	  this._eventBus = eventBus;
+	}
+
+	CommandInterceptor.$inject = [ 'eventBus' ];
+
+	function unwrapEvent(fn, that) {
+	  return function(event) {
+	    return fn.call(that || null, event.context, event.command, event);
+	  };
+	}
+
+	/**
+	 * Register an interceptor for a command execution
+	 *
+	 * @param {string|Array<string>} [events] list of commands to register on
+	 * @param {string} [hook] command hook, i.e. preExecute, executed to listen on
+	 * @param {number} [priority] the priority on which to hook into the execution
+	 * @param {Function} handlerFn interceptor to be invoked with (event)
+	 * @param {boolean} unwrap if true, unwrap the event and pass (context, command, event) to the
+	 *                          listener instead
+	 * @param {Object} [that] Pass context (`this`) to the handler function
+	 */
+	CommandInterceptor.prototype.on = function(events, hook, priority, handlerFn, unwrap, that) {
+
+	  if (isFunction(hook) || isNumber(hook)) {
+	    that = unwrap;
+	    unwrap = handlerFn;
+	    handlerFn = priority;
+	    priority = hook;
+	    hook = null;
+	  }
+
+	  if (isFunction(priority)) {
+	    that = unwrap;
+	    unwrap = handlerFn;
+	    handlerFn = priority;
+	    priority = DEFAULT_PRIORITY$1;
+	  }
+
+	  if (isObject(unwrap)) {
+	    that = unwrap;
+	    unwrap = false;
+	  }
+
+	  if (!isFunction(handlerFn)) {
+	    throw new Error('handlerFn must be a function');
+	  }
+
+	  if (!isArray$1(events)) {
+	    events = [ events ];
+	  }
+
+	  var eventBus = this._eventBus;
+
+	  forEach(events, function(event) {
+
+	    // concat commandStack(.event)?(.hook)?
+	    var fullEvent = [ 'commandStack', event, hook ].filter(function(e) { return e; }).join('.');
+
+	    eventBus.on(fullEvent, priority, unwrap ? unwrapEvent(handlerFn, that) : handlerFn, that);
+	  });
+	};
+
+
+	var hooks = [
+	  'canExecute',
+	  'preExecute',
+	  'preExecuted',
+	  'execute',
+	  'executed',
+	  'postExecute',
+	  'postExecuted',
+	  'revert',
+	  'reverted'
+	];
+
+	/*
+	 * Install hook shortcuts
+	 *
+	 * This will generate the CommandInterceptor#(preExecute|...|reverted) methods
+	 * which will in term forward to CommandInterceptor#on.
+	 */
+	forEach(hooks, function(hook) {
+
+	  /**
+	   * {canExecute|preExecute|preExecuted|execute|executed|postExecute|postExecuted|revert|reverted}
+	   *
+	   * A named hook for plugging into the command execution
+	   *
+	   * @param {string|Array<string>} [events] list of commands to register on
+	   * @param {number} [priority] the priority on which to hook into the execution
+	   * @param {Function} handlerFn interceptor to be invoked with (event)
+	   * @param {boolean} [unwrap=false] if true, unwrap the event and pass (context, command, event) to the
+	   *                          listener instead
+	   * @param {Object} [that] Pass context (`this`) to the handler function
+	   */
+	  CommandInterceptor.prototype[hook] = function(events, priority, handlerFn, unwrap, that) {
+
+	    if (isFunction(events) || isNumber(events)) {
+	      that = unwrap;
+	      unwrap = handlerFn;
+	      handlerFn = priority;
+	      priority = events;
+	      events = null;
+	    }
+
+	    this.on(events, hook, priority, handlerFn, unwrap, that);
+	  };
+	});
+
+	/**
+	 * A modeling behavior that ensures we set the correct root element
+	 * as we undo and redo commands.
+	 *
+	 * @param {Canvas} canvas
+	 * @param {didi.Injector} injector
+	 */
+	function RootElementsBehavior(canvas, injector) {
+
+	  injector.invoke(CommandInterceptor, this);
+
+	  this.executed(function(event) {
+	    var context = event.context;
+
+	    if (context.rootElement) {
+	      canvas.setRootElement(context.rootElement);
+	    } else {
+	      context.rootElement = canvas.getRootElement();
+	    }
+	  });
+
+	  this.revert(function(event) {
+	    var context = event.context;
+
+	    if (context.rootElement) {
+	      canvas.setRootElement(context.rootElement);
+	    }
+	  });
+	}
+
+	inherits$1(RootElementsBehavior, CommandInterceptor);
+
+	RootElementsBehavior.$inject = [ 'canvas', 'injector'];
+
+	var RootElementsModule = {
+	  __init__: [ 'rootElementsBehavior' ],
+	  rootElementsBehavior: [ 'type', RootElementsBehavior ]
+	};
+
 	var css_escape = {exports: {}};
 
 	/*! https://mths.be/cssescape v1.5.1 by @mathias | MIT license */
@@ -7459,39 +7678,94 @@
 	  });
 	}
 
-	var ARROW_DOWN_SVG = '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M4.81801948,3.50735931 L10.4996894,9.1896894 L10.5,4 L12,4 L12,12 L4,12 L4,10.5 L9.6896894,10.4996894 L3.75735931,4.56801948 C3.46446609,4.27512627 3.46446609,3.80025253 3.75735931,3.50735931 C4.05025253,3.21446609 4.52512627,3.21446609 4.81801948,3.50735931 Z"/></svg>';
+	var planeSuffix = '_plane';
+
+	/**
+	 * Get plane ID for a primary shape.
+	 *
+	 * @param  {djs.model.Base|ModdleElement} element
+	 *
+	 * @returns {String}
+	 */
+	function getPlaneIdFromShape(element) {
+	  var id = element.id;
+
+	  if (is$1(element, 'bpmn:SubProcess')) {
+	    return addPlaneSuffix(id);
+	  }
+
+	  return id;
+	}
+
+	function addPlaneSuffix(id) {
+	  return id + planeSuffix;
+	}
 
 	var OPEN_CLASS = 'bjs-breadcrumbs-shown';
 
+
 	/**
-	 * Adds Overlays that allow switching planes on collapsed subprocesses.
+	 * Adds overlays that allow switching planes on collapsed subprocesses.
 	 *
 	 * @param {eventBus} eventBus
 	 * @param {elementRegistry} elementRegistry
 	 * @param {overlays} overlays
 	 * @param {canvas} canvas
 	 */
-	function DrilldownOverlays(eventBus, elementRegistry, overlays, canvas) {
+	function DrilldownBreadcrumbs(eventBus, elementRegistry, overlays, canvas) {
 	  var breadcrumbs = domify('<ul class="bjs-breadcrumbs"></ul>');
 	  var container = canvas.getContainer();
 	  var containerClasses = classes(container);
 	  container.appendChild(breadcrumbs);
 
-	  function updateBreadcrumbs(plane) {
-	    var subProcess = elementRegistry.get(plane.name);
-	    var parents = getParentChain(subProcess);
+	  var boParents = [];
+
+	  // update breadcrumbs if name or ID of the primary shape changes
+	  eventBus.on('element.changed', function(e) {
+	    var shape = e.element,
+	        bo = getBusinessObject(shape);
+
+	    var isPresent = find(boParents, function(el) {
+	      return el === bo;
+	    });
 
-	    var path = parents.map(function(el) {
-	      var title = escapeHTML(el.name || el.id);
+	    if (!isPresent) {
+	      return;
+	    }
+
+	    updateBreadcrumbs();
+	  });
+
+	  /**
+	   * Updates the displayed breadcrumbs. If no element is provided, only the
+	   * labels are updated.
+	   *
+	   * @param {djs.model.Base} [element]
+	   */
+	  function updateBreadcrumbs(element) {
+	    if (element) {
+	      boParents = getBoParentChain(element);
+	    }
+
+	    var path = boParents.map(function(parent) {
+	      var title = escapeHTML(parent.name || parent.id);
 	      var link = domify('<li><span class="bjs-crumb"><a title="' + title + '">' + title + '</a></span></li>');
 
+	      var parentPlane = canvas.findRoot(getPlaneIdFromShape(parent)) || canvas.findRoot(parent.id);
+
+	      // when the root is a collaboration, the process does not have a corresponding
+	      // element in the elementRegisty. Instead, we search for the corresponding participant
+	      if (!parentPlane && is$1(parent, 'bpmn:Process')) {
+	        var participant = elementRegistry.find(function(element) {
+	          var bo = getBusinessObject(element);
+	          return bo && bo.processRef && bo.processRef === parent;
+	        });
+
+	        parentPlane = canvas.findRoot(participant.id);
+	      }
+
 	      link.addEventListener('click', function() {
-	        if (canvas.getPlane(el.id)) {
-	          canvas.setActivePlane(el.id);
-	        } else {
-	          var plane = canvas.findPlane(el.id);
-	          canvas.setActivePlane(plane);
-	        }
+	        canvas.setRootElement(parentPlane);
 	      });
 
 	      return link;
@@ -7508,50 +7782,26 @@
 	    });
 	  }
 
-	  eventBus.on('plane.set', function(event) {
-	    var plane = event.plane;
-
-	    updateBreadcrumbs(plane);
+	  eventBus.on('root.set', function(event) {
+	    updateBreadcrumbs(event.element);
 	  });
 
-	  var createOverlay = function(element) {
-	    var html = domify('<button class="bjs-drilldown">' + ARROW_DOWN_SVG + '</button>');
-
-	    html.addEventListener('click', function() {
-	      canvas.setActivePlane(element.id);
-	    });
-
-	    overlays.add(element, {
-	      position: {
-	        bottom: -7,
-	        right: -8
-	      },
-	      html: html
-	    });
-	  };
-
-	  var addOverlays = function(elements) {
-	    elements.forEach(function(element) {
-	      if (is$1(element, 'bpmn:SubProcess')
-	          && element.collapsed
-	          && canvas.getPlane(element.id)) {
-	        createOverlay(element);
-	      }
-	    });
-	  };
-
-	  eventBus.on('import.done', function() {
-	    addOverlays(elementRegistry.filter(function(el) {
-	      return is$1(el, 'bpmn:SubProcess');
-	    }));
-	  });
 	}
 
-	DrilldownOverlays.$inject = [ 'eventBus', 'elementRegistry', 'overlays', 'canvas' ];
+	DrilldownBreadcrumbs.$inject = [ 'eventBus', 'elementRegistry', 'overlays', 'canvas' ];
 
 
-	// helpers
-	var getParentChain = function(child) {
+	// helpers //////////
+
+	/**
+	 * Returns the parents for the element using the business object chain,
+	 * starting with the root element.
+	 *
+	 * @param {djs.model.Shape} child
+	 *
+	 * @returns {Array<djs.model.Shape>} parents
+	 */
+	function getBoParentChain(child) {
 	  var bo = getBusinessObject(child);
 
 	  var parents = [];
@@ -7563,29 +7813,40 @@
 	  }
 
 	  return parents.reverse();
-	};
+	}
 
 	/**
-	 * Move collapsed subprocesses into view when drilling down. Zoom and scroll
-	 * are saved in a session.
+	 * Move collapsed subprocesses into view when drilling down.
+	 *
+	 * Zoom and scroll are saved in a session.
 	 *
 	 * @param {eventBus} eventBus
 	 * @param {canvas} canvas
 	 */
 	function DrilldownCentering(eventBus, canvas) {
-	  var currentPlane = 'base';
-	  var positionMap = {};
 
-	  eventBus.on('plane.set', function(event) {
+	  var currentRoot = null;
+	  var positionMap = new Map();
+
+	  eventBus.on('root.set', function(event) {
+	    var newRoot = event.element;
 	    var currentViewbox = canvas.viewbox();
-	    positionMap[currentPlane] = {
+	    var storedViewbox = positionMap.get(newRoot);
+
+	    positionMap.set(currentRoot, {
 	      x: currentViewbox.x,
 	      y: currentViewbox.y,
 	      zoom: currentViewbox.scale
-	    };
+	    });
 
-	    var planeId = event.plane.name;
-	    var storedViewbox = positionMap[planeId] || { x: 0, y: 0, zoom: 1 };
+	    currentRoot = newRoot;
+
+	    // current root was replaced with a collaboration, we don't update the viewbox
+	    if (is$1(newRoot, 'bpmn:Collaboration') && !storedViewbox) {
+	      return;
+	    }
+
+	    storedViewbox = storedViewbox || { x: 0, y: 0, zoom: 1 };
 
 	    var dx = (currentViewbox.x - storedViewbox.x) * currentViewbox.scale,
 	        dy = (currentViewbox.y - storedViewbox.y) * currentViewbox.scale;
@@ -7600,13 +7861,77 @@
 	    if (storedViewbox.zoom !== currentViewbox.scale) {
 	      canvas.zoom(storedViewbox.zoom, { x: 0, y: 0 });
 	    }
+	  });
 
-	    currentPlane = planeId;
+	  eventBus.on('diagram.clear', function() {
+	    positionMap.clear();
+	    currentRoot = null;
 	  });
+
 	}
 
 	DrilldownCentering.$inject = [ 'eventBus', 'canvas' ];
 
+
+	/**
+	 * ES5 Map implementation. Works.
+	 */
+	function Map() {
+
+	  this._entries = [];
+
+	  this.set = function(key, value) {
+
+	    var found = false;
+
+	    for (var k in this._entries) {
+	      if (this._entries[k][0] === key) {
+	        this._entries[k][1] = value;
+
+	        found = true;
+
+	        break;
+	      }
+	    }
+
+	    if (!found) {
+	      this._entries.push([ key, value ]);
+	    }
+	  };
+
+	  this.get = function(key) {
+
+	    for (var k in this._entries) {
+	      if (this._entries[k][0] === key) {
+	        return this._entries[k][1];
+	      }
+	    }
+
+	    return null;
+	  };
+
+	  this.clear = function() {
+	    this._entries.length = 0;
+	  };
+
+	  this.remove = function(key) {
+
+	    var idx = -1;
+
+	    for (var k in this._entries) {
+	      if (this._entries[k][0] === key) {
+	        idx = k;
+
+	        break;
+	      }
+	    }
+
+	    if (idx !== -1) {
+	      this._entries.splice(idx, 1);
+	    }
+	  };
+	}
+
 	var DEFAULT_POSITION = {
 	  x: 180,
 	  y: 160
@@ -7673,6 +7998,11 @@
 
 	  plane.get('planeElement').forEach(function(diElement) {
 	    var bo = diElement.bpmnElement;
+
+	    if (!bo) {
+	      return;
+	    }
+
 	    var parent = bo.$parent;
 
 	    if (is$1(bo, 'bpmn:SubProcess') && !diElement.isExpanded) {
@@ -7688,12 +8018,21 @@
 
 	  var newDiagrams = [];
 
+	  // create new planes for all collapsed subprocesses, even when they are empty
+	  collapsedElements.forEach(function(element) {
+	    if (!self._processToDiagramMap[element.id]) {
+	      var diagram = self.createDiagram(element);
+	      self._processToDiagramMap[element.id] = diagram;
+	      newDiagrams.push(diagram);
+	    }
+	  });
+
 	  elementsToMove.forEach(function(element) {
 	    var diElement = element.diElement;
 	    var parent = element.parent;
 
 	    // parent is expanded, get nearest collapsed parent
-	    while (parent && !collapsedElements.includes(parent)) {
+	    while (parent && collapsedElements.indexOf(parent) === -1) {
 	      parent = parent.$parent;
 	    }
 
@@ -7703,12 +8042,6 @@
 	    }
 
 	    var diagram = self._processToDiagramMap[parent.id];
-	    if (!diagram) {
-	      diagram = self.createDiagram(parent);
-	      self._processToDiagramMap[parent.id] = diagram;
-	      newDiagrams.push(diagram);
-	    }
-
 	    self.moveToDiPlane(diElement, diagram.plane);
 	  });
 
@@ -7775,33 +8108,209 @@
 	  }
 	}
 
-	function getPlaneBounds(plane) {
-	  var planeTrbl = {
-	    top: Infinity,
-	    right: -Infinity,
-	    bottom: -Infinity,
-	    left: Infinity
-	  };
+	function getPlaneBounds(plane) {
+	  var planeTrbl = {
+	    top: Infinity,
+	    right: -Infinity,
+	    bottom: -Infinity,
+	    left: Infinity
+	  };
+
+	  plane.planeElement.forEach(function(element) {
+	    if (!element.bounds) {
+	      return;
+	    }
+
+	    var trbl = asTRBL(element.bounds);
+
+	    planeTrbl.top = Math.min(trbl.top, planeTrbl.top);
+	    planeTrbl.left = Math.min(trbl.left, planeTrbl.left);
+	  });
+
+	  return asBounds(planeTrbl);
+	}
+
+	var LOW_PRIORITY = 250;
+	var ARROW_DOWN_SVG = '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M4.81801948,3.50735931 L10.4996894,9.1896894 L10.5,4 L12,4 L12,12 L4,12 L4,10.5 L9.6896894,10.4996894 L3.75735931,4.56801948 C3.46446609,4.27512627 3.46446609,3.80025253 3.75735931,3.50735931 C4.05025253,3.21446609 4.52512627,3.21446609 4.81801948,3.50735931 Z"/></svg>';
+
+	var EMPTY_MARKER = 'bjs-drilldown-empty';
+
+	function DrilldownOverlayBehavior(
+	    canvas, eventBus, elementRegistry, overlays
+	) {
+	  CommandInterceptor.call(this, eventBus);
+
+	  this._canvas = canvas;
+	  this._eventBus = eventBus;
+	  this._elementRegistry = elementRegistry;
+	  this._overlays = overlays;
+
+	  var self = this;
+
+	  this.executed('shape.toggleCollapse', LOW_PRIORITY, function(context) {
+	    var shape = context.shape;
+
+	    // Add overlay to the collapsed shape
+	    if (self.canDrillDown(shape)) {
+	      self.addOverlay(shape);
+	    } else {
+	      self.removeOverlay(shape);
+	    }
+	  }, true);
+
+
+	  this.reverted('shape.toggleCollapse', LOW_PRIORITY, function(context) {
+	    var shape = context.shape;
+
+	    // Add overlay to the collapsed shape
+	    if (self.canDrillDown(shape)) {
+	      self.addOverlay(shape);
+	    } else {
+	      self.removeOverlay(shape);
+	    }
+	  }, true);
+
+
+	  this.executed(['shape.create', 'shape.move', 'shape.delete'], LOW_PRIORITY,
+	    function(context) {
+	      var oldParent = context.oldParent,
+	          newParent = context.newParent || context.parent,
+	          shape = context.shape;
+
+	      // Add overlay to the collapsed shape
+	      if (self.canDrillDown(shape)) {
+	        self.addOverlay(shape);
+	      }
+
+	      self.updateDrilldownOverlay(oldParent);
+	      self.updateDrilldownOverlay(newParent);
+	      self.updateDrilldownOverlay(shape);
+	    }, true);
+
+
+	  this.reverted(['shape.create', 'shape.move', 'shape.delete'], LOW_PRIORITY,
+	    function(context) {
+	      var oldParent = context.oldParent,
+	          newParent = context.newParent || context.parent,
+	          shape = context.shape;
+
+	      // Add overlay to the collapsed shape
+	      if (self.canDrillDown(shape)) {
+	        self.addOverlay(shape);
+	      }
+
+	      self.updateDrilldownOverlay(oldParent);
+	      self.updateDrilldownOverlay(newParent);
+	      self.updateDrilldownOverlay(shape);
+	    }, true);
+
+
+	  eventBus.on('import.done', function() {
+	    elementRegistry.filter(function(e) {
+	      return self.canDrillDown(e);
+	    }).map(function(el) {
+	      self.addOverlay(el);
+	    });
+	  });
+
+	}
+
+	inherits$1(DrilldownOverlayBehavior, CommandInterceptor);
+
+	DrilldownOverlayBehavior.prototype.updateDrilldownOverlay = function(shape) {
+	  var canvas = this._canvas;
+
+	  if (!shape) {
+	    return;
+	  }
+
+	  var root = canvas.findRoot(shape);
+	  if (root) {
+	    this.updateOverlayVisibility(root);
+	  }
+	};
+
+
+	DrilldownOverlayBehavior.prototype.canDrillDown = function(element) {
+	  var canvas = this._canvas;
+	  return is$1(element, 'bpmn:SubProcess') && canvas.findRoot(getPlaneIdFromShape(element));
+	};
+
+	/**
+	 * Updates visibility of the drilldown overlay. If the plane has no elements,
+	 * the drilldown will be only shown when the element is selected.
+	 *
+	 * @param {djs.model.Shape|djs.model.Root} element collapsed shape or root element
+	 */
+	DrilldownOverlayBehavior.prototype.updateOverlayVisibility = function(element) {
+	  var overlays = this._overlays;
+
+	  var bo = element.businessObject;
+
+	  var overlay = overlays.get({ element: bo.id, type: 'drilldown' })[0];
+
+	  if (!overlay) {
+	    return;
+	  }
+
+	  var hasContent = bo && bo.flowElements && bo.flowElements.length;
+	  classes(overlay.html).toggle(EMPTY_MARKER, !hasContent);
+	};
+
+	/**
+	 * Attaches a drilldown button to the given element. We assume that the plane has
+	 * the same id as the element.
+	 *
+	 * @param {djs.model.Shape} element collapsed shape
+	 */
+	DrilldownOverlayBehavior.prototype.addOverlay = function(element) {
+	  var canvas = this._canvas;
+	  var overlays = this._overlays;
+
+	  var existingOverlays = overlays.get({ element: element, type: 'drilldown' });
+	  if (existingOverlays.length) {
+	    this.removeOverlay(element);
+	  }
+
+	  var button = domify('<button class="bjs-drilldown">' + ARROW_DOWN_SVG + '</button>');
 
-	  plane.planeElement.forEach(function(element) {
-	    if (!element.bounds) {
-	      return;
-	    }
+	  button.addEventListener('click', function() {
+	    canvas.setRootElement(canvas.findRoot(getPlaneIdFromShape(element)));
+	  });
 
-	    var trbl = asTRBL(element.bounds);
+	  overlays.add(element, 'drilldown', {
+	    position: {
+	      bottom: -7,
+	      right: -8
+	    },
+	    html: button
+	  });
 
-	    planeTrbl.top = Math.min(trbl.top, planeTrbl.top);
-	    planeTrbl.left = Math.min(trbl.left, planeTrbl.left);
+	  this.updateOverlayVisibility(element);
+	};
+
+	DrilldownOverlayBehavior.prototype.removeOverlay = function(element) {
+	  var overlays = this._overlays;
+
+	  overlays.remove({
+	    element: element,
+	    type: 'drilldown'
 	  });
+	};
 
-	  return asBounds(planeTrbl);
-	}
+	DrilldownOverlayBehavior.$inject = [
+	  'canvas',
+	  'eventBus',
+	  'elementRegistry',
+	  'overlays'
+	];
 
 	var DrilldownModdule = {
-	  __depends__: [ OverlaysModule, ChangeSupportModule ],
-	  __init__: [ 'drilldownOverlays', 'drilldownCentering', 'subprocessCompatibility'],
-	  drilldownOverlays: [ 'type', DrilldownOverlays ],
+	  __depends__: [ OverlaysModule, ChangeSupportModule, RootElementsModule ],
+	  __init__: [ 'drilldownBreadcrumbs', 'drilldownOverlayBehavior', 'drilldownCentering', 'subprocessCompatibility'],
+	  drilldownBreadcrumbs: [ 'type', DrilldownBreadcrumbs ],
 	  drilldownCentering: [ 'type', DrilldownCentering ],
+	  drilldownOverlayBehavior: [ 'type', DrilldownOverlayBehavior ],
 	  subprocessCompatibility: [ 'type', SubprocessCompatibility ]
 	};
 
@@ -8442,7 +8951,6 @@
 	}
 
 	var BASE_LAYER = 'base';
-	var HIDDEN_MARKER = 'djs-element-hidden';
 
 	// render plane contents behind utility layers
 	var PLANE_LAYER_INDEX = 0;
@@ -8473,6 +8981,12 @@
 	  this._elementRegistry = elementRegistry;
 	  this._graphicsFactory = graphicsFactory;
 
+	  this._rootsIdx = 0;
+
+	  this._layers = {};
+	  this._planes = [];
+	  this._rootElement = null;
+
 	  this._init(config || {});
 	}
 
@@ -8510,9 +9024,6 @@
 
 	  var viewport = this._viewport = createGroup(svg, 'viewport');
 
-	  this._layers = {};
-	  this._planes = {};
-
 	  // debounce canvas.viewbox.changed events
 	  // for smoother diagram interaction
 	  if (config.deferUpdate !== false) {
@@ -8547,7 +9058,7 @@
 	    'shape.removed',
 	    'connection.removed',
 	    'elements.changed',
-	    'plane.set'
+	    'root.set'
 	  ], function() {
 	    delete this._cachedViewbox;
 	  }, this);
@@ -8572,7 +9083,7 @@
 	  delete this._container;
 	  delete this._layers;
 	  delete this._planes;
-	  delete this._activePlane;
+	  delete this._rootElement;
 	  delete this._viewport;
 	};
 
@@ -8587,15 +9098,15 @@
 	    var type = getType(element);
 
 	    if (type === 'root') {
-	      self.setRootElementForPlane(null, self.findPlane(element), true);
+	      self.removeRootElement(element);
 	    } else {
 	      self._removeElement(element, type);
 	    }
 	  });
 
 	  // remove all planes
-	  this._activePlane = null;
-	  this._planes = {};
+	  this._planes = [];
+	  this._rootElement = null;
 
 	  // force recomputation of view box
 	  delete this._cachedViewbox;
@@ -8676,140 +9187,75 @@
 
 	};
 
-	/**
-	 * Returns a plane that is used to draw elements on it.
-	 *
-	 * @param {string} name
-	 *
-	 * @return {Object} plane descriptor with { layer, rootElement, name }
-	 */
-	Canvas.prototype.getPlane = function(name) {
-	  if (!name) {
-	    throw new Error('must specify a name');
-	  }
-
-	  return this._planes[name];
-	};
-
-	/**
-	 * Creates a plane that is used to draw elements on it. If no
-	 * root element is provided, an implicit root will be used.
-	 *
-	 * @param {string} name
-	 * @param {Object|djs.model.Root} [rootElement] optional root element
-	 *
-	 * @return {Object} plane descriptor with { layer, rootElement, name }
-	 */
-	Canvas.prototype.createPlane = function(name, rootElement) {
-	  if (!name) {
-	    throw new Error('must specify a name');
-	  }
-
-	  if (this._planes[name]) {
-	    throw new Error('plane ' + name + ' already exists');
-	  }
-
-	  if (!rootElement) {
-	    rootElement = {
-	      id: '__implicitroot' + name,
-	      children: [],
-	      isImplicit: true
-	    };
-	  }
-
-	  var svgLayer = this.getLayer(name, PLANE_LAYER_INDEX);
-	  classes$1(svgLayer).add(HIDDEN_MARKER);
-
-	  var plane = this._planes[name] = {
-	    layer: svgLayer,
-	    name: name,
-	    rootElement: null
-	  };
-
-	  this.setRootElementForPlane(rootElement, plane);
-
-	  return plane;
-	};
-
-	/**
-	 * Sets the active plane and hides the previously active plane.
-	 *
-	 * @param {string|Object} plane
-	 *
-	 * @return {Object} plane descriptor with { layer, rootElement, name }
-	 */
-	Canvas.prototype.setActivePlane = function(plane) {
-	  if (!plane) {
-	    throw new Error('must specify a plane');
-	  }
-
-	  if (typeof plane === 'string') {
-	    plane = this.getPlane(plane);
-	  }
 
-	  // hide previous Plane
-	  if (this._activePlane) {
-	    classes$1(this._activePlane.layer).add(HIDDEN_MARKER);
-	  }
+	Canvas.prototype._removeLayer = function(name) {
 
-	  this._activePlane = plane;
+	  var layer = this._layers[name];
 
-	  // show current Plane
-	  classes$1(plane.layer).remove(HIDDEN_MARKER);
+	  if (layer) {
+	    delete this._layers[name];
 
-	  if (plane.rootElement) {
-	    this._elementRegistry.updateGraphics(plane.rootElement, this._svg, true);
+	    remove$2(layer.group);
 	  }
-
-	  this._eventBus.fire('plane.set', { plane: plane });
-
-	  return plane;
 	};
 
 	/**
-	 * Returns the currently active layer
+	 * Returns the currently active layer. Can be null.
 	 *
-	 * @returns {SVGElement}
+	 * @returns {SVGElement|null}
 	 */
-
 	Canvas.prototype.getActiveLayer = function() {
-	  return this.getActivePlane().layer;
-	};
+	  var plane = this._findPlaneForRoot(this.getRootElement());
 
-	/**
-	 * Returns the currently active plane.
-	 *
-	 * @return {Object} plane descriptor with { layer, rootElement, name }
-	 */
-	Canvas.prototype.getActivePlane = function() {
-	  var plane = this._activePlane;
 	  if (!plane) {
-	    plane = this.createPlane(BASE_LAYER);
-	    this.setActivePlane(BASE_LAYER);
+	    return null;
 	  }
 
-	  return plane;
+	  return plane.layer;
 	};
 
+
 	/**
 	 * Returns the plane which contains the given element.
 	 *
 	 * @param {string|djs.model.Base} element
 	 *
-	 * @return {Object} plane descriptor with { layer, rootElement, name }
+	 * @return {djs.model.Base} root for element
 	 */
-	Canvas.prototype.findPlane = function(element) {
+	Canvas.prototype.findRoot = function(element) {
 	  if (typeof element === 'string') {
 	    element = this._elementRegistry.get(element);
 	  }
 
-	  var root = findRoot(element);
+	  if (!element) {
+	    return;
+	  }
+
+	  var plane = this._findPlaneForRoot(
+	    findRoot(element)
+	  ) || {};
+
+	  return plane.rootElement;
+	};
+
+	/**
+	 * Return a list of all root elements on the diagram.
+	 *
+	 * @return {djs.model.Root[]}
+	 */
+	Canvas.prototype.getRootElements = function() {
+	  return this._planes.map(function(plane) {
+	    return plane.rootElement;
+	  });
+	};
 
+	Canvas.prototype._findPlaneForRoot = function(rootElement) {
 	  return find(this._planes, function(plane) {
-	    return plane.rootElement === root;
+	    return plane.rootElement === rootElement;
 	  });
 	};
 
+
 	/**
 	 * Returns the html element that encloses the
 	 * drawing canvas.
@@ -8930,95 +9376,205 @@
 	  }
 	};
 
+	/**
+	 * Returns the current root element.
+	 *
+	 * Supports two different modes for handling root elements:
+	 *
+	 * 1. if no root element has been added before, an implicit root will be added
+	 * and returned. This is used in applications that don't require explicit
+	 * root elements.
+	 *
+	 * 2. when root elements have been added before calling `getRootElement`,
+	 * root elements can be null. This is used for applications that want to manage
+	 * root elements themselves.
+	 *
+	 * @returns {Object|djs.model.Root|null} rootElement.
+	 */
 	Canvas.prototype.getRootElement = function() {
-	  var plane = this.getActivePlane();
+	  var rootElement = this._rootElement;
 
-	  return plane.rootElement;
+	  // can return null if root elements are present but none was set yet
+	  if (rootElement || this._planes.length) {
+	    return rootElement;
+	  }
+
+	  return this.setRootElement(this.addRootElement(null));
 	};
 
+	/**
+	 * Adds a given root element and returns it.
+	 *
+	 * @param {Object|djs.model.Root} rootElement
+	 *
+	 * @return {Object|djs.model.Root} rootElement
+	 */
 
+	Canvas.prototype.addRootElement = function(rootElement) {
+	  var idx = this._rootsIdx++;
 
-	// root element handling //////////////////////
+	  if (!rootElement) {
+	    rootElement = {
+	      id: '__implicitroot_' + idx,
+	      children: [],
+	      isImplicit: true
+	    };
+	  }
+
+	  var layerName = rootElement.layer = 'root-' + idx;
+
+	  this._ensureValid('root', rootElement);
+
+	  var layer = this.getLayer(layerName, PLANE_LAYER_INDEX);
+
+	  attr$1(layer, 'display', 'none');
+
+	  this._addRoot(rootElement, layer);
+
+	  this._planes.push({
+	    rootElement: rootElement,
+	    layer: layer
+	  });
+
+	  return rootElement;
+	};
 
 	/**
-	 * Sets a given element as the new root element for the canvas
-	 * and returns the new root element.
+	 * Removes a given rootElement and returns it.
 	 *
-	 * @param {Object|djs.model.Root} element
-	 * @param {boolean} [override] whether to override the current root element, if any
+	 * @param {djs.model.Root|String} rootElement
 	 *
-	 * @return {Object|djs.model.Root} new root element
+	 * @return {Object|djs.model.Root} rootElement
 	 */
-	Canvas.prototype.setRootElement = function(element, override) {
-	  var activePlane = this._activePlane;
+	Canvas.prototype.removeRootElement = function(rootElement) {
 
-	  if (activePlane) {
-	    return this.setRootElementForPlane(element, activePlane, override);
-	  } else {
-	    var basePlane = this.createPlane(BASE_LAYER, element);
+	  if (typeof rootElement === 'string') {
+	    rootElement = this._elementRegistry.get(rootElement);
+	  }
+
+	  var plane = this._findPlaneForRoot(rootElement);
+
+	  if (!plane) {
+	    return;
+	  }
+
+	  // hook up life-cycle events
+	  this._removeRoot(rootElement);
+
+	  // clean up layer
+	  this._removeLayer(rootElement.layer);
 
-	    this.setActivePlane(basePlane);
+	  // clean up plane
+	  this._planes = this._planes.filter(function(plane) {
+	    return plane.rootElement !== rootElement;
+	  });
 
-	    return basePlane.rootElement;
+	  // clean up active root
+	  if (this._rootElement === rootElement) {
+	    this._rootElement = null;
 	  }
+
+	  return rootElement;
 	};
 
 
+	// root element handling //////////////////////
+
 	/**
 	 * Sets a given element as the new root element for the canvas
 	 * and returns the new root element.
 	 *
-	 * @param {Object|djs.model.Root} element
-	 * @param {Object|djs.model.Root} plane
-	 * @param {boolean} [override] whether to override the current root element, if any
+	 * @param {Object|djs.model.Root} rootElement
 	 *
 	 * @return {Object|djs.model.Root} new root element
 	 */
-	Canvas.prototype.setRootElementForPlane = function(element, plane, override) {
+	Canvas.prototype.setRootElement = function(rootElement, override) {
 
-	  if (typeof plane === 'string') {
-	    plane = this.getPlane(plane);
+	  if (isDefined(override)) {
+	    throw new Error('override not supported');
 	  }
 
-	  if (element) {
-	    this._ensureValid('root', element);
+	  if (rootElement === this._rootElement) {
+	    return;
 	  }
 
-	  var currentRoot = plane.rootElement,
-	      elementRegistry = this._elementRegistry,
-	      eventBus = this._eventBus;
+	  var plane;
 
-	  if (currentRoot) {
-	    if (!override) {
-	      throw new Error('rootElement already set, need to specify override');
-	    }
+	  if (!rootElement) {
+	    throw new Error('rootElement required');
+	  }
 
-	    // simulate element remove event sequence
-	    eventBus.fire('root.remove', { element: currentRoot });
-	    eventBus.fire('root.removed', { element: currentRoot });
+	  plane = this._findPlaneForRoot(rootElement);
 
-	    elementRegistry.remove(currentRoot);
+	  // give set add semantics for backwards compatibility
+	  if (!plane) {
+	    rootElement = this.addRootElement(rootElement);
 	  }
 
-	  if (element) {
-	    var gfx = plane.layer;
+	  this._setRoot(rootElement);
+
+	  return rootElement;
+	};
 
-	    // resemble element add event sequence
-	    eventBus.fire('root.add', { element: element });
 
-	    elementRegistry.add(element, gfx);
+	Canvas.prototype._removeRoot = function(element) {
+	  var elementRegistry = this._elementRegistry,
+	      eventBus = this._eventBus;
+
+	  // simulate element remove event sequence
+	  eventBus.fire('root.remove', { element: element });
+	  eventBus.fire('root.removed', { element: element });
+
+	  elementRegistry.remove(element);
+	};
+
+
+	Canvas.prototype._addRoot = function(element, gfx) {
+	  var elementRegistry = this._elementRegistry,
+	      eventBus = this._eventBus;
+
+	  // resemble element add event sequence
+	  eventBus.fire('root.add', { element: element });
+
+	  elementRegistry.add(element, gfx);
+
+	  eventBus.fire('root.added', { element: element, gfx: gfx });
+	};
+
+
+	Canvas.prototype._setRoot = function(rootElement, layer) {
 
-	    eventBus.fire('root.added', { element: element, gfx: gfx });
+	  var currentRoot = this._rootElement;
 
-	    // associate SVG with root element when active
-	    if (plane === this._activePlane) {
-	      this._elementRegistry.updateGraphics(element, this._svg, true);
+	  var currentLayer;
+
+	  if (currentRoot) {
+
+	    // un-associate previous root element <svg>
+	    this._elementRegistry.updateGraphics(currentRoot, null, true);
+
+	    // hide previous layer
+	    currentLayer = this._findPlaneForRoot(currentRoot).layer;
+
+	    attr$1(currentLayer, 'display', 'none');
+	  }
+
+	  if (rootElement) {
+
+	    if (!layer) {
+	      layer = this._findPlaneForRoot(rootElement).layer;
 	    }
+
+	    // associate element with <svg>
+	    this._elementRegistry.updateGraphics(rootElement, this._svg, true);
+
+	    // show root layer
+	    attr$1(layer, 'display', null);
 	  }
 
-	  plane.rootElement = element;
+	  this._rootElement = rootElement;
 
-	  return element;
+	  this._eventBus.fire('root.set', { element: rootElement });
 	};
 
 	// add functionality //////////////////////
@@ -9029,7 +9585,7 @@
 	  }
 
 	  if (this._elementRegistry.get(element.id)) {
-	    throw new Error('element with id ' + element.id + ' already exists');
+	    throw new Error('element <' + element.id + '> already exists');
 	  }
 
 	  var requiredAttrs = REQUIRED_MODEL_ATTRS[type];
@@ -9319,6 +9875,7 @@
 	      innerBox,
 	      outerBox = this.getSize(),
 	      matrix,
+	      activeLayer,
 	      transform,
 	      scale,
 	      x, y;
@@ -9326,10 +9883,11 @@
 	  if (!box) {
 
 	    // compute the inner box based on the
-	    // diagrams active plane. This allows us to exclude
+	    // diagrams active layer. This allows us to exclude
 	    // external components, such as overlays
 
-	    innerBox = (this._activePlane && this._activePlane.layer.getBBox()) || {};
+	    activeLayer = this._rootElement ? this.getActiveLayer() : null;
+	    innerBox = activeLayer && activeLayer.getBBox() || {};
 
 	    transform = transform$1(viewport);
 	    matrix = transform ? transform.matrix : createMatrix();
@@ -9412,10 +9970,11 @@
 	    element = this._elementRegistry.get(element);
 	  }
 
-	  // switch to correct Plane
-	  var targetPlane = this.findPlane(element);
-	  if (targetPlane !== this._activePlane) {
-	    this.setActivePlane(targetPlane);
+	  // set to correct rootElement
+	  var rootElement = this.findRoot(element);
+
+	  if (rootElement !== this.getRootElement()) {
+	    this.setRootElement(rootElement);
 	  }
 
 	  if (!padding) {
@@ -9778,7 +10337,9 @@
 	    container.gfx = gfx;
 	  }
 
-	  attr$1(gfx, ELEMENT_ID, id);
+	  if (gfx) {
+	    attr$1(gfx, ELEMENT_ID, id);
+	  }
 
 	  return gfx;
 	};
@@ -19555,18 +20116,29 @@
 
 	    var walker = new BpmnTreeWalker(visitor, translate);
 
+
+	    bpmnDiagram = bpmnDiagram || (definitions.diagrams && definitions.diagrams[0]);
+
+	    var diagramsToImport = getDiagramsToImport(definitions, bpmnDiagram);
+
+	    if (!diagramsToImport) {
+	      throw new Error(translate('no diagram to display'));
+	    }
+
 	    // traverse BPMN 2.0 document model,
 	    // starting at definitions
-	    if (!bpmnDiagram && definitions.diagrams) {
-	      for (var i = 0; i < definitions.diagrams.length; i++) {
-	        walker.handleDefinitions(definitions, definitions.diagrams[i]);
-	      }
-	    } else {
-	      walker.handleDefinitions(definitions, bpmnDiagram);
-	    }
+	    forEach(diagramsToImport, function(diagram) {
+	      walker.handleDefinitions(definitions, diagram);
+	    });
 
-	    var mainDiagram = bpmnDiagram || definitions.diagrams[0];
-	    canvas.setActivePlane(mainDiagram.plane.bpmnElement.id);
+	    var rootId = bpmnDiagram.plane.bpmnElement.id;
+
+	    // we do need to account for different ways we create root elements
+	    // each nested imported <root> do have the `_plane` suffix, while
+	    // the root <root> is found under the business object ID
+	    canvas.setRootElement(
+	      canvas.findRoot(rootId + '_plane') || canvas.findRoot(rootId)
+	    );
 	  }
 
 	  return new Promise(function(resolve, reject) {
@@ -19594,6 +20166,107 @@
 	  });
 	}
 
+	/**
+	 * Returns all diagrams in the same hirarchy as the requested diagram.
+	 * Includes all parent and sub process diagrams.
+	 *
+	 * @param {Array} definitions
+	 * @param {Object} bpmnDiagram
+	 *
+	 * @returns {Array<Object>}
+	 */
+	function getDiagramsToImport(definitions, bpmnDiagram) {
+	  if (!bpmnDiagram) {
+	    return;
+	  }
+
+	  var bpmnElement = bpmnDiagram.plane.bpmnElement,
+	      rootElement = bpmnElement;
+
+	  if (!is$1(bpmnElement, 'bpmn:Process') && !is$1(bpmnElement, 'bpmn:Collaboration')) {
+	    rootElement = findRootProcess(bpmnElement);
+	  }
+
+	  // in case the process is part of a collaboration, the plane references the
+	  // collaboration, not the process
+	  var collaboration;
+
+	  if (is$1(rootElement, 'bpmn:Collaboration')) {
+	    collaboration = rootElement;
+	  } else {
+	    collaboration = find(definitions.rootElements, function(element) {
+	      if (!is$1(element, 'bpmn:Collaboration')) {
+	        return;
+	      }
+
+	      return find(element.participants, function(participant) {
+	        return participant.processRef === rootElement;
+	      });
+	    });
+	  }
+
+	  var rootElements = [ rootElement ];
+
+	  // all collaboration processes can contain sub-diagrams
+	  if (collaboration) {
+	    rootElements = map$1(collaboration.participants, function(participant) {
+	      return participant.processRef;
+	    });
+
+	    rootElements.push(collaboration);
+	  }
+
+	  var allChildren = selfAndAllFlowElements(rootElements);
+
+	  // if we have multiple diagrams referencing the same element, we
+	  // use the first in the file
+	  var diagramsToImport = [ bpmnDiagram ];
+	  var handledElements = [ bpmnElement ];
+
+	  forEach(definitions.diagrams, function(diagram) {
+	    var businessObject = diagram.plane.bpmnElement;
+
+	    if (
+	      allChildren.indexOf(businessObject) !== -1 &&
+	      handledElements.indexOf(businessObject) === -1
+	    ) {
+	      diagramsToImport.push(diagram);
+	      handledElements.push(businessObject);
+	    }
+	  });
+
+
+	  return diagramsToImport;
+	}
+
+	function selfAndAllFlowElements(elements) {
+	  var result = [];
+
+	  forEach(elements, function(element) {
+	    if (!element) {
+	      return;
+	    }
+
+	    result.push(element);
+
+	    result = result.concat(selfAndAllFlowElements(element.flowElements));
+	  });
+
+	  return result;
+	}
+
+	function findRootProcess(element) {
+	  var parent = element;
+
+	  while (parent) {
+	    if (is$1(parent, 'bpmn:Process')) {
+	      return parent;
+	    }
+
+	    parent = parent.$parent;
+	  }
+	}
+
 	/**
 	 * This file must not be changed or exchanged.
 	 *
@@ -20084,7 +20757,7 @@
 	    try {
 	      var canvas = self.get('canvas');
 
-	      var contentNode = canvas.getDefaultLayer(),
+	      var contentNode = canvas.getActiveLayer(),
 	          defsNode = query('defs', canvas._svg);
 
 	      var contents = innerSVG(contentNode),