@vpmedia/phaser 1.11.0 → 1.13.0

package/src/phaser/display/webgl/util.js

@@ -1,22 +1,22 @@
 /**
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
  * @author       Mat Groves http://matgroves.com/ @Doormat23
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 
 /**
- *
+ * TBD.
  */
-export function initDefaultShaders() {
-}
+export function initDefaultShaders() {}
 
 /**
+ * TBD.
  *
- * @param {object} gl TBD
- * @param {string[]|string} shaderSrc TBD
- * @param {object} shaderType TBD
- * @returns {object} TBD
+ * @param {object} gl - TBD.
+ * @param {string[]|string} shaderSrc - TBD.
+ * @param {object} shaderType - TBD.
+ * @returns {object} TBD.
  */
 export function compileShader(gl, shaderSrc, shaderType) {
   let src = shaderSrc;
@@ -36,31 +36,34 @@ export function compileShader(gl, shaderSrc, shaderType) {
 }
 
 /**
+ * TBD.
  *
- * @param {object} gl TBD
- * @param {string[]|string} shaderSrc TBD
- * @returns {object} TBD
+ * @param {object} gl - TBD.
+ * @param {string[]|string} shaderSrc - TBD.
+ * @returns {object} TBD.
  */
 export function compileVertexShader(gl, shaderSrc) {
   return compileShader(gl, shaderSrc, gl.VERTEX_SHADER);
 }
 
 /**
+ * TBD.
  *
- * @param {object} gl TBD
- * @param {string[]|string} shaderSrc TBD
- * @returns {object} TBD
+ * @param {object} gl - TBD.
+ * @param {string[]|string} shaderSrc - TBD.
+ * @returns {object} TBD.
  */
 export function compileFragmentShader(gl, shaderSrc) {
   return compileShader(gl, shaderSrc, gl.FRAGMENT_SHADER);
 }
 
 /**
+ * TBD.
  *
- * @param {object} gl TBD
- * @param {string[]|string} vertexSrc TBD
- * @param {string[]|string} fragmentSrc TBD
- * @returns {object} TBD
+ * @param {object} gl - TBD.
+ * @param {string[]|string} vertexSrc - TBD.
+ * @param {string[]|string} fragmentSrc - TBD.
+ * @returns {object} TBD.
  */
 export function compileProgram(gl, vertexSrc, fragmentSrc) {
   const fragmentShader = compileFragmentShader(gl, fragmentSrc);

package/src/phaser/geom/circle.js

@@ -1,16 +1,23 @@
 /**
+ * @module geom/circle
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from './point';
-import Rectangle from './rectangle';
+import { Point } from './point';
+import { Rectangle } from  './rectangle';
 import { distance } from '../util/math';
 import { clone, contains, circumferencePoint } from './util/circle';
 import { GEOM_CIRCLE } from '../core/const';
 
-export default class {
-
+export class Circle {
+  /**
+   * TBD.
+   *
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   * @param {number} diameter - TBD.
+   */
   constructor(x = 0, y = 0, diameter = 0) {
     this.x = x;
     this.y = y;
@@ -30,11 +37,11 @@ export default class {
     const result = output || new Point();
     const t = 2 * Math.PI * Math.random();
     const u = Math.random() + Math.random();
-    const r = (u > 1) ? 2 - u : u;
+    const r = u > 1 ? 2 - u : u;
     const x = r * Math.cos(t);
     const y = r * Math.sin(t);
-    result.x = this.x + (x * this.radius);
-    result.y = this.y + (y * this.radius);
+    result.x = this.x + x * this.radius;
+    result.y = this.y + y * this.radius;
     return result;
   }
 
@@ -89,7 +96,17 @@ export default class {
   }
 
   toString() {
-    return '[{Circle (x=' + this.x + ' y=' + this.y + ' diameter=' + this.diameter + ' radius=' + this.radius + ')}]';
+    return (
+      '[{Circle (x=' +
+      this.x +
+      ' y=' +
+      this.y +
+      ' diameter=' +
+      this.diameter +
+      ' radius=' +
+      this.radius +
+      ')}]'
+    );
   }
 
   get diameter() {
@@ -174,7 +191,7 @@ export default class {
   }
 
   get empty() {
-    return (this._diameter === 0);
+    return this._diameter === 0;
   }
 
   set empty(value) {
@@ -182,5 +199,4 @@ export default class {
       this.setTo(0, 0, 0);
     }
   }
-
 }

package/src/phaser/geom/ellipse.js

@@ -1,15 +1,23 @@
 /**
+ * @module geom/ellipse
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from './point';
-import Rectangle from './rectangle';
+import { Point } from './point';
+import { Rectangle } from  './rectangle';
 import { contains } from './util/ellipse';
 import { GEOM_ELLIPSE } from '../core/const';
 
-export default class {
-
+export class Ellipse {
+  /**
+   * TBD.
+   *
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   */
   constructor(x = 0, y = 0, width = 0, height = 0) {
     this.x = x;
     this.y = y;
@@ -52,14 +60,22 @@ export default class {
     const r = Math.random();
     result.x = Math.sqrt(r) * Math.cos(p);
     result.y = Math.sqrt(r) * Math.sin(p);
-    result.x = this.x + (result.x * this.width / 2.0);
-    result.y = this.y + (result.y * this.height / 2.0);
+    result.x = this.x + (result.x * this.width) / 2.0;
+    result.y = this.y + (result.y * this.height) / 2.0;
     return result;
   }
 
   toString() {
-    return '[{Ellipse (x=' + this.x + ' y=' + this.y + ' width=' + this.width + ' height=' + this.height + ')}]';
+    return (
+      '[{Ellipse (x=' +
+      this.x +
+      ' y=' +
+      this.y +
+      ' width=' +
+      this.width +
+      ' height=' +
+      this.height +
+      ')}]'
+    );
   }
-
-
 }

package/src/phaser/geom/line.js

@@ -1,15 +1,23 @@
 /**
+ * @module geom/line
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from './point';
+import { Point } from './point';
 import { clone, intersectsPoints, reflect } from './util/line';
 import { wrap } from '../util/math';
 import { GEOM_LINE } from '../core/const';
 
-export default class {
-
+export class Line {
+  /**
+   * TBD.
+   *
+   * @param {number} x1 - TBD.
+   * @param {number} y1 - TBD.
+   * @param {number} x2 - TBD.
+   * @param {number} y2 - TBD.
+   */
   constructor(x1 = 0, y1 = 0, x2 = 0, y2 = 0) {
     this.start = new Point(x1, y1);
     this.end = new Point(x2, y2);
@@ -24,14 +32,19 @@ export default class {
 
   fromSprite(startSprite, endSprite, useCenter = false) {
     if (useCenter) {
-      return this.setTo(startSprite.center.x, startSprite.center.y, endSprite.center.x, endSprite.center.y);
+      return this.setTo(
+        startSprite.center.x,
+        startSprite.center.y,
+        endSprite.center.x,
+        endSprite.center.y
+      );
     }
     return this.setTo(startSprite.x, startSprite.y, endSprite.x, endSprite.y);
   }
 
   fromAngle(x, y, angle, length) {
     this.start.setTo(x, y);
-    this.end.setTo(x + (Math.cos(angle) * length), y + (Math.sin(angle) * length));
+    this.end.setTo(x + Math.cos(angle) * length, y + Math.sin(angle) * length);
     return this;
   }
 
@@ -74,7 +87,10 @@ export default class {
   }
 
   pointOnLine(x, y) {
-    return ((x - this.start.x) * (this.end.y - this.start.y) === (this.end.x - this.start.x) * (y - this.start.y));
+    return (
+      (x - this.start.x) * (this.end.y - this.start.y) ===
+      (this.end.x - this.start.x) * (y - this.start.y)
+    );
   }
 
   pointOnSegment(x, y) {
@@ -82,7 +98,7 @@ export default class {
     const xMax = Math.max(this.start.x, this.end.x);
     const yMin = Math.min(this.start.y, this.end.y);
     const yMax = Math.max(this.start.y, this.end.y);
-    return (this.pointOnLine(x, y) && (x >= xMin && x <= xMax) && (y >= yMin && y <= yMax));
+    return this.pointOnLine(x, y) && x >= xMin && x <= xMax && y >= yMin && y <= yMax;
   }
 
   random(output = null) {
@@ -100,12 +116,12 @@ export default class {
     const y2 = Math.round(this.end.y);
     const dx = Math.abs(x2 - x1);
     const dy = Math.abs(y2 - y1);
-    const sx = (x1 < x2) ? 1 : -1;
-    const sy = (y1 < y2) ? 1 : -1;
+    const sx = x1 < x2 ? 1 : -1;
+    const sy = y1 < y2 ? 1 : -1;
     let err = dx - dy;
     results.push([x1, y1]);
     let i = 1;
-    while (!((x1 === x2) && (y1 === y2))) {
+    while (!(x1 === x2 && y1 === y2)) {
       const e2 = err << 1;
       if (e2 > -dy) {
         err -= dy;
@@ -128,7 +144,10 @@ export default class {
   }
 
   get length() {
-    return Math.sqrt((this.end.x - this.start.x) * (this.end.x - this.start.x) + (this.end.y - this.start.y) * (this.end.y - this.start.y));
+    return Math.sqrt(
+      (this.end.x - this.start.x) * (this.end.x - this.start.x) +
+        (this.end.y - this.start.y) * (this.end.y - this.start.y)
+    );
   }
 
   get angle() {
@@ -186,5 +205,4 @@ export default class {
   get normalAngle() {
     return wrap(this.angle - 1.5707963267948966, -Math.PI, Math.PI);
   }
-
 }

package/src/phaser/geom/matrix.js

@@ -1,14 +1,24 @@
 /**
+ * @module geom/matrix
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from './point';
+import { Point } from './point';
 import { clone } from './util/matrix';
 import { GEOM_MATRIX } from '../core/const';
 
-export default class {
-
+export class Matrix {
+  /**
+   * TBD.
+   *
+   * @param {number} a - TBD.
+   * @param {number} b - TBD.
+   * @param {number} c - TBD.
+   * @param {number} d - TBD.
+   * @param {number} tx - TBD.
+   * @param {number} ty - TBD.
+   */
   constructor(a = 1, b = 0, c = 0, d = 1, tx = 0, ty = 0) {
     this.a = a;
     this.b = b;
@@ -143,5 +153,4 @@ export default class {
   identity() {
     return this.setTo(1, 0, 0, 1, 0, 0);
   }
-
 }

package/src/phaser/geom/point.js

@@ -1,13 +1,19 @@
 /**
+ * @module geom/point
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 import { distance, rotate, clone } from './util/point';
 import { GEOM_POINT } from '../core/const';
 
-export default class {
-
+export class Point {
+  /**
+   * TBD.
+   *
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   */
   constructor(x = 0, y = 0) {
     this.x = x;
     this.y = y;
@@ -24,14 +30,14 @@ export default class {
 
   setTo(x, y) {
     this.x = x || 0;
-    this.y = y || ((y !== 0) ? this.x : 0);
+    this.y = y || (y !== 0 ? this.x : 0);
     return this;
   }
 
   set(x, y) {
     // deprecated, use setTo(x, y)
     this.x = x || 0;
-    this.y = y || ((y !== 0) ? this.x : 0);
+    this.y = y || (y !== 0 ? this.x : 0);
     return this;
   }
 
@@ -90,12 +96,12 @@ export default class {
   }
 
   equals(a) {
-    return (a.x === this.x && a.y === this.y);
+    return a.x === this.x && a.y === this.y;
   }
 
   angle(a, asDegrees = false) {
     if (asDegrees) {
-      return (180 / Math.PI) * (Math.atan2(a.y - this.y, a.x - this.x));
+      return (180 / Math.PI) * Math.atan2(a.y - this.y, a.x - this.x);
     }
     return Math.atan2(a.y - this.y, a.x - this.x);
   }
@@ -105,11 +111,11 @@ export default class {
   }
 
   getMagnitude() {
-    return Math.sqrt((this.x * this.x) + (this.y * this.y));
+    return Math.sqrt(this.x * this.x + this.y * this.y);
   }
 
   getMagnitudeSq() {
-    return (this.x * this.x) + (this.y * this.y);
+    return this.x * this.x + this.y * this.y;
   }
 
   setMagnitude(magnitude) {
@@ -126,15 +132,15 @@ export default class {
   }
 
   isZero() {
-    return (this.x === 0 && this.y === 0);
+    return this.x === 0 && this.y === 0;
   }
 
   dot(a) {
-    return ((this.x * a.x) + (this.y * a.y));
+    return this.x * a.x + this.y * a.y;
   }
 
   cross(a) {
-    return ((this.x * a.y) - (this.y * a.x));
+    return this.x * a.y - this.y * a.x;
   }
 
   perp() {
@@ -160,5 +166,4 @@ export default class {
   toString() {
     return '[{Point (x=' + this.x + ' y=' + this.y + ')}]';
   }
-
 }

package/src/phaser/geom/polygon.js

@@ -1,14 +1,14 @@
 /**
+ * @module geom/polygon
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from './point';
+import { Point } from './point';
 import { clone } from './util/polygon';
 import { GEOM_POLYGON } from '../core/const';
 
-export default class {
-
+export class Polygon {
   constructor(points = null) {
     this.area = 0;
     this._points = [];
@@ -53,7 +53,10 @@ export default class {
         const iy = this._points[i + 1];
         const jx = this._points[j];
         const jy = this._points[j + 1];
-        if (((iy <= y && y < jy) || (jy <= y && y < iy)) && (x < (jx - ix) * (y - iy) / (jy - iy) + ix)) {
+        if (
+          ((iy <= y && y < jy) || (jy <= y && y < iy)) &&
+          x < ((jx - ix) * (y - iy)) / (jy - iy) + ix
+        ) {
           inside = !inside;
         }
       }
@@ -63,7 +66,10 @@ export default class {
         const iy = this._points[i].y;
         const jx = this._points[j].x;
         const jy = this._points[j].y;
-        if (((iy <= y && y < jy) || (jy <= y && y < iy)) && (x < (jx - ix) * (y - iy) / (jy - iy) + ix)) {
+        if (
+          ((iy <= y && y < jy) || (jy <= y && y < iy)) &&
+          x < ((jx - ix) * (y - iy)) / (jy - iy) + ix
+        ) {
           inside = !inside;
         }
       }
@@ -117,7 +123,7 @@ export default class {
       } else {
         p2 = this._points[i + 1];
       }
-      avgHeight = ((p1.y - y0) + (p2.y - y0)) / 2;
+      avgHeight = (p1.y - y0 + (p2.y - y0)) / 2;
       width = p1.x - p2.x;
       this.area += avgHeight * width;
     }
@@ -136,5 +142,4 @@ export default class {
       this._points = [];
     }
   }
-
 }

package/src/phaser/geom/rectangle.js

@@ -1,14 +1,44 @@
 /**
+ * @module geom/rectangle
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
-import Point from './point';
-import { inflate, size, clone, contains, containsRect, equals, intersects, intersection, intersectsRaw, union } from './util/rectangle';
-import { GEOM_RECTANGLE, TOP_LEFT, TOP_CENTER, TOP_RIGHT, LEFT_CENTER, CENTER, RIGHT_CENTER, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT } from '../core/const';
-
-export default class {
-
+import { Point } from './point';
+import {
+  inflate,
+  size,
+  clone,
+  contains,
+  containsRect,
+  equals,
+  intersects,
+  intersection,
+  intersectsRaw,
+  union,
+} from './util/rectangle';
+import {
+  GEOM_RECTANGLE,
+  TOP_LEFT,
+  TOP_CENTER,
+  TOP_RIGHT,
+  LEFT_CENTER,
+  CENTER,
+  RIGHT_CENTER,
+  BOTTOM_LEFT,
+  BOTTOM_CENTER,
+  BOTTOM_RIGHT,
+} from '../core/const';
+
+export class Rectangle {
+  /**
+   * TBD.
+   *
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   */
   constructor(x = 0, y = 0, width = 0, height = 0) {
     this.x = x;
     this.y = y;
@@ -36,7 +66,9 @@ export default class {
   }
 
   scale(x, y) {
-    if (y === undefined) { y = x; }
+    if (y === undefined) {
+      y = x;
+    }
     this.width *= x;
     this.height *= y;
     return this;
@@ -164,7 +196,19 @@ export default class {
   }
 
   toString() {
-    return '[{Rectangle (x=' + this.x + ' y=' + this.y + ' width=' + this.width + ' height=' + this.height + ' empty=' + this.empty + ')}]';
+    return (
+      '[{Rectangle (x=' +
+      this.x +
+      ' y=' +
+      this.y +
+      ' width=' +
+      this.width +
+      ' height=' +
+      this.height +
+      ' empty=' +
+      this.empty +
+      ')}]'
+    );
   }
 
   get halfWidth() {
@@ -184,7 +228,7 @@ export default class {
       this.height = 0;
       this.y = value;
     } else {
-      this.height = (this.bottom - value);
+      this.height = this.bottom - value;
     }
   }
 
@@ -266,7 +310,7 @@ export default class {
   }
 
   get perimeter() {
-    return (this.width * 2) + (this.height * 2);
+    return this.width * 2 + this.height * 2;
   }
 
   get centerX() {
@@ -286,11 +330,11 @@ export default class {
   }
 
   get randomX() {
-    return this.x + (Math.random() * this.width);
+    return this.x + Math.random() * this.width;
   }
 
   get randomY() {
-    return this.y + (Math.random() * this.height);
+    return this.y + Math.random() * this.height;
   }
 
   get empty() {
@@ -302,5 +346,4 @@ export default class {
       this.setTo(0, 0, 0, 0);
     }
   }
-
 }

package/src/phaser/geom/rounded_rectangle.js

@@ -1,13 +1,22 @@
 /**
+ * @module geom/rounded_rectangle
+ * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  * @author       Andras Csizmadia <andras@vpmedia.hu>
  * @author       Richard Davey <rich@photonstorm.com>
- * @copyright    Copyright (c) 2018-present Richard Davey, Photon Storm Ltd., Andras Csizmadia <andras@vpmedia.hu> (www.vpmedia.hu)
  */
 import { clone } from './util/rounded_rectangle';
 import { GEOM_ROUNDED_RECTANGLE } from '../core/const';
 
-export default class {
-
+export class RoundedRectangle {
+  /**
+   * TBD.
+   *
+   * @param {number} x - TBD.
+   * @param {number} y - TBD.
+   * @param {number} width - TBD.
+   * @param {number} height - TBD.
+   * @param {number} radius - TBD.
+   */
   constructor(x = 0, y = 0, width = 0, height = 0, radius = 20) {
     this.x = x;
     this.y = y;
@@ -32,5 +41,4 @@ export default class {
   clone() {
     return clone(this);
   }
-
 }