@vpmedia/phaser 1.19.0 → 1.20.0

package/README.md

@@ -1,6 +1,6 @@
 # @vpmedia/phaser
 
-[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.19.0)](https://badge.fury.io/js/@vpmedia%2Fphaser)
+[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.20.0)](https://badge.fury.io/js/@vpmedia%2Fphaser)
 [![Node.js CI](https://github.com/vpmedia/phaser/actions/workflows/node.js.yml/badge.svg)](https://github.com/vpmedia/phaser/actions/workflows/node.js.yml)
 
 @vpmedia/phaser is the modern ECMAScript port of the popular Phaser game engine v2.6.2.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpmedia/phaser",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "@vpmedia/phaser is the modern ECMAScript port of the popular Phaser game engine v2.6.2",
   "author": "Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "husky": "^8.0.3",
     "jest": "^29.5.0",
     "lint-staged": "^13.2.1",
-    "prettier": "^2.8.8",
+    "prettier": "^2.8.7",
     "typescript": "^5.0.4"
   },
   "scripts": {

package/src/phaser/core/cache.js

@@ -1,6 +1,5 @@
 import { Texture } from '../display/webgl/texture';
 import { BaseTexture } from '../display/webgl/base_texture';
-import { RenderTexture } from '../display/webgl/render_texture';
 import { Signal } from './signal';
 import { Frame } from './frame';
 import { FrameData } from './frame_data';
@@ -85,7 +84,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {HTMLImageElement} data - TBD.
+   * @param data - TBD.
    * @returns {object} TBD.
    */
   addImage(key, url, data) {
@@ -113,7 +112,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {HTMLCanvasElement} data - TBD.
+   * @param data - TBD.
    * @param {object} atlasData - TBD.
    */
   addTextureAtlas(key, url, data, atlasData) {
@@ -132,7 +131,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {object} data - TBD.
+   * @param data - TBD.
    */
   addSound(key, url, data) {
     this._cache.sound[key] = {
@@ -149,7 +148,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {string} data - TBD.
+   * @param data - TBD.
    */
   addText(key, url, data) {
     this._cache.text[key] = { url, data };
@@ -160,11 +159,11 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {HTMLCanvasElement} data - TBD.
-   * @param {object} atlasData - TBD.
-   * @param {string} atlasType - TBD.
-   * @param {number} xSpacing - TBD.
-   * @param {number} ySpacing - TBD.
+   * @param data - TBD.
+   * @param atlasData - TBD.
+   * @param atlasType - TBD.
+   * @param xSpacing - TBD.
+   * @param ySpacing - TBD.
    */
   addBitmapFont(key, url, data, atlasData, atlasType, xSpacing = 0, ySpacing = 0) {
     const obj = {
@@ -186,7 +185,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {object} data - TBD.
+   * @param data - TBD.
    */
   addJSON(key, url, data) {
     this._cache.json[key] = { url, data };
@@ -197,7 +196,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} url - TBD.
-   * @param {XMLDocument} data - TBD.
+   * @param data - TBD.
    */
   addXML(key, url, data) {
     this._cache.xml[key] = { url, data };
@@ -236,7 +235,7 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {string} property - TBD.
-   * @param {any} value - TBD.
+   * @param value - TBD.
    */
   updateSound(key, property, value) {
     const sound = this.getSound(key);
@@ -248,7 +247,7 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @param {object} data - TBD.
+   * @param data - TBD.
    */
   decodedSound(key, data) {
     const sound = this.getSound(key);
@@ -414,7 +413,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {HTMLCanvasElement} TBD.
    */
   getCanvas(key) {
     return this.getItem(key, CANVAS, 'getCanvas', 'canvas');
@@ -423,8 +421,7 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @param {boolean} full - TBD.
-   * @returns {HTMLImageElement} TBD.
+   * @param full - TBD.
    */
   getImage(key = '__default', full = false) {
     let img = this.getItem(key, IMAGE, 'getImage');
@@ -440,7 +437,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {object} TBD.
    */
   getTextureFrame(key) {
     return this.getItem(key, TEXTURE, 'getTextureFrame', 'frame');
@@ -449,7 +445,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {object} TBD.
    */
   getSound(key) {
     return this.getItem(key, SOUND, 'getSound');
@@ -458,7 +453,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {object} TBD.
    */
   getSoundData(key) {
     return this.getItem(key, SOUND, 'getSoundData', 'data');
@@ -467,7 +461,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {object} TBD.
    */
   getText(key) {
     return this.getItem(key, TEXT, 'getText', 'data');
@@ -476,7 +469,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {object} TBD.
    */
   getBitmapData(key) {
     return this.getItem(key, BITMAPDATA, 'getBitmapData', 'data');
@@ -485,7 +477,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {object} TBD.
    */
   getBitmapFont(key) {
     return this.getItem(key, BITMAPFONT, 'getBitmapFont');
@@ -495,7 +486,6 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {boolean} isClone - TBD.
-   * @returns {object} TBD.
    */
   getJSON(key, isClone = false) {
     const data = this.getItem(key, JSON, 'getJSON', 'data');
@@ -505,7 +495,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {XMLDocument} TBD.
    */
   getXML(key) {
     return this.getItem(key, XML, 'getXML', 'data');
@@ -514,7 +503,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @returns {RenderTexture} TBD.
    */
   getRenderTexture(key) {
     return this.getItem(key, RENDER_TEXTURE, 'getRenderTexture');
@@ -526,7 +514,6 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {number} cache - TBD.
-   * @returns {BaseTexture} TBD.
    */
   getBaseTexture(key, cache = IMAGE) {
     return this.getItem(key, cache, 'getBaseTexture', 'base');
@@ -536,7 +523,6 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {number} cache - TBD.
-   * @returns {Frame} TBD.
    */
   getFrame(key, cache = IMAGE) {
     return this.getItem(key, cache, 'getFrame', 'frame');
@@ -546,7 +532,6 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {number} cache - TBD.
-   * @returns {number} TBD.
    */
   getFrameCount(key, cache = IMAGE) {
     const data = this.getFrameData(key, cache);
@@ -560,7 +545,6 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {number} cache - TBD.
-   * @returns {FrameData} TBD.
    */
   getFrameData(key, cache = IMAGE) {
     return this.getItem(key, cache, 'getFrameData', 'frameData');
@@ -570,7 +554,6 @@ export class Cache {
    * TBD.
    * @param {string} key - TBD.
    * @param {number} cache - TBD.
-   * @returns {boolean} TBD.
    */
   hasFrameData(key, cache = IMAGE) {
     return this.getItem(key, cache, '', 'frameData') !== null;
@@ -579,7 +562,7 @@ export class Cache {
   /**
    * TBD.
    * @param {string} key - TBD.
-   * @param {FrameData} frameData - TBD.
+   * @param frameData - TBD.
    * @param {number} cache - TBD.
    */
   updateFrameData(key, frameData, cache = IMAGE) {
@@ -593,7 +576,6 @@ export class Cache {
    * @param {string} key - TBD.
    * @param {number} index - TBD.
    * @param {number} cache - TBD.
-   * @returns {Frame} TBD.
    */
   getFrameByIndex(key, index, cache = IMAGE) {
     const data = this.getFrameData(key, cache);
@@ -608,7 +590,6 @@ export class Cache {
    * @param {string} key - TBD.
    * @param {string} name - TBD.
    * @param {number} cache - TBD.
-   * @returns {Frame} TBD.
    */
   getFrameByName(key, name, cache = IMAGE) {
     const data = this.getFrameData(key, cache);
@@ -621,7 +602,6 @@ export class Cache {
   /**
    * TBD.
    * @param {string} url - TBD.
-   * @returns {string} TBD.
    */
   getURL(url) {
     const resolvedURL = this._resolveURL(url);
@@ -635,7 +615,6 @@ export class Cache {
   /**
    * TBD.
    * @param {object} cache - TBD.
-   * @returns {string[]} TBD.
    */
   getKeys(cache = IMAGE) {
     const result = [];
@@ -760,7 +739,7 @@ export class Cache {
   /**
    * TBD.
    * @param {string} url - TBD.
-   * @param {object} data - TBD.
+   * @param data - TBD.
    * @returns {string} TBD.
    */
   _resolveURL(url, data) {

package/src/phaser/core/dom.js

@@ -201,7 +201,7 @@ export class DOM {
 
   /**
    * TBD.
-   * @param {HTMLCanvasElement} element - TBD.
+   * @param element - TBD.
    * @param {Point} point - TBD.
    * @returns {Point} TBD.
    */
@@ -219,7 +219,7 @@ export class DOM {
 
   /**
    * TBD.
-   * @param {HTMLCanvasElement} element - TBD.
+   * @param element - TBD.
    * @param {number} cushion - TBD.
    * @returns {boolean} TBD.
    */
@@ -233,7 +233,7 @@ export class DOM {
 
   /**
    * TBD.
-   * @param {DOMRect} coords - TBD.
+   * @param coords - TBD.
    * @param {number} cushion - TBD.
    * @returns {object} TBD.
    */

package/src/phaser/core/input.js

@@ -1,6 +1,5 @@
 import { ArraySet } from './array_set';
 import { Graphics } from '../display/graphics';
-import { DisplayObject } from '../display/display_object';
 import { Image } from '../display/image';
 import { Signal } from './signal';
 import { Point } from '../geom/point';
@@ -126,7 +125,7 @@ export class Input {
   /**
    * TBD.
    * @param {Function} callback - TBD.
-   * @param {object} context - TBD.
+   * @param context - TBD.
    */
   setInteractiveCandidateHandler(callback, context) {
     this.customCandidateHandler = callback;
@@ -136,7 +135,7 @@ export class Input {
   /**
    * TBD.
    * @param {Function} callback - TBD.
-   * @param {object} context - TBD.
+   * @param context - TBD.
    */
   addMoveCallback(callback, context) {
     this.moveCallbacks.push({ callback, context });
@@ -145,7 +144,7 @@ export class Input {
   /**
    * TBD.
    * @param {Function} callback - TBD.
-   * @param {object} context - TBD.
+   * @param context - TBD.
    */
   deleteMoveCallback(callback, context) {
     let i = this.moveCallbacks.length;
@@ -299,7 +298,7 @@ export class Input {
 
   /**
    * TBD.
-   * @param {number} limit - TBD.
+   * @param limit - TBD.
    * @returns {number} TBD.
    */
   countActivePointers(limit = this.pointers.length) {
@@ -330,7 +329,7 @@ export class Input {
 
   /**
    * TBD.
-   * @param {number} identifier - TBD.
+   * @param identifier - TBD.
    * @returns {Pointer} TBD.
    */
   getPointerFromIdentifier(identifier) {
@@ -346,7 +345,7 @@ export class Input {
 
   /**
    * TBD.
-   * @param {number} pointerId - TBD.
+   * @param pointerId - TBD.
    * @returns {Pointer} TBD.
    */
   getPointerFromId(pointerId) {
@@ -362,9 +361,9 @@ export class Input {
 
   /**
    * TBD.
-   * @param {DisplayObject} displayObject - TBD.
-   * @param {Pointer} pointer - TBD.
-   * @param {Point} output - TBD.
+   * @param displayObject - TBD.
+   * @param pointer - TBD.
+   * @param output - TBD.
    * @returns {Point} TBD.
    */
   getLocalPosition(displayObject, pointer, output = null) {
@@ -379,9 +378,9 @@ export class Input {
 
   /**
    * TBD.
-   * @param {DisplayObject} displayObject - TBD.
-   * @param {Pointer} pointer - TBD.
-   * @param {Point} localPoint - TBD.
+   * @param displayObject - TBD.
+   * @param pointer - TBD.
+   * @param localPoint - TBD.
    * @returns {boolean} TBD.
    */
   hitTest(displayObject, pointer, localPoint) {

package/src/phaser/core/input_handler.js

@@ -3,13 +3,12 @@ import { GROUP } from './const';
 import { distance } from '../util/math';
 import { Pointer } from './input_pointer';
 import { Rectangle } from '../geom/rectangle';
-import { Image } from '../display/image';
 import { DisplayObject } from '../display/display_object';
 
 export class InputHandler {
   /**
    * TBD.
-   * @param {Image} sprite - TBD.
+   * @param sprite
    */
   constructor(sprite) {
     this.sprite = sprite;

package/src/phaser/core/input_mouse.js

@@ -12,8 +12,8 @@ import { Game } from './game';
 class WheelEventProxy {
   /**
    * TBD.
-   * @param {number} scaleFactor - TBD.
-   * @param {number} deltaMode - TBD.
+   * @param scaleFactor - TBD.
+   * @param deltaMode - TBD.
    */
   constructor(scaleFactor, deltaMode) {
     this._scaleFactor = scaleFactor;
@@ -48,7 +48,6 @@ class WheelEventProxy {
 
   /**
    * TBD.
-   * @returns {number} TBD.
    */
   get deltaMode() {
     return this._deltaMode;

package/src/phaser/core/input_pointer.js

@@ -9,7 +9,6 @@ import {
   MOUSE_TOUCH_COMBINE,
 } from './const';
 import { Game } from './game';
-import { InputHandler } from './input_handler';
 
 export class Pointer {
   /**
@@ -303,7 +302,7 @@ export class Pointer {
 
   /**
    * TBD.
-   * @param {InputHandler} newTarget - TBD.
+   * @param newTarget - TBD.
    * @param {boolean} silent - TBD.
    */
   swapTarget(newTarget, silent = false) {