melonjs 15.1.3 → 15.1.5

package/dist/types/audio/audio.d.ts

@@ -35,7 +35,7 @@ export function hasAudio(): boolean;
  * enable audio output <br>
  * only useful if audio supported and previously disabled through
  * @function audio.enable
- * @see audio#disable
+ * @see audio.disable
  */
 export function enable(): void;
 /**
@@ -159,7 +159,7 @@ export function playTrack(sound_name: string, volume?: number | undefined): numb
 /**
  * stop the current audio track
  * @function audio.stopTrack
- * @see audio#playTrack
+ * @see audio.playTrack
  * @example
  * // play a awesome music
  * me.audio.playTrack("awesome_music");

package/dist/types/const.d.ts

@@ -15,7 +15,7 @@ export const WEBGL: number;
 /**
  * constant to auto-select the renderer (Attempt WebGL first, with fallback to Canvas)
  * @static
- * @type (number)
+ * @type {number}
  * @see Application
  */
-export const AUTO: any;
+export const AUTO: number;

package/dist/types/loader/loader.d.ts

@@ -1,17 +1,22 @@
 /**
- * set all the specified game resources to be preloaded.
- * @name preload
+ * an asset definition to be used with the loader
+ * @typedef {object} loader.Asset
+ * @property {string} name - name of the asset
+ * @property {string} type  - the type of the asset : "audio", binary", "image", "json", "js", "tmx", "tmj", "tsx", "tsj", "fontface"
+ * @property {string} [src]  - path and/or file name of the resource (for audio assets only the path is required)
+ * @property {string} [data]  - TMX data if not provided through a src url
+ * @property {boolean} [stream] - Set to true to force HTML5 Audio, which allows not to wait for large file to be downloaded before playing.
+ * @see loader.preload
+ * @see loader.load
+ */
+/**
+ * set all the specified game assets to be preloaded.
  * @memberof loader
- * @public
- * @param {object[]} res
- * @param {string} res.name - internal name of the resource
- * @param {string} res.type  - "audio", binary", "image", "json","js", "tmx", "tsx", "fontface"
- * @param {string} res.src  - path and/or file name of the resource (for audio assets only the path is required)
- * @param {boolean} [res.stream] - Set to true to force HTML5 Audio, which allows not to wait for large file to be downloaded before playing.
- * @param {Function} [onload=loader.onload] - function to be called when all resources are loaded
+ * @param {loader.Asset[]} assets - list of assets to load
+ * @param {Function} [onloadcb=loader.onload] - function to be called when all resources are loaded
  * @param {boolean} [switchToLoadState=true] - automatically switch to the loading screen
  * @example
- * game_resources = [
+ * game.assets = [
  *   // PNG tileset
  *   {name: "tileset-platformer", type: "image",  src: "data/map/tileset.png"},
  *   // PNG packed texture
@@ -41,24 +46,13 @@
  * ];
  * ...
  * // set all resources to be loaded
- * me.loader.preload(game.resources, () => this.loaded());
+ * me.loader.preload(game.assets, () => this.loaded());
  */
-export function preload(res: {
-    name: string;
-    type: string;
-    src: string;
-    stream?: boolean;
-}, onloadcb: any, switchToLoadState?: boolean | undefined): void;
+export function preload(assets: loader.Asset[], onloadcb?: Function | undefined, switchToLoadState?: boolean | undefined): void;
 /**
- * Load a single resource (to be used if you need to load additional resource during the game)
- * @name load
+ * Load a single asset (to be used if you need to load additional asset(s) during the game)
  * @memberof loader
- * @public
- * @param {object} res
- * @param {string} res.name - internal name of the resource
- * @param {string} res.type  - "audio", binary", "image", "json", "tmx", "tsx"
- * @param {string} res.src  - path and/or file name of the resource (for audio assets only the path is required)
- * @param {boolean} [res.stream] - Set to true to force HTML5 Audio, which allows not to wait for large file to be downloaded before playing.
+ * @param {loader.Asset} asset
  * @param {Function} [onload] - function to be called when the resource is loaded
  * @param {Function} [onerror] - function to be called in case of error
  * @returns {number} the amount of corresponding resource to be preloaded
@@ -76,67 +70,45 @@ export function preload(res: {
  *     me.audio.play("bgmusic");
  * });
  */
-export function load(res: {
-    name: string;
-    type: string;
-    src: string;
-    stream?: boolean | undefined;
-}, onload?: Function | undefined, onerror?: Function | undefined): number;
+export function load(asset: loader.Asset, onload?: Function | undefined, onerror?: Function | undefined): number;
 /**
- * unload specified resource to free memory
- * @name unload
+ * unload the specified asset to free memory
  * @memberof loader
- * @public
- * @param {object} res
- * @param {string} res.name - internal name of the resource
- * @param {string} res.type  - "audio", binary", "image", "json", "tmx", "tsx"
+ * @param {loader.Asset} asset
  * @returns {boolean} true if unloaded
  * @example me.loader.unload({name: "avatar",  type:"image"});
  */
-export function unload(res: {
-    name: string;
-    type: string;
-}): boolean;
+export function unload(asset: loader.Asset): boolean;
 /**
  * unload all resources to free memory
- * @name unloadAll
  * @memberof loader
- * @public
  * @example me.loader.unloadAll();
  */
 export function unloadAll(): void;
 /**
  * return the specified TMX/TSX object
- * @name getTMX
  * @memberof loader
- * @public
  * @param {string} elt - name of the tmx/tsx element ("map1");
  * @returns {object} requested element or null if not found
  */
 export function getTMX(elt: string): object;
 /**
  * return the specified Binary object
- * @name getBinary
  * @memberof loader
- * @public
  * @param {string} elt - name of the binary object ("ymTrack");
  * @returns {object} requested element or null if not found
  */
 export function getBinary(elt: string): object;
 /**
  * return the specified Image Object
- * @name getImage
  * @memberof loader
- * @public
  * @param {string} image - name of the Image element ("tileset-platformer");
  * @returns {HTMLImageElement} requested element or null if not found
  */
 export function getImage(image: string): HTMLImageElement;
 /**
  * return the specified JSON Object
- * @name getJSON
  * @memberof loader
- * @public
  * @param {string} elt - name of the json file to load
  * @returns {object}
  */
@@ -144,23 +116,50 @@ export function getJSON(elt: string): object;
 export * from "./settings.js";
 /**
  * onload callback
- * @name onload
  * @default undefined
  * @memberof loader
+ * @type {function}
  * @example
  * // set a callback when everything is loaded
  * me.loader.onload = this.loaded.bind(this);
  */
-export let onload: any;
+export let onload: Function;
 /**
  * onProgress callback<br>
  * each time a resource is loaded, the loader will fire the specified function,
  * giving the actual progress [0 ... 1], as argument, and an object describing the resource loaded
- * @name onProgress
  * @default undefined
  * @memberof loader
+ * @type {function}
  * @example
  * // set a callback for progress notification
  * me.loader.onProgress = this.updateProgress.bind(this);
  */
-export let onProgress: any;
+export let onProgress: Function;
+export namespace loader {
+    /**
+     * an asset definition to be used with the loader
+     */
+    type Asset = {
+        /**
+         * - name of the asset
+         */
+        name: string;
+        /**
+         * - the type of the asset : "audio", binary", "image", "json", "js", "tmx", "tmj", "tsx", "tsj", "fontface"
+         */
+        type: string;
+        /**
+         * - path and/or file name of the resource (for audio assets only the path is required)
+         */
+        src?: string | undefined;
+        /**
+         * - TMX data if not provided through a src url
+         */
+        data?: string | undefined;
+        /**
+         * - Set to true to force HTML5 Audio, which allows not to wait for large file to be downloaded before playing.
+         */
+        stream?: boolean | undefined;
+    };
+}

package/dist/types/renderable/renderable.d.ts

@@ -205,7 +205,7 @@ export default class Renderable extends Rect {
     };
     _inViewport: boolean;
     /**
-     * Whether the renderable object is floating, or contained in a floating container
+     * Whether the renderable object is floating (i.e. used screen coordinates), or contained in a floating parent container
      * @see Renderable#floating
      * @type {boolean}
      */

package/dist/types/video/video.d.ts

@@ -84,7 +84,7 @@ export const WEBGL: number;
  * @memberof video
  * @static
  */
-export const AUTO: any;
+export const AUTO: number;
 /**
  * A reference to the active Canvas or WebGL active renderer renderer
  * @memberof video

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melonjs",
-  "version": "15.1.3",
+  "version": "15.1.5",
   "description": "melonJS Game Engine",
   "homepage": "http://www.melonjs.org/",
   "type": "module",
@@ -55,11 +55,11 @@
     "@teppeis/multimaps": "^3.0.0",
     "core-js": "^3.30.1",
     "earcut": "2.2.4",
-    "eventemitter3": "^5.0.0",
+    "eventemitter3": "^5.0.1",
     "howler": "2.2.3"
   },
   "devDependencies": {
-    "@babel/eslint-parser": "^7.21.3",
+    "@babel/eslint-parser": "^7.21.8",
     "@babel/plugin-syntax-import-assertions": "^7.20.0",
     "@fastify/static": "^6.10.1",
     "@melonjs/webdoc-theme": "^1.1.1",
@@ -68,18 +68,18 @@
     "@rollup/plugin-node-resolve": "^15.0.2",
     "@rollup/plugin-replace": "^5.0.2",
     "@webdoc/cli": "^2.2.0",
-    "chromedriver": "^112.0.0",
+    "chromedriver": "^112.0.1",
     "cross-env": "^7.0.3",
     "del-cli": "^5.0.0",
     "eslint": "^8.39.0",
-    "eslint-plugin-jsdoc": "^43.0.7",
+    "eslint-plugin-jsdoc": "^43.1.1",
     "expect": "^29.5.0",
     "expect-mocha-image-snapshot": "^3.0.13",
-    "fastify": "^4.15.0",
+    "fastify": "^4.17.0",
     "mocha": "^10.2.0",
     "npm-self-link": "^1.1.7",
-    "puppeteer": "^19.10.1",
-    "rollup": "^3.21.0",
+    "puppeteer": "^20.1.0",
+    "rollup": "^3.21.5",
     "rollup-plugin-bundle-size": "^1.0.3",
     "rollup-plugin-string": "^3.0.0",
     "terser": "^5.17.1",

package/src/audio/audio.js

@@ -123,7 +123,7 @@ export function hasAudio() {
  * enable audio output <br>
  * only useful if audio supported and previously disabled through
  * @function audio.enable
- * @see audio#disable
+ * @see audio.disable
  */
 export function enable() {
     unmuteAll();
@@ -375,7 +375,7 @@ export function playTrack(sound_name, volume) {
 /**
  * stop the current audio track
  * @function audio.stopTrack
- * @see audio#playTrack
+ * @see audio.playTrack
  * @example
  * // play a awesome music
  * me.audio.playTrack("awesome_music");

package/src/const.js

@@ -17,7 +17,7 @@ export const WEBGL = 1;
 /**
  * constant to auto-select the renderer (Attempt WebGL first, with fallback to Canvas)
  * @static
- * @type (number)
+ * @type {number}
  * @see Application
  */
 export const AUTO = 2;

package/src/entity/entity.js

@@ -180,11 +180,8 @@ import Body from "./../physics/body.js";
         }
 
         if (absolute === true) {
-            bounds.centerOn(this.pos.x + bounds.x + bounds.width / 2,  this.pos.y + bounds.y + bounds.height / 2);
-             if (typeof this.ancestor !== "undefined" && typeof this.ancestor.addChild === "function" && this.floating !== true) {
-                 bounds.translate(this.ancestor.getAbsolutePosition());
-             }
-
+            var absPos = this.getAbsolutePosition();
+            bounds.centerOn(absPos.x + bounds.x + bounds.width / 2,  absPos.y + bounds.y + bounds.height / 2);
         }
 
         return bounds;

package/src/geometries/path2d.js

@@ -235,10 +235,10 @@ import earcut from "earcut";
         const cos_rotation = Math.cos(rotation);
         const sin_rotation = Math.sin(rotation);
         for (let j = 0; j < nr_of_interpolation_points; j++) {
-            let _x1 = radiusX * Math.cos(angle);
-            let _y1 = radiusY * Math.sin(angle);
-            let _x2 = x + _x1 * cos_rotation - _y1 * sin_rotation;
-            let _y2 = y + _x1 * sin_rotation + _y1 * cos_rotation;
+            const _x1 = radiusX * Math.cos(angle);
+            const _y1 = radiusY * Math.sin(angle);
+            const _x2 = x + _x1 * cos_rotation - _y1 * sin_rotation;
+            const _y2 = y + _x1 * sin_rotation + _y1 * cos_rotation;
             points.push(pool.pull("Point", _x2, _y2));
             angle += direction * dangle;
         }

package/src/geometries/poly.js

@@ -432,8 +432,8 @@ import pool from "./../system/pooling.js";
 
         //http://www.ecse.rpi.edu/Homepages/wrf/Research/Short_Notes/pnpoly.html
         for (let i = 0, j = len - 1; i < len; j = i++) {
-            let iy = points[i].y + posy, ix = points[i].x + posx,
-                jy = points[j].y + posy, jx = points[j].x + posx;
+            const iy = points[i].y + posy, ix = points[i].x + posx,
+                  jy = points[j].y + posy, jx = points[j].x + posx;
             if (((iy > _y) !== (jy > _y)) && (_x < (jx - ix) * (_y - iy) / (jy - iy) + ix)) {
                 intersects = !intersects;
             }

package/src/input/pointerevent.js

@@ -210,7 +210,7 @@ function enablePointerEvent() {
  */
 function findActiveEvent(activeEventList, eventTypes) {
     for (let i = 0; i < eventTypes.length; i++) {
-        let event = activeEventList.indexOf(eventTypes[i]);
+        const event = activeEventList.indexOf(eventTypes[i]);
         if (event !== -1) {
             return eventTypes[i];
         }
@@ -223,7 +223,7 @@ function findActiveEvent(activeEventList, eventTypes) {
 function findAllActiveEvents(activeEventList, eventTypes) {
     let events = [];
     for (let i = 0; i < eventTypes.length; i++) {
-        let event = activeEventList.indexOf(eventTypes[i]);
+        const event = activeEventList.indexOf(eventTypes[i]);
         if (event !== -1) {
             events.push(eventTypes[i]);
         }
@@ -293,10 +293,10 @@ function dispatchEvent(normalizedEvents) {
 
         for (let c = candidates.length, candidate; c--, (candidate = candidates[c]);) {
             if (eventHandlers.has(candidate) && (candidate.isKinematic !== true)) {
-                let handlers = eventHandlers.get(candidate);
-                let region = handlers.region;
-                let ancestor = region.ancestor;
-                let bounds = region.getBounds();
+                const handlers = eventHandlers.get(candidate);
+                const region = handlers.region;
+                const ancestor = region.ancestor;
+                const bounds = region.getBounds();
                 let eventInBounds = false;
 
                 if (region.isFloating === true) {
@@ -404,7 +404,7 @@ function normalizeEvent(originalEvent) {
     if (device.touchEvent && originalEvent.changedTouches) {
         // iOS/Android Touch event
         for (let i = 0, l = originalEvent.changedTouches.length; i < l; i++) {
-            let touchEvent = originalEvent.changedTouches[i];
+            const touchEvent = originalEvent.changedTouches[i];
             _pointer = T_POINTERS.pop();
             _pointer.setEvent(
                 originalEvent,
@@ -682,7 +682,7 @@ export function registerPointerEvent(eventType, region, callback) {
     // allocate array if not defined
     let handlers = eventHandlers.get(region);
     for (let i = 0; i < eventTypes.length; i++) {
-        eventType = eventTypes[i];
+        const eventType = eventTypes[i];
         if (handlers.callbacks[eventType]) {
             handlers.callbacks[eventType].push(callback);
         } else {
@@ -715,7 +715,7 @@ export function releasePointerEvent(eventType, region, callback) {
     let handlers = eventHandlers.get(region);
     if (typeof (handlers) !== "undefined") {
         for (let i = 0; i < eventTypes.length; i++) {
-            eventType = eventTypes[i];
+            const eventType = eventTypes[i];
             if (handlers.callbacks[eventType]) {
                 if (typeof (callback) !== "undefined") {
                     remove(handlers.callbacks[eventType], callback);

package/src/level/tiled/TMXLayer.js

@@ -42,7 +42,7 @@ function setLayerData(layer, bounds, data) {
     for (let y = 0; y < height; y++) {
         for (let x = 0; x < width; x++) {
             // get the value of the gid
-            let gid = data[idx++];
+            const gid = data[idx++];
             // fill the array
             if (gid !== 0) {
                 // add a new tile to the layer
@@ -61,7 +61,7 @@ function preRenderLayer(layer, renderer) {
     for (let y = 0; y < layer.rows; y++) {
         for (let x = 0; x < layer.cols; x++) {
             // get the value of the gid
-            let tile = layer.layerData[x][y];
+            const tile = layer.layerData[x][y];
             // draw the tile if defined
             if (tile instanceof Tile) {
                 // add a new tile to the layer
@@ -128,7 +128,7 @@ function preRenderLayer(layer, renderer) {
             "height" : 0
         };
         for (let i = 0; i < this.tilesets.length; i++) {
-            let tileset = this.tilesets.getTilesetByIndex(i);
+            const tileset = this.tilesets.getTilesetByIndex(i);
             this.maxTileSize.width = Math.max(this.maxTileSize.width, tileset.tilewidth);
             this.maxTileSize.height = Math.max(this.maxTileSize.height, tileset.tileheight);
         }

package/src/level/tiled/TMXUtils.js

@@ -83,7 +83,7 @@ function parseAttributes(obj, elt) {
     // do attributes
     if (elt.attributes && elt.attributes.length > 0) {
         for (let j = 0; j < elt.attributes.length; j++) {
-            let attribute = elt.attributes.item(j);
+            const attribute = elt.attributes.item(j);
             if (typeof(attribute.name) !== "undefined") {
                 // DOM4 (Attr no longer inherit from Node)
                 obj[attribute.name] = attribute.value;
@@ -282,8 +282,8 @@ export function normalize(obj, item) {
             var points = parse(item).points.split(" ");  // <= "Unexpected lexical declaration in case block" if using let
 
             // And normalize them into an array of vectors
-            for (let i = 0, v; i < points.length; i++) {
-                v = points[i].split(",");
+            for (let i = 0; i < points.length; i++) {
+                const v = points[i].split(",");
                 obj[nodeName].push({
                     "x" : +v[0],
                     "y" : +v[1]

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

@@ -284,7 +284,7 @@ const offsetsStaggerY = [
         let nearest = 0;
         let minDist = Number.MAX_VALUE;
         for (let i = 0; i < 4; ++i) {
-            let dc = this.centers[i].sub(rel).length2();
+            const dc = this.centers[i].sub(rel).length2();
             if (dc < minDist) {
                 minDist = dc;
                 nearest = i;