melonjs 10.5.2 → 10.7.0

package/dist/melonjs.module.d.ts

@@ -17,6 +17,7 @@ export class BitmapText extends Renderable {
      * @param {string} [settings.textBaseline="top"] the text baseline
      * @param {number} [settings.lineHeight=1.0] line spacing height
      * @param {Vector2d} [settings.anchorPoint={x:0.0, y:0.0}] anchor point to draw the text at
+     * @param {number} [settings.wordWrapWidth] the maximum length in CSS pixel for a single segment of text
      * @param {(string|string[])} [settings.text] a string, or an array of strings
      * @example
      * // Use me.loader.preload or me.loader.load to load assets
@@ -42,6 +43,7 @@ export class BitmapText extends Renderable {
         textBaseline?: string;
         lineHeight?: number;
         anchorPoint?: Vector2d;
+        wordWrapWidth?: number;
         text?: (string | string[]);
     });
     /**
@@ -50,8 +52,6 @@ export class BitmapText extends Renderable {
      * @public
      * @type {string}
      * @default "left"
-     * @name textAlign
-     * @memberof BitmapText
      */
     public textAlign: string;
     /**
@@ -60,8 +60,6 @@ export class BitmapText extends Renderable {
      * @public
      * @type {string}
      * @default "top"
-     * @name textBaseline
-     * @memberof BitmapText
      */
     public textBaseline: string;
     /**
@@ -70,10 +68,16 @@ export class BitmapText extends Renderable {
      * @public
      * @type {number}
      * @default 1.0
-     * @name lineHeight
-     * @memberof BitmapText
      */
     public lineHeight: number;
+    /**
+     * the maximum length in CSS pixel for a single segment of text.
+     * (use -1 to disable word wrapping)
+     * @public
+     * @type {number}
+     * @default -1
+     */
+    public wordWrapWidth: number;
     /**
      * the text to be displayed
      * @private
@@ -94,11 +98,9 @@ export class BitmapText extends Renderable {
      * @private
      */
     private fontData;
+    metrics: TextMetrics;
     /**
      * change the font settings
-     * @name set
-     * @memberof BitmapText.prototype
-     * @function
      * @param {string} textAlign ("left", "center", "right")
      * @param {number} [scale]
      * @returns {BitmapText} this object for chaining
@@ -106,51 +108,32 @@ export class BitmapText extends Renderable {
     set(textAlign: string, scale?: number): BitmapText;
     /**
      * change the text to be displayed
-     * @name setText
-     * @memberof BitmapText.prototype
-     * @function
      * @param {number|string|string[]} value a string, or an array of strings
      * @returns {BitmapText} this object for chaining
      */
-    setText(value: number | string | string[]): BitmapText;
+    setText(value?: number | string | string[]): BitmapText;
     public set fillStyle(arg: Color);
     /**
      * defines the color used to tint the bitmap text
      * @public
      * @type {Color}
-     * @name fillStyle
      * @see Renderable#tint
-     * @memberof BitmapText
      */
     public get fillStyle(): Color;
     /**
      * change the font display size
-     * @name resize
-     * @memberof BitmapText.prototype
-     * @function
      * @param {number} scale ratio
      * @returns {BitmapText} this object for chaining
      */
     resize(scale: number): BitmapText;
     /**
      * measure the given text size in pixels
-     * @name measureText
-     * @memberof BitmapText.prototype
-     * @function
      * @param {string} [text]
-     * @param {Rect} [ret] a object in which to store the text metrics
      * @returns {TextMetrics} a TextMetrics object with two properties: `width` and `height`, defining the output dimensions
      */
-    measureText(text?: string, ret?: Rect): TextMetrics;
-    /**
-     * @ignore
-     */
-    update(): boolean;
+    measureText(text?: string): TextMetrics;
     /**
      * draw the bitmap font
-     * @name draw
-     * @memberof BitmapText.prototype
-     * @function
      * @param {CanvasRenderer|WebGLRenderer} renderer Reference to the destination renderer instance
      * @param {string} [text]
      * @param {number} [x]
@@ -247,7 +230,7 @@ export class Body {
      * @see collision.types
      * @example
      * // set the body collision type
-     * myEntity.body.collisionType = me.collision.types.PLAYER_OBJECT;
+     * body.collisionType = me.collision.types.PLAYER_OBJECT;
      */
     public collisionType: number;
     vel: Vector2d;
@@ -384,17 +367,17 @@ export class Body {
      */
     removeShapeAt(index: number): number;
     /**
-     * By default all entities are able to collide with all other entities, <br>
+     * By default all physic bodies are able to collide with all other bodies, <br>
      * but it's also possible to specify 'collision filters' to provide a finer <br>
-     * control over which entities can collide with each other.
+     * control over which body can collide with each other.
      * @see collision.types
      * @param {number} [bitmask = collision.types.ALL_OBJECT] the collision mask
      * @example
      * // filter collision detection with collision shapes, enemies and collectables
-     * myEntity.body.setCollisionMask(me.collision.types.WORLD_SHAPE | me.collision.types.ENEMY_OBJECT | me.collision.types.COLLECTABLE_OBJECT);
+     * body.setCollisionMask(me.collision.types.WORLD_SHAPE | me.collision.types.ENEMY_OBJECT | me.collision.types.COLLECTABLE_OBJECT);
      * ...
      * // disable collision detection with all other objects
-     * myEntity.body.setCollisionMask(me.collision.types.NO_OBJECT);
+     * body.setCollisionMask(me.collision.types.NO_OBJECT);
      */
     setCollisionMask(bitmask?: number): void;
     /**
@@ -403,7 +386,7 @@ export class Body {
      * @param {number} type the collision type
      * @example
      * // set the body collision type
-     * myEntity.body.collisionType = me.collision.types.PLAYER_OBJECT;
+     * body.collisionType = me.collision.types.PLAYER_OBJECT;
      */
     setCollisionType(type: number): void;
     /**
@@ -472,7 +455,7 @@ export class Body {
      * 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
      * me.timer.tick value (which can be used to scale velocities).  The approach to moving the
-     * parent Entity is to compute new values of the Body.vel property then add them to
+     * 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>
@@ -949,7 +932,7 @@ export class Camera2d extends Renderable {
      */
     moveTo(x: number, y: number): void;
     /** @ignore */
-    updateTarget(): boolean;
+    updateTarget(): void;
     /** @ignore */
     update(dt: any): boolean;
     /**
@@ -1096,11 +1079,21 @@ export class CanvasRenderer extends Renderer {
      */
     resetTransform(): void;
     /**
-     * Set a blend mode for the given context
+     * set a blend mode for the given context. <br>
+     * Supported blend mode between Canvas and WebGL remderer : <br>
+     * - "normal" : this is the default mode and draws new content on top of the existing content <br>
+     * <img src="images/normal-blendmode.png" width="510"/> <br>
+     * - "multiply" : the pixels of the top layer are multiplied with the corresponding pixel of the bottom layer. A darker picture is the result. <br>
+     * <img src="images/multiply-blendmode.png" width="510"/> <br>
+     * - "additive or lighter" : where both content overlap the color is determined by adding color values. <br>
+     * <img src="images/lighter-blendmode.png" width="510"/> <br>
+     * - "screen" : The pixels are inverted, multiplied, and inverted again. A lighter picture is the result (opposite of multiply) <br>
+     * <img src="images/screen-blendmode.png" width="510"/> <br>
      * @name setBlendMode
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
      * @memberof CanvasRenderer.prototype
      * @function
-     * @param {string} [mode="normal"] blend mode : "normal", "multiply"
+     * @param {string} [mode="normal"] blend mode : "normal", "multiply", "lighter, "additive", "screen"
      * @param {CanvasRenderingContext2D} [context]
      */
     setBlendMode(mode?: string, context?: CanvasRenderingContext2D): void;
@@ -4060,17 +4053,18 @@ export class ObservableVector3d extends Vector3d {
 /**
  * @classdesc
  * Single Particle Object.
- * @class Particle
  * @augments Renderable
- * @param {ParticleEmitter} particle emitter
  */
 export class Particle extends Renderable {
+    /**
+     * @param {ParticleEmitter} emitter the particle emitter
+     */
+    constructor(emitter: ParticleEmitter);
     /**
      * @ignore
      */
-    constructor(emitter: any);
-    vel: Vector2d;
     onResetEvent(emitter: any, newInstance?: boolean): void;
+    vel: Vector2d;
     image: any;
     life: any;
     startLife: any;
@@ -4082,50 +4076,319 @@ export class Particle extends Renderable {
     onlyInViewport: any;
     _deltaInv: number;
     angle: number;
-    /**
-     * @ignore
-     */
-    preDraw(renderer: any): void;
     /**
      * @ignore
      */
     draw(renderer: any): void;
 }
 /**
+ * @classdesc
  * Particle Emitter Object.
- * @class
- * @augments Rect
- * @param {number} x x-position of the particle emitter
- * @param {number} y y-position of the particle emitter
- * @param {object} settings An object containing the settings for the particle emitter. See {@link ParticleEmitterSettings}
- * @example
- * // Create a basic emitter at position 100, 100
- * var emitter = new me.ParticleEmitter(100, 100);
- *
- * // Adjust the emitter properties
- * emitter.totalParticles = 200;
- * emitter.minLife = 1000;
- * emitter.maxLife = 3000;
- * emitter.z = 10;
- *
- * // Add the emitter to the game world
- * me.game.world.addChild(emitter);
- *
- * // Launch all particles one time and stop, like a explosion
- * emitter.burstParticles();
- *
- * // Launch constantly the particles, like a fountain
- * emitter.streamParticles();
- *
- * // At the end, remove emitter from the game world
- * // call this in onDestroyEvent function
- * me.game.world.removeChild(emitter);
+ * @augments Container
  */
-export class ParticleEmitter extends Rect {
+export class ParticleEmitter extends Container {
     /**
-     * @ignore
+     * @param {number} x x position of the particle emitter
+     * @param {number} y y position of the particle emitter
+     * @param {ParticleEmitterSettings} [settings=ParticleEmitterSettings] the settings for the particle emitter.
+     * @example
+     * // Create a basic emitter at position 100, 100
+     * var emitter = new ParticleEmitter(100, 100);
+     *
+     * // Adjust the emitter properties
+     * emitter.totalParticles = 200;
+     * emitter.minLife = 1000;
+     * emitter.maxLife = 3000;
+     * emitter.z = 10;
+     *
+     * // Add the emitter to the game world
+     * me.game.world.addChild(emitter);
+     *
+     * // Launch all particles one time and stop, like a explosion
+     * emitter.burstParticles();
+     *
+     * // Launch constantly the particles, like a fountain
+     * emitter.streamParticles();
+     *
+     * // At the end, remove emitter from the game world
+     * // call this in onDestroyEvent function
+     * me.game.world.removeChild(emitter);
      */
-    constructor(x: any, y: any, settings: any);
+    constructor(x: number, y: number, settings?: {
+        /**
+         * Width of the particle spawn area.
+         * @type {number}
+         * @name width
+         * @memberof ParticleEmitterSettings
+         * @default 1
+         */
+        width: number;
+        /**
+         * Height of the particle spawn area
+         * @public
+         * @type {number}
+         * @name height
+         * @memberof ParticleEmitterSettings
+         * @default 1
+         */
+        height: number;
+        /**
+         * image used for particles texture
+         * (by default melonJS will create an white 8x8 texture image)
+         * @public
+         * @type {HTMLCanvasElement}
+         * @name image
+         * @memberof ParticleEmitterSettings
+         * @default undefined
+         * @see ParticleEmitterSettings.textureSize
+         */
+        image: HTMLCanvasElement;
+        /**
+         * default texture size used for particles if no image is specified
+         * (by default melonJS will create an white 8x8 texture image)
+         * @public
+         * @type {number}
+         * @name textureSize
+         * @memberof ParticleEmitterSettings
+         * @default 8
+         * @see ParticleEmitterSettings.image
+         */
+        textureSize: number;
+        /**
+         * tint to be applied to particles
+         * @public
+         * @type {string}
+         * @name tint
+         * @memberof ParticleEmitterSettings
+         * @default "#fff"
+         */
+        tint: string;
+        /**
+         * Total number of particles in the emitter
+         * @public
+         * @type {number}
+         * @name totalParticles
+         * @default 50
+         * @memberof ParticleEmitterSettings
+         */
+        totalParticles: number;
+        /**
+         * Start angle for particle launch in Radians
+         * @public
+         * @type {number}
+         * @name angle
+         * @default Math.PI / 2
+         * @memberof ParticleEmitterSettings
+         */
+        angle: number;
+        /**
+         * Variation in the start angle for particle launch in Radians.
+         * @public
+         * @type {number}
+         * @name angleVariation
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        angleVariation: number;
+        /**
+         * Minimum time each particle lives once it is emitted in ms.
+         * @public
+         * @type {number}
+         * @name minLife
+         * @default 1000
+         * @memberof ParticleEmitterSettings
+         */
+        minLife: number;
+        /**
+         * Maximum time each particle lives once it is emitted in ms.
+         * @public
+         * @type {number}
+         * @name maxLife
+         * @default 3000
+         * @memberof ParticleEmitterSettings
+         */
+        maxLife: number;
+        /**
+         * Start speed of particles.<br>
+         * @public
+         * @type {number}
+         * @name speed
+         * @default 2
+         * @memberof ParticleEmitterSettings
+         */
+        speed: number;
+        /**
+         * Variation in the start speed of particles
+         * @public
+         * @type {number}
+         * @name speedVariation
+         * @default 1
+         * @memberof ParticleEmitterSettings
+         */
+        speedVariation: number;
+        /**
+         * Minimum start rotation for particles sprites in Radians
+         * @public
+         * @type {number}
+         * @name minRotation
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        minRotation: number;
+        /**
+         * Maximum start rotation for particles sprites in Radians
+         * @public
+         * @type {number}
+         * @name maxRotation
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        maxRotation: number;
+        /**
+         * Minimum start scale ratio for particles (1 = no scaling)
+         * @public
+         * @type {number}
+         * @name minStartScale
+         * @default 1
+         * @memberof ParticleEmitterSettings
+         */
+        minStartScale: number;
+        /**
+         * Maximum start scale ratio for particles (1 = no scaling)
+         * @public
+         * @type {number}
+         * @name maxStartScale
+         * @default 1
+         * @memberof ParticleEmitterSettings
+         */
+        maxStartScale: number;
+        /**
+         * Minimum end scale ratio for particles
+         * @public
+         * @type {number}
+         * @name minEndScale
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        minEndScale: number;
+        /**
+         * Maximum end scale ratio for particles
+         * @public
+         * @type {number}
+         * @name maxEndScale
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        maxEndScale: number;
+        /**
+         * Vertical force (Gravity) for each particle
+         * @public
+         * @type {number}
+         * @name gravity
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         * @see game.world.gravity
+         */
+        gravity: number;
+        /**
+         * Horizontal force (like a Wind) for each particle
+         * @public
+         * @type {number}
+         * @name wind
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        wind: number;
+        /**
+         * Update the rotation of particle in accordance the particle trajectory.<br>
+         * The particle sprite should aim at zero angle (draw from left to right).<br>
+         * Override the particle minRotation and maxRotation.<br>
+         * @public
+         * @type {boolean}
+         * @name followTrajectory
+         * @default false
+         * @memberof ParticleEmitterSettings
+         */
+        followTrajectory: boolean;
+        /**
+         * Enable the Texture Additive by composite operation ("additive" blendMode)
+         * @public
+         * @type {boolean}
+         * @name textureAdditive
+         * @default false
+         * @memberof ParticleEmitterSettings
+         * @see ParticleEmitterSettings.blendMode
+         */
+        textureAdditive: boolean;
+        /**
+         * the blend mode to be applied when rendering particles.
+         * (note: this will superseed the `textureAdditive` setting if different than "normal")
+         * @public
+         * @type {string}
+         * @name blendMode
+         * @default normal
+         * @memberof ParticleEmitterSettings
+         * @see CanvasRenderer#setBlendMode
+         * @see WebGLRenderer#setBlendMode
+         */
+        blendMode: string;
+        /**
+         * Update particles only in the viewport, remove it when out of viewport.
+         * @public
+         * @type {boolean}
+         * @name onlyInViewport
+         * @default true
+         * @memberof ParticleEmitterSettings
+         */
+        onlyInViewport: boolean;
+        /**
+         * Render particles in screen space.
+         * @public
+         * @type {boolean}
+         * @name floating
+         * @default false
+         * @memberof ParticleEmitterSettings
+         */
+        floating: boolean;
+        /**
+         * Maximum number of particles launched each time in this emitter (used only if emitter is Stream).
+         * @public
+         * @type {number}
+         * @name maxParticles
+         * @default 10
+         * @memberof ParticleEmitterSettings
+         */
+        maxParticles: number;
+        /**
+         * How often a particle is emitted in ms (used only if emitter is a Stream).
+         * @public
+         * @type {number}
+         * @name frequency
+         * @default 100
+         * @memberof ParticleEmitterSettings
+         */
+        frequency: number;
+        /**
+         * Duration that the emitter releases particles in ms (used only if emitter is Stream).
+         * After this period, the emitter stop the launch of particles.
+         * @public
+         * @type {number}
+         * @name duration
+         * @default Infinity
+         * @memberof ParticleEmitterSettings
+         */
+        duration: number;
+        /**
+         * Skip n frames after updating the particle system once.
+         * This can be used to reduce the performance impact of emitters with many particles.
+         * @public
+         * @type {number}
+         * @name framesToSkip
+         * @default 0
+         * @memberof ParticleEmitterSettings
+         */
+        framesToSkip: number;
+    });
     /** @ignore */
     _stream: boolean;
     /** @ignore */
@@ -4134,95 +4397,43 @@ export class ParticleEmitter extends Rect {
     _durationTimer: number;
     /** @ignore */
     _enabled: boolean;
-    alwaysUpdate: boolean;
-    autoSort: boolean;
-    container: ParticleContainer;
-    /**
-     * @ignore
-     */
-    set z(arg: number);
-    /**
-     * @ignore
-     */
-    get z(): number;
-    set floating(arg: boolean);
-    /**
-     * Floating property for particles, value is forwarded to the particle container <br>
-     * @type {boolean}
-     * @name floating
-     * @memberof ParticleEmitter
-     */
-    get floating(): boolean;
-    /**
-     * @ignore
-     */
-    onActivateEvent(): void;
-    /**
-     * @ignore
-     */
-    onDeactivateEvent(): void;
+    _updateCount: number;
+    settings: {};
+    _dt: number;
     /**
-     * @ignore
+     * Reset the emitter with particle emitter settings.
+     * @param {object} settings [optional] object with emitter settings. See {@link ParticleEmitterSettings}
      */
-    destroy(): void;
+    reset(settings?: object): void;
     /**
-     * returns a random point inside the bounds x axis of this emitter
-     * @name getRandomPointX
-     * @memberof ParticleEmitter
-     * @function
+     * returns a random point on the x axis within the bounds of this emitter
      * @returns {number}
      */
     getRandomPointX(): number;
     /**
-     * returns a random point inside the bounds y axis of this emitter
-     * @name getRandomPointY
-     * @memberof ParticleEmitter
-     * @function
+     * returns a random point on the y axis within the bounds this emitter
      * @returns {number}
      */
     getRandomPointY(): number;
-    /**
-     * Reset the emitter with default values.<br>
-     * @function
-     * @param {object} settings [optional] object with emitter settings. See {@link ParticleEmitterSettings}
-     * @name reset
-     * @memberof ParticleEmitter
-     */
-    reset(settings: object): void;
     /** @ignore */
     addParticles(count: any): void;
     /**
-     * Emitter is of type stream and is launching particles <br>
-     * @function
+     * Emitter is of type stream and is launching particles
      * @returns {boolean} Emitter is Stream and is launching particles
-     * @name isRunning
-     * @memberof ParticleEmitter
      */
     isRunning(): boolean;
     /**
-     * Launch particles from emitter constantly <br>
-     * Particles example: Fountains
+     * Launch particles from emitter constantly (e.g. for stream)
      * @param {number} duration [optional] time that the emitter releases particles in ms
-     * @function
-     * @name streamParticles
-     * @memberof ParticleEmitter
      */
     streamParticles(duration: number): void;
-    frequency: any;
     /**
-     * Stop the emitter from generating new particles (used only if emitter is Stream) <br>
-     * @function
-     * @name stopStream
-     * @memberof ParticleEmitter
+     * Stop the emitter from generating new particles (used only if emitter is Stream)
      */
     stopStream(): void;
     /**
-     * Launch all particles from emitter and stop <br>
-     * Particles example: Explosions <br>
+     * Launch all particles from emitter and stop (e.g. for explosion)
      * @param {number} total [optional] number of particles to launch
-     * @function
-     * @name burstParticles
-     * @memberof ParticleEmitter
      */
     burstParticles(total: number): void;
     /**
@@ -4231,32 +4442,35 @@ export class ParticleEmitter extends Rect {
     update(dt: any): boolean;
 }
 export namespace ParticleEmitterSettings {
-    export const width: number;
-    export const height: number;
-    export { pixel as image };
-    export const totalParticles: number;
-    export const angle: number;
-    export const angleVariation: number;
-    export const minLife: number;
-    export const maxLife: number;
-    export const speed: number;
-    export const speedVariation: number;
-    export const minRotation: number;
-    export const maxRotation: number;
-    export const minStartScale: number;
-    export const maxStartScale: number;
-    export const minEndScale: number;
-    export const maxEndScale: number;
-    export const gravity: number;
-    export const wind: number;
-    export const followTrajectory: boolean;
-    export const textureAdditive: boolean;
-    export const onlyInViewport: boolean;
-    export const floating: boolean;
-    export const maxParticles: number;
-    export const frequency: number;
-    export const duration: number;
-    export const framesToSkip: number;
+    const width: number;
+    const height: number;
+    const image: HTMLCanvasElement;
+    const textureSize: number;
+    const tint: string;
+    const totalParticles: number;
+    const angle: number;
+    const angleVariation: number;
+    const minLife: number;
+    const maxLife: number;
+    const speed: number;
+    const speedVariation: number;
+    const minRotation: number;
+    const maxRotation: number;
+    const minStartScale: number;
+    const maxStartScale: number;
+    const minEndScale: number;
+    const maxEndScale: number;
+    const gravity: number;
+    const wind: number;
+    const followTrajectory: boolean;
+    const textureAdditive: boolean;
+    const blendMode: string;
+    const onlyInViewport: boolean;
+    const floating: boolean;
+    const maxParticles: number;
+    const frequency: number;
+    const duration: number;
+    const framesToSkip: number;
 }
 /**
  * @classdesc
@@ -4950,6 +5164,16 @@ export class Rect extends Polygon {
      * @memberof Rect
      */
     public get centerY(): number;
+    /**
+     * center the rectangle position around the given coordinates
+     * @name centerOn
+     * @memberof Rect.prototype
+     * @function
+     * @param {number} x the x coordinate around which to center this rectangle
+     * @param {number} x the y coordinate around which to center this rectangle
+     * @returns {Rect} this rectangle
+     */
+    centerOn(x: number, y: any): Rect;
     /**
      * resize the rectangle
      * @name resize
@@ -5255,6 +5479,17 @@ export class Renderable extends Rect {
      * this.tint.setColor(255, 255, 255);
      */
     public tint: Color;
+    /**
+     * the blend mode to be applied to this renderable (see renderer setBlendMode for available blend mode)
+     * @public
+     * @type {string}
+     * @name blendMode
+     * @default "normal"
+     * @see CanvasRenderer#setBlendMode
+     * @see WebGLRenderer#setBlendMode
+     * @memberof Renderable#
+     */
+    public blendMode: string;
     /**
      * The name of the renderable
      * @public
@@ -6913,6 +7148,7 @@ export class Text extends Renderable {
      * @param {number} [settings.lineHeight=1.0] line spacing height
      * @param {Vector2d} [settings.anchorPoint={x:0.0, y:0.0}] anchor point to draw the text at
      * @param {boolean} [settings.offScreenCanvas=false] whether to draw the font to an individual "cache" texture first
+     * @param {number} [settings.wordWrapWidth] the maximum length in CSS pixel for a single segment of text
      * @param {(string|string[])} [settings.text=""] a string, or an array of strings
      * @example
      * var font = new me.Text(0, 0, {font: "Arial", size: 8, fillStyle: this.color});
@@ -6928,6 +7164,7 @@ export class Text extends Renderable {
         lineHeight?: number;
         anchorPoint?: Vector2d;
         offScreenCanvas?: boolean;
+        wordWrapWidth?: number;
         text?: (string | string[]);
     });
     /** @ignore */
@@ -6939,7 +7176,6 @@ export class Text extends Renderable {
      * @public
      * @type {number}
      * @default 1
-     * @name Text#lineWidth
      */
     public lineWidth: number;
     /**
@@ -6948,7 +7184,6 @@ export class Text extends Renderable {
      * @public
      * @type {string}
      * @default "left"
-     * @name Text#textAlign
      */
     public textAlign: string;
     /**
@@ -6957,7 +7192,6 @@ export class Text extends Renderable {
      * @public
      * @type {string}
      * @default "top"
-     * @name Text#textBaseline
      */
     public textBaseline: string;
     /**
@@ -6966,7 +7200,6 @@ export class Text extends Renderable {
      * @public
      * @type {number}
      * @default 1.0
-     * @name Text#lineHeight
      */
     public lineHeight: number;
     /**
@@ -6976,9 +7209,16 @@ export class Text extends Renderable {
      * @public
      * @type {boolean}
      * @default false
-     * @name Text#offScreenCanvas
      */
     public offScreenCanvas: boolean;
+    /**
+     * the maximum length in CSS pixel for a single segment of text.
+     * (use -1 to disable word wrapping)
+     * @public
+     * @type {number}
+     * @default -1
+     */
+    public wordWrapWidth: number;
     /**
      * the text to be displayed
      * @private
@@ -6988,38 +7228,28 @@ export class Text extends Renderable {
      * the font size (in px)
      * @public
      * @type {number}
-     * @name fontSize
      * @default 10
-     * @memberof Text
      */
     public fontSize: number;
     canvas: HTMLCanvasElement | OffscreenCanvas;
     context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
+    metrics: TextMetrics;
     /** @ignore */
     onDeactivateEvent(): void;
     glTextureUnit: any;
     /**
      * make the font bold
-     * @name bold
-     * @memberof Text.prototype
-     * @function
      * @returns {Text} this object for chaining
      */
     bold(): Text;
     font: any;
     /**
      * make the font italic
-     * @name italic
-     * @memberof Text.prototype
-     * @function
      * @returns {Text} this object for chaining
      */
     italic(): Text;
     /**
      * set the font family and size
-     * @name setFont
-     * @memberof Text.prototype
-     * @function
      * @param {string} font a CSS font name
      * @param {number|string} [size=10] size in px, or size + suffix (px, em, pt)
      * @returns {Text} this object for chaining
@@ -7030,33 +7260,19 @@ export class Text extends Renderable {
     setFont(font: string, size?: number | string): Text;
     /**
      * change the text to be displayed
-     * @name setText
-     * @memberof Text.prototype
-     * @function
      * @param {number|string|string[]} value a string, or an array of strings
      * @returns {Text} this object for chaining
      */
     setText(value?: number | string | string[]): Text;
     /**
      * measure the given text size in pixels
-     * @name measureText
-     * @memberof Text.prototype
-     * @function
      * @param {CanvasRenderer|WebGLRenderer} [renderer] reference to the active renderer
      * @param {string} [text] the text to be measured
-     * @param {Rect|Bounds} [ret] a object in which to store the text metrics
-     * @returns {TextMetrics} a TextMetrics object with two properties: `width` and `height`, defining the output dimensions
+     * @returns {TextMetrics} a TextMetrics object defining the dimensions of the given piece of text
      */
-    measureText(renderer?: CanvasRenderer | WebGLRenderer, text?: string, ret?: Rect | Bounds): TextMetrics;
-    /**
-     * @ignore
-     */
-    update(): boolean;
+    measureText(renderer$1?: CanvasRenderer | WebGLRenderer, text?: string): TextMetrics;
     /**
      * draw a text at the specified coord
-     * @name draw
-     * @memberof Text.prototype
-     * @function
      * @param {CanvasRenderer|WebGLRenderer} renderer Reference to the destination renderer instance
      * @param {string} [text]
      * @param {number} [x]
@@ -7068,9 +7284,6 @@ export class Text extends Renderable {
      * draw a stroke text at the specified coord, as defined <br>
      * by the `lineWidth` and `fillStroke` properties. <br>
      * Note : using drawStroke is not recommended for performance reasons
-     * @name drawStroke
-     * @memberof Text.prototype
-     * @function
      * @param {CanvasRenderer|WebGLRenderer} renderer Reference to the destination renderer instance
      * @param {string} text
      * @param {number} x
@@ -7080,7 +7293,7 @@ export class Text extends Renderable {
     /**
      * @ignore
      */
-    _drawFont(context: any, text: any, x: any, y: any, stroke?: boolean): Bounds;
+    _drawFont(context: any, text: any, x: any, y: any, stroke?: boolean): TextMetrics;
     /**
      * Destroy function
      * @ignore
@@ -8634,6 +8847,10 @@ export class WebGLRenderer extends Renderer {
      * @ignore
      */
     _scissorStack: any[];
+    /**
+     * @ignore
+     */
+    _blendStack: any[];
     /**
      * @ignore
      */
@@ -8799,14 +9016,25 @@ export class WebGLRenderer extends Renderer {
      */
     getContext(): WebGLRenderingContext;
     /**
-     * set a blend mode for the given context
+     * set a blend mode for the given context. <br>
+     * Supported blend mode between Canvas and WebGL remderer : <br>
+     * - "normal" : this is the default mode and draws new content on top of the existing content <br>
+     * <img src="images/normal-blendmode.png" width="510"/> <br>
+     * - "multiply" : the pixels of the top layer are multiplied with the corresponding pixel of the bottom layer. A darker picture is the result. <br>
+     * <img src="images/multiply-blendmode.png" width="510"/> <br>
+     * - "additive or lighter" : where both content overlap the color is determined by adding color values. <br>
+     * <img src="images/lighter-blendmode.png" width="510"/> <br>
+     * - "screen" : The pixels are inverted, multiplied, and inverted again. A lighter picture is the result (opposite of multiply) <br>
+     * <img src="images/screen-blendmode.png" width="510"/> <br>
      * @name setBlendMode
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/globalCompositeOperation
      * @memberof WebGLRenderer.prototype
      * @function
-     * @param {string} [mode="normal"] blend mode : "normal", "multiply"
+     * @param {string} [mode="normal"] blend mode : "normal", "multiply", "lighter", "additive", "screen"
      * @param {WebGLRenderingContext} [gl]
      */
     setBlendMode(mode?: string, gl?: WebGLRenderingContext): void;
+    currentBlendMode: any;
     /**
      * return a reference to the font 2d Context
      * @ignore
@@ -9161,7 +9389,7 @@ declare namespace device$1 {
     namespace turnOnPointerLock { }
     namespace turnOffPointerLock { }
 }
-export var event: Readonly<{
+declare var event$1: Readonly<{
     __proto__: any;
     BOOT: string;
     STATE_PAUSE: string;
@@ -9194,8 +9422,8 @@ export var event: Readonly<{
     WINDOW_ONORIENTATION_CHANGE: string;
     WINDOW_ONSCROLL: string;
     VIEWPORT_ONCHANGE: string;
-    WEBGL_ONCONTEXT_LOST: string;
-    WEBGL_ONCONTEXT_RESTORED: string;
+    ONCONTEXT_LOST: string;
+    ONCONTEXT_RESTORED: string;
     emit: typeof emit;
     on: typeof on;
     once: typeof once;
@@ -10168,184 +10396,16 @@ export var plugin: any;
  * @namespace plugins
  */
 export var plugins: {};
-export namespace pool {
-    /**
-     * register an object to the pool. <br>
-     * Pooling must be set to true if more than one such objects will be created. <br>
-     * (Note: for an object to be poolable, it must implements a `onResetEvent` method)
-     * @function pool.register
-     * @param {string} className as defined in the Name field of the Object Properties (in Tiled)
-     * @param {object} classObj corresponding Class to be instantiated
-     * @param {boolean} [recycling=false] enables object recycling for the specified class
-     * @example
-     * // implement CherryEntity
-     * class CherryEntity extends Spritesheet {
-     *    onResetEvent() {
-     *        // reset object mutable properties
-     *        this.lifeBar = 100;
-     *    }
-     * };
-     * // add our users defined entities in the object pool and enable object recycling
-     * me.pool.register("cherryentity", CherryEntity, true);
-     */
-    function register(className: string, classObj: any, recycling?: boolean): void;
-    /**
-     * register an object to the pool. <br>
-     * Pooling must be set to true if more than one such objects will be created. <br>
-     * (Note: for an object to be poolable, it must implements a `onResetEvent` method)
-     * @function pool.register
-     * @param {string} className as defined in the Name field of the Object Properties (in Tiled)
-     * @param {object} classObj corresponding Class to be instantiated
-     * @param {boolean} [recycling=false] enables object recycling for the specified class
-     * @example
-     * // implement CherryEntity
-     * class CherryEntity extends Spritesheet {
-     *    onResetEvent() {
-     *        // reset object mutable properties
-     *        this.lifeBar = 100;
-     *    }
-     * };
-     * // add our users defined entities in the object pool and enable object recycling
-     * me.pool.register("cherryentity", CherryEntity, true);
-     */
-    function register(className: string, classObj: any, recycling?: boolean): void;
-    /**
-     * Pull a new instance of the requested object (if added into the object pool)
-     * @function pool.pull
-     * @param {string} name as used in {@link pool.register}
-     * @param {object} [...arguments] arguments to be passed when instantiating/reinitializing the object
-     * @returns {object} the instance of the requested object
-     * @example
-     * me.pool.register("bullet", BulletEntity, true);
-     * me.pool.register("enemy", EnemyEntity, true);
-     * // ...
-     * // when we need to manually create a new bullet:
-     * var bullet = me.pool.pull("bullet", x, y, direction);
-     * // ...
-     * // params aren't a fixed number
-     * // when we need new enemy we can add more params, that the object construct requires:
-     * var enemy = me.pool.pull("enemy", x, y, direction, speed, power, life);
-     * // ...
-     * // when we want to destroy existing object, the remove
-     * // function will ensure the object can then be reallocated later
-     * me.game.world.removeChild(enemy);
-     * me.game.world.removeChild(bullet);
-     */
-    function pull(name: string, ...args: any[]): any;
-    /**
-     * Pull a new instance of the requested object (if added into the object pool)
-     * @function pool.pull
-     * @param {string} name as used in {@link pool.register}
-     * @param {object} [...arguments] arguments to be passed when instantiating/reinitializing the object
-     * @returns {object} the instance of the requested object
-     * @example
-     * me.pool.register("bullet", BulletEntity, true);
-     * me.pool.register("enemy", EnemyEntity, true);
-     * // ...
-     * // when we need to manually create a new bullet:
-     * var bullet = me.pool.pull("bullet", x, y, direction);
-     * // ...
-     * // params aren't a fixed number
-     * // when we need new enemy we can add more params, that the object construct requires:
-     * var enemy = me.pool.pull("enemy", x, y, direction, speed, power, life);
-     * // ...
-     * // when we want to destroy existing object, the remove
-     * // function will ensure the object can then be reallocated later
-     * me.game.world.removeChild(enemy);
-     * me.game.world.removeChild(bullet);
-     */
-    function pull(name: string, ...args: any[]): any;
-    /**
-     * purge the object pool from any inactive object <br>
-     * Object pooling must be enabled for this function to work<br>
-     * note: this will trigger the garbage collector
-     * @function pool.purge
-     */
-    function purge(): void;
-    /**
-     * purge the object pool from any inactive object <br>
-     * Object pooling must be enabled for this function to work<br>
-     * note: this will trigger the garbage collector
-     * @function pool.purge
-     */
-    function purge(): void;
-    /**
-     * Push back an object instance into the object pool <br>
-     * Object pooling for the object class must be enabled,
-     * and object must have been instantiated using {@link pool#pull},
-     * otherwise this function won't work
-     * @function pool.push
-     * @throws will throw an error if the object cannot be recycled
-     * @param {object} obj instance to be recycled
-     * @param {boolean} [throwOnError=true] throw an exception if the object cannot be recycled
-     * @returns {boolean} true if the object was successfully recycled in the object pool
-     */
-    function push(obj: any, throwOnError?: boolean): boolean;
-    /**
-     * Push back an object instance into the object pool <br>
-     * Object pooling for the object class must be enabled,
-     * and object must have been instantiated using {@link pool#pull},
-     * otherwise this function won't work
-     * @function pool.push
-     * @throws will throw an error if the object cannot be recycled
-     * @param {object} obj instance to be recycled
-     * @param {boolean} [throwOnError=true] throw an exception if the object cannot be recycled
-     * @returns {boolean} true if the object was successfully recycled in the object pool
-     */
-    function push(obj: any, throwOnError?: boolean): boolean;
-    /**
-     * Check if an object with the provided name is registered
-     * @function pool.exists
-     * @param {string} name of the registered object class
-     * @returns {boolean} true if the classname is registered
-     */
-    function exists(name: string): boolean;
-    /**
-     * Check if an object with the provided name is registered
-     * @function pool.exists
-     * @param {string} name of the registered object class
-     * @returns {boolean} true if the classname is registered
-     */
-    function exists(name: string): boolean;
-    /**
-     * Check if an object is poolable
-     * (was properly registered with the recycling feature enable)
-     * @function pool.poolable
-     * @see pool.register
-     * @param {object} obj object to be checked
-     * @returns {boolean} true if the object is poolable
-     * @example
-     * if (!me.pool.poolable(myCherryEntity)) {
-     *     // object was not properly registered
-     * }
-     */
-    function poolable(obj: any): boolean;
-    /**
-     * Check if an object is poolable
-     * (was properly registered with the recycling feature enable)
-     * @function pool.poolable
-     * @see pool.register
-     * @param {object} obj object to be checked
-     * @returns {boolean} true if the object is poolable
-     * @example
-     * if (!me.pool.poolable(myCherryEntity)) {
-     *     // object was not properly registered
-     * }
-     */
-    function poolable(obj: any): boolean;
-    /**
-     * returns the amount of object instance currently in the pool
-     * @function pool.getInstanceCount
-     * @returns {number} amount of object instance
-     */
-    function getInstanceCount(): number;
-    /**
-     * returns the amount of object instance currently in the pool
-     * @function pool.getInstanceCount
-     * @returns {number} amount of object instance
-     */
-    function getInstanceCount(): number;
-}
+declare var pooling: Readonly<{
+    __proto__: any;
+    register: typeof register;
+    pull: typeof pull;
+    purge: typeof purge;
+    push: typeof push;
+    exists: typeof exists;
+    poolable: typeof poolable;
+    getInstanceCount: typeof getInstanceCount;
+}>;
 export namespace save {
     /**
      * Add new keys to localStorage and set them to the given default values if they do not exist
@@ -10416,7 +10476,7 @@ export namespace state {
     const DEFAULT: number;
     const USER: number;
     /**
-     * Stop the current screen object.
+     * Stop the current stage.
      * @name stop
      * @memberof state
      * @public
@@ -10425,7 +10485,7 @@ export namespace state {
      */
     function stop(pauseTrack?: boolean): void;
     /**
-     * Stop the current screen object.
+     * Stop the current stage.
      * @name stop
      * @memberof state
      * @public
@@ -10434,7 +10494,7 @@ export namespace state {
      */
     function stop(pauseTrack?: boolean): void;
     /**
-     * pause the current screen object
+     * pause the current stage
      * @name pause
      * @memberof state
      * @public
@@ -10443,7 +10503,7 @@ export namespace state {
      */
     function pause(music?: boolean): void;
     /**
-     * pause the current screen object
+     * pause the current stage
      * @name pause
      * @memberof state
      * @public
@@ -10452,7 +10512,7 @@ export namespace state {
      */
     function pause(music?: boolean): void;
     /**
-     * Restart the screen object from a full stop.
+     * Restart the current stage from a full stop.
      * @name restart
      * @memberof state
      * @public
@@ -10461,7 +10521,7 @@ export namespace state {
      */
     function restart(music?: boolean): void;
     /**
-     * Restart the screen object from a full stop.
+     * Restart the current stage from a full stop.
      * @name restart
      * @memberof state
      * @public
@@ -10470,7 +10530,7 @@ export namespace state {
      */
     function restart(music?: boolean): void;
     /**
-     * resume the screen object
+     * resume the current stage
      * @name resume
      * @memberof state
      * @public
@@ -10479,7 +10539,7 @@ export namespace state {
      */
     function resume(music?: boolean): void;
     /**
-     * resume the screen object
+     * resume the current stage
      * @name resume
      * @memberof state
      * @public
@@ -10618,7 +10678,7 @@ export namespace state {
      */
     function set(state: number, stage: Stage, start?: boolean): void;
     /**
-     * return a reference to the current screen object<br>
+     * return a reference to the current stage<br>
      * useful to call a object specific method
      * @name current
      * @memberof state
@@ -10628,7 +10688,7 @@ export namespace state {
      */
     function current(): Stage;
     /**
-     * return a reference to the current screen object<br>
+     * return a reference to the current stage<br>
      * useful to call a object specific method
      * @name current
      * @memberof state
@@ -10946,6 +11006,51 @@ export var video: Readonly<{
  * @param {string} version the version since when the lass,function or property is deprecated
  */
 export function warning(deprecated: string, replacement: string, version: string): void;
+/**
+ * @classdesc
+ * a Text Metrics object that contains helper for text manipulation
+ * @augments Bounds
+ */
+declare class TextMetrics extends Bounds {
+    /**
+     * @param {Text|BitmapText} ancestor the parent object that contains this TextMetrics object
+     */
+    constructor(ancestor: Text | BitmapText);
+    /**
+     * a reference to the parent object that contains this TextMetrics object
+     * @public
+     * @type {Renderable}
+     * @default undefined
+     */
+    public ancestor: Renderable;
+    /**
+     * Returns the height of a segment of inline text in CSS pixels.
+     * @returns {number} the height of a segment of inline text in CSS pixels.
+     */
+    lineHeight(): number;
+    /**
+     * Returns the width of the given segment of inline text in CSS pixels.
+     * @param {string} text the text to be measured
+     * @param {CanvasRenderingContext2D} [context] reference to an active 2d context for canvas rendering
+     * @returns {number} the width of the given segment of inline text in CSS pixels.
+     */
+    lineWidth(text: string, context?: CanvasRenderingContext2D): number;
+    /**
+     * measure the given text size in CSS pixels
+     * @param {string} text the text to be measured
+     * @param {CanvasRenderingContext2D} [context] reference to an active 2d context for canvas rendering
+     * @returns {TextMetrics} this
+     */
+    measureText(text: string, context?: CanvasRenderingContext2D): TextMetrics;
+    /**
+     * wrap the given text based on the given width
+     * @param {string|string[]} text the text to be wrapped
+     * @param {number} width maximum width of one segment of text in css pixel
+     * @param {CanvasRenderingContext2D} [context] reference to an active 2d context for canvas rendering
+     * @returns {string[]} an array of string representing wrapped text
+     */
+    wordWrap(text: string | string[], width: number, context?: CanvasRenderingContext2D): string[];
+}
 /**
  * @classdesc
  * a bound object contains methods for creating and manipulating axis-aligned bounding boxes (AABB).
@@ -11383,31 +11488,6 @@ declare function round(num: number, dec?: number): number;
  * }
  */
 declare function toBeCloseTo(expected: number, actual: number, precision?: number): boolean;
-/**
- * @classdesc
- * Particle Container Object.
- * @class ParticleContainer
- * @augments Container
- * @param {ParticleEmitter} emitter the emitter which owns this container
- */
-declare class ParticleContainer extends Container {
-    /**
-     * @ignore
-     */
-    constructor(emitter: any);
-    _updateCount: number;
-    _dt: number;
-    _emitter: any;
-    /**
-     * @ignore
-     */
-    update(dt: any): boolean;
-    /**
-     * @ignore
-     */
-    draw(renderer: any, rect: any): void;
-}
-declare var pixel: HTMLCanvasElement | OffscreenCanvas;
 /**
  * @classdesc
  * a Vertex Buffer object
@@ -11951,7 +12031,6 @@ declare function releaseAllPointerEvents(region: Rect | Polygon | Line | Ellipse
  * @memberof input
  * @public
  * @function
- * @param {Function} [success] callback if the request is successful
  * @returns {boolean} return true if the request was successfully submitted
  * @example
  * // register on the pointer lock change event
@@ -12127,6 +12206,107 @@ declare function setGamepadDeadzone(value: number): void;
  * @ignore
  */
 declare function addMapping(id: any, mapping: any): void;
+/**
+ * This object is used for object pooling - a technique that might speed up your game if used properly.<br>
+ * If some of your classes will be instantiated and removed a lot at a time, it is a
+ * good idea to add the class to this object pool. A separate pool for that class
+ * will be created, which will reuse objects of the class. That way they won't be instantiated
+ * each time you need a new one (slowing your game), but stored into that pool and taking one
+ * already instantiated when you need it.<br><br>
+ * This object is also used by the engine to instantiate objects defined in the map,
+ * which means, that on level loading the engine will try to instantiate every object
+ * found in the map, based on the user defined name in each Object Properties<br>
+ * <img src="images/object_properties.png"/><br>
+ * @namespace pool
+ */
+/**
+ * register an object to the pool. <br>
+ * Pooling must be set to true if more than one such objects will be created. <br>
+ * (Note: for an object to be poolable, it must implements a `onResetEvent` method)
+ * @function pool.register
+ * @param {string} className as defined in the Name field of the Object Properties (in Tiled)
+ * @param {object} classObj corresponding Class to be instantiated
+ * @param {boolean} [recycling=false] enables object recycling for the specified class
+ * @example
+ * // implement CherryEntity
+ * class CherryEntity extends Spritesheet {
+ *    onResetEvent() {
+ *        // reset object mutable properties
+ *        this.lifeBar = 100;
+ *    }
+ * };
+ * // add our users defined entities in the object pool and enable object recycling
+ * me.pool.register("cherryentity", CherryEntity, true);
+ */
+declare function register(className: string, classObj: object, recycling?: boolean): void;
+/**
+ * Pull a new instance of the requested object (if added into the object pool)
+ * @function pool.pull
+ * @param {string} name as used in {@link pool.register}
+ * @param {object} [...arguments] arguments to be passed when instantiating/reinitializing the object
+ * @returns {object} the instance of the requested object
+ * @example
+ * me.pool.register("bullet", BulletEntity, true);
+ * me.pool.register("enemy", EnemyEntity, true);
+ * // ...
+ * // when we need to manually create a new bullet:
+ * var bullet = me.pool.pull("bullet", x, y, direction);
+ * // ...
+ * // params aren't a fixed number
+ * // when we need new enemy we can add more params, that the object construct requires:
+ * var enemy = me.pool.pull("enemy", x, y, direction, speed, power, life);
+ * // ...
+ * // when we want to destroy existing object, the remove
+ * // function will ensure the object can then be reallocated later
+ * me.game.world.removeChild(enemy);
+ * me.game.world.removeChild(bullet);
+ */
+declare function pull(name: string, ...args: any[]): object;
+/**
+ * purge the object pool from any inactive object <br>
+ * Object pooling must be enabled for this function to work<br>
+ * note: this will trigger the garbage collector
+ * @function pool.purge
+ */
+declare function purge(): void;
+/**
+ * Push back an object instance into the object pool <br>
+ * Object pooling for the object class must be enabled,
+ * and object must have been instantiated using {@link pool#pull},
+ * otherwise this function won't work
+ * @function pool.push
+ * @throws will throw an error if the object cannot be recycled
+ * @param {object} obj instance to be recycled
+ * @param {boolean} [throwOnError=true] throw an exception if the object cannot be recycled
+ * @returns {boolean} true if the object was successfully recycled in the object pool
+ */
+declare function push(obj: object, throwOnError?: boolean): boolean;
+/**
+ * Check if an object with the provided name is registered
+ * @function pool.exists
+ * @param {string} name of the registered object class
+ * @returns {boolean} true if the classname is registered
+ */
+declare function exists(name: string): boolean;
+/**
+ * Check if an object is poolable
+ * (was properly registered with the recycling feature enable)
+ * @function pool.poolable
+ * @see pool.register
+ * @param {object} obj object to be checked
+ * @returns {boolean} true if the object is poolable
+ * @example
+ * if (!me.pool.poolable(myCherryEntity)) {
+ *     // object was not properly registered
+ * }
+ */
+declare function poolable(obj: object): boolean;
+/**
+ * returns the amount of object instance currently in the pool
+ * @function pool.getInstanceCount
+ * @returns {number} amount of object instance
+ */
+declare function getInstanceCount(): number;
 declare var agentUtils: Readonly<{
     __proto__: any;
     prefixed: typeof prefixed;
@@ -12242,7 +12422,7 @@ declare function scale(x: number, y: number): void;
  * @name prefixed
  * @function
  * @param {string} name Property name
- * @param {object} [obj=window] Object or element reference to access
+ * @param {object} [obj=globalThis] Object or element reference to access
  * @returns {string} Value of property
  * @memberof utils.agent
  */
@@ -12254,7 +12434,7 @@ declare function prefixed(name: string, obj?: object): string;
  * @function
  * @param {string} name Property name
  * @param {string} value Property value
- * @param {object} [obj=window] Object or element reference to access
+ * @param {object} [obj=globalThis] Object or element reference to access
  * @returns {boolean} true if one of the vendor-prefixed property was found
  * @memberof utils.agent
  */
@@ -12419,4 +12599,4 @@ declare function defer(func: Function, thisArg: object, ...args: any[]): number;
  * @returns {Function} the function that will be throttled
  */
 declare function throttle(fn: Function, delay: number, no_trailing: any): Function;
-export { Bounds$1 as Bounds, math as Math, device$1 as device, timer$1 as timer };
+export { Bounds$1 as Bounds, math as Math, device$1 as device, event$1 as event, pooling as pool, timer$1 as timer };