melonjs 10.4.0 → 10.5.2

package/dist/melonjs.module.d.ts

@@ -142,6 +142,10 @@ export class BitmapText extends Renderable {
      * @returns {TextMetrics} a TextMetrics object with two properties: `width` and `height`, defining the output dimensions
      */
     measureText(text?: string, ret?: Rect): TextMetrics;
+    /**
+     * @ignore
+     */
+    update(): boolean;
     /**
      * draw the bitmap font
      * @name draw
@@ -266,7 +270,8 @@ export class Body {
     public mass: number;
     maxVel: Vector2d;
     /**
-     * either this body is a static body or not
+     * Either this body is a static body or not.
+     * A static body is completely fixed and can never change position or angle.
      * @readonly
      * @public
      * @type {boolean}
@@ -2064,17 +2069,6 @@ export class Container extends Renderable {
      * @ignore
      */
     _sortY(a: any, b: any): number;
-    /**
-     * container update function. <br>
-     * automatically called by the game manager {@link game}
-     * @name update
-     * @memberof Container.prototype
-     * @function
-     * @protected
-     * @param {number} dt time since the last update in milliseconds.
-     * @returns {boolean} true if the Container is dirty
-     */
-    protected update(dt: number): boolean;
     /**
      * draw the container. <br>
      * automatically called by the game manager {@link game}
@@ -2089,21 +2083,14 @@ export class Container extends Renderable {
 }
 /**
  * @classdesc
- * Used to make a game entity draggable
- * @augments Entity
+ * A Draggable base object
+ * @see DropTarget
+ * @augments Renderable
  */
-export class DraggableEntity extends Entity {
-    /**
-     * @param {number} x the x coordinates of the entity object
-     * @param {number} y the y coordinates of the entity object
-     * @param {object} settings Entity properties (see {@link Entity})
-     */
-    constructor(x: number, y: number, settings: object);
+export class Draggable extends Renderable {
     dragging: boolean;
     dragId: any;
     grabOffset: Vector2d;
-    onPointerEvent: typeof registerPointerEvent;
-    removePointerEvent: typeof releasePointerEvent;
     /**
      * Initializes the events the modules needs to listen to
      * It translates the pointer events to me.events
@@ -2111,31 +2098,15 @@ export class DraggableEntity extends Entity {
      * this module testable. Then we subscribe this module to the
      * transformed events.
      * @name initEvents
-     * @memberof DraggableEntity
+     * @memberof Draggable
      * @function
+     * @private
      */
-    initEvents(): void;
-    /**
-     * @ignore
-     */
-    mouseDown: (e: any) => void;
-    /**
-     * @ignore
-     */
-    mouseUp: (e: any) => void;
-    /**
-     * Translates a pointer event to a me.event
-     * @name translatePointerEvent
-     * @memberof DraggableEntity
-     * @function
-     * @param {object} e the pointer event you want to translate
-     * @param {string} translation the me.event you want to translate the event to
-     */
-    translatePointerEvent(e: object, translation: string): void;
+    private initEvents;
     /**
      * Gets called when the user starts dragging the entity
      * @name dragStart
-     * @memberof DraggableEntity
+     * @memberof Draggable
      * @function
      * @param {object} e the pointer event
      * @returns {boolean} false if the object is being dragged
@@ -2144,7 +2115,7 @@ export class DraggableEntity extends Entity {
     /**
      * Gets called when the user drags this entity around
      * @name dragMove
-     * @memberof DraggableEntity
+     * @memberof Draggable
      * @function
      * @param {object} e the pointer event
      */
@@ -2152,7 +2123,7 @@ export class DraggableEntity extends Entity {
     /**
      * Gets called when the user stops dragging the entity
      * @name dragEnd
-     * @memberof DraggableEntity
+     * @memberof Draggable
      * @function
      * @returns {boolean} false if the object stopped being dragged
      */
@@ -2160,30 +2131,41 @@ export class DraggableEntity extends Entity {
     /**
      * Destructor
      * @name destroy
-     * @memberof DraggableEntity
+     * @memberof Draggable
      * @function
+     * @ignore
      */
     destroy(): void;
 }
 /**
  * @classdesc
- * Used to make a game entity a droptarget
+ * Used to make a game entity draggable
  * @augments Entity
+ * @deprecated since 10.5.0
+ * @see Draggable
  */
-export class DroptargetEntity extends Entity {
+export class DraggableEntity extends Entity {
     /**
-     * @param {number} x the x coordinates of the entity object
-     * @param {number} y the y coordinates of the entity object
+     * @param {number} x the x coordinates of the draggable object
+     * @param {number} y the y coordinates of the draggable object
      * @param {object} settings Entity properties (see {@link Entity})
      */
     constructor(x: number, y: number, settings: object);
+}
+/**
+ * @classdesc
+ * a base drop target object
+ * @see Draggable
+ * @augments Renderable
+ */
+export class DropTarget extends Renderable {
     /**
      * constant for the overlaps method
      * @public
      * @constant
      * @type {string}
      * @name CHECKMETHOD_OVERLAP
-     * @memberof DroptargetEntity
+     * @memberof DropTarget
      */
     public CHECKMETHOD_OVERLAP: string;
     /**
@@ -2192,7 +2174,7 @@ export class DroptargetEntity extends Entity {
      * @constant
      * @type {string}
      * @name CHECKMETHOD_CONTAINS
-     * @memberof DroptargetEntity
+     * @memberof DropTarget
      */
     public CHECKMETHOD_CONTAINS: string;
     /**
@@ -2201,13 +2183,14 @@ export class DroptargetEntity extends Entity {
      * @constant
      * @type {string}
      * @name checkMethod
-     * @memberof DroptargetEntity
+     * @default "overlaps"
+     * @memberof DropTarget
      */
     public checkMethod: string;
     /**
      * Sets the collision method which is going to be used to check a valid drop
      * @name setCheckMethod
-     * @memberof DroptargetEntity
+     * @memberof DropTarget
      * @function
      * @param {string} checkMethod the checkmethod (defaults to CHECKMETHOD_OVERLAP)
      */
@@ -2215,28 +2198,44 @@ export class DroptargetEntity extends Entity {
     /**
      * Checks if a dropped entity is dropped on the current entity
      * @name checkOnMe
-     * @memberof DroptargetEntity
+     * @memberof DropTarget
      * @function
      * @param {object} e the triggering event
-     * @param {object} draggableEntity the draggable entity that is dropped
+     * @param {Draggable} draggable the draggable object that is dropped
      */
-    checkOnMe(e: object, draggableEntity: object): void;
+    checkOnMe(e: object, draggable: Draggable): void;
     /**
      * Gets called when a draggable entity is dropped on the current entity
      * @name drop
-     * @memberof DroptargetEntity
+     * @memberof DropTarget
      * @function
-     * @param {object} draggableEntity the draggable entity that is dropped
+     * @param {Draggable} draggable the draggable object that is dropped
      */
     drop(): void;
     /**
      * Destructor
      * @name destroy
-     * @memberof DroptargetEntity
+     * @memberof DropTarget
      * @function
+     * @ignore
      */
     destroy(): void;
 }
+/**
+ * @classdesc
+ * Used to make a game entity a droptarget
+ * @augments Entity
+ * @deprecated since 10.5.0
+ * @see DropTarget
+ */
+export class DroptargetEntity extends Entity {
+    /**
+     * @param {number} x the x coordinates of the draggable object
+     * @param {number} y the y coordinates of the draggable object
+     * @param {object} settings Entity properties (see {@link Entity})
+     */
+    constructor(x: number, y: number, settings: object);
+}
 /**
  * @classdesc
  * an ellipse Object
@@ -2873,16 +2872,6 @@ export class ImageLayer extends Renderable {
      * @ignore
      */
     preDraw(renderer: any): void;
-    /**
-     * draw the ImageLayer. <br>
-     * automatically called by the game manager {@link game}
-     * @name draw
-     * @memberof ImageLayer.prototype
-     * @function
-     * @protected
-     * @param {CanvasRenderer|WebGLRenderer} renderer a renderer object
-     */
-    protected draw(renderer: CanvasRenderer | WebGLRenderer): void;
     onDeactivateEvent(): void;
     /**
      * Destroy function<br>
@@ -4093,16 +4082,6 @@ export class Particle extends Renderable {
     onlyInViewport: any;
     _deltaInv: number;
     angle: number;
-    /**
-     * Update the Particle <br>
-     * This is automatically called by the game manager {@link game}
-     * @name update
-     * @memberof Particle
-     * @function
-     * @ignore
-     * @param {number} dt time since the last update in milliseconds
-     */
-    update(dt: number): boolean;
     /**
      * @ignore
      */
@@ -5459,7 +5438,7 @@ export class Renderable extends Rect {
      * @param {number} dt time since the last update in milliseconds.
      * @returns {boolean} true if the renderable is dirty
      */
-    protected update(): boolean;
+    protected update(dt: number): boolean;
     /**
      * update the renderable's bounding rect (private)
      * @ignore
@@ -5507,7 +5486,7 @@ export class Renderable extends Rect {
      * @protected
      * @param {CanvasRenderer|WebGLRenderer} renderer a renderer object
      */
-    protected draw(): void;
+    protected draw(renderer: CanvasRenderer | WebGLRenderer): void;
     /**
      * restore the rendering context after drawing. <br>
      * automatically called by the game manager {@link game}
@@ -6097,32 +6076,11 @@ export class Sprite extends Renderable {
      * @returns {number} if using number indices. Returns {object} containing frame data if using texture atlas
      */
     getAnimationFrameObjectByIndex(id: number): number;
-    /**
-     * update function. <br>
-     * automatically called by the game manager {@link game}
-     * @name update
-     * @memberof Sprite.prototype
-     * @function
-     * @protected
-     * @param {number} dt time since the last update in milliseconds.
-     * @returns {boolean} true if the Sprite is dirty
-     */
-    protected update(dt: number): boolean;
     /**
      * Destroy function<br>
      * @ignore
      */
     destroy(): void;
-    /**
-     * sprite draw. <br>
-     * automatically called by the game manager {@link game}
-     * @name draw
-     * @memberof Sprite.prototype
-     * @function
-     * @protected
-     * @param {CanvasRenderer|WebGLRenderer} renderer a renderer object
-     */
-    protected draw(renderer: CanvasRenderer | WebGLRenderer): void;
 }
 /**
  * @classdesc
@@ -7090,6 +7048,10 @@ export class Text extends Renderable {
      * @returns {TextMetrics} a TextMetrics object with two properties: `width` and `height`, defining the output dimensions
      */
     measureText(renderer?: CanvasRenderer | WebGLRenderer, text?: string, ret?: Rect | Bounds): TextMetrics;
+    /**
+     * @ignore
+     */
+    update(): boolean;
     /**
      * draw a text at the specified coord
      * @name draw
@@ -8510,6 +8472,14 @@ export class WebGLCompositor {
      * @ignore
      */
     uploadTexture(texture: any, w: any, h: any, b: any, force?: boolean): any;
+    /**
+     * set/change the current projection matrix
+     * @name setProjection
+     * @memberof WebGLCompositor
+     * @function
+     * @param {Matrix3d} matrix
+     */
+    setProjection(matrix: Matrix3d): void;
     /**
      * Select the shader to use for compositing
      * @name useShader
@@ -9187,10 +9157,6 @@ export function boot(): void;
  * @namespace collision
  */
 export var collision: any;
-export var deprecated: Readonly<{
-    __proto__: any;
-    warning: typeof warning;
-}>;
 declare namespace device$1 {
     namespace turnOnPointerLock { }
     namespace turnOffPointerLock { }
@@ -10969,6 +10935,17 @@ export var video: Readonly<{
     getParent: typeof getParent;
     scale: typeof scale;
 }>;
+/**
+ * placeholder for all deprecated classes and corresponding alias for backward compatibility
+ */
+/**
+ * display a deprecation warning in the console
+ * @ignore
+ * @param {string} deprecated deprecated class,function or property name
+ * @param {string} replacement the replacement class, function, or property name
+ * @param {string} version the version since when the lass,function or property is deprecated
+ */
+export function warning(deprecated: string, replacement: string, version: string): void;
 /**
  * @classdesc
  * a bound object contains methods for creating and manipulating axis-aligned bounding boxes (AABB).
@@ -11241,7 +11218,7 @@ declare class TextureCache {
      * @ignore
      */
     constructor(max_size: any);
-    cache: Map<any, any>;
+    cache: any;
     tinted: Map<any, any>;
     units: Map<any, any>;
     max_size: any;
@@ -11269,67 +11246,12 @@ declare class TextureCache {
     /**
      * @ignore
      */
-    set(image: any, texture: any): void;
+    set(image: any, texture: any): any;
     /**
      * @ignore
      */
     getUnit(texture: any): any;
 }
-/**
- * allows registration of event listeners on the object target. <br>
- * melonJS will pass a me.Pointer object to the defined callback.
- * @see Pointer
- * @see {@link http://www.w3.org/TR/pointerevents/#list-of-pointer-events|W3C Pointer Event list}
- * @name registerPointerEvent
- * @memberof input
- * @public
- * @function
- * @param {string} eventType The event type for which the object is registering <br>
- * melonJS currently supports: <br>
- * <ul>
- *   <li><code>"pointermove"</code></li>
- *   <li><code>"pointerdown"</code></li>
- *   <li><code>"pointerup"</code></li>
- *   <li><code>"pointerenter"</code></li>
- *   <li><code>"pointerover"</code></li>
- *   <li><code>"pointerleave"</code></li>
- *   <li><code>"pointercancel"</code></li>
- *   <li><code>"wheel"</code></li>
- * </ul>
- * @param {Rect|Polygon|Line|Ellipse} region a shape representing the region to register on
- * @param {Function} callback methods to be called when the event occurs.
- * Returning `false` from the defined callback will prevent the event to be propagated to other objects
- * @example
- *  // onActivate function
- *  onActivateEvent: function () {
- *     // register on the 'pointerdown' event
- *     me.input.registerPointerEvent('pointerdown', this, this.pointerDown.bind(this));
- *  },
- *
- *  // pointerDown event callback
- *  pointerDown: function (pointer) {
- *    // do something
- *    ....
- *    // don"t propagate the event to other objects
- *    return false;
- *  },
- */
-declare function registerPointerEvent(eventType: string, region: Rect | Polygon | Line | Ellipse, callback: Function): void;
-/**
- * allows the removal of event listeners from the object target.
- * @see {@link http://www.w3.org/TR/pointerevents/#list-of-pointer-events|W3C Pointer Event list}
- * @name releasePointerEvent
- * @memberof input
- * @public
- * @function
- * @param {string} eventType The event type for which the object was registered. See {@link input.registerPointerEvent}
- * @param {Rect|Polygon|Line|Ellipse} region the registered region to release for this event
- * @param {Function} [callback="all"] if specified unregister the event only for the specific callback
- * @example
- * // release the registered region on the 'pointerdown' event
- * me.input.releasePointerEvent('pointerdown', this);
- */
-declare function releasePointerEvent(eventType: string, region: Rect | Polygon | Line | Ellipse, callback?: Function): void;
 /**
  * returns true if the given value is a power of two
  * @public
@@ -11799,17 +11721,6 @@ declare function unload(sound_name: string): boolean;
  * me.audio.unloadAll();
  */
 declare function unloadAll(): void;
-/**
- * placeholder for all deprecated classes and corresponding alias for backward compatibility
- */
-/**
- * display a deprecation warning in the console
- * @ignore
- * @param {string} deprecated deprecated class,function or property name
- * @param {string} replacement the replacement class, function, or property name
- * @param {string} version the version since when the lass,function or property is deprecated
- */
-declare function warning(deprecated: string, replacement: string, version: string): void;
 /**
  * calls each of the listeners registered for a given event.
  * @function event.emit
@@ -11966,6 +11877,61 @@ declare function bindPointer(...args: any[]): void;
  * me.input.unbindPointer(me.input.pointer.LEFT);
  */
 declare function unbindPointer(button?: number): void;
+/**
+ * allows registration of event listeners on the object target. <br>
+ * melonJS will pass a me.Pointer object to the defined callback.
+ * @see Pointer
+ * @see {@link http://www.w3.org/TR/pointerevents/#list-of-pointer-events|W3C Pointer Event list}
+ * @name registerPointerEvent
+ * @memberof input
+ * @public
+ * @function
+ * @param {string} eventType The event type for which the object is registering <br>
+ * melonJS currently supports: <br>
+ * <ul>
+ *   <li><code>"pointermove"</code></li>
+ *   <li><code>"pointerdown"</code></li>
+ *   <li><code>"pointerup"</code></li>
+ *   <li><code>"pointerenter"</code></li>
+ *   <li><code>"pointerover"</code></li>
+ *   <li><code>"pointerleave"</code></li>
+ *   <li><code>"pointercancel"</code></li>
+ *   <li><code>"wheel"</code></li>
+ * </ul>
+ * @param {Rect|Polygon|Line|Ellipse} region a shape representing the region to register on
+ * @param {Function} callback methods to be called when the event occurs.
+ * Returning `false` from the defined callback will prevent the event to be propagated to other objects
+ * @example
+ *  // onActivate function
+ *  onActivateEvent: function () {
+ *     // register on the 'pointerdown' event
+ *     me.input.registerPointerEvent('pointerdown', this, this.pointerDown.bind(this));
+ *  },
+ *
+ *  // pointerDown event callback
+ *  pointerDown: function (pointer) {
+ *    // do something
+ *    ....
+ *    // don"t propagate the event to other objects
+ *    return false;
+ *  },
+ */
+declare function registerPointerEvent(eventType: string, region: Rect | Polygon | Line | Ellipse, callback: Function): void;
+/**
+ * allows the removal of event listeners from the object target.
+ * @see {@link http://www.w3.org/TR/pointerevents/#list-of-pointer-events|W3C Pointer Event list}
+ * @name releasePointerEvent
+ * @memberof input
+ * @public
+ * @function
+ * @param {string} eventType The event type for which the object was registered. See {@link input.registerPointerEvent}
+ * @param {Rect|Polygon|Line|Ellipse} region the registered region to release for this event
+ * @param {Function} [callback="all"] if specified unregister the event only for the specific callback
+ * @example
+ * // release the registered region on the 'pointerdown' event
+ * me.input.releasePointerEvent('pointerdown', this);
+ */
+declare function releasePointerEvent(eventType: string, region: Rect | Polygon | Line | Ellipse, callback?: Function): void;
 /**
  * allows the removal of all registered event listeners from the object target.
  * @name releaseAllPointerEvents