@vpmedia/phaser 1.29.0 → 1.40.0

package/README.md

@@ -1,6 +1,6 @@
 # @vpmedia/phaser
 
-[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.29.0)](https://badge.fury.io/js/@vpmedia%2Fphaser)
+[![npm version](https://badge.fury.io/js/@vpmedia%2Fphaser.svg?v=1.40.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.29.0",
+  "version": "1.40.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",
@@ -21,18 +21,17 @@
   ],
   "main": "./src/index.js",
   "types": "./types/index.d.ts",
+  "type": "module",
   "devDependencies": {
-    "eslint": "^8.41.0",
-    "eslint-config-prettier": "^8.8.0",
-    "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-jest": "^27.2.1",
-    "eslint-plugin-jsdoc": "^46.1.0",
-    "eslint-plugin-prettier": "^4.2.1",
+    "eslint": "^8.49.0",
+    "eslint-plugin-import": "^2.28.1",
+    "eslint-plugin-jest": "^27.2.3",
+    "eslint-plugin-jsdoc": "^46.8.0",
     "husky": "^8.0.3",
-    "jest": "^29.5.0",
-    "lint-staged": "^13.2.2",
-    "prettier": "^2.8.8",
-    "typescript": "^5.1.3"
+    "jest": "^29.7.0",
+    "lint-staged": "^14.0.1",
+    "prettier": "^3.0.3",
+    "typescript": "^5.2.2"
   },
   "scripts": {
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests",

package/src/index.js

@@ -1,44 +1,44 @@
 // core
-import * as Const from './phaser/core/const';
-import { Game } from './phaser/core/game';
-import { GameObjectFactory } from './phaser/core/factory';
-import { Signal } from './phaser/core/signal';
-import * as MathUtils from './phaser/util/math';
+import * as Const from './phaser/core/const.js';
+import { Game } from './phaser/core/game.js';
+import { GameObjectFactory } from './phaser/core/factory.js';
+import { Signal } from './phaser/core/signal.js';
+import * as MathUtils from './phaser/util/math.js';
 // sound
-import { Sound } from './phaser/core/sound';
-import { SoundSprite } from './phaser/core/sound_sprite';
-import { SoundManager } from './phaser/core/sound_manager';
+import { Sound } from './phaser/core/sound.js';
+import { SoundSprite } from './phaser/core/sound_sprite.js';
+import { SoundManager } from './phaser/core/sound_manager.js';
 // time
-import { Time } from './phaser/core/time';
-import { Timer } from './phaser/core/timer';
-import { TimerEvent } from './phaser/core/timer_event';
+import { Time } from './phaser/core/time.js';
+import { Timer } from './phaser/core/timer.js';
+import { TimerEvent } from './phaser/core/timer_event.js';
 // tween
-import { Tween } from './phaser/core/tween';
-import { TweenData } from './phaser/core/tween_data';
-import { TweenManager } from './phaser/core/tween_manager';
+import { Tween } from './phaser/core/tween.js';
+import { TweenData } from './phaser/core/tween_data.js';
+import { TweenManager } from './phaser/core/tween_manager.js';
 // animation
-import { Animation } from './phaser/core/animation';
-import { AnimationManager } from './phaser/core/animation_manager';
+import { Animation } from './phaser/core/animation.js';
+import { AnimationManager } from './phaser/core/animation_manager.js';
 // texture
-import { BaseTexture } from './phaser/display/webgl/base_texture';
-import { Texture } from './phaser/display/webgl/texture';
+import { BaseTexture } from './phaser/display/webgl/base_texture.js';
+import { Texture } from './phaser/display/webgl/texture.js';
 // geom
-import { Circle } from './phaser/geom/circle';
-import { Ellipse } from './phaser/geom/ellipse';
-import { Line } from './phaser/geom/line';
-import { Matrix } from './phaser/geom/matrix';
-import { Point } from './phaser/geom/point';
-import { Polygon } from './phaser/geom/polygon';
-import { Rectangle } from './phaser/geom/rectangle';
-import { RoundedRectangle } from './phaser/geom/rounded_rectangle';
+import { Circle } from './phaser/geom/circle.js';
+import { Ellipse } from './phaser/geom/ellipse.js';
+import { Line } from './phaser/geom/line.js';
+import { Matrix } from './phaser/geom/matrix.js';
+import { Point } from './phaser/geom/point.js';
+import { Polygon } from './phaser/geom/polygon.js';
+import { Rectangle } from './phaser/geom/rectangle.js';
+import { RoundedRectangle } from './phaser/geom/rounded_rectangle.js';
 // display
-import { BitmapText } from './phaser/display/bitmap_text';
-import { DisplayObject } from './phaser/display/display_object';
-import { Button } from './phaser/display/button';
-import { Image } from './phaser/display/image';
-import { Group } from './phaser/display/group';
-import { Text } from './phaser/display/text';
-import { Graphics } from './phaser/display/graphics';
+import { BitmapText } from './phaser/display/bitmap_text.js';
+import { DisplayObject } from './phaser/display/display_object.js';
+import { Button } from './phaser/display/button.js';
+import { Image } from './phaser/display/image.js';
+import { Group } from './phaser/display/group.js';
+import { Text } from './phaser/display/text.js';
+import { Graphics } from './phaser/display/graphics.js';
 // exports
 export {
   Const,

package/src/phaser/core/animation.js

@@ -1,12 +1,12 @@
-import { Signal } from './signal';
+import { Signal } from './signal.js';
 
 export class Animation {
   /**
    * TBD.
-   * @param {import('./game').Game} game - TBD.
-   * @param {import('../display/image').Image} parent - TBD.
+   * @param {import('./game.js').Game} game - TBD.
+   * @param {import('../display/image.js').Image} parent - TBD.
    * @param {string} name - TBD.
-   * @param {import('./frame_data').FrameData} frameData - TBD.
+   * @param {import('./frame_data.js').FrameData} frameData - TBD.
    * @param {string[]|number[]} frames - TBD.
    * @param {number} frameRate - TBD.
    * @param {boolean} loop - TBD.
@@ -302,7 +302,7 @@ export class Animation {
 
   /**
    * TBD.
-   * @param {import('./frame_data').FrameData} frameData - TBD.
+   * @param {import('./frame_data.js').FrameData} frameData - TBD.
    */
   updateFrameData(frameData) {
     this._frameData = frameData;

package/src/phaser/core/animation_manager.js

@@ -1,9 +1,9 @@
-import { Animation } from './animation';
+import { Animation } from './animation.js';
 
 export class AnimationManager {
   /**
    * TBD.
-   * @param {import('../display/image').Image} sprite - TBD.
+   * @param {import('../display/image.js').Image} sprite - TBD.
    */
   constructor(sprite) {
     this.sprite = sprite;
@@ -36,7 +36,7 @@ export class AnimationManager {
 
   /**
    * TBD.
-   * @param {import('./frame_data').FrameData} frameData - TBD.
+   * @param {import('./frame_data.js').FrameData} frameData - TBD.
    * @param {string|number} frame - TBD.
    * @returns {boolean} TBD.
    */
@@ -66,7 +66,7 @@ export class AnimationManager {
 
   /**
    * TBD.
-   * @param {import('./frame_data').FrameData} frameData - TBD.
+   * @param {import('./frame_data.js').FrameData} frameData - TBD.
    * @param {string|number} frame - TBD.
    * @returns {boolean} TBD.
    */
@@ -119,7 +119,7 @@ export class AnimationManager {
       this._frameData,
       this._outputFrames,
       frameRate,
-      loop
+      loop,
     );
     this.currentAnim = this._anims[name];
     if (this.sprite.tilingTexture) {
@@ -245,7 +245,7 @@ export class AnimationManager {
 
   /**
    * TBD.
-   * @returns {import('./frame_data').FrameData} TBD.
+   * @returns {import('./frame_data.js').FrameData} TBD.
    */
   get frameData() {
     return this._frameData;

package/src/phaser/core/animation_parser.js

@@ -1,9 +1,9 @@
-import { Frame } from './frame';
-import { FrameData } from './frame_data';
+import { Frame } from './frame.js';
+import { FrameData } from './frame_data.js';
 
 /**
  * TBD.
- * @param {import('./game').Game} game - TBD.
+ * @param {import('./game.js').Game} game - TBD.
  * @param {string} key - TBD.
  * @param {number} frameWidth - TBD.
  * @param {number} frameHeight - TBD.
@@ -37,7 +37,7 @@ export function spriteSheet(game, key, frameWidth, frameHeight, frameMax, margin
   //  Zero or smaller than frame sizes?
   if (width === 0 || height === 0 || width < frameWidth || height < frameHeight || total === 0) {
     console.warn(
-      "AnimationParser.spriteSheet: '" + key + "'s width/height zero or width/height < given frameWidth/frameHeight"
+      "AnimationParser.spriteSheet: '" + key + "'s width/height zero or width/height < given frameWidth/frameHeight",
     );
     return null;
   }
@@ -58,7 +58,7 @@ export function spriteSheet(game, key, frameWidth, frameHeight, frameMax, margin
 
 /**
  * TBD.
- * @param {import('./game').Game} game - TBD.
+ * @param {import('./game.js').Game} game - TBD.
  * @param {object} json - TBD.
  * @returns {object} TBD.
  */
@@ -77,7 +77,7 @@ export function JSONDataHash(game, json) {
   for (let k = 0; k < keys.length; k += 1) {
     const key = keys[k];
     newFrame = data.addFrame(
-      new Frame(i, frames[key].frame.x, frames[key].frame.y, frames[key].frame.w, frames[key].frame.h, key)
+      new Frame(i, frames[key].frame.x, frames[key].frame.y, frames[key].frame.w, frames[key].frame.h, key),
     );
     if (frames[key].trimmed) {
       newFrame.setTrim(
@@ -87,7 +87,7 @@ export function JSONDataHash(game, json) {
         frames[key].spriteSourceSize.x,
         frames[key].spriteSourceSize.y,
         frames[key].spriteSourceSize.w,
-        frames[key].spriteSourceSize.h
+        frames[key].spriteSourceSize.h,
       );
     }
     i += 1;

package/src/phaser/core/cache.js

@@ -1,10 +1,10 @@
-import { Texture } from '../display/webgl/texture';
-import { BaseTexture } from '../display/webgl/base_texture';
-import { Signal } from './signal';
-import { Frame } from './frame';
-import { FrameData } from './frame_data';
-import { JSONDataHash } from './animation_parser';
-import { jsonBitmapFont, xmlBitmapFont } from './loader_parser';
+import { BaseTexture } from '../display/webgl/base_texture.js';
+import { Texture } from '../display/webgl/texture.js';
+import { JSONDataHash } from './animation_parser.js';
+import { Frame } from './frame.js';
+import { FrameData } from './frame_data.js';
+import { jsonBitmapFont, xmlBitmapFont } from './loader_parser.js';
+import { Signal } from './signal.js';
 
 export const CANVAS = 0;
 export const IMAGE = 1;
@@ -20,7 +20,7 @@ export const RENDER_TEXTURE = 9;
 export class Cache {
   /**
    * TBD.
-   * @param {import('./game').Game} game - TBD.
+   * @param {import('./game.js').Game} game - TBD.
    */
   constructor(game) {
     this.game = game;

package/src/phaser/core/device_util.js

@@ -1,4 +1,4 @@
-import { Device } from './device';
+import { Device } from './device.js';
 
 /**
  * TBD.

package/src/phaser/core/dom.js

@@ -1,4 +1,4 @@
-import { Point } from '../geom/point';
+import { Point } from '../geom/point.js';
 
 class VisualBoundsDesktopRectangle {
   /**
@@ -182,7 +182,7 @@ class DocumentBoundsRectangle {
 export class DOM {
   /**
    * TBD.
-   * @param {import('./device').Device} device - TBD.
+   * @param {import('./device.js').Device} device - TBD.
    */
   constructor(device) {
     this.treatAsDesktop =

package/src/phaser/core/event_manager.js

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

package/src/phaser/core/factory.js

@@ -1,14 +1,14 @@
-import { BitmapText } from '../display/bitmap_text';
-import { Button } from '../display/button';
-import { Group } from '../display/group';
-import { Graphics } from '../display/graphics';
-import { Image } from '../display/image';
-import { Text } from '../display/text';
+import { BitmapText } from '../display/bitmap_text.js';
+import { Button } from '../display/button.js';
+import { Graphics } from '../display/graphics.js';
+import { Group } from '../display/group.js';
+import { Image } from '../display/image.js';
+import { Text } from '../display/text.js';
 
 export class GameObjectFactory {
   /**
    * TBD.
-   * @param {import('./game').Game} game - TBD.
+   * @param {import('./game.js').Game} game - TBD.
    */
   constructor(game) {
     this.game = game;
@@ -79,11 +79,11 @@ export class GameObjectFactory {
     outFrame = null,
     downFrame = null,
     upFrame = null,
-    group = null
+    group = null,
   ) {
     const parent = group || this.game.world;
     return parent.add(
-      new Button(this.game, x, y, key, callback, callbackContext, overFrame, outFrame, downFrame, upFrame)
+      new Button(this.game, x, y, key, callback, callbackContext, overFrame, outFrame, downFrame, upFrame),
     );
   }
 

package/src/phaser/core/frame.js

@@ -1,6 +1,6 @@
-import { Rectangle } from '../geom/rectangle';
-import { distance } from '../util/math';
-import { cloneFrame } from './frame_util';
+import { Rectangle } from '../geom/rectangle.js';
+import { distance } from '../util/math.js';
+import { cloneFrame } from './frame_util.js';
 
 export class Frame {
   /**

package/src/phaser/core/frame_data.js

@@ -1,4 +1,4 @@
-import { cloneFrameData } from './frame_util';
+import { cloneFrameData } from './frame_util.js';
 
 export class FrameData {
   /**
@@ -6,7 +6,7 @@ export class FrameData {
    */
   constructor() {
     /**
-     * @type {import('./frame').Frame[]}
+     * @type {import('./frame.js').Frame[]}
      */
     this._frames = [];
     /**
@@ -17,8 +17,8 @@ export class FrameData {
 
   /**
    * TBD.
-   * @param {import('./frame').Frame} frame - TBD.
-   * @returns {import('./frame').Frame} TBD.
+   * @param {import('./frame.js').Frame} frame - TBD.
+   * @returns {import('./frame.js').Frame} TBD.
    */
   addFrame(frame) {
     frame.index = this._frames.length;
@@ -32,7 +32,7 @@ export class FrameData {
   /**
    * TBD.
    * @param {number} index - TBD.
-   * @returns {import('./frame').Frame} TBD.
+   * @returns {import('./frame.js').Frame} TBD.
    */
   getFrame(index = 0) {
     if (index >= this._frames.length) {
@@ -44,7 +44,7 @@ export class FrameData {
   /**
    * TBD.
    * @param {string} name - TBD.
-   * @returns {import('./frame').Frame} TBD.
+   * @returns {import('./frame.js').Frame} TBD.
    */
   getFrameByName(name) {
     if (typeof this._frameNames[name] === 'number') {
@@ -77,8 +77,8 @@ export class FrameData {
    * TBD.
    * @param {number} start - TBD.
    * @param {number} end - TBD.
-   * @param {import('./frame').Frame[]} output - TBD.
-   * @returns {import('./frame').Frame[]} TBD.
+   * @param {import('./frame.js').Frame[]} output - TBD.
+   * @returns {import('./frame.js').Frame[]} TBD.
    */
   getFrameRange(start, end, output = null) {
     const result = output || [];

package/src/phaser/core/frame_util.js

@@ -1,5 +1,5 @@
-import { Frame } from './frame';
-import { FrameData } from './frame_data';
+import { Frame } from './frame.js';
+import { FrameData } from './frame_data.js';
 
 /**
  * TBD.

package/src/phaser/core/game.js

@@ -1,22 +1,22 @@
-import { CanvasRenderer } from '../display/canvas/renderer';
-import { WebGLRenderer } from '../display/webgl/renderer';
-import { Signal } from './signal';
-import { Loader } from './loader';
-import { Cache } from './cache';
-import { Input } from './input';
-import { Device } from './device';
-import { GameObjectFactory } from './factory';
-import { RequestAnimationFrame } from './raf';
-import { ScaleManager } from './scale_manager';
-import { SoundManager } from './sound_manager';
-import { SceneManager } from './scene_manager';
-import { Time } from './time';
-import { TweenManager } from './tween_manager';
-import { World } from './world';
-import { Stage } from './stage';
-import { RENDER_AUTO, RENDER_WEBGL } from './const';
-import { create, removeFromDOM, addToDOM, setTouchAction } from '../display/canvas/util';
-import { initialize, checkOS } from './device_util';
+import { CanvasRenderer } from '../display/canvas/renderer.js';
+import { WebGLRenderer } from '../display/webgl/renderer.js';
+import { Signal } from './signal.js';
+import { Loader } from './loader.js';
+import { Cache } from './cache.js';
+import { Input } from './input.js';
+import { Device } from './device.js';
+import { GameObjectFactory } from './factory.js';
+import { RequestAnimationFrame } from './raf.js';
+import { ScaleManager } from './scale_manager.js';
+import { SoundManager } from './sound_manager.js';
+import { SceneManager } from './scene_manager.js';
+import { Time } from './time.js';
+import { TweenManager } from './tween_manager.js';
+import { World } from './world.js';
+import { Stage } from './stage.js';
+import { RENDER_AUTO, RENDER_WEBGL } from './const.js';
+import { create, removeFromDOM, addToDOM, setTouchAction } from '../display/canvas/util.js';
+import { initialize, checkOS } from './device_util.js';
 
 export class Game {
   /**
@@ -66,7 +66,7 @@ export class Game {
           initialize(this.device);
           this.boot();
         },
-        false
+        false,
       );
     }
   }

package/src/phaser/core/input.js

@@ -1,22 +1,22 @@
-import { ArraySet } from './array_set';
-import { Graphics } from '../display/graphics';
-import { Image } from '../display/image';
-import { Signal } from './signal';
-import { Point } from '../geom/point';
-import { Circle } from '../geom/circle';
-import { Mouse } from './input_mouse';
-import { MSPointer } from './input_mspointer';
-import { Pointer } from './input_pointer';
-import { Touch } from './input_touch';
-import { POINTER_CURSOR, POINTER_CONTACT, MOUSE_TOUCH_COMBINE } from './const';
-import { create, remove } from '../display/canvas/pool';
+import { create, remove } from '../display/canvas/pool.js';
+import { Graphics } from '../display/graphics.js';
+import { Image } from '../display/image.js';
+import { Circle } from '../geom/circle.js';
+import { Point } from '../geom/point.js';
+import { ArraySet } from './array_set.js';
+import { MOUSE_TOUCH_COMBINE, POINTER_CONTACT, POINTER_CURSOR } from './const.js';
+import { Mouse } from './input_mouse.js';
+import { MSPointer } from './input_mspointer.js';
+import { Pointer } from './input_pointer.js';
+import { Touch } from './input_touch.js';
+import { Signal } from './signal.js';
 
 const MAX_POINTERS = 10;
 
 export class Input {
   /**
    * TBD.
-   * @param {import('./game').Game} game - TBD.
+   * @param {import('./game.js').Game} game - TBD.
    */
   constructor(game) {
     this.game = game;
@@ -360,7 +360,7 @@ export class Input {
 
   /**
    * TBD.
-   * @param {import('../display/display_object').DisplayObject} displayObject - TBD.
+   * @param {import('../display/display_object.js').DisplayObject} displayObject - TBD.
    * @param {Pointer} pointer - TBD.
    * @param {Point} output - TBD.
    * @returns {Point} TBD.
@@ -371,13 +371,13 @@ export class Input {
     const id = 1 / (wt.a * wt.d + wt.c * -wt.b);
     return result.setTo(
       wt.d * id * pointer.x + -wt.c * id * pointer.y + (wt.ty * wt.c - wt.tx * wt.d) * id,
-      wt.a * id * pointer.y + -wt.b * id * pointer.x + (-wt.ty * wt.a + wt.tx * wt.b) * id
+      wt.a * id * pointer.y + -wt.b * id * pointer.x + (-wt.ty * wt.a + wt.tx * wt.b) * id,
     );
   }
 
   /**
    * TBD.
-   * @param {import('../display/display_object').DisplayObject} displayObject - TBD.
+   * @param {import('../display/display_object.js').DisplayObject} displayObject - TBD.
    * @param {Pointer} pointer - TBD.
    * @param {Point} localPoint - TBD.
    * @returns {boolean} TBD.