melonjs 14.1.2 → 14.3.0

package/README.md

@@ -3,7 +3,6 @@ melonJS 2
 ![melonJS Logo](https://github.com/melonjs/melonJS/raw/master/media/Banner/Banner%20-%20Billboard%20-%20Original%20Logo%20-%20horizontal.png)
 
 [![Build Status](https://travis-ci.org/melonjs/melonJS.svg)](https://travis-ci.org/melonjs/melonJS)
-[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/melonjs/melonJS.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/melonjs/melonJS/context:javascript)
 [![Build Size](https://badgen.net/bundlephobia/min/melonjs)](https://bundlephobia.com/result?p=melonjs)
 [![NPM Package](https://img.shields.io/npm/v/melonjs)](https://www.npmjs.com/package/melonjs)
 [![jsDeliver](https://data.jsdelivr.com/v1/package/npm/melonjs/badge?style=rounded)](https://www.jsdelivr.com/package/npm/melonjs)
@@ -107,7 +106,7 @@ A few demos of melonJS capabilities :
 * [Platformer Demo](https://melonjs.github.io/examples/platformer/)
 * [Isometric Demo](https://melonjs.github.io/examples/isometric_rpg/)
 * [Sprite Demo](https://melonjs.github.io/examples/sprite/)
-* [Masking Demo](https://melonjs.github.io/examples/masking/)
+* [Masking Demo](https://melonjs.github.io/examples/masking/) (WARNING: may potentially trigger seizures for people with photosensitive epilepsy)
 * [Primitive Drawing Demo](https://melonjs.github.io/examples/graphics/)
 * [UI Demo](https://melonjs.github.io/examples/UI/)
 
@@ -178,10 +177,10 @@ Or can simply be added to your html, using [jsDeliver](https://www.jsdelivr.com/
 
 ```html
 <!-- load the ES6 module bundle of melonJS v10.0 -->
-<script src="https://esm.run/melonjs@10.0"></script>
+<script type="module" src="https://esm.run/melonjs@10.0"></script>
 <!-- omit the version completely to get the latest one -->
 <!-- you should NOT use this in production -->
-<script src="https://esm.run/melonjs"></script>
+<script type="module" src="https://esm.run/melonjs"></script>
 ```
 > Note: starting from the 10.0.0 version, the debug plugin is no longer provided as part of the melonJS library release, and has been moved to the official [boilerplate](https://github.com/melonjs/es6-boilerplate)
 

package/dist/melonjs.mjs/_virtual/_commonjsHelpers.js

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

package/dist/melonjs.mjs/_virtual/arraymultimap.js

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

package/dist/melonjs.mjs/_virtual/earcut.js

@@ -1,10 +1,14 @@
 /*!
- * melonJS Game Engine - v14.1.2
+ * melonJS Game Engine - v14.3.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)
  */
-var earcut = {exports: {}};
+var earcutExports = {};
+var earcut = {
+  get exports(){ return earcutExports; },
+  set exports(v){ earcutExports = v; },
+};
 
-export { earcut as e };
+export { earcut as __module, earcutExports as exports };

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

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

package/dist/melonjs.mjs/_virtual/index.js

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

package/dist/melonjs.mjs/_virtual/index2.js

@@ -1,10 +1,14 @@
 /*!
- * melonJS Game Engine - v14.1.2
+ * melonJS Game Engine - v14.3.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)
  */
-var eventemitter3 = {exports: {}};
+var eventemitter3Exports = {};
+var eventemitter3 = {
+  get exports(){ return eventemitter3Exports; },
+  set exports(v){ eventemitter3Exports = v; },
+};
 
-export { eventemitter3 as e };
+export { eventemitter3 as __module, eventemitter3Exports as exports };

package/dist/melonjs.mjs/_virtual/make-built-in.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var makeBuiltIn = {exports: {}};
+
+export { makeBuiltIn as m };

package/dist/melonjs.mjs/_virtual/multimap.js

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

package/dist/melonjs.mjs/_virtual/object-define-property.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var objectDefineProperty = {};
+
+export { objectDefineProperty as __exports };

package/dist/melonjs.mjs/_virtual/object-get-own-property-descriptor.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var objectGetOwnPropertyDescriptor = {};
+
+export { objectGetOwnPropertyDescriptor as __exports };

package/dist/melonjs.mjs/_virtual/object-get-own-property-names.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var objectGetOwnPropertyNames = {};
+
+export { objectGetOwnPropertyNames as __exports };

package/dist/melonjs.mjs/_virtual/object-get-own-property-symbols.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var objectGetOwnPropertySymbols = {};
+
+export { objectGetOwnPropertySymbols as __exports };

package/dist/melonjs.mjs/_virtual/object-property-is-enumerable.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var objectPropertyIsEnumerable = {};
+
+export { objectPropertyIsEnumerable as __exports };

package/dist/melonjs.mjs/_virtual/setmultimap.js

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

package/dist/melonjs.mjs/_virtual/shared.js

@@ -0,0 +1,10 @@
+/*!
+ * melonJS Game Engine - v14.1.3
+ * 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)
+ */
+var shared = {exports: {}};
+
+export { shared as s };

package/dist/melonjs.mjs/application/application.js

@@ -1,15 +1,39 @@
 /*!
- * melonJS Game Engine - v14.1.2
+ * melonJS Game Engine - v14.3.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)
  */
-import { renderer } from '../video/video.js';
-import { emit, GAME_INIT, GAME_RESET, GAME_BEFORE_UPDATE, GAME_UPDATE, GAME_AFTER_UPDATE, GAME_BEFORE_DRAW, GAME_AFTER_DRAW } from '../system/event.js';
+import { autoDetectRenderer } from '../video/utils/autodetect.js';
+import CanvasRenderer from '../video/canvas/canvas_renderer.js';
+import { getElement, platform, enableSwipe } from '../system/device.js';
+import { on, emit, GAME_AFTER_UPDATE, GAME_BEFORE_DRAW, GAME_AFTER_DRAW, WINDOW_ONRESIZE, WINDOW_ONORIENTATION_CHANGE, GAME_INIT, GAME_RESET, GAME_BEFORE_UPDATE, GAME_UPDATE } from '../system/event.js';
+import utils from '../utils/utils.js';
 import timer from '../system/timer.js';
 import state from '../state/state.js';
 import World from '../physics/world.js';
+import { onresize } from './resize.js';
+import { defaultSettings } from './settings.js';
+import { consoleHeader } from './header.js';
+
+/**
+ * Select the HTML5 Canvas renderer
+ * @constant
+ */
+const CANVAS = 0;
+
+/**
+ * Select the WebGL renderer
+ * @constant
+ */
+const WEBGL = 1;
+
+/**
+ * Auto-select the renderer (Attempt WebGL first, with fallback to Canvas)
+ * @constant
+ */
+const AUTO = 2;
 
 /**
  * @classdesc
@@ -18,10 +42,37 @@ import World from '../physics/world.js';
  * @see game
  */
  class Application {
-    constructor() {
+    /**
+     * @param {number} width - The width of the canvas viewport
+     * @param {number} height - The height of the canvas viewport
+     * @param {object} [options] - The optional video/renderer parameters.<br> (see Renderer(s) documentation for further specific options)
+     * @param {string|HTMLElement} [options.parent=document.body] - the DOM parent element to hold the canvas in the HTML file
+     * @param {number|Renderer} [options.renderer=video.AUTO] - renderer to use (me.video.CANVAS, me.video.WEBGL, me.video.AUTO), or a custom renderer class
+     * @param {number|string} [options.scale=1.0] - enable scaling of the canvas ('auto' for automatic scaling)
+     * @param {string} [options.scaleMethod="fit"] - screen scaling modes ('fit','fill-min','fill-max','flex','flex-width','flex-height','stretch')
+     * @param {boolean} [options.preferWebGL1=false] - if true the renderer will only use WebGL 1
+     * @param {string} [options.powerPreference="default"] - a hint to the user agent indicating what configuration of GPU is suitable for the WebGL context ("default", "high-performance", "low-power"). To be noted that Safari and Chrome (since version 80) both default to "low-power" to save battery life and improve the user experience on these dual-GPU machines.
+     * @param {boolean} [options.transparent=false] - whether to allow transparent pixels in the front buffer (screen).
+     * @param {boolean} [options.antiAlias=false] - whether to enable or not video scaling interpolation
+     * @param {boolean} [options.consoleHeader=true] - whether to display melonJS version and basic device information in the console
+     * @throws Will throw an exception if it fails to instantiate a renderer
+     */
+    constructor(width, height, options) {
+
+        /**
+         * the parent HTML element holding the main canvas of this application
+         * @type {HTMLElement}
+         */
+        this.parentElement = undefined;
+
         /**
-         * a reference to the current active stage "default" camera
-         * @public
+         * a reference to the active Canvas or WebGL active renderer renderer
+         * @type {CanvasRenderer|WebGLRenderer}
+         */
+        this.renderer = undefined;
+
+        /**
+         * the active stage "default" camera
          * @type {Camera2d}
          */
         this.viewport = undefined;
@@ -29,7 +80,6 @@ import World from '../physics/world.js';
         /**
          * a reference to the game world, <br>
          * a world is a virtual environment containing all the game objects
-         * @public
          * @type {World}
          */
         this.world = undefined;
@@ -37,7 +87,6 @@ import World from '../physics/world.js';
         /**
          * when true, all objects will be added under the root world container.<br>
          * When false, a `me.Container` object will be created for each corresponding groups
-         * @public
          * @type {boolean}
          * @default true
          */
@@ -46,7 +95,6 @@ import World from '../physics/world.js';
         /**
          * Specify the property to be used when sorting renderables.
          * Accepted values : "x", "y", "z"
-         * @public
          * @type {string}
          * @default "z"
          */
@@ -57,13 +105,23 @@ import World from '../physics/world.js';
          * Use this value to implement frame prediction in drawing events,
          * for creating smooth motion while running game update logic at
          * a lower fps.
-         * @public
          * @type {DOMHighResTimeStamp}
-         * @name lastUpdate
-         * @memberof Application
          */
         this.lastUpdate = 0;
 
+        /**
+         * true when this app instance has been initialized
+         * @type {boolean}
+         * @default false
+         */
+        this.isInitialized = false;
+
+        /**
+         * the given settings used when creating this application
+         * @type {Object}
+         */
+        this.settings = undefined;
+
         // to know when we have to refresh the display
         this.isDirty = true;
 
@@ -85,17 +143,111 @@ import World from '../physics/world.js';
         this.updateDelta = 0;
         this.lastUpdateStart = null;
         this.updateAverageDelta = 0;
+
+        // when using the default game application, legacy is set to true
+        // and init is called through the legacy video.init() call
+        if (options.legacy !== true) {
+            this.init(width, height, options);
+        }
     }
 
     /**
      * init the game instance (create a physic world, update starting time, etc..)
      */
-    init() {
+    init(width, height, options) {
+
+        this.settings = Object.assign(defaultSettings, options || {});
+
+        // sanitize potential given parameters
+        this.settings.width = width;
+        this.settings.height = height;
+        this.settings.transparent = !!(this.settings.transparent);
+        this.settings.antiAlias = !!(this.settings.antiAlias);
+        this.settings.failIfMajorPerformanceCaveat = !!(this.settings.failIfMajorPerformanceCaveat);
+        this.settings.subPixel = !!(this.settings.subPixel);
+        this.settings.verbose = !!(this.settings.verbose);
+        if (this.settings.scaleMethod.search(/^(fill-(min|max)|fit|flex(-(width|height))?|stretch)$/) !== -1) {
+            this.settings.autoScale = (this.settings.scale === "auto") || true;
+        } else {
+            // default scaling method
+            this.settings.scaleMethod = "fit";
+            this.settings.autoScale = (this.settings.scale === "auto") || false;
+        }
+
+        // override renderer settings if &webgl or &canvas is defined in the URL
+        var uriFragment = utils.getUriFragment();
+        if (uriFragment.webgl === true || uriFragment.webgl1 === true || uriFragment.webgl2 === true) {
+            this.settings.renderer = WEBGL;
+            if (uriFragment.webgl1 === true) {
+                this.settings.preferWebGL1 = true;
+            }
+        } else if (uriFragment.canvas === true) {
+            this.settings.renderer = CANVAS;
+        }
+
+        // normalize scale
+        this.settings.scale = (this.settings.autoScale) ? 1.0 : (+this.settings.scale || 1.0);
+
+        // default scaled size value
+        this.settings.zoomX = width * this.settings.scale;
+        this.settings.zoomY = height * this.settings.scale;
+
+        if (typeof this.settings.renderer === "number") {
+            switch (this.settings.renderer) {
+                case AUTO:
+                case WEBGL:
+                    this.renderer = autoDetectRenderer(this.settings);
+                    break;
+                default:
+                    this.renderer = new CanvasRenderer(this.settings);
+                    break;
+            }
+        } else {
+            var CustomRenderer = this.settings.renderer;
+            // a renderer class
+            this.renderer = new CustomRenderer(this.settings);
+        }
+
+        // register to the channel
+        on(WINDOW_ONRESIZE, () => { onresize(this); }, this);
+        on(WINDOW_ONORIENTATION_CHANGE, () => { onresize(this); }, this);
+
+        // add our canvas (default to document.body if settings.parent is undefined)
+        this.parentElement = getElement(this.settings.parent);
+        this.parentElement.appendChild(this.renderer.getCanvas());
+
+        // Mobile browser hacks
+        if (platform.isMobile) {
+            // Prevent the webview from moving on a swipe
+            enableSwipe(false);
+        }
+
+        // trigger an initial resize();
+        onresize(this);
+
+        // add an observer to detect when the dom tree is modified
+        if ("MutationObserver" in globalThis) {
+            // Create an observer instance linked to the callback function
+            var observer = new MutationObserver(onresize.bind(this, this));
+
+            // Start observing the target node for configured mutations
+            observer.observe(this.parentElement, {
+                attributes: false, childList: true, subtree: true
+            });
+        }
+
+        if (this.settings.consoleHeader !== false) {
+            consoleHeader(this);
+        }
+
         // create a new physic world
         this.world = new World();
         // set the reference to this application instance
         this.world.app = this;
         this.lastUpdate = globalThis.performance.now();
+
+        this.isInitialized = true;
+
         emit(GAME_INIT, this);
     }
 
@@ -147,12 +299,11 @@ import World from '../physics/world.js';
     }
 
     /**
-     * Returns the parent container of the specified Child in the game world
-     * @param {Renderable} child
-     * @returns {Container}
+     * Returns the parent HTML Element holding the main canvas of this application
+     * @returns {HTMLElement}
      */
-    getParentContainer(child) {
-        return child.ancestor;
+    getParentElement() {
+        return this.parentElement;
     }
 
     /**
@@ -213,21 +364,21 @@ import World from '../physics/world.js';
      * @param {Stage} stage - the current stage
      */
     draw(stage) {
-        if (renderer.isContextValid === true && (this.isDirty || this.isAlwaysDirty)) {
+        if (this.renderer.isContextValid === true && (this.isDirty || this.isAlwaysDirty)) {
             // publish notification
             emit(GAME_BEFORE_DRAW, globalThis.performance.now());
 
             // prepare renderer to draw a new frame
-            renderer.clear();
+            this.renderer.clear();
 
             // render the stage
-            stage.draw(renderer);
+            stage.draw(this.renderer);
 
             // set back to flag
             this.isDirty = false;
 
             // flush/render our frame
-            renderer.flush();
+            this.renderer.flush();
 
             // publish notification
             emit(GAME_AFTER_DRAW, globalThis.performance.now());

package/dist/melonjs.mjs/application/header.js

@@ -0,0 +1,34 @@
+/*!
+ * melonJS Game Engine - v14.3.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)
+ */
+import { devicePixelRatio, platform, getScreenOrientation, language, hasWebAudio } from '../system/device.js';
+
+/**
+ * display information
+ * @param {Application} game - the game application instance calling this function
+ */
+function consoleHeader(app) {
+    var renderType = app.renderer.type;
+    var gpu_renderer = (typeof app.renderer.GPURenderer === "string") ? " (" + app.renderer.GPURenderer + ")" : "";
+    var audioType = hasWebAudio ? "Web Audio" : "HTML5 Audio";
+
+    // output video information in the console
+    console.log(
+        renderType + " renderer" + gpu_renderer + " | " +
+        audioType + " | " +
+        "pixel ratio " + devicePixelRatio + " | " +
+        (platform.nodeJS ? "node.js" : platform.isMobile ? "mobile" : "desktop") + " | " +
+        getScreenOrientation() + " | " +
+        language
+    );
+
+    console.log( "resolution: " + "requested " + app.settings.width + "x" + app.settings.height +
+        ", got " + app.renderer.getWidth() + "x" + app.renderer.getHeight()
+    );
+}
+
+export { consoleHeader };

package/dist/melonjs.mjs/application/resize.js

@@ -0,0 +1,119 @@
+/*!
+ * melonJS Game Engine - v14.3.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)
+ */
+import { getParentBounds, devicePixelRatio } from '../system/device.js';
+
+/**
+ * scale the "displayed" canvas by the given scalar.
+ * this will modify the size of canvas element directly.
+ * Only use this if you are not using the automatic scaling feature.
+ * @param {Application} game - the game application instance triggering the resize
+ * @param {number} x - x scaling multiplier
+ * @param {number} y - y scaling multiplier
+ */
+function scale(game, x, y) {
+    var renderer = game.renderer;
+    var canvas = renderer.getCanvas();
+    var context = renderer.getContext();
+    var settings = renderer.settings;
+    var pixelRatio = devicePixelRatio;
+
+    var w = settings.zoomX = canvas.width * x * pixelRatio;
+    var h = settings.zoomY = canvas.height * y * pixelRatio;
+
+    // update the global scale variable
+    renderer.scaleRatio.set(x * pixelRatio, y * pixelRatio);
+
+    // adjust CSS style based on device pixel ratio
+    canvas.style.width = (w / pixelRatio) + "px";
+    canvas.style.height = (h / pixelRatio) + "px";
+
+    // if anti-alias and blend mode were resetted (e.g. Canvas mode)
+    renderer.setAntiAlias(context, settings.antiAlias);
+    renderer.setBlendMode(settings.blendMode, context);
+
+    // force repaint
+    game.repaint();
+}
+
+/**
+ * callback for window resize event
+ * @param {Application} game - the game application instance triggering the resize
+ */
+function onresize(game) {
+    var renderer = game.renderer;
+    var settings = renderer.settings;
+    var scaleX = 1, scaleY = 1;
+
+    if (settings.autoScale) {
+
+        // set max the canvas max size if CSS values are defined
+        var canvasMaxWidth = Infinity;
+        var canvasMaxHeight = Infinity;
+
+        if (globalThis.getComputedStyle) {
+            var style = globalThis.getComputedStyle(renderer.getCanvas(), null);
+            canvasMaxWidth = parseInt(style.maxWidth, 10) || Infinity;
+            canvasMaxHeight = parseInt(style.maxHeight, 10) || Infinity;
+        }
+
+        // get the maximum canvas size within the parent div containing the canvas container
+        var nodeBounds = getParentBounds(game.getParentElement());
+
+        var _max_width = Math.min(canvasMaxWidth, nodeBounds.width);
+        var _max_height = Math.min(canvasMaxHeight, nodeBounds.height);
+
+        // calculate final canvas width & height
+        var screenRatio = _max_width / _max_height;
+
+        if ((settings.scaleMethod === "fill-min" && screenRatio > renderer.designRatio) ||
+            (settings.scaleMethod === "fill-max" && screenRatio < renderer.designRatio) ||
+            (settings.scaleMethod === "flex-width")
+        ) {
+            // resize the display canvas to fill the parent container
+            var sWidth = Math.min(canvasMaxWidth, settings.height * screenRatio);
+            scaleX = scaleY = _max_width / sWidth;
+            renderer.resize(Math.floor(sWidth), settings.height);
+        }
+        else if ((settings.scaleMethod === "fill-min" && screenRatio < renderer.designRatio) ||
+                 (settings.scaleMethod === "fill-max" && screenRatio > renderer.designRatio) ||
+                 (settings.scaleMethod === "flex-height")
+        ) {
+            // resize the display canvas to fill the parent container
+            var sHeight = Math.min(canvasMaxHeight, settings.width * (_max_height / _max_width));
+            scaleX = scaleY = _max_height / sHeight;
+            renderer.resize(settings.width, Math.floor(sHeight));
+        }
+        else if (settings.scaleMethod === "flex") {
+            // resize the display canvas to fill the parent container
+            renderer.resize(Math.floor(_max_width), Math.floor(_max_height));
+        }
+        else if (settings.scaleMethod === "stretch") {
+            // scale the display canvas to fit with the parent container
+            scaleX = _max_width / settings.width;
+            scaleY = _max_height / settings.height;
+        }
+        else {
+            // scale the display canvas to fit the parent container
+            // make sure we maintain the original aspect ratio
+            if (screenRatio < renderer.designRatio) {
+                scaleX = scaleY = _max_width / settings.width;
+            }
+            else {
+                scaleX = scaleY = _max_height / settings.height;
+            }
+        }
+
+        // adjust scaling ratio based on the new scaling ratio
+        scale(game, scaleX, scaleY);
+    } else {
+        // adjust scaling ratio based on the given settings
+        scale(game, settings.scale, settings.scale);
+    }
+}
+
+export { onresize };

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

@@ -0,0 +1,28 @@
+/*!
+ * melonJS Game Engine - v14.3.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)
+ */
+// default settings
+const defaultSettings = {
+    parent : undefined,
+    renderer : 2, // AUTO
+    autoScale : false,
+    scale : 1.0,
+    scaleMethod : "manual",
+    transparent : false,
+    premultipliedAlpha: true,
+    blendMode : "normal",
+    antiAlias : false,
+    failIfMajorPerformanceCaveat : true,
+    subPixel : false,
+    preferWebGL1 : false,
+    powerPreference : "default",
+    verbose : false,
+    consoleHeader : true,
+    legacy : false
+};
+
+export { defaultSettings };