@vpmedia/phaser 1.17.0 → 1.18.0

package/README.md

@@ -1,6 +1,6 @@
 # @vpmedia/phaser
 
-[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.17.0)](https://badge.fury.io/js/@vpmedia%2Fphaser)
+[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.18.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.17.0",
+  "version": "1.18.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",
@@ -22,11 +22,11 @@
   "main": "./src/index.js",
   "types": "./types/index.d.ts",
   "devDependencies": {
-    "eslint": "^8.38.0",
+    "eslint": "^8.39.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-plugin-import": "^2.27.5",
     "eslint-plugin-jest": "^27.2.1",
-    "eslint-plugin-jsdoc": "^43.0.6",
+    "eslint-plugin-jsdoc": "^43.0.7",
     "eslint-plugin-prettier": "^4.2.1",
     "husky": "^8.0.3",
     "jest": "^29.5.0",

package/src/phaser/core/animation.js

@@ -1,15 +1,16 @@
 import { Game } from './game';
 import { Signal } from './signal';
 import { FrameData } from './frame_data';
+import { Image } from '../display/image';
 
 export class Animation {
   /**
    * TBD.
    * @param {Game} game - TBD.
-   * @param parent - TBD.
+   * @param {Image} parent - TBD.
    * @param {string} name - TBD.
    * @param {FrameData} frameData - TBD.
-   * @param frames - TBD.
+   * @param {string[]|number[]} frames - TBD.
    * @param {number} frameRate - TBD.
    * @param {boolean} loop - TBD.
    */

package/src/phaser/core/animation_manager.js

@@ -1,10 +1,11 @@
 import { Animation } from './animation';
 import { FrameData } from './frame_data';
+import { Image } from '../display/image';
 
 export class AnimationManager {
   /**
    * TBD.
-   * @param sprite - TBD.
+   * @param {Image} sprite - TBD.
    */
   constructor(sprite) {
     this.sprite = sprite;
@@ -131,7 +132,7 @@ export class AnimationManager {
 
   /**
    * TBD.
-   * @param {number[]} frames - TBD.
+   * @param {string[]|number[]} frames - TBD.
    * @param {boolean} useNumericIndex - TBD.
    * @returns {boolean} TBD.
    */

package/src/phaser/core/cache.js

@@ -113,7 +113,7 @@ export class Cache {
    * @param {string} key - TBD.
    * @param {string} url - TBD.
    * @param data - TBD.
-   * @param atlasData - TBD.
+   * @param {object} atlasData - TBD.
    */
   addTextureAtlas(key, url, data, atlasData) {
     const obj = {

package/src/phaser/core/const.js

@@ -169,25 +169,91 @@ export const TOUCH_OVERRIDES_MOUSE = 1;
  */
 export const MOUSE_TOUCH_COMBINE = 2;
 // game objects
+/**
+ * @type {number}
+ */
 export const GROUP = 7;
+/**
+ * @type {number}
+ */
 export const SPRITE = 0;
+/**
+ * @type {number}
+ */
 export const SPRITE_BATCH = 17;
+/**
+ * @type {number}
+ */
 export const BUTTON = 1;
+/**
+ * @type {number}
+ */
 export const IMAGE = 2;
+/**
+ * @type {number}
+ */
 export const GRAPHICS = 3;
+/**
+ * @type {number}
+ */
 export const TEXT = 4;
+/**
+ * @type {number}
+ */
 export const BITMAP_TEXT = 6;
+/**
+ * @type {number}
+ */
 export const TILE_SPRITE = 5;
+/**
+ * @type {number}
+ */
 export const RENDER_TEXTURE = 8;
+/**
+ * @type {number}
+ */
 export const FILTER_CANVAS = 14;
+/**
+ * @type {number}
+ */
 export const FILTER_WEBGL = 15;
+/**
+ * @type {number}
+ */
 export const POINTER = 19;
+/**
+ * @type {number}
+ */
 export const GEOM_POLYGON = 12;
+/**
+ * @type {number}
+ */
 export const GEOM_RECTANGLE = 22;
+/**
+ * @type {number}
+ */
 export const GEOM_CIRCLE = 21;
+/**
+ * @type {number}
+ */
 export const GEOM_ELLIPSE = 16;
+/**
+ * @type {number}
+ */
 export const GEOM_ROUNDED_RECTANGLE = 26;
+/**
+ * @type {number}
+ */
 export const GEOM_LINE = 23;
+/**
+ * @type {number}
+ */
 export const GEOM_MATRIX = 24;
+/**
+ * @type {number}
+ */
 export const GEOM_POINT = 25;
+/**
+ * @type {number}
+ */
 export const PENDING_ATLAS = -1;

package/src/phaser/core/device.js

@@ -3,35 +3,122 @@ export class Device {
    * TBD.
    */
   constructor() {
+    /**
+     * @type {boolean}
+     */
     this.desktop = false;
+    /**
+     * @type {boolean}
+     */
     this.iOS = false;
+    /**
+     * @type {boolean}
+     */
     this.android = false;
+    /**
+     * @type {boolean}
+     */
     this.chromeOS = false;
+    /**
+     * @type {boolean}
+     */
     this.linux = false;
+    /**
+     * @type {boolean}
+     */
     this.macOS = false;
+    /**
+     * @type {boolean}
+     */
     this.windows = false;
+    /**
+     * @type {boolean}
+     */
     this.windowsPhone = false;
+    /**
+     * @type {boolean}
+     */
     this.canvas = false;
+    /**
+     * @type {boolean}
+     */
     this.touch = false;
+    /**
+     * @type {boolean}
+     */
     this.mspointer = false;
     this.wheelEvent = null;
+    /**
+     * @type {boolean}
+     */
     this.chrome = false;
+    /**
+     * @type {boolean}
+     */
     this.firefox = false;
+    /**
+     * @type {boolean}
+     */
     this.edge = false;
+    /**
+     * @type {boolean}
+     */
     this.safari = false;
+    /**
+     * @type {boolean}
+     */
     this.silk = false;
+    /**
+     * @type {boolean}
+     */
     this.ogg = false;
+    /**
+     * @type {boolean}
+     */
     this.opus = false;
+    /**
+     * @type {boolean}
+     */
     this.mp3 = false;
+    /**
+     * @type {boolean}
+     */
     this.wav = false;
+    /**
+     * @type {boolean}
+     */
     this.m4a = false;
+    /**
+     * @type {boolean}
+     */
     this.webm = false;
+    /**
+     * @type {boolean}
+     */
     this.dolby = false;
+    /**
+     * @type {boolean}
+     */
     this.avif = false;
+    /**
+     * @type {boolean}
+     */
     this.webp = false;
+    /**
+     * @type {boolean}
+     */
     this.fullscreen = false;
+    /**
+     * @type {string}
+     */
     this.requestFullscreen = '';
+    /**
+     * @type {string}
+     */
     this.cancelFullscreen = '';
+    /**
+     * @type {boolean}
+     */
     this.fullscreenKeyboard = false;
   }
 }

package/src/phaser/core/dom.js

@@ -1,4 +1,5 @@
 import { Point } from '../geom/point';
+import { Device } from './device';
 
 class VisualBoundsDesktopRectangle {
   /**
@@ -182,7 +183,7 @@ class DocumentBoundsRectangle {
 export class DOM {
   /**
    * TBD.
-   * @param device
+   * @param {Device} device - TBD.
    */
   constructor(device) {
     this.treatAsDesktop =
@@ -200,8 +201,9 @@ export class DOM {
 
   /**
    * TBD.
-   * @param element
-   * @param point
+   * @param element - TBD.
+   * @param {Point} point - TBD.
+   * @returns {Point} TBD.
    */
   getOffset(element, point = null) {
     point = point || new Point();
@@ -217,8 +219,9 @@ export class DOM {
 
   /**
    * TBD.
-   * @param element
-   * @param cushion
+   * @param element - TBD.
+   * @param {number} cushion - TBD.
+   * @returns {boolean} TBD.
    */
   getBounds(element, cushion = 0) {
     element = element && !element.nodeType ? element[0] : element;
@@ -230,8 +233,9 @@ export class DOM {
 
   /**
    * TBD.
-   * @param coords
-   * @param cushion
+   * @param coords - TBD.
+   * @param {number} cushion - TBD.
+   * @returns {object} TBD.
    */
   calibrate(coords, cushion = 0) {
     const output = {
@@ -249,7 +253,8 @@ export class DOM {
 
   /**
    * TBD.
-   * @param primaryFallback
+   * @param {string} primaryFallback - TBD.
+   * @returns {string} TBD.
    */
   getScreenOrientation(primaryFallback) {
     const screen = window.screen;

package/src/phaser/core/event_manager.js

@@ -1,9 +1,10 @@
 import { Signal } from './signal';
+import { DisplayObject } from '../display/display_object';
 
 export class EventManager {
   /**
    * TBD.
-   * @param sprite - TBD.
+   * @param {DisplayObject} sprite - TBD.
    */
   constructor(sprite) {
     this.parent = sprite;

package/src/phaser/core/factory.js

@@ -20,7 +20,7 @@ export class GameObjectFactory {
    * @param {number} x - TBD.
    * @param {number} y - TBD.
    * @param {string} key - TBD.
-   * @param frame - TBD.
+   * @param {string} frame - TBD.
    * @param {Group} group - TBD.
    * @returns {Image} TBD.
    */
@@ -46,8 +46,8 @@ export class GameObjectFactory {
    * TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
-   * @param text - TBD.
-   * @param style - TBD.
+   * @param {string} text - TBD.
+   * @param {object} style - TBD.
    * @param {Group} group - TBD.
    * @returns {Text} TBD.
    */
@@ -63,10 +63,10 @@ export class GameObjectFactory {
    * @param {string} key - TBD.
    * @param {Function} callback - TBD.
    * @param {object} callbackContext - TBD.
-   * @param overFrame - TBD.
-   * @param outFrame - TBD.
-   * @param downFrame - TBD.
-   * @param upFrame - TBD.
+   * @param {string} overFrame - TBD.
+   * @param {string} outFrame - TBD.
+   * @param {string} downFrame - TBD.
+   * @param {string} upFrame - TBD.
    * @param {Group} group - TBD.
    * @returns {Button} TBD.
    */
@@ -93,11 +93,11 @@ export class GameObjectFactory {
    * TBD.
    * @param {number} x - TBD.
    * @param {number} y - TBD.
-   * @param font - TBD.
-   * @param text - TBD.
-   * @param size - TBD.
+   * @param {string} font - TBD.
+   * @param {string} text - TBD.
+   * @param {number} size - TBD.
    * @param {Group} group - TBD.
-   * @param align - TBD.
+   * @param {string} align - TBD.
    * @returns {BitmapText} TBD.
    */
   bitmapText(x, y, font, text, size, group = null, align = 'left') {

package/src/phaser/core/game.js

@@ -35,6 +35,7 @@ export class Game {
     this.renderer = null;
     this.state = null;
     this.isBooted = false;
+    this.paused = false;
     this.raf = null;
     this.add = null;
     this.cache = null;

package/src/phaser/core/input_mspointer.js

@@ -83,7 +83,7 @@ export class MSPointer {
 
   /**
    * TBD.
-   * @param {Event} event - TBD.
+   * @param {PointerEvent} event - TBD.
    */
   onPointerDown(event) {
     this.event = event;
@@ -104,7 +104,7 @@ export class MSPointer {
 
   /**
    * TBD.
-   * @param {Event} event - TBD.
+   * @param {PointerEvent} event - TBD.
    */
   onPointerMove(event) {
     this.event = event;
@@ -125,7 +125,7 @@ export class MSPointer {
 
   /**
    * TBD.
-   * @param {Event} event - TBD.
+   * @param {PointerEvent} event - TBD.
    */
   onPointerUp(event) {
     this.event = event;
@@ -146,7 +146,7 @@ export class MSPointer {
 
   /**
    * TBD.
-   * @param {Event} event - TBD.
+   * @param {PointerEvent} event - TBD.
    */
   onPointerUpGlobal(event) {
     if ((event.pointerType === 'mouse' || event.pointerType === 0x00000004) && !this.input.mousePointer.withinGame) {
@@ -161,7 +161,7 @@ export class MSPointer {
 
   /**
    * TBD.
-   * @param {Event} event - TBD.
+   * @param {PointerEvent} event - TBD.
    */
   onPointerOut(event) {
     this.event = event;
@@ -193,7 +193,7 @@ export class MSPointer {
 
   /**
    * TBD.
-   * @param {Event} event - TBD.
+   * @param {PointerEvent} event - TBD.
    */
   onPointerOver(event) {
     this.event = event;

package/src/phaser/core/input_pointer.js

@@ -422,7 +422,7 @@ export class Pointer {
    * @param {string} name - TBD.
    * @param {Function} callback - TBD.
    * @param {object} callbackContext - TBD.
-   * @param callbackArgs - TBD.
+   * @param {...any} callbackArgs - TBD.
    */
   addClickTrampoline(name, callback, callbackContext, callbackArgs) {
     if (!this.isDown) {