melonjs 17.3.0 → 17.4.0

package/dist/melonjs.module.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v17.3.0
+ * melonJS Game Engine - v17.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -3650,7 +3650,7 @@ class Vector2d {
 
     /**
      * return true if this vector is equal to the given values or vector
-     * @param {number|Vector2d|ObservableVector2d} x
+     * @param {number|Vector2d} x
      * @param {number} [y]
      * @returns {boolean}
      */
@@ -3686,7 +3686,7 @@ class Vector2d {
     /**
      * Rotate this vector (counter-clockwise) by the specified angle (in radians).
      * @param {number} angle - The angle to rotate (in radians)
-     * @param {Vector2d|ObservableVector2d} [v] - an optional point to rotate around
+     * @param {Vector2d} [v] - an optional point to rotate around
      * @returns {Vector2d} Reference to this object for method chaining
      */
     rotate(angle, v) {
@@ -3829,6 +3829,11 @@ class Vector2d {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./vector2.js";
+ */
+
 /**
  * @classdesc
  * a generic 3D Vector Object
@@ -4085,10 +4090,10 @@ class Vector3d {
 
     /**
      * return true if this vector is equal to the given values or vector
-     * @param {number|Vector2d|ObservableVector2d|Vector3d|ObservableVector3d} x
+     * @param {number|Vector2d|Vector3d} x
      * @param {number} [y]
      * @param {number} [z]
-     * @returns {boolean}
+     * @returns {boolean} true if both vectros are equals
      */
     equals(...args) {
         let _x, _y, _z;
@@ -4127,7 +4132,7 @@ class Vector3d {
     /**
      * Rotate this vector (counter-clockwise) by the specified angle (in radians) around the z axis
      * @param {number} angle - The angle to rotate (in radians)
-     * @param {Vector2d|ObservableVector2d} [v] - an optional point to rotate around (on the same z axis)
+     * @param {Vector2d} [v] - an optional point to rotate around (on the same z axis)
      * @returns {Vector3d} Reference to this object for method chaining
      */
     rotate(angle, v) {
@@ -4742,6 +4747,12 @@ class ObservableVector2d extends Vector2d {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import ObservableVector2d from "./observable_vector2.js";
+ * @import Vector2d from "./vector2.js";
+ */
+
 /**
  * @classdesc
  * A Vector3d object that provide notification by executing the given callback when the vector is changed.
@@ -5288,6 +5299,14 @@ class ObservableVector3d extends Vector3d {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Matrix3d from "./matrix3.js";
+ * @import Vector2d from "./vector2.js";
+ * @import Vector3d from "./vector3.js";
+ */
+
+
 /**
  * @classdesc
  * a Matrix2d Object.<br>
@@ -5765,6 +5784,13 @@ class Matrix2d {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Matrix2d from "./matrix2.js";
+ * @import Vector2d from "./vector2.js";
+ * @import Vector3d from "./vector3.js";
+ */
+
 /**
  * @classdesc
  * a 4x4 Matrix3d Object
@@ -7064,6 +7090,14 @@ earcut.flatten = function (data) {
 var earcutExports = earcut$2.exports;
 var earcut$1 = /*@__PURE__*/getDefaultExportFromCjs(earcutExports);
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ * @import ObservableVector2d from "./../math/observable_vector2.js";
+ * @import Matrix2d from "./../math/matrix2.js";
+ * @import Bounds from "./../physics/bounds.js";
+ */
+
 /**
  * @classdesc
  * a polygon Object.<br>
@@ -7486,6 +7520,11 @@ class Polygon {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2d.js";
+ */
+
 /**
  * @classdesc
  * a line segment Object
@@ -7583,6 +7622,14 @@ class Line extends Polygon {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ * @import ObservableVector2d from "./../math/observable_vector2.js";
+ * @import Matrix2d from "./../math/matrix2.js";
+ * @import Bounds from "./../physics/bounds.js";
+ */
+
 /**
  * @classdesc
  * an ellipse Object
@@ -7721,7 +7768,7 @@ class Ellipse {
     /**
      * apply the given transformation matrix to this ellipse
      * @param {Matrix2d} matrix - the transformation matrix
-     * @returns {Polygon} Reference to this object for method chaining
+     * @returns {Ellipse} Reference to this object for method chaining
      */
     transform(matrix) { // eslint-disable-line no-unused-vars
         // TODO
@@ -7818,6 +7865,11 @@ class Ellipse {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ **/
+
 /**
  * @classdesc
  * represents a point in a 2d space
@@ -7890,6 +7942,11 @@ class Point {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ **/
+
 /**
  * @classdesc
  * a rectangle Object
@@ -8424,6 +8481,12 @@ var array$1 = {
 	weightedRandom: weightedRandom
 };
 
+/**
+ * @import World from "./world.js";
+ * @import Container from "./../renderable/container.js";
+ * @import Bounds from "./bounds.js";
+ */
+
 /*
  * A QuadTree implementation in JavaScript, a 2d spatial subdivision algorithm.
  * Based on the QuadTree Library by Timo Hausmann and released under the MIT license
@@ -8809,6 +8872,12 @@ class QuadTree {
     }
 }
 
+/**
+ * @import Point from "./../geometries/point.js";
+ * @import Rect from "./../geometries/rectangle.js";
+ * @import Polygon from "./../geometries/poly.js";
+ **/
+
 /**
  * @classdesc
  * a bound object contains methods for creating and manipulating axis-aligned bounding boxes (AABB).
@@ -9207,6 +9276,11 @@ class Bounds {
 
 }
 
+/**
+ * @import Line from "./../geometries/line.js";
+ * @import Renderable from "./../renderable/renderable.js";
+ **/
+
 /**
  * Collision detection (and projection-based collision response) of 2D shapes.<br>
  * Based on the Separating Axis Theorem and supports detecting collisions between simple Axis-Aligned Boxes, convex polygons and circles based shapes.
@@ -13725,6 +13799,11 @@ var string$1 = {
 
 // external import
 
+/**
+ * additional import for TypeScript
+ * @import { Asset } from "./../loader/loader.js";
+ */
+
 /**
  * @namespace audio
  */
@@ -13858,7 +13937,7 @@ function disable() {
 /**
  * Load an audio file
  * @memberof audio
- * @param {loader.Asset} sound
+ * @param {Asset} sound
  * @param {Function} [onloadcb] - function to be called when the resource is loaded
  * @param {Function} [onerrorcb] - function to be called in case of error
  * @param {Object} [settings] - custom settings to apply to the request (@link https://developer.mozilla.org/en-US/docs/Web/API/fetch#options)
@@ -15629,6 +15708,11 @@ var device = {
 	wheel: wheel
 };
 
+/**
+ * additional import for TypeScript
+ * @import Renderer from "./../video/renderer.js";
+ */
+
 /**
  * Application & Renderer Settings definition.
  * @typedef {Object} ApplicationSettings
@@ -16684,6 +16768,10 @@ class Pointer extends Bounds {
     }
 }
 
+/**
+ * @import Vector2d from "./../math/vector2.js";
+ */
+
 /**
  * A pool of `Pointer` objects to cache pointer/touch event coordinates.
  * @type {Array.<Vector2d>}
@@ -18357,6 +18445,24 @@ class GLShader {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ * @import Vector3d from "./../math/vector3.js";
+ * @import Matrix2d from "./../math/matrix2.js";
+ * @import Entity from "./entity/entity.js";
+ * @import Container from "./container.js";
+ * @import Line from "./../geometries/line.js";
+ * @import Ellipse from "./../geometries/ellipse.js";
+ * @import Polygon from "./../geometries/poly.js";
+ * @import RoundRect from "./../geometries/roundrect.js";
+ * @import Application from "./../application/application.js";
+ * @import CanvasRenderer from "./../video/canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
+ * @import ResponseObject from "./../physics/response.js";
+ **/
+
+
 /**
  * @classdesc
  * A base class for renderable objects.
@@ -19103,7 +19209,7 @@ class Renderable extends Rect {
      * onCollision callback, triggered in case of collision,
      * when this renderable body is colliding with another one
      * @param {ResponseObject} response - the collision response object
-     * @param {Renderable|Container|Entity|Sprite|NineSliceSprite} other - the other renderable touching this one (a reference to response.a or response.b)
+     * @param {Renderable} other - the other renderable touching this one (a reference to response.a or response.b)
      * @returns {boolean} true if the object should respond to the collision (its position and velocity will be corrected)
      * @example
      * // colision handler
@@ -19198,6 +19304,14 @@ class Renderable extends Rect {
 
 }
 
+/**
+ * @import Bounds from "./../physics/bounds.js";
+ * @import Color from "./../math/color.js";
+ * @import Entity from "./../renderable/entity/entity.js";
+ * @import Sprite from "./../renderable/sprite.js";
+ * @import NineSliceSprite from "./../renderable/nineslicesprite.js";
+ */
+
 // some ref shortcut
 const MIN = Math.min, MAX = Math.max;
 
@@ -24427,6 +24541,11 @@ function endpointToCenterParameterization(x1, y1, x2, y2, largeArcFlag, sweepFla
     };
 }
 
+/**
+ * additional import for TypeScript
+ * @import Point from "./point.js";
+ */
+
 /**
  * @classdesc
  * a simplified path2d implementation, supporting only one path
@@ -24888,6 +25007,12 @@ class Path2D {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import CanvasRenderer from "./../canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../webgl/webgl_renderer.js";
+ */
+
 // default canvas settings
 let defaultAttributes = {
     offscreenCanvas : false,
@@ -24961,8 +25086,8 @@ class CanvasRenderTarget {
     /**
      * @param {number} width - the desired width of the canvas
      * @param {number} height - the desired height of the canvas
-     * @param {Settings} attributes - The attributes to create both the canvas and context
-     * @param {boolean} [attributes.context="2d"] - the context type to be created ("2d", "webgl")
+     * @param {object} attributes - The attributes to create both the canvas and context
+     * @param {string} [attributes.context="2d"] - the context type to be created ("2d", "webgl")
      * @param {boolean} [attributes.preferWebGL1=false] - set to true for force using WebGL1 instead of WebGL2 (if supported)
      * @param {boolean} [attributes.transparent=false] - specify if the canvas contains an alpha channel
      * @param {boolean} [attributes.offscreenCanvas=false] - will create an offscreenCanvas if true instead of a standard canvas
@@ -25186,6 +25311,15 @@ class CanvasRenderTarget {
     }
 }
 
+/**
+ * @import Rect from "./../geometries/rectangle.js";
+ * @import RoundRect from "./../geometries/roundrect.js";
+ * @import Polygon from "./../geometries/poly.js";
+ * @import Line from "./../geometries/line.js";
+ * @import Ellipse from "./../geometries/ellipse.js";
+ * @import Bounds from "./../physics/bounds.js";
+ */
+
 /**
  * @classdesc
  * a base renderer object
@@ -25408,7 +25542,7 @@ class Renderer {
      * enable/disable image smoothing (scaling interpolation) for the current render target
      * @param {boolean} [enable=false]
      */
-    setAntiAlias(enable) {
+    setAntiAlias(enable = false) {
         this.renderTarget.setAntiAlias(enable);
     }
 
@@ -25750,6 +25884,11 @@ function parseAseprite(data, textureAtlas) {
     return atlas;
 }
 
+/**
+ * additional import for TypeScript
+ * @import NineSliceSprite from "./../../renderable/nineslicesprite.js";
+ */
+
 /**
  * create a simple 1 frame texture atlas based on the given parameters
  * @ignore
@@ -26553,6 +26692,16 @@ class TextureCache {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import Rect from "./../../geometries/rectangle.js";
+ * @import RoundRect from "./../../geometries/roundrect.js";
+ * @import Polygon from "./../../geometries/poly.js";
+ * @import Line from "./../../geometries/line.js";
+ * @import Ellipse from "./../../geometries/ellipse.js";
+ * @import Matrix2d from "./../../math/matrix2.js";
+ */
+
 /**
  * @classdesc
  * a canvas renderer object
@@ -27221,6 +27370,8 @@ class CanvasRenderer extends Renderer {
 
     /**
      * sets or returns the thickness of lines for shape drawing
+     * @type {number}
+     * @default 1
      */
     get lineWidth() {
         return this.getContext().lineWidth;
@@ -27234,6 +27385,25 @@ class CanvasRenderer extends Renderer {
         return value;
     }
 
+    /**
+     * sets or returns the shape used to join two line segments where they meet.
+     * There are three possible values for this property: "round", "bevel", and "miter"
+     * @type {string}
+     * @default "miter"
+     */
+    get lineJoin() {
+        return this.getContext().lineJoin;
+    }
+
+    /**
+     * @ignore
+     */
+    set lineJoin(value) {
+        let context = this.getContext();
+        context.lineJoin = value;
+        return context.lineJoin;
+    }
+
     /**
      * Reset (overrides) the renderer transformation matrix to the
      * identity one, and then apply the given transformation matrix.
@@ -27957,6 +28127,29 @@ function deferredRemove(child, keepalive) {
 
 let globalFloatingCounter = 0;
 
+/**
+ * additional import for TypeScript
+ * @import Color from "./../math/color.js";
+ * @import Entity from "./entity/entity.js";
+ * @import Sprite from "./sprite.js";
+ * @import Collectable from "./collectable.js";
+ * @import Trigger from "./trigger.js";
+ * @import { Draggable } from "./draggable.js";
+ * @import { DropTarget } from "./dragndrop.js";
+ * @import NineSliceSprite from "./nineslicesprite.js";
+ * @import ImageLayer from "./imagelayer.js";
+ * @import ColorLayer from "./colorlayer.js";
+ * @import Light2d from "./light2d.js";
+ * @import UIBaseElement from "./ui/uibaseelement.js";
+ * @import UISpriteElement from "./ui/uispriteelement.js";
+ * @import UITextButton from "./ui/uitextbutton.js";
+ * @import Text from "./text/text.js";
+ * @import BitmapText from "./text/bitmaptext.js";
+ * @import Bounds from "./../physics/bounds.js";
+ * @import CanvasRenderer from "./../video/canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
+ */
+
 /**
  * @classdesc
  * Container represents a collection of child objects
@@ -28579,7 +28772,7 @@ class Container extends Renderable {
     /**
      * 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 - Child to be removed
+     * @param {Renderable|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()
      */
     removeChild(child, keepalive) {
@@ -28860,8 +29053,7 @@ class Container extends Renderable {
     }
 
     /**
-      * draw this renderable (automatically called by melonJS)
-     * @protected
+     * draw this renderable (automatically called by melonJS)
      * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
      * @param {Camera2d} [viewport] - the viewport to (re)draw
      */
@@ -31369,7 +31561,7 @@ function onResourceLoaded(res) {
 
 /**
  * on error callback for image loading
- * @param {loader.Asset} asset - asset that loaded with failure
+ * @param {Asset} asset - asset that loaded with failure
  * @ignore
  */
 function onLoadingError(res) {
@@ -31383,7 +31575,8 @@ function onLoadingError(res) {
 
 /**
  * an asset definition to be used with the loader
- * @typedef {object} loader.Asset
+ * @typedef {object} Asset
+ * @memberof loader
  * @property {string} name - name of the asset
  * @property {string} type  - the type of the asset ("audio"|"binary"|"image"|"json"|"js"|"tmx"|"tmj"|"tsx"|"tsj"|"fontface"|"video")
  * @property {string} [src]  - path and/or file name of the resource (for audio assets only the path is required)
@@ -31429,7 +31622,7 @@ function onLoadingError(res) {
  * @memberof loader
  * @param {string} type - asset type
  * @param {function} parserFn - parser function
- * @see loader.Asset.type
+ * @see Asset.type
  * @example
  * // specify a custom function for "abc" format
  * function customAbcParser(data, onload, onerror) {
@@ -31460,7 +31653,7 @@ function setParser(type, parserFn) {
 /**
  * set all the specified game assets to be preloaded.
  * @memberof loader
- * @param {loader.Asset[]} assets - list of assets to load
+ * @param {Asset[]} assets - list of assets to load
  * @param {Function} [onloadcb=loader.onload] - function to be called when all resources are loaded
  * @param {boolean} [switchToLoadState=true] - automatically switch to the loading screen
  * @example
@@ -31555,7 +31748,7 @@ function reload(src) {
 /**
  * Load a single asset (to be used if you need to load additional asset(s) during the game)
  * @memberof loader
- * @param {loader.Asset} asset
+ * @param {Asset} asset
  * @param {Function} [onload] - function to be called when the asset is loaded
  * @param {Function} [onerror] - function to be called in case of error
  * @returns {number} the amount of corresponding resource to be preloaded
@@ -31608,7 +31801,7 @@ function load(asset, onload, onerror) {
 /**
  * unload the specified asset to free memory
  * @memberof loader
- * @param {loader.Asset} asset
+ * @param {Asset} asset
  * @returns {boolean} true if unloaded
  * @example me.loader.unload({name: "avatar",  type:"image"});
  */
@@ -31863,6 +32056,13 @@ var loader = {
 	get withCredentials () { return withCredentials; }
 };
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ * @import CanvasRenderer from "./../video/canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
+ */
+
 /**
  * @classdesc
  * An object to display a fixed or animated sprite on screen.
@@ -32475,7 +32675,6 @@ class Sprite extends Renderable {
 
     /**
      * draw this srite (automatically called by melonJS)
-     * @protected
      * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
      * @param {Camera2d} [viewport] - the viewport to (re)draw
      */
@@ -33438,6 +33637,17 @@ class Timer {
 
 const timer = new Timer();
 
+/**
+ * @import Entity from "./../renderable/entity/entity.js";
+ * @import Container from "./../renderable/container.js";
+ * @import Renderable from "./../renderable/renderable.js";
+ * @import Sprite from "./../renderable/sprite.js";
+ * @import NineSliceSprite from "./../renderable/nineslicesprite.js";
+ * @import Line from "./../geometries/line.js";
+ * @import Vector2d from "./../math/vector2.js";
+ * @import ObservableVector2d from "./../math/observable_vector2.js";
+ **/
+
 /**
  * @classdesc
  * a Generic Physic Body Object with some physic properties and behavior functionality, to add as a member of a Renderable.
@@ -35158,6 +35368,12 @@ class VertexArrayBuffer {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import WebGLRenderer from "./../webgl_renderer.js";
+ * @import Matrix3d from "./../../../math/matrix3.js";
+ */
+
 /**
  * @classdesc
  * A base Compositor object.
@@ -35385,6 +35601,11 @@ var primitiveVertex = "// Current vertex point\nattribute vec2 aVertex;\nattribu
 
 var primitiveFragment = "varying vec4 vColor;\n\nvoid main(void) {\n    gl_FragColor = vColor;\n}\n";
 
+/**
+ * additional import for TypeScript
+ * @import Point from "./../../../geometries/point.js";
+ */
+
 /**
  * @classdesc
  * A WebGL Compositor object. This class handles all of the WebGL state<br>
@@ -35454,6 +35675,11 @@ var quadVertex = "// Current vertex point\nattribute vec2 aVertex;\nattribute ve
 
 var quadFragment = "uniform sampler2D uSampler;\nvarying vec4 vColor;\nvarying vec2 vRegion;\n\nvoid main(void) {\n    gl_FragColor = texture2D(uSampler, vRegion) * vColor;\n}\n";
 
+/**
+ * additional import for TypeScript
+ * @import {TextureAtlas} from "./../../texture/atlas.js";
+ */
+
 // a pool of resuable vectors
 let V_ARRAY = [
     new Vector2d(),
@@ -35694,12 +35920,23 @@ class QuadCompositor extends Compositor {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Rect from "./../../geometries/rectangle.js";
+ * @import RoundRect from "./../../geometries/roundrect.js";
+ * @import Polygon from "./../../geometries/poly.js";
+ * @import Line from "./../../geometries/line.js";
+ * @import Ellipse from "./../../geometries/ellipse.js";
+ * @import Matrix3d from "./../../math/matrix3.js";
+ * @import Compositor from "./compositors/compositor.js";
+ */
+
 // list of supported compressed texture formats
 let supportedCompressedTextureFormats;
 
 /**
  * @classdesc
- * a WebGL renderer draw
+ * a WebGL renderer object
  * @augments Renderer
  */
 class WebGLRenderer extends Renderer {
@@ -35734,13 +35971,23 @@ class WebGLRenderer extends Renderer {
         this.gl = this.renderTarget.context;
 
         /**
-         * sets or returns the thickness of lines for shape drawing (limited to strokeLine)
+         * sets or returns the thickness of lines for shape drawing (limited to strokeLine, strokePolygon and strokeRect)
          * @type {number}
          * @default 1
          * @see WebGLRenderer#strokeLine
+         * @see WebGLRenderer#strokePolygon
+         * @see WebGLRenderer#strokeRect
          */
         this.lineWidth = 1;
 
+        /**
+         * sets or returns the shape used to join two line segments where they meet.
+         * Out of the three possible values for this property: "round", "bevel", and "miter", only "round" is supported for now in WebGL
+         * @type {string}
+         * @default "round"
+         */
+        this.lineJoin = "round";
+
         /**
          * the vertex buffer used by this WebGL Renderer
          * @type {WebGLBuffer}
@@ -35782,7 +36029,7 @@ class WebGLRenderer extends Renderer {
 
         /**
          * The current compositor used by the renderer
-         * @type {WebGLCompositor}
+         * @type {Compositor}
          */
         this.currentCompositor = undefined;
 
@@ -35794,7 +36041,7 @@ class WebGLRenderer extends Renderer {
 
         /**
          * The list of active compositors
-         * @type {Map<WebGLCompositor>}
+         * @type {Map<Compositor>}
          */
         this.compositors = new Map();
 
@@ -35873,7 +36120,6 @@ class WebGLRenderer extends Renderer {
      * The WebGL version used by this renderer (1 or 2)
      * @type {number}
      * @default 1
-     * @readonly
      */
     get WebGLVersion() {
         return this.renderTarget.WebGLVersion;
@@ -36443,10 +36689,11 @@ class WebGLRenderer extends Renderer {
 
     /**
      * not used by this renderer?
+     * @param {boolean} [enable=false]
      * @ignore
      */
-    setAntiAlias(context, enable) {
-        super.setAntiAlias(context, enable);
+    setAntiAlias(enable = false) {
+        super.setAntiAlias(enable);
         // TODO: perhaps handle GLNEAREST or other options with texture binding
     }
 
@@ -36538,7 +36785,7 @@ class WebGLRenderer extends Renderer {
      * @param {number} h - vertical radius of the ellipse
      */
     fillEllipse(x, y, w, h) {
-        this.strokeEllipse(x, y, w, h, false);
+        this.strokeEllipse(x, y, w, h, true);
     }
 
     /**
@@ -36593,7 +36840,7 @@ class WebGLRenderer extends Renderer {
     }
 
     /**
-     * Stroke a me.Polygon on the screen with a specified color
+     * Stroke a Polygon on the screen with a specified color
      * @param {Polygon} poly - the shape to draw
      * @param {boolean} [fill=false] - also fill the shape with the current color if true
      */
@@ -36601,24 +36848,38 @@ class WebGLRenderer extends Renderer {
         const points = poly.points;
         const len = points.length;
 
-        this.setCompositor("primitive");
-
         this.translate(poly.pos.x, poly.pos.y);
 
-        this.path2D.beginPath();
-        for (let i = 0; i < len - 1; i++) {
-            const curPoint = points[i];
-            const nextPoint = points[i + 1];
-            this.path2D.moveTo(curPoint.x, curPoint.y);
-            this.path2D.lineTo(nextPoint.x, nextPoint.y);
-        }
-        this.path2D.closePath();
-
-        if (fill === false) {
-            this.currentCompositor.drawVertices(this.gl.LINES, this.path2D.points);
+        if (fill === false && this.lineWidth > 1) {
+            const radius = this.lineWidth / 2;
+            for (let i = 0; i < len - 1; i++) {
+                const curPoint = points[i];
+                const nextPoint = points[i + 1];
+                this.fillEllipse(nextPoint.x, nextPoint.y, radius, radius);
+                this.strokeLine(curPoint.x, curPoint.y, nextPoint.x, nextPoint.y);
+            }
+            const lastPoint = points[len - 1];
+            const firstPoint = points[0];
+            if (!lastPoint.equals(firstPoint)) {
+                this.fillEllipse(firstPoint.x, firstPoint.y, radius, radius);
+                this.strokeLine(lastPoint.x, lastPoint.y, firstPoint.x, firstPoint.y);
+            }
         } else {
-            // draw all triangles
-            this.currentCompositor.drawVertices(this.gl.TRIANGLES, this.path2D.triangulatePath());
+            this.setCompositor("primitive");
+            this.path2D.beginPath();
+            for (let i = 0; i < len - 1; i++) {
+                const curPoint = points[i];
+                const nextPoint = points[i + 1];
+                this.path2D.moveTo(curPoint.x, curPoint.y);
+                this.path2D.lineTo(nextPoint.x, nextPoint.y);
+            }
+            this.path2D.closePath();
+            if (fill === false) {
+                this.currentCompositor.drawVertices(this.gl.LINES, this.path2D.points);
+            } else {
+                // draw all triangles
+                this.currentCompositor.drawVertices(this.gl.TRIANGLES, this.path2D.triangulatePath());
+            }
         }
 
         this.translate(-poly.pos.x, -poly.pos.y);
@@ -36641,13 +36902,25 @@ class WebGLRenderer extends Renderer {
      * @param {boolean} [fill=false] - also fill the shape with the current color if true
      */
     strokeRect(x, y, width, height, fill = false) {
-        this.setCompositor("primitive");
-        this.path2D.beginPath();
-        this.path2D.rect(x, y, width, height);
-        if (fill === false) {
-            this.currentCompositor.drawVertices(this.gl.LINES, this.path2D.points);
+        if (fill === false && this.lineWidth > 1) {
+            const radius = this.lineWidth / 2;
+            this.strokeLine(x, y, x + width, y);
+            this.strokeLine(x + width, y, x + width, y + height);
+            this.strokeLine(x + width, y + height, x, y + height);
+            this.strokeLine(x, y + height, x, y);
+            this.fillEllipse(x, y, radius, radius);
+            this.fillEllipse(x + width, y, radius, radius);
+            this.fillEllipse(x + width, y + height, radius, radius);
+            this.fillEllipse(x, y + height, radius, radius);
         } else {
-            this.currentCompositor.drawVertices(this.gl.TRIANGLES, this.path2D.triangulatePath());
+            this.setCompositor("primitive");
+            this.path2D.beginPath();
+            this.path2D.rect(x, y, width, height);
+            if (fill === false) {
+                this.currentCompositor.drawVertices(this.gl.LINES, this.path2D.points);
+            } else {
+                this.currentCompositor.drawVertices(this.gl.TRIANGLES, this.path2D.triangulatePath());
+            }
         }
     }
 
@@ -36873,6 +37146,14 @@ class WebGLRenderer extends Renderer {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import Color from "./../math/color.js";
+ * @import CanvasRenderer from "./../video/canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
+ * @import Camera2d from "./../camera/camera2d.js";
+ */
+
 /**
  * @classdesc
  * a generic Color Layer Object.  Fills the entire Canvas with the color not just the container the object belongs to.
@@ -36912,9 +37193,6 @@ class ColorLayer extends Renderable {
 
     /**
      * draw this color layer (automatically called by melonJS)
-     * @name draw
-     * @memberof ColorLayer
-     * @protected
      * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
      * @param {Camera2d} [viewport] - the viewport to (re)draw
      */
@@ -36940,6 +37218,11 @@ class ColorLayer extends Renderable {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import Vector2d from "./../math/vector2.js";
+ */
+
 /**
  * @classdesc
  * a generic Image Layer Object
@@ -37213,6 +37496,12 @@ class ImageLayer extends Sprite {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import Color from "./../math/color.js";
+ * @import { TextureAtlas } from "./../video/texture/atlas.js";
+ */
+
 /**
  * @classdesc
  * A NineSliceSprite is similar to a Sprite, but it uses 9-slice scaling to strech its inner area to fit the size of the Renderable,
@@ -39114,6 +39403,11 @@ class Collectable extends Sprite {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import ResponseObject from "./../physics/response.js";
+ */
+
 /**
  * @classdesc
  * trigger an event when colliding with another object
@@ -39246,7 +39540,7 @@ class Trigger extends Renderable {
      * @name onCollision
      * @memberof Trigger
      * @param {ResponseObject} response - the collision response object
-     * @param {Renderable|Container|Entity|Sprite|NineSliceSprite} other - the other renderable touching this one (a reference to response.a or response.b)
+     * @param {Renderable} other - the other renderable touching this one (a reference to response.a or response.b)
      * @returns {boolean} true if the object should respond to the collision (its position and velocity will be corrected)
      */
     onCollision(response, other) { // eslint-disable-line no-unused-vars
@@ -39258,6 +39552,15 @@ class Trigger extends Renderable {
 
 }
 
+/**
+ * additional import for TypeScript
+ * @import Color from "./../math/color.js";
+ * @import Ellipse from "./../geometries/ellipse.js";
+ * @import CanvasRenderer from "./../video/canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
+ */
+
+
 /** @ignore */
 function createGradient(light) {
     let context = light.texture.context;
@@ -39388,7 +39691,6 @@ class Light2d extends Renderable {
      * draw this Light2d (automatically called by melonJS)
      * @name draw
      * @memberof Light2d
-     * @protected
      * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
      * @param {Camera2d} [viewport] - the viewport to (re)draw
      */
@@ -39761,6 +40063,11 @@ class Draggable extends Renderable {
     }
 }
 
+/**
+ * additional import for TypeScript
+ * @import { Draggable } from "./draggable.js";
+ */
+
 /**
  * @classdesc
  * a base drop target object
@@ -39869,6 +40176,15 @@ class DropTarget extends Renderable {
 * Available under the MIT License - https://github.com/jriecken/sat-js
 */
 
+/**
+ * @import Entity from "./../renderable/entity/entity.js";
+ * @import Container from "./../renderable/container.js";
+ * @import Renderable from "./../renderable/renderable.js";
+ * @import Sprite from "./../renderable/sprite.js";
+ * @import NineSliceSprite from "./../renderable/nineslicesprite.js";
+ * @import Polygon from "./../geometries/poly.js";
+ * @import Ellipse from "./../geometries/ellipse.js";
+ */
 
 /**
  * Constants for Vornoi regions
@@ -40392,6 +40708,15 @@ class ResponseObject {
     }
 }
 
+/**
+ * @import Entity from "./../renderable/entity/entity.js";
+ * @import Container from "./../renderable/container.js";
+ * @import Renderable from "./../renderable/renderable.js";
+ * @import Sprite from "./../renderable/sprite.js";
+ * @import NineSliceSprite from "./../renderable/nineslicesprite.js";
+ * @import Line from "./../geometries/line.js";
+ */
+
 // a dummy object when using Line for raycasting
 let dummyObj = {
     pos : new Vector2d(0, 0),
@@ -40597,6 +40922,10 @@ class Detector {
     }
 }
 
+/**
+ * @import Application from "./../application/application.js";
+ */
+
 /**
  * @classdesc
  * an object representing the physic world, and responsible for managing and updating all childs and physics
@@ -41365,6 +41694,10 @@ class ParticleEmitter extends Container {
     }
 }
 
+/**
+ * @import ParticleEmitter from "./emitter.js";
+ */
+
 /**
  * @classdesc
  * Single Particle Object.
@@ -41538,6 +41871,16 @@ class Particle extends Renderable {
     }
 }
 
+/**
+ * @import Line from "./../../geometries/line.js";
+ * @import Rect from "./../../geometries/rectangle.js";
+ * @import Ellipse from "./../../geometries/ellipse.js";
+ * @import Polygon from "./../../geometries/poly.js";
+ * @import Bounds from "./../../physics/bounds.js";
+ * @import CanvasRenderer from "./../../video/canvas/canvas_renderer.js";
+ * @import WebGLRenderer from "./../../video/webgl/webgl_renderer.js";
+ **/
+
 /**
  * @classdesc
  * a Generic Object Entity
@@ -41735,7 +42078,6 @@ class Entity extends Renderable {
 
     /**
      * draw this entity (automatically called by melonJS)
-     * @protected
      * @param {CanvasRenderer|WebGLRenderer} renderer - a renderer instance
      * @param {Camera2d} [viewport] - the viewport to (re)draw
      */
@@ -41794,6 +42136,11 @@ function autoDetectRenderer(options) {
     return new CanvasRenderer(options);
 }
 
+/**
+ * additional import for TypeScript
+ * @import Application from "./application.js";
+ */
+
 /**
  * scale the "displayed" canvas by the given scalar.
  * this will modify the size of canvas element directly.
@@ -41907,6 +42254,11 @@ function onresize(game) {
     scale(game, scaleX, scaleY);
 }
 
+/**
+ * additional import for TypeScript
+ * @import Application from "./application.js";
+ */
+
 /**
  * display information
  * @param {Application} app - the game application instance calling this function
@@ -41932,6 +42284,12 @@ function consoleHeader(app) {
     );
 }
 
+/**
+ * additional import for TypeScript
+ * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
+ * @import Camera2d from "./../camera/camera2d.js";
+ */
+
 /**
  * @classdesc
  * An Application represents a single melonJS game, and is responsible for updating (each frame) all the related object status and draw them.
@@ -42348,6 +42706,10 @@ class Application {
     }
 }
 
+/**
+ * @import Application from "./../application/application.js";
+ */
+
 /**
  * Contains all registered plugins.
  * @name cache
@@ -42376,9 +42738,9 @@ class BasePlugin {
          * define the minimum required version of melonJS<br>
          * this can be overridden by the plugin
          * @type {string}
-         * @default "17.3.0"
+         * @default "17.4.0"
          */
-        this.version = "17.3.0";
+        this.version = "17.4.0";
 
         /**
          * a reference to the app/game that registered this plugin
@@ -42449,7 +42811,7 @@ function patch(proto, name, fn) {
  * Register a plugin.
  * @name register
  * @memberof plugin
- * @param {plugin.BasePlugin} plugin - Plugin object to instantiate and register
+ * @param {BasePlugin} plugin - Plugin object to instantiate and register
  * @param {string} [name=plugin.constructor.name] - a unique name for this plugin
  * @param {...*} [args] - all extra parameters will be passed to the plugin constructor
  * @example
@@ -42706,7 +43068,7 @@ WebGLRenderer.prototype.setLineWidth = function(width)  {
  * @name version
  * @type {string}
  */
-const version = "17.3.0";
+const version = "17.4.0";
 
 /**
  * a flag indicating that melonJS is fully initialized