melonjs 14.2.0 → 14.4.0

package/dist/melonjs.mjs/index.js

@@ -1,34 +1,10 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
-import * as audio from './audio/audio.js';
-export { audio };
-export { default as collision } from './physics/collision.js';
-import { emit, BOOT } from './system/event.js';
-import * as event from './system/event.js';
-export { event };
-import { onReady } from './system/device.js';
-import * as device from './system/device.js';
-export { device };
-export { default as game } from './game.js';
-import loader from './loader/loader.js';
-import * as math from './math/math.js';
-export { math as Math };
-import utils from './utils/utils.js';
-import * as input from './input/input.js';
-export { input };
-export { plugin, plugins } from './plugin/plugin.js';
-import * as video from './video/video.js';
-export { video };
-export { default as save } from './system/save.js';
-export { default as timer } from './system/timer.js';
-import pool from './system/pooling.js';
-export { default as state } from './state/state.js';
-export { default as level } from './level/level.js';
 import Color from './math/color.js';
 import Vector2d from './math/vector2.js';
 import Vector3d from './math/vector3.js';
@@ -54,9 +30,6 @@ export { default as CanvasRenderer } from './video/canvas/canvas_renderer.js';
 import CanvasTexture from './video/texture/canvas_texture.js';
 export { TextureAtlas } from './video/texture/atlas.js';
 import Renderable from './renderable/renderable.js';
-import Text from './text/text.js';
-import BitmapText from './text/bitmaptext.js';
-import BitmapTextData from './text/bitmaptextdata.js';
 import ColorLayer from './renderable/colorlayer.js';
 import ImageLayer from './renderable/imagelayer.js';
 import Sprite from './renderable/sprite.js';
@@ -67,6 +40,9 @@ export { default as UISpriteElement } from './renderable/ui/uispriteelement.js';
 import Collectable from './renderable/collectable.js';
 import Trigger from './renderable/trigger.js';
 import Light2d from './renderable/light2d.js';
+import Text from './text/text.js';
+import BitmapText from './text/bitmaptext.js';
+import BitmapTextData from './text/bitmaptextdata.js';
 export { Draggable, DropTarget } from './renderable/dragndrop.js';
 export { default as TMXRenderer } from './level/tiled/renderer/TMXRenderer.js';
 export { default as TMXOrthogonalRenderer } from './level/tiled/renderer/TMXOrthogonalRenderer.js';
@@ -87,7 +63,32 @@ export { default as ParticleEmitterSettings } from './particles/settings.js';
 export { default as ParticleEmitter } from './particles/emitter.js';
 import Particle from './particles/particle.js';
 import Entity from './entity/entity.js';
-export { DraggableEntity, DroptargetEntity, GUI_Object, warning } from './lang/deprecated.js';
+import Application from './application/application.js';
+import * as audio from './audio/audio.js';
+export { audio };
+export { default as collision } from './physics/collision.js';
+import { emit, BOOT } from './system/event.js';
+import * as event from './system/event.js';
+export { event };
+import { onReady } from './system/device.js';
+import * as device from './system/device.js';
+export { device };
+import loader from './loader/loader.js';
+import * as math from './math/math.js';
+export { math as Math };
+import utils from './utils/utils.js';
+import * as input from './input/input.js';
+export { input };
+export { plugin, plugins } from './plugin/plugin.js';
+import * as video from './video/video.js';
+export { video };
+export { default as save } from './system/save.js';
+export { default as timer } from './system/timer.js';
+import pool from './system/pooling.js';
+export { default as state } from './state/state.js';
+export { default as level } from './level/level.js';
+export { DraggableEntity, DroptargetEntity, GUI_Object } from './lang/deprecated.js';
+export { AUTO, CANVAS, WEBGL } from './const.js';
 import { initKeyboardEvent } from './input/keyboard.js';
 
 // ES5/ES6 polyfills
@@ -100,8 +101,7 @@ import { initKeyboardEvent } from './input/keyboard.js';
  * @name version
  * @type {string}
  */
-const version = "14.2.0";
-
+const version = "14.4.0";
 
 /**
  * a flag indicating that melonJS is fully initialized
@@ -119,6 +119,14 @@ var initialized = false;
  */
 var skipAutoInit = false;
 
+/*
+ * game is a default instance of a melonJS Application and represents your current game,
+ * it contains all the objects, tilemap layers, current viewport, collision map, etc...<br>
+ * @namespace game
+ * @see Application
+ */
+const game = new Application(0, 0, {legacy:true});
+
 /**
  * initialize the melonJS library.
  * this is automatically called unless me.skipAutoInit is set to true,
@@ -133,6 +141,9 @@ function boot() {
         return;
     }
 
+    // output melonJS version in the console
+    console.log("melonJS 2 (v" + version + ") | http://melonjs.org" );
+
     // register all built-ins objects into the object pool
     pool.register("me.Entity", Entity);
     pool.register("me.Collectable", Collectable);
@@ -214,4 +225,4 @@ onReady(() => {
     }
 });
 
-export { BitmapText, BitmapTextData, Bounds, Collectable, Color, ColorLayer, Ellipse, Entity, ImageLayer, Light2d, Line, Matrix2d, Matrix3d, NineSliceSprite, ObservableVector2d, ObservableVector3d, Particle, Point, Polygon, Rect, Renderable, RoundRect, Sprite, Text, Trigger, Tween, Vector2d, Vector3d, boot, initialized, loader, pool, skipAutoInit, utils, version };
+export { Application, BitmapText, BitmapTextData, Bounds, Collectable, Color, ColorLayer, Ellipse, Entity, ImageLayer, Light2d, Line, Matrix2d, Matrix3d, NineSliceSprite, ObservableVector2d, ObservableVector3d, Particle, Point, Polygon, Rect, Renderable, RoundRect, Sprite, Text, Trigger, Tween, Vector2d, Vector3d, boot, game, initialized, loader, pool, skipAutoInit, utils, version };

package/dist/melonjs.mjs/input/gamepad.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { getBindingKey, triggerKeyEvent } from './keyboard.js';
 import { emit, GAMEPAD_CONNECTED, GAMEPAD_DISCONNECTED, on, GAME_BEFORE_UPDATE, GAMEPAD_UPDATE } from '../system/event.js';

package/dist/melonjs.mjs/input/input.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 export { bindPointer, exitPointerLock, globalToLocal, locked, pointer, pointerEventTarget, registerPointerEvent, releaseAllPointerEvents, releasePointerEvent, requestPointerLock, setTouchAction, throttlingInterval, unbindPointer } from './pointerevent.js';
 export { KEY, bindKey, getBindingKey, initKeyboardEvent, isKeyPressed, keyBoardEventTarget, keyStatus, triggerKeyEvent, unbindKey, unlockKey } from './keyboard.js';

package/dist/melonjs.mjs/input/keyboard.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { preventDefault } from './input.js';
 import { emit, KEYDOWN, KEYUP } from '../system/event.js';

package/dist/melonjs.mjs/input/pointer.js

@@ -1,13 +1,13 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import Vector2d from '../math/vector2.js';
 import Bounds from '../physics/bounds.js';
-import game from '../game.js';
+import { game } from '../index.js';
 import { globalToLocal, locked } from './pointerevent.js';
 
 /**

package/dist/melonjs.mjs/input/pointerevent.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { preventDefault } from './input.js';
 import { getBindingKey, triggerKeyEvent } from './keyboard.js';
@@ -16,7 +16,7 @@ import pool from '../system/pooling.js';
 import { getElementBounds, hasPointerLockSupport, maxTouchPoints, pointerEvent, touch, focus, touchEvent } from '../system/device.js';
 import Pointer from './pointer.js';
 import Rect from '../geometries/rectangle.js';
-import game from '../game.js';
+import { game } from '../index.js';
 
 /**
  * A pool of `Pointer` objects to cache pointer/touch event coordinates.

package/dist/melonjs.mjs/lang/console.js

@@ -0,0 +1,44 @@
+/*!
+ * melonJS Game Engine - v14.4.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)
+ */
+/**
+ * display a deprecation warning in the console
+ * @param {string} deprecated - deprecated class,function or property name
+ * @param {string} replacement - the replacement class, function, or property name
+ * @param {string} version - the version since when the lass,function or property is deprecated
+ */
+function warning(deprecated, replacement, version) {
+    var msg = "melonJS: %s is deprecated since version %s, please use %s";
+    var stack = new Error().stack;
+
+    if (console.groupCollapsed) {
+        console.groupCollapsed(
+            "%c" + msg,
+            "font-weight:normal;color:yellow;",
+            deprecated,
+            version,
+            replacement
+        );
+    } else {
+        console.warn(
+            msg,
+            deprecated,
+            version,
+            replacement
+        );
+    }
+
+    if (typeof stack !== "undefined") {
+        console.warn(stack);
+    }
+
+    if (console.groupCollapsed) {
+        console.groupEnd();
+    }
+}
+
+export { warning };

package/dist/melonjs.mjs/lang/deprecated.js

@@ -1,56 +1,20 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { TextureAtlas } from '../video/texture/atlas.js';
 import Renderer from '../video/renderer.js';
 import { Draggable, DropTarget } from '../renderable/dragndrop.js';
 import UISpriteElement from '../renderable/ui/uispriteelement.js';
+import { warning } from './console.js';
 
 /*
  * placeholder for all deprecated classes and corresponding alias for backward compatibility
  */
 
-/**
- * display a deprecation warning in the console
- * @ignore
- * @param {string} deprecated - deprecated class,function or property name
- * @param {string} replacement - the replacement class, function, or property name
- * @param {string} version - the version since when the lass,function or property is deprecated
- */
-function warning(deprecated, replacement, version) {
-    var msg = "melonJS: %s is deprecated since version %s, please use %s";
-    var stack = new Error().stack;
-
-    if (console.groupCollapsed) {
-        console.groupCollapsed(
-            "%c" + msg,
-            "font-weight:normal;color:yellow;",
-            deprecated,
-            version,
-            replacement
-        );
-    } else {
-        console.warn(
-            msg,
-            deprecated,
-            version,
-            replacement
-        );
-    }
-
-    if (typeof stack !== "undefined") {
-        console.warn(stack);
-    }
-
-    if (console.groupCollapsed) {
-        console.groupEnd();
-    }
-}
-
 /**
  * Alias of {@link TextureAtlas}
  * @public
@@ -154,4 +118,4 @@ Renderer.prototype.getScreenContext = function()  {
     }
 }
 
-export { DraggableEntity, DroptargetEntity, GUI_Object, warning };
+export { DraggableEntity, DroptargetEntity, GUI_Object };

package/dist/melonjs.mjs/level/level.js

@@ -1,15 +1,15 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import utils from '../utils/utils.js';
 import { emit, LEVEL_LOADED } from '../system/event.js';
 import state from '../state/state.js';
 import loader from '../loader/loader.js';
-import game from '../game.js';
+import { game } from '../index.js';
 import TMXTileMap from './tiled/TMXTileMap.js';
 
 // our levels

package/dist/melonjs.mjs/level/tiled/TMXGroup.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { applyTMXProperties } from './TMXUtils.js';
 import TMXObject from './TMXObject.js';
@@ -22,66 +22,45 @@ class TMXGroup {
 
         /**
          * group name
-         * @public
          * @type {string}
-         * @name name
-         * @memberof TMXGroup
          */
         this.name = data.name;
 
         /**
          * group width
-         * @public
          * @type {number}
-         * @name width
-         * @memberof TMXGroup
          */
         this.width = data.width || 0;
 
         /**
          * group height
-         * @public
          * @type {number}
-         * @name height
-         * @memberof TMXGroup
          */
         this.height = data.height || 0;
 
         /**
          * tint color
-         * @public
          * @type {string}
-         * @name tintcolor
-         * @memberof TMXGroup
          */
         this.tintcolor = data.tintcolor;
 
 
         /**
          * the group class
-         * @public
          * @type {string}
-         * @name class
-         * @memberof TMXGroup
          */
         this.class = data.class;
 
         /**
          * group z order
-         * @public
          * @type {number}
-         * @name z
-         * @memberof TMXGroup
          */
         this.z = z;
 
         /**
          * group objects list definition
          * @see TMXObject
-         * @public
          * @type {object[]}
-         * @name name
-         * @memberof TMXGroup
          */
         this.objects = [];
 

package/dist/melonjs.mjs/level/tiled/TMXLayer.js

@@ -1,9 +1,9 @@
 /*!
- * melonJS Game Engine - v14.2.0
+ * melonJS Game Engine - v14.4.0
  * http://www.melonjs.org
  * melonjs is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
- * @copyright (C) 2011 - 2022 Olivier Biot (AltByte Pte Ltd)
+ * @copyright (C) 2011 - 2023 Olivier Biot (AltByte Pte Ltd)
  */
 import { createCanvas } from '../../video/video.js';
 import pool from '../../system/pooling.js';
@@ -11,40 +11,49 @@ import { applyTMXProperties, decode } from './TMXUtils.js';
 import Tile from './TMXTile.js';
 import Renderable from '../../renderable/renderable.js';
 import CanvasRenderer from '../../video/canvas/canvas_renderer.js';
-import game from '../../game.js';
+import { game } from '../../index.js';
 
 /**
  * Create required arrays for the given layer object
  * @ignore
  */
-function initArray(layer) {
+function initArray(rows, cols) {
     // initialize the array
-    layer.layerData = new Array(layer.cols);
-    for (var x = 0; x < layer.cols; x++) {
-        layer.layerData[x] = new Array(layer.rows);
-        for (var y = 0; y < layer.rows; y++) {
-            layer.layerData[x][y] = null;
+    var array = new Array(cols);
+    for (var col = 0; col < cols; col++) {
+        array[col] = new Array(rows);
+        for (var row = 0; row < rows; row++) {
+            array[col][row] = null;
         }
     }
+    return array;
 }
 
 /**
  * Set a tiled layer Data
  * @ignore
  */
-function setLayerData(layer, data) {
+function setLayerData(layer, bounds, data) {
     var idx = 0;
-    // initialize the data array
-    initArray(layer);
+    var width, height;
+
+    // layer provide rows and cols, chunk width and height
+    if (typeof bounds.rows === "undefined") {
+        width = bounds.width;
+        height = bounds.height;
+    } else {
+        width = bounds.cols;
+        height = bounds.rows;
+    }
     // set everything
-    for (var y = 0; y < layer.rows; y++) {
-        for (var x = 0; x < layer.cols; x++) {
+    for (var y = 0; y < height; y++) {
+        for (var x = 0; x < width; x++) {
             // get the value of the gid
             var gid = data[idx++];
             // fill the array
             if (gid !== 0) {
                 // add a new tile to the layer
-                layer.layerData[x][y] = layer.getTileById(gid, x, y);
+                layer.layerData[x + bounds.x][y + bounds.y] = layer.getTileById(gid, x + bounds.x, y + bounds.y);
             }
         }
     }
@@ -96,11 +105,23 @@ function preRenderLayer(layer, renderer) {
         // layer orientation
         this.orientation = orientation;
 
+        /**
+         * Horizontal layer offset in tiles
+         * @default 0
+         * @type {number}
+         */
+        this.x = 0;
+
+        /**
+         * Vertical layer offset in tiles
+         * @default 0
+         * @type {number}
+         */
+        this.y = 0;
+
         /**
          * The Layer corresponding Tilesets
-         * @public
          * @type {TMXTilesetGroup}
-         * @name TMXLayer#tilesets
          */
         this.tilesets = tilesets;
 
@@ -121,36 +142,27 @@ function preRenderLayer(layer, renderer) {
 
         /**
          * All animated tilesets in this layer
-         * @ignore
          * @type {TMXTileset[]}
-         * @name TMXLayer#animatedTilesets
          */
         this.animatedTilesets = [];
 
         /**
          * Layer contains tileset animations
-         * @public
          * @type {boolean}
-         * @name TMXLayer#isAnimated
          */
         this.isAnimated = false;
 
         /**
          * the order in which tiles on orthogonal tile layers are rendered.
          * (valid values are "left-down", "left-up", "right-down", "right-up")
-         * @public
          * @type {string}
          * @default "right-down"
-         * @name TMXLayer#renderorder
          */
         this.renderorder = data.renderorder || "right-down";
 
         /**
          * the layer class
-         * @public
          * @type {string}
-         * @name class
-         * @name TMXLayer#class
          */
         this.class = data.class;
 
@@ -196,14 +208,36 @@ function preRenderLayer(layer, renderer) {
         this.setRenderer(map.getRenderer());
 
 
-        // initialize and set the layer data
-        setLayerData(this,
-            decode(
-                data.data,
-                data.encoding,
-                data.compression
-            )
-        );
+        // initialize the data array
+        this.layerData = initArray(this.rows, this.cols);
+
+        if (map.infinite === 0) {
+            // initialize and set the layer data
+            setLayerData(
+                this,
+                this,
+                decode(
+                    data.data,
+                    data.encoding,
+                    data.compression
+                )
+            );
+        } else if (map.infinite === 1) {
+            // infinite map, initialize per chunk
+            data.chunks.forEach((chunk) => {
+                // initialize and set the layer data
+                setLayerData(
+                    this,
+                    chunk,
+                    decode(
+                        chunk.data,
+                        data.encoding,
+                        data.compression
+                    )
+                );
+            });
+        }
+
     }
 
 
@@ -255,9 +289,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Set the TMX renderer for this layer object
-     * @name setRenderer
-     * @memberof TMXLayer
-     * @public
      * @param {TMXRenderer} renderer
      * @example
      * // use the parent map default renderer
@@ -270,9 +301,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the layer current renderer object
-     * @name getRenderer
-     * @memberof TMXLayer
-     * @public
      * @returns {TMXRenderer} renderer
      */
     getRenderer() {
@@ -282,9 +310,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the TileId of the Tile at the specified position
-     * @name getTileId
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - X coordinate (in world/pixels coordinates)
      * @param {number} y - Y coordinate (in world/pixels coordinates)
      * @returns {number} TileId or null if there is no Tile at the given position
@@ -296,9 +321,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the Tile object at the specified position
-     * @name getTile
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - X coordinate (in world/pixels coordinates)
      * @param {number} y - Y coordinate (in world/pixels coordinates)
      * @returns {Tile} corresponding tile or null if there is no defined tile at the coordinate or if outside of the layer bounds
@@ -321,9 +343,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * assign the given Tile object to the specified position
-     * @name getTile
-     * @memberof TMXLayer
-     * @public
      * @param {Tile} tile - the tile object to be assigned
      * @param {number} x - x coordinate (in world/pixels coordinates)
      * @param {number} y - y coordinate (in world/pixels coordinates)
@@ -336,9 +355,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * return a new the Tile object corresponding to the given tile id
-     * @name setTile
-     * @memberof TMXLayer
-     * @public
      * @param {number} tileId - tileId
      * @param {number} x - X coordinate (in world/pixels coordinates)
      * @param {number} y - Y coordinate (in world/pixels coordinates)
@@ -354,9 +370,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * Return the Tile object at the specified tile coordinates
-     * @name cellAt
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - x position of the tile (in Tile unit)
      * @param {number} y - x position of the tile (in Tile unit)
      * @param {number} [boundsCheck=true] - check first if within the layer bounds
@@ -380,9 +393,6 @@ function preRenderLayer(layer, renderer) {
 
     /**
      * clear the tile at the specified position
-     * @name clearTile
-     * @memberof TMXLayer
-     * @public
      * @param {number} x - X coordinate (in map coordinates: row/column)
      * @param {number} y - Y coordinate (in map coordinates: row/column)
      * @example