@vpmedia/phaser 1.104.0 → 1.105.0

package/src/phaser/core/dom.ts

@@ -191,7 +191,7 @@ export class DOM {
    * TBD.
    * @param {import('./device.js').Device} device - TBD.
    */
-  constructor(device) {
+  constructor(device: import('./device.js').Device) {
     this.treatAsDesktop =
       device.desktop &&
       document.documentElement.clientWidth <= window.innerWidth &&
@@ -211,7 +211,7 @@ export class DOM {
    * @param {Point} point - Optional Point object to store the result.
    * @returns {Point} The offset position of the element.
    */
-  getOffset(element, point = null) {
+  getOffset(element: HTMLCanvasElement, point: Point = null) {
     point = point || new Point();
     const box = element.getBoundingClientRect();
     const scrollTop = this.scrollY;
@@ -229,7 +229,7 @@ export class DOM {
    * @param {number} cushion - Optional padding to add around the element.
    * @returns {boolean} True if bounds were successfully retrieved, false otherwise.
    */
-  getBounds(element, cushion = 0) {
+  getBounds(element: HTMLCanvasElement, cushion: number = 0) {
     element = element && !element.nodeType ? element[0] : element;
     if (!element || element.nodeType !== 1) {
       return false;
@@ -243,7 +243,7 @@ export class DOM {
    * @param {number} cushion - Optional padding to add around the rectangle.
    * @returns {{width: number, height: number, left: number, right: number, top: number, bottom: number}} The calibrated rectangle.
    */
-  calibrate(coords, cushion = 0) {
+  calibrate(coords: DOMRect, cushion: number = 0) {
     const output = {
       width: 0,
       height: 0,
@@ -262,7 +262,7 @@ export class DOM {
    * @param {string} primaryFallback - The fallback method to use if screen orientation API is not available.
    * @returns {string} The screen orientation ('portrait-primary', 'landscape-primary', etc.).
    */
-  getScreenOrientation(primaryFallback) {
+  getScreenOrientation(primaryFallback: string) {
     const screen = window.screen;
     // @ts-ignore
     const orientation = screen.orientation || screen.mozOrientation || screen.msOrientation;

package/src/phaser/core/event_manager.ts

@@ -1,28 +1,25 @@
-// @ts-nocheck
+import type { DisplayObject } from '../display/display_object.js';
 import { Signal } from './signal.js';
 
 export class EventManager {
-parent;
-_onAddedToGroup;
-_onRemovedFromGroup;
-_onDestroy;
-_onOutOfBounds;
-_onEnterBounds;
-_onInputOver;
-_onInputOut;
-_onInputDown;
-_onInputUp;
-_onDragStart;
-_onDragUpdate;
-_onDragStop;
-_onAnimationStart;
-_onAnimationComplete;
-_onAnimationLoop;
-  /**
-   * Creates a new EventManager instance.
-   * @param {import('../display/display_object.js').DisplayObject} sprite - Reference to the parent DisplayObject.
-   */
-  constructor(sprite) {
+  parent: DisplayObject | null;
+  _onAddedToGroup: Signal | null;
+  _onRemovedFromGroup: Signal | null;
+  _onDestroy: Signal | null;
+  _onOutOfBounds: Signal | null;
+  _onEnterBounds: Signal | null;
+  _onInputOver: Signal | null;
+  _onInputOut: Signal | null;
+  _onInputDown: Signal | null;
+  _onInputUp: Signal | null;
+  _onDragStart: Signal | null;
+  _onDragUpdate: Signal | null;
+  _onDragStop: Signal | null;
+  _onAnimationStart: Signal | null;
+  _onAnimationComplete: Signal | null;
+  _onAnimationLoop: Signal | null;
+
+  constructor(sprite: DisplayObject) {
     this.parent = sprite;
     this._onAddedToGroup = null;
     this._onRemovedFromGroup = null;
@@ -41,11 +38,8 @@ _onAnimationLoop;
     this._onAnimationLoop = null;
   }
 
-  /**
-   * Destroys the EventManager and cleans up resources.
-   */
-  destroy() {
-    this._parent = null;
+  destroy(): void {
+    this.parent = null;
     if (this._onDestroy) {
       this._onDestroy.dispose();
     }
@@ -93,318 +87,183 @@ _onAnimationLoop;
     }
   }
 
-  /**
-   * Gets the onAddedToGroup signal.
-   * @returns {Signal} The Signal object for the onAddedToGroup event.
-   */
-  get onAddedToGroup() {
+  get onAddedToGroup(): Signal {
     if (!this._onAddedToGroup) {
       this._onAddedToGroup = new Signal();
     }
     return this._onAddedToGroup;
   }
-
-  /**
-   * Dispatches the onAddedToGroup event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onAddedToGroup$dispatch(...args) {
+  onAddedToGroup$dispatch(...args: unknown[]): void {
     if (this._onAddedToGroup) {
       this._onAddedToGroup.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onRemovedFromGroup signal.
-   * @returns {Signal} The Signal object for the onRemovedFromGroup event.
-   */
-  get onRemovedFromGroup() {
+  get onRemovedFromGroup(): Signal {
     if (!this._onRemovedFromGroup) {
       this._onRemovedFromGroup = new Signal();
     }
     return this._onRemovedFromGroup;
   }
-
-  /**
-   * Dispatches the onRemovedFromGroup event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onRemovedFromGroup$dispatch(...args) {
+  onRemovedFromGroup$dispatch(...args: unknown[]): void {
     if (this._onRemovedFromGroup) {
       this._onRemovedFromGroup.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onDestroy signal.
-   * @returns {Signal} The Signal object for the onDestroy event.
-   */
-  get onDestroy() {
+  get onDestroy(): Signal {
     if (!this._onDestroy) {
       this._onDestroy = new Signal();
     }
     return this._onDestroy;
   }
-
-  /**
-   * Dispatches the onDestroy event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onDestroy$dispatch(...args) {
+  onDestroy$dispatch(...args: unknown[]): void {
     if (this._onDestroy) {
       this._onDestroy.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onOutOfBounds signal.
-   * @returns {Signal} The Signal object for the onOutOfBounds event.
-   */
-  get onOutOfBounds() {
+  get onOutOfBounds(): Signal {
     if (!this._onOutOfBounds) {
       this._onOutOfBounds = new Signal();
     }
     return this._onOutOfBounds;
   }
-
-  /**
-   * Dispatches the onOutOfBounds event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onOutOfBounds$dispatch(...args) {
+  onOutOfBounds$dispatch(...args: unknown[]): void {
     if (this._onOutOfBounds) {
       this._onOutOfBounds.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onEnterBounds signal.
-   * @returns {Signal} The Signal object for the onEnterBounds event.
-   */
-  get onEnterBounds() {
+  get onEnterBounds(): Signal {
     if (!this._onEnterBounds) {
       this._onEnterBounds = new Signal();
     }
     return this._onEnterBounds;
   }
-
-  /**
-   * Dispatches the onEnterBounds event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onEnterBounds$dispatch(...args) {
+  onEnterBounds$dispatch(...args: unknown[]): void {
     if (this._onEnterBounds) {
       this._onEnterBounds.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onInputOver signal.
-   * @returns {Signal} The Signal object for the onInputOver event.
-   */
-  get onInputOver() {
+  get onInputOver(): Signal {
     if (!this._onInputOver) {
       this._onInputOver = new Signal();
     }
     return this._onInputOver;
   }
-
-  /**
-   * Dispatches the onInputOver event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onInputOver$dispatch(...args) {
+  onInputOver$dispatch(...args: unknown[]): void {
     if (this._onInputOver) {
       this._onInputOver.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onInputOut signal.
-   * @returns {Signal} The Signal object for the onInputOut event.
-   */
-  get onInputOut() {
+  get onInputOut(): Signal {
     if (!this._onInputOut) {
       this._onInputOut = new Signal();
     }
     return this._onInputOut;
   }
-
-  /**
-   * Dispatches the onInputOut event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onInputOut$dispatch(...args) {
+  onInputOut$dispatch(...args: unknown[]): void {
     if (this._onInputOut) {
       this._onInputOut.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onInputDown signal.
-   * @returns {Signal} The Signal object for the onInputDown event.
-   */
-  get onInputDown() {
+  get onInputDown(): Signal {
     if (!this._onInputDown) {
       this._onInputDown = new Signal();
     }
     return this._onInputDown;
   }
-
-  /**
-   * Dispatches the onInputDown event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onInputDown$dispatch(...args) {
+  onInputDown$dispatch(...args: unknown[]): void {
     if (this._onInputDown) {
       this._onInputDown.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onInputUp signal.
-   * @returns {Signal} The Signal object for the onInputUp event.
-   */
-  get onInputUp() {
+  get onInputUp(): Signal {
     if (!this._onInputUp) {
       this._onInputUp = new Signal();
     }
     return this._onInputUp;
   }
-
-  /**
-   * Dispatches the onInputUp event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onInputUp$dispatch(...args) {
+  onInputUp$dispatch(...args: unknown[]): void {
     if (this._onInputUp) {
       this._onInputUp.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onDragStart signal.
-   * @returns {Signal} The Signal object for the onDragStart event.
-   */
-  get onDragStart() {
+  get onDragStart(): Signal {
     if (!this._onDragStart) {
       this._onDragStart = new Signal();
     }
     return this._onDragStart;
   }
-
-  /**
-   * Dispatches the onDragStart event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onDragStart$dispatch(...args) {
+  onDragStart$dispatch(...args: unknown[]): void {
     if (this._onDragStart) {
       this._onDragStart.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onDragUpdate signal.
-   * @returns {Signal} The Signal object for the onDragUpdate event.
-   */
-  get onDragUpdate() {
+  get onDragUpdate(): Signal {
     if (!this._onDragUpdate) {
       this._onDragUpdate = new Signal();
     }
     return this._onDragUpdate;
   }
-
-  /**
-   * Dispatches the onDragUpdate event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onDragUpdate$dispatch(...args) {
+  onDragUpdate$dispatch(...args: unknown[]): void {
     if (this._onDragUpdate) {
       this._onDragUpdate.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onDragStop signal.
-   * @returns {Signal} The Signal object for the onDragStop event.
-   */
-  get onDragStop() {
+  get onDragStop(): Signal {
     if (!this._onDragStop) {
       this._onDragStop = new Signal();
     }
     return this._onDragStop;
   }
-
-  /**
-   * Dispatches the onDragStop event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onDragStop$dispatch(...args) {
+  onDragStop$dispatch(...args: unknown[]): void {
     if (this._onDragStop) {
       this._onDragStop.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onAnimationStart signal.
-   * @returns {Signal} The Signal object for the onAnimationStart event.
-   */
-  get onAnimationStart() {
+  get onAnimationStart(): Signal {
     if (!this._onAnimationStart) {
       this._onAnimationStart = new Signal();
     }
     return this._onAnimationStart;
   }
-
-  /**
-   * Dispatches the onAnimationStart event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onAnimationStart$dispatch(...args) {
+  onAnimationStart$dispatch(...args: unknown[]): void {
     if (this._onAnimationStart) {
       this._onAnimationStart.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onAnimationComplete signal.
-   * @returns {Signal} The Signal object for the onAnimationComplete event.
-   */
-  get onAnimationComplete() {
+  get onAnimationComplete(): Signal {
     if (!this._onAnimationComplete) {
       this._onAnimationComplete = new Signal();
     }
     return this._onAnimationComplete;
   }
-
-  /**
-   * Dispatches the onAnimationComplete event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onAnimationComplete$dispatch(...args) {
+  onAnimationComplete$dispatch(...args: unknown[]): void {
     if (this._onAnimationComplete) {
       this._onAnimationComplete.dispatch(...args);
     }
   }
 
-  /**
-   * Gets the onAnimationLoop signal.
-   * @returns {Signal} The Signal object for the onAnimationLoop event.
-   */
-  get onAnimationLoop() {
+  get onAnimationLoop(): Signal {
     if (!this._onAnimationLoop) {
       this._onAnimationLoop = new Signal();
     }
     return this._onAnimationLoop;
   }
-
-  /**
-   * Dispatches the onAnimationLoop event.
-   * @param {...any} args - Arguments to pass to the signal.
-   */
-  onAnimationLoop$dispatch(...args) {
+  onAnimationLoop$dispatch(...args: unknown[]): void {
     if (this._onAnimationLoop) {
       this._onAnimationLoop.dispatch(...args);
     }
   }
-}
+}

package/src/phaser/core/factory.ts

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import { BitmapText } from '../display/bitmap_text.js';
 import { Button } from '../display/button.js';
 import { Graphics } from '../display/graphics.js';
@@ -7,12 +6,12 @@ import { Image } from '../display/image.js';
 import { Text } from '../display/text.js';
 
 export class GameObjectFactory {
-game;
+  game!: any;
   /**
    * Creates a new GameObjectFactory instance.
    * @param {import('./game.js').Game} game - The game instance this factory belongs to.
    */
-  constructor(game) {
+  constructor(game: import('./game.js').Game) {
     this.game = game;
   }
 
@@ -25,7 +24,7 @@ game;
    * @param {Group} group - The parent group for the image.
    * @returns {Image} The created Image object.
    */
-  image(x, y, key, frame, group = null) {
+  image(x: number, y: number, key: string, frame: any, group: Group = null) {
     if (!group) {
       group = this.game.world;
     }
@@ -39,7 +38,7 @@ game;
    * @param {boolean} addToStage - Whether to add the group to the stage.
    * @returns {Group} The created Group object.
    */
-  group(parent = null, name = null, addToStage = false) {
+  group(parent: Group | null = null, name: string | null = null, addToStage: boolean = false) {
     return new Group(this.game, parent, name, addToStage);
   }
 
@@ -52,7 +51,7 @@ game;
    * @param {Group | null} group - The parent group for the text.
    * @returns {Text} The created Text object.
    */
-  text(x, y, text, style, group = null) {
+  text(x: number, y: number, text: any, style: any, group: Group | null = null) {
     const parent = group || this.game.world;
     return parent.add(new Text(this.game, x, y, text, style));
   }
@@ -72,16 +71,16 @@ game;
    * @returns {Button} The created Button object.
    */
   button(
-    x,
-    y,
-    key,
-    callback = null,
-    callbackContext = null,
-    overFrame = null,
-    outFrame = null,
-    downFrame = null,
-    upFrame = null,
-    group = null
+    x: number,
+    y: number,
+    key: string,
+    callback: Function | null = null,
+    callbackContext: any | null = null,
+    overFrame: string | null = null,
+    outFrame: string | null = null,
+    downFrame: string | null = null,
+    upFrame: string | null = null,
+    group: Group | null = null
   ) {
     const parent = group || this.game.world;
     return parent.add(
@@ -96,7 +95,7 @@ game;
    * @param {Group | null} group - The parent group for the graphics object.
    * @returns {Graphics} The created Graphics object.
    */
-  graphics(x = 0, y = 0, group = null) {
+  graphics(x: number = 0, y: number = 0, group: Group | null = null) {
     const parent = group || this.game.world;
     return parent.add(new Graphics(this.game, x, y));
   }
@@ -112,7 +111,15 @@ game;
    * @param {string} align - The alignment of the text.
    * @returns {BitmapText} The created BitmapText object.
    */
-  bitmapText(x, y, font, text, size, group = null, align = 'left') {
+  bitmapText(
+    x: number,
+    y: number,
+    font: string,
+    text: string,
+    size: number,
+    group: Group | null = null,
+    align: string = 'left'
+  ) {
     const parent = group || this.game.world;
     return parent.add(new BitmapText(this.game, x, y, font, text, size, align));
   }

package/src/phaser/core/frame.ts

@@ -1,38 +1,40 @@
-// @ts-nocheck
 import { Rectangle } from '../geom/rectangle.js';
 import { distance } from '../util/math.js';
 import { cloneFrame } from './frame_util.js';
 
 export class Frame {
-  /**
-   * Creates a new Frame instance.
-   * @param {number} index - The index of this frame in the animation.
-   * @param {number} x - The x coordinate of this frame's position in the texture.
-   * @param {number} y - The y coordinate of this frame's position in the texture.
-   * @param {number} width - The width of this frame in pixels.
-   * @param {number} height - The height of this frame in pixels.
-   * @param {string} name - The name of this frame.
-   */
-  constructor(index, x, y, width, height, name) {
+  index!: number;
+  x!: number;
+  y!: number;
+  width!: number;
+  height!: number;
+  name!: string;
+  centerX!: number;
+  centerY!: number;
+  distance!: number;
+  rotated!: boolean;
+  rotationDirection!: 'cw' | 'ccw';
+  trimmed!: boolean;
+  sourceSizeW!: number;
+  sourceSizeH!: number;
+  spriteSourceSizeX!: number;
+  spriteSourceSizeY!: number;
+  spriteSourceSizeW!: number;
+  spriteSourceSizeH!: number;
+  right!: number;
+  bottom!: number;
+
+  constructor(index: number, x: number, y: number, width: number, height: number, name?: string) {
     this.initialize(index, x, y, width, height, name);
   }
 
-  /**
-   * Initializes this frame with the specified properties.
-   * @param {number} index - The index of this frame in the animation.
-   * @param {number} x - The x coordinate of this frame's position in the texture.
-   * @param {number} y - The y coordinate of this frame's position in the texture.
-   * @param {number} width - The width of this frame in pixels.
-   * @param {number} height - The height of this frame in pixels.
-   * @param {string} name - The name of this frame.
-   */
-  initialize(index, x, y, width, height, name) {
+  initialize(index: number, x: number, y: number, width: number, height: number, name?: string): void {
     this.index = index;
     this.x = x;
     this.y = y;
     this.width = width;
     this.height = height;
-    this.name = name;
+    this.name = name as string;
     this.centerX = Math.floor(width / 2);
     this.centerY = Math.floor(height / 2);
     this.distance = distance(0, 0, width, height);
@@ -49,12 +51,7 @@ export class Frame {
     this.bottom = this.y + this.height;
   }
 
-  /**
-   * Resizes this frame to the specified dimensions.
-   * @param {number} width - The new width of this frame in pixels.
-   * @param {number} height - The new height of this frame in pixels.
-   */
-  resize(width, height) {
+  resize(width: number, height: number): void {
     this.width = width;
     this.height = height;
     this.centerX = Math.floor(width / 2);
@@ -66,17 +63,15 @@ export class Frame {
     this.bottom = this.y + height;
   }
 
-  /**
-   * Sets the trim properties for this frame.
-   * @param {boolean} trimmed - Whether this frame is trimmed.
-   * @param {number} actualWidth - The actual width of the trimmed frame.
-   * @param {number} actualHeight - The actual height of the trimmed frame.
-   * @param {number} destX - The destination x coordinate for the trimmed frame.
-   * @param {number} destY - The destination y coordinate for the trimmed frame.
-   * @param {number} destWidth - The destination width of the trimmed frame.
-   * @param {number} destHeight - The destination height of the trimmed frame.
-   */
-  setTrim(trimmed, actualWidth, actualHeight, destX, destY, destWidth, destHeight) {
+  setTrim(
+    trimmed: boolean,
+    actualWidth: number,
+    actualHeight: number,
+    destX: number,
+    destY: number,
+    destWidth: number,
+    destHeight: number
+  ): void {
     this.trimmed = trimmed;
     if (trimmed) {
       this.sourceSizeW = actualWidth;
@@ -90,22 +85,13 @@ export class Frame {
     }
   }
 
-  /**
-   * Creates a clone of this frame.
-   * @returns {Frame} A new Frame instance with the same properties.
-   */
-  clone() {
+  clone(): Frame {
     return cloneFrame(this);
   }
 
-  /**
-   * Gets the rectangle bounds of this frame.
-   * @param {Rectangle} output - The rectangle to use for the result (optional).
-   * @returns {Rectangle} A Rectangle object representing this frame's bounds.
-   */
-  getRect(output = null) {
+  getRect(output: Rectangle | null = null): Rectangle {
     const result = output || new Rectangle();
     result.setTo(this.x, this.y, this.width, this.height);
     return result;
   }
-}
+}