@math.gl/core 3.6.0-alpha.1 → 3.6.0-alpha.2

package/dist/classes/vector2.js

@@ -1,29 +1,15 @@
 // Copyright (c) 2017 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// MIT License
 import Vector from './base/vector';
 import { config, isArray } from '../lib/common';
 import { checkNumber } from '../lib/validators';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
 import * as vec2 from 'gl-matrix/vec2';
-// eslint-disable-next-line camelcase
+/* eslint-disable camelcase */
 import { vec2_transformMat4AsVector } from '../lib/gl-matrix-extras';
+/**
+ * Two-element vector class.
+ * Subclass of Array<number>
+ */
 export default class Vector2 extends Vector {
     // Creates a new, empty vec2
     constructor(x = 0, y = 0) {
@@ -69,23 +55,43 @@ export default class Vector2 extends Vector {
     get ELEMENTS() {
         return 2;
     }
-    // x,y inherited from Vector
+    /**
+     * Returns angle from x axis
+     * @returns
+     */
     horizontalAngle() {
         return Math.atan2(this.y, this.x);
     }
+    /**
+     * Returns angle from y axis
+     * @returns
+     */
     verticalAngle() {
         return Math.atan2(this.x, this.y);
     }
     // Transforms
+    /**
+     * Transforms as point
+     * @param matrix4
+     * @returns
+     */
     transform(matrix4) {
         return this.transformAsPoint(matrix4);
     }
-    // transforms as point (4th component is implicitly 1)
+    /**
+     * transforms as point (4th component is implicitly 1)
+     * @param matrix4
+     * @returns
+     */
     transformAsPoint(matrix4) {
         vec2.transformMat4(this, this, matrix4);
         return this.check();
     }
-    // transforms as vector  (4th component is implicitly 0, ignores translation. slightly faster)
+    /**
+     * transforms as vector (4th component is implicitly 0, ignores translation. slightly faster)
+     * @param matrix4
+     * @returns
+     */
     transformAsVector(matrix4) {
         vec2_transformMat4AsVector(this, this, matrix4);
         return this.check();

package/dist/classes/vector3.d.ts

@@ -1,41 +1,56 @@
-export default class Vector3 extends Vector<any> {
-    static get ZERO(): any;
+import { NumericArray } from '@math.gl/types';
+import Vector from './base/vector';
+/**
+ * Three-element vector class.
+ * Subclass of Array<number>
+ */
+export default class Vector3 extends Vector {
+    static get ZERO(): Vector3;
     /**
      * @class
-     * @param {Number | [Number, Number, Number]} x
-     * @param {Number} y - rotation around X (latitude)
-     * @param {Number} z - rotation around X (latitude)
+     * @param x
+     * @param y
+     * @param z
      */
-    constructor(x?: number | [number, number, number], y?: number, z?: number, ...args: any[]);
-    0: number | [number, number, number];
-    1: number;
-    2: number;
-    set(x: any, y: any, z: any): any;
-    copy(array: any): any;
-    fromObject(object: any): any;
-    toObject(object: any): any;
-    set z(arg: number);
+    constructor(x?: number | Readonly<NumericArray>, y?: number, z?: number);
+    set(x: number, y: number, z: number): this;
+    copy(array: Readonly<NumericArray>): this;
+    fromObject(object: {
+        x: number;
+        y: number;
+        z: number;
+    }): this;
+    toObject(object: {
+        x?: number;
+        y?: number;
+        z?: number;
+    }): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    get ELEMENTS(): number;
     get z(): number;
-    angle(vector: any): any;
-    cross(vector: any): any;
+    set z(value: number);
+    angle(vector: Readonly<NumericArray>): number;
+    cross(vector: Readonly<NumericArray>): this;
     rotateX({ radians, origin }: {
-        radians: any;
-        origin?: number[];
-    }): any;
+        radians: number;
+        origin?: Readonly<NumericArray>;
+    }): this;
     rotateY({ radians, origin }: {
-        radians: any;
-        origin?: number[];
-    }): any;
+        radians: number;
+        origin?: Readonly<NumericArray>;
+    }): this;
     rotateZ({ radians, origin }: {
-        radians: any;
-        origin?: number[];
-    }): any;
-    transform(matrix4: any): any;
-    transformAsPoint(matrix4: any): any;
-    transformAsVector(matrix4: any): any;
-    transformByMatrix3(matrix3: any): any;
-    transformByMatrix2(matrix2: any): any;
-    transformByQuaternion(quaternion: any): any;
+        radians: number;
+        origin?: Readonly<NumericArray>;
+    }): this;
+    transform(matrix4: Readonly<NumericArray>): this;
+    transformAsPoint(matrix4: Readonly<NumericArray>): this;
+    transformAsVector(matrix4: Readonly<NumericArray>): this;
+    transformByMatrix3(matrix3: Readonly<NumericArray>): this;
+    transformByMatrix2(matrix2: Readonly<NumericArray>): this;
+    transformByQuaternion(quaternion: Readonly<NumericArray>): this;
 }
-import Vector from "./base/vector";
 //# sourceMappingURL=vector3.d.ts.map

package/dist/classes/vector3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../../src/classes/vector3.js"],"names":[],"mappings":"AAgCA;IACE,uBAEC;IAED;;;;;OAKG;IACH,gBAJW,SAAS,wBAAwB,0CAqB3C;IAJG,qCAAW;IACX,UAAW;IACX,UAAW;IAIf,iCAKC;IAED,sBAKC;IAED,6BAUC;IAED,2BAKC;IAaD,mBAEC;IALD,gBAEC;IAMD,wBAEC;IAID,wBAGC;IAED;;;YAGC;IAED;;;YAGC;IAED;;;YAGC;IAKD,6BAEC;IAGD,oCAGC;IAGD,qCAGC;IAED,sCAGC;IAED,sCAGC;IAED,4CAGC;CACF"}
+{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../../src/classes/vector3.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,MAAM,MAAM,eAAe,CAAC;AAWnC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,MAAM;IACzC,MAAM,KAAK,IAAI,IAAI,OAAO,CAMzB;IAED;;;;;OAKG;gBACS,CAAC,GAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAK,EAAE,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU;IAmBhF,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1C,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAOzC,UAAU,CAAC,MAAM,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI;IAY3D,QAAQ,CAAC,MAAM,EAAE;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC;IASzF,IAAI,QAAQ,IAAI,MAAM,CAErB;IACD,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAID,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,MAAM;IAM7C,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAK3C,OAAO,CAAC,EAAC,OAAO,EAAE,MAAe,EAAC,EAAE;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;KAAC,GAAG,IAAI;IAK7F,OAAO,CAAC,EAAC,OAAO,EAAE,MAAe,EAAC,EAAE;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;KAAC,GAAG,IAAI;IAK7F,OAAO,CAAC,EAAC,OAAO,EAAE,MAAe,EAAC,EAAE;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;KAAC,GAAG,IAAI;IAQ7F,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKhD,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAMvD,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKxD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKzD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKzD,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;CAIhE"}

package/dist/classes/vector3.js

@@ -1,40 +1,28 @@
-// Copyright (c) 2017 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
 import Vector from './base/vector';
 import { config, isArray } from '../lib/common';
 import { checkNumber } from '../lib/validators';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
 import * as vec3 from 'gl-matrix/vec3';
-// eslint-disable-next-line camelcase
+/* eslint-disable camelcase */
 import { vec3_transformMat2, vec3_transformMat4AsVector } from '../lib/gl-matrix-extras';
 const ORIGIN = [0, 0, 0];
-const constants = {};
+let ZERO;
+/**
+ * Three-element vector class.
+ * Subclass of Array<number>
+ */
 export default class Vector3 extends Vector {
     static get ZERO() {
-        return (constants.ZERO = constants.ZERO || Object.freeze(new Vector3(0, 0, 0, 0)));
+        if (!ZERO) {
+            ZERO = new Vector3(0, 0, 0);
+            Object.freeze(ZERO);
+        }
+        return ZERO;
     }
     /**
      * @class
-     * @param {Number | [Number, Number, Number]} x
-     * @param {Number} y - rotation around X (latitude)
-     * @param {Number} z - rotation around X (latitude)
+     * @param x
+     * @param y
+     * @param z
      */
     constructor(x = 0, y = 0, z = 0) {
         // PERF NOTE: initialize elements as double precision numbers
@@ -49,7 +37,7 @@ export default class Vector3 extends Vector {
                 checkNumber(y);
                 checkNumber(z);
             }
-            // @ts-ignore TS2412: Property '0' of type 'number | [number, number, number]' is not assignable to numeric index type 'number'
+            // @ts-expect-error TS2412: Property '0' of type 'number | [number, number, number]' is not assignable to numeric index type 'number'
             this[0] = x;
             this[1] = y;
             this[2] = z;
@@ -85,18 +73,16 @@ export default class Vector3 extends Vector {
         return object;
     }
     // Getters/setters
-    /* eslint-disable no-multi-spaces, brace-style, no-return-assign */
     get ELEMENTS() {
         return 3;
     }
-    // x,y inherited from Vector
     get z() {
         return this[2];
     }
     set z(value) {
         this[2] = checkNumber(value);
     }
-    /* eslint-enable no-multi-spaces, brace-style, no-return-assign */
+    // ACCESSORS
     angle(vector) {
         return vec3.angle(this, vector);
     }

package/dist/classes/vector4.d.ts

@@ -1,23 +1,41 @@
-export default class Vector4 extends Vector<any> {
-    static get ZERO(): any;
-    constructor(x?: number, y?: number, z?: number, w?: number, ...args: any[]);
-    0: number;
-    1: number;
-    2: number;
-    3: number;
-    set(x: any, y: any, z: any, w: any): any;
-    copy(array: any): any;
-    fromObject(object: any): Vector4;
-    toObject(object: any): any;
-    set z(arg: number);
+import Vector from './base/vector';
+import { NumericArray } from '@math.gl/types';
+import type Matrix4 from './matrix4';
+/**
+ * Four-element vector class.
+ * Subclass of Array<number>
+ */
+export default class Vector4 extends Vector {
+    static get ZERO(): Vector4;
+    constructor(x?: number | Readonly<NumericArray>, y?: number, z?: number, w?: number);
+    set(x: number, y: number, z: number, w: number): this;
+    copy(array: Readonly<NumericArray>): this;
+    fromObject(object: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    }): this;
+    toObject(object: {
+        x?: number;
+        y?: number;
+        z?: number;
+        w?: number;
+    }): {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    get ELEMENTS(): number;
     get z(): number;
-    set w(arg: number);
+    set z(value: number);
     get w(): number;
-    transform(matrix4: any): any;
-    transformByMatrix3(matrix3: any): any;
-    transformByMatrix2(matrix2: any): any;
-    transformByQuaternion(quaternion: any): any;
-    applyMatrix4(m: any): Vector4;
+    set w(value: number);
+    transform(matrix4: Readonly<NumericArray>): this;
+    transformByMatrix3(matrix3: Readonly<NumericArray>): this;
+    transformByMatrix2(matrix2: Readonly<NumericArray>): this;
+    transformByQuaternion(quaternion: Readonly<NumericArray>): this;
+    applyMatrix4(m: Matrix4): this;
 }
-import Vector from "./base/vector";
 //# sourceMappingURL=vector4.d.ts.map

package/dist/classes/vector4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector4.d.ts","sourceRoot":"","sources":["../../src/classes/vector4.js"],"names":[],"mappings":"AA+BA;IACE,uBAEC;IAED,4EAkBC;IALG,UAAW;IACX,UAAW;IACX,UAAW;IACX,UAAW;IAIf,yCAMC;IAED,sBAMC;IAED,iCAYC;IAED,2BAMC;IAcD,mBAEC;IAND,gBAEC;IAUD,mBAEC;IAND,gBAEC;IAOD,6BAGC;IAED,sCAGC;IAED,sCAGC;IAED,4CAGC;IAGD,8BAGC;CACF"}
+{"version":3,"file":"vector4.d.ts","sourceRoot":"","sources":["../../src/classes/vector4.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,eAAe,CAAC;AAMnC,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAIrC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,MAAM;IACzC,MAAM,KAAK,IAAI,IAAI,OAAO,CAMzB;gBAEW,CAAC,GAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAK,EAAE,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU,EAAE,CAAC,GAAE,MAAU;IAoB/F,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAQrD,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAQzC,UAAU,CAAC,MAAM,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI;IActE,QAAQ,CAAC,MAAM,EAAE;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG;QAClE,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX;IAeD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IACD,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKhD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKzD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKzD,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAM/D,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;CAI/B"}

package/dist/classes/vector4.js

@@ -1,33 +1,23 @@
 // Copyright (c) 2017 Uber Technologies, Inc.
-//
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-//
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-//
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// MIT License
 import Vector from './base/vector';
 import { config, isArray } from '../lib/common';
 import { checkNumber } from '../lib/validators';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
 import * as vec4 from 'gl-matrix/vec3';
-// eslint-disable-next-line camelcase
+/* eslint-disable camelcase */
 import { vec4_transformMat2, vec4_transformMat3 } from '../lib/gl-matrix-extras';
-const constants = {};
+let ZERO;
+/**
+ * Four-element vector class.
+ * Subclass of Array<number>
+ */
 export default class Vector4 extends Vector {
     static get ZERO() {
-        return (constants.ZERO = constants.ZERO || Object.freeze(new Vector4(0, 0, 0, 0)));
+        if (!ZERO) {
+            ZERO = new Vector4(0, 0, 0, 0);
+            Object.freeze(ZERO);
+        }
+        return ZERO;
     }
     constructor(x = 0, y = 0, z = 0, w = 0) {
         // PERF NOTE: initialize elements as double precision numbers
@@ -88,7 +78,6 @@ export default class Vector4 extends Vector {
     get ELEMENTS() {
         return 4;
     }
-    // x,y inherited from Vector
     get z() {
         return this[2];
     }
@@ -101,7 +90,6 @@ export default class Vector4 extends Vector {
     set w(value) {
         this[3] = checkNumber(value);
     }
-    /* eslint-enable no-multi-spaces, brace-style, no-return-assign */
     transform(matrix4) {
         vec4.transformMat4(this, this, matrix4);
         return this.check();