melonjs 18.1.0 → 18.2.0

package/build/application/application.d.ts

@@ -1,46 +1,33 @@
-/**
- * additional import for TypeScript
- * @import WebGLRenderer from "./../video/webgl/webgl_renderer.js";
- * @import Camera2d from "./../camera/camera2d.js";
- */
+import type Camera2d from "./../camera/camera2d.ts";
+import World from "../physics/world.js";
+import type Renderer from "./../video/renderer.js";
+import type { ApplicationSettings } from "./settings.ts";
 /**
  * An Application represents a single melonJS game, and is responsible for updating (each frame) all the related object status and draw them.
  * @category Application
  * @see {@link game}
  */
 export default class Application {
-    /**
-     * @param {number} width - The width of the canvas viewport
-     * @param {number} height - The height of the canvas viewport
-     * @param {ApplicationSettings} [options] - The optional parameters for the application and default renderer
-     * @throws Will throw an exception if it fails to instantiate a renderer
-     */
-    constructor(width: number, height: number, options?: ApplicationSettings);
     /**
      * the parent HTML element holding the main canvas of this application
-     * @type {HTMLElement}
      */
     parentElement: HTMLElement;
     /**
      * a reference to the active Canvas or WebGL renderer
-     * @type {CanvasRenderer|WebGLRenderer}
      */
-    renderer: CanvasRenderer | WebGLRenderer;
+    renderer: Renderer;
     /**
      * the active stage "default" camera
-     * @type {Camera2d}
      */
     viewport: Camera2d;
     /**
      * a reference to the game world, <br>
      * a world is a virtual environment containing all the game objects
-     * @type {World}
      */
     world: World;
     /**
      * 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
-     * @type {boolean}
      * @default true
      */
     mergeGroup: boolean;
@@ -49,23 +36,26 @@ export default class Application {
      * Use this value to implement frame prediction in drawing events,
      * for creating smooth motion while running game update logic at
      * a lower fps.
-     * @type {DOMHighResTimeStamp}
      */
     lastUpdate: DOMHighResTimeStamp;
     /**
      * true when this app instance has been initialized
-     * @type {boolean}
      * @default false
      */
     isInitialized: boolean;
     /**
      * the given settings used when creating this application
-     * @type {ApplicationSettings}
      */
-    settings: ApplicationSettings;
+    settings: ApplicationSettings & {
+        width: number;
+        height: number;
+        autoScale: boolean;
+        zoomX: number;
+        zoomY: number;
+        scale: number | "auto";
+    };
     /**
      * Specify whether to pause this app when losing focus
-     * @type {boolean}
      * @default true
      * @example
      *  // keep the default game instance running even when losing focus
@@ -74,13 +64,11 @@ export default class Application {
     pauseOnBlur: boolean;
     /**
      * Specify whether to unpause this app when gaining back focus
-     * @type {boolean}
      * @default true
      */
     resumeOnFocus: boolean;
     /**
      * Specify whether to stop this app when losing focus
-     * @type {boolean}
      * @default false
      */
     stopOnBlur: boolean;
@@ -95,26 +83,34 @@ export default class Application {
     updateDelta: number;
     lastUpdateStart: number | null;
     updateAverageDelta: number;
+    /**
+     * @param width - The width of the canvas viewport
+     * @param height - The height of the canvas viewport
+     * @param options - The optional parameters for the application and default renderer
+     * @throws {Error} Will throw an exception if it fails to instantiate a renderer
+     */
+    constructor(width: number, height: number, options?: Partial<ApplicationSettings> & {
+        legacy?: boolean;
+    });
     /**
      * init the game instance (create a physic world, update starting time, etc..)
-     * @param {number} width - The width of the canvas viewport
-     * @param {number} height - The height of the canvas viewport
-     * @param {ApplicationSettings} [options] - The optional parameters for the application and default renderer
+     * @param width - The width of the canvas viewport
+     * @param height - The height of the canvas viewport
+     * @param options - The optional parameters for the application and default renderer
      */
-    init(width: number, height: number, options?: ApplicationSettings): void;
+    init(width: number, height: number, options?: Partial<ApplicationSettings>): void;
     /**
      * reset the game Object manager
      * destroy all current objects
      */
     reset(): void;
-    set sortOn(value: string);
     /**
      * Specify the property to be used when sorting renderables for this application game world.
      * Accepted values : "x", "y", "z", "depth"
-     * @type {string}
      * @see {@link World.sortOn}
      */
     get sortOn(): string;
+    set sortOn(value: string);
     /**
      * Fired when a level is fully loaded and all renderable instantiated. <br>
      * Additionally the level id will also be passed to the called function.
@@ -131,7 +127,7 @@ export default class Application {
     updateFrameRate(): void;
     /**
      * Returns the parent HTML Element holding the main canvas of this application
-     * @returns {HTMLElement} the parent HTML element
+     * @returns the parent HTML element
      */
     getParentElement(): HTMLElement;
     /**
@@ -140,7 +136,7 @@ export default class Application {
     repaint(): void;
     /**
      * update all objects related to this game active scene/stage
-     * @param {number} time - current timestamp as provided by the RAF callback
+     * @param time - current timestamp as provided by the RAF callback
      */
     update(time: number): void;
     /**
@@ -148,8 +144,4 @@ export default class Application {
      */
     draw(): void;
 }
-import CanvasRenderer from "../video/canvas/canvas_renderer.js";
-import type WebGLRenderer from "./../video/webgl/webgl_renderer.js";
-import type Camera2d from "./../camera/camera2d.js";
-import World from "../physics/world.js";
 //# sourceMappingURL=application.d.ts.map

package/build/application/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/application/application.js"],"names":[],"mappings":"AAgCA;;;;GAIG;AAEH;;;;GAIG;AACH;IACC;;;;;OAKG;IACH,mBALW,MAAM,UACN,MAAM,YACN,mBAAmB,EA8G7B;IA1GA;;;OAGG;IACH,eAFU,WAAW,CAES;IAE9B;;;OAGG;IACH,UAFU,cAAc,GAAC,aAAa,CAEb;IAEzB;;;OAGG;IACH,UAFU,QAAQ,CAEO;IAEzB;;;;OAIG;IACH,OAFU,KAAK,CAEO;IAEtB;;;;;OAKG;IACH,YAHU,OAAO,CAGK;IAEtB;;;;;;OAMG;IACH,YAFU,mBAAmB,CAEV;IAEnB;;;;OAIG;IACH,eAHU,OAAO,CAGS;IAE1B;;;OAGG;IACH,UAFU,mBAAmB,CAEJ;IAEzB;;;;;;;OAOG;IACH,aANU,OAAO,CAMM;IAEvB;;;;OAIG;IACH,eAHU,OAAO,CAGQ;IAEzB;;;;OAIG;IACH,YAHU,OAAO,CAGM;IAGvB,iBAAmB;IAGnB,uBAA0B;IAI1B,qBAAqB;IACrB,kBAAkB;IAGlB,oBAAsB;IACtB,uBAAyB;IACzB,+BAA+B;IAG/B,iBAAyB;IACzB,oBAAoB;IACpB,+BAA2B;IAC3B,2BAA2B;IAS5B;;;;;OAKG;IACH,YAJW,MAAM,UACN,MAAM,YACN,mBAAmB,QA6J7B;IAED;;;OAGG;IACH,cAYC;IAWD,kBANU,MAAM,EAQf;IAXD;;;;;OAKG;IACH,cAHU,MAAM,CAKf;IAKD;;;;;;OAMG;IACH,sBAAkB;IAElB;;;;OAIG;IACH,wBAaC;IAED;;;OAGG;IACH,oBAFa,WAAW,CAIvB;IAED;;OAEG;IACH,gBAEC;IAED;;;OAGG;IACH,aAFW,MAAM,QA8ChB;IAED;;OAEG;IACH,aAuBC;CACD;2BAjc0B,oCAAoC;+BASjC,oCAAoC;0BACzC,yBAAyB;kBAlChC,qBAAqB"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/application/application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,MAAM,qBAAqB,CAAC;AAyBxC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAC;AAMnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW;IAC/B;;OAEG;IACH,aAAa,EAAG,WAAW,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAG,QAAQ,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAG,QAAQ,CAAC;IAEpB;;;OAGG;IACH,KAAK,EAAG,KAAK,CAAC;IAEd;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;;;OAKG;IACH,UAAU,EAAE,mBAAmB,CAAC;IAEhC;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAG,mBAAmB,GAAG;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;IAEF;;;;;;OAMG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAGpB,OAAO,EAAE,OAAO,CAAC;IAGjB,aAAa,EAAE,OAAO,CAAC;IAGvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAGlB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAG/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;gBAEF,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;IA2BlE;;;;;OAKG;IACH,IAAI,CACH,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACpC,IAAI;IA4JP;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgBb;;;;OAIG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAEvB;IAED;;;;;;OAMG;IACH,aAAa,IAAI,IAAI;IAErB;;;;OAIG;IACH,eAAe,IAAI,IAAI;IAevB;;;OAGG;IACH,gBAAgB,IAAI,WAAW;IAI/B;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA+C1B;;OAEG;IACH,IAAI,IAAI,IAAI;CAqBZ"}

package/build/application/header.d.ts

@@ -1,11 +1,7 @@
-/**
- * additional import for TypeScript
- * @import Application from "./application.js";
- */
+import type Application from "./application.ts";
 /**
  * display information
- * @param {Application} app - the game application instance calling this function
+ * @param app - the game application instance calling this function
  */
-export function consoleHeader(app: Application): void;
-import type Application from "./application.js";
+export declare function consoleHeader(app: Application): void;
 //# sourceMappingURL=header.d.ts.map

package/build/application/header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/application/header.js"],"names":[],"mappings":"AAEA;;;GAGG;AAEH;;;GAGG;AACH,mCAFW,WAAW,QAgDrB;6BArD2B,kBAAkB"}
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/application/header.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA8BpD"}

package/build/application/resize.d.ts

@@ -1,8 +1,7 @@
+import type Application from "./application.ts";
 /**
  * callback for window resize event
- * @private
- * @param {Application} game - the game application instance triggering the resize
+ * @param game - the game application instance triggering the resize
  */
-export function onresize(game: Application): void;
-import type Application from "./application.js";
+export declare function onresize(game: Application): void;
 //# sourceMappingURL=resize.d.ts.map

package/build/application/resize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/application/resize.js"],"names":[],"mappings":"AAyCA;;;;GAIG;AACH,+BAFW,WAAW,QA8ErB;6BAtH2B,kBAAkB"}
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../src/application/resize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAkChD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CA4EhD"}