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

package/dist/classes/pose.js

@@ -1,28 +1,10 @@
 // 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 Matrix4 from './matrix4';
 import Vector3 from './vector3';
 import Euler from './euler';
 export default class Pose {
-    // @ts-ignore TS2740: Type '{}' is missing the following properties from type
-    constructor({ x = 0, y = 0, z = 0, roll = 0, pitch = 0, yaw = 0, position = undefined, orientation = undefined } = {}) {
+    constructor({ x = 0, y = 0, z = 0, roll = 0, pitch = 0, yaw = 0, position, orientation } = {}) {
         if (Array.isArray(position) && position.length === 3) {
             this.position = new Vector3(position);
         }
@@ -30,6 +12,7 @@ export default class Pose {
             this.position = new Vector3(x, y, z);
         }
         if (Array.isArray(orientation) && orientation.length === 4) {
+            // @ts-expect-error
             this.orientation = new Euler(orientation, orientation[3]);
         }
         else {
@@ -91,14 +74,15 @@ export default class Pose {
         return (this.position.exactEquals(pose.position) && this.orientation.exactEquals(pose.orientation));
     }
     getTransformationMatrix() {
-        // setup precomputations for the sin/cos of the angles
+        // setup pre computations for the sin/cos of the angles
         const sr = Math.sin(this.roll);
         const sp = Math.sin(this.pitch);
         const sw = Math.sin(this.yaw);
         const cr = Math.cos(this.roll);
         const cp = Math.cos(this.pitch);
         const cw = Math.cos(this.yaw);
-        const matrix = new Matrix4().setRowMajor(cw * cp, // 0,0
+        // Create matrix
+        return new Matrix4().setRowMajor(cw * cp, // 0,0
         -sw * cr + cw * sp * sr, // 0,1
         sw * sr + cw * sp * cr, // 0,2
         this.x, // 0,3
@@ -111,7 +95,6 @@ export default class Pose {
         cp * cr, // 2,2
         this.z, // 2,3
         0, 0, 0, 1);
-        return matrix;
     }
     getTransformationMatrixFromPose(pose) {
         return new Matrix4()

package/dist/classes/quaternion.d.ts

@@ -1,42 +1,63 @@
-export default class Quaternion extends MathArray<any> {
-    constructor(x?: number, y?: number, z?: number, w?: number, ...args: any[]);
-    copy(array: any): any;
-    0: any;
-    1: any;
-    2: any;
-    3: any;
-    set(x: any, y: any, z: any, w: any): any;
-    fromMatrix3(m: any): any;
-    identity(): any;
-    fromAxisRotation(axis: any, rad: any): any;
-    setAxisAngle(axis: any, rad: any): any;
-    set x(arg: any);
-    get x(): any;
-    set y(arg: any);
-    get y(): any;
-    set z(arg: any);
-    get z(): any;
-    set w(arg: any);
-    get w(): any;
-    len(): any;
-    lengthSquared(): any;
-    dot(a: any, b: any): any;
-    rotationTo(vectorA: any, vectorB: any): any;
-    calculateW(): any;
-    conjugate(): any;
-    invert(): any;
-    multiplyRight(a: any, b: any): any;
-    multiplyLeft(a: any, b: any): any;
-    normalize(): any;
-    rotateX(rad: any): any;
-    rotateY(rad: any): any;
-    rotateZ(rad: any): any;
-    slerp(start: any, target: any, ratio: any, ...args: any[]): any;
-    transformVector4(vector: any, result?: any): any;
-    lengthSq(): any;
-    setFromAxisAngle(axis: any, rad: any): any;
-    premultiply(a: any, b: any): any;
-    multiply(a: any, b: any): any;
+import MathArray from './base/math-array';
+import { NumericArray } from '@math.gl/types';
+export default class Quaternion extends MathArray {
+    constructor(x?: number | Readonly<NumericArray>, y?: number, z?: number, w?: number);
+    copy(array: Readonly<NumericArray>): this;
+    set(x: number, y: number, z: number, w: number): this;
+    fromObject(object: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    }): this;
+    /**
+     * Creates a quaternion from the given 3x3 rotation matrix.
+     * NOTE: The resultant quaternion is not normalized, so you should
+     * be sure to renormalize the quaternion yourself where necessary.
+     * @param m
+     * @returns
+     */
+    fromMatrix3(m: Readonly<NumericArray>): this;
+    fromAxisRotation(axis: Readonly<NumericArray>, rad: number): this;
+    /** Set a quat to the identity quaternion */
+    identity(): this;
+    setAxisAngle(axis: Readonly<NumericArray>, rad: number): this;
+    get ELEMENTS(): number;
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    get z(): number;
+    set z(value: number);
+    get w(): number;
+    set w(value: number);
+    len(): number;
+    lengthSquared(): number;
+    dot(a: Readonly<NumericArray>): number;
+    rotationTo(vectorA: NumericArray, vectorB: NumericArray): this;
+    add(a: Readonly<NumericArray>): this;
+    calculateW(): this;
+    conjugate(): this;
+    invert(): this;
+    lerp(a: Readonly<NumericArray>, b: Readonly<NumericArray> | number, t?: number): this;
+    multiplyRight(a: Readonly<NumericArray>): this;
+    multiplyLeft(a: Readonly<NumericArray>): this;
+    normalize(): this;
+    rotateX(rad: number): this;
+    rotateY(rad: number): this;
+    rotateZ(rad: number): this;
+    scale(b: number): this;
+    slerp(target: Readonly<NumericArray>, ratio: number): this;
+    slerp(start: Readonly<NumericArray>, target: Readonly<NumericArray>, ratio: number): this;
+    slerp(params: {
+        start: Readonly<NumericArray>;
+        target: Readonly<NumericArray>;
+        ratio: number;
+    }): this;
+    transformVector4(vector: Readonly<NumericArray>, result?: NumericArray): NumericArray;
+    lengthSq(): number;
+    setFromAxisAngle(axis: Readonly<NumericArray>, rad: number): this;
+    premultiply(a: Readonly<NumericArray>): this;
+    multiply(a: Readonly<NumericArray>): this;
 }
-import MathArray from "./base/math-array";
 //# sourceMappingURL=quaternion.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"quaternion.d.ts","sourceRoot":"","sources":["../../src/classes/quaternion.js"],"names":[],"mappings":"AA+BA;IACE,4EASC;IAED,sBAMC;IALC,OAAkB;IAClB,OAAkB;IAClB,OAAkB;IAClB,OAAkB;IAIpB,yCAMC;IAKD,yBAGC;IAGD,gBAGC;IAED,2CAGC;IASD,uCAEC;IAYD,gBAEC;IAND,aAEC;IAUD,gBAEC;IAND,aAEC;IAUD,gBAEC;IAND,aAEC;IAUD,gBAEC;IAND,aAEC;IASD,WAEC;IAGD,qBAEC;IAID,yBAKC;IAoBD,4CAGC;IAyBD,kBAGC;IAID,iBAGC;IAGD,cAGC;IASD,mCAIC;IAED,kCAIC;IAGD,iBAaC;IAGD,uBAGC;IAGD,uBAGC;IAGD,uBAGC;IASD,gEAgBC;IAED,iDAGC;IAGD,gBAEC;IAED,2CAEC;IAED,iCAEC;IAED,8BAEC;CACF"}
+{"version":3,"file":"quaternion.d.ts","sourceRoot":"","sources":["../../src/classes/quaternion.ts"],"names":[],"mappings":"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"}

package/dist/classes/quaternion.js

@@ -1,28 +1,9 @@
 // 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 MathArray from './base/math-array';
 import { checkNumber, checkVector } from '../lib/validators';
-import assert from '../lib/assert';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
+import Vector4 from './vector4';
 import * as quat from 'gl-matrix/quat';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
 import * as vec4 from 'gl-matrix/vec4';
 const IDENTITY_QUATERNION = [0, 0, 0, 1];
 export default class Quaternion extends MathArray {
@@ -51,22 +32,33 @@ export default class Quaternion extends MathArray {
         this[3] = w;
         return this.check();
     }
-    // Creates a quaternion from the given 3x3 rotation matrix.
-    // NOTE: The resultant quaternion is not normalized, so you should
-    // be sure to renormalize the quaternion yourself where necessary.
-    fromMatrix3(m) {
-        quat.fromMat3(this, m);
+    fromObject(object) {
+        this[0] = object.x;
+        this[1] = object.y;
+        this[2] = object.z;
+        this[3] = object.w;
         return this.check();
     }
-    // Set a quat to the identity quaternion
-    identity() {
-        quat.identity(this);
+    /**
+     * Creates a quaternion from the given 3x3 rotation matrix.
+     * NOTE: The resultant quaternion is not normalized, so you should
+     * be sure to renormalize the quaternion yourself where necessary.
+     * @param m
+     * @returns
+     */
+    fromMatrix3(m) {
+        quat.fromMat3(this, m);
         return this.check();
     }
     fromAxisRotation(axis, rad) {
         quat.setAxisAngle(this, axis, rad);
         return this.check();
     }
+    /** Set a quat to the identity quaternion */
+    identity() {
+        quat.identity(this);
+        return this.check();
+    }
     // Set the components of a quat to the given values
     // set(i, j, k, l) {
     //   quat.set(this, i, j, k, l);
@@ -77,7 +69,6 @@ export default class Quaternion extends MathArray {
         return this.fromAxisRotation(axis, rad);
     }
     // Getters/setters
-    /* eslint-disable no-multi-spaces, brace-style, no-return-assign */
     get ELEMENTS() {
         return 4;
     }
@@ -105,7 +96,6 @@ export default class Quaternion extends MathArray {
     set w(value) {
         this[3] = checkNumber(value);
     }
-    /* eslint-enable no-multi-spaces, brace-style, no-return-assign */
     // Calculates the length of a quat
     len() {
         return quat.length(this);
@@ -116,10 +106,7 @@ export default class Quaternion extends MathArray {
     }
     // Calculates the dot product of two quat's
     // @return {Number}
-    dot(a, b) {
-        if (b !== undefined) {
-            throw new Error('Quaternion.dot only takes one argument');
-        }
+    dot(a) {
         return quat.dot(this, a);
     }
     // Gets the rotation axis and angle for a given quaternion.
@@ -153,10 +140,7 @@ export default class Quaternion extends MathArray {
     //   Number;
     // }
     // Adds two quat's
-    add(a, b) {
-        if (b !== undefined) {
-            throw new Error('Quaternion.add only takes one argument');
-        }
+    add(a) {
         quat.add(this, this, a);
         return this.check();
     }
@@ -179,17 +163,18 @@ export default class Quaternion extends MathArray {
     }
     // Performs a linear interpolation between two quat's
     lerp(a, b, t) {
+        if (t === undefined) {
+            return this.lerp(this, a, b);
+        }
         quat.lerp(this, a, b, t);
         return this.check();
     }
     // Multiplies two quat's
-    multiplyRight(a, b) {
-        assert(!b); // Quaternion.multiply only takes one argument
+    multiplyRight(a) {
         quat.multiply(this, this, a);
         return this.check();
     }
-    multiplyLeft(a, b) {
-        assert(!b); // Quaternion.multiply only takes one argument
+    multiplyLeft(a) {
         quat.multiply(this, a, this);
         return this.check();
     }
@@ -229,24 +214,35 @@ export default class Quaternion extends MathArray {
         return this.check();
     }
     // Performs a spherical linear interpolation between two quat
-    slerp(start, target, ratio) {
+    slerp(arg0, arg1, arg2) {
+        let start;
+        let target;
+        let ratio;
         // eslint-disable-next-line prefer-rest-params
         switch (arguments.length) {
             case 1: // Deprecated signature ({start, target, ratio})
                 // eslint-disable-next-line prefer-rest-params
-                ({ start = IDENTITY_QUATERNION, target, ratio } = arguments[0]);
+                ({
+                    start = IDENTITY_QUATERNION,
+                    target,
+                    ratio
+                } = arg0);
                 break;
             case 2: // THREE.js compatibility signature (target, ration)
-                // eslint-disable-next-line prefer-rest-params
-                [target, ratio] = arguments;
                 start = this; // eslint-disable-line
+                target = arg0;
+                ratio = arg1;
                 break;
-            default: // Default signature: (start, target, ratio)
+            default:
+                // Default signature: (start, target, ratio)
+                start = arg0;
+                target = arg1;
+                ratio = arg2;
         }
         quat.slerp(this, start, target, ratio);
         return this.check();
     }
-    transformVector4(vector, result = vector) {
+    transformVector4(vector, result = new Vector4()) {
         vec4.transformQuat(result, vector, this);
         return checkVector(result, 4);
     }
@@ -257,10 +253,10 @@ export default class Quaternion extends MathArray {
     setFromAxisAngle(axis, rad) {
         return this.setAxisAngle(axis, rad);
     }
-    premultiply(a, b) {
-        return this.multiplyLeft(a, b);
+    premultiply(a) {
+        return this.multiplyLeft(a);
     }
-    multiply(a, b) {
-        return this.multiplyRight(a, b);
+    multiply(a) {
+        return this.multiplyRight(a);
     }
 }

package/dist/classes/spherical-coordinates.d.ts

@@ -1,40 +1,60 @@
+import Vector3 from './vector3';
+import { NumericArray } from '@math.gl/types';
+declare type SphericalCoordinatesOptions = {
+    phi?: number;
+    theta?: number;
+    radius?: number;
+    bearing?: number;
+    pitch?: number;
+    altitude?: number;
+    radiusScale?: number;
+};
+declare type FormatOptions = {
+    printTypes?: boolean;
+};
+/**
+ * The poles (phi) are at the positive and negative y axis.
+ * The equator starts at positive z.
+ * @link https://en.wikipedia.org/wiki/Spherical_coordinate_system
+ */
 export default class SphericalCoordinates {
-    constructor({ phi, theta, radius, bearing, pitch, altitude, radiusScale }?: {
-        phi?: number;
-        theta?: number;
-        radius?: number;
-        bearing?: any;
-        pitch?: any;
-        altitude?: any;
-        radiusScale?: number;
-    });
     phi: number;
     theta: number;
-    radius: any;
+    radius: number;
     radiusScale: number;
-    set bearing(arg: number);
+    /**
+     * Creates a new SphericalCoordinates object
+     * @param options
+     * @param [options.phi] =0 - rotation around X (latitude)
+     * @param [options.theta] =0 - rotation around Y (longitude)
+     * @param [options.radius] =1 - Distance from center
+     * @param [options.bearing]
+     * @param [options.pitch]
+     * @param [options.altitude]
+     * @param [options.radiusScale] =1
+     */
+    constructor({ phi, theta, radius, bearing, pitch, altitude, radiusScale }?: SphericalCoordinatesOptions);
+    toString(): string;
+    formatString({ printTypes }: FormatOptions): string;
+    equals(other: SphericalCoordinates): boolean;
+    exactEquals(other: SphericalCoordinates): boolean;
     get bearing(): number;
-    set pitch(arg: number);
+    set bearing(v: number);
     get pitch(): number;
-    toString(): string;
-    formatString({ printTypes }: {
-        printTypes?: boolean;
-    }): string;
-    equals(other: any): boolean;
-    exactEquals(other: any): boolean;
+    set pitch(v: number);
     get longitude(): number;
     get latitude(): number;
     get lng(): number;
     get lat(): number;
     get z(): number;
-    set(radius: any, phi: any, theta: any): SphericalCoordinates;
+    set(radius: number, phi: number, theta: number): this;
     clone(): SphericalCoordinates;
-    copy(other: any): SphericalCoordinates;
-    fromLngLatZ([lng, lat, z]: [any, any, any]): void;
-    fromVector3(v: any): SphericalCoordinates;
+    copy(other: SphericalCoordinates): this;
+    fromLngLatZ([lng, lat, z]: [number, number, number]): this;
+    fromVector3(v: Readonly<NumericArray>): this;
     toVector3(): Vector3;
-    makeSafe(): SphericalCoordinates;
-    check(): SphericalCoordinates;
+    makeSafe(): this;
+    check(): this;
 }
-import Vector3 from "./vector3";
+export {};
 //# sourceMappingURL=spherical-coordinates.d.ts.map

package/dist/classes/spherical-coordinates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spherical-coordinates.d.ts","sourceRoot":"","sources":["../../src/classes/spherical-coordinates.js"],"names":[],"mappings":"AAkCA;IAGE;;;;;;;;OAsBC;IAbC,YAAc;IACd,cAAkB;IAElB,YAAqC;IACrC,oBAAmC;IAsCrC,yBAEC;IALD,sBAEC;IAOD,uBAEC;IALD,oBAEC;IAhCD,mBAEC;IAED;;eAIC;IAED,4BAMC;IAED,iCAEC;IAqBD,wBAEC;IACD,uBAEC;IACD,kBAEC;IACD,kBAEC;IACD,gBAEC;IAGD,6DAKC;IAED,8BAEC;IAED,uCAKC;IAED,kDAIC;IAED,0CAOC;IAED,qBAIC;IAGD,iCAGC;IAED,8BAMC;CACF"}
+{"version":3,"file":"spherical-coordinates.d.ts","sourceRoot":"","sources":["../../src/classes/spherical-coordinates.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,WAAW,CAAC;AAIhC,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,aAAK,2BAA2B,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,aAAK,aAAa,GAAG;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAMF;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IAYpB;;;;;;;;;;OAUG;gBAES,EACV,GAAO,EACP,KAAS,EACT,MAAU,EACV,OAAO,EACP,KAAK,EACL,QAAQ,EACR,WAAiC,EAClC,GAAE,2BAAgC;IAenC,QAAQ,IAAI,MAAM;IAIlB,YAAY,CAAC,EAAC,UAAkB,EAAC,EAAE,aAAa,GAAG,MAAM;IAMzD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;IAQ5C,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;IAMjD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,OAAO,CAAC,CAAC,EAAE,MAAM,EAEpB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,EAElB;IAMD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,CAAC,IAAI,MAAM,CAEd;IAGD,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOrD,KAAK,IAAI,oBAAoB;IAI7B,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAOvC,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAO1D,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAS5C,SAAS,IAAI,OAAO;IAOpB,QAAQ,IAAI,IAAI;IAKhB,KAAK,IAAI,IAAI;CAOd"}

package/dist/classes/spherical-coordinates.js

@@ -1,36 +1,41 @@
 // 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
 // Adaptation of THREE.js Spherical class, under MIT license
+import Vector3 from './vector3';
 import { formatValue, equals, config } from '../lib/common';
 import { degrees, radians, clamp } from '../lib/common';
-import Vector3 from './vector3';
-// @ts-ignore: error TS2307: Cannot find module 'gl-matrix/...'.
 import * as vec3 from 'gl-matrix/vec3';
 // TODO - import epsilon
 const EPSILON = 0.000001;
-const EARTH_RADIUS_METERS = 6.371e6;
-// Todo [rho, theta, phi] ?
+const EARTH_RADIUS_METERS = 6371000;
+/**
+ * The poles (phi) are at the positive and negative y axis.
+ * The equator starts at positive z.
+ * @link https://en.wikipedia.org/wiki/Spherical_coordinate_system
+ */
 export default class SphericalCoordinates {
-    // @ts-ignore TS2740: Type '{}' is missing the following properties from type
+    // bearing: number;
+    // pitch: number;
+    // altitude: number;
+    // lnglatZ coordinates
+    // longitude: number;
+    // latitude: number;
+    // lng: number;
+    // lat: number;
+    // z: number;
+    /**
+     * Creates a new SphericalCoordinates object
+     * @param options
+     * @param [options.phi] =0 - rotation around X (latitude)
+     * @param [options.theta] =0 - rotation around Y (longitude)
+     * @param [options.radius] =1 - Distance from center
+     * @param [options.bearing]
+     * @param [options.pitch]
+     * @param [options.altitude]
+     * @param [options.radiusScale] =1
+     */
     // eslint-disable-next-line complexity
-    constructor({ phi = 0, theta = 0, radius = 1, bearing = undefined, pitch = undefined, altitude = undefined, radiusScale = EARTH_RADIUS_METERS } = {}) {
+    constructor({ phi = 0, theta = 0, radius = 1, bearing, pitch, altitude, radiusScale = EARTH_RADIUS_METERS } = {}) {
         this.phi = phi;
         this.theta = theta;
         // TODO - silently accepts illegal 0
@@ -113,6 +118,7 @@ export default class SphericalCoordinates {
         this.radius = 1 + z / this.radiusScale;
         this.phi = radians(lat);
         this.theta = radians(lng);
+        return this.check();
     }
     fromVector3(v) {
         this.radius = vec3.length(v);

package/dist/classes/vector2.d.ts

@@ -1,19 +1,55 @@
-export default class Vector2 extends Vector<any> {
-    constructor(x?: number, y?: number, ...args: any[]);
-    0: number;
-    1: number;
-    set(x: any, y: any): any;
-    copy(array: any): any;
-    fromObject(object: any): any;
-    toObject(object: any): any;
+import Vector from './base/vector';
+import { NumericArray } from '@math.gl/types';
+/**
+ * Two-element vector class.
+ * Subclass of Array<number>
+ */
+export default class Vector2 extends Vector {
+    constructor(x?: number | Readonly<NumericArray>, y?: number);
+    set(x: number, y: number): this;
+    copy(array: Readonly<NumericArray>): this;
+    fromObject(object: {
+        x: number;
+        y: number;
+    }): this;
+    toObject(object: {
+        x?: number;
+        y?: number;
+    }): {
+        x: number;
+        y: number;
+    };
+    get ELEMENTS(): number;
+    /**
+     * Returns angle from x axis
+     * @returns
+     */
     horizontalAngle(): number;
+    /**
+     * Returns angle from y axis
+     * @returns
+     */
     verticalAngle(): number;
-    transform(matrix4: any): any;
-    transformAsPoint(matrix4: any): any;
-    transformAsVector(matrix4: any): any;
-    transformByMatrix3(matrix3: any): any;
-    transformByMatrix2x3(matrix2x3: any): any;
-    transformByMatrix2(matrix2: any): any;
+    /**
+     * Transforms as point
+     * @param matrix4
+     * @returns
+     */
+    transform(matrix4: Readonly<NumericArray>): this;
+    /**
+     * transforms as point (4th component is implicitly 1)
+     * @param matrix4
+     * @returns
+     */
+    transformAsPoint(matrix4: Readonly<NumericArray>): this;
+    /**
+     * transforms as vector (4th component is implicitly 0, ignores translation. slightly faster)
+     * @param matrix4
+     * @returns
+     */
+    transformAsVector(matrix4: Readonly<NumericArray>): this;
+    transformByMatrix3(matrix3: Readonly<NumericArray>): this;
+    transformByMatrix2x3(matrix2x3: Readonly<NumericArray>): this;
+    transformByMatrix2(matrix2: Readonly<NumericArray>): this;
 }
-import Vector from "./base/vector";
 //# sourceMappingURL=vector2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"vector2.d.ts","sourceRoot":"","sources":["../../src/classes/vector2.js"],"names":[],"mappings":"AA6BA;IAEE,oDAaC;IAHG,UAAW;IACX,UAAW;IAIf,yBAIC;IAED,sBAIC;IAED,6BAQC;IAED,2BAIC;IASD,0BAEC;IAED,wBAEC;IAID,6BAEC;IAGD,oCAGC;IAGD,qCAGC;IAED,sCAGC;IAED,0CAGC;IAED,sCAGC;CACF"}
+{"version":3,"file":"vector2.d.ts","sourceRoot":"","sources":["../../src/classes/vector2.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,eAAe,CAAC;AAMnC,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,MAAM;gBAE7B,CAAC,GAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAK,EAAE,CAAC,GAAE,MAAU;IAejE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAM/B,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAMzC,UAAU,CAAC,MAAM,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI;IAUhD,QAAQ,CAAC,MAAM,EAAE;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC;IAQlE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;OAGG;IACH,aAAa,IAAI,MAAM;IAMvB;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAIhD;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKvD;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKxD,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAKzD,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAK7D,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;CAI1D"}