@vpmedia/phaser 1.115.0 → 1.117.0

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

@@ -7,7 +7,7 @@ import { Point } from '../point.js';
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point containing the sum of the two points.
  */
-export const add = (a: Point, b: Point, output: Point | null = null) => {
+export const add = (a: Point, b: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   result.x = a.x + b.x;
   result.y = a.y + b.y;
@@ -21,7 +21,7 @@ export const add = (a: Point, b: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point containing the difference of the two points.
  */
-export const subtract = (a: Point, b: Point, output: Point | null = null) => {
+export const subtract = (a: Point, b: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   result.x = a.x - b.x;
   result.y = a.y - b.y;
@@ -35,7 +35,7 @@ export const subtract = (a: Point, b: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point containing the product of the two points.
  */
-export const multiply = (a: Point, b: Point, output: Point | null = null) => {
+export const multiply = (a: Point, b: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   result.x = a.x * b.x;
   result.y = a.y * b.y;
@@ -49,7 +49,7 @@ export const multiply = (a: Point, b: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point containing the quotient of the two points.
  */
-export const divide = (a: Point, b: Point, output: Point | null = null) => {
+export const divide = (a: Point, b: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   result.x = a.x / b.x;
   result.y = a.y / b.y;
@@ -62,7 +62,7 @@ export const divide = (a: Point, b: Point, output: Point | null = null) => {
  * @param {Point} b - The second point to compare.
  * @returns {boolean} True if the points are equal, false otherwise.
  */
-export const equals = (a: Point, b: Point) => a.x === b.x && a.y === b.y;
+export const equals = (a: Point, b: Point): boolean => a.x === b.x && a.y === b.y;
 
 /**
  * Calculates the angle between two points.
@@ -70,7 +70,7 @@ export const equals = (a: Point, b: Point) => a.x === b.x && a.y === b.y;
  * @param {Point} b - The second point to calculate the angle to.
  * @returns {number} The angle between the two points in radians.
  */
-export const angle = (a: Point, b: Point) => Math.atan2(a.y - b.y, a.x - b.x);
+export const angle = (a: Point, b: Point): number => Math.atan2(a.y - b.y, a.x - b.x);
 
 /**
  * Creates a new point with the same coordinates as the input point but with inverted signs.
@@ -78,7 +78,7 @@ export const angle = (a: Point, b: Point) => Math.atan2(a.y - b.y, a.x - b.x);
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point with negated coordinates.
  */
-export const negative = (a: Point, output: Point | null = null) => {
+export const negative = (a: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   return result.setTo(-a.x, -a.y);
 };
@@ -91,7 +91,7 @@ export const negative = (a: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point with the result of the operation.
  */
-export const multiplyAdd = (a: Point, b: Point, s: number, output: Point | null = null) => {
+export const multiplyAdd = (a: Point, b: Point, s: number, output: Point | null = null): Point => {
   const result = output ?? new Point();
   return result.setTo(a.x + b.x * s, a.y + b.y * s);
 };
@@ -104,7 +104,7 @@ export const multiplyAdd = (a: Point, b: Point, s: number, output: Point | null
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point interpolated between the two points.
  */
-export const interpolate = (a: Point, b: Point, f: number, output: Point | null = null) => {
+export const interpolate = (a: Point, b: Point, f: number, output: Point | null = null): Point => {
   const result = output ?? new Point();
   return result.setTo(a.x + (b.x - a.x) * f, a.y + (b.y - a.y) * f);
 };
@@ -115,7 +115,7 @@ export const interpolate = (a: Point, b: Point, f: number, output: Point | null
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point that is perpendicular to the input point.
  */
-export const perp = (a: Point, output: Point | null = null) => {
+export const perp = (a: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   return result.setTo(-a.y, a.x);
 };
@@ -126,7 +126,7 @@ export const perp = (a: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point that is perpendicular to the input point (rotated clockwise).
  */
-export const rperp = (a: Point, output: Point | null = null) => {
+export const rperp = (a: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   return result.setTo(a.y, -a.x);
 };
@@ -138,7 +138,7 @@ export const rperp = (a: Point, output: Point | null = null) => {
  * @param {boolean} round - Whether to round the result (default: false).
  * @returns {number} The distance between the two points.
  */
-export const distance = (a: Point, b: Point, round = false) => {
+export const distance = (a: Point, b: Point, round = false): number => {
   const dx = a.x - b.x;
   const dy = a.y - b.y;
   const abDistance = Math.sqrt(dx * dx + dy * dy);
@@ -152,7 +152,7 @@ export const distance = (a: Point, b: Point, round = false) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point with the projected result.
  */
-export const project = (a: Point, b: Point, output: Point | null = null) => {
+export const project = (a: Point, b: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   const amt = a.dot(b) / b.getMagnitudeSq();
   if (amt !== 0) {
@@ -168,7 +168,7 @@ export const project = (a: Point, b: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point with the projected result.
  */
-export const projectUnit = (a: Point, b: Point, output: Point | null = null) => {
+export const projectUnit = (a: Point, b: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   const amt = a.dot(b);
   if (amt !== 0) {
@@ -183,7 +183,7 @@ export const projectUnit = (a: Point, b: Point, output: Point | null = null) =>
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point with the same x coordinate but negated y coordinate.
  */
-export const normalRightHand = (a: Point, output: Point | null = null) => {
+export const normalRightHand = (a: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   return result.setTo(a.y * -1, a.x);
 };
@@ -194,7 +194,7 @@ export const normalRightHand = (a: Point, output: Point | null = null) => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new normalized point.
  */
-export const normalize = (a: Point, output: Point | null = null) => {
+export const normalize = (a: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   const m = a.getMagnitude();
   if (m !== 0) {
@@ -220,7 +220,7 @@ export const rotate = (
   ang: number,
   asDegrees: boolean,
   dist: number | null | undefined
-) => {
+): Point => {
   if (asDegrees) {
     ang *= Math.PI / 180;
   }
@@ -247,7 +247,7 @@ export const rotate = (
  * @returns {Point} A new point representing the centroid of the input points.
  * @throws {Error} If the points array is empty.
  */
-export const centroid = (points: Point[], output: Point | null = null) => {
+export const centroid = (points: Point[], output: Point | null = null): Point => {
   const result = output ?? new Point();
   const pointsLen = points.length;
   if (pointsLen < 1) {
@@ -271,7 +271,7 @@ export const centroid = (points: Point[], output: Point | null = null) => {
  * @param {string} yProp - The name of the property containing the y value (default: 'y').
  * @returns {Point} A new point with parsed x and y values.
  */
-export const parse = (obj: any, xProp = 'x', yProp = 'y') => {
+export const parse = (obj: any, xProp = 'x', yProp = 'y'): Point => {
   const point = new Point();
   if (obj[xProp]) {
     point.x = Math.trunc(Number(obj[xProp]));
@@ -288,7 +288,7 @@ export const parse = (obj: any, xProp = 'x', yProp = 'y') => {
  * @param {Point} output - The point to store the result in (optional).
  * @returns {Point} A new point with the same coordinates as the input.
  */
-export const clone = (input: Point, output: Point | null = null) => {
+export const clone = (input: Point, output: Point | null = null): Point => {
   const result = output ?? new Point();
   result.setTo(input.x, input.y);
   return result;

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

@@ -6,7 +6,7 @@ import { Polygon } from '../polygon.js';
  * @param {Polygon} output - Optional polygon to store the result in.
  * @returns {Polygon} The cloned polygon.
  */
-export const clone = (input: Polygon, output: Polygon | null = null) => {
+export const clone = (input: Polygon, output: Polygon | null = null): Polygon => {
   const result = output ?? new Polygon();
   result.setTo([...input._points]);
   return result;

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

@@ -9,7 +9,7 @@ import { getRegistry } from '../../core/registry.js';
  * @param {number} dy - The amount to inflate the rectangle vertically.
  * @returns {Rectangle} The inflated rectangle.
  */
-export const inflate = (a: Rectangle, dx: number, dy: number) => {
+export const inflate = (a: Rectangle, dx: number, dy: number): Rectangle => {
   a.x -= dx;
   a.width += 2 * dx;
   a.y -= dy;
@@ -23,7 +23,7 @@ export const inflate = (a: Rectangle, dx: number, dy: number) => {
  * @param {object} point - The point containing x and y values to inflate the rectangle by.
  * @returns {Rectangle} The inflated rectangle.
  */
-export const inflatePoint = (a: Rectangle, point: any) => inflate(a, point.x, point.y);
+export const inflatePoint = (a: Rectangle, point: any): Rectangle => inflate(a, point.x, point.y);
 
 /**
  * Gets the size of the rectangle as a point.
@@ -31,7 +31,7 @@ export const inflatePoint = (a: Rectangle, point: any) => inflate(a, point.x, po
  * @param {Point} output - Optional point to store the result in.
  * @returns {Point} The size of the rectangle as a point (width, height).
  */
-export const size = (a: Rectangle, output: Point | null = null) => {
+export const size = (a: Rectangle, output: Point | null = null): Point => {
   const result = output ?? new Point();
   result.setTo(a.width, a.height);
   return result;
@@ -43,7 +43,7 @@ export const size = (a: Rectangle, output: Point | null = null) => {
  * @param {Rectangle} output - Optional rectangle to store the result in.
  * @returns {Rectangle} The cloned rectangle.
  */
-export const clone = (input: Rectangle, output: Rectangle | null = null) => {
+export const clone = (input: Rectangle, output: Rectangle | null = null): Rectangle => {
   const result = output ?? new Rectangle();
   result.setTo(input.x, input.y, input.width, input.height);
   return result;
@@ -56,7 +56,7 @@ export const clone = (input: Rectangle, output: Rectangle | null = null) => {
  * @param {number} y - The y coordinate of the point.
  * @returns {boolean} True if the point is contained within the rectangle, false otherwise.
  */
-export const contains = (a: Rectangle, x: number, y: number) => {
+export const contains = (a: Rectangle, x: number, y: number): boolean => {
   if (a.width <= 0 || a.height <= 0) {
     return false;
   }
@@ -73,7 +73,7 @@ export const contains = (a: Rectangle, x: number, y: number) => {
  * @param {number} y - The y coordinate of the point.
  * @returns {boolean} True if the point is contained within the rectangle, false otherwise.
  */
-export const containsRaw = (rx: number, ry: number, rw: number, rh: number, x: number, y: number) =>
+export const containsRaw = (rx: number, ry: number, rw: number, rh: number, x: number, y: number): boolean =>
   x >= rx && x < rx + rw && y >= ry && y < ry + rh;
 
 /**
@@ -82,7 +82,7 @@ export const containsRaw = (rx: number, ry: number, rw: number, rh: number, x: n
  * @param {Point} point - The point to check.
  * @returns {boolean} True if the point is contained within the rectangle, false otherwise.
  */
-export const containsPoint = (a: Rectangle, point: Point) => contains(a, point.x, point.y);
+export const containsPoint = (a: Rectangle, point: Point): boolean => contains(a, point.x, point.y);
 
 /**
  * Checks if rectangle a contains rectangle b.
@@ -90,7 +90,7 @@ export const containsPoint = (a: Rectangle, point: Point) => contains(a, point.x
  * @param {Rectangle} b - The second rectangle to check.
  * @returns {boolean} True if rectangle a contains rectangle b, false otherwise.
  */
-export const containsRect = (a: Rectangle, b: Rectangle) => {
+export const containsRect = (a: Rectangle, b: Rectangle): boolean => {
   if (a.volume > b.volume) {
     return false;
   }
@@ -103,7 +103,7 @@ export const containsRect = (a: Rectangle, b: Rectangle) => {
  * @param {Rectangle} b - The second rectangle to compare.
  * @returns {boolean} True if the rectangles are equal, false otherwise.
  */
-export const equals = (a: Rectangle, b: Rectangle) =>
+export const equals = (a: Rectangle, b: Rectangle): boolean =>
   a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
 
 /**
@@ -112,7 +112,7 @@ export const equals = (a: Rectangle, b: Rectangle) =>
  * @param {Rectangle} b - The second rectangle to compare.
  * @returns {boolean} True if the rectangles have the same dimensions, false otherwise.
  */
-export const sameDimensions = (a: Rectangle, b: Rectangle) => a.width === b.width && a.height === b.height;
+export const sameDimensions = (a: Rectangle, b: Rectangle): boolean => a.width === b.width && a.height === b.height;
 
 /**
  * Checks if two rectangles intersect.
@@ -120,7 +120,17 @@ export const sameDimensions = (a: Rectangle, b: Rectangle) => a.width === b.widt
  * @param {Rectangle} b - The second rectangle to check.
  * @returns {boolean} True if the rectangles intersect, false otherwise.
  */
-export const intersects = (a: Rectangle, b: Rectangle) => {
+/** Anything with an axis-aligned extent, which Line exposes as well as Rectangle. */
+export type Bounds = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  right: number;
+  bottom: number;
+};
+
+export const intersects = (a: Bounds, b: Bounds): boolean => {
   if (a.width <= 0 || a.height <= 0 || b.width <= 0 || b.height <= 0) {
     return false;
   }
@@ -134,7 +144,7 @@ export const intersects = (a: Rectangle, b: Rectangle) => {
  * @param {Rectangle} output - Optional rectangle to store the result in.
  * @returns {Rectangle} The intersection of the rectangles, or an empty rectangle if they don't intersect.
  */
-export const intersection = (a: Rectangle, b: Rectangle, output: Rectangle | null = null) => {
+export const intersection = (a: Rectangle, b: Rectangle, output: Rectangle | null = null): Rectangle => {
   const result = output ?? new Rectangle();
   if (intersects(a, b)) {
     result.x = Math.max(a.x, b.x);
@@ -155,7 +165,14 @@ export const intersection = (a: Rectangle, b: Rectangle, output: Rectangle | nul
  * @param {number} tolerance - Optional tolerance value for intersection.
  * @returns {boolean} True if the rectangle intersects with the area, false otherwise.
  */
-export const intersectsRaw = (a: Rectangle, left: number, right: number, top: number, bottom: number, tolerance = 0) =>
+export const intersectsRaw = (
+  a: Rectangle,
+  left: number,
+  right: number,
+  top: number,
+  bottom: number,
+  tolerance = 0
+): boolean =>
   !(
     left > a.right + tolerance ||
     right < a.left - tolerance ||
@@ -170,7 +187,7 @@ export const intersectsRaw = (a: Rectangle, left: number, right: number, top: nu
  * @param {Rectangle} output - Optional rectangle to store the result in.
  * @returns {Rectangle} The union of the rectangles.
  */
-export const union = (a: Rectangle, b: Rectangle, output: Rectangle | null = null) => {
+export const union = (a: Rectangle, b: Rectangle, output: Rectangle | null = null): Rectangle => {
   const result = output ?? new Rectangle();
   return result.setTo(
     Math.min(a.x, b.x),
@@ -186,13 +203,13 @@ export const union = (a: Rectangle, b: Rectangle, output: Rectangle | null = nul
  * @param {Rectangle} output - Optional rectangle to store the result in.
  * @returns {Rectangle} The AABB of the points.
  */
-export const aabb = (points: Point[], output: Rectangle | null = null) => {
+export const aabb = (points: Point[], output: Rectangle | null = null): Rectangle => {
   const result = output ?? new Rectangle();
   let xMax = Number.NEGATIVE_INFINITY;
   let xMin = Number.POSITIVE_INFINITY;
   let yMax = Number.NEGATIVE_INFINITY;
   let yMin = Number.POSITIVE_INFINITY;
-  points.forEach((point) => {
+  points.forEach((point): void => {
     if (point.x > xMax) {
       xMax = point.x;
     }
@@ -214,7 +231,7 @@ export const aabb = (points: Point[], output: Rectangle | null = null) => {
  * Gets an empty rectangle instance.
  * @returns {Rectangle} An empty rectangle.
  */
-export const getEmptyRectangle = () => {
+export const getEmptyRectangle = (): Rectangle => {
   getRegistry();
   globalThis.PhaserRegistry.EMPTY_RECTANGLE ??= new Rectangle();
   return globalThis.PhaserRegistry.EMPTY_RECTANGLE;

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

@@ -6,7 +6,7 @@ import { RoundedRectangle } from '../rounded_rectangle.js';
  * @param {RoundedRectangle} output - Optional rounded rectangle to store the result in.
  * @returns {RoundedRectangle} The cloned rounded rectangle.
  */
-export const clone = (input: RoundedRectangle, output: RoundedRectangle | null = null) => {
+export const clone = (input: RoundedRectangle, output: RoundedRectangle | null = null): RoundedRectangle => {
   const result = output ?? new RoundedRectangle();
   result.x = input.x;
   result.y = input.y;