melonjs 15.3.0 → 15.4.1

package/src/physics/world.js

@@ -11,7 +11,7 @@ import state from "./../state/state.js";
  * an object representing the physic world, and responsible for managing and updating all childs and physics
  * @augments Container
  */
- export default class World extends Container {
+export default class World extends Container {
     /**
      * @param {number} [x=0] - position of the container (accessible via the inherited pos.x property)
      * @param {number} [y=0] - position of the container (accessible via the inherited pos.y property)
@@ -50,13 +50,10 @@ import state from "./../state/state.js";
         this.gravity = new Vector2d(0, 0.98);
 
         /**
-         * Specify the rendering method for tile layers. <br>
-         * if false visible part of the layers are rendered dynamically,<br>
-         * if true the entire layers are first rendered into an offscreen canvas.<br>
-         * the "best" rendering method depends of your game
-         * (amount of layer, layer size, amount of tiles per layer, etc.)<br>
-         * note : rendering method is also configurable per layer by adding this
-         * property to your layer (in Tiled).
+         * Enabled pre-rendering for all tile layers. <br>
+         * If false layers are rendered dynamically, if true layers are first fully rendered into an offscreen canvas.<br>
+         * the "best" rendering method depends of your game (amount of layer, layer size, amount of tiles per layer, etc.)<br>
+         * Note : rendering method is also configurable per layer by adding a boolean "preRender" property to your layer in Tiled ({@link https://doc.mapeditor.org/en/stable/manual/custom-properties/#adding-properties}).
          * @type {boolean}
          * @default false
          */

package/src/polyfill/roundrect.js

@@ -4,234 +4,234 @@
  */
 (() => {
 
-  "use strict";
+    "use strict";
 
-  /** @ignore */
-  function roundRect(x, y, w, h, radii) {
-
-    if (!([x, y, w, h].every((input) => Number.isFinite(input)))) {
-
-      return;
-
-    }
-
-    radii = parseRadiiArgument(radii);
+    /** @ignore */
+    function roundRect(x, y, w, h, radii) {
 
-    let upperLeft, upperRight, lowerRight, lowerLeft;
+        if (!([x, y, w, h].every((input) => Number.isFinite(input)))) {
 
-    if (radii.length === 4) {
+            return;
 
-      upperLeft = toCornerPoint(radii[0]);
-      upperRight = toCornerPoint(radii[1]);
-      lowerRight = toCornerPoint(radii[2]);
-      lowerLeft = toCornerPoint(radii[3]);
+        }
 
-    } else if (radii.length === 3) {
+        radii = parseRadiiArgument(radii);
 
-      upperLeft = toCornerPoint(radii[0]);
-      upperRight = toCornerPoint(radii[1]);
-      lowerLeft = toCornerPoint(radii[1]);
-      lowerRight = toCornerPoint(radii[2]);
+        let upperLeft, upperRight, lowerRight, lowerLeft;
 
-    } else if (radii.length === 2) {
+        if (radii.length === 4) {
 
-      upperLeft = toCornerPoint(radii[0]);
-      lowerRight = toCornerPoint(radii[0]);
-      upperRight = toCornerPoint(radii[1]);
-      lowerLeft = toCornerPoint(radii[1]);
+            upperLeft = toCornerPoint(radii[0]);
+            upperRight = toCornerPoint(radii[1]);
+            lowerRight = toCornerPoint(radii[2]);
+            lowerLeft = toCornerPoint(radii[3]);
 
-    } else if (radii.length === 1) {
+        } else if (radii.length === 3) {
 
-      upperLeft = toCornerPoint(radii[0]);
-      upperRight = toCornerPoint(radii[0]);
-      lowerRight = toCornerPoint(radii[0]);
-      lowerLeft = toCornerPoint(radii[0]);
+            upperLeft = toCornerPoint(radii[0]);
+            upperRight = toCornerPoint(radii[1]);
+            lowerLeft = toCornerPoint(radii[1]);
+            lowerRight = toCornerPoint(radii[2]);
 
-    } else {
+        } else if (radii.length === 2) {
 
-      throw new Error(radii.length + " is not a valid size for radii sequence.");
+            upperLeft = toCornerPoint(radii[0]);
+            lowerRight = toCornerPoint(radii[0]);
+            upperRight = toCornerPoint(radii[1]);
+            lowerLeft = toCornerPoint(radii[1]);
 
-    }
+        } else if (radii.length === 1) {
 
-    const corners = [upperLeft, upperRight, lowerRight, lowerLeft];
-    const negativeCorner = corners.find(({x, y}) => x < 0 || y < 0);
-    //const negativeValue = negativeCorner?.x < 0 ? negativeCorner.x : negativeCorner?.y
+            upperLeft = toCornerPoint(radii[0]);
+            upperRight = toCornerPoint(radii[0]);
+            lowerRight = toCornerPoint(radii[0]);
+            lowerLeft = toCornerPoint(radii[0]);
 
-    if (corners.some(({x, y}) => !Number.isFinite(x) || !Number.isFinite(y))) {
+        } else {
 
-      return;
+            throw new Error(radii.length + " is not a valid size for radii sequence.");
 
-    }
+        }
 
-    if (negativeCorner) {
+        const corners = [upperLeft, upperRight, lowerRight, lowerLeft];
+        const negativeCorner = corners.find(({x, y}) => x < 0 || y < 0);
+        //const negativeValue = negativeCorner?.x < 0 ? negativeCorner.x : negativeCorner?.y
 
-      throw new Error("Radius value " + negativeCorner + " is negative.");
+        if (corners.some(({x, y}) => !Number.isFinite(x) || !Number.isFinite(y))) {
 
-    }
+            return;
 
-    fixOverlappingCorners(corners);
+        }
 
-    if (w < 0 && h < 0) {
+        if (negativeCorner) {
 
-      this.moveTo(x - upperLeft.x, y);
-      this.ellipse(x + w + upperRight.x, y - upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI * 1.5, -Math.PI);
-      this.ellipse(x + w + lowerRight.x, y + h + lowerRight.y, lowerRight.x, lowerRight.y, 0, -Math.PI, -Math.PI / 2);
-      this.ellipse(x - lowerLeft.x, y + h + lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, -Math.PI / 2, 0);
-      this.ellipse(x - upperLeft.x, y - upperLeft.y, upperLeft.x, upperLeft.y, 0, 0, -Math.PI / 2);
+            throw new Error("Radius value " + negativeCorner + " is negative.");
 
-    } else if (w < 0) {
+        }
 
-      this.moveTo(x - upperLeft.x, y);
-      this.ellipse(x + w + upperRight.x, y + upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI / 2, -Math.PI, 1);
-      this.ellipse(x + w + lowerRight.x, y + h - lowerRight.y, lowerRight.x, lowerRight.y, 0, -Math.PI, -Math.PI * 1.5, 1);
-      this.ellipse(x - lowerLeft.x, y + h - lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, Math.PI / 2, 0, 1);
-      this.ellipse(x - upperLeft.x, y + upperLeft.y, upperLeft.x, upperLeft.y, 0, 0, -Math.PI / 2, 1);
+        fixOverlappingCorners(corners);
 
-    } else if (h < 0) {
+        if (w < 0 && h < 0) {
 
-      this.moveTo(x + upperLeft.x, y);
-      this.ellipse(x + w - upperRight.x, y - upperRight.y, upperRight.x, upperRight.y, 0, Math.PI / 2, 0, 1);
-      this.ellipse(x + w - lowerRight.x, y + h + lowerRight.y, lowerRight.x, lowerRight.y, 0, 0, -Math.PI / 2, 1);
-      this.ellipse(x + lowerLeft.x, y + h + lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, -Math.PI / 2, -Math.PI, 1);
-      this.ellipse(x + upperLeft.x, y - upperLeft.y, upperLeft.x, upperLeft.y, 0, -Math.PI, -Math.PI * 1.5, 1);
+            this.moveTo(x - upperLeft.x, y);
+            this.ellipse(x + w + upperRight.x, y - upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI * 1.5, -Math.PI);
+            this.ellipse(x + w + lowerRight.x, y + h + lowerRight.y, lowerRight.x, lowerRight.y, 0, -Math.PI, -Math.PI / 2);
+            this.ellipse(x - lowerLeft.x, y + h + lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, -Math.PI / 2, 0);
+            this.ellipse(x - upperLeft.x, y - upperLeft.y, upperLeft.x, upperLeft.y, 0, 0, -Math.PI / 2);
 
-    } else {
+        } else if (w < 0) {
 
-      this.moveTo(x + upperLeft.x, y);
-      this.ellipse(x + w - upperRight.x, y + upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI / 2, 0);
-      this.ellipse(x + w - lowerRight.x, y + h - lowerRight.y, lowerRight.x, lowerRight.y, 0, 0, Math.PI / 2);
-      this.ellipse(x + lowerLeft.x, y + h - lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, Math.PI / 2, Math.PI);
-      this.ellipse(x + upperLeft.x, y + upperLeft.y, upperLeft.x, upperLeft.y, 0, Math.PI, Math.PI * 1.5);
+            this.moveTo(x - upperLeft.x, y);
+            this.ellipse(x + w + upperRight.x, y + upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI / 2, -Math.PI, 1);
+            this.ellipse(x + w + lowerRight.x, y + h - lowerRight.y, lowerRight.x, lowerRight.y, 0, -Math.PI, -Math.PI * 1.5, 1);
+            this.ellipse(x - lowerLeft.x, y + h - lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, Math.PI / 2, 0, 1);
+            this.ellipse(x - upperLeft.x, y + upperLeft.y, upperLeft.x, upperLeft.y, 0, 0, -Math.PI / 2, 1);
 
-    }
+        } else if (h < 0) {
 
-    this.closePath();
-    this.moveTo(x, y);
+            this.moveTo(x + upperLeft.x, y);
+            this.ellipse(x + w - upperRight.x, y - upperRight.y, upperRight.x, upperRight.y, 0, Math.PI / 2, 0, 1);
+            this.ellipse(x + w - lowerRight.x, y + h + lowerRight.y, lowerRight.x, lowerRight.y, 0, 0, -Math.PI / 2, 1);
+            this.ellipse(x + lowerLeft.x, y + h + lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, -Math.PI / 2, -Math.PI, 1);
+            this.ellipse(x + upperLeft.x, y - upperLeft.y, upperLeft.x, upperLeft.y, 0, -Math.PI, -Math.PI * 1.5, 1);
 
-    /** @ignore */
-    function toDOMPointInit(value) {
+        } else {
 
-      const {x, y, z, w} = value;
-      return {x, y, z, w};
+            this.moveTo(x + upperLeft.x, y);
+            this.ellipse(x + w - upperRight.x, y + upperRight.y, upperRight.x, upperRight.y, 0, -Math.PI / 2, 0);
+            this.ellipse(x + w - lowerRight.x, y + h - lowerRight.y, lowerRight.x, lowerRight.y, 0, 0, Math.PI / 2);
+            this.ellipse(x + lowerLeft.x, y + h - lowerLeft.y, lowerLeft.x, lowerLeft.y, 0, Math.PI / 2, Math.PI);
+            this.ellipse(x + upperLeft.x, y + upperLeft.y, upperLeft.x, upperLeft.y, 0, Math.PI, Math.PI * 1.5);
 
-    }
+        }
 
-    /** @ignore */
-    function parseRadiiArgument(value) {
+        this.closePath();
+        this.moveTo(x, y);
 
-      // https://webidl.spec.whatwg.org/#es-union
-      // with 'optional (unrestricted double or DOMPointInit
-      //   or sequence<(unrestricted double or DOMPointInit)>) radii = 0'
-      const type = typeof value;
+        /** @ignore */
+        function toDOMPointInit(value) {
 
-      if (type === "undefined" || value === null) {
+            const {x, y, z, w} = value;
+            return {x, y, z, w};
 
-        return [0];
+        }
 
-      }
-      if (type === "function") {
+        /** @ignore */
+        function parseRadiiArgument(value) {
 
-        return [NaN];
+            // https://webidl.spec.whatwg.org/#es-union
+            // with 'optional (unrestricted double or DOMPointInit
+            //   or sequence<(unrestricted double or DOMPointInit)>) radii = 0'
+            const type = typeof value;
 
-      }
-      if (type === "object") {
+            if (type === "undefined" || value === null) {
 
-        if (typeof value[Symbol.iterator] === "function") {
+                return [0];
 
-          return [...value].map((elem) => {
-            // https://webidl.spec.whatwg.org/#es-union
-            // with '(unrestricted double or DOMPointInit)'
-            const elemType = typeof elem;
-            if (elemType === "undefined" || elem === null) {
-              return 0;
             }
-            if (elemType === "function") {
-              return NaN;
-            }
-            if (elemType === "object") {
-              return toDOMPointInit(elem);
-            }
-            return toUnrestrictedNumber(elem);
-          });
+            if (type === "function") {
 
-        }
+                return [NaN];
 
-        return [toDOMPointInit(value)];
+            }
+            if (type === "object") {
+
+                if (typeof value[Symbol.iterator] === "function") {
+
+                    return [...value].map((elem) => {
+                        // https://webidl.spec.whatwg.org/#es-union
+                        // with '(unrestricted double or DOMPointInit)'
+                        const elemType = typeof elem;
+                        if (elemType === "undefined" || elem === null) {
+                            return 0;
+                        }
+                        if (elemType === "function") {
+                            return NaN;
+                        }
+                        if (elemType === "object") {
+                            return toDOMPointInit(elem);
+                        }
+                        return toUnrestrictedNumber(elem);
+                    });
+
+                }
+
+                return [toDOMPointInit(value)];
 
-      }
+            }
 
-      return [toUnrestrictedNumber(value)];
+            return [toUnrestrictedNumber(value)];
 
-    }
+        }
 
-    /** @ignore */
-    function toUnrestrictedNumber(value) {
+        /** @ignore */
+        function toUnrestrictedNumber(value) {
 
-      return +value;
+            return +value;
 
-    }
+        }
 
-    /** @ignore */
-    function toCornerPoint(value) {
+        /** @ignore */
+        function toCornerPoint(value) {
 
-      const asNumber = toUnrestrictedNumber(value);
-      if (Number.isFinite(asNumber)) {
+            const asNumber = toUnrestrictedNumber(value);
+            if (Number.isFinite(asNumber)) {
 
-        return {
-          x: asNumber,
-          y: asNumber
-        };
+                return {
+                    x: asNumber,
+                    y: asNumber
+                };
 
-      }
-      if (Object(value) === value) {
+            }
+            if (Object(value) === value) {
 
-        return {
-          x: toUnrestrictedNumber(value.x || 0),
-          y: toUnrestrictedNumber(value.y || 0)
-        };
+                return {
+                    x: toUnrestrictedNumber(value.x || 0),
+                    y: toUnrestrictedNumber(value.y || 0)
+                };
 
-      }
+            }
 
-      return {
-        x: NaN,
-        y: NaN
-      };
+            return {
+                x: NaN,
+                y: NaN
+            };
 
-    }
+        }
 
-    /** @ignore */
-    function fixOverlappingCorners(corners) {
-      const [upperLeft, upperRight, lowerRight, lowerLeft] = corners;
-      const factors = [
-        Math.abs(w) / (upperLeft.x + upperRight.x),
-        Math.abs(h) / (upperRight.y + lowerRight.y),
-        Math.abs(w) / (lowerRight.x + lowerLeft.x),
-        Math.abs(h) / (upperLeft.y + lowerLeft.y)
-      ];
-      const minFactor = Math.min(...factors);
-      if (minFactor <= 1) {
-        corners.forEach((radii) => {
-            radii.x *= minFactor;
-            radii.y *= minFactor;
-        });
-      }
+        /** @ignore */
+        function fixOverlappingCorners(corners) {
+            const [upperLeft, upperRight, lowerRight, lowerLeft] = corners;
+            const factors = [
+                Math.abs(w) / (upperLeft.x + upperRight.x),
+                Math.abs(h) / (upperRight.y + lowerRight.y),
+                Math.abs(w) / (lowerRight.x + lowerLeft.x),
+                Math.abs(h) / (upperLeft.y + lowerLeft.y)
+            ];
+            const minFactor = Math.min(...factors);
+            if (minFactor <= 1) {
+                corners.forEach((radii) => {
+                    radii.x *= minFactor;
+                    radii.y *= minFactor;
+                });
+            }
+        }
     }
-  }
 
-  if (globalThis.CanvasRenderingContext2D) {
-    if (typeof globalThis.Path2D.prototype.roundRect === "undefined") {
-        globalThis.Path2D.prototype.roundRect = roundRect;
+    if (globalThis.CanvasRenderingContext2D) {
+        if (typeof globalThis.Path2D.prototype.roundRect === "undefined") {
+            globalThis.Path2D.prototype.roundRect = roundRect;
+        }
     }
-  }
-  if (globalThis.CanvasRenderingContext2D) {
-    if (typeof globalThis.CanvasRenderingContext2D.prototype.roundRect === "undefined") {
-        globalThis.CanvasRenderingContext2D.prototype.roundRect = roundRect;
+    if (globalThis.CanvasRenderingContext2D) {
+        if (typeof globalThis.CanvasRenderingContext2D.prototype.roundRect === "undefined") {
+            globalThis.CanvasRenderingContext2D.prototype.roundRect = roundRect;
+        }
     }
-  }
-  if (globalThis.OffscreenCanvasRenderingContext2D) {
-    if (typeof globalThis.OffscreenCanvasRenderingContext2D.prototype.roundRect === "undefined") {
-        globalThis.OffscreenCanvasRenderingContext2D.prototype.roundRect = roundRect;
+    if (globalThis.OffscreenCanvasRenderingContext2D) {
+        if (typeof globalThis.OffscreenCanvasRenderingContext2D.prototype.roundRect === "undefined") {
+            globalThis.OffscreenCanvasRenderingContext2D.prototype.roundRect = roundRect;
+        }
     }
-  }
 
 })();

package/src/renderable/collectable.js

@@ -8,7 +8,7 @@ import pool from "./../system/pooling.js";
  * a basic collectable helper class for immovable object (e.g. a coin)
  * @augments Sprite
  */
- export default class Collectable extends Sprite {
+export default class Collectable extends Sprite {
     /**
      * @param {number} x - the x coordinates of the collectable
      * @param {number} y - the y coordinates of the collectable

package/src/renderable/colorlayer.js

@@ -7,7 +7,7 @@ import Renderable from "./renderable.js";
  * a generic Color Layer Object.  Fills the entire Canvas with the color not just the container the object belongs to.
  * @augments Renderable
  */
- export default class ColorLayer extends Renderable {
+export default class ColorLayer extends Renderable {
     /**
      * @param {string} name - Layer name
      * @param {Color|string} color - CSS color
@@ -24,9 +24,9 @@ import Renderable from "./renderable.js";
          * @name color
          * @memberof ColorLayer#
          */
-         this.color = pool.pull("Color").parseCSS(color);
+        this.color = pool.pull("Color").parseCSS(color);
 
-         this.onResetEvent(name, color, z);
+        this.onResetEvent(name, color, z);
 
     }
 

package/src/renderable/container.js

@@ -22,7 +22,7 @@ let globalFloatingCounter = 0;
  * Container represents a collection of child objects
  * @augments Renderable
  */
- export default class Container extends Renderable {
+export default class Container extends Renderable {
     /**
      * @param {number} [x=0] - position of the container (accessible via the inherited pos.x property)
      * @param {number} [y=0] - position of the container (accessible via the inherited pos.y property)
@@ -177,7 +177,7 @@ let globalFloatingCounter = 0;
      * will not be in any container. <br>
      * if the given child implements a onActivateEvent method, that method will be called
      * once the child is added to this container.
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be added
      * @param {number} [z] - forces the z index of the child to the specified value
      * @returns {Renderable} the added child
      */
@@ -210,7 +210,7 @@ let globalFloatingCounter = 0;
         // set the child z value if required
         if (typeof(child.pos) !== "undefined") {
             if (typeof(z) === "number") {
-                    child.pos.z = z;
+                child.pos.z = z;
             } else if (this.autoDepth === true) {
                 child.pos.z = this.getChildren().length;
             }
@@ -231,7 +231,7 @@ let globalFloatingCounter = 0;
 
         // if a physic body(ies) to the game world
         if (this.isAttachedToRoot()) {
-            var worldContainer = this.getRootAncestor();
+            let worldContainer = this.getRootAncestor();
             if (child.body instanceof Body) {
                 worldContainer.addBody(child.body);
             }
@@ -259,8 +259,8 @@ let globalFloatingCounter = 0;
     /**
      * Add a child to the container at the specified index<br>
      * (the list won't be sorted after insertion)
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
-     * @param {number} index
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be added
+     * @param {number} index - The index at which to insert the child
      * @returns {Renderable} the added child
      */
     addChildAt(child, index) {
@@ -301,7 +301,7 @@ let globalFloatingCounter = 0;
 
             // if a physic body(ies) to the game world
             if (this.isAttachedToRoot()) {
-                var worldContainer = this.getRootAncestor();
+                let worldContainer = this.getRootAncestor();
                 if (child.body instanceof Body) {
                     worldContainer.addBody(child.body);
                 }
@@ -370,8 +370,8 @@ let globalFloatingCounter = 0;
 
     /**
      * Swaps the position (z-index) of 2 children
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child2
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be added
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child2 - Child to be added
      */
     swapChildren(child, child2) {
         let index = this.getChildIndex(child);
@@ -395,7 +395,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Returns the Child at the specified index
-     * @param {number} index
+     * @param {number} index - The index of the child
      * @returns {Renderable} the child at the specified index
      */
     getChildAt(index) {
@@ -409,7 +409,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Returns the index of the given Child
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - The child object
      * @returns {number} index
      */
     getChildIndex(child) {
@@ -418,7 +418,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Returns the next child within the container or undefined if none
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - The child object
      * @returns {Renderable} child
      */
     getNextChild(child) {
@@ -431,7 +431,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Returns true if contains the specified Child
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - The child object
      * @returns {boolean}
      */
     hasChild(child) {
@@ -490,7 +490,7 @@ let globalFloatingCounter = 0;
 
     /**
      * returns the list of childs with the specified class type
-     * @param {object} classType
+     * @param {object} classType - Class type
      * @returns {Renderable[]} Array of children
      */
     getChildByType(classType) {
@@ -570,7 +570,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Checks if this container is root or if it's attached to the root container.
-     * @returns {boolean}
+     * @returns {boolean} true if this container is root or if it's attached to the root container
      */
     isAttachedToRoot() {
         if (this.root === true) {
@@ -589,7 +589,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Returns the instance of the root container (i.e. the current application World container).
-     * @returns {Container}
+     * @returns {Container} root container
      */
     getRootAncestor() {
         if (this.root === true) {
@@ -639,7 +639,7 @@ let globalFloatingCounter = 0;
     /**
      * Invokes the removeChildNow in a defer, to ensure the child is removed safely after the update & draw stack has completed. <br>
      * if the given child implements a onDeactivateEvent() method, that method will be called once the child is removed from this container.
-     * @param {RendRenderable|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapTexterable} child
+     * @param {RendRenderable|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapTexterable} child - Child to be removed
      * @param {boolean} [keepalive=false] - true to prevent calling child.destroy()
      */
     removeChild(child, keepalive) {
@@ -655,7 +655,7 @@ let globalFloatingCounter = 0;
      * Removes (and optionally destroys) a child from the container.<br>
      * (removal is immediate and unconditional)<br>
      * Never use keepalive=true with objects from {@link pool}. Doing so will create a memory leak.
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be removed
      * @param {boolean} [keepalive=False] - True to prevent calling child.destroy()
      */
     removeChildNow(child, keepalive) {
@@ -667,7 +667,7 @@ let globalFloatingCounter = 0;
             // remove the body first to avoid a condition where a body can be detached
             // from its parent, before the body is removed from the game world
             if (child.body instanceof Body) {
-               this.getRootAncestor().removeBody(child.body);
+                this.getRootAncestor().removeBody(child.body);
             }
 
             if (!keepalive) {
@@ -718,7 +718,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Move the child in the group one step forward (z depth).
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child -  Child to be moved
      */
     moveUp(child) {
         let childIndex = this.getChildIndex(child);
@@ -732,7 +732,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Move the child in the group one step backward (z depth).
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be moved
      */
     moveDown(child) {
         let childIndex = this.getChildIndex(child);
@@ -746,7 +746,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Move the specified child to the top(z depth).
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be moved
      */
     moveToTop(child) {
         let childIndex = this.getChildIndex(child);
@@ -763,7 +763,7 @@ let globalFloatingCounter = 0;
 
     /**
      * Move the specified child the bottom (z depth).
-     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child
+     * @param {Renderable|Entity|Sprite|Collectable|Trigger|Draggable|DropTarget|NineSliceSprite|ImageLayer|ColorLayer|Light2d|UIBaseElement|UISpriteElement|UITextButton|Text|BitmapText} child - Child to be moved
      */
     moveToBottom(child) {
         let childIndex = this.getChildIndex(child);
@@ -779,7 +779,7 @@ let globalFloatingCounter = 0;
     }
 
     /**
-     * Manually trigger the sort of all the childs in the container</p>
+     * Manually trigger the sort of all the childs in the container
      * @param {boolean} [recursive=false] - recursively sort all containers if true
      */
     sort(recursive) {