melonjs 14.1.1 → 14.2.0

package/README.md

@@ -3,7 +3,6 @@ melonJS 2
 ![melonJS Logo](https://github.com/melonjs/melonJS/raw/master/media/Banner/Banner%20-%20Billboard%20-%20Original%20Logo%20-%20horizontal.png)
 
 [![Build Status](https://travis-ci.org/melonjs/melonJS.svg)](https://travis-ci.org/melonjs/melonJS)
-[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/melonjs/melonJS.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/melonjs/melonJS/context:javascript)
 [![Build Size](https://badgen.net/bundlephobia/min/melonjs)](https://bundlephobia.com/result?p=melonjs)
 [![NPM Package](https://img.shields.io/npm/v/melonjs)](https://www.npmjs.com/package/melonjs)
 [![jsDeliver](https://data.jsdelivr.com/v1/package/npm/melonjs/badge?style=rounded)](https://www.jsdelivr.com/package/npm/melonjs)
@@ -107,7 +106,7 @@ A few demos of melonJS capabilities :
 * [Platformer Demo](https://melonjs.github.io/examples/platformer/)
 * [Isometric Demo](https://melonjs.github.io/examples/isometric_rpg/)
 * [Sprite Demo](https://melonjs.github.io/examples/sprite/)
-* [Masking Demo](https://melonjs.github.io/examples/masking/)
+* [Masking Demo](https://melonjs.github.io/examples/masking/) (WARNING: may potentially trigger seizures for people with photosensitive epilepsy)
 * [Primitive Drawing Demo](https://melonjs.github.io/examples/graphics/)
 * [UI Demo](https://melonjs.github.io/examples/UI/)
 
@@ -162,7 +161,7 @@ melonJS 2 now only provides an ES6 Bundle :
 | ------------------- | ----------- |
 | `melonjs.module.js` | the ES6 Module (ESM) Bundle |
 | `melonjs.mjs` | a tree-shakeable ES6 Module Directory |
-| `melonjs.module.d.ts` | typescript declaration file for the ES6 Module (ESM) Bundle |
+| `types/index.d.ts` | typescript declaration files for the ES6 Module (ESM) Bundle |
 
 >Note: if you need your application to be compatible with ES5, refer to our [boilerplate](https://github.com/melonjs/es6-boilerplate) that provides automatic transpiling to ES5.
 
@@ -178,10 +177,10 @@ Or can simply be added to your html, using [jsDeliver](https://www.jsdelivr.com/
 
 ```html
 <!-- load the ES6 module bundle of melonJS v10.0 -->
-<script src="https://esm.run/melonjs@10.0"></script>
+<script type="module" src="https://esm.run/melonjs@10.0"></script>
 <!-- omit the version completely to get the latest one -->
 <!-- you should NOT use this in production -->
-<script src="https://esm.run/melonjs"></script>
+<script type="module" src="https://esm.run/melonjs"></script>
 ```
 > Note: starting from the 10.0.0 version, the debug plugin is no longer provided as part of the melonJS library release, and has been moved to the official [boilerplate](https://github.com/melonjs/es6-boilerplate)
 
@@ -204,8 +203,13 @@ Then build the melonJS source by running:
 
 The generated files will be available under the `build` directory :
 - `melonjs.module.js` : plain ES6 module
-- `melonjs.module.js` : a ES6 chunk directory used for tree-shaking
-- `melonjs.module.d.ts` : typescript declaration for the ES6 Module
+- `melonjs.mjs` : a ES6 chunk directory used for tree-shaking
+
+If you need to create the corresponding typing you can use the follwing :
+
+    $ npm run types
+
+This will generate all the `.d.ts` file under the `dist/types` directory.
 
 To run the melonJS test suite simply use the following:
 

package/dist/melonjs.mjs/_virtual/_commonjsHelpers.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/_virtual/arraymultimap.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/_virtual/earcut.js

@@ -1,10 +1,14 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
  * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
  */
-var earcut = {exports: {}};
+var earcutExports = {};
+var earcut = {
+  get exports(){ return earcutExports; },
+  set exports(v){ earcutExports = v; },
+};
 
-export { earcut as e };
+export { earcut as __module, earcutExports as exports };

package/dist/melonjs.mjs/_virtual/howler.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/_virtual/index.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/_virtual/index2.js

@@ -1,10 +1,14 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
  * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
  */
-var eventemitter3 = {exports: {}};
+var eventemitter3Exports = {};
+var eventemitter3 = {
+  get exports(){ return eventemitter3Exports; },
+  set exports(v){ eventemitter3Exports = v; },
+};
 
-export { eventemitter3 as e };
+export { eventemitter3 as __module, eventemitter3Exports as exports };

package/dist/melonjs.mjs/_virtual/make-built-in.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var makeBuiltIn = {exports: {}};
+
+export { makeBuiltIn as m };

package/dist/melonjs.mjs/_virtual/multimap.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/_virtual/object-define-property.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var objectDefineProperty = {};
+
+export { objectDefineProperty as __exports };

package/dist/melonjs.mjs/_virtual/object-get-own-property-descriptor.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var objectGetOwnPropertyDescriptor = {};
+
+export { objectGetOwnPropertyDescriptor as __exports };

package/dist/melonjs.mjs/_virtual/object-get-own-property-names.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var objectGetOwnPropertyNames = {};
+
+export { objectGetOwnPropertyNames as __exports };

package/dist/melonjs.mjs/_virtual/object-get-own-property-symbols.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var objectGetOwnPropertySymbols = {};
+
+export { objectGetOwnPropertySymbols as __exports };

package/dist/melonjs.mjs/_virtual/object-property-is-enumerable.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var objectPropertyIsEnumerable = {};
+
+export { objectPropertyIsEnumerable as __exports };

package/dist/melonjs.mjs/_virtual/setmultimap.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/_virtual/shared.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+var shared = {exports: {}};
+
+export { shared as s };

package/dist/melonjs.mjs/application/application.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -19,9 +19,15 @@ import World from '../physics/world.js';
  */
  class Application {
     constructor() {
+
+        /**
+         * the parent HTML element holding the main canvas of this application
+         * @type {HTMLElement}
+         */
+        this.parentElement = undefined;
+
         /**
-         * a reference to the current active stage "default" camera
-         * @public
+         * the active stage "default" camera
          * @type {Camera2d}
          */
         this.viewport = undefined;
@@ -29,7 +35,6 @@ import World from '../physics/world.js';
         /**
          * a reference to the game world, <br>
          * a world is a virtual environment containing all the game objects
-         * @public
          * @type {World}
          */
         this.world = undefined;
@@ -37,7 +42,6 @@ import World from '../physics/world.js';
         /**
          * when true, all objects will be added under the root world container.<br>
          * When false, a `me.Container` object will be created for each corresponding groups
-         * @public
          * @type {boolean}
          * @default true
          */
@@ -46,7 +50,6 @@ import World from '../physics/world.js';
         /**
          * Specify the property to be used when sorting renderables.
          * Accepted values : "x", "y", "z"
-         * @public
          * @type {string}
          * @default "z"
          */
@@ -57,13 +60,17 @@ import World from '../physics/world.js';
          * Use this value to implement frame prediction in drawing events,
          * for creating smooth motion while running game update logic at
          * a lower fps.
-         * @public
          * @type {DOMHighResTimeStamp}
-         * @name lastUpdate
-         * @memberof Application
          */
         this.lastUpdate = 0;
 
+        /**
+         * true when this app instance has been initialized
+         * @type {boolean}
+         * @default false
+         */
+        this.isInitialized = false;
+
         // to know when we have to refresh the display
         this.isDirty = true;
 
@@ -96,6 +103,7 @@ import World from '../physics/world.js';
         // set the reference to this application instance
         this.world.app = this;
         this.lastUpdate = globalThis.performance.now();
+        this.isInitialized = true;
         emit(GAME_INIT, this);
     }
 
@@ -147,12 +155,11 @@ import World from '../physics/world.js';
     }
 
     /**
-     * Returns the parent container of the specified Child in the game world
-     * @param {Renderable} child
-     * @returns {Container}
+     * Returns the parent HTML Element holding the main canvas of this application
+     * @returns {HTMLElement}
      */
-    getParentContainer(child) {
-        return child.ancestor;
+    getParentElement() {
+        return this.parentElement;
     }
 
     /**

package/dist/melonjs.mjs/application/resize.js

@@ -0,0 +1,119 @@
+/*!
+ * melonJS Game Engine - v14.2.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ */
+import { getParentBounds, devicePixelRatio } from '../system/device.js';
+
+/**
+ * scale the "displayed" canvas by the given scalar.
+ * this will modify the size of canvas element directly.
+ * Only use this if you are not using the automatic scaling feature.
+ * @param {Application} game - the game application instance triggering the resize
+ * @param {number} x - x scaling multiplier
+ * @param {number} y - y scaling multiplier
+ */
+function scale(game, x, y) {
+    var renderer = game.renderer;
+    var canvas = renderer.getCanvas();
+    var context = renderer.getContext();
+    var settings = renderer.settings;
+    var pixelRatio = devicePixelRatio;
+
+    var w = settings.zoomX = canvas.width * x * pixelRatio;
+    var h = settings.zoomY = canvas.height * y * pixelRatio;
+
+    // update the global scale variable
+    renderer.scaleRatio.set(x * pixelRatio, y * pixelRatio);
+
+    // adjust CSS style based on device pixel ratio
+    canvas.style.width = (w / pixelRatio) + "px";
+    canvas.style.height = (h / pixelRatio) + "px";
+
+    // if anti-alias and blend mode were resetted (e.g. Canvas mode)
+    renderer.setAntiAlias(context, settings.antiAlias);
+    renderer.setBlendMode(settings.blendMode, context);
+
+    // force repaint
+    game.repaint();
+}
+
+/**
+ * callback for window resize event
+ * @param {Application} game - the game application instance triggering the resize
+ */
+function onresize(game) {
+    var renderer = game.renderer;
+    var settings = renderer.settings;
+    var scaleX = 1, scaleY = 1;
+
+    if (settings.autoScale) {
+
+        // set max the canvas max size if CSS values are defined
+        var canvasMaxWidth = Infinity;
+        var canvasMaxHeight = Infinity;
+
+        if (globalThis.getComputedStyle) {
+            var style = globalThis.getComputedStyle(renderer.getCanvas(), null);
+            canvasMaxWidth = parseInt(style.maxWidth, 10) || Infinity;
+            canvasMaxHeight = parseInt(style.maxHeight, 10) || Infinity;
+        }
+
+        // get the maximum canvas size within the parent div containing the canvas container
+        var nodeBounds = getParentBounds(game.getParentElement());
+
+        var _max_width = Math.min(canvasMaxWidth, nodeBounds.width);
+        var _max_height = Math.min(canvasMaxHeight, nodeBounds.height);
+
+        // calculate final canvas width & height
+        var screenRatio = _max_width / _max_height;
+
+        if ((settings.scaleMethod === "fill-min" && screenRatio > renderer.designRatio) ||
+            (settings.scaleMethod === "fill-max" && screenRatio < renderer.designRatio) ||
+            (settings.scaleMethod === "flex-width")
+        ) {
+            // resize the display canvas to fill the parent container
+            var sWidth = Math.min(canvasMaxWidth, settings.height * screenRatio);
+            scaleX = scaleY = _max_width / sWidth;
+            renderer.resize(Math.floor(sWidth), settings.height);
+        }
+        else if ((settings.scaleMethod === "fill-min" && screenRatio < renderer.designRatio) ||
+                 (settings.scaleMethod === "fill-max" && screenRatio > renderer.designRatio) ||
+                 (settings.scaleMethod === "flex-height")
+        ) {
+            // resize the display canvas to fill the parent container
+            var sHeight = Math.min(canvasMaxHeight, settings.width * (_max_height / _max_width));
+            scaleX = scaleY = _max_height / sHeight;
+            renderer.resize(settings.width, Math.floor(sHeight));
+        }
+        else if (settings.scaleMethod === "flex") {
+            // resize the display canvas to fill the parent container
+            renderer.resize(Math.floor(_max_width), Math.floor(_max_height));
+        }
+        else if (settings.scaleMethod === "stretch") {
+            // scale the display canvas to fit with the parent container
+            scaleX = _max_width / settings.width;
+            scaleY = _max_height / settings.height;
+        }
+        else {
+            // scale the display canvas to fit the parent container
+            // make sure we maintain the original aspect ratio
+            if (screenRatio < renderer.designRatio) {
+                scaleX = scaleY = _max_width / settings.width;
+            }
+            else {
+                scaleX = scaleY = _max_height / settings.height;
+            }
+        }
+
+        // adjust scaling ratio based on the new scaling ratio
+        scale(game, scaleX, scaleY);
+    } else {
+        // adjust scaling ratio based on the given settings
+        scale(game, settings.scale, settings.scale);
+    }
+}
+
+export { onresize };

package/dist/melonjs.mjs/audio/audio.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/camera/camera2d.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/entity/entity.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/game.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/geometries/ellipse.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/geometries/line.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/geometries/path2d.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -8,7 +8,7 @@
 import pool from '../system/pooling.js';
 import { TAU } from '../math/math.js';
 import '../node_modules/earcut/src/earcut.js';
-import { e as earcut } from '../_virtual/earcut.js';
+import { exports as earcutExports } from '../_virtual/earcut.js';
 
 /**
  * @classdesc
@@ -76,7 +76,7 @@ import { e as earcut } from '../_virtual/earcut.js';
         var i = 0;
         var points = this.points;
         var vertices = this.vertices;
-        var indices = earcut.exports(points.flatMap(p => [p.x, p.y]));
+        var indices = earcutExports(points.flatMap(p => [p.x, p.y]));
 
         // calculate all vertices
         for (i = 0; i < indices.length; i++ ) {

package/dist/melonjs.mjs/geometries/point.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/geometries/poly.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -8,7 +8,7 @@
 import '../node_modules/earcut/src/earcut.js';
 import Vector2d from '../math/vector2.js';
 import pool from '../system/pooling.js';
-import { e as earcut } from '../_virtual/earcut.js';
+import { exports as earcutExports } from '../_virtual/earcut.js';
 
 /**
  * @classdesc
@@ -284,7 +284,7 @@ import { e as earcut } from '../_virtual/earcut.js';
      */
     getIndices() {
         if (this.indices.length === 0) {
-            this.indices = earcut.exports(this.points.flatMap(p => [p.x, p.y]));
+            this.indices = earcutExports(this.points.flatMap(p => [p.x, p.y]));
         }
         return this.indices;
     }

package/dist/melonjs.mjs/geometries/rectangle.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license

package/dist/melonjs.mjs/geometries/roundrect.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.1.1
+ * melonJS Game Engine - v14.2.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license