melonjs 16.1.3 → 17.1.0

package/dist/melonjs.mjs/loader/parsers/fetchdata.js

@@ -1,17 +1,17 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
  * @copyright (C) 2011 - 2024 Olivier Biot (AltByte Pte Ltd)
  */
-import { nocache } from '../settings.js';
-
 /**
  * Fetches data from the specified URL.
  * @param {string} url - The URL to fetch the data from.
  * @param {string} responseType - The type of response expected ('json', 'text', 'blob', 'arrayBuffer').
+ * @param {Object} [settings] - custom settings to apply to the request (@link https://developer.mozilla.org/en-US/docs/Web/API/fetch#options)
  * @returns {Promise} A promise that resolves with the fetched data or rejects with an error.
+ * @ignore
  * @example
  * fetchData('https://api.example.com/data', 'json')
  *     .then(data => {
@@ -21,15 +21,15 @@ import { nocache } from '../settings.js';
  *         // Handle the error
  *     });
  */
-function fetchData(url, responseType) {
+function fetchData(url, responseType, settings = {}) {
     return new Promise((resolve, reject) => {
         fetch(url, {
             method: "GET",
             // internally nocache is a string with a generated random number
-            cache: nocache === "" ? "no-cache" : "reload",
-            credentials: "omit",
+            cache: settings.nocache === "" ? "no-cache" : "reload",
+            credentials: settings.withCredentials === true ? "include" : "omit",
             // see setting.crossorigin, "anonymous" is used for cross-origin requests
-            mode: "no-cors"
+            mode: settings.crossOrigin === "anonymous" ? "cors" : "no-cors"
         })
             .then(response => {
                 if (!response.ok) {

package/dist/melonjs.mjs/loader/parsers/fontface.js

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

package/dist/melonjs.mjs/loader/parsers/image.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -8,12 +8,14 @@
 import { imgList } from '../cache.js';
 import { fetchData } from './fetchdata.js';
 import { getExtension } from '../../utils/file.js';
+import { parseCompressedImage } from './compressed_textures/compressed_image.js';
 
 /**
  * parse/preload an image
  * @param {loader.Asset} img
  * @param {Function} [onload] - function to be called when the resource is loaded
  * @param {Function} [onerror] - function to be called in case of error
+ * @param {Object} [settings] - Additional settings to be passed when loading the asset
  * @returns {number} the amount of corresponding resource parsed/preloaded
  * @ignore
  * @example
@@ -24,58 +26,104 @@ import { getExtension } from '../../utils/file.js';
  *     { name : 'image4', src : 'images/image4.png'}
  * ]);
  */
-function preloadImage(img, onload, onerror) {
+function preloadImage(img, onload, onerror, settings) {
     if (typeof imgList[img.name] !== "undefined") {
         // already loaded
         return 0;
     }
 
-    // handle SVG file loading
-    if (getExtension(img.src) === "svg") {
-        // handle SVG file
-        fetchData(img.src, "text")
-            .then(svgText => {
-                const svgImage = new Image();
-                svgImage.onload = function() {
-                    imgList[img.name] = svgImage;
-                    if (typeof onload === "function") {
-                        // callback
-                        onload();
-                    }
-                };
-                svgImage.onerror = function(error) {
-                    if (typeof onerror === "function") {
-                        onerror(error);
-                    }
-                };
-                svgImage.src = "data:image/svg+xml;charset=utf8," + encodeURIComponent(svgText);
-            })
-            .catch(error => {
-                if (typeof onerror === "function") {
-                    onerror(error);
-                }
-            });
-    } else {
-        // handle all other image files
-        fetchData(img.src, "blob")
-            .then(blob => {
-                globalThis.createImageBitmap(blob)
-                    .then((bitmap) => {
-                        imgList[img.name] = bitmap;
-                        if (typeof onload === "function") {
-                            // callback
-                            onload();
+    let sources = Array.isArray(img.src) ? img.src : [img.src];
+    let isFormatSupported = false;
+
+    for (const imgPath of sources) {
+        const imgExt = getExtension(imgPath);
+        // loop will stop as soon as a first supported format is detected
+        switch (imgExt) {
+            // Compressed texture
+            case "dds":
+            case "pvr":
+            case "pkm":
+            case "ktx":
+            case "ktx2":
+                fetchData(imgPath, "arrayBuffer", settings)
+                    .then(arrayBuffer => {
+                        try {
+                            imgList[img.name] = parseCompressedImage(arrayBuffer, imgExt);
+                            isFormatSupported = true;
+                            if (typeof onload === "function") {
+                                // callback
+                                onload();
+                            }
+                        } catch (e) {
+                            // parseCompressedImage will throw an error if a format is not supported or badly formatted
+                        }
+                    }).catch(error => {
+                        if (typeof onerror === "function") {
+                            // file cannot be loaded
+                            onerror(error);
+                        }
+                    });
+                break;
+
+            // SVG file
+            case "svg":
+                fetchData(imgPath, "text", settings)
+                    .then(svgText => {
+                        const svgImage = new Image();
+                        svgImage.onload = function() {
+                            imgList[img.name] = svgImage;
+                            if (typeof onload === "function") {
+                                // callback
+                                onload();
+                            }
+                        };
+                        svgImage.onerror = function(error) {
+                            if (typeof onerror === "function") {
+                                onerror(error);
+                            }
+                        };
+                        svgImage.src = "data:image/svg+xml;charset=utf8," + encodeURIComponent(svgText);
+                    })
+                    .catch(error => {
+                        if (typeof onerror === "function") {
+                            onerror(error);
                         }
                     });
-            })
-            .catch(error => {
-                if (typeof onerror === "function") {
-                    onerror(error);
-                }
-            });
+                isFormatSupported = true;
+                break;
+
+            // default is regular images (jpg, png and friends)
+            default:
+                fetchData(imgPath, "blob", settings)
+                    .then(blob => {
+                        globalThis.createImageBitmap(blob)
+                            .then((bitmap) => {
+                                imgList[img.name] = bitmap;
+                                if (typeof onload === "function") {
+                                    // callback
+                                    onload();
+                                }
+                            });
+                    })
+                    .catch(error => {
+                        if (typeof onerror === "function") {
+                            onerror(error);
+                        }
+                    });
+                isFormatSupported = true;
+                break;
+        }
+
+        // exit the loop as soon as the first supported format is detected
+        if (isFormatSupported === true) {
+            return 1;
+        }
     }
 
-    return 1;
+    // no compatible format was found
+    throw new Error(
+        "No suppported Image file format found for " + img.name
+    );
 }
 
 export { preloadImage };

package/dist/melonjs.mjs/loader/parsers/json.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -11,18 +11,19 @@ import { fetchData } from './fetchdata.js';
 /**
  * parse/preload a JSON files
  * @param {loader.Asset} data - asset data
- * @param {Function} [onload] - function to be called when the asset is loaded
+ * @param {Function} [onload] - function to be called when the resource is loaded
  * @param {Function} [onerror] - function to be called in case of error
+ * @param {Object} [settings] - Additional settings to be passed when loading the asset
  * @returns {number} the amount of corresponding resource parsed/preloaded
  * @ignore
  */
-function preloadJSON(data, onload, onerror) {
+function preloadJSON(data, onload, onerror, settings) {
     if (typeof jsonList[data.name] !== "undefined") {
         // already loaded
         return 0;
     }
 
-    fetchData(data.src, "json")
+    fetchData(data.src, "json", settings)
         .then(response => {
             jsonList[data.name] = response;
             if (typeof onload === "function") {

package/dist/melonjs.mjs/loader/parsers/script.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -8,16 +8,20 @@
 /**
  * parse/preload a Javascript files
  * @param {loader.Asset} data - asset data
- * @param {Function} [onload] - function to be called when the asset is loaded
+ * @param {Function} [onload] - function to be called when the resource is loaded
  * @param {Function} [onerror] - function to be called in case of error
+ * @param {Object} [settings] - Additional settings to be passed when loading the asset
  * @returns {number} the amount of corresponding resource parsed/preloaded
  * @ignore
  */
-function preloadJavascript(data, onload, onerror) {
+function preloadJavascript(data, onload, onerror, settings) {
     let script = globalThis.document.createElement("script");
 
     script.src = data.src;
     script.type = "text/javascript";
+    if (typeof (crossOrigin) === "string") {
+        script.crossOrigin = settings.crossOrigin;
+    }
     script.defer = true;
 
     if (typeof onload === "function") {

package/dist/melonjs.mjs/loader/parsers/tmx.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -15,12 +15,13 @@ import { fetchData } from './fetchdata.js';
  * parse/preload a TMX file
  * @param {loader.Asset} data - asset data
  * @param {Function} [onload] - function to be called when the asset is loaded
+ * @param {Function} [onload] - function to be called when the resource is loaded
  * @param {Function} [onerror] - function to be called in case of error
- * @param {Function} [fetchData] - function to use instead of default window.fetch, has some error handling and things
+ * @param {Object} [settings] - Additional settings to be passed when loading the asset
  * @returns {number} the amount of corresponding resource parsed/preloaded
  * @ignore
  */
-function preloadTMX(tmxData, onload, onerror) {
+function preloadTMX(tmxData, onload, onerror, settings) {
     if (typeof tmxList[tmxData.name] !== "undefined") {
         // already loaded
         return 0;
@@ -48,7 +49,7 @@ function preloadTMX(tmxData, onload, onerror) {
         return;
     }
 
-    fetchData(tmxData.src, "text")
+    fetchData(tmxData.src, "text", settings)
         .then(response => {
             if (typeof response !== "string") {
                 throw new Error("Invalid response type");

package/dist/melonjs.mjs/loader/parsers/video.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -9,25 +9,25 @@ import { videoList } from '../cache.js';
 import { fetchData } from './fetchdata.js';
 import { hasVideoFormat } from '../../system/device.js';
 import { getExtension } from '../../utils/file.js';
-import { crossOrigin } from '../settings.js';
 import { isDataUrl } from '../../utils/string.js';
 
 /**
  * parse/preload a Video file
  * @param {loader.Asset} data - asset data
- * @param {Function} [onload] - function to be called when the asset is loaded
+ * @param {Function} [onload] - function to be called when the resource is loaded
  * @param {Function} [onerror] - function to be called in case of error
+ * @param {Object} [settings] - Additional settings to be passed when loading the asset
  * @returns {number} the amount of corresponding resource parsed/preloaded
  * @ignore
  */
-function preloadVideo(data, onload, onerror) {
+function preloadVideo(data, onload, onerror, settings) {
 
     if (typeof videoList[data.name] !== "undefined") {
         // Video already preloaded
         return 0;
     }
 
-    let videoElement = videoList[data.name] = document.createElement("video");
+    let videoElement = videoList[data.name] = globalThis.document.createElement("video");
 
     if (isDataUrl(data.src)) {
         const mimeType = data.src.match(/[^:]\w+\/[\w-+\d.]+(?=;|,)/)[0];
@@ -41,7 +41,7 @@ function preloadVideo(data, onload, onerror) {
     }
 
     if (isDataUrl(data.src)) {
-        fetchData(data.src, "blob")
+        fetchData(data.src, "blob", settings)
             .then(blob => {
                 videoElement.src = globalThis.URL.createObjectURL(blob);
             })
@@ -59,7 +59,7 @@ function preloadVideo(data, onload, onerror) {
     videoElement.setAttribute("playsinline", "true");
     videoElement.setAttribute("disablePictureInPicture", "true");
     videoElement.setAttribute("controls", "false");
-    videoElement.setAttribute("crossorigin", crossOrigin);
+    videoElement.setAttribute("crossorigin", settings.crossOrigin);
 
     if (data.autoplay === true) {
         videoElement.setAttribute("autoplay", "true");

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

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.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 - v16.1.3
+ * melonJS Game Engine - v17.1.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -12,54 +12,42 @@
 
 /**
  * constant to convert from degrees to radians
- * @public
  * @type {number}
- * @name DEG_TO_RAD
  * @memberof Math
  */
 const DEG_TO_RAD = Math.PI / 180.0;
 
 /**
  * constant to convert from radians to degrees
- * @public
  * @type {number}
- * @name RAD_TO_DEG
  * @memberof Math
  */
 const RAD_TO_DEG = 180.0 / Math.PI;
 
 /**
  * constant equals to 2 times pi
- * @public
  * @type {number}
- * @name TAU
  * @memberof Math
  */
 const TAU = Math.PI * 2;
 
 /**
  * constant equals to half pi
- * @public
  * @type {number}
- * @name ETA
  * @memberof Math
  */
 const ETA = Math.PI * 0.5;
 
 /**
  * the difference between 1 and the smallest floating point number greater than 1
- * @public
  * @type {number}
- * @name EPSILON
  * @memberof Math
  */
 const EPSILON = 0.000001;
 
 /**
  * returns true if the given value is a power of two
- * @public
  * @memberof Math
- * @name isPowerOfTwo
  * @param {number} val
  * @returns {boolean}
  */
@@ -67,11 +55,31 @@ function isPowerOfTwo(val) {
     return (val & (val - 1)) === 0;
 }
 
+/**
+ * returns true if the given value is a power of four
+ * @memberof Math
+ * @param {number} val
+ * @returns {boolean}
+ */
+function isPowerOfFour(val) {
+    if (val === 0 || val === 2 || val === 3) {
+        return false;
+    }
+    if (val === 1) {
+        return true;
+    }
+
+    if ((val & (val - 1)) === 0) {
+        if ((val & 0xAAAAAAAA) === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+
 /**
  * returns the next power of two for the given value
- * @public
  * @memberof Math
- * @name nextPowerOfTwo
  * @param {number} val
  * @returns {boolean}
  */
@@ -88,9 +96,7 @@ function nextPowerOfTwo(val) {
 
 /**
  * Converts an angle in degrees to an angle in radians
- * @public
  * @memberof Math
- * @name degToRad
  * @param {number} angle - angle in degrees
  * @returns {number} corresponding angle in radians
  * @example
@@ -103,9 +109,7 @@ function degToRad(angle) {
 
 /**
  * Converts an angle in radians to an angle in degrees.
- * @public
  * @memberof Math
- * @name radToDeg
  * @param {number} radians - angle in radians
  * @returns {number} corresponding angle in degrees
  * @example
@@ -118,9 +122,7 @@ function radToDeg(radians) {
 
 /**
  * clamp the given value
- * @public
  * @memberof Math
- * @name clamp
  * @param {number} val - the value to clamp
  * @param {number} low - lower limit
  * @param {number} high - higher limit
@@ -132,9 +134,7 @@ function clamp(val, low, high) {
 
 /**
  * return a random integer between min (included) and max (excluded)
- * @public
  * @memberof Math
- * @name random
  * @param {number} min - minimum value.
  * @param {number} max - maximum value.
  * @returns {number} random value
@@ -148,9 +148,7 @@ function random(min, max) {
 
 /**
  * return a random float between min, max (exclusive)
- * @public
  * @memberof Math
- * @name randomFloat
  * @param {number} min - minimum value.
  * @param {number} max - maximum value.
  * @returns {number} random value
@@ -164,9 +162,7 @@ function randomFloat(min, max) {
 
 /**
  * return a weighted random between min, max (exclusive)
- * @public
  * @memberof Math
- * @name weightedRandom
  * @param {number} min - minimum value.
  * @param {number} max - maximum value.
  * @returns {number} random value
@@ -180,9 +176,7 @@ function weightedRandom(min, max) {
 
 /**
  * round a value to the specified number of digit
- * @public
  * @memberof Math
- * @name round
  * @param {number} num - value to be rounded.
  * @param {number} [dec=0] - number of decimal digit to be rounded to.
  * @returns {number} rounded value
@@ -198,9 +192,7 @@ function round(num, dec = 0) {
 
 /**
  * check if the given value is close to the expected one
- * @public
  * @memberof Math
- * @name toBeCloseTo
  * @param {number} expected - value to be compared with.
  * @param {number} actual - actual value to compare
  * @param {number} [precision=2] - float precision for the comparison
@@ -218,6 +210,7 @@ function toBeCloseTo(expected, actual, precision = 2) {
 
 /**
  * Calculates the power of a number.
+ * @memberof Math
  * @param {number} n - The number to be raised to the power of 2.
  * @returns {number} The result of raising the number to the power of 2.
  */
@@ -225,4 +218,4 @@ function pow(n) {
     return Math.pow(n, 2);
 }
 
-export { DEG_TO_RAD, EPSILON, ETA, RAD_TO_DEG, TAU, clamp, degToRad, isPowerOfTwo, nextPowerOfTwo, pow, radToDeg, random, randomFloat, round, toBeCloseTo, weightedRandom };
+export { DEG_TO_RAD, EPSILON, ETA, RAD_TO_DEG, TAU, clamp, degToRad, isPowerOfFour, isPowerOfTwo, nextPowerOfTwo, pow, radToDeg, random, randomFloat, round, toBeCloseTo, weightedRandom };

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

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

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

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

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.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/esm/arraymultimap.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.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/esm/multimap.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Game Engine - v16.1.3
+ * melonJS Game Engine - v17.1.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 - v16.1.3
+ * melonJS Game Engine - v17.1.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 - v16.1.3
+ * melonJS Game Engine - v17.1.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 - v16.1.3
+ * melonJS Game Engine - v17.1.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 - v16.1.3
+ * melonJS Game Engine - v17.1.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/semver/classes/comparator.js

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