melonjs 15.1.6 → 15.2.1

package/dist/melonjs.module.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v15.1.6
+ * melonJS Game Engine - v15.2.1
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -8096,7 +8096,7 @@ function weightedRandom(arr) {
     return arr[weightedRandom$1(0, arr.length)];
 }
 
-var arrayUtils = {
+var array$1 = {
 	__proto__: null,
 	random: random,
 	remove: remove,
@@ -9002,201 +9002,6 @@ let collision = {
     rayCast(line, result) { return game.world.detector.rayCast(line, result); }
 };
 
-/**
- * a collection of string utility functions
- * @namespace utils.string
- */
-
-/**
- * converts the first character of the given string to uppercase
- * @public
- * @memberof utils.string
- * @name capitalize
- * @param {string} str - the string to be capitalized
- * @returns {string} the capitalized string
- */
-function capitalize(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
-
-/**
- * returns true if the given string contains a numeric integer or float value
- * @public
- * @memberof utils.string
- * @name isNumeric
- * @param {string} str - the string to be tested
- * @returns {boolean} true if string contains only digits
- */
-function isNumeric(str) {
-    if (typeof str === "string") {
-        str = str.trim();
-    }
-    return !isNaN(str) && /^[+-]?(\d+(\.\d+)?|\.\d+)$/.test(str);
-}
-
-/**
- * returns true if the given string contains a true or false
- * @public
- * @memberof utils.string
- * @name isBoolean
- * @param {string} str - the string to be tested
- * @returns {boolean} true if the string is either true or false
- */
-function isBoolean(str) {
-    const trimmed = str.trim();
-    return (trimmed === "true") || (trimmed === "false");
-}
-
-/**
- * convert a string to the corresponding hexadecimal value
- * @public
- * @memberof utils.string
- * @name toHex
- * @param {string} str - the string to be converted
- * @returns {string} the converted hexadecimal value
- */
-function toHex(str) {
-    let res = "", c = 0;
-    while (c < str.length) {
-        res += str.charCodeAt(c++).toString(16);
-    }
-    return res;
-}
-
-/**
- * returns true if the given string is a data url in the `data:[<mediatype>][;base64],<data>` format.
- * (this will not test the validity of the Data or Base64 encoding)
- * @public
- * @memberof utils.string
- * @name isDataUrl
- * @param {string} str - the string (url) to be tested
- * @returns {boolean} true if the string is a data url
- */
-function isDataUrl(str) {
-    return /^data:(.+);base64,(.+)$/.test(str);
-}
-
-var stringUtils = {
-	__proto__: null,
-	capitalize: capitalize,
-	isBoolean: isBoolean,
-	isDataUrl: isDataUrl,
-	isNumeric: isNumeric,
-	toHex: toHex
-};
-
-/**
- * a collection of utility functons to ease porting between different user agents.
- * @namespace utils.agent
- */
-
-/**
- * Known agent vendors
- * @ignore
- */
-const vendors = [ "ms", "MS", "moz", "webkit", "o" ];
-
-/**
- * Get a vendor-prefixed property
- * @public
- * @name prefixed
- * @param {string} name - Property name
- * @param {object} [obj=globalThis] - Object or element reference to access
- * @returns {string} Value of property
- * @memberof utils.agent
- */
-function prefixed(name, obj) {
-    obj = obj || globalThis;
-    if (name in obj) {
-        return obj[name];
-    }
-
-    let uc_name = capitalize(name);
-
-    let result;
-    vendors.some((vendor) => {
-        let name = vendor + uc_name;
-        return (result = (name in obj) ? obj[name] : undefined);
-    });
-    return result;
-}
-
-/**
- * Set a vendor-prefixed property
- * @public
- * @name setPrefixed
- * @param {string} name - Property name
- * @param {string} value - Property value
- * @param {object} [obj=globalThis] - Object or element reference to access
- * @returns {boolean} true if one of the vendor-prefixed property was found
- * @memberof utils.agent
- */
-function setPrefixed(name, value, obj) {
-    obj = obj || globalThis;
-    if (name in obj) {
-        obj[name] = value;
-        return;
-    }
-
-    let uc_name = capitalize(name);
-
-    vendors.some((vendor) => {
-        let name = vendor + uc_name;
-        if (name in obj) {
-            obj[name] = value;
-            return true;
-        }
-    });
-
-    return false;
-}
-
-var agentUtils = {
-	__proto__: null,
-	prefixed: prefixed,
-	setPrefixed: setPrefixed
-};
-
-/**
- * a collection of file utility functions
- * @namespace utils.file
- */
-
-// regexp to deal with file name & path
-const REMOVE_PATH = /^.*(\\|\/|\:)/;
-const REMOVE_EXT = /\.[^\.]*$/;
-
-
-/**
- * return the base name of the file without path info
- * @public
- * @memberof utils.file
- * @name getBasename
- * @param  {string} path- -  path containing the filename
- * @returns {string} the base name without path information.
- */
-function getBasename(path) {
-    return path.replace(REMOVE_PATH, "").replace(REMOVE_EXT, "");
-}
-
-/**
- * return the extension of the file in the given path
- * @public
- * @memberof utils.file
- * @name getExtension
- * @param  {string} path- -  path containing the filename
- * @returns {string} filename extension.
- */
-function getExtension(path) {
-    return path.substring(path.lastIndexOf(".") + 1, path.length);
-}
-
-var fileUtils = {
-	__proto__: null,
-	getBasename: getBasename,
-	getExtension: getExtension
-};
-
 /**
  * a collection of utility functions
  * @namespace utils.function
@@ -9259,141 +9064,12 @@ function throttle(fn, delay, no_trailing) {
     };
 }
 
-var fnUtils = {
+var _function = {
 	__proto__: null,
 	defer: defer,
 	throttle: throttle
 };
 
-/**
- * a collection of utility functions
- * @namespace utils
- */
-
-// guid default value
-let GUID_base  = "";
-let GUID_index = 0;
-
-let utils = {
-
-    agent : agentUtils,
-    array : arrayUtils,
-    file : fileUtils,
-    string : stringUtils,
-    function : fnUtils,
-
-    /**
-     * Compare two version strings
-     * @public
-     * @memberof utils
-     * @name checkVersion
-     * @param {string} first - First version string to compare
-     * @param {string} second - second version string to compare
-     * @returns {number} comparison result <br>&lt; 0 : first &lt; second<br>
-     * 0 : first == second<br>
-     * &gt; 0 : first &gt; second
-     * @example
-     * if (me.utils.checkVersion("7.0.0") > 0) {
-     *     console.error(
-     *         "melonJS is too old. Expected: 7.0.0, Got: 6.3.0"
-     *     );
-     * }
-     */
-    checkVersion : function (first, second) {
-        let a = first.split(".");
-        let b = second.split(".");
-        let len = Math.min(a.length, b.length);
-        let result = 0;
-
-        for (let i = 0; i < len; i++) {
-            if ((result = +a[i] - +b[i])) {
-                break;
-            }
-        }
-
-        return result ? result : a.length - b.length;
-    },
-
-    /**
-     * parse the fragment (hash) from a URL and returns them into
-     * @public
-     * @memberof utils
-     * @name getUriFragment
-     * @param {string} [url=document.location] - an optional params string or URL containing fragment (hash) params to be parsed
-     * @returns {object} an object representing the deserialized params string.
-     * @property {boolean} [hitbox=false] draw the hitbox in the debug panel (if enabled)
-     * @property {boolean} [velocity=false] draw the entities velocity in the debug panel (if enabled)
-     * @property {boolean} [quadtree=false] draw the quadtree in the debug panel (if enabled)
-     * @property {boolean} [webgl=false] force the renderer to WebGL
-     * @property {boolean} [debug=false] display the debug panel (if preloaded)
-     * @property {string} [debugToggleKey="s"] show/hide the debug panel (if preloaded)
-     * @example
-     * // http://www.example.com/index.html#debug&hitbox=true&mytag=value
-     * let UriFragment = me.utils.getUriFragment();
-     * console.log(UriFragment["mytag"]); //> "value"
-     */
-    getUriFragment : function (url) {
-        let hash = {};
-
-        if (typeof url === "undefined") {
-            if (typeof globalThis.document !== "undefined") {
-                let location = globalThis.document.location;
-
-                if (location && location.hash) {
-                    url = location.hash;
-                } else {
-                    // No "document.location" exist for Wechat mini game platform.
-                    return hash;
-                }
-            } else {
-                // "document" undefined on node.js
-                return hash;
-            }
-        } else {
-            // never cache if a url is passed as parameter
-            let index = url.indexOf("#");
-            if (index !== -1) {
-                url = url.slice(index, url.length);
-            } else {
-                return hash;
-            }
-        }
-
-        // parse the url
-        url.slice(1).split("&").filter((value) => value !== "").forEach((value) => {
-            let kv = value.split("=");
-            let k = kv.shift();
-            let v = kv.join("=");
-            hash[k] = v || true;
-        });
-
-        return hash;
-    },
-
-    /**
-     * reset the GUID Base Name
-     * the idea here being to have a unique ID
-     * per level / object
-     * @ignore
-     */
-    resetGUID : function (base, index = 0) {
-        // also ensure it's only 8bit ASCII characters
-        GUID_base  = toHex(base.toString().toUpperCase());
-        GUID_index = index;
-    },
-
-    /**
-     * create and return a very simple GUID
-     * Game Unique ID
-     * @ignore
-     */
-    createGUID : function (index = 1) {
-        // to cover the case of undefined id for groups
-        GUID_index += index;
-        return GUID_base + "-" + (index || GUID_index);
-    }
-};
-
 var eventemitter3$1 = {exports: {}};
 
 var eventemitter3 = eventemitter3$1.exports;
@@ -13642,6 +13318,89 @@ function setBaseURL(type, url) {
     }
 }
 
+/**
+ * a collection of string utility functions
+ * @namespace utils.string
+ */
+
+/**
+ * converts the first character of the given string to uppercase
+ * @public
+ * @memberof utils.string
+ * @name capitalize
+ * @param {string} str - the string to be capitalized
+ * @returns {string} the capitalized string
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+/**
+ * returns true if the given string contains a numeric integer or float value
+ * @public
+ * @memberof utils.string
+ * @name isNumeric
+ * @param {string} str - the string to be tested
+ * @returns {boolean} true if string contains only digits
+ */
+function isNumeric(str) {
+    if (typeof str === "string") {
+        str = str.trim();
+    }
+    return !isNaN(str) && /^[+-]?(\d+(\.\d+)?|\.\d+)$/.test(str);
+}
+
+/**
+ * returns true if the given string contains a true or false
+ * @public
+ * @memberof utils.string
+ * @name isBoolean
+ * @param {string} str - the string to be tested
+ * @returns {boolean} true if the string is either true or false
+ */
+function isBoolean(str) {
+    const trimmed = str.trim();
+    return (trimmed === "true") || (trimmed === "false");
+}
+
+/**
+ * convert a string to the corresponding hexadecimal value
+ * @public
+ * @memberof utils.string
+ * @name toHex
+ * @param {string} str - the string to be converted
+ * @returns {string} the converted hexadecimal value
+ */
+function toHex(str) {
+    let res = "", c = 0;
+    while (c < str.length) {
+        res += str.charCodeAt(c++).toString(16);
+    }
+    return res;
+}
+
+/**
+ * returns true if the given string is a data url in the `data:[<mediatype>][;base64],<data>` format.
+ * (this will not test the validity of the Data or Base64 encoding)
+ * @public
+ * @memberof utils.string
+ * @name isDataUrl
+ * @param {string} str - the string (url) to be tested
+ * @returns {boolean} true if the string is a data url
+ */
+function isDataUrl(str) {
+    return /^data:(.+);base64,(.+)$/.test(str);
+}
+
+var string$1 = {
+	__proto__: null,
+	capitalize: capitalize,
+	isBoolean: isBoolean,
+	isDataUrl: isDataUrl,
+	isNumeric: isNumeric,
+	toHex: toHex
+};
+
 // external import
 
 /**
@@ -14210,7 +13969,7 @@ var audio = {
  * @static
  * @see Application
  */
-const CANVAS$1 = 0;
+const CANVAS = 0;
 
 /**
  * constant to select select the WebGL renderer
@@ -14218,7 +13977,7 @@ const CANVAS$1 = 0;
  * @static
  * @see Application
  */
-const WEBGL$1 = 1;
+const WEBGL = 1;
 
 /**
  * constant to auto-select the renderer (Attempt WebGL first, with fallback to Canvas)
@@ -14226,33 +13985,7 @@ const WEBGL$1 = 1;
  * @type {number}
  * @see Application
  */
-const AUTO$1 = 2;
-
-/**
- * @namespace video
- */
-
-
-/**
- * Select the HTML5 Canvas renderer
- * @memberof video
- * @static
- */
-const CANVAS = CANVAS$1;
-
-/**
- * Select the WebGL renderer
- * @memberof video
- * @static
- */
-const WEBGL = WEBGL$1;
-
-/**
- * Auto-select the renderer (Attempt WebGL first, with fallback to Canvas)
- * @memberof video
- * @static
- */
-const AUTO = AUTO$1;
+const AUTO = 2;
 
 /**
  * A reference to the active Canvas or WebGL active renderer renderer
@@ -14322,7 +14055,7 @@ function init(width, height, options) {
     //add a channel for the onresize/onorientationchange event
     globalThis.addEventListener(
         "resize",
-        utils.function.throttle(
+        throttle(
             (e) => {
                 emit(WINDOW_ONRESIZE, e);
             }, 100
@@ -14354,7 +14087,7 @@ function init(width, height, options) {
     }
 
     // Automatically update relative canvas position on scroll
-    globalThis.addEventListener("scroll", utils.function.throttle((e) => {
+    globalThis.addEventListener("scroll", throttle((e) => {
         emit(WINDOW_ONSCROLL, e);
     }, 100), false);
 
@@ -14561,6 +14294,78 @@ let save = {
     }
 };
 
+/**
+ * a collection of utility functons to ease porting between different user agents.
+ * @namespace utils.agent
+ */
+
+/**
+ * Known agent vendors
+ * @ignore
+ */
+const vendors = [ "ms", "MS", "moz", "webkit", "o" ];
+
+/**
+ * Get a vendor-prefixed property
+ * @public
+ * @name prefixed
+ * @param {string} name - Property name
+ * @param {object} [obj=globalThis] - Object or element reference to access
+ * @returns {string} Value of property
+ * @memberof utils.agent
+ */
+function prefixed(name, obj) {
+    obj = obj || globalThis;
+    if (name in obj) {
+        return obj[name];
+    }
+
+    let uc_name = capitalize(name);
+
+    let result;
+    vendors.some((vendor) => {
+        let name = vendor + uc_name;
+        return (result = (name in obj) ? obj[name] : undefined);
+    });
+    return result;
+}
+
+/**
+ * Set a vendor-prefixed property
+ * @public
+ * @name setPrefixed
+ * @param {string} name - Property name
+ * @param {string} value - Property value
+ * @param {object} [obj=globalThis] - Object or element reference to access
+ * @returns {boolean} true if one of the vendor-prefixed property was found
+ * @memberof utils.agent
+ */
+function setPrefixed(name, value, obj) {
+    obj = obj || globalThis;
+    if (name in obj) {
+        obj[name] = value;
+        return;
+    }
+
+    let uc_name = capitalize(name);
+
+    vendors.some((vendor) => {
+        let name = vendor + uc_name;
+        if (name in obj) {
+            obj[name] = value;
+            return true;
+        }
+    });
+
+    return false;
+}
+
+var agent$1 = {
+	__proto__: null,
+	prefixed: prefixed,
+	setPrefixed: setPrefixed
+};
+
 /**
   * The device platform type
   * @namespace platform
@@ -19500,6 +19305,46 @@ let default_settings = {
     }
 }
 
+/**
+ * a collection of file utility functions
+ * @namespace utils.file
+ */
+
+// regexp to deal with file name & path
+const REMOVE_PATH = /^.*(\\|\/|\:)/;
+const REMOVE_EXT = /\.[^\.]*$/;
+
+
+/**
+ * return the base name of the file without path info
+ * @public
+ * @memberof utils.file
+ * @name getBasename
+ * @param  {string} path- -  path containing the filename
+ * @returns {string} the base name without path information.
+ */
+function getBasename(path) {
+    return path.replace(REMOVE_PATH, "").replace(REMOVE_EXT, "");
+}
+
+/**
+ * return the extension of the file in the given path
+ * @public
+ * @memberof utils.file
+ * @name getExtension
+ * @param  {string} path- -  path containing the filename
+ * @returns {string} filename extension.
+ */
+function getExtension(path) {
+    return path.substring(path.lastIndexOf(".") + 1, path.length);
+}
+
+var file$1 = {
+	__proto__: null,
+	getBasename: getBasename,
+	getExtension: getExtension
+};
+
 /**
  * where all preloaded content is cached
  */
@@ -19516,6 +19361,139 @@ let binList = {};
 // contains all the JSON files
 let jsonList = {};
 
+/**
+ * a collection of utility functions
+ * @namespace utils
+ */
+
+// guid default value
+let GUID_base  = "";
+let GUID_index = 0;
+
+/**
+ * Compare two version strings
+ * @public
+ * @memberof utils
+ * @name checkVersion
+ * @param {string} first - First version string to compare
+ * @param {string} second - second version string to compare
+ * @returns {number} comparison result <br>&lt; 0 : first &lt; second<br>
+ * 0 : first == second<br>
+ * &gt; 0 : first &gt; second
+ * @example
+ * if (me.utils.checkVersion("7.0.0") > 0) {
+ *     console.error(
+ *         "melonJS is too old. Expected: 7.0.0, Got: 6.3.0"
+ *     );
+ * }
+ */
+function checkVersion(first, second) {
+    let a = first.split(".");
+    let b = second.split(".");
+    let len = Math.min(a.length, b.length);
+    let result = 0;
+
+    for (let i = 0; i < len; i++) {
+        if ((result = +a[i] - +b[i])) {
+            break;
+        }
+    }
+
+    return result ? result : a.length - b.length;
+}
+
+/**
+ * parse the fragment (hash) from a URL and returns them into
+ * @public
+ * @memberof utils
+ * @name getUriFragment
+ * @param {string} [url=document.location] - an optional params string or URL containing fragment (hash) params to be parsed
+ * @returns {object} an object representing the deserialized params string.
+ * @property {boolean} [hitbox=false] draw the hitbox in the debug panel (if enabled)
+ * @property {boolean} [velocity=false] draw the entities velocity in the debug panel (if enabled)
+ * @property {boolean} [quadtree=false] draw the quadtree in the debug panel (if enabled)
+ * @property {boolean} [webgl=false] force the renderer to WebGL
+ * @property {boolean} [debug=false] display the debug panel (if preloaded)
+ * @property {string} [debugToggleKey="s"] show/hide the debug panel (if preloaded)
+ * @example
+ * // http://www.example.com/index.html#debug&hitbox=true&mytag=value
+ * let UriFragment = me.utils.getUriFragment();
+ * console.log(UriFragment["mytag"]); //> "value"
+ */
+function getUriFragment(url) {
+    let hash = {};
+
+    if (typeof url === "undefined") {
+        if (typeof globalThis.document !== "undefined") {
+            let location = globalThis.document.location;
+
+            if (location && location.hash) {
+                url = location.hash;
+            } else {
+                // No "document.location" exist for Wechat mini game platform.
+                return hash;
+            }
+        } else {
+            // "document" undefined on node.js
+            return hash;
+        }
+    } else {
+        // never cache if a url is passed as parameter
+        let index = url.indexOf("#");
+        if (index !== -1) {
+            url = url.slice(index, url.length);
+        } else {
+            return hash;
+        }
+    }
+
+    // parse the url
+    url.slice(1).split("&").filter((value) => value !== "").forEach((value) => {
+        let kv = value.split("=");
+        let k = kv.shift();
+        let v = kv.join("=");
+        hash[k] = v || true;
+    });
+
+    return hash;
+}
+
+/**
+ * reset the GUID Base Name
+ * the idea here being to have a unique ID
+ * per level / object
+ * @ignore
+ */
+function resetGUID(base, index = 0) {
+    // also ensure it's only 8bit ASCII characters
+    GUID_base  = toHex(base.toString().toUpperCase());
+    GUID_index = index;
+}
+
+/**
+ * create and return a very simple GUID
+ * Game Unique ID
+ * @ignore
+ */
+function createGUID(index = 1) {
+    // to cover the case of undefined id for groups
+    GUID_index += index;
+    return GUID_base + "-" + (index || GUID_index);
+}
+
+var utils = {
+	__proto__: null,
+	agent: agent$1,
+	array: array$1,
+	checkVersion: checkVersion,
+	createGUID: createGUID,
+	file: file$1,
+	function: _function,
+	getUriFragment: getUriFragment,
+	resetGUID: resetGUID,
+	string: string$1
+};
+
 /**
  * @classdesc
  * a TMX Tile Set Object
@@ -19870,6 +19848,18 @@ const COLLISION_GROUP     = "collision";
     }
 }
 
+/**
+ * a collection of utility functions for parsing TMX maps
+ * @namespace TMXUtils
+ */
+
+
+/**
+ * the function used to decompress zlib/gzip data
+ * @ignore
+ */
+let inflateFunction;
+
 /**
  * set and interpret a TMX property value
  * @ignore
@@ -19895,11 +19885,11 @@ function setTMXValue(name, type, value) {
 
         default :
             // try to parse it anyway
-            if (!value || utils.string.isBoolean(value)) {
+            if (!value || isBoolean(value)) {
                 // if value not defined or boolean
                 value = value ? (value === "true") : true;
             }
-            else if (utils.string.isNumeric(value)) {
+            else if (isNumeric(value)) {
                 // check if numeric
                 value = Number(value);
             }
@@ -19965,94 +19955,6 @@ function parseAttributes(obj, elt) {
     }
 }
 
-/**
- * decompress and decode zlib/gzip data
- * @ignore
- * @name decompress
- * @param {string} input - Base64 encoded and compressed data
- * @param {string} format - compressed data format ("gzip","zlib", "zstd")
- * @returns {Uint32Array} Decoded and decompress data
- */
-function decompress(data, format) {
-    if (typeof utils.inflateb64 === "function") {
-        return utils.inflateb64(data, format);
-    } else {
-        throw new Error("GZIP/ZLIB compressed TMX Tile Map not supported!");
-    }
-}
-
-/**
- * Decode a CSV encoded array into a binary array
- * @ignore
- * @name decodeCSV
- * @param  {string} input- -  CSV formatted data (only numbers, everything else will be converted to NaN)
- * @returns {number[]} Decoded data
- */
-function decodeCSV(input) {
-    let entries = input.replace("\n", "").trim().split(",");
-
-    let result = [];
-    for (let i = 0; i < entries.length; i++) {
-        result.push(+entries[i]);
-    }
-    return result;
-}
-
-/**
- * Decode a base64 encoded string into a byte array
- * @ignore
- * @name decodeBase64AsArray
- * @param {string} input - Base64 encoded data
- * @param {number} [bytes] - number of bytes per array entry
- * @returns {Uint32Array} Decoded data
- */
-function decodeBase64AsArray(input, bytes) {
-    bytes = bytes || 1;
-
-    let i, j, len;
-    let dec = globalThis.atob(input.replace(/[^A-Za-z0-9\+\/\=]/g, ""));
-    let ar = new Uint32Array(dec.length / bytes);
-
-    for (i = 0, len = dec.length / bytes; i < len; i++) {
-        ar[i] = 0;
-        for (j = bytes - 1; j >= 0; --j) {
-            ar[i] += dec.charCodeAt((i * bytes) + j) << (j << 3);
-        }
-    }
-    return ar;
-}
-
-/**
- * Decode the given data
- * @ignore
- */
-function decode(data, encoding, compression) {
-    compression = compression || "none";
-    encoding = encoding || "none";
-
-    switch (encoding) {
-        case "csv":
-            return decodeCSV(data);
-
-        case "base64":
-            if (compression !== "none") {
-                data = decompress(data, compression);
-            } else {
-                data = decodeBase64AsArray(data, 4);
-            }
-            return data;
-
-        case "none":
-            return data;
-
-        case "xml":
-            throw new Error("XML encoding is deprecated, use base64 instead");
-
-        default:
-            throw new Error("Unknown layer encoding: " + encoding);
-    }
-}
-
 /**
  * Normalize TMX format to Tiled JSON format
  * @ignore
@@ -20185,9 +20087,113 @@ function normalize(obj, item) {
     }
 }
 
+
+/**
+ * decompress and decode zlib/gzip data
+ * @name decompress
+ * @memberOf TMXUtils
+ * @param {string} input - Base64 encoded and compressed data
+ * @param {string} format - compressed data format ("gzip","zlib", "zstd")
+ * @returns {Uint32Array} Decoded and decompress data
+ */
+function decompress(data, format) {
+    if (typeof inflateFunction === "function") {
+        return inflateFunction(data, format);
+    } else {
+        throw new Error("GZIP/ZLIB compressed TMX Tile Map not supported!");
+    }
+}
+
+/**
+ * Decode a CSV encoded array into a binary array
+ * @name decodeCSV
+ * @memberOf TMXUtils
+ * @param  {string} input- -  CSV formatted data (only numbers, everything else will be converted to NaN)
+ * @returns {number[]} Decoded data
+ */
+function decodeCSV(input) {
+    let entries = input.replace("\n", "").trim().split(",");
+
+    let result = [];
+    for (let i = 0; i < entries.length; i++) {
+        result.push(+entries[i]);
+    }
+    return result;
+}
+
+/**
+ * Decode a base64 encoded string into a byte array
+ * @name decodeBase64AsArray
+ * @memberOf TMXUtils
+ * @param {string} input - Base64 encoded data
+ * @param {number} [bytes] - number of bytes per array entry
+ * @returns {Uint32Array} Decoded data
+ */
+function decodeBase64AsArray(input, bytes) {
+    bytes = bytes || 1;
+
+    let i, j, len;
+    let dec = globalThis.atob(input.replace(/[^A-Za-z0-9\+\/\=]/g, ""));
+    let ar = new Uint32Array(dec.length / bytes);
+
+    for (i = 0, len = dec.length / bytes; i < len; i++) {
+        ar[i] = 0;
+        for (j = bytes - 1; j >= 0; --j) {
+            ar[i] += dec.charCodeAt((i * bytes) + j) << (j << 3);
+        }
+    }
+    return ar;
+}
+
+/**
+ * set the function used to inflate gzip/zlib data
+ * @param {Func} fn - inflate function
+ */
+function setInflateFunction(fn) {
+    inflateFunction = fn;
+}
+
+/**
+ * Decode a encoded array into a binary array
+ * @name decodeCSV
+ * @memberOf TMXUtils
+ * @param {string} data - data to be decoded
+ * @param {string} [encoding="none"] - data encoding ("csv", "base64", "xml")
+ * @returns {number[]} Decoded data
+ */
+function decode(data, encoding, compression) {
+    compression = compression || "none";
+    encoding = encoding || "none";
+
+    switch (encoding) {
+        case "csv":
+            return decodeCSV(data);
+
+        case "base64":
+            if (compression !== "none") {
+                data = decompress(data, compression);
+            } else {
+                data = decodeBase64AsArray(data, 4);
+            }
+            return data;
+
+        case "none":
+            return data;
+
+        case "xml":
+            throw new Error("XML encoding is deprecated, use base64 instead");
+
+        default:
+            throw new Error("Unknown layer encoding: " + encoding);
+    }
+}
+
 /**
  * Parse a XML TMX object and returns the corresponding javascript object
- * @ignore
+ * @name parse
+ * @memberOf TMXUtils
+ * @param {Document} xml - XML TMX object
+ * @returns {object} Javascript object
  */
 function parse(xml) {
     // Create the return object
@@ -20225,7 +20231,11 @@ function parse(xml) {
 
 /**
  * Apply TMX Properties to the given object
- * @ignore
+ * @name applyTMXProperties
+ * @memberOf TMXUtils
+ * @param {object} obj - object to apply the properties to
+ * @param {object} data - TMX data object
+ * @returns {object} obj
  */
 function applyTMXProperties(obj, data) {
     let properties = data.properties;
@@ -20255,6 +20265,14 @@ function applyTMXProperties(obj, data) {
     }
 }
 
+var TMXUtils = {
+	__proto__: null,
+	applyTMXProperties: applyTMXProperties,
+	decode: decode,
+	parse: parse,
+	setInflateFunction: setInflateFunction
+};
+
 /**
  * @classdesc
  * a basic tile object
@@ -23690,7 +23708,7 @@ let globalFloatingCounter = 0;
             // (e.g. move one child from one container to another)
             if (child.isRenderable) {
                 // allocated a GUID value (use child.id as based index if defined)
-                child.GUID = utils.createGUID(child.id);
+                child.GUID = createGUID(child.id);
             }
         }
 
@@ -23773,7 +23791,7 @@ let globalFloatingCounter = 0;
                 // (e.g. move one child from one container to another)
                 if (child.isRenderable) {
                     // allocated a GUID value
-                    child.GUID = utils.createGUID();
+                    child.GUID = createGUID();
                 }
             }
 
@@ -24144,7 +24162,7 @@ let globalFloatingCounter = 0;
      */
     removeChild(child, keepalive) {
         if (this.hasChild(child)) {
-            utils.function.defer(deferredRemove, this, child, keepalive);
+            defer(deferredRemove, this, child, keepalive);
         }
         else {
             throw new Error("Child is not mine.");
@@ -24295,7 +24313,7 @@ let globalFloatingCounter = 0;
                 });
             }
             /** @ignore */
-            this.pendingSort = utils.function.defer(function () {
+            this.pendingSort = defer(function () {
                 // sort everything in this container
                 this.getChildren().sort(this["_sort" + this.sortOn.toUpperCase()]);
                 // clear the defer id
@@ -25760,7 +25778,7 @@ function readObjectGroup(map, data, z) {
         // if version is undefined or empty it usually means the map was not created with Tiled
         if (this.version !== "undefined" && this.version !== "") {
             // deprecation warning if map tiled version is older than 1.5
-            if (utils.checkVersion(this.version, "1.5") < 0) {
+            if (checkVersion(this.version, "1.5") < 0) {
                 warning("("+this.name+") Tiled Map format version 1.4 and below", "format 1.5 or higher", "10.4.4");
             }
         }
@@ -26185,7 +26203,7 @@ function loadTMXLevel(levelId, container, flatten, setViewportBounds) {
 
     // reset the GUID generator
     // and pass the level id as parameter
-    utils.resetGUID(levelId, level.nextobjectid);
+    resetGUID(levelId, level.nextobjectid);
 
     // Tiled use 0,0 anchor coordinates
     container.anchorPoint.set(0, 0);
@@ -26301,7 +26319,7 @@ let level = {
                 // some silly side effects
                 state$1.stop();
 
-                utils.function.defer(safeLoadLevel, this, levelId, options, true);
+                defer(safeLoadLevel, this, levelId, options, true);
             }
             else {
                 safeLoadLevel(levelId, options);
@@ -28563,7 +28581,7 @@ class Timer {
      */
     clearTimeout(timeoutID) {
         if (timeoutID > 0) {
-            utils.function.defer(this.clearTimer.bind(this), this, timeoutID);
+            defer(this.clearTimer.bind(this), this, timeoutID);
         }
     }
 
@@ -28573,7 +28591,7 @@ class Timer {
      */
     clearInterval(intervalID) {
         if (intervalID > 0) {
-            utils.function.defer(this.clearTimer.bind(this), this, intervalID);
+            defer(this.clearTimer.bind(this), this, intervalID);
         }
     }
 
@@ -37767,14 +37785,14 @@ function consoleHeader(app) {
         }
 
         // override renderer settings if &webgl or &canvas is defined in the URL
-        let uriFragment = utils.getUriFragment();
+        let uriFragment = getUriFragment();
         if (uriFragment.webgl === true || uriFragment.webgl1 === true || uriFragment.webgl2 === true) {
-            this.settings.renderer = WEBGL$1;
+            this.settings.renderer = WEBGL;
             if (uriFragment.webgl1 === true) {
                 this.settings.preferWebGL1 = true;
             }
         } else if (uriFragment.canvas === true) {
-            this.settings.renderer = CANVAS$1;
+            this.settings.renderer = CANVAS;
         }
 
         // normalize scale
@@ -37786,8 +37804,8 @@ function consoleHeader(app) {
 
         if (typeof this.settings.renderer === "number") {
             switch (this.settings.renderer) {
-                case AUTO$1:
-                case WEBGL$1:
+                case AUTO:
+                case WEBGL:
                     this.renderer = autoDetectRenderer(this.settings);
                     break;
                 default:
@@ -37995,133 +38013,140 @@ function consoleHeader(app) {
 }
 
 /**
- * This namespace is a container for all registered plugins.
- * @see plugin.register
- * @namespace plugins
+ * Contains all registered plugins.
+ * @name cache
+ * @memberof plugin
  */
-let plugins = {};
+let cache = {};
 
+/**
+ * @namespace plugin
+ */
 
+/**
+ * a base Object class for plugin
+ * (plugin must be installed using the register function)
+ * @class
+ * @name BasePlugin
+ * @memberof plugin
+ */
 class BasePlugin {
 
     constructor() {
         /**
          * define the minimum required version of melonJS<br>
          * this can be overridden by the plugin
-         * @public
          * @type {string}
-         * @default "15.1.6"
-         * @name plugin.Base#version
+         * @default "15.2.1"
          */
-        this.version = "15.1.6";
+        this.version = "15.2.1";
     }
 }
 
+
 /**
- * @namespace plugin
+ * @class
+ * @name Base
+ * @memberof plugin
+ * @deprecated since 15.1.6, see {@link plugin.BasePlugin}
  */
-let plugin = {
+class Base extends BasePlugin {}
 
-    /**
-     * a base Object for plugin <br>
-     * plugin must be installed using the register function
-     * @see plugin
-     * @class
-     * @name Base
-     * @memberof plugin
-     */
-    Base : BasePlugin,
+/**
+ * patch a melonJS function
+ * @name patch
+ * @memberof plugin
+ * @param {object} proto - target object
+ * @param {string} name - target function
+ * @param {Function} fn - replacement function
+ * @example
+ * // redefine the me.game.update function with a new one
+ * me.plugin.patch(me.game, "update", function () {
+ *   // display something in the console
+ *   console.log("duh");
+ *   // call the original me.game.update function
+ *   this._patched();
+ * });
+ */
+function patch(proto, name, fn) {
+    // use the object prototype if possible
+    if (typeof proto.prototype !== "undefined") {
+        proto = proto.prototype;
+    }
+    // reuse the logic behind object extends
+    if (typeof(proto[name]) === "function") {
+        // save the original function
+        let _parent = proto[name];
+        // override the function with the new one
+        Object.defineProperty(proto, name, {
+            "configurable" : true,
+            "value" : (function (name, fn) {
+                return function () {
+                    this._patched = _parent;
+                    let ret = fn.apply(this, arguments);
+                    this._patched = null;
+                    return ret;
+                };
+            })(name, fn)
+        });
+    }
+    else {
+        throw new Error(name + " is not an existing function");
+    }
+}
 
-    /**
-     * patch a melonJS function
-     * @name patch
-     * @memberof plugin
-     * @public
-     * @param {object} proto - target object
-     * @param {string} name - target function
-     * @param {Function} fn - replacement function
-     * @example
-     * // redefine the me.game.update function with a new one
-     * me.plugin.patch(me.game, "update", function () {
-     *   // display something in the console
-     *   console.log("duh");
-     *   // call the original me.game.update function
-     *   this._patched();
-     * });
-     */
-    patch : function (proto, name, fn) {
-        // use the object prototype if possible
-        if (typeof proto.prototype !== "undefined") {
-            proto = proto.prototype;
-        }
-        // reuse the logic behind object extends
-        if (typeof(proto[name]) === "function") {
-            // save the original function
-            let _parent = proto[name];
-            // override the function with the new one
-            Object.defineProperty(proto, name, {
-                "configurable" : true,
-                "value" : (function (name, fn) {
-                    return function () {
-                        this._patched = _parent;
-                        let ret = fn.apply(this, arguments);
-                        this._patched = null;
-                        return ret;
-                    };
-                })(name, fn)
-            });
-        }
-        else {
-            throw new Error(name + " is not an existing function");
-        }
-    },
+/**
+ * Register a plugin.
+ * @name register
+ * @memberof plugin
+ * @param {plugin.BasePlugin} plugin - Plugin object to instantiate and register
+ * @param {string} [name=plugin.constructor.name] - a unique name for this plugin
+ * @param {object} [...arguments] - all extra parameters will be passed to the plugin constructor
+ * @example
+ * // register a new plugin
+ * me.plugin.register(TestPlugin, "testPlugin");
+ * // the plugin then also become available
+ * // under then me.plugins namespace
+ * me.plugins.testPlugin.myfunction ();
+ */
+function register(plugin, name = plugin.toString().match(/ (\w+)/)[1]) {
+    // ensure me.plugins[name] is not already "used"
+    if (cache[name]) {
+        throw new Error("plugin " + name + " already registered");
+    }
 
-    /**
-     * Register a plugin.
-     * @name register
-     * @memberof plugin
-     * @see Base
-     * @public
-     * @param {plugin.Base} pluginObj - Plugin object to instantiate and register
-     * @param {string} [name=pluginObj.constructor.name] - a unique name for this plugin
-     * @param {object} [...arguments] - all extra parameters will be passed to the plugin constructor
-     * @example
-     * // register a new plugin
-     * me.plugin.register(TestPlugin, "testPlugin");
-     * // the plugin then also become available
-     * // under then me.plugins namespace
-     * me.plugins.testPlugin.myfunction ();
-     */
-    register : function (pluginObj, name = pluginObj.toString().match(/ (\w+)/)[1]) {
-        // ensure me.plugins[name] is not already "used"
-        if (plugins[name]) {
-            throw new Error("plugin " + name + " already registered");
-        }
+    // get extra arguments
+    let _args = [];
+    if (arguments.length > 2) {
+        // store extra arguments if any
+        _args = Array.prototype.slice.call(arguments, 1);
+    }
 
-        // get extra arguments
-        let _args = [];
-        if (arguments.length > 2) {
-            // store extra arguments if any
-            _args = Array.prototype.slice.call(arguments, 1);
-        }
+    // try to instantiate the plugin
+    _args[0] = plugin;
+    let instance = new (plugin.bind.apply(plugin, _args))();
 
-        // try to instantiate the plugin
-        _args[0] = pluginObj;
-        let instance = new (pluginObj.bind.apply(pluginObj, _args))();
+    // inheritance check
+    if (typeof instance === "undefined" || !(instance instanceof BasePlugin)) {
+        throw new Error("Plugin should extend the BasePlugin Class !");
+    }
 
-        // inheritance check
-        if (typeof instance === "undefined" || !(instance instanceof plugin.Base)) {
-            throw new Error("Plugin should extend the me.plugin.Base Class !");
-        }
+    // compatibility testing
+    if (checkVersion(instance.version, version) > 0) {
+        throw new Error("Plugin version mismatch, expected: " + instance.version + ", got: " + version);
+    }
 
-        // compatibility testing
-        if (utils.checkVersion(instance.version, version) > 0) {
-            throw new Error("Plugin version mismatch, expected: " + instance.version + ", got: " + version);
-        }
+    // create a reference to the new plugin
+    cache[name] = instance;
+}
 
-        // create a reference to the new plugin
-        plugins[name] = instance;
-    }
+var plugin = {
+	__proto__: null,
+	Base: Base,
+	BasePlugin: BasePlugin,
+	cache: cache,
+	patch: patch,
+	register: register
 };
 
 /*
@@ -38241,7 +38266,7 @@ Renderer.prototype.getScreenContext = function()  {
  * @name version
  * @type {string}
  */
-const version = "15.1.6";
+const version = "15.2.1";
 
 /**
  * a flag indicating that melonJS is fully initialized
@@ -38349,7 +38374,7 @@ function boot() {
     emit(BOOT);
 
     // enable/disable the cache
-    setNocache( utils.getUriFragment().nocache || false );
+    setNocache( getUriFragment().nocache || false );
 
     // automatically enable keyboard events
     initKeyboardEvent();
@@ -38370,4 +38395,4 @@ onReady(() => {
     }
 });
 
-export { AUTO$1 as AUTO, Application, BitmapText, BitmapTextData, Body, Bounds, CANVAS$1 as CANVAS, Camera2d, CanvasRenderer, CanvasTexture, Collectable, Color, ColorLayer, Compositor, Container, Draggable, DraggableEntity, DropTarget, DroptargetEntity, Ellipse, Entity, GLShader, GUI_Object, ImageLayer, Light2d, Line, math as Math, Matrix2d, Matrix3d, NineSliceSprite, ObservableVector2d, ObservableVector3d, Particle, ParticleEmitter, ParticleEmitterSettings, Point, Pointer, Polygon, PrimitiveCompositor, QuadCompositor, QuadTree, Rect, Renderable, Renderer, RoundRect, Sprite, Stage, TMXHexagonalRenderer, TMXIsometricRenderer, TMXLayer, TMXOrthogonalRenderer, TMXRenderer, TMXStaggeredRenderer, TMXTileMap, TMXTileset, TMXTilesetGroup, Text, TextureAtlas, Tile, Trigger, Tween, UIBaseElement, UISpriteElement, UITextButton, Vector2d, Vector3d, WEBGL$1 as WEBGL, WebGLRenderer, World, audio, boot, collision, device, event, game, initialized, input, level, loader, plugin, plugins, pool, save, skipAutoInit, state$1 as state, timer$1 as timer, utils, version, video };
+export { AUTO, Application, BitmapText, BitmapTextData, Body, Bounds, CANVAS, Camera2d, CanvasRenderer, CanvasTexture, Collectable, Color, ColorLayer, Compositor, Container, Draggable, DraggableEntity, DropTarget, DroptargetEntity, Ellipse, Entity, GLShader, GUI_Object, ImageLayer, Light2d, Line, math as Math, Matrix2d, Matrix3d, NineSliceSprite, ObservableVector2d, ObservableVector3d, Particle, ParticleEmitter, ParticleEmitterSettings, Point, Pointer, Polygon, PrimitiveCompositor, QuadCompositor, QuadTree, Rect, Renderable, Renderer, RoundRect, Sprite, Stage, TMXHexagonalRenderer, TMXIsometricRenderer, TMXLayer, TMXOrthogonalRenderer, TMXRenderer, TMXStaggeredRenderer, TMXTileMap, TMXTileset, TMXTilesetGroup, TMXUtils, Text, TextureAtlas, Tile, Trigger, Tween, UIBaseElement, UISpriteElement, UITextButton, Vector2d, Vector3d, WEBGL, WebGLRenderer, World, audio, boot, collision, device, event, game, initialized, input, level, loader, plugin, cache as plugins, pool, save, skipAutoInit, state$1 as state, timer$1 as timer, utils, version, video };