@vpmedia/phaser 1.105.0 → 1.107.0

package/src/phaser/display/group.ts

@@ -30,8 +30,8 @@ export class Group extends DisplayObject {
    */
   constructor(
     game: import('../core/game.js').Game,
-    parent: DisplayObject = null,
-    name: string = null,
+    parent: DisplayObject | null = null,
+    name: string | null = null,
     addToStage: boolean = false
   ) {
     super(game);
@@ -80,7 +80,7 @@ export class Group extends DisplayObject {
    * @param {boolean} destroyChildren - Whether to destroy children as well.
    * @param {boolean} soft - Whether to perform a soft destroy (leaving the group in the parent's children list).
    */
-  destroy(destroyChildren: boolean = true, soft: boolean = false) {
+  override destroy(destroyChildren: boolean = true, soft: boolean = false) {
     if (this.game === null || this.ignoreDestroy) {
       return;
     }
@@ -93,7 +93,7 @@ export class Group extends DisplayObject {
       if (this.parent) {
         this.parent.removeChild(this);
       }
-      this.game = null;
+      this.game = null!;
       this.exists = false;
     }
   }
@@ -253,12 +253,12 @@ export class Group extends DisplayObject {
   /**
    * Updates the Z indices of all children in this group before the update cycle.
    */
-  preUpdate() {
+  override preUpdate() {
     if (this.pendingDestroy) {
       this.destroy();
       return;
     }
-    if (!this.exists || !this.parent.exists) {
+    if (!this.exists || !this.parent?.exists) {
       this.renderOrderID = -1;
       return;
     }
@@ -270,7 +270,7 @@ export class Group extends DisplayObject {
   /**
    * Updates all children in this group during the update cycle.
    */
-  update() {
+  override update() {
     let i = this.children.length;
     while (i) {
       i -= 1;
@@ -281,7 +281,7 @@ export class Group extends DisplayObject {
   /**
    * Updates all children in this group after the update cycle.
    */
-  postUpdate() {
+  override postUpdate() {
     for (let i = 0; i < this.children.length; i += 1) {
       this.children[i].postUpdate();
     }

package/src/phaser/display/image.ts

@@ -35,7 +35,13 @@ export class Image extends DisplayObject {
    * @param {string | number | Texture} key - The texture key or texture to use.
    * @param {string | number} frame - The frame identifier (name or index) to use.
    */
-  constructor(game: import('../core/game.js').Game, x: number, y: number, key: string | number | Texture, frame: string | number = 0) {
+  constructor(
+    game: import('../core/game.js').Game,
+    x: number,
+    y: number,
+    key: string | number | Texture | null,
+    frame: string | number | null = 0
+  ) {
     super(game);
     /** @type {number} */
     this.type = IMAGE;
@@ -78,11 +84,11 @@ export class Image extends DisplayObject {
   /**
    * Destroys this image and cleans up resources.
    */
-  destroy() {
-    this.game = null;
+  override destroy() {
+    this.game = null!;
     this.key = null;
     this.data = null;
-    this.texture = null;
+    this.texture = null!;
     this.tint = 0xff_ff_ff;
     this.cachedTint = -1;
     this.tintedTexture = null;
@@ -91,23 +97,23 @@ export class Image extends DisplayObject {
     if (this.events) {
       this.events.destroy();
     }
-    this.events = null;
+    this.events = null!;
     if (this.animations) {
       this.animations.destroy();
     }
-    this.animations = null;
+    this.animations = null!;
     super.destroy();
   }
 
   /**
    * Called before the update cycle for this image.
    */
-  preUpdate() {
+  override preUpdate() {
     if (this.pendingDestroy) {
       this.destroy();
       return;
     }
-    if (!this.exists || !this.parent.exists) {
+    if (!this.exists || !this.parent?.exists) {
       this.renderOrderID = -1;
       return;
     }
@@ -131,9 +137,9 @@ export class Image extends DisplayObject {
    * @param {string | number | null | undefined} frame - The frame identifier (name or index) to use.
    * @param {boolean} stopAnimation - Whether to stop the animation when changing textures.
    */
-  loadTexture(key: string | number | Texture, frame: string | number | null = 0, stopAnimation: boolean = true) {
+  loadTexture(key: string | number | Texture | null, frame: string | number | null = 0, stopAnimation: boolean = true) {
     if (key === PENDING_ATLAS) {
-      key = frame;
+      key = frame ?? 0;
       frame = 0;
     } else {
       frame = frame || 0;
@@ -216,11 +222,11 @@ export class Image extends DisplayObject {
 
   /**
    * Resizes the frame of this image.
-   * @param {DisplayObject} parent - The parent display object.
+   * @param {DisplayObject} _parent - The parent display object.
    * @param {number} width - The new width of the frame.
    * @param {number} height - The new height of the frame.
    */
-  resizeFrame(parent: DisplayObject, width: number, height: number) {
+  resizeFrame(_parent: DisplayObject, width: number, height: number) {
     this.texture.frame.resize(width, height);
     this.texture.setFrame(this.texture.frame);
   }
@@ -326,7 +332,7 @@ export class Image extends DisplayObject {
    * Gets the width of this image.
    * @returns {number} The width in pixels.
    */
-  get width() {
+  override get width() {
     return this.scale.x * this.texture.frame.width;
   }
 
@@ -334,7 +340,7 @@ export class Image extends DisplayObject {
    * Sets the width of this image.
    * @param {number} value - The new width in pixels.
    */
-  set width(value: number) {
+  override set width(value: number) {
     this.scale.x = value / this.texture.frame.width;
     this._width = value;
   }
@@ -343,7 +349,7 @@ export class Image extends DisplayObject {
    * Gets the height of this image.
    * @returns {number} The height in pixels.
    */
-  get height() {
+  override get height() {
     return this.scale.y * this.texture.frame.height;
   }
 
@@ -351,7 +357,7 @@ export class Image extends DisplayObject {
    * Sets the height of this image.
    * @param {number} value - The new height in pixels.
    */
-  set height(value: number) {
+  override set height(value: number) {
     this.scale.y = value / this.texture.frame.height;
     this._height = value;
   }
@@ -383,7 +389,7 @@ export class Image extends DisplayObject {
    * @param {import('../geom/matrix.js').Matrix} matrix - The transformation matrix to use.
    * @returns {Rectangle} The bounds rectangle of this image.
    */
-  getBounds(matrix: import('../geom/matrix.js').Matrix = null) {
+  override getBounds(matrix: import('../geom/matrix.js').Matrix | null = null) {
     return getBounds(this, matrix);
   }
 
@@ -391,7 +397,7 @@ export class Image extends DisplayObject {
    * Gets the local bounds of this image.
    * @returns {Rectangle} The local bounds rectangle of this image.
    */
-  getLocalBounds() {
+  override getLocalBounds() {
     return getLocalBounds(this);
   }
 
@@ -400,7 +406,7 @@ export class Image extends DisplayObject {
    * @param {object} renderSession - The WebGL rendering session.
    * @param {import('../geom/matrix.js').Matrix} matrix - The transformation matrix to use.
    */
-  renderWebGL(renderSession: any, matrix: import('../geom/matrix.js').Matrix = null) {
+  override renderWebGL(renderSession: any, matrix: import('../geom/matrix.js').Matrix | null = null) {
     renderWebGL(this, renderSession, matrix);
   }
 
@@ -409,7 +415,7 @@ export class Image extends DisplayObject {
    * @param {object} renderSession - The Canvas rendering session.
    * @param {import('../geom/matrix.js').Matrix} matrix - The transformation matrix to use.
    */
-  renderCanvas(renderSession: any, matrix: import('../geom/matrix.js').Matrix = null) {
+  override renderCanvas(renderSession: any, matrix: import('../geom/matrix.js').Matrix | null = null) {
     renderCanvas(this, renderSession, matrix);
   }
 }

package/src/phaser/display/sprite_util.ts

@@ -8,7 +8,11 @@ import { getTintedTexture } from './canvas/tinter.js';
  * @param {import('./webgl/texture.js').Texture} texture - The new texture to set.
  * @param {boolean} destroyBase - Whether to destroy the base texture.
  */
-export const setTexture = (target: import('./image.js').Image, texture: import('./webgl/texture.js').Texture, destroyBase: boolean = false) => {
+export const setTexture = (
+  target: import('./image.js').Image,
+  texture: import('./webgl/texture.js').Texture,
+  destroyBase: boolean = false
+) => {
   if (destroyBase) {
     target.texture.baseTexture.destroy();
   }
@@ -24,7 +28,7 @@ export const setTexture = (target: import('./image.js').Image, texture: import('
  * @param {object} matrix - The transformation matrix.
  * @returns {import('../geom/rectangle.js').Rectangle} The bounds rectangle.
  */
-export const getBounds = (target: import('./image.js').Image, matrix: any = null) => {
+export const getBounds = (target: import('./image.js').Image, matrix: any | null = null) => {
   // TODO verify
   if (target.currentBounds) {
     return target.currentBounds;
@@ -127,7 +131,11 @@ export const getLocalBounds = (target: import('./image.js').Image) => {
  * @param {object} renderSession - The render session object.
  * @param {import('../geom/matrix.js').Matrix | null | undefined} matrix - The transformation matrix.
  */
-export const renderWebGL = (target: import('./image.js').Image, renderSession: any, matrix: import('../geom/matrix.js').Matrix | null | undefined = null) => {
+export const renderWebGL = (
+  target: import('./image.js').Image,
+  renderSession: any,
+  matrix: import('../geom/matrix.js').Matrix | null | undefined = null
+) => {
   // if the sprite is not visible or the alpha is 0 then no need to render this element
   if (!target.visible || target.alpha <= 0 || !target.renderable) {
     return;
@@ -176,7 +184,11 @@ export const renderWebGL = (target: import('./image.js').Image, renderSession: a
  * @param {object} renderSession - The render session object.
  * @param {import('../geom/matrix.js').Matrix | null | undefined} matrix - The transformation matrix.
  */
-export const renderCanvas = (target: import('./image.js').Image, renderSession: any, matrix: import('../geom/matrix.js').Matrix | null | undefined = null) => {
+export const renderCanvas = (
+  target: import('./image.js').Image,
+  renderSession: any,
+  matrix: import('../geom/matrix.js').Matrix | null | undefined = null
+) => {
   // If the sprite is not visible or the alpha is 0 then no need to render this element
   if (
     !target.visible ||

package/src/phaser/display/text.ts

@@ -77,7 +77,7 @@ export class Text extends Image {
   /**
    * Destroys this text object and cleans up resources.
    */
-  destroy() {
+  override destroy() {
     this.texture.destroy(true);
     remove(this);
     this.canvas = null;
@@ -128,7 +128,7 @@ export class Text extends Image {
    * @param {boolean} update - Whether to update the text immediately.
    * @returns {Text} This Text object for chaining.
    */
-  setStyle(style: any = null, update: boolean = false) {
+  setStyle(style: any | null = null, update: boolean = false) {
     style = JSON.parse(JSON.stringify(style)) || {};
     style.font = style.font || 'bold 20pt Arial';
     style.backgroundColor = style.backgroundColor || null;
@@ -878,7 +878,7 @@ export class Text extends Image {
    * Renders this text object using WebGL.
    * @param {object} renderSession - The render session to use.
    */
-  renderWebGL(renderSession: any) {
+  override renderWebGL(renderSession: any) {
     if (this.dirty) {
       this.updateText();
       this.dirty = false;
@@ -890,7 +890,7 @@ export class Text extends Image {
    * Renders this text object using Canvas.
    * @param {object} renderSession - The render session to use.
    */
-  renderCanvas(renderSession: any) {
+  override renderCanvas(renderSession: any) {
     if (this.dirty) {
       this.updateText();
       this.dirty = false;
@@ -1044,7 +1044,7 @@ export class Text extends Image {
    * @param {import('../geom/matrix.js').Matrix} matrix - The transformation matrix to use.
    * @returns {Rectangle} The bounds of this text object.
    */
-  getBounds(matrix: import('../geom/matrix.js').Matrix = null) {
+  override getBounds(matrix: import('../geom/matrix.js').Matrix | null = null) {
     if (this.dirty) {
       this.updateText();
       this.dirty = false;
@@ -1521,7 +1521,7 @@ export class Text extends Image {
    * Gets the width of this object.
    * @returns {number} The width in pixels.
    */
-  get width() {
+  override get width() {
     if (this.dirty) {
       this.updateText();
       this.dirty = false;
@@ -1533,7 +1533,7 @@ export class Text extends Image {
    * Sets the width of this object.
    * @param {number} value - The new width to set in pixels.
    */
-  set width(value: number) {
+  override set width(value: number) {
     this.scale.x = value / this.texture.frame.width;
     this._width = value;
   }
@@ -1542,7 +1542,7 @@ export class Text extends Image {
    * Gets the height of this object.
    * @returns {number} The height in pixels.
    */
-  get height() {
+  override get height() {
     if (this.dirty) {
       this.updateText();
       this.dirty = false;
@@ -1554,7 +1554,7 @@ export class Text extends Image {
    * Sets the height of this object.
    * @param {number} value - The new height to set in pixels.
    */
-  set height(value: number) {
+  override set height(value: number) {
     this.scale.y = value / this.texture.frame.height;
     this._height = value;
   }

package/src/phaser/display/webgl/blend_manager.ts

@@ -1,7 +1,7 @@
 export class WebGLBlendModeManager {
   [key: string]: any;
-gl!: any;
-currentBlendMode!: any;
+  gl!: any;
+  currentBlendMode!: any;
   /**
    * Creates a new BlendModeManager instance.
    */

package/src/phaser/display/webgl/earcut.ts

@@ -107,7 +107,7 @@ export function zOrder(x: number, y: number, minX: number, minY: number, size: n
  * @param {number} minY - The minimum y-coordinate of the bounding box.
  * @param {number} size - The size of the bounding box.
  */
-export function indexCurve(start: any, minX: number, minY: number, size: number) {
+export function indexCurve(start: any, minX: number = 0, minY: number = 0, size: number = 0) {
   let p = start;
   do {
     if (p.z === null) p.z = zOrder(p.x, p.y, minX, minY, size);
@@ -147,7 +147,16 @@ export function getLeftmost(start: any) {
  * @param {number} py - TBD.
  * @returns {object} TBD.
  */
-export function pointInTriangle(ax: number, ay: number, bx: number, by: number, cx: number, cy: number, px: number, py: number) {
+export function pointInTriangle(
+  ax: number,
+  ay: number,
+  bx: number,
+  by: number,
+  cx: number,
+  cy: number,
+  px: number,
+  py: number
+) {
   return (
     (cx - px) * (ay - py) - (ax - px) * (cy - py) >= 0 &&
     (ax - px) * (by - py) - (bx - px) * (ay - py) >= 0 &&
@@ -339,7 +348,7 @@ export function isEar(ear: any) {
  * @param {number} size - TBD.
  * @returns {boolean} TBD.
  */
-export function isEarHashed(ear: any, minX: number, minY: number, size: number) {
+export function isEarHashed(ear: any, minX: number = 0, minY: number = 0, size: number = 0) {
   const a = ear.prev;
   const b = ear;
   const c = ear.next;
@@ -517,6 +526,7 @@ export function eliminateHoles(data: any, holeIndices: any, outerNode: any, dim:
     start = holeIndices[i] * dim;
     end = i < len - 1 ? holeIndices[i + 1] * dim : data.length;
     list = linkedList(data, start, end, dim, false);
+    if (!list) continue;
     if (list === list.next) list.steiner = true;
     queue.push(getLeftmost(list));
   }
@@ -566,7 +576,14 @@ export function cureLocalIntersections(start: any, triangles: any, dim: number)
  * @param {number} minY - The minimum y-coordinate of the bounding box.
  * @param {number} size - The size of the bounding box.
  */
-export function splitEarcut(start: any, triangles: any, dim: number, minX: number, minY: number, size: number) {
+export function splitEarcut(
+  start: any,
+  triangles: any,
+  dim: number,
+  minX: number = 0,
+  minY: number = 0,
+  size: number = 0
+) {
   // look for a valid diagonal that divides the polygon into two
   let a = start;
   do {
@@ -599,7 +616,15 @@ export function splitEarcut(start: any, triangles: any, dim: number, minX: numbe
  * @param {number} size - The size of the bounding box.
  * @param {object} pass - The pass information for triangulation.
  */
-export function earcutLinked(ear: any, triangles: any, dim: number, minX?: number, minY?: number, size?: number, pass?: any) {
+export function earcutLinked(
+  ear: any,
+  triangles: any,
+  dim: number,
+  minX?: number,
+  minY?: number,
+  size?: number,
+  pass?: any
+) {
   if (!ear) return;
   // interlink polygon nodes in z-order
   if (!pass && size) indexCurve(ear, minX, minY, size);
@@ -652,7 +677,7 @@ export function triangulate(data: any, holeIndices: any, dim: number) {
   const hasHoles = holeIndices && holeIndices.length;
   const outerLen = hasHoles ? holeIndices[0] * dim : data.length;
   let outerNode = linkedList(data, 0, outerLen, dim, true);
-  const triangles = [];
+  const triangles: number[] = [];
   if (!outerNode) return triangles;
   let minX;
   let minY;

package/src/phaser/display/webgl/fast_sprite_batch.ts

@@ -1,25 +1,27 @@
+import type { IdentifiedWebGLRenderingContext } from './util.js';
+
 export class FastSpriteBatch {
   [key: string]: any;
-vertSize!: any;
-maxSize!: any;
-size!: any;
-vertices!: any;
-indices!: any;
-vertexBuffer!: any;
-indexBuffer!: any;
-lastIndexCount!: any;
-drawing!: any;
-currentBatchSize!: any;
-currentBaseTexture!: any;
-currentBlendMode!: any;
-renderSession!: any;
-shader!: any;
-matrix!: any;
+  vertSize!: any;
+  maxSize!: any;
+  size!: any;
+  vertices!: any;
+  indices!: any;
+  vertexBuffer!: any;
+  indexBuffer!: any;
+  lastIndexCount!: any;
+  drawing!: any;
+  currentBatchSize!: any;
+  currentBaseTexture!: any;
+  currentBlendMode!: any;
+  renderSession!: any;
+  shader!: any;
+  matrix!: any;
   /**
    * Creates a new FastSpriteBatch instance.
    * @param {WebGLRenderingContext & { id: number }} gl - The WebGL rendering context.
    */
-  constructor(gl) {
+  constructor(gl: IdentifiedWebGLRenderingContext) {
     this.vertSize = 10;
     this.maxSize = 6000; // Math.pow(2, 16) / this.vertSize;
     this.size = this.maxSize;
@@ -54,7 +56,7 @@ matrix!: any;
    * Sets the WebGL context for this batch.
    * @param {WebGLRenderingContext & { id: number }} gl - The WebGL rendering context.
    */
-  setContext(gl) {
+  setContext(gl: IdentifiedWebGLRenderingContext) {
     this.gl = gl;
     // create a couple of buffers
     this.vertexBuffer = gl.createBuffer();

package/src/phaser/display/webgl/filter_manager.ts

@@ -1,8 +1,8 @@
 export class WebGLFilterManager {
   [key: string]: any;
-filterStack!: any;
-offsetX!: any;
-offsetY!: any;
+  filterStack!: any;
+  offsetX!: any;
+  offsetY!: any;
   /**
    * Creates a new FilterManager instance.
    */

package/src/phaser/display/webgl/filter_texture.ts

@@ -2,10 +2,10 @@ import { SCALE_LINEAR } from '../../core/const.js';
 
 export class FilterTexture {
   [key: string]: any;
-gl!: any;
-frameBuffer!: any;
-texture!: any;
-renderBuffer!: any;
+  gl!: any;
+  frameBuffer!: any;
+  texture!: any;
+  renderBuffer!: any;
   /**
    * Creates a new FilterTexture instance.
    * @param {WebGLRenderingContext} gl - The WebGL rendering context.

package/src/phaser/display/webgl/graphics.ts

@@ -3,6 +3,7 @@ import { Point } from '../../geom/point.js';
 import { hex2rgb } from '../../util/math.js';
 import { triangulate } from './earcut.js';
 import { GraphicsData } from './graphics_data.js';
+import type { IdentifiedWebGLRenderingContext } from './util.js';
 
 /**
  * Updates the graphics data for WebGL rendering.
@@ -269,7 +270,14 @@ export const buildRectangle = (graphicsData: any, webGLData: GraphicsData) => {
  * @param {number} toY - The ending y-coordinate.
  * @returns {number[]} The calculated points for the quadratic bezier curve.
  */
-export const quadraticBezierCurve = (fromX: number, fromY: number, cpX: number, cpY: number, toX: number, toY: number) => {
+export const quadraticBezierCurve = (
+  fromX: number,
+  fromY: number,
+  cpX: number,
+  cpY: number,
+  toX: number,
+  toY: number
+) => {
   let xa;
   let ya;
   let xb;
@@ -278,7 +286,7 @@ export const quadraticBezierCurve = (fromX: number, fromY: number, cpX: number,
   let y;
   const n = 20;
   const points = [];
-  const getPt = (n1, n2, perc) => {
+  const getPt = (n1: number, n2: number, perc: number) => {
     const diff = n2 - n1;
     return n1 + diff * perc;
   };
@@ -487,7 +495,7 @@ export const buildPoly = (graphicsData: any, webGLData: GraphicsData) => {
  * @param {import('../graphics.js').Graphics} graphics - The graphics object to update.
  * @param {WebGLRenderingContext & { id: number }} gl - The WebGL rendering context.
  */
-export const updateGraphics = (graphics: import('../graphics.js').Graphics, gl) => {
+export const updateGraphics = (graphics: import('../graphics.js').Graphics, gl: IdentifiedWebGLRenderingContext) => {
   const stencilBufferLimit = getStencilBufferLimit();
   // get the contexts graphics object
   let webGL = graphics._webGL[gl.id];

package/src/phaser/display/webgl/graphics_data.ts

@@ -1,14 +1,14 @@
 export class GraphicsData {
   [key: string]: any;
-gl!: any;
-color!: any;
-points!: any;
-indices!: any;
-buffer!: any;
-indexBuffer!: any;
-mode!: any;
-alpha!: any;
-dirty!: any;
+  gl!: any;
+  color!: any;
+  points!: any;
+  indices!: any;
+  buffer!: any;
+  indexBuffer!: any;
+  mode!: any;
+  alpha!: any;
+  dirty!: any;
   /**
    * Creates a new GraphicsData instance.
    * @param {WebGLRenderingContext} gl - The WebGL rendering context.

package/src/phaser/display/webgl/render_texture.ts

@@ -26,7 +26,13 @@ export class RenderTexture extends Texture {
    * @param {number} scaleMode - The scale mode to use.
    * @param {number} resolution - The resolution to use.
    */
-  constructor(width: number, height: number, renderer: import('./renderer.js').WebGLRenderer|import('../canvas/renderer.js').CanvasRenderer, scaleMode: number, resolution: number = 1) {
+  constructor(
+    width: number,
+    height: number,
+    renderer: import('./renderer.js').WebGLRenderer | import('../canvas/renderer.js').CanvasRenderer,
+    scaleMode: number,
+    resolution: number = 1
+  ) {
     const w = width || 100;
     const h = height || 100;
     const res = resolution || 1;
@@ -104,14 +110,14 @@ export class RenderTexture extends Texture {
    * @returns {string} The base64 string representation.
    */
   getBase64() {
-    return this.getCanvas().toDataURL();
+    return this.getCanvas()?.toDataURL() ?? '';
   }
 
   /**
    * Gets the canvas element for this render texture.
    * @returns {HTMLCanvasElement} The canvas element.
    */
-  getCanvas() {
+  getCanvas(): HTMLCanvasElement | null {
     // TODO
     return null;
   }

package/src/phaser/display/webgl/shader/complex.ts

@@ -5,11 +5,11 @@ import { compileProgram } from '../util.js';
 
 export class ComplexPrimitiveShader {
   [key: string]: any;
-gl!: any;
-_UID!: any;
-program!: any;
-fragmentSrc!: any;
-vertexSrc!: any;
+  gl!: any;
+  _UID!: any;
+  program!: any;
+  fragmentSrc!: any;
+  vertexSrc!: any;
   /**
    * Creates a new ComplexShader instance.
    * @param {WebGLRenderingContext} gl - The WebGL rendering context.

package/src/phaser/display/webgl/shader/fast.ts

@@ -5,12 +5,12 @@ import { compileProgram } from '../util.js';
 
 export class FastShader {
   [key: string]: any;
-gl!: any;
-_UID!: any;
-program!: any;
-textureCount!: any;
-fragmentSrc!: any;
-vertexSrc!: any;
+  gl!: any;
+  _UID!: any;
+  program!: any;
+  textureCount!: any;
+  fragmentSrc!: any;
+  vertexSrc!: any;
   /**
    * Creates a new FastShader instance.
    * @param {WebGLRenderingContext} gl - The WebGL rendering context.