melonjs 10.12.0 → 13.0.0

package/dist/melonjs.module.d.ts

@@ -234,22 +234,24 @@ export class Body {
      */
     public collisionType: number;
     /**
-     * body velocity
+     * The current velocity of the body.
+     * See to apply a force if you need to modify a body velocity
+     * @see Body.force
      * @public
      * @type {Vector2d}
      * @default <0,0>
      */
     public vel: Vector2d;
     /**
-     * body force or acceleration (automatically) applied to the body.
-     * when defining a force, user should also define a max velocity
+     * body force to apply to this the body in the current step.
+     * (any positive or negative force will be cancelled after every world/body update cycle)
      * @public
      * @type {Vector2d}
      * @default <0,0>
      * @see Body.setMaxVelocity
      * @example
      * // define a default maximum acceleration, initial force and friction
-     * this.body.force.set(0, 0);
+     * this.body.force.set(1, 0);
      * this.body.friction.set(0.4, 0);
      * this.body.setMaxVelocity(3, 15);
      *
@@ -259,8 +261,6 @@ export class Body {
      *          this.body.force.x = -this.body.maxVel.x;
      *      } else if (me.input.isKeyPressed("right")) {
      *         this.body.force.x = this.body.maxVel.x;
-     *     } else {
-     *         this.body.force.x = 0;
      *     }
      * }
      */
@@ -486,23 +486,14 @@ export class Body {
      * @param {number} y vertical friction
      */
     setFriction(x?: number, y?: number): void;
-    /**
-     * compute the new velocity value
-     * @ignore
-     */
-    computeVelocity(): void;
     /**
      * Updates the parent's position as well as computes the new body's velocity based
-     * on the values of force/friction/gravity.  Velocity chages are proportional to the
+     * on the values of force/friction.  Velocity chages are proportional to the
      * me.timer.tick value (which can be used to scale velocities).  The approach to moving the
      * parent renderable is to compute new values of the Body.vel property then add them to
      * the parent.pos value thus changing the postion the amount of Body.vel each time the
      * update call is made. <br>
      * Updates to Body.vel are bounded by maxVel (which defaults to viewport size if not set) <br>
-     *
-     * In addition, when the gravity calcuation is made, if the Body.vel.y > 0 then the Body.falling
-     * property is set to true and Body.jumping is set to !Body.falling.
-     *
      * At this time a call to Body.Update does not call the onBodyUpdate callback that is listed in the constructor arguments.
      * @protected
      * @param {number} dt time since the last update in milliseconds.
@@ -1956,7 +1947,7 @@ export class Container extends Renderable {
      * @memberof Container
      * @public
      * @param {Renderable} child
-     * @param {boolean} [keepalive=False] True to prevent calling child.destroy()
+     * @param {boolean} [keepalive=false] true to prevent calling child.destroy()
      */
     public removeChild(child: Renderable, keepalive?: boolean): void;
     /**
@@ -2806,11 +2797,12 @@ export class Light2d extends Renderable {
     /**
      * @param {number} x - The horizontal position of the light.
      * @param {number} y - The vertical position of the light.
-     * @param {number} radius - The radius of the light.
+     * @param {number} radiusX - The horizontal radius of the light.
+     * @param {number} [radiusY=radiusX] - The vertical radius of the light.
      * @param {Color|string} [color="#FFF"] the color of the light
      * @param {number} [intensity=0.7] - The intensity of the light.
      */
-    constructor(x: number, y: number, radius: number, color?: Color | string, intensity?: number);
+    constructor(x: number, y: number, radiusX: number, radiusY?: number, color?: Color | string, intensity?: number);
     /**
      * the color of the light
      * @type {Color}
@@ -2818,10 +2810,15 @@ export class Light2d extends Renderable {
      */
     color: Color;
     /**
-     * The radius of the light
+     * The horizontal radius of the light
      * @type {number}
      */
-    radius: number;
+    radiusX: number;
+    /**
+     * The vertical radius of the light
+     * @type {number}
+     */
+    radiusY: number;
     /**
      * The intensity of the light
      * @type {number}
@@ -5403,16 +5400,18 @@ export class Polygon {
  */
 export class QuadTree {
     /**
+     * @param {World} world the physic world this QuadTree belongs to
      * @param {Bounds} bounds bounds of the node
      * @param {number} [max_objects=4] max objects a node can hold before splitting into 4 subnodes
      * @param {number} [max_levels=4] total max levels inside root Quadtree
      * @param {number} [level] deepth level, required for subnodes
      */
-    constructor(bounds: Bounds, max_objects?: number, max_levels?: number, level?: number);
+    constructor(world: World, bounds: Bounds, max_objects?: number, max_levels?: number, level?: number);
+    world: World;
+    bounds: Bounds;
     max_objects: number;
     max_levels: number;
     level: number;
-    bounds: Bounds;
     objects: any[];
     nodes: any[];
     split(): void;
@@ -6153,7 +6152,7 @@ export class Renderer {
      * @param {number} options.width The width of the canvas without scaling
      * @param {number} options.height The height of the canvas without scaling
      * @param {HTMLCanvasElement} [options.canvas] The html canvas to draw to on screen
-     * @param {boolean} [options.doubleBuffering=false] Whether to enable double buffering
+     * @param {boolean} [options.doubleBuffering=false] Whether to enable double buffering (not applicable when using the WebGL Renderer)
      * @param {boolean} [options.antiAlias=false] Whether to enable anti-aliasing, use false (default) for a pixelated effect.
      * @param {boolean} [options.failIfMajorPerformanceCaveat=true] If true, the renderer will switch to CANVAS mode if the performances of a WebGL context would be dramatically lower than that of a native application making equivalent OpenGL calls.
      * @param {boolean} [options.transparent=false] Whether to enable transparency on the canvas (performance hit when enabled)
@@ -7624,9 +7623,6 @@ export class Text extends Renderable {
     public fontSize: number;
     canvasTexture: any;
     metrics: TextMetrics;
-    /** @ignore */
-    onDeactivateEvent(): void;
-    glTextureUnit: any;
     /**
      * make the font bold
      * @returns {Text} this object for chaining
@@ -7654,6 +7650,7 @@ export class Text extends Renderable {
      * @returns {Text} this object for chaining
      */
     setText(value?: number | string | string[]): Text;
+    glTextureUnit: any;
     /**
      * measure the given text size in pixels
      * @param {CanvasRenderer|WebGLRenderer} renderer reference to the active renderer
@@ -9052,7 +9049,7 @@ export class WebGLRenderer extends Renderer {
      * @param {number} options.width The width of the canvas without scaling
      * @param {number} options.height The height of the canvas without scaling
      * @param {HTMLCanvasElement} [options.canvas] The html canvas to draw to on screen
-     * @param {boolean} [options.doubleBuffering=false] Whether to enable double buffering
+     * @param {boolean} [options.doubleBuffering=false] Whether to enable double buffering (not applicable when using the WebGL Renderer)
      * @param {boolean} [options.antiAlias=false] Whether to enable anti-aliasing
      * @param {boolean} [options.failIfMajorPerformanceCaveat=true] If true, the renderer will switch to CANVAS mode if the performances of a WebGL context would be dramatically lower than that of a native application making equivalent OpenGL calls.
      * @param {boolean} [options.transparent=false] Whether to enable transparency on the canvas (performance hit when enabled)
@@ -9556,6 +9553,12 @@ export class World extends Container {
      * @param {number} [height=game.viewport.height] height of the container
      */
     constructor(x?: number, y?: number, width?: number, height?: number);
+    /**
+     * the application (game) this physic world belong to
+     * @public
+     * @type {Application}
+     */
+    public app: Application;
     /**
      * the rate at which the game world is updated,
      * may be greater than or lower than the display fps
@@ -9623,6 +9626,14 @@ export class World extends Container {
      * @returns {World} this game world
      */
     removeBody(body: Body): World;
+    /**
+     * Apply gravity to the given body
+     * @name bodyApplyVelocity
+     * @memberof World
+     * @private
+     * @param {Body} body
+     */
+    private bodyApplyGravity;
 }
 export var audio: Readonly<{
     __proto__: any;
@@ -9734,31 +9745,10 @@ export namespace collision {
      */
     function rayCast(line: Line, result?: Renderable[]): Renderable[];
 }
-export namespace device {
-    const devicePixelRatio: number;
-    const isFullscreen: boolean;
-    const sound: boolean;
-    /**
-     * @public
-     * @name turnOnPointerLock
-     * @returns {boolean} return true if the request was successfully submitted
-     * @memberof device#
-     * @deprecated since 10.3.0
-     * @see input.requestPointerLock
-     */
-    function turnOnPointerLock(): boolean;
-    /**
-     * @public
-     * @name turnOffPointerLock
-     * @returns {boolean} return true if the request was successfully submitted
-     * @memberof device#
-     * @deprecated since 10.3.0
-     * @see input.exitPointerLock
-     */
-    function turnOffPointerLock(): boolean;
-}
+export var device: any;
 export var event: Readonly<{
     __proto__: any;
+    DOM_READY: string;
     BOOT: string;
     STATE_PAUSE: string;
     STATE_RESUME: string;
@@ -9798,21 +9788,13 @@ export var event: Readonly<{
     once: typeof once;
     off: typeof off;
 }>;
-export var game: Readonly<{
-    __proto__: any;
-    readonly viewport: Camera2d;
-    readonly world: World;
-    mergeGroup: true;
-    sortOn: string;
-    readonly lastUpdate: number;
-    onLevelLoaded: typeof onLevelLoaded;
-    reset: typeof reset;
-    updateFrameRate: typeof updateFrameRate;
-    getParentContainer: typeof getParentContainer;
-    repaint: typeof repaint;
-    update: typeof update;
-    draw: typeof draw;
-}>;
+/**
+ * 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
+ */
+export let game: Application;
 /**
  * a flag indicating that melonJS is fully initialized
  * @type {boolean}
@@ -10147,7 +10129,7 @@ export namespace level {
      * @param {string} levelId level id
      * @param {object} [options] additional optional parameters
      * @param {Container} [options.container=game.world] container in which to load the specified level
-     * @param {Function} [options.onLoaded=ame.onLevelLoaded] callback for when the level is fully loaded
+     * @param {Function} [options.onLoaded=game.onLevelLoaded] callback for when the level is fully loaded
      * @param {boolean} [options.flatten=game.mergeGroup] if true, flatten all objects into the given container
      * @param {boolean} [options.setViewportBounds=true] if true, set the viewport bounds to the map size
      * @returns {boolean} true if the level was successfully loaded
@@ -10192,7 +10174,7 @@ export namespace level {
      * @param {string} levelId level id
      * @param {object} [options] additional optional parameters
      * @param {Container} [options.container=game.world] container in which to load the specified level
-     * @param {Function} [options.onLoaded=ame.onLevelLoaded] callback for when the level is fully loaded
+     * @param {Function} [options.onLoaded=game.onLevelLoaded] callback for when the level is fully loaded
      * @param {boolean} [options.flatten=game.mergeGroup] if true, flatten all objects into the given container
      * @param {boolean} [options.setViewportBounds=true] if true, set the viewport bounds to the map size
      * @returns {boolean} true if the level was successfully loaded
@@ -10461,6 +10443,8 @@ export namespace loader {
      *   {name: "tileset-platformer", type: "image",  src: "data/map/tileset.png"},
      *   // PNG packed texture
      *   {name: "texture", type:"image", src: "data/gfx/texture.png"}
+     *   // PNG base64 encoded image
+     *   {name: "texture", type:"image", src: "data:image/png;base64,iVBORw0KAAAQAAAAEACA..."}
      *   // TSX file
      *   {name: "meta_tiles", type: "tsx", src: "data/map/meta_tiles.tsx"},
      *   // TMX level (XML & JSON)
@@ -10471,6 +10455,8 @@ export namespace loader {
      *   // audio resources
      *   {name: "bgmusic", type: "audio",  src: "data/audio/"},
      *   {name: "cling",   type: "audio",  src: "data/audio/"},
+     *   // base64 encoded audio resources
+     *   {name: "band",   type: "audio",  src: "data:audio/wav;base64,..."},
      *   // binary file
      *   {name: "ymTrack", type: "binary", src: "data/audio/main.ym"},
      *   // JSON file (used for texturePacker)
@@ -10508,6 +10494,8 @@ export namespace loader {
      *   {name: "tileset-platformer", type: "image",  src: "data/map/tileset.png"},
      *   // PNG packed texture
      *   {name: "texture", type:"image", src: "data/gfx/texture.png"}
+     *   // PNG base64 encoded image
+     *   {name: "texture", type:"image", src: "data:image/png;base64,iVBORw0KAAAQAAAAEACA..."}
      *   // TSX file
      *   {name: "meta_tiles", type: "tsx", src: "data/map/meta_tiles.tsx"},
      *   // TMX level (XML & JSON)
@@ -10518,6 +10506,8 @@ export namespace loader {
      *   // audio resources
      *   {name: "bgmusic", type: "audio",  src: "data/audio/"},
      *   {name: "cling",   type: "audio",  src: "data/audio/"},
+     *   // base64 encoded audio resources
+     *   {name: "band",   type: "audio",  src: "data:audio/wav;base64,..."},
      *   // binary file
      *   {name: "ymTrack", type: "binary", src: "data/audio/main.ym"},
      *   // JSON file (used for texturePacker)
@@ -10547,13 +10537,14 @@ export namespace loader {
      * @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 {Function} onload function to be called when the resource is loaded
-     * @param {Function} onerror function to be called in case of error
+     * @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
      * @example
      * // load an image asset
      * me.loader.load({name: "avatar",  type:"image",  src: "data/avatar.png"}, this.onload.bind(this), this.onerror.bind(this));
-     *
+     * // load a base64 image asset
+     *  me.loader.load({name: "avatar", type:"image", src: "data:image/png;base64,iVBORw0KAAAQAAAAEACA..."};
      * // start loading music
      * me.loader.load({
      *     name   : "bgmusic",
@@ -10568,7 +10559,7 @@ export namespace loader {
         type: string;
         src: string;
         stream?: boolean;
-    }, onload: Function, onerror: Function): number;
+    }, onload?: Function, onerror?: Function): number;
     /**
      * Load a single resource (to be used if you need to load additional resource during the game)
      * @name load
@@ -10579,13 +10570,14 @@ export namespace loader {
      * @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 {Function} onload function to be called when the resource is loaded
-     * @param {Function} onerror function to be called in case of error
+     * @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
      * @example
      * // load an image asset
      * me.loader.load({name: "avatar",  type:"image",  src: "data/avatar.png"}, this.onload.bind(this), this.onerror.bind(this));
-     *
+     * // load a base64 image asset
+     *  me.loader.load({name: "avatar", type:"image", src: "data:image/png;base64,iVBORw0KAAAQAAAAEACA..."};
      * // start loading music
      * me.loader.load({
      *     name   : "bgmusic",
@@ -10600,7 +10592,7 @@ export namespace loader {
         type: string;
         src: string;
         stream?: boolean;
-    }, onload: Function, onerror: Function): number;
+    }, onload?: Function, onerror?: Function): number;
     /**
      * unload specified resource to free memory
      * @name unload
@@ -11108,20 +11100,6 @@ export namespace state {
      */
     export function isCurrent(state: number): boolean;
 }
-/**
- * the default global Timer instance
- * @namespace timer
- * @see Timer
- * @example
- * // set a timer to call "myFunction" after 1000ms
- * timer.setTimeout(myFunction, 1000);
- * // set a timer to call "myFunction" after 1000ms (respecting the pause state) and passing param1 and param2
- * timer.setTimeout(myFunction, 1000, true, param1, param2);
- * // set a timer to call "myFunction" every 1000ms
- * timer.setInterval(myFunction, 1000);
- * // set a timer to call "myFunction" every 1000ms (respecting the pause state) and passing param1 and param2
- * timer.setInterval(myFunction, 1000, true, param1, param2);
- */
 export const timer: Timer;
 export namespace utils {
     export { agentUtils as agent };
@@ -11150,7 +11128,7 @@ export var video: Readonly<{
     AUTO: 2;
     readonly parent: HTMLElement;
     scaleRatio: Vector2d;
-    readonly renderer: CanvasRenderer | WebGLRenderer;
+    readonly renderer: WebGLRenderer | CanvasRenderer;
     init: typeof init;
     createCanvas: typeof createCanvas;
     getParent: typeof getParent;
@@ -11586,6 +11564,109 @@ declare class VertexArrayBuffer {
      */
     isEmpty(): boolean;
 }
+/**
+ * @classdesc
+ * An Application represents a single melonJS game.
+ * An Application is responsible for updating (each frame) all the related object status and draw them.
+ * @see game
+ */
+declare class Application {
+    /**
+     * a reference to the current active stage "default" camera
+     * @public
+     * @type {Camera2d}
+     */
+    public viewport: Camera2d;
+    /**
+     * a reference to the game world, <br>
+     * a world is a virtual environment containing all the game objects
+     * @public
+     * @type {World}
+     */
+    public 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
+     * @public
+     * @type {boolean}
+     * @default true
+     */
+    public mergeGroup: boolean;
+    /**
+     * Specify the property to be used when sorting renderables.
+     * Accepted values : "x", "y", "z"
+     * @public
+     * @type {string}
+     * @default "z"
+     */
+    public sortOn: string;
+    /**
+     * Last time the game update loop was executed. <br>
+     * 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
+     */
+    public lastUpdate: DOMHighResTimeStamp;
+    isDirty: boolean;
+    isAlwaysDirty: boolean;
+    frameCounter: number;
+    frameRate: number;
+    accumulator: number;
+    accumulatorMax: number;
+    accumulatorUpdateDelta: number;
+    stepSize: number;
+    updateDelta: number;
+    lastUpdateStart: number;
+    updateAverageDelta: number;
+    /**
+     * init the game instance (create a physic world, update starting time, etc..)
+     */
+    init(): void;
+    /**
+     * reset the game Object manager
+     * destroy all current objects
+     */
+    reset(): void;
+    /**
+     * Fired when a level is fully loaded and all renderable instantiated. <br>
+     * Additionnaly the level id will also be passed to the called function.
+     * @example
+     * // call myFunction () everytime a level is loaded
+     * me.game.onLevelLoaded = this.myFunction.bind(this);
+     */
+    onLevelLoaded(): void;
+    /**
+     * Update the renderer framerate using the system config variables.
+     * @see timer.maxfps
+     * @see World.fps
+     */
+    updateFrameRate(): void;
+    /**
+     * Returns the parent container of the specified Child in the game world
+     * @param {Renderable} child
+     * @returns {Container}
+     */
+    getParentContainer(child: Renderable): Container;
+    /**
+     * force the redraw (not update) of all objects
+     */
+    repaint(): void;
+    /**
+     * update all objects related to this game active scene/stage
+     * @param {number} time current timestamp as provided by the RAF callback
+     * @param {Stage} stage the current stage
+     */
+    update(time: number, stage: Stage): void;
+    /**
+     * draw the active scene/stage associated to this game
+     * @param {Stage} stage the current stage
+     */
+    draw(stage: Stage): void;
+}
 /**
  * Initialize and configure the audio support.<br>
  * melonJS supports a wide array of audio codecs that have varying browser support :
@@ -11887,55 +11968,6 @@ declare function once(eventName: string | symbol, listener: Function, context?:
  * me.event.off("event-name", myFunction);
  */
 declare function off(eventName: string | symbol, listener: Function): {};
-/**
- * Fired when a level is fully loaded and all entities instantiated. <br>
- * Additionnaly the level id will also be passed to the called function.
- * @function game.onLevelLoaded
- * @example
- * // call myFunction () everytime a level is loaded
- * me.game.onLevelLoaded = this.myFunction.bind(this);
- */
-declare function onLevelLoaded(): void;
-/**
- * reset the game Object manager<br>
- * destroy all current objects
- * @function game.reset
- */
-declare function reset(): void;
-/**
- * Update the renderer framerate using the system config variables.
- * @function game.updateFrameRate
- * @see timer.maxfps
- * @see World.fps
- */
-declare function updateFrameRate(): void;
-/**
- * Returns the parent container of the specified Child in the game world
- * @function game.getParentContainer
- * @param {Renderable} child
- * @returns {Container}
- */
-declare function getParentContainer(child: Renderable): Container;
-/**
- * force the redraw (not update) of all objects
- * @function game.repaint
- */
-declare function repaint(): void;
-/**
- * update all objects of the game manager
- * @ignore
- * @function game.update
- * @param {number} time current timestamp as provided by the RAF callback
- * @param {Stage} stage the current stage
- */
-declare function update(time: number, stage: Stage): void;
-/**
- * draw the current scene/stage
- * @function game.draw
- * @ignore
- * @param {Stage} stage the current stage
- */
-declare function draw(stage: Stage): void;
 /**
  * Translate the specified x and y values from the global (absolute)
  * coordinate to local (viewport) relative coordinate.
@@ -12330,48 +12362,41 @@ declare class ObjectPool {
 /**
  * @classdesc
  * a Timer class to manage timing related function (FPS, Game Tick, Time...)
-  * @see {@link timer} the default global timer instance
+ * @see {@link timer} the default global timer instance
  */
 declare class Timer {
     /**
-     * Last game tick value.<br/>
-     * Use this value to scale velocities during frame drops due to slow
-     * hardware or when setting an FPS limit. (See {@link timer.maxfps})
-     * This feature is disabled by default. Enable me.timer.interpolation to
-     * use it.
+     * Last game tick value. <br>
+     * Use this value to scale velocities during frame drops due to slow hardware or when setting an FPS limit.
+     * This feature is disabled by default (Enable interpolation to use it).
      * @public
-     * @see timer.interpolation
+     * @see interpolation
+     * @See maxfps
      * @type {number}
      * @name tick
-     * @memberof timer
      */
     public tick: number;
     /**
-     * Last measured fps rate.<br/>
-     * This feature is disabled by default, unless the debugPanel is enabled/visible
+     * Last measured fps rate.<br>
+     * This feature is disabled by default, unless the debugPanel is enabled/visible.
      * @public
      * @type {number}
      * @name fps
-     * @memberof timer
      */
     public fps: number;
     /**
      * Set the maximum target display frame per second
      * @public
-     * @see timer.tick
+     * @see tick
      * @type {number}
-     * @name maxfps
      * @default 60
-     * @memberof timer
      */
     public maxfps: number;
     /**
      * Enable/disable frame interpolation
-     * @see timer.tick
+     * @see tick
      * @type {boolean}
      * @default false
-     * @name interpolation
-     * @memberof timer
      */
     interpolation: boolean;
     framecount: number;
@@ -12385,15 +12410,11 @@ declare class Timer {
     timerId: number;
     /**
      * reset time (e.g. usefull in case of pause)
-     * @name reset
-     * @memberof timer
      * @ignore
      */
     reset(): void;
     /**
      * Calls a function once after a specified delay. See me.timer.setInterval to repeativly call a function.
-     * @name setTimeout
-     * @memberof timer
      * @param {Function} fn the function you want to execute after delay milliseconds.
      * @param {number} delay the number of milliseconds (thousandths of a second) that the function call should be delayed by.
      * @param {boolean} [pauseable=true] respects the pause state of the engine.
@@ -12408,8 +12429,6 @@ declare class Timer {
     setTimeout(fn: Function, delay: number, pauseable?: boolean, ...args: any[]): number;
     /**
      * Calls a function continously at the specified interval.  See setTimeout to call function a single time.
-     * @name setInterval
-     * @memberof timer
      * @param {Function} fn the function to execute
      * @param {number} delay the number of milliseconds (thousandths of a second) on how often to execute the function
      * @param {boolean} [pauseable=true] respects the pause state of the engine.
@@ -12424,38 +12443,28 @@ declare class Timer {
     setInterval(fn: Function, delay: number, pauseable?: boolean, ...args: any[]): number;
     /**
      * Clears the delay set by me.timer.setTimeout().
-     * @name clearTimeout
-     * @memberof timer
      * @param {number} timeoutID ID of the timeout to be cleared
      */
     clearTimeout(timeoutID: number): void;
     /**
      * Clears the Interval set by me.timer.setInterval().
-     * @name clearInterval
-     * @memberof timer
      * @param {number} intervalID ID of the interval to be cleared
      */
     clearInterval(intervalID: number): void;
     /**
      * Return the current timestamp in milliseconds <br>
      * since the game has started or since linux epoch (based on browser support for High Resolution Timer)
-     * @name getTime
-     * @memberof timer
      * @returns {number}
      */
     getTime(): number;
     /**
      * Return elapsed time in milliseconds since the last update
-     * @name getDelta
-     * @memberof timer
      * @returns {number}
      */
     getDelta(): number;
     /**
      * compute the actual frame time and fps rate
-     * @name computeFPS
      * @ignore
-     * @memberof timer
      */
     countFPS(): void;
     /**
@@ -12493,11 +12502,10 @@ declare var fileUtils: Readonly<{
 declare var stringUtils: Readonly<{
     __proto__: any;
     capitalize: typeof capitalize;
-    trimLeft: typeof trimLeft;
-    trimRight: typeof trimRight;
     isNumeric: typeof isNumeric;
     isBoolean: typeof isBoolean;
     toHex: typeof toHex$1;
+    isDataUrl: typeof isDataUrl;
 }>;
 declare var fnUtils: Readonly<{
     __proto__: any;
@@ -12563,10 +12571,10 @@ declare function init(width: number, height: number, options?: {
  * @function video.createCanvas
  * @param {number} width width
  * @param {number} height height
- * @param {boolean} [offscreenCanvas=false] will return an OffscreenCanvas if supported
+ * @param {boolean} [returnOffscreenCanvas=false] will return an OffscreenCanvas if supported
  * @returns {HTMLCanvasElement|OffscreenCanvas}
  */
-declare function createCanvas(width: number, height: number, offscreenCanvas?: boolean): HTMLCanvasElement | OffscreenCanvas;
+declare function createCanvas(width: number, height: number, returnOffscreenCanvas?: boolean): HTMLCanvasElement | OffscreenCanvas;
 /**
  * return a reference to the parent DOM element holding the main canvas
  * @function video.getParent
@@ -12674,24 +12682,6 @@ declare function getExtension(path: string): string;
  * @returns {string} the capitalized string
  */
 declare function capitalize(str: string): string;
-/**
- * returns the string stripped of whitespace from the left.
- * @public
- * @memberof utils.string
- * @name trimLeft
- * @param {string} str the string to be trimmed
- * @returns {string} trimmed string
- */
-declare function trimLeft(str: string): string;
-/**
- * returns the string stripped of whitespace from the right.
- * @public
- * @memberof utils.string
- * @name trimRight
- * @param {string} str the string to be trimmed
- * @returns {string} trimmed string
- */
-declare function trimRight(str: string): string;
 /**
  * returns true if the given string contains a numeric integer or float value
  * @public
@@ -12719,6 +12709,16 @@ declare function isBoolean(str: string): boolean;
  * @returns {string} the converted hexadecimal value
  */
 declare function toHex$1(str: string): string;
+/**
+ * returns true if the given string is a data url in the `data:[<mediatype>][;base64],<data>` format.
+ * (this will not test the validity of the Data or Base64 encoding)
+ * @public
+ * @memberof utils.string
+ * @name isDataUrl
+ * @param {string} str the string (url) to be tested
+ * @returns {boolean} true if the string is a data url
+ */
+declare function isDataUrl(str: string): boolean;
 /**
  * a collection of utility functions
  * @namespace utils.function