fix(LaneUtil): fix JSDoc

lib/features/modeling/util/LaneUtil.js

@@ -13,6 +13,12 @@ import {
   resizeTRBL
 } from 'diagram-js/lib/features/resize/ResizeUtil';
 
+/**
+ * @typedef {import('../../../model/Types').BpmnShape} BpmnShape
+ *
+ * @typedef {import('diagram-js/lib/util/Types').Rect} Rect
+ */
+
 var abs = Math.abs;
 
 
@@ -31,12 +37,12 @@ export var LANE_INDENTATION = 30;
 
 
 /**
- * Collect all lane shapes in the given paren
+ * Return all lanes that are children of the given shape.
  *
- * @param  {djs.model.Shape} shape
- * @param  {Array<djs.model.Base>} [collectedShapes]
+ * @param  {BpmnShape} shape
+ * @param  {BpmnShape[]} [collectedShapes]
  *
- * @return {Array<djs.model.Base>}
+ * @return {BpmnShape[]}
  */
 export function collectLanes(shape, collectedShapes) {
 
@@ -55,11 +61,11 @@ export function collectLanes(shape, collectedShapes) {
 
 
 /**
- * Return the lane children of the given element.
+ * Return all lanes that are direct children of the given shape.
  *
- * @param {djs.model.Shape} shape
+ * @param {BpmnShape} shape
  *
- * @return {Array<djs.model.Shape>}
+ * @return {BpmnShape[]}
  */
 export function getChildLanes(shape) {
   return shape.children.filter(function(c) {
@@ -69,11 +75,11 @@ export function getChildLanes(shape) {
 
 
 /**
- * Return the root element containing the given lane shape
+ * Return the parent shape of the given lane.
  *
- * @param {djs.model.Shape} shape
+ * @param {BpmnShape} shape
  *
- * @return {djs.model.Shape}
+ * @return {BpmnShape}
  */
 export function getLanesRoot(shape) {
   return getParent(shape, LANE_PARENTS) || shape;
@@ -85,10 +91,13 @@ export function getLanesRoot(shape) {
  * adjacent to the given shape, assuming it will be
  * resized to the given new bounds.
  *
- * @param {djs.model.Shape} shape
- * @param {Bounds} newBounds
+ * @param {BpmnShape} shape
+ * @param {Rect} newBounds
  *
- * @return {Array<Object>}
+ * @return { {
+ *   shape: BpmnShape;
+ *   newBounds: Rect;
+ * }[] }
  */
 export function computeLanesResize(shape, newBounds) {