melonjs 10.5.2 → 10.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melonjs",
-  "version": "10.5.2",
+  "version": "10.7.0",
   "description": "melonJS Game Engine",
   "homepage": "http://www.melonjs.org/",
   "keywords": [
@@ -38,7 +38,8 @@
   "engines": {
     "node": ">= 12"
   },
-  "main": "dist/melonjs.js",
+  "main": "dist/melonjs.module.js",
+  "type": "module",
   "module": "dist/melonjs.module.js",
   "files": [
     "dist/melonjs.js",
@@ -54,41 +55,42 @@
   ],
   "dependencies": {
     "@teppeis/multimaps": "^2.0.0",
+    "core-js": "^3.22.4",
     "earcut": "2.2.3",
     "eventemitter3": "^4.0.7",
     "howler": "2.2.3"
   },
   "devDependencies": {
     "@rollup/plugin-buble": "^0.21.3",
-    "@rollup/plugin-commonjs": "^21.0.2",
-    "@rollup/plugin-node-resolve": "^13.1.3",
+    "@rollup/plugin-commonjs": "^22.0.0",
+    "@rollup/plugin-node-resolve": "^13.3.0",
     "@rollup/plugin-replace": "^4.0.0",
     "@types/offscreencanvas": "^2019.6.4",
     "cheerio": "^1.0.0-rc.10",
     "del-cli": "^4.0.1",
-    "eslint": "^8.11.0",
-    "eslint-plugin-jsdoc": "^38.0.4",
-    "jasmine-core": "^4.0.1",
+    "eslint": "^8.14.0",
+    "eslint-plugin-jsdoc": "^39.2.9",
+    "jasmine-core": "^4.1.0",
     "jsdoc": "^3.6.10",
-    "karma": "^6.3.17",
+    "karma": "^6.3.19",
     "karma-chrome-launcher": "^3.1.1",
     "karma-coverage": "^2.2.0",
     "karma-html-detailed-reporter": "^2.1.0",
-    "karma-jasmine": "^4.0.1",
+    "karma-jasmine": "^5.0.0",
     "karma-nyan-reporter": "0.2.5",
     "qs": "^6.10.3",
-    "rollup": "^2.70.1",
+    "rollup": "^2.71.1",
     "rollup-plugin-bundle-size": "^1.0.3",
     "rollup-plugin-string": "^3.0.0",
-    "terser": "^5.12.1",
-    "typescript": "^4.6.2"
+    "terser": "^5.13.1",
+    "typescript": "^4.6.4"
   },
   "scripts": {
     "build": "npm run lint && rollup -c --silent",
     "dist": " npm run build && npm run minify && mkdirp dist && cp -f build/*.js dist/ && npm run types",
     "minify": "terser build/melonjs.js --compress --mangle --comments  '/(?:^!|@(?:license|preserve|cc_on))/' --output build/melonjs.min.js",
     "lint": "eslint src rollup.config.js",
-    "test": "npm run build && karma start tests/karma.conf.js",
+    "test": "npm run build && karma start tests/karma.conf.cjs",
     "doc": "mkdirp docs && jsdoc -c jsdoc_conf.json",
     "release": "npm run dist && npm publish --access public",
     "clean": "del-cli --force build/*.js dist/*.js dist/*.d.ts docs src/**/*.d.ts",

package/src/camera/camera2d.js

@@ -7,7 +7,7 @@ import Matrix3d from "./../math/matrix3.js";
 import Rect from "./../geometries/rectangle.js";
 import { renderer } from "./../video/video.js";
 import * as event from "./../system/event.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 import Renderable from "./../renderable/renderable.js";
 import {clamp, toBeCloseTo} from "./../math/math.js";
 import { world } from "./../game.js";
@@ -408,7 +408,7 @@ class Camera2d extends Renderable {
 
         //publish the VIEWPORT_ONCHANGE event if necessary
         if (_x !== this.pos.x || _y !== this.pos.y) {
-            event.emit(event.VIEWPORT_ONCHANGE, this.pos);
+            this.isDirty = true;
         }
     }
 
@@ -447,22 +447,22 @@ class Camera2d extends Renderable {
                     if (toBeCloseTo(targetV.x, this.pos.x, 2) &&
                         toBeCloseTo(targetV.y, this.pos.y, 2)) {
                         this.pos.setV(targetV);
-                        return false;
+                        return;
                     } else {
                         this.pos.lerp(targetV, this.damping);
                     }
                 } else {
                     this.pos.setV(targetV);
                 }
-                return true;
+                this.isDirty = true;
             }
         }
-        return false;
     }
 
     /** @ignore */
     update(dt) {
-        var updated = this.updateTarget(dt);
+        // update the camera position
+        this.updateTarget(dt);
 
         if (this._shake.duration > 0) {
             this._shake.duration -= dt;
@@ -484,17 +484,17 @@ class Camera2d extends Renderable {
                 }
             }
             // updated!
-            updated = true;
+            this.isDirty = true;
         }
 
-        if (updated === true) {
+        if (this.isDirty === true) {
             //publish the corresponding message
             event.emit(event.VIEWPORT_ONCHANGE, this.pos);
         }
 
         // check for fade/flash effect
         if ((this._fadeIn.tween != null) || (this._fadeOut.tween != null)) {
-            updated = true;
+            this.isDirty = true;
         }
 
         if (!this.currentTransform.isIdentity()) {
@@ -503,7 +503,8 @@ class Camera2d extends Renderable {
             // reset to default
             this.invCurrentTransform.identity();
         }
-        return updated;
+
+        return super.update(dt);
     }
 
     /**

package/src/game.js

@@ -94,7 +94,7 @@ export let sortOn = "z";
  * @name lastUpdate
  * @memberof game
  */
-export let lastUpdate = window.performance.now();
+export let lastUpdate = globalThis.performance.now();
 
 /**
  * Fired when a level is fully loaded and all entities instantiated. <br>
@@ -188,7 +188,7 @@ export function update(time, stage) {
         accumulatorUpdateDelta = (timer.interpolation) ? updateDelta : Math.max(updateDelta, updateAverageDelta);
 
         while (accumulator >= accumulatorUpdateDelta || timer.interpolation) {
-            lastUpdateStart = window.performance.now();
+            lastUpdateStart = globalThis.performance.now();
 
             // game update event
             if (state.isPaused() !== true) {
@@ -198,7 +198,7 @@ export function update(time, stage) {
             // update all objects (and pass the elapsed time since last frame)
             isDirty = stage.update(updateDelta) || isDirty;
 
-            lastUpdate = window.performance.now();
+            lastUpdate = globalThis.performance.now();
             updateAverageDelta = lastUpdate - lastUpdateStart;
 
             accumulator -= accumulatorUpdateDelta;
@@ -223,7 +223,7 @@ export function draw(stage) {
 
     if (renderer.isContextValid === true && (isDirty || isAlwaysDirty)) {
         // publish notification
-        event.emit(event.GAME_BEFORE_DRAW, window.performance.now());
+        event.emit(event.GAME_BEFORE_DRAW, globalThis.performance.now());
 
         // prepare renderer to draw a new frame
         renderer.clear();
@@ -238,6 +238,6 @@ export function draw(stage) {
         renderer.flush();
 
         // publish notification
-        event.emit(event.GAME_AFTER_DRAW, window.performance.now());
+        event.emit(event.GAME_AFTER_DRAW, globalThis.performance.now());
     }
 };

package/src/geometries/ellipse.js

@@ -1,5 +1,5 @@
 import Vector2d from "./../math/vector2.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 
 /**
  * @classdesc

package/src/geometries/poly.js

@@ -1,6 +1,6 @@
 import earcut from "earcut";
 import Vector2d from "./../math/vector2.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 
 /**
  * @classdesc

package/src/geometries/rectangle.js

@@ -172,6 +172,21 @@ class Rect extends Polygon {
         this.pos.y = value - (this.height / 2);
     }
 
+    /**
+     * center the rectangle position around the given coordinates
+     * @name centerOn
+     * @memberof Rect.prototype
+     * @function
+     * @param {number} x the x coordinate around which to center this rectangle
+     * @param {number} x the y coordinate around which to center this rectangle
+     * @returns {Rect} this rectangle
+     */
+    centerOn(x, y) {
+        this.centerX = x;
+        this.centerY = y;
+        return this;
+    }
+
     /**
      * resize the rectangle
      * @name resize

package/src/index.js

@@ -1,6 +1,5 @@
-// ES5 polyfills
-import "./polyfill/console.js";
-import "./polyfill/requestAnimationFrame.js";
+// ES5/ES6 polyfills
+import "./polyfill/index.js";
 
 // utility classes
 import * as audio from "./audio/audio.js";
@@ -16,7 +15,7 @@ import { plugin, plugins } from "./plugin/plugin.js";
 import * as video from "./video/video.js";
 import save from "./system/save.js";
 import timer from "./system/timer.js";
-import pool from "./system/pooling.js";
+import * as pool from "./system/pooling.js";
 import state from "./state/state.js";
 import level from "./level/level.js";
 
@@ -69,7 +68,8 @@ import Stage from "./state/stage.js";
 import Camera2d from "./camera/camera2d.js";
 import Container from "./renderable/container.js";
 import World from "./physics/world.js";
-import { ParticleEmitterSettings, ParticleEmitter } from "./particles/emitter.js";
+import ParticleEmitterSettings from "./particles/settings.js";
+import ParticleEmitter from "./particles/emitter.js";
 import Particle from "./particles/particle.js";
 import Entity from "./entity/entity.js";
 

package/src/input/gamepad.js

@@ -265,17 +265,19 @@ var updateGamepads = function () {
  * gamepad connected callback
  * @ignore
  */
-window.addEventListener("gamepadconnected", function (e) {
-    event.emit(event.GAMEPAD_CONNECTED, e.gamepad);
-}, false);
+if (globalThis.navigator && typeof globalThis.navigator.getGamepads === "function") {
+    globalThis.addEventListener("gamepadconnected", function (e) {
+        event.emit(event.GAMEPAD_CONNECTED, e.gamepad);
+    }, false);
 
-/**
- * gamepad disconnected callback
- * @ignore
- */
-window.addEventListener("gamepaddisconnected", function (e) {
-    event.emit(event.GAMEPAD_DISCONNECTED, e.gamepad);
-}, false);
+    /**
+     * gamepad disconnected callback
+     * @ignore
+     */
+    globalThis.addEventListener("gamepaddisconnected", function (e) {
+        event.emit(event.GAMEPAD_DISCONNECTED, e.gamepad);
+    }, false);
+}
 
 /*
  * PUBLIC STUFF

package/src/input/keyboard.js

@@ -319,9 +319,11 @@ export var KEY = {
 export function initKeyboardEvent() {
     // make sure the keyboard is enable
     if (keyBoardEventTarget === null && device.isMobile === false) {
-        keyBoardEventTarget = window;
-        keyBoardEventTarget.addEventListener("keydown", keyDownEvent, false);
-        keyBoardEventTarget.addEventListener("keyup", keyUpEvent, false);
+        keyBoardEventTarget = globalThis;
+        if (typeof keyBoardEventTarget.addEventListener === "function") {
+            keyBoardEventTarget.addEventListener("keydown", keyDownEvent, false);
+            keyBoardEventTarget.addEventListener("keyup", keyUpEvent, false);
+        }
     }
 };
 

package/src/input/pointer.js

@@ -334,7 +334,7 @@ class Pointer extends Bounds {
         this.gameScreenY = this.y = tmpVec.y;
 
         // true if not originally a pointer event
-        this.isNormalized = !device.PointerEvent || (device.PointerEvent && !(event instanceof window.PointerEvent));
+        this.isNormalized = !device.PointerEvent || (device.PointerEvent && !(event instanceof globalThis.PointerEvent));
 
         this.locked = locked;
         this.movementX = event.movementX || 0;

package/src/input/pointerevent.js

@@ -5,7 +5,7 @@ import { throttle } from "./../utils/function.js";
 import { remove } from "./../utils/array.js";
 import * as event from "./../system/event.js";
 import timer from "./../system/timer.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 import device from "./../system/device.js";
 import Pointer from "./pointer.js";
 import Rect from "./../geometries/rectangle.js";
@@ -559,8 +559,8 @@ export function globalToLocal(x, y, v) {
     v = v || pool.pull("Vector2d");
     var rect = device.getElementBounds(renderer.getScreenCanvas());
     var pixelRatio = device.devicePixelRatio;
-    x -= rect.left + (window.pageXOffset || 0);
-    y -= rect.top + (window.pageYOffset || 0);
+    x -= rect.left + (globalThis.pageXOffset || 0);
+    y -= rect.top + (globalThis.pageYOffset || 0);
     var scale = scaleRatio;
     if (scale.x !== 1.0 || scale.y !== 1.0) {
         x /= scale.x;
@@ -783,7 +783,6 @@ export function releaseAllPointerEvents(region) {
  * @memberof input
  * @public
  * @function
- * @param {Function} [success] callback if the request is successful
  * @returns {boolean} return true if the request was successfully submitted
  * @example
  * // register on the pointer lock change event

package/src/level/tiled/TMXLayer.js

@@ -1,5 +1,5 @@
 import { createCanvas } from "./../../video/video.js";
-import pool from "./../../system/pooling.js";
+import * as pool from "./../../system/pooling.js";
 import * as TMXUtils from "./TMXUtils.js";
 import Tile from "./TMXTile.js";
 import Renderable from "./../../renderable/renderable.js";

package/src/level/tiled/TMXTileMap.js

@@ -1,4 +1,4 @@
-import pool from "./../../system/pooling.js";
+import * as pool from "./../../system/pooling.js";
 import * as event from "./../../system/event.js";
 import { viewport } from "./../../game.js";
 import collision from "./../../physics/collision.js";

package/src/level/tiled/TMXUtils.js

@@ -138,7 +138,7 @@ export function decodeBase64AsArray(input, bytes) {
     bytes = bytes || 1;
 
     var i, j, len;
-    var dec = window.atob(input.replace(/[^A-Za-z0-9\+\/\=]/g, ""));
+    var dec = globalThis.atob(input.replace(/[^A-Za-z0-9\+\/\=]/g, ""));
     var ar = new Uint32Array(dec.length / bytes);
 
     for (i = 0, len = dec.length / bytes; i < len; i++) {

package/src/level/tiled/renderer/TMXHexagonalRenderer.js

@@ -1,5 +1,5 @@
 import Vector2d from "./../../../math/vector2.js";
-import pool from "./../../../system/pooling.js";
+import * as pool from "./../../../system/pooling.js";
 import TMXRenderer from "./TMXRenderer.js";
 import TMXLayer from "./../TMXLayer.js";
 

package/src/level/tiled/renderer/TMXIsometricRenderer.js

@@ -1,5 +1,5 @@
 import Vector2d from "./../../../math/vector2.js";
-import pool from "./../../../system/pooling.js";
+import * as pool from "./../../../system/pooling.js";
 import TMXRenderer from "./TMXRenderer.js";
 import TMXLayer from "./../TMXLayer.js";
 

package/src/level/tiled/renderer/TMXOrthogonalRenderer.js

@@ -1,5 +1,5 @@
 import Vector2d from "./../../../math/vector2.js";
-import pool from "./../../../system/pooling.js";
+import * as pool from "./../../../system/pooling.js";
 import TMXRenderer from "./TMXRenderer.js";
 
 /**

package/src/level/tiled/renderer/TMXRenderer.js

@@ -1,6 +1,6 @@
 /* eslint-disable no-unused-vars */
 
-import pool from "./../../../system/pooling.js";
+import * as pool from "./../../../system/pooling.js";
 import TMXLayer from "./../TMXLayer.js";
 import Bounds from "./../../../physics/Bounds.js";
 

package/src/level/tiled/renderer/TMXStaggeredRenderer.js

@@ -1,5 +1,5 @@
 import Vector2d from "./../../../math/vector2.js";
-import pool from "./../../../system/pooling.js";
+import * as pool from "./../../../system/pooling.js";
 import TMXHexagonalRenderer from "./TMXHexagonalRenderer.js";
 import { degToRad } from "./../../../math/math.js";
 

package/src/loader/loader.js

@@ -154,7 +154,7 @@ function preloadTMX(tmxData, onload, onerror) {
                     case "tsx":
                         // ie9 does not fully implement the responseXML
                         if (device.ua.match(/msie/i) || !xmlhttp.responseXML) {
-                            if (window.DOMParser) {
+                            if (globalThis.DOMParser) {
                                 // manually create the XML DOM
                                 result = (new DOMParser()).parseFromString(xmlhttp.responseText, "text/xml");
                             } else {

package/src/loader/loadingscreen.js

@@ -2,7 +2,7 @@ import { world, viewport } from "./../game.js";
 import { createCanvas, renderer } from "./../video/video.js";
 import * as event from "./../system/event.js";
 import {nextPowerOfTwo} from "./../math/math.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 import Renderable from "./../renderable/renderable.js";
 import Stage from "./../state/stage.js";
 

package/src/math/color.js

@@ -1,5 +1,5 @@
 import { clamp, random } from "./math.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 
 // convert a give color component to it hexadecimal value
 var toHex = function (component) {

package/src/math/matrix2.js

@@ -1,4 +1,4 @@
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 import Matrix3d from "./matrix3.js";
 
 /**
@@ -9,7 +9,7 @@ import Matrix3d from "./matrix3.js";
  */
 class Matrix2d {
     /**
-     * @param {(Matrix2d|Matrix3d|...number)} args an instance of me.Matrix2d or me.Matrix3d to copy from, or individual matrix components (See {@link Matrix2d.setTransform}). If not arguments are given, the matrix will be set to Identity. 
+     * @param {(Matrix2d|Matrix3d|...number)} args an instance of me.Matrix2d or me.Matrix3d to copy from, or individual matrix components (See {@link Matrix2d.setTransform}). If not arguments are given, the matrix will be set to Identity.
      */
     constructor(...args) {
         this.onResetEvent(...args);

package/src/math/matrix3.js

@@ -1,4 +1,4 @@
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 import { EPSILON } from "./math.js";
 
 /**
@@ -475,72 +475,73 @@ class Matrix3d {
      * @returns {Matrix3d} Reference to this object for method chaining
      */
     rotate(angle, v) {
-        var a = this.val,
-            x = v.x,
-            y = v.y,
-            z = v.z;
-
-        var len = Math.sqrt(x * x + y * y + z * z);
-
-        var s, c, t;
-        var a00, a01, a02, a03;
-        var a10, a11, a12, a13;
-        var a20, a21, a22, a23;
-        var b00, b01, b02;
-        var b10, b11, b12;
-        var b20, b21, b22;
-
-        if (len < EPSILON) {
-            return null;
-        }
-
-        len = 1 / len;
-        x *= len;
-        y *= len;
-        z *= len;
-
-        s = Math.sin(angle);
-        c = Math.cos(angle);
-        t = 1 - c;
-
-        a00 = a[0];
-        a01 = a[1];
-        a02 = a[2];
-        a03 = a[3];
-        a10 = a[4];
-        a11 = a[5];
-        a12 = a[6];
-        a13 = a[7];
-        a20 = a[8];
-        a21 = a[9];
-        a22 = a[10];
-        a23 = a[11];
-
-        // Construct the elements of the rotation matrix
-        b00 = x * x * t + c;
-        b01 = y * x * t + z * s;
-        b02 = z * x * t - y * s;
-        b10 = x * y * t - z * s;
-        b11 = y * y * t + c;
-        b12 = z * y * t + x * s;
-        b20 = x * z * t + y * s;
-        b21 = y * z * t - x * s;
-        b22 = z * z * t + c;
-
-        // Perform rotation-specific matrix multiplication
-        a[0] = a00 * b00 + a10 * b01 + a20 * b02;
-        a[1] = a01 * b00 + a11 * b01 + a21 * b02;
-        a[2] = a02 * b00 + a12 * b01 + a22 * b02;
-        a[3] = a03 * b00 + a13 * b01 + a23 * b02;
-        a[4] = a00 * b10 + a10 * b11 + a20 * b12;
-        a[5] = a01 * b10 + a11 * b11 + a21 * b12;
-        a[6] = a02 * b10 + a12 * b11 + a22 * b12;
-        a[7] = a03 * b10 + a13 * b11 + a23 * b12;
-        a[8] = a00 * b20 + a10 * b21 + a20 * b22;
-        a[9] = a01 * b20 + a11 * b21 + a21 * b22;
-        a[10] = a02 * b20 + a12 * b21 + a22 * b22;
-        a[11] = a03 * b20 + a13 * b21 + a23 * b22;
+        if (angle !== 0) {
+            var a = this.val,
+                x = v.x,
+                y = v.y,
+                z = v.z;
+
+            var len = Math.sqrt(x * x + y * y + z * z);
+
+            var s, c, t;
+            var a00, a01, a02, a03;
+            var a10, a11, a12, a13;
+            var a20, a21, a22, a23;
+            var b00, b01, b02;
+            var b10, b11, b12;
+            var b20, b21, b22;
+
+            if (len < EPSILON) {
+                return null;
+            }
+
+            len = 1 / len;
+            x *= len;
+            y *= len;
+            z *= len;
+
+            s = Math.sin(angle);
+            c = Math.cos(angle);
+            t = 1 - c;
+
+            a00 = a[0];
+            a01 = a[1];
+            a02 = a[2];
+            a03 = a[3];
+            a10 = a[4];
+            a11 = a[5];
+            a12 = a[6];
+            a13 = a[7];
+            a20 = a[8];
+            a21 = a[9];
+            a22 = a[10];
+            a23 = a[11];
 
+            // Construct the elements of the rotation matrix
+            b00 = x * x * t + c;
+            b01 = y * x * t + z * s;
+            b02 = z * x * t - y * s;
+            b10 = x * y * t - z * s;
+            b11 = y * y * t + c;
+            b12 = z * y * t + x * s;
+            b20 = x * z * t + y * s;
+            b21 = y * z * t - x * s;
+            b22 = z * z * t + c;
+
+            // Perform rotation-specific matrix multiplication
+            a[0] = a00 * b00 + a10 * b01 + a20 * b02;
+            a[1] = a01 * b00 + a11 * b01 + a21 * b02;
+            a[2] = a02 * b00 + a12 * b01 + a22 * b02;
+            a[3] = a03 * b00 + a13 * b01 + a23 * b02;
+            a[4] = a00 * b10 + a10 * b11 + a20 * b12;
+            a[5] = a01 * b10 + a11 * b11 + a21 * b12;
+            a[6] = a02 * b10 + a12 * b11 + a22 * b12;
+            a[7] = a03 * b10 + a13 * b11 + a23 * b12;
+            a[8] = a00 * b20 + a10 * b21 + a20 * b22;
+            a[9] = a01 * b20 + a11 * b21 + a21 * b22;
+            a[10] = a02 * b20 + a12 * b21 + a22 * b22;
+            a[11] = a03 * b20 + a13 * b21 + a23 * b22;
+        }
         return this;
     }
 

package/src/math/observable_vector2.js

@@ -1,4 +1,4 @@
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 import Vector2d from "./vector2.js";
 import {clamp} from "./math.js";
 

package/src/math/observable_vector3.js

@@ -1,6 +1,6 @@
 import Vector3d from "./vector3.js";
 import {clamp} from "./math.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 
 /**
  * @classdesc

package/src/math/vector2.js

@@ -1,5 +1,5 @@
 import {clamp} from "./math.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 
 /**
  * @classdesc

package/src/math/vector3.js

@@ -1,5 +1,5 @@
 import {clamp} from "./math.js";
-import pool from "./../system/pooling.js";
+import * as pool from "./../system/pooling.js";
 
 /**
  * @classdesc