@vpmedia/phaser 1.106.0 → 1.107.0

package/src/phaser/display/image.ts

@@ -39,8 +39,8 @@ export class Image extends DisplayObject {
     game: import('../core/game.js').Game,
     x: number,
     y: number,
-    key: string | number | Texture,
-    frame: string | number = 0
+    key: string | number | Texture | null,
+    frame: string | number | null = 0
   ) {
     super(game);
     /** @type {number} */
@@ -84,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;
@@ -97,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;
     }
@@ -137,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;
@@ -222,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);
   }
@@ -332,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;
   }
 
@@ -340,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;
   }
@@ -349,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;
   }
 
@@ -357,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;
   }
@@ -389,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);
   }
 
@@ -397,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);
   }
 
@@ -406,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);
   }
 
@@ -415,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

@@ -28,7 +28,7 @@ export const setTexture = (
  * @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;

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/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);
@@ -348,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;
@@ -526,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));
   }
@@ -575,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 {
@@ -669,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,3 +1,5 @@
+import type { IdentifiedWebGLRenderingContext } from './util.js';
+
 export class FastSpriteBatch {
   [key: string]: any;
   vertSize!: any;
@@ -19,7 +21,7 @@ export class FastSpriteBatch {
    * 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 @@ export class FastSpriteBatch {
    * 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/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.
@@ -285,7 +286,7 @@ export const quadraticBezierCurve = (
   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;
   };
@@ -494,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/render_texture.ts

@@ -110,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/normal.ts

@@ -39,7 +39,7 @@ export class NormalShader {
    * Creates a new NormalShader instance.
    * @param {WebGLRenderingContext & { id: number }} gl - The WebGL rendering context.
    */
-  constructor(gl) {
+  constructor(gl: WebGLRenderingContext) {
     this.gl = gl;
     this._UID = uuidv4();
     /** @type {WebGLProgram} */

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

@@ -3,6 +3,7 @@ import { FastShader } from './shader/fast.js';
 import { NormalShader } from './shader/normal.js';
 import { PrimitiveShader } from './shader/primitive.js';
 import { StripShader } from './shader/strip.js';
+import type { IdentifiedWebGLRenderingContext } from './util.js';
 
 export class WebGLShaderManager {
   [key: string]: any;
@@ -39,7 +40,7 @@ export class WebGLShaderManager {
    * Initializes the shader manager with a WebGL context.
    * @param {WebGLRenderingContext & { id: number }} gl - The WebGL rendering context.
    */
-  setContext(gl) {
+  setContext(gl: IdentifiedWebGLRenderingContext) {
     this.gl = gl;
     this.primitiveShader = new PrimitiveShader(gl);
     this.complexPrimitiveShader = new ComplexPrimitiveShader(gl);

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

@@ -1,5 +1,6 @@
 import { AbstractFilter } from './abstract_filter.js';
 import { NormalShader } from './shader/normal.js';
+import type { IdentifiedWebGLRenderingContext } from './util.js';
 
 export class WebGLSpriteBatch {
   [key: string]: any;
@@ -65,7 +66,7 @@ export class WebGLSpriteBatch {
    * Renders a sprite using WebGL.
    * @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/util.ts

@@ -1,3 +1,6 @@
+/** WebGL context tagged with the per-context id the renderer assigns, used to key shader caches. */
+export type IdentifiedWebGLRenderingContext = WebGLRenderingContext & { id: number };
+
 // No error has been recorded. The value of this constant is 0.
 export const NO_ERROR = 0;
 // An unacceptable value has been specified for an enumerated argument. The command is ignored and the error flag is set.
@@ -63,6 +66,9 @@ export const initDefaultShaders = () => {};
 export const compileShader = (gl: WebGLRenderingContext, shaderSrc: string[] | string, shaderType: any) => {
   const src = Array.isArray(shaderSrc) ? shaderSrc.join('\n') : shaderSrc;
   const shader = gl.createShader(shaderType);
+  if (!shader) {
+    return null;
+  }
   gl.shaderSource(shader, src);
   gl.compileShader(shader);
   if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
@@ -112,6 +118,9 @@ export const compileProgram = (
 
   const shaderProgram = gl.createProgram();
 
+  if (!shaderProgram || !vertexShader || !fragmentShader) {
+    return null;
+  }
   gl.attachShader(shaderProgram, vertexShader);
   gl.attachShader(shaderProgram, fragmentShader);
   gl.linkProgram(shaderProgram);

package/src/phaser/geom/circle.ts

@@ -46,7 +46,7 @@ export class Circle {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} A random point within this circle.
    */
-  random(output: Point = null) {
+  random(output: Point | null = null) {
     const result = output || new Point();
     const t = 2 * Math.PI * Math.random();
     const u = Math.random() + Math.random();

package/src/phaser/geom/ellipse.ts

@@ -91,7 +91,7 @@ export class Ellipse {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} A random point within this ellipse.
    */
-  random(output: Point = null) {
+  random(output: Point | null = null) {
     const result = output || new Point();
     const p = Math.random() * Math.PI * 2;
     const r = Math.random();

package/src/phaser/geom/line.ts

@@ -119,7 +119,7 @@ export class Line {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} The midpoint of this line.
    */
-  midPoint(output: Point = null) {
+  midPoint(output: Point | null = null) {
     const result = output || new Point();
     result.x = (this.start.x + this.end.x) / 2;
     result.y = (this.start.y + this.end.y) / 2;
@@ -169,7 +169,7 @@ export class Line {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} A random point on this line.
    */
-  random(output: Point = null) {
+  random(output: Point | null = null) {
     const result = output || new Point();
     const t = Math.random();
     result.x = this.start.x + t * (this.end.x - this.start.x);

package/src/phaser/geom/matrix.ts

@@ -105,7 +105,7 @@ export class Matrix {
    * @param {Float32Array} output - The array to store the result in (optional).
    * @returns {Float32Array} A Float32Array containing the matrix elements.
    */
-  toArray(transpose: boolean = false, output: Float32Array = null) {
+  toArray(transpose: boolean = false, output: Float32Array | null = null) {
     const result = output || new Float32Array(9);
     if (transpose) {
       result[0] = this.a;
@@ -137,7 +137,7 @@ export class Matrix {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} The transformed point.
    */
-  apply(pos: Point, output: Point = null) {
+  apply(pos: Point, output: Point | null = null) {
     const result = output || new Point();
     result.x = this.a * pos.x + this.c * pos.y + this.tx;
     result.y = this.b * pos.x + this.d * pos.y + this.ty;
@@ -150,7 +150,7 @@ export class Matrix {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} The transformed point.
    */
-  applyInverse(pos: Point, output: Point = null) {
+  applyInverse(pos: Point, output: Point | null = null) {
     const result = output || new Point();
     const id = 1 / (this.a * this.d + this.c * -this.b);
     const x = pos.x;

package/src/phaser/geom/polygon.ts

@@ -13,7 +13,7 @@ export class Polygon {
    * Creates a new Polygon instance.
    * @param {object[]} points - The array of points to define the polygon (optional).
    */
-  constructor(points: any[] = null) {
+  constructor(points: any[] | null = null) {
     /** @type {number} */
     this.area = 0;
     /** @type {Point[]} */

package/src/phaser/geom/rectangle.ts

@@ -288,7 +288,7 @@ export class Rectangle {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} A random point within this rectangle.
    */
-  random(output: Point = null) {
+  random(output: Point | null = null) {
     const result = output || new Point();
     result.x = this.randomX;
     result.y = this.randomY;
@@ -301,7 +301,7 @@ export class Rectangle {
    * @param {Point} output - The point to store the result in (optional).
    * @returns {Point} A point at the specified position on the rectangle.
    */
-  getPoint(position: number, output: Point = null) {
+  getPoint(position: number, output: Point | null = null) {
     const result = output || new Point();
     switch (position) {
       case TOP_LEFT:

package/src/phaser/geom/util/circle.ts

@@ -8,7 +8,7 @@ import { Point } from '../point.js';
  * @param {Circle} output - Optional circle to store the result in.
  * @returns {Circle} The cloned circle.
  */
-export const clone = (input: Circle, output: Circle = null) => {
+export const clone = (input: Circle, output: Circle | null = null) => {
   const result = output || new Circle();
   result.x = input.x;
   result.y = input.y;
@@ -60,7 +60,12 @@ export const intersects = (a: Circle, b: Circle) => {
  * @param {Point} output - Optional point to store the result in.
  * @returns {Point} The point on the circumference of the circle.
  */
-export const circumferencePoint = (a: Circle, angle: number, asDegrees: boolean = false, output: Point = null) => {
+export const circumferencePoint = (
+  a: Circle,
+  angle: number,
+  asDegrees: boolean = false,
+  output: Point | null = null
+) => {
   const result = output || new Point();
   if (asDegrees === true) {
     angle = degToRad(angle);
@@ -78,7 +83,7 @@ export const circumferencePoint = (a: Circle, angle: number, asDegrees: boolean
  * @param {Point} output - Optional point to store the result in.
  * @returns {Point} The point on the circumference of the circle.
  */
-export const intersectsPoint = (a: Circle, angle: number, asDegrees: boolean = false, output: Point = null) => {
+export const intersectsPoint = (a: Circle, angle: number, asDegrees: boolean = false, output: Point | null = null) => {
   const result = output || new Point();
   if (asDegrees === true) {
     angle = degToRad(angle);

package/src/phaser/geom/util/line.ts

@@ -8,7 +8,7 @@ import { intersects as intersectsRect } from './rectangle.js';
  * @param {Line} output - Optional line to store the result in.
  * @returns {Line} The cloned line.
  */
-export const clone = (input: Line, output: Line = null) => {
+export const clone = (input: Line, output: Line | null = null) => {
   const result = output || new Line();
   result.start.x = input.start.x;
   result.start.y = input.start.y;
@@ -27,7 +27,14 @@ export const clone = (input: Line, output: Line = null) => {
  * @param {Point} output - Optional point to store the result in.
  * @returns {Point} The intersection point, or null if there is no intersection.
  */
-export const intersectsPoints = (a: any, b: any, e: any, f: any, asSegment: boolean = true, output: Point = null) => {
+export const intersectsPoints = (
+  a: any,
+  b: any,
+  e: any,
+  f: any,
+  asSegment: boolean = true,
+  output: Point | null = null
+) => {
   const result = output || new Point();
   const a1 = b.y - a.y;
   const a2 = f.y - e.y;

package/src/phaser/geom/util/matrix.ts

@@ -6,7 +6,7 @@ import { Matrix } from '../matrix.js';
  * @param {Matrix} output - Optional matrix to store the result in.
  * @returns {Matrix} The cloned matrix.
  */
-export const clone = (input: Matrix, output: Matrix = null) => {
+export const clone = (input: Matrix, output: Matrix | null = null) => {
   const result = output || new Matrix();
   result.a = input.a;
   result.b = input.b;