melonjs 14.4.0 → 14.5.0

package/dist/melonjs.mjs/loader/loadingscreen.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -11,7 +11,7 @@ import { on, LOADER_PROGRESS, VIEWPORT_ONRESIZE, off } from '../system/event.js'
 import Sprite from '../renderable/sprite.js';
 import Renderable from '../renderable/renderable.js';
 import Stage from '../state/stage.js';
-import loader from './loader.js';
+import { load, unload } from './loader.js';
 import logo_url from './melonjs_logo.png.js';
 
 // a basic progress bar object
@@ -92,7 +92,7 @@ class DefaultLoadingScreen extends Stage {
         ), 1);
 
         // load the melonJS logo
-        loader.load({name: "melonjs_logo", type: "image", src: logo_url}, () => {
+        load({name: "melonjs_logo", type: "image", src: logo_url}, () => {
             // melonJS logo
             game.world.addChild(new Sprite(
                 renderer.getWidth() / 2,
@@ -111,7 +111,7 @@ class DefaultLoadingScreen extends Stage {
      */
     onDestroyEvent() {
         // cancel the callback
-        loader.unload({name: "melonjs_logo", type:"image"});
+        unload({name: "melonjs_logo", type:"image"});
     }
 }
 

package/dist/melonjs.mjs/loader/melonjs_logo.png.js

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

package/dist/melonjs.mjs/loader/parser.js

@@ -0,0 +1,281 @@
+/*!
+ * melonJS Game Engine - v14.5.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
+ */
+import { getExtension } from '../utils/file.js';
+import { ua } from '../system/platform.js';
+import level from '../level/level.js';
+import { parse } from '../level/tiled/TMXUtils.js';
+import { isDataUrl } from '../utils/string.js';
+import { imgList, jsonList, binList, tmxList } from './cache.js';
+import { nocache, withCredentials } from './settings.js';
+
+/**
+ * load Images
+ * @example
+ * preloadImages([
+ *     { name : 'image1', src : 'images/image1.png'},
+ *     { name : 'image2', src : 'images/image2.png'},
+ *     { name : 'image3', src : 'images/image3.png'},
+ *     { name : 'image4', src : 'images/image4.png'}
+ * ]);
+ * @ignore
+ */
+function preloadImage(img, onload, onerror) {
+    // create new Image object and add to list
+    imgList[img.name] = new Image();
+    if (typeof onload === "function") {
+        imgList[img.name].onload = onload;
+    }
+    if (typeof onerror === "function") {
+        imgList[img.name].onerror = onerror;
+    }
+    imgList[img.name].src = img.src + nocache;
+}
+
+/**
+ * load a font face
+ * @example
+ * preloadFontFace(
+ *     name: "'kenpixel'", type: "fontface",  src: "url('data/font/kenvector_future.woff2')"
+ * ]);
+ * @ignore
+ */
+function preloadFontFace(data, onload, onerror) {
+
+    if (isDataUrl(data.src) === true) {
+        // make sure it in the `url(data:[<mediatype>][;base64],<data>)` format as expected by FontFace
+        if (!data.src.startsWith("url(")) {
+            data.src = "url(" + data.src + ")";
+        }
+    }
+
+    var font = new FontFace(data.name, data.src);
+
+    // loading promise
+    font.load().then(() => {
+        // apply the font after the font has finished downloading
+        document.fonts.add(font);
+        document.body.style.fontFamily = data.name;
+        if (typeof onload === "function") {
+            // onloaded callback
+            onload();
+        }
+    }, () => {
+        if (typeof onerror === "function") {
+            // rejected
+            onerror(data.name);
+        }
+    });
+}
+
+/**
+ * preload TMX files
+ * @ignore
+ */
+function preloadTMX(tmxData, onload, onerror) {
+    /**
+     * @ignore
+     */
+    function addToTMXList(data) {
+        // set the TMX content
+        tmxList[tmxData.name] = data;
+
+        // add the tmx to the level manager
+        if (tmxData.type === "tmx") {
+            level.add(tmxData.type, tmxData.name);
+        }
+    }
+
+
+    //if the data is in the tmxData object, don't get it via a XMLHTTPRequest
+    if (tmxData.data) {
+        addToTMXList(tmxData.data);
+        if (typeof onload === "function") {
+            onload();
+        }
+        return;
+    }
+
+    var xmlhttp = new XMLHttpRequest();
+    // check the data format ('tmx', 'json')
+    var format = getExtension(tmxData.src);
+
+    if (xmlhttp.overrideMimeType) {
+        if (format === "json") {
+            xmlhttp.overrideMimeType("application/json");
+        }
+        else {
+            xmlhttp.overrideMimeType("text/xml");
+        }
+    }
+
+    xmlhttp.open("GET", tmxData.src + nocache, true);
+    xmlhttp.withCredentials = withCredentials;
+    // set the callbacks
+    xmlhttp.ontimeout = onerror;
+    xmlhttp.onreadystatechange = function () {
+        if (xmlhttp.readyState === 4) {
+            // status = 0 when file protocol is used, or cross-domain origin,
+            // (With Chrome use "--allow-file-access-from-files --disable-web-security")
+            if ((xmlhttp.status === 200) || ((xmlhttp.status === 0) && xmlhttp.responseText)) {
+                var result = null;
+
+                // parse response
+                switch (format) {
+                    case "xml":
+                    case "tmx":
+                    case "tsx":
+                        // ie9 does not fully implement the responseXML
+                        if (ua.match(/msie/i) || !xmlhttp.responseXML) {
+                            if (globalThis.DOMParser) {
+                                // manually create the XML DOM
+                                result = (new DOMParser()).parseFromString(xmlhttp.responseText, "text/xml");
+                            } else {
+                                throw new Error("XML file format loading not supported, use the JSON file format instead");
+                            }
+                        }
+                        else {
+                            result = xmlhttp.responseXML;
+                        }
+                        // converts to a JS object
+                        var data = parse(result);
+                        switch (format) {
+                            case "tmx":
+                                result = data.map;
+                                break;
+
+                            case "tsx":
+                                result = data.tilesets[0];
+                                break;
+                        }
+
+                        break;
+
+                    case "json":
+                    case "tmj":
+                    case "tsj":
+                        result = JSON.parse(xmlhttp.responseText);
+                        break;
+
+                    default:
+                        throw new Error("TMX file format " + format + " not supported !");
+                }
+
+                //set the TMX content
+                addToTMXList(result);
+
+                // fire the callback
+                if (typeof onload === "function") {
+                    onload();
+                }
+            }
+            else if (typeof onerror === "function") {
+                onerror(tmxData.name);
+            }
+        }
+    };
+    // send the request
+    xmlhttp.send();
+}
+
+/**
+ * preload JSON files
+ * @ignore
+ */
+function preloadJSON(data, onload, onerror) {
+    var xmlhttp = new XMLHttpRequest();
+
+    if (xmlhttp.overrideMimeType) {
+        xmlhttp.overrideMimeType("application/json");
+    }
+
+    xmlhttp.open("GET", data.src + nocache, true);
+    xmlhttp.withCredentials = withCredentials;
+
+    // set the callbacks
+    xmlhttp.ontimeout = onerror;
+    xmlhttp.onreadystatechange = function () {
+        if (xmlhttp.readyState === 4) {
+            // status = 0 when file protocol is used, or cross-domain origin,
+            // (With Chrome use "--allow-file-access-from-files --disable-web-security")
+            if ((xmlhttp.status === 200) || ((xmlhttp.status === 0) && xmlhttp.responseText)) {
+                // get the Texture Packer Atlas content
+                jsonList[data.name] = JSON.parse(xmlhttp.responseText);
+                if (typeof onload === "function") {
+                    // fire the callback
+                    onload();
+                }
+            }
+            else if (typeof onerror === "function") {
+                onerror(data.name);
+            }
+        }
+    };
+    // send the request
+    xmlhttp.send();
+}
+
+/**
+ * preload Binary files
+ * @ignore
+ */
+function preloadBinary(data, onload, onerror) {
+    var httpReq = new XMLHttpRequest();
+
+    // load our file
+    httpReq.open("GET", data.src + nocache, true);
+    httpReq.withCredentials = withCredentials;
+    httpReq.responseType = "arraybuffer";
+    httpReq.onerror = onerror;
+    httpReq.onload = function () {
+        var arrayBuffer = httpReq.response;
+        if (arrayBuffer) {
+            var byteArray = new Uint8Array(arrayBuffer);
+            var buffer = [];
+            for (var i = 0; i < byteArray.byteLength; i++) {
+                buffer[i] = String.fromCharCode(byteArray[i]);
+            }
+            binList[data.name] = buffer.join("");
+            if (typeof onload === "function") {
+                // callback
+                onload();
+            }
+
+        }
+    };
+    httpReq.send();
+}
+
+/**
+ * preload Binary files
+ * @ignore
+ */
+function preloadJavascript(data, onload, onerror) {
+    var script = document.createElement("script");
+
+    script.src = data.src;
+    script.type = "text/javascript";
+    script.defer = true;
+
+    if (typeof onload === "function") {
+        script.onload = () => {
+            // callback
+            onload();
+        };
+    }
+
+    if (typeof onerror === "function") {
+        script.onerror = () => {
+            // callback
+            onerror(data.name);
+        };
+    }
+
+    document.getElementsByTagName("body")[0].appendChild(script);
+}
+
+export { preloadBinary, preloadFontFace, preloadImage, preloadJSON, preloadJavascript, preloadTMX };

package/dist/melonjs.mjs/loader/settings.js

@@ -0,0 +1,91 @@
+/*!
+ * melonJS Game Engine - v14.5.0
+ * http://www.melonjs.org
+ * melonjs is licensed under the MIT License.
+ * http://www.opensource.org/licenses/mit-license
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
+ */
+//  to enable/disable caching
+let nocache = "";
+
+// baseURL
+let baseURL = {};
+
+
+/**
+ * crossOrigin attribute to configure the CORS requests for Image data element.
+ * By default (that is, when the attribute is not specified), CORS is not used at all.
+ * The "anonymous" keyword means that there will be no exchange of user credentials via cookies,
+ * client-side SSL certificates or HTTP authentication as described in the Terminology section of the CORS specification.<br>
+ * @type {string}
+ * @name crossOrigin
+ * @default undefined
+ * @memberof loader
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes
+ * @example
+ *  // allow for cross-origin texture loading in WebGL
+ * me.loader.crossOrigin = "anonymous";
+ *
+ * // set all ressources to be loaded
+ * me.loader.preload(game.resources, this.loaded.bind(this));
+ */
+let crossOrigin;
+
+/**
+ * indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies,
+ * authorization headers or TLS client certificates. Setting withCredentials has no effect on same-site requests.
+ * @public
+ * @type {boolean}
+ * @name withCredentials
+ * @default false
+ * @memberof loader
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials
+ * @example
+ *  // enable withCredentials
+ * me.loader.withCredentials = true;
+ *
+ * // set all ressources to be loaded
+ * me.loader.preload(game.resources, this.loaded.bind(this));
+ */
+let withCredentials = false;
+
+/**
+ * enable the nocache mechanism
+ * @ignore
+ */
+function setNocache(enable = false) {
+    nocache = enable ? "?" + ~~(Math.random() * 10000000) : "";
+}
+
+/**
+ * change the default baseURL for the given asset type.<br>
+ * (this will prepend the asset URL and must finish with a '/')
+ * @name setBaseURL
+ * @memberof loader
+ * @public
+ * @param {string} type  - "*", "audio", binary", "image", "json", "js", "tmx", "tsx"
+ * @param {string} [url="./"] - default base URL
+ * @example
+ * // change the base URL relative address for audio assets
+ * me.loader.setBaseURL("audio", "data/audio/");
+ * // change the base URL absolute address for all object types
+ * me.loader.setBaseURL("*", "http://myurl.com/")
+ */
+function setBaseURL(type, url) {
+    if (type !== "*") {
+        baseURL[type] = url;
+    } else {
+        // "wildcards"
+        baseURL["audio"] = url;
+        baseURL["binary"] = url;
+        baseURL["image"] = url;
+        baseURL["json"] = url;
+        baseURL["js"] = url;
+        baseURL["tmx"] = url;
+        baseURL["tsx"] = url;
+        // XXX ?
+        //baseURL["fontface"] = url;
+    }
+}
+
+export { baseURL, crossOrigin, nocache, setBaseURL, setNocache, withCredentials };

package/dist/melonjs.mjs/math/color.js

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

package/dist/melonjs.mjs/math/math.js

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

package/dist/melonjs.mjs/math/matrix2.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -303,15 +303,13 @@ import Matrix3d from './matrix3.js';
      * @param {number} [y=x] - a number representing the ordinate of the scaling vector.
      * @returns {Matrix2d} Reference to this object for method chaining
      */
-    scale(x, y) {
-        var a = this.val,
-           _x = x,
-           _y = typeof(y) === "undefined" ? _x : y;
+    scale(x, y = x) {
+        var a = this.val;
 
-        a[0] *= _x;
-        a[1] *= _x;
-        a[3] *= _y;
-        a[4] *= _y;
+        a[0] *= x;
+        a[1] *= x;
+        a[3] *= y;
+        a[4] *= y;
 
         return this;
     }

package/dist/melonjs.mjs/math/matrix3.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -401,26 +401,23 @@ import { EPSILON } from './math.js';
      * @param {number} [z=0] - a number representing the depth vector
      * @returns {Matrix3d} Reference to this object for method chaining
      */
-    scale(x, y, z) {
-        var a = this.val,
-           _x = x,
-           _y = typeof(y) === "undefined" ? _x : y,
-           _z = typeof(z) === "undefined" ?  0 : z;
-
-        a[0] = a[0] * _x;
-        a[1] = a[1] * _x;
-        a[2] = a[2] * _x;
-        a[3] = a[3] * _x;
-
-        a[4] = a[4] * _y;
-        a[5] = a[5] * _y;
-        a[6] = a[6] * _y;
-        a[7] = a[7] * _y;
-
-        a[8] = a[8] * _z;
-        a[9] = a[9] * _z;
-        a[10] = a[10] * _z;
-        a[11] = a[11] * _z;
+    scale(x, y = x, z = 0) {
+        var a = this.val;
+
+        a[0] = a[0] * x;
+        a[1] = a[1] * x;
+        a[2] = a[2] * x;
+        a[3] = a[3] * x;
+
+        a[4] = a[4] * y;
+        a[5] = a[5] * y;
+        a[6] = a[6] * y;
+        a[7] = a[7] * y;
+
+        a[8] = a[8] * z;
+        a[9] = a[9] * z;
+        a[10] = a[10] * z;
+        a[11] = a[11] * z;
 
         return this;
     }

package/dist/melonjs.mjs/math/observable_vector2.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -163,8 +163,8 @@ import { clamp } from './math.js';
      * @param {number} [y=x]
      * @returns {ObservableVector2d} Reference to this object for method chaining
      */
-    scale(x, y) {
-        return this._set(this._x * x, this._y * (typeof (y) !== "undefined" ? y : x));
+    scale(x, y = x) {
+        return this._set(this._x * x, this._y * y);
     }
 
     /**

package/dist/melonjs.mjs/math/observable_vector3.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -193,9 +193,8 @@ import pool from '../system/pooling.js';
      * @param {number} [z=1]
      * @returns {ObservableVector3d} Reference to this object for method chaining
      */
-    scale(x, y, z) {
-        y = (typeof (y) !== "undefined" ? y : x);
-        return this._set(this._x * x, this._y * y, this._z * (z || 1));
+    scale(x, y = x, z = 1) {
+        return this._set(this._x * x, this._y * y, this._z * z);
     }
 
     /**

package/dist/melonjs.mjs/math/vector2.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -127,8 +127,8 @@ import pool from '../system/pooling.js';
      * @param {number} [y=x]
      * @returns {Vector2d} Reference to this object for method chaining
      */
-    scale(x, y) {
-        return this._set(this.x * x, this.y * (typeof (y) !== "undefined" ? y : x));
+    scale(x, y = x) {
+        return this._set(this.x * x, this.y * y);
     }
 
     /**

package/dist/melonjs.mjs/math/vector3.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -141,9 +141,8 @@ import pool from '../system/pooling.js';
      * @param {number} [z=1]
      * @returns {Vector3d} Reference to this object for method chaining
      */
-    scale(x, y, z) {
-        y = (typeof (y) !== "undefined" ? y : x);
-        return this._set(this.x * x, this.y * y, this.z * (z || 1));
+    scale(x, y = x, z = 1) {
+        return this._set(this.x * x, this.y * y, this.z * z);
     }
 
     /**

package/dist/melonjs.mjs/node_modules/@teppeis/multimaps/dist/src/arraymultimap.js

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

package/dist/melonjs.mjs/node_modules/@teppeis/multimaps/dist/src/index.js

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

package/dist/melonjs.mjs/node_modules/@teppeis/multimaps/dist/src/multimap.js

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

package/dist/melonjs.mjs/node_modules/@teppeis/multimaps/dist/src/setmultimap.js

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

package/dist/melonjs.mjs/node_modules/earcut/src/earcut.js

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

package/dist/melonjs.mjs/node_modules/eventemitter3/index.js

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

package/dist/melonjs.mjs/node_modules/eventemitter3/index2.js

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

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

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

package/dist/melonjs.mjs/particles/emitter.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v14.4.0
+ * melonJS Game Engine - v14.5.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -167,7 +167,7 @@ function createDefaultParticleTexture(w = 8, h = 8) {
 
     /**
      * Launch particles from emitter constantly (e.g. for stream)
-     * @param {number} duration - [optional] time that the emitter releases particles in ms
+     * @param {number} [duration] - time that the emitter releases particles in ms
      */
     streamParticles(duration) {
         this._enabled = true;
@@ -185,7 +185,7 @@ function createDefaultParticleTexture(w = 8, h = 8) {
 
     /**
      * Launch all particles from emitter and stop (e.g. for explosion)
-     * @param {number} total - [optional] number of particles to launch
+     * @param {number} [total] - number of particles to launch
      */
     burstParticles(total) {
         this._enabled = true;